@danceroutine/tango-schema 1.3.0 → 1.5.0

package/dist/domain/ModelWriteHooks.d.ts

@@ -4,6 +4,12 @@ export interface ModelWriteHookManager<TModel extends Record<string, unknown>> {
     delete(id: TModel[keyof TModel]): Promise<void>;
     bulkCreate(inputs: Partial<TModel>[]): Promise<TModel[]>;
 }
+export interface ModelWriteHookOnCommitOptions {
+    robust?: boolean;
+}
+export interface ModelWriteHookTransaction {
+    onCommit(callback: () => void, options?: ModelWriteHookOnCommitOptions): void;
+}
 /**
  * Structural model contract passed into write lifecycle hooks.
  */
@@ -20,11 +26,13 @@ export interface BeforeCreateHookArgs<TModel extends Record<string, unknown>> {
     data: Partial<TModel>;
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface AfterCreateHookArgs<TModel extends Record<string, unknown>> {
     record: TModel;
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface BeforeUpdateHookArgs<TModel extends Record<string, unknown>> {
     id: TModel[keyof TModel];
@@ -32,6 +40,7 @@ export interface BeforeUpdateHookArgs<TModel extends Record<string, unknown>> {
     current: TModel;
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface AfterUpdateHookArgs<TModel extends Record<string, unknown>> {
     id: TModel[keyof TModel];
@@ -40,28 +49,33 @@ export interface AfterUpdateHookArgs<TModel extends Record<string, unknown>> {
     record: TModel;
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface BeforeDeleteHookArgs<TModel extends Record<string, unknown>> {
     id: TModel[keyof TModel];
     current: TModel;
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface AfterDeleteHookArgs<TModel extends Record<string, unknown>> {
     id: TModel[keyof TModel];
     previous: TModel;
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface BeforeBulkCreateHookArgs<TModel extends Record<string, unknown>> {
     rows: Partial<TModel>[];
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 export interface AfterBulkCreateHookArgs<TModel extends Record<string, unknown>> {
     records: TModel[];
     model: ModelHookModel<TModel>;
     manager: ModelWriteHookManager<TModel>;
+    transaction?: ModelWriteHookTransaction;
 }
 /**
  * Async-capable model-owned write lifecycle hooks.

package/dist/domain/index.d.ts

@@ -10,4 +10,4 @@ export type { IndexDef } from './IndexDef';
 export type { RelationDef } from './RelationDef';
 export type { ModelMetadata } from './ModelMetadata';
 export type { Model, ModelAugmentations, ModelKeyOf, PersistedModelOutput } from './Model';
-export type { ModelHookModel, ModelWriteHookManager, ModelWriteHooks, BeforeCreateHookArgs, AfterCreateHookArgs, BeforeUpdateHookArgs, AfterUpdateHookArgs, BeforeDeleteHookArgs, AfterDeleteHookArgs, BeforeBulkCreateHookArgs, AfterBulkCreateHookArgs, } from './ModelWriteHooks';
+export type { ModelHookModel, ModelWriteHookOnCommitOptions, ModelWriteHookManager, ModelWriteHookTransaction, ModelWriteHooks, BeforeCreateHookArgs, AfterCreateHookArgs, BeforeUpdateHookArgs, AfterUpdateHookArgs, BeforeDeleteHookArgs, AfterDeleteHookArgs, BeforeBulkCreateHookArgs, AfterBulkCreateHookArgs, } from './ModelWriteHooks';

package/dist/domain-Cufz6y1q.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-Cufz6y1q.js","names":[],"sources":["../src/domain/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { FieldType } from './FieldType';\nexport type { DeleteReferentialAction } from './DeleteReferentialAction';\nexport type { UpdateReferentialAction } from './UpdateReferentialAction';\nexport type { RelationType } from './RelationType';\nexport type { Field } from './Field';\nexport type { IndexDef } from './IndexDef';\nexport type { RelationDef } from './RelationDef';\nexport type { ModelMetadata } from './ModelMetadata';\nexport type { Model, ModelAugmentations, ModelKeyOf, PersistedModelOutput } from './Model';\nexport type {\n    ModelHookModel,\n    ModelWriteHookManager,\n    ModelWriteHooks,\n    BeforeCreateHookArgs,\n    AfterCreateHookArgs,\n    BeforeUpdateHookArgs,\n    AfterUpdateHookArgs,\n    BeforeDeleteHookArgs,\n    AfterDeleteHookArgs,\n    BeforeBulkCreateHookArgs,\n    AfterBulkCreateHookArgs,\n} from './ModelWriteHooks';\n"],"mappings":""}
+{"version":3,"file":"domain-Cufz6y1q.js","names":[],"sources":["../src/domain/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { FieldType } from './FieldType';\nexport type { DeleteReferentialAction } from './DeleteReferentialAction';\nexport type { UpdateReferentialAction } from './UpdateReferentialAction';\nexport type { RelationType } from './RelationType';\nexport type { Field } from './Field';\nexport type { IndexDef } from './IndexDef';\nexport type { RelationDef } from './RelationDef';\nexport type { ModelMetadata } from './ModelMetadata';\nexport type { Model, ModelAugmentations, ModelKeyOf, PersistedModelOutput } from './Model';\nexport type {\n    ModelHookModel,\n    ModelWriteHookOnCommitOptions,\n    ModelWriteHookManager,\n    ModelWriteHookTransaction,\n    ModelWriteHooks,\n    BeforeCreateHookArgs,\n    AfterCreateHookArgs,\n    BeforeUpdateHookArgs,\n    AfterUpdateHookArgs,\n    BeforeDeleteHookArgs,\n    AfterDeleteHookArgs,\n    BeforeBulkCreateHookArgs,\n    AfterBulkCreateHookArgs,\n} from './ModelWriteHooks';\n"],"mappings":""}

package/dist/index.d.ts

@@ -5,4 +5,5 @@
 export * as domain from './domain/index';
 export * as model from './model/index';
 export type { DeleteReferentialAction, Field, FieldType, IndexDef, ModelHookModel, ModelKeyOf, ModelAugmentations, ModelMetadata, PersistedModelOutput, ModelWriteHookManager, ModelWriteHooks, BeforeCreateHookArgs, AfterCreateHookArgs, BeforeUpdateHookArgs, AfterUpdateHookArgs, BeforeDeleteHookArgs, AfterDeleteHookArgs, BeforeBulkCreateHookArgs, AfterBulkCreateHookArgs, RelationDef, RelationType, UpdateReferentialAction, } from './domain/index';
-export { Model, RelationBuilder, ModelRegistry, registerModelAugmentor, Constraints, Decorators, Indexes, Meta, c, i, m, t, type ModelDefinition, type ForeignKeyDecoratorConfig, type FieldDecoratorBuilder, type DecoratedFieldKind, type ManyToManyDecoratorConfig, type ModelRef, type ModelRefTarget, type OneToOneDecoratorConfig, type RelationDecoratedSchema, type TypedModelRef, } from './model/index';
+export { Model, RelationBuilder, ModelRegistry, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, ResolvedRelationGraphArtifactFactory, registerModelAugmentor, Constraints, Decorators, Indexes, Meta, c, i, m, t, type ModelDefinition, type ForeignKeyDecoratorConfig, type FieldDecoratorBuilder, type DecoratedFieldKind, type ManyToManyDecoratorConfig, type ModelRef, type ModelRefTarget, type GeneratedRelationRegistryArtifact, type OneToOneDecoratorConfig, type RelationDecoratedSchema, type ResolvedRelationGraphSnapshot, type ResolvedRelationGraphSnapshotModel, type ResolvedRelationGraphSnapshotRelation, type TypedModelRef, } from './model/index';
+export { createSchemaModuleAliases, resolveSchemaModuleEntrypoint } from './resolveSchemaModuleEntrypoint';

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Constraints, Decorators, Indexes, Meta, Model, ModelRegistry, RelationBuilder, model_exports, registerModelAugmentor } from "./model-YLW1ydkV.js";
+import { Constraints, Decorators, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, Indexes, Meta, Model, ModelRegistry, RelationBuilder, ResolvedRelationGraphArtifactFactory, createSchemaModuleAliases, model_exports, registerModelAugmentor, resolveSchemaModuleEntrypoint } from "./model-BxkSqwrt.js";
 import { domain_exports } from "./domain-Cufz6y1q.js";
 
-export { Constraints, Decorators, Indexes, Meta, Model, ModelRegistry, RelationBuilder, Constraints as c, domain_exports as domain, Indexes as i, Meta as m, model_exports as model, registerModelAugmentor, Decorators as t };
+export { Constraints, Decorators, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, Indexes, Meta, Model, ModelRegistry, RelationBuilder, ResolvedRelationGraphArtifactFactory, Constraints as c, createSchemaModuleAliases, domain_exports as domain, Indexes as i, Meta as m, model_exports as model, registerModelAugmentor, resolveSchemaModuleEntrypoint, Decorators as t };

package/dist/model/index.d.ts

@@ -21,4 +21,4 @@ export { Meta, m } from './meta/index';
 export type { ModelConstraint, ModelMetaFragment } from './meta/index';
 export { Constraints, Indexes, c, i } from './constraints/index';
 export type { ConstraintDefinition } from './constraints/index';
-export { ModelRegistry } from './registry/index';
+export { ModelRegistry, createSchemaModuleAliases, resolveSchemaModuleEntrypoint, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, ResolvedRelationGraphArtifactFactory, type GeneratedRelationRegistryArtifact, type ResolvedRelationGraphSnapshot, type ResolvedRelationGraphSnapshotModel, type ResolvedRelationGraphSnapshotRelation, } from './registry/index';

package/dist/model/index.js

@@ -1,3 +1,3 @@
-import { Constraints, Decorators, Indexes, InternalDecoratedFieldKind, Meta, Model, ModelRegistry, RelationBuilder, constraints_exports, createTypedModelRef, decorators_exports, isTypedModelRef, meta_exports, registerModelAugmentor, registry_exports, relations_exports } from "../model-YLW1ydkV.js";
+import { Constraints, Decorators, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, Indexes, InternalDecoratedFieldKind, Meta, Model, ModelRegistry, RelationBuilder, ResolvedRelationGraphArtifactFactory, constraints_exports, createSchemaModuleAliases, createTypedModelRef, decorators_exports, isTypedModelRef, meta_exports, registerModelAugmentor, registry_exports, relations_exports, resolveSchemaModuleEntrypoint } from "../model-BxkSqwrt.js";
 
-export { Constraints, Decorators, Indexes, InternalDecoratedFieldKind, Meta, Model, ModelRegistry, RelationBuilder, Constraints as c, constraints_exports as constraints, createTypedModelRef, decorators_exports as decorators, Indexes as i, isTypedModelRef, Meta as m, meta_exports as meta, registerModelAugmentor, registry_exports as registry, relations_exports as relations, Decorators as t };
+export { Constraints, Decorators, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, Indexes, InternalDecoratedFieldKind, Meta, Model, ModelRegistry, RelationBuilder, ResolvedRelationGraphArtifactFactory, Constraints as c, constraints_exports as constraints, createSchemaModuleAliases, createTypedModelRef, decorators_exports as decorators, Indexes as i, isTypedModelRef, Meta as m, meta_exports as meta, registerModelAugmentor, registry_exports as registry, relations_exports as relations, resolveSchemaModuleEntrypoint, Decorators as t };

package/dist/model/internal/InternalSchemaModel.d.ts

@@ -14,10 +14,6 @@ export declare class InternalSchemaModel<TSchema extends z.ZodObject<z.ZodRawSha
     readonly objects: ModelAugmentations<TSchema, TKey> extends {
         readonly objects: infer TObject;
     } ? TObject : never;
-    private readonly registry;
-    private readonly normalizedRelations;
-    private readonly explicitFields?;
-    private readonly explicitRelations?;
     private constructor();
     static create<TSchema extends z.ZodObject<z.ZodRawShape>>(definition: ModelDefinition<TSchema>, registry: ModelRegistry): InternalSchemaModel<TSchema>;
     static isInternalSchemaModel(value: unknown): value is AnyInternalSchemaModel;
@@ -27,5 +23,7 @@ export declare class InternalSchemaModel<TSchema extends z.ZodObject<z.ZodRawSha
     static getExplicitRelations(model: AnySchemaModel): Readonly<Record<string, RelationDef>> | undefined;
     private static validateDefinition;
     private static require;
+    private static carrier;
+    private static attachInternals;
 }
 export {};

package/dist/model/registry/GeneratedRelationRegistryArtifact.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedRelationGraphSnapshot } from './ResolvedRelationGraphSnapshot';
+export declare const GENERATED_RELATION_REGISTRY_DIRNAME = ".tango";
+export declare const GENERATED_RELATION_REGISTRY_TYPES_FILENAME = "relations.generated.d.ts";
+export declare const GENERATED_RELATION_REGISTRY_METADATA_FILENAME = "relations.generated.json";
+export declare const GENERATED_RELATION_REGISTRY_METADATA_VERSION = 1;
+export type GeneratedRelationRegistryArtifact = {
+    version: typeof GENERATED_RELATION_REGISTRY_METADATA_VERSION;
+    fingerprint: string;
+    snapshot: ResolvedRelationGraphSnapshot;
+};

package/dist/model/registry/ModelRegistry.d.ts

@@ -2,11 +2,15 @@ import type { Field, Model } from '../../domain/index';
 import { type ModelRef } from '../decorators/domain/ModelRef';
 import type { FinalizedStorageArtifacts } from '../fields/FinalizedStorageArtifacts';
 import type { ResolvedRelationGraph } from '../relations/ResolvedRelationGraph';
+import type { ResolvedRelationGraphSnapshot } from './ResolvedRelationGraphSnapshot';
 /**
  * Registry that resolves Tango models by stable identity.
  *
- * The global registry is convenient for application bootstrapping, while
- * dedicated instances are useful in tests and tooling.
+ * The default shared registry is convenient for application bootstrapping
+ * within one schema package instance, while dedicated instances are useful in
+ * tests and tooling. Explicit active-registry binding stays process-shared so
+ * tooling can construct models across separate schema package copies without
+ * relying on the ambient default registry.
  */
 export declare class ModelRegistry {
     private static globalRegistry?;
@@ -14,12 +18,17 @@ export declare class ModelRegistry {
     private version;
     private storageCache?;
     private relationGraphCache?;
+    private lastRelationRegistryDriftCheckVersion?;
     /**
-     * Return the shared process-wide registry used by `Model(...)`.
+     * Return the shared default registry used by `Model(...)` for this schema
+     * package instance.
      */
     static global(): ModelRegistry;
     /**
      * Return the registry currently bound to model construction work.
+     *
+     * This explicit binding is process-shared so code that imports separate
+     * schema package copies can still participate in one construction flow.
      */
     static active(): ModelRegistry;
     /**
@@ -53,7 +62,13 @@ export declare class ModelRegistry {
     /**
      * Return the owning registry for a model.
      */
-    static getOwner(model: Model): ModelRegistry;
+    static getOwner(model: {
+        metadata: {
+            key?: string;
+        };
+    } & object): ModelRegistry;
+    private static runtimeGlobal;
+    private static activeRegistryStorage;
     /**
      * Register a model on this registry instance.
      */
@@ -86,6 +101,14 @@ export declare class ModelRegistry {
      * Resolve the registry's relation graph from finalized storage artifacts.
      */
     getResolvedRelationGraph(): ResolvedRelationGraph;
+    /**
+     * Return a canonical snapshot of the resolved relation graph.
+     */
+    getResolvedRelationGraphSnapshot(): ResolvedRelationGraphSnapshot;
+    /**
+     * Return a deterministic fingerprint for the resolved relation graph.
+     */
+    getResolvedRelationGraphFingerprint(): string;
     /**
      * Remove all registered models from this registry instance.
      */
@@ -98,4 +121,8 @@ export declare class ModelRegistry {
     private freezeFields;
     private inferPrimaryKeyName;
     private mergeStorageFields;
+    private warnOnGeneratedRelationRegistryDrift;
+    private shouldCheckGeneratedRelationRegistry;
+    private readGeneratedRelationRegistryArtifact;
+    private isPartialRegistrySnapshot;
 }

package/dist/model/registry/ResolvedRelationGraphArtifactFactory.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedRelationGraph } from '../relations/ResolvedRelationGraph';
+import type { ResolvedRelationGraphSnapshot } from './ResolvedRelationGraphSnapshot';
+/**
+ * Build canonical serialized artifacts from a resolved relation graph.
+ *
+ * Generation, drift detection, and related tooling all need the same stable
+ * snapshot shape and fingerprinting rules, so that work lives behind one class
+ * instead of a pair of free functions.
+ */
+export declare class ResolvedRelationGraphArtifactFactory {
+    static createSnapshot(graph: ResolvedRelationGraph): ResolvedRelationGraphSnapshot;
+    static createFingerprint(value: ResolvedRelationGraph | ResolvedRelationGraphSnapshot): string;
+}

package/dist/model/registry/ResolvedRelationGraphSnapshot.d.ts

@@ -0,0 +1,26 @@
+import type { RelationCardinality, RelationPublicKind, RelationStorageStrategy } from '../relations/RelationSpec';
+export type ResolvedRelationGraphSnapshotRelation = {
+    edgeId: string;
+    sourceModelKey: string;
+    targetModelKey: string;
+    name: string;
+    inverseEdgeId?: string;
+    kind: RelationPublicKind;
+    storageStrategy: RelationStorageStrategy;
+    cardinality: RelationCardinality;
+    localFieldName?: string;
+    targetFieldName?: string;
+    alias: string;
+    capabilities: {
+        migratable: boolean;
+        queryable: boolean;
+        hydratable: boolean;
+    };
+};
+export type ResolvedRelationGraphSnapshotModel = {
+    key: string;
+    relations: ResolvedRelationGraphSnapshotRelation[];
+};
+export type ResolvedRelationGraphSnapshot = {
+    models: ResolvedRelationGraphSnapshotModel[];
+};

package/dist/model/registry/index.d.ts

@@ -2,3 +2,7 @@
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
 export { ModelRegistry } from './ModelRegistry';
+export { createSchemaModuleAliases, resolveSchemaModuleEntrypoint } from '../../resolveSchemaModuleEntrypoint';
+export { GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, type GeneratedRelationRegistryArtifact, } from './GeneratedRelationRegistryArtifact';
+export { ResolvedRelationGraphArtifactFactory } from './ResolvedRelationGraphArtifactFactory';
+export { type ResolvedRelationGraphSnapshot, type ResolvedRelationGraphSnapshotModel, type ResolvedRelationGraphSnapshotRelation, } from './ResolvedRelationGraphSnapshot';

package/dist/model/relations/ResolvedRelationGraphBuilder.d.ts

@@ -1,5 +1,6 @@
 import type { Model } from '../../domain/index';
 import type { FinalizedStorageArtifacts } from '../fields/FinalizedStorageArtifacts';
+import type { ResolvedRelationGraphSnapshot } from '../registry/ResolvedRelationGraphSnapshot';
 import type { NormalizedRelationStorageDescriptor } from './NormalizedRelationStorageDescriptor';
 import type { ResolvedRelationGraph } from './ResolvedRelationGraph';
 type GraphBuilderOptions = {
@@ -28,6 +29,11 @@ export declare class ResolvedRelationGraphBuilder {
     private readonly matchedOverrides;
     constructor(options: GraphBuilderOptions);
     static build(options: GraphBuilderOptions): ResolvedRelationGraph;
+    /**
+     * Serialize a resolved graph into the canonical snapshot shape used by
+     * relation-registry code generation and fingerprinting.
+     */
+    static createSnapshot(graph: ResolvedRelationGraph): ResolvedRelationGraphSnapshot;
     /**
      * Resolve every model's normalized relation descriptors into a single
      * registry-scoped graph and fail when authoring ambiguity remains.