better exporting of types

[tomasciccola]

This PR addresses #39 and #38

[tomasciccola]

I basically now generate a types/index.d.ts with the following contents:

export { ProtobufSchema } from './proto'
export { JSONSchema } from './schema'

both refer to a mixed type that can the be imported like:

/**
* @property {import('./types').JSONSchema} obj
*/

However one cannot access individual schemas from there like so:

/**
THIS WON'T WORK
* @property {import('./types').JSONSchema.Observation} observation
*/

Since i.e Observation is not actually a field inside JSONSchema.
To import individual types one would do smth like

/**
THIS WILL WORK
* @property {import('./types/schema').Observation} observation
*/

this works since each index.d.ts corresponding to JSONSchemas and Protobufs also export individual types referring every version of a schema or protobuf, where the identifier without a specific version corresponds to the last version (so Observation actually refers to Observation_5).

[tomasciccola]

An alternative to referring to individual types would be exporting every JSONSchema and Proto types from types/index.d.ts, where we append an identifier like so

export { Observation_5 as ObservationProto } from './proto/observation/v5'
export { Observation_4 as ObservationProto_4 } from './proto/observation/v4'

this, I think, would allow to do smth like

/**
* @param {import ('./types').ObservationProto} observation
*/

instead of

/**
* @param {import ('./types/proto').Observation} observation
*/

I don't have any preferences, so open to suggestions...

[sethvincent]

/**
THIS WILL WORK
* @property {import('./types/schema').Observation} observation
*/

this works since each index.d.ts corresponding to JSONSchemas and Protobufs also export individual types referring every version of a schema or protobuf, where the identifier without a specific version corresponds to the last version (so Observation actually refers to Observation_5).

Cool, that works for me. I'll do some quick experiments using/integrating this.