@danceroutine/tango-schema 1.11.1 → 1.11.2

package/dist/{model-upj6jxaK.js → model-aRAusQPz.js}

@@ -1,23 +1,13 @@
-import { getLogger, getLogger as getLogger$1 } from "@danceroutine/tango-core";
-import { z, z as z$1 } from "zod";
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { getLogger } from "@danceroutine/tango-core";
+import { z } from "zod";
 import { AsyncLocalStorage } from "node:async_hooks";
-import { existsSync, existsSync as existsSync$1, readFileSync } from "node:fs";
-import { dirname, extname, resolve, resolve as resolve$1 } from "node:path";
-import { createHash, createHash as createHash$1 } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, extname, resolve } from "node:path";
+import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
-
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-};
-
-//#endregion
 //#region src/model/fields/FieldMetadataStore.ts
-const fieldMetadataStore = new WeakMap();
+const fieldMetadataStore = /* @__PURE__ */ new WeakMap();
 function getFieldMetadata(schema) {
 	return fieldMetadataStore.get(schema);
 }
@@ -28,7 +18,6 @@ function setFieldMetadata(schema, meta) {
 		...meta
 	});
 }
-
 //#endregion
 //#region src/model/decorators/domain/ModelRef.ts
 function createTypedModelRef(key) {
@@ -37,7 +26,6 @@ function createTypedModelRef(key) {
 function isTypedModelRef(value) {
 	return typeof value === "object" && value !== null && typeof value.key === "string";
 }
-
 //#endregion
 //#region src/model/decorators/domain/DecoratedFieldKind.ts
 const InternalDecoratedFieldKind = {
@@ -45,7 +33,6 @@ const InternalDecoratedFieldKind = {
 	ONE_TO_ONE: "oneToOne",
 	MANY_TO_MANY: "manyToMany"
 };
-
 //#endregion
 //#region src/model/decorators/Decorators.ts
 function isZodType(value) {
@@ -55,11 +42,11 @@ function decorate(schema, meta) {
 	setFieldMetadata(schema, meta);
 	return schema;
 }
-const warnedDecoratorKinds = new Set();
+const warnedDecoratorKinds = /* @__PURE__ */ new Set();
 function warnDeprecatedSchemaOverload(kind, replacement) {
 	if (warnedDecoratorKinds.has(kind)) return;
 	warnedDecoratorKinds.add(kind);
-	getLogger$1("tango.schema.decorators").warn(`Deprecated positional schema overload used for t.${kind}(...). Prefer ${replacement} instead.`);
+	getLogger("tango.schema.decorators").warn(`Deprecated positional schema overload used for t.${kind}(...). Prefer ${replacement} instead.`);
 }
 function maybeDecorator(schemaOrUndefined, meta) {
 	if (schemaOrUndefined) return decorate(schemaOrUndefined, meta);
@@ -105,6 +92,7 @@ function errorMessages(schema, map) {
 	return decorate(schema, { errorMessages: map });
 }
 var FieldDecoratorBuilderImpl = class {
+	schema;
 	constructor(schema) {
 		this.schema = schema;
 	}
@@ -155,8 +143,8 @@ function applyRelationMetadata(schema, meta, config) {
 	});
 }
 function toReferentialOptions(config) {
-	if (!config) return undefined;
-	if (config.column === undefined && config.onDelete === undefined && config.onUpdate === undefined) return undefined;
+	if (!config) return;
+	if (config.column === void 0 && config.onDelete === void 0 && config.onUpdate === void 0) return;
 	return {
 		column: config.column,
 		onDelete: config.onDelete,
@@ -178,14 +166,13 @@ function foreignKey(target, schemaOrOptions, maybeOptions) {
 		});
 	}
 	const config = schemaOrOptions;
-	const schema = config?.field ?? z$1.number().int();
-	return applyRelationMetadata(schema, {
+	return applyRelationMetadata(config?.field ?? z.number().int(), {
 		relationKind: InternalDecoratedFieldKind.FOREIGN_KEY,
 		references: {
 			target,
 			options: toReferentialOptions(config)
 		},
-		notNull: config?.field ? undefined : true
+		notNull: config?.field ? void 0 : true
 	}, config);
 }
 function oneToOne(target, schemaOrOptions, maybeOptions) {
@@ -201,15 +188,14 @@ function oneToOne(target, schemaOrOptions, maybeOptions) {
 		});
 	}
 	const config = schemaOrOptions;
-	const schema = config?.field ?? z$1.number().int();
-	return applyRelationMetadata(schema, {
+	return applyRelationMetadata(config?.field ?? z.number().int(), {
 		relationKind: InternalDecoratedFieldKind.ONE_TO_ONE,
 		unique: true,
 		references: {
 			target,
 			options: toReferentialOptions(config)
 		},
-		notNull: config?.field ? undefined : true
+		notNull: config?.field ? void 0 : true
 	}, config);
 }
 function manyToMany(target, schemaOrConfig) {
@@ -220,12 +206,10 @@ function manyToMany(target, schemaOrConfig) {
 			references: { target }
 		});
 	}
-	if (schemaOrConfig?.relatedName !== undefined) throw new Error("t.manyToMany(...) does not support relatedName yet.");
+	if (schemaOrConfig?.relatedName !== void 0) throw new Error("t.manyToMany(...) does not support relatedName yet.");
 	const config = schemaOrConfig;
-	const hasPartialThroughConfig = (config?.through !== undefined || config?.throughSourceFieldName !== undefined || config?.throughTargetFieldName !== undefined) && !(config?.through && config.throughSourceFieldName && config.throughTargetFieldName);
-	if (hasPartialThroughConfig) throw new Error("t.manyToMany(...) through config requires through, throughSourceFieldName, and throughTargetFieldName.");
-	const schema = config?.field ?? z$1.array(z$1.number().int());
-	return applyRelationMetadata(schema, {
+	if ((config?.through !== void 0 || config?.throughSourceFieldName !== void 0 || config?.throughTargetFieldName !== void 0) && !(config?.through && config.throughSourceFieldName && config.throughTargetFieldName)) throw new Error("t.manyToMany(...) through config requires through, throughSourceFieldName, and throughTargetFieldName.");
+	return applyRelationMetadata(config?.field ?? z.array(z.number().int()), {
 		relationKind: InternalDecoratedFieldKind.MANY_TO_MANY,
 		references: {
 			target,
@@ -254,18 +238,15 @@ const Decorators = {
 	oneToOne,
 	manyToMany
 };
-
 //#endregion
 //#region src/model/decorators/index.ts
-var decorators_exports = {};
-__export(decorators_exports, {
+var decorators_exports = /* @__PURE__ */ __exportAll({
 	Decorators: () => Decorators,
 	InternalDecoratedFieldKind: () => InternalDecoratedFieldKind,
 	createTypedModelRef: () => createTypedModelRef,
 	isTypedModelRef: () => isTypedModelRef,
 	t: () => Decorators
 });
-
 //#endregion
 //#region src/model/meta/Meta.ts
 const Meta = {
@@ -306,15 +287,12 @@ const Meta = {
 		}), {});
 	}
 };
-
 //#endregion
 //#region src/model/meta/index.ts
-var meta_exports = {};
-__export(meta_exports, {
+var meta_exports = /* @__PURE__ */ __exportAll({
 	Meta: () => Meta,
 	m: () => Meta
 });
-
 //#endregion
 //#region src/model/constraints/Constraints.ts
 const Constraints = {
@@ -339,7 +317,6 @@ const Constraints = {
 		};
 	}
 };
-
 //#endregion
 //#region src/model/constraints/Indexes.ts
 const Indexes = { index(on, options) {
@@ -351,17 +328,14 @@ const Indexes = { index(on, options) {
 		where: options?.where
 	};
 } };
-
 //#endregion
 //#region src/model/constraints/index.ts
-var constraints_exports = {};
-__export(constraints_exports, {
+var constraints_exports = /* @__PURE__ */ __exportAll({
 	Constraints: () => Constraints,
 	Indexes: () => Indexes,
 	c: () => Constraints,
 	i: () => Indexes
 });
-
 //#endregion
 //#region src/domain/internal/InternalFieldType.ts
 const InternalFieldType = {
@@ -374,73 +348,61 @@ const InternalFieldType = {
 	JSONB: "jsonb",
 	UUID: "uuid"
 };
-
 //#endregion
 //#region src/domain/internal/zod/isDate.ts
 function isDate(value) {
-	return value !== null && value !== undefined && Object.prototype.toString.call(value) === "[object Date]";
+	return value !== null && value !== void 0 && Object.prototype.toString.call(value) === "[object Date]";
 }
-
 //#endregion
 //#region src/domain/internal/zod/hasConstructorName.ts
 function hasConstructorName(value, name) {
 	return !!value && typeof value === "object" && value.constructor?.name === name;
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodArray.ts
 function isZodArray(value) {
 	return hasConstructorName(value, "ZodArray");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodBoolean.ts
 function isZodBoolean(value) {
 	return hasConstructorName(value, "ZodBoolean");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodDate.ts
 function isZodDate(value) {
 	return hasConstructorName(value, "ZodDate");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodDefault.ts
 function isZodDefault(value) {
 	return hasConstructorName(value, "ZodDefault");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodNullable.ts
 function isZodNullable(value) {
 	return hasConstructorName(value, "ZodNullable");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodNumber.ts
 function isZodNumber(value) {
 	return hasConstructorName(value, "ZodNumber");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodObject.ts
 function isZodObject(value) {
 	return hasConstructorName(value, "ZodObject");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodOptional.ts
 function isZodOptional(value) {
 	return hasConstructorName(value, "ZodOptional");
 }
-
 //#endregion
 //#region src/domain/internal/zod/isZodString.ts
 function isZodString(value) {
 	return hasConstructorName(value, "ZodString");
 }
-
 //#endregion
 //#region src/model/fields/inferFieldsFromSchema.ts
 /**
@@ -451,75 +413,74 @@ function isZodString(value) {
 */
 function inferField(name, zodType, meta, registry, resolveReferenceTarget) {
 	let type;
-	let notNull$1 = true;
-	let defaultValue$1 = undefined;
+	let notNull = true;
+	let defaultValue = void 0;
 	let unwrapped = zodType;
 	if (isZodOptional(unwrapped)) {
-		notNull$1 = false;
+		notNull = false;
 		unwrapped = unwrapped.unwrap();
 	}
 	if (isZodNullable(unwrapped)) {
-		notNull$1 = false;
+		notNull = false;
 		unwrapped = unwrapped.unwrap();
 	}
 	if (isZodDefault(unwrapped)) {
 		const def = unwrapped._zod.def.defaultValue;
-		if (isDate(def)) defaultValue$1 = { now: true };
-else if (typeof def === "string" || typeof def === "number") defaultValue$1 = String(def);
+		if (isDate(def)) defaultValue = { now: true };
+		else if (typeof def === "string" || typeof def === "number") defaultValue = String(def);
 		unwrapped = unwrapped.removeDefault();
 	}
 	if (isZodString(unwrapped)) type = InternalFieldType.TEXT;
-else if (isZodNumber(unwrapped)) {
-		const checks = unwrapped._zod.def.checks ?? [];
-		const isInt = checks.some((c) => "format" in c._zod.def && c._zod.def.format === "safeint");
-		type = isInt ? InternalFieldType.INT : InternalFieldType.BIGINT;
-	} else if (isZodBoolean(unwrapped)) type = InternalFieldType.BOOL;
-else if (isZodDate(unwrapped)) type = InternalFieldType.TIMESTAMPTZ;
-else if (isZodObject(unwrapped) || isZodArray(unwrapped)) type = InternalFieldType.JSONB;
-else return null;
-	const field$1 = {
+	else if (isZodNumber(unwrapped)) type = (unwrapped._zod.def.checks ?? []).some((c) => "format" in c._zod.def && c._zod.def.format === "safeint") ? InternalFieldType.INT : InternalFieldType.BIGINT;
+	else if (isZodBoolean(unwrapped)) type = InternalFieldType.BOOL;
+	else if (isZodDate(unwrapped)) type = InternalFieldType.TIMESTAMPTZ;
+	else if (isZodObject(unwrapped) || isZodArray(unwrapped)) type = InternalFieldType.JSONB;
+	else return null;
+	const field = {
 		name,
 		type,
-		notNull: notNull$1,
-		default: defaultValue$1
+		notNull,
+		default: defaultValue
 	};
-	if (!meta) return field$1;
-	if (meta.dbColumn) field$1.name = meta.dbColumn;
-	if (typeof meta.notNull === "boolean") field$1.notNull = meta.notNull;
-	if (meta.default !== undefined) field$1.default = meta.default;
-	if (meta.primaryKey) field$1.primaryKey = true;
-	if (meta.unique) field$1.unique = true;
+	if (!meta) return field;
+	if (meta.dbColumn) field.name = meta.dbColumn;
+	if (typeof meta.notNull === "boolean") field.notNull = meta.notNull;
+	if (meta.default !== void 0) field.default = meta.default;
+	if (meta.primaryKey) field.primaryKey = true;
+	if (meta.unique) field.unique = true;
 	if (meta.relationKind === InternalDecoratedFieldKind.MANY_TO_MANY) return null;
 	if (meta.references) {
 		const targetMetadata = resolveReferenceTarget ? resolveReferenceTarget(meta.references.target) : resolveReferenceTargetFromRegistry(meta.references.target, registry, meta.references.options?.column);
-		field$1.references = {
+		field.references = {
 			table: targetMetadata.table,
 			column: meta.references.options?.column ?? targetMetadata.pk,
 			onDelete: meta.references.options?.onDelete,
 			onUpdate: meta.references.options?.onUpdate
 		};
 	}
-	return field$1;
+	return field;
 }
 function resolveReferenceTargetFromRegistry(target, registry, explicitColumn) {
 	const targetModel = registry.resolveRef(target);
-	const primaryKey$1 = explicitColumn ?? targetModel.metadata.fields.find((candidate) => candidate.primaryKey)?.name ?? "id";
+	const primaryKey = explicitColumn ?? targetModel.metadata.fields.find((candidate) => candidate.primaryKey)?.name ?? "id";
 	return {
 		table: targetModel.metadata.table,
-		pk: primaryKey$1
+		pk: primaryKey
 	};
 }
+/**
+* Infer Tango field metadata from a Zod object schema and any attached field decorators.
+*/
 function inferFieldsFromSchema(schema, options) {
 	const registry = options?.registry ?? ModelRegistry.global();
 	const shape = schema.shape;
 	const fields = [];
 	for (const [name, zodType] of Object.entries(shape)) {
-		const field$1 = inferField(name, zodType, getFieldMetadata(zodType), registry, options?.resolveReferenceTarget);
-		if (field$1) fields.push(field$1);
+		const field = inferField(name, zodType, getFieldMetadata(zodType), registry, options?.resolveReferenceTarget);
+		if (field) fields.push(field);
 	}
 	return fields;
 }
-
 //#endregion
 //#region src/domain/internal/InternalRelationType.ts
 const InternalRelationType = {
@@ -527,40 +488,63 @@ const InternalRelationType = {
 	BELONGS_TO: "belongsTo",
 	HAS_ONE: "hasOne"
 };
-
 //#endregion
 //#region src/model/relations/RelationBuilder.ts
+/**
+* Public authoring DSL for model-level named relations.
+*
+* This is the first stage of the relations subdomain. Application code uses it
+* inside `relations: (r) => ({ ... })` to declare stable relation names and
+* resolve ambiguity that field decorators alone cannot express.
+*
+* Later internal stages normalize these authored definitions and combine them
+* with field-authored relation metadata to build the resolved relation graph.
+*/
 var RelationBuilder = class {
 	/** Declare a one-to-many relation from this model to `target`. */
-	hasMany(target, foreignKey$1) {
+	hasMany(target, foreignKey) {
 		return {
 			type: InternalRelationType.HAS_MANY,
 			target,
-			foreignKey: foreignKey$1
+			foreignKey
 		};
 	}
 	/** Declare an owning relation to a parent model. */
-	belongsTo(target, foreignKey$1, localKey) {
+	belongsTo(target, foreignKey, localKey) {
 		return {
 			type: InternalRelationType.BELONGS_TO,
 			target,
-			foreignKey: foreignKey$1,
+			foreignKey,
 			localKey
 		};
 	}
 	/** Declare a one-to-one relation from this model to `target`. */
-	hasOne(target, foreignKey$1) {
+	hasOne(target, foreignKey) {
 		return {
 			type: InternalRelationType.HAS_ONE,
 			target,
-			foreignKey: foreignKey$1
+			foreignKey
 		};
 	}
 };
-
 //#endregion
 //#region src/model/relations/RelationDescriptorNormalizer.ts
+/**
+* Normalizes field-authored relation declarations from a model schema into the
+* shared descriptor shape consumed by storage and relation finalization.
+*
+* This is the normalization stage of the relations subdomain. It sits between
+* authoring and resolution:
+*
+* - authoring: decorators attach relation intent to schema fields
+* - normalization: this class converts that intent into a registry-independent
+*   descriptor shape
+* - resolution: the graph builder combines those descriptors with finalized
+*   storage artifacts and explicit relation names
+*/
 var RelationDescriptorNormalizer = class RelationDescriptorNormalizer {
+	sourceModelKey;
+	schema;
 	constructor(sourceModelKey, schema) {
 		this.sourceModelKey = sourceModelKey;
 		this.schema = schema;
@@ -588,7 +572,7 @@ var RelationDescriptorNormalizer = class RelationDescriptorNormalizer {
 	}
 	normalizeCandidate(candidate) {
 		const meta = getFieldMetadata(candidate.zodType);
-		if (!meta?.references || !meta.relationKind) return undefined;
+		if (!meta?.references || !meta.relationKind) return;
 		return {
 			edgeId: this.buildEdgeId(candidate.sourceSchemaFieldKey, meta.relationKind),
 			sourceModelKey: this.sourceModelKey,
@@ -619,9 +603,16 @@ var RelationDescriptorNormalizer = class RelationDescriptorNormalizer {
 		return fieldKey;
 	}
 };
-
 //#endregion
 //#region src/model/relations/SchemaNaming.ts
+/**
+* Shared naming policy for the model and relations subdomains.
+*
+* These helpers are not an authoring or graph stage on their own. They are the
+* cross-cutting policy layer used by both model construction and relation
+* resolution when Tango derives table names, aliases, and synthesized relation
+* names in a Django-style shape.
+*/
 function toSnakeCase(value) {
 	return value.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
 }
@@ -637,7 +628,6 @@ function decapitalizeModelName(name) {
 	if (name.length === 0) return name;
 	return `${name[0].toLowerCase()}${name.slice(1)}`;
 }
-
 //#endregion
 //#region src/model/internal/InternalSchemaModel.ts
 const REGISTRY_OWNER_KEY = Symbol.for("tango.schema.registryOwner");
@@ -658,7 +648,7 @@ var InternalSchemaModel = class InternalSchemaModel {
 	static create(definition, registry) {
 		InternalSchemaModel.validateDefinition(definition);
 		const builder = new RelationBuilder();
-		const relations = definition.relations ? Object.freeze(definition.relations(builder)) : undefined;
+		const relations = definition.relations ? Object.freeze(definition.relations(builder)) : void 0;
 		const key = `${definition.namespace}/${definition.name}`;
 		const table = definition.table?.trim() || deriveTableName(definition.name);
 		const normalizedRelations = RelationDescriptorNormalizer.normalize(key, definition.schema);
@@ -710,7 +700,7 @@ var InternalSchemaModel = class InternalSchemaModel {
 	static validateDefinition(definition) {
 		if (!definition.namespace.trim()) throw new Error("Model.namespace is required and cannot be empty.");
 		if (!definition.name.trim()) throw new Error("Model.name is required and cannot be empty.");
-		if (definition.table !== undefined && !definition.table.trim()) throw new Error("Model.table cannot be empty when provided.");
+		if (definition.table !== void 0 && !definition.table.trim()) throw new Error("Model.table cannot be empty when provided.");
 	}
 	static require(model) {
 		if (!InternalSchemaModel.isInternalSchemaModel(model)) throw new Error(`Model '${model.metadata.key}' is missing internal registry ownership metadata.`);
@@ -720,8 +710,7 @@ var InternalSchemaModel = class InternalSchemaModel {
 		return InternalSchemaModel.require(model);
 	}
 	static attachInternals(model, internals) {
-		const carrier = model;
-		Object.defineProperties(carrier, {
+		Object.defineProperties(model, {
 			[REGISTRY_OWNER_KEY]: {
 				value: internals.registry,
 				enumerable: false,
@@ -735,7 +724,7 @@ var InternalSchemaModel = class InternalSchemaModel {
 				writable: false
 			},
 			[EXPLICIT_FIELDS_KEY]: {
-				value: internals.explicitFields ? Object.freeze([...internals.explicitFields]) : undefined,
+				value: internals.explicitFields ? Object.freeze([...internals.explicitFields]) : void 0,
 				enumerable: false,
 				configurable: false,
 				writable: false
@@ -749,7 +738,6 @@ var InternalSchemaModel = class InternalSchemaModel {
 		});
 	}
 };
-
 //#endregion
 //#region src/model/relations/NormalizedRelationStorageDescriptor.ts
 const InternalNormalizedRelationOrigin = {
@@ -757,7 +745,6 @@ const InternalNormalizedRelationOrigin = {
 	ONE_TO_ONE: "oneToOne",
 	MANY_TO_MANY: "manyToMany"
 };
-
 //#endregion
 //#region src/model/relations/RelationSpec.ts
 const InternalRelationPublicKind = {
@@ -780,9 +767,14 @@ const InternalRelationProvenance = {
 	RELATIONS_API: "relations-api",
 	SYNTHESIZED_REVERSE: "synthesized-reverse"
 };
-
 //#endregion
 //#region src/model/relations/ImplicitManyToManyIdentifier.ts
+/**
+* Single source of truth for identity of Tango-synthesized many-to-many
+* through models. Other parts of the schema package interact with synthesized
+* models exclusively through this class so they do not have to know the
+* namespace or digest scheme those keys encode.
+*/
 var ImplicitManyToManyIdentifier = class ImplicitManyToManyIdentifier {
 	static NAMESPACE = "tango.implicit";
 	/**
@@ -834,10 +826,9 @@ var ImplicitManyToManyIdentifier = class ImplicitManyToManyIdentifier {
 		return modelKey.slice(prefix.length);
 	}
 	static digest(sourceModelKey, sourceSchemaFieldKey, targetModelKey, byteLength) {
-		return createHash$1("sha256").update(`${sourceModelKey}\0${sourceSchemaFieldKey}\0${targetModelKey}`, "utf8").digest("hex").slice(0, byteLength);
+		return createHash("sha256").update(`${sourceModelKey}\0${sourceSchemaFieldKey}\0${targetModelKey}`, "utf8").digest("hex").slice(0, byteLength);
 	}
 };
-
 //#endregion
 //#region src/domain/internal/InternalReferentialAction.ts
 const InternalReferentialAction = {
@@ -846,7 +837,6 @@ const InternalReferentialAction = {
 	RESTRICT: "RESTRICT",
 	NO_ACTION: "NO ACTION"
 };
-
 //#endregion
 //#region src/model/relations/ImplicitManyToManyThroughFactory.ts
 var ImplicitManyToManyThroughFactory = class ImplicitManyToManyThroughFactory {
@@ -941,11 +931,7 @@ var ImplicitManyToManyThroughFactory = class ImplicitManyToManyThroughFactory {
 	}
 	static clonePrimaryKeySchemaForForeignKey(zodType) {
 		const unwrapped = ImplicitManyToManyThroughFactory.unwrapForForeignKeyField(zodType);
-		if (isZodNumber(unwrapped)) {
-			const checks = unwrapped._zod.def.checks ?? [];
-			const isInt = checks.some((check) => "format" in check._zod.def && check._zod.def.format === "safeint");
-			return isInt ? z.number().int() : z.number();
-		}
+		if (isZodNumber(unwrapped)) return (unwrapped._zod.def.checks ?? []).some((check) => "format" in check._zod.def && check._zod.def.format === "safeint") ? z.number().int() : z.number();
 		if (isZodString(unwrapped)) return z.string();
 		if (isZodBoolean(unwrapped)) return z.boolean();
 		if (isZodDate(unwrapped)) return z.date();
@@ -955,10 +941,7 @@ var ImplicitManyToManyThroughFactory = class ImplicitManyToManyThroughFactory {
 	}
 	static readSinglePrimaryKey(model) {
 		const keys = [];
-		for (const [fieldKey$1, zodType$1] of Object.entries(model.schema.shape)) {
-			const meta$1 = getFieldMetadata(zodType$1);
-			if (meta$1?.primaryKey) keys.push(fieldKey$1);
-		}
+		for (const [fieldKey, zodType] of Object.entries(model.schema.shape)) if (getFieldMetadata(zodType)?.primaryKey) keys.push(fieldKey);
 		if (keys.length !== 1) throw new Error(`Implicit many-to-many requires model '${model.metadata.key}' to declare exactly one primary key field.`);
 		const fieldKey = keys[0];
 		const zodType = model.schema.shape[fieldKey];
@@ -990,7 +973,6 @@ var ImplicitManyToManyThroughFactory = class ImplicitManyToManyThroughFactory {
 		return candidate;
 	}
 };
-
 //#endregion
 //#region src/model/relations/ResolvedRelationGraphBuilder.ts
 const REFERENCE_CAPABILITIES = Object.freeze({
@@ -1004,10 +986,24 @@ const MANY_TO_MANY_CAPABILITIES = Object.freeze({
 	hydratable: true
 });
 const RELATION_NAME_SEPARATOR = ":";
+/**
+* Resolution-stage builder that turns normalized relation descriptors into the
+* registry-scoped resolved relation graph.
+*
+* This is the final pipeline stage in the relations subdomain. It combines:
+*
+* - normalized field-authored relation descriptors
+* - explicit model-level relation names from `RelationBuilder`
+* - finalized storage artifacts from the registry
+*
+* The result is the canonical named relation graph used by ORM-facing
+* consumers.
+*/
 var ResolvedRelationGraphBuilder = class ResolvedRelationGraphBuilder {
-	byModel = new Map();
-	byEdgeId = new Map();
-	matchedOverrides = new Set();
+	options;
+	byModel = /* @__PURE__ */ new Map();
+	byEdgeId = /* @__PURE__ */ new Map();
+	matchedOverrides = /* @__PURE__ */ new Set();
 	constructor(options) {
 		this.options = options;
 	}
@@ -1160,8 +1156,7 @@ var ResolvedRelationGraphBuilder = class ResolvedRelationGraphBuilder {
 		const reverseModelRelations = InternalSchemaModel.getExplicitRelations(targetModel) ?? {};
 		const reverseKind = descriptor.unique ? InternalRelationPublicKind.HAS_ONE : InternalRelationPublicKind.HAS_MANY;
 		return Object.entries(reverseModelRelations).find(([, relation]) => {
-			const relationTargetKey = this.resolveRelationTargetKey(targetModel, relation.target);
-			return relationTargetKey === sourceModel.metadata.key && relation.type === reverseKind && relation.foreignKey === descriptor.sourceSchemaFieldKey;
+			return this.resolveRelationTargetKey(targetModel, relation.target) === sourceModel.metadata.key && relation.type === reverseKind && relation.foreignKey === descriptor.sourceSchemaFieldKey;
 		});
 	}
 	assertAllOverridesMatched(model) {
@@ -1173,9 +1168,8 @@ var ResolvedRelationGraphBuilder = class ResolvedRelationGraphBuilder {
 		}
 	}
 	addResolvedRelation(descriptor) {
-		const modelRelations = this.byModel.get(descriptor.sourceModelKey) ?? new Map();
-		const existing = modelRelations.get(descriptor.name);
-		if (existing) throw new Error(`Ambiguous relation name '${descriptor.name}' on model '${descriptor.sourceModelKey}'. Add an explicit relations override.`);
+		const modelRelations = this.byModel.get(descriptor.sourceModelKey) ?? /* @__PURE__ */ new Map();
+		if (modelRelations.get(descriptor.name)) throw new Error(`Ambiguous relation name '${descriptor.name}' on model '${descriptor.sourceModelKey}'. Add an explicit relations override.`);
 		modelRelations.set(descriptor.name, descriptor);
 		this.byModel.set(descriptor.sourceModelKey, modelRelations);
 		this.byEdgeId.set(descriptor.edgeId, descriptor);
@@ -1199,16 +1193,21 @@ var ResolvedRelationGraphBuilder = class ResolvedRelationGraphBuilder {
 		return cardinality === InternalRelationCardinality.MANY ? pluralize(snake) : snake;
 	}
 };
-
 //#endregion
 //#region src/model/registry/GeneratedRelationRegistryArtifact.ts
 const GENERATED_RELATION_REGISTRY_DIRNAME = ".tango";
 const GENERATED_RELATION_REGISTRY_TYPES_FILENAME = "relations.generated.d.ts";
 const GENERATED_RELATION_REGISTRY_METADATA_FILENAME = "relations.generated.json";
 const GENERATED_RELATION_REGISTRY_METADATA_VERSION = 1;
-
 //#endregion
 //#region src/model/registry/ResolvedRelationGraphArtifactFactory.ts
+/**
+* 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.
+*/
 var ResolvedRelationGraphArtifactFactory = class ResolvedRelationGraphArtifactFactory {
 	static createSnapshot(graph) {
 		return ResolvedRelationGraphBuilder.createSnapshot(graph);
@@ -1218,14 +1217,22 @@ var ResolvedRelationGraphArtifactFactory = class ResolvedRelationGraphArtifactFa
 		return createHash("sha256").update(JSON.stringify(snapshot)).digest("hex");
 	}
 };
-
 //#endregion
 //#region src/model/registry/ModelRegistry.ts
 const DEFAULT_IDENTIFIER_NAME = "id";
 const ACTIVE_REGISTRY_STORAGE_KEY = Symbol.for("tango.schema.activeRegistryStorage");
+/**
+* Registry that resolves Tango models by stable identity.
+*
+* 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.
+*/
 var ModelRegistry = class ModelRegistry {
 	static globalRegistry;
-	models = new Map();
+	models = /* @__PURE__ */ new Map();
 	version = 0;
 	storageCache;
 	relationGraphCache;
@@ -1307,8 +1314,7 @@ var ModelRegistry = class ModelRegistry {
 	* Register a model on this registry instance.
 	*/
 	register(model) {
-		const owner = InternalSchemaModel.getRegistryOwner(model);
-		if (owner !== this) throw new Error(`Model '${model.metadata.key}' belongs to a different registry and cannot be registered here.`);
+		if (InternalSchemaModel.getRegistryOwner(model) !== this) throw new Error(`Model '${model.metadata.key}' belongs to a different registry and cannot be registered here.`);
 		const existing = this.models.get(model.metadata.key);
 		if (existing && existing !== model) throw new Error(`Model '${model.metadata.key}' is already registered in this registry.`);
 		this.models.set(model.metadata.key, model);
@@ -1338,9 +1344,9 @@ var ModelRegistry = class ModelRegistry {
 	resolveRef(ref) {
 		if (typeof ref === "string" || isTypedModelRef(ref)) {
 			const key = typeof ref === "string" ? ref : ref.key;
-			const model$1 = this.getByKey(key);
-			if (!model$1) throw new Error(`Unable to resolve model reference '${key}'. Ensure it is registered in ModelRegistry.`);
-			return model$1;
+			const model = this.getByKey(key);
+			if (!model) throw new Error(`Unable to resolve model reference '${key}'. Ensure it is registered in ModelRegistry.`);
+			return model;
 		}
 		const model = typeof ref === "function" ? ref() : ref;
 		if (InternalSchemaModel.getRegistryOwner(model) !== this) throw new Error(`Model reference '${model.metadata.key}' belongs to a different registry and cannot be resolved here.`);
@@ -1355,9 +1361,9 @@ var ModelRegistry = class ModelRegistry {
 		const implicitThroughModels = ImplicitManyToManyThroughFactory.buildModels(this);
 		for (const model of implicitThroughModels) this.models.set(model.metadata.key, model);
 		if (strippedImplicit || implicitThroughModels.length > 0) this.bumpVersion();
-		const primaryKeyByModel = new Map();
+		const primaryKeyByModel = /* @__PURE__ */ new Map();
 		for (const model of this.models.values()) primaryKeyByModel.set(model.metadata.key, this.inferPrimaryKeyName(model));
-		const byModel = new Map();
+		const byModel = /* @__PURE__ */ new Map();
 		for (const model of this.models.values()) {
 			const explicitFields = InternalSchemaModel.getExplicitFields(model);
 			const inferredFields = inferFieldsFromSchema(model.schema, {
@@ -1371,12 +1377,12 @@ var ModelRegistry = class ModelRegistry {
 				}
 			});
 			const fields = this.freezeFields(this.mergeStorageFields(inferredFields, explicitFields));
-			const primaryKey$1 = fields.find((field$1) => field$1.primaryKey)?.name ?? DEFAULT_IDENTIFIER_NAME;
+			const primaryKey = fields.find((field) => field.primaryKey)?.name ?? DEFAULT_IDENTIFIER_NAME;
 			byModel.set(model.metadata.key, {
 				key: model.metadata.key,
 				table: model.metadata.table,
 				fields,
-				pk: primaryKey$1
+				pk: primaryKey
 			});
 		}
 		const finalized = {
@@ -1438,9 +1444,9 @@ var ModelRegistry = class ModelRegistry {
 	}
 	bumpVersion() {
 		this.version += 1;
-		this.storageCache = undefined;
-		this.relationGraphCache = undefined;
-		this.lastRelationRegistryDriftCheckVersion = undefined;
+		this.storageCache = void 0;
+		this.relationGraphCache = void 0;
+		this.lastRelationRegistryDriftCheckVersion = void 0;
 	}
 	stripImplicitManyToManyModels() {
 		let removed = false;
@@ -1451,7 +1457,7 @@ var ModelRegistry = class ModelRegistry {
 		return removed;
 	}
 	freezeFields(fields) {
-		return Object.freeze(fields.map((field$1) => Object.freeze({ ...field$1 })));
+		return Object.freeze(fields.map((field) => Object.freeze({ ...field })));
 	}
 	inferPrimaryKeyName(model) {
 		for (const [fieldKey, zodType] of Object.entries(model.schema.shape)) {
@@ -1459,12 +1465,12 @@ var ModelRegistry = class ModelRegistry {
 			if (meta?.primaryKey) return meta.dbColumn ?? fieldKey;
 		}
 		const explicitFields = InternalSchemaModel.getExplicitFields(model);
-		if (explicitFields) return explicitFields.find((field$1) => field$1.primaryKey)?.name ?? DEFAULT_IDENTIFIER_NAME;
+		if (explicitFields) return explicitFields.find((field) => field.primaryKey)?.name ?? DEFAULT_IDENTIFIER_NAME;
 		return DEFAULT_IDENTIFIER_NAME;
 	}
 	mergeStorageFields(inferredFields, explicitFields) {
 		if (!explicitFields?.length) return inferredFields;
-		const mergedFields = new Map(inferredFields.map((field$1) => [field$1.name, field$1]));
+		const mergedFields = new Map(inferredFields.map((field) => [field.name, field]));
 		for (const explicitField of explicitFields) mergedFields.set(explicitField.name, explicitField);
 		return Array.from(mergedFields.values());
 	}
@@ -1475,26 +1481,25 @@ var ModelRegistry = class ModelRegistry {
 		if (!expected) return;
 		const liveSnapshot = ResolvedRelationGraphArtifactFactory.createSnapshot(graph);
 		if (this.isPartialRegistrySnapshot(liveSnapshot, expected.snapshot)) return;
-		const liveFingerprint = ResolvedRelationGraphArtifactFactory.createFingerprint(liveSnapshot);
-		if (liveFingerprint === expected.fingerprint) return;
+		if (ResolvedRelationGraphArtifactFactory.createFingerprint(liveSnapshot) === expected.fingerprint) return;
 		getLogger("tango.schema.registry").warn(`Generated relation registry drift detected. Run 'tango codegen relations' to refresh ${GENERATED_RELATION_REGISTRY_DIRNAME}/${GENERATED_RELATION_REGISTRY_METADATA_FILENAME}.`);
 	}
 	shouldCheckGeneratedRelationRegistry() {
 		return process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test";
 	}
 	readGeneratedRelationRegistryArtifact() {
-		const metadataPath = resolve$1(process.cwd(), GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME);
-		if (!existsSync$1(metadataPath)) return undefined;
+		const metadataPath = resolve(process.cwd(), GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME);
+		if (!existsSync(metadataPath)) return;
 		try {
 			const parsed = JSON.parse(readFileSync(metadataPath, "utf8"));
-			if (parsed.version !== GENERATED_RELATION_REGISTRY_METADATA_VERSION || typeof parsed.fingerprint !== "string" || !parsed.snapshot || !Array.isArray(parsed.snapshot.models)) {
+			if (parsed.version !== 1 || typeof parsed.fingerprint !== "string" || !parsed.snapshot || !Array.isArray(parsed.snapshot.models)) {
 				getLogger("tango.schema.registry").warn(`Ignoring malformed generated relation registry metadata at '${metadataPath}'.`);
-				return undefined;
+				return;
 			}
 			return parsed;
 		} catch (error) {
 			getLogger("tango.schema.registry").warn(`Unable to read generated relation registry metadata at '${metadataPath}'.`, error);
-			return undefined;
+			return;
 		}
 	}
 	isPartialRegistrySnapshot(liveSnapshot, expectedSnapshot) {
@@ -1508,10 +1513,16 @@ var ModelRegistry = class ModelRegistry {
 		return true;
 	}
 };
-
 //#endregion
 //#region src/resolveSchemaModuleEntrypoint.ts
 const LOCAL_ENTRYPOINT_CANDIDATES = ["./index.ts", "./index.js"];
+/**
+* Resolve the current package root entrypoint for `@danceroutine/tango-schema`.
+*
+* Tooling loaders alias app-side `@danceroutine/tango-schema` imports back to
+* this path so project modules reuse the same schema package instance across
+* workspace-source and published-dist environments.
+*/
 function resolveSchemaModuleEntrypoint() {
 	for (const relativePath of LOCAL_ENTRYPOINT_CANDIDATES) {
 		const absolutePath = fileURLToPath(new URL(relativePath, import.meta.url));
@@ -1519,6 +1530,17 @@ function resolveSchemaModuleEntrypoint() {
 	}
 	throw new Error(`Unable to resolve the @danceroutine/tango-schema entrypoint relative to '${fileURLToPath(import.meta.url)}'.`);
 }
+/**
+* Return explicit Jiti alias entries for the schema package root and its
+* public subpaths so app modules always reuse the same schema package instance.
+*
+* @internal
+* Exported for Tango tooling/framework consumption only. This helper exists so
+* Tango loaders can force app modules to reuse the active schema package
+* instance during module execution. It is not intended as a stable application
+* API, and the alias map may be more permissive than the package exports
+* surface by design.
+*/
 function createSchemaModuleAliases() {
 	const entrypoint = resolveSchemaModuleEntrypoint();
 	const packageRoot = dirname(entrypoint);
@@ -1533,29 +1555,27 @@ function createSchemaModuleAliases() {
 		"@danceroutine/tango-schema/": `${packageRoot}/`
 	};
 }
-
 //#endregion
 //#region src/model/registry/index.ts
-var registry_exports = {};
-__export(registry_exports, {
+var registry_exports = /* @__PURE__ */ __exportAll({
 	GENERATED_RELATION_REGISTRY_DIRNAME: () => GENERATED_RELATION_REGISTRY_DIRNAME,
 	GENERATED_RELATION_REGISTRY_METADATA_FILENAME: () => GENERATED_RELATION_REGISTRY_METADATA_FILENAME,
-	GENERATED_RELATION_REGISTRY_METADATA_VERSION: () => GENERATED_RELATION_REGISTRY_METADATA_VERSION,
+	GENERATED_RELATION_REGISTRY_METADATA_VERSION: () => 1,
 	GENERATED_RELATION_REGISTRY_TYPES_FILENAME: () => GENERATED_RELATION_REGISTRY_TYPES_FILENAME,
 	ModelRegistry: () => ModelRegistry,
 	ResolvedRelationGraphArtifactFactory: () => ResolvedRelationGraphArtifactFactory,
 	createSchemaModuleAliases: () => createSchemaModuleAliases,
 	resolveSchemaModuleEntrypoint: () => resolveSchemaModuleEntrypoint
 });
-
 //#endregion
 //#region src/model/relations/index.ts
-var relations_exports = {};
-__export(relations_exports, { RelationBuilder: () => RelationBuilder });
-
+var relations_exports = /* @__PURE__ */ __exportAll({ RelationBuilder: () => RelationBuilder });
 //#endregion
 //#region src/model/ModelAugmentorRegistry.ts
-const modelAugmentors = new Set();
+const modelAugmentors = /* @__PURE__ */ new Set();
+/**
+* Register a model augmentor that runs for existing and future models.
+*/
 function registerModelAugmentor(augmentor) {
 	modelAugmentors.add(augmentor);
 	for (const model of ModelRegistry.global().values()) augmentor(model);
@@ -1563,29 +1583,33 @@ function registerModelAugmentor(augmentor) {
 		modelAugmentors.delete(augmentor);
 	};
 }
+/**
+* Apply all registered augmentors to a model before it is returned publicly.
+*/
 function applyModelAugmentors(model) {
 	for (const augmentor of modelAugmentors) augmentor(model);
 	return model;
 }
-
 //#endregion
 //#region src/model/Model.ts
+/**
+* Creates a model definition with metadata and schema validation.
+* Automatically finalizes field types through the owning model registry.
+*/
 function Model(definition) {
 	const registry = definition.registry ?? ModelRegistry.active();
 	const model = applyModelAugmentors(InternalSchemaModel.create(definition, registry));
 	registry.register(model);
 	return model;
 }
-
 //#endregion
 //#region src/model/index.ts
-var model_exports = {};
-__export(model_exports, {
+var model_exports = /* @__PURE__ */ __exportAll({
 	Constraints: () => Constraints,
 	Decorators: () => Decorators,
 	GENERATED_RELATION_REGISTRY_DIRNAME: () => GENERATED_RELATION_REGISTRY_DIRNAME,
 	GENERATED_RELATION_REGISTRY_METADATA_FILENAME: () => GENERATED_RELATION_REGISTRY_METADATA_FILENAME,
-	GENERATED_RELATION_REGISTRY_METADATA_VERSION: () => GENERATED_RELATION_REGISTRY_METADATA_VERSION,
+	GENERATED_RELATION_REGISTRY_METADATA_VERSION: () => 1,
 	GENERATED_RELATION_REGISTRY_TYPES_FILENAME: () => GENERATED_RELATION_REGISTRY_TYPES_FILENAME,
 	ImplicitManyToManyIdentifier: () => ImplicitManyToManyIdentifier,
 	Indexes: () => Indexes,
@@ -1610,7 +1634,7 @@ __export(model_exports, {
 	resolveSchemaModuleEntrypoint: () => resolveSchemaModuleEntrypoint,
 	t: () => Decorators
 });
-
 //#endregion
-export { Constraints, Decorators, GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, ImplicitManyToManyIdentifier, Indexes, InternalDecoratedFieldKind, Meta, Model, ModelRegistry, RelationBuilder, ResolvedRelationGraphArtifactFactory, constraints_exports, createSchemaModuleAliases, createTypedModelRef, decorators_exports, isTypedModelRef, meta_exports, model_exports, registerModelAugmentor, registry_exports, relations_exports, resolveSchemaModuleEntrypoint };
-//# sourceMappingURL=model-upj6jxaK.js.map
+export { InternalDecoratedFieldKind as C, Decorators as S, isTypedModelRef as T, Indexes as _, registry_exports as a, Meta as b, ModelRegistry as c, GENERATED_RELATION_REGISTRY_METADATA_FILENAME as d, GENERATED_RELATION_REGISTRY_METADATA_VERSION as f, constraints_exports as g, RelationBuilder as h, relations_exports as i, ResolvedRelationGraphArtifactFactory as l, ImplicitManyToManyIdentifier as m, Model as n, createSchemaModuleAliases as o, GENERATED_RELATION_REGISTRY_TYPES_FILENAME as p, registerModelAugmentor as r, resolveSchemaModuleEntrypoint as s, model_exports as t, GENERATED_RELATION_REGISTRY_DIRNAME as u, Constraints as v, createTypedModelRef as w, decorators_exports as x, meta_exports as y };
+
+//# sourceMappingURL=model-aRAusQPz.js.map