Schema and registry


import { ModelRegistry } from "@stratasync/core";

const names = ModelRegistry.getModelNames();
// ["Workspace", "Project", "Task", ...]

const meta = ModelRegistry.getModelMetadata("Task");
// { name: "Task", loadStrategy: "instant" }

const props = ModelRegistry.getModelProperties("Task");
// Map { "title" => { type: "property" }, "projectId" => { type: "reference", ... } }

const hash = ModelRegistry.getSchemaHash();
// "a1b2c3d4"

Method	Return type	Description
`registerModel(name, ctor, meta)`	`void`	Registers a model (called by `@ClientModel`).
`registerProperty(target, name, meta)`	`void`	Registers a property (called by decorators).
`getModelNames()`	`string[]`	All registered model names.
`getModelMetadata(name)`	`ModelMetadata \| undefined`	Metadata for one model.
`getModelConstructor(name)`	`ModelConstructor \| undefined`	Constructor for a model name.
`getModelName(ctor)`	`string \| undefined`	Model name for a constructor.
`hasModel(name)`	`boolean`	Whether a model is registered.
`getModelMetadataEntries()`	`[string, ModelMetadata][]`	All metadata entries.
`getBootstrapModelNames()`	`string[]`	Models with `instant` load strategy.
`getPartialModelNames()`	`string[]`	Models with `partial` load strategy.
`getModelProperties(name)`	`Map<string, PropertyMetadata>`	Property metadata map for a model.
`getReferencedProperties(name)`	`Map<string, PropertyMetadata>`	Reference and collection properties only.
`getPropertyNames(name)`	`string[]`	Sorted property names.
`getSchemaHash()`	`string`	Deterministic hash of the full schema.
`snapshot()`	`ModelRegistrySnapshot`	Serializable snapshot of the registry.


import { ModelRegistry } from "@stratasync/core";

const registry = new ModelRegistry({
  models: {
    Task: {
      loadStrategy: "instant",
      fields: {
        id: {},
        title: { type: "string" },
        status: { type: "string" },
      },
      relations: {
        project: {
          kind: "belongsTo",
          model: "Project",
          foreignKey: "projectId",
        },
      },
    },
  },
});

const names = registry.getModelNames();
const hash = registry.getSchemaHash();
const model = registry.getModel("Task");

Method	Return type	Description
`getModelNames()`	`string[]`	All model names.
`getModelMetadata(name)`	`ModelMetadata \| undefined`	Metadata for one model.
`hasModel(name)`	`boolean`	Whether a model exists.
`getModelMetadataEntries()`	`[string, ModelMetadata][]`	All metadata entries.
`getBootstrapModelNames()`	`string[]`	Models with `instant` load strategy.
`getPartialModelNames()`	`string[]`	Models with `partial` load strategy.
`getModelProperties(name)`	`Map<string, PropertyMetadata>`	Property metadata map.
`getPropertyNames(name)`	`string[]`	Sorted property names.
`getSchemaHash()`	`string`	Deterministic schema hash.
`snapshot()`	`ModelRegistrySnapshot`	Underlying snapshot data.
`getModel(name)`	`ModelDefinition \| undefined`	Full model definition.
`getAllModels()`	`ModelDefinition[]`	All model definitions.
`getBootstrapModels()`	`ModelDefinition[]`	Models for bootstrap loading.
`getPartialModels()`	`ModelDefinition[]`	Partially-loaded models.
`getPrimaryKey(name)`	`string`	Primary key field (defaults to `"id"`).

Strategy	Bootstrap	Best for
`"instant"`	Included	Core data needed on every page
`"lazy"` / `"partial"` / `"explicitlyRequested"` / `"local"`	Excluded	Data loaded on demand or kept local-only


interface PropertyMetadata {
  type: PropertyType;
  lazy?: boolean;
  serializer?: PropertySerializer<unknown>;
  indexed?: boolean;
  nullable?: boolean;
  referenceModel?: string;
  inverseProperty?: string;
  foreignKey?: string;
  through?: string;
}


interface SchemaDefinition {
  models: Record<string, ModelDefinition>;
}

interface ModelDefinition {
  name?: string;
  loadStrategy?: LoadStrategy;
  partialLoadMode?: PartialLoadMode;
  primaryKey?: string;
  groupKey?: string;
  fields?: Record<string, FieldDefinition>;
  relations?: Record<string, RelationDefinition>;
  indexes?: ModelIndexDefinition[];
  schemaVersion?: number;
  tableName?: string;
}

ModelRegistry

Static API

Static method reference

Instance API

Instance method reference

computeSchemaHash

Load strategies

Schema types

ModelMetadata

PropertyMetadata

PropertyType

SchemaDefinition