@prisma/orm-framework 0.16.0

package/dist/contract-authoring.mjs

@@ -0,0 +1,133 @@
+import { t as blindCast } from "./casts-DpaahrlC-Bd5n2coI.mjs";
+import { a as structuredError } from "./structured-error-H6WU9Kjt.mjs";
+import { c as instantiateAuthoringEntityType } from "./framework-authoring-CDEvlouU-mlMWSksD.mjs";
+//#region ../../../1-framework/2-authoring/contract/dist/index.mjs
+/**
+* Deep-merges any number of capability matrices into a single matrix.
+*
+* Merge is purely structural — namespaces and capability flags from later
+* sources overlay earlier ones. Undefined entries are skipped so callers
+* can pass optional sources without pre-filtering.
+*
+* The helper is target-agnostic: it contains no SQL or family-specific
+* knowledge. Higher layers contribute their own capability matrices (for
+* example, a target pack, an extension pack, or the contract author's
+* own `capabilities` block) and call this helper to fold them together.
+*/
+function mergeCapabilityMatrices(...sources) {
+	const result = {};
+	for (const source of sources) {
+		if (source === void 0) continue;
+		for (const [namespace, capabilities] of Object.entries(source)) {
+			const existing = result[namespace];
+			result[namespace] = existing ? {
+				...existing,
+				...capabilities
+			} : { ...capabilities };
+		}
+	}
+	return result;
+}
+/**
+* Walks an entity-type namespace (after cross-pack merge) and produces the
+* runtime callable surface mirroring its tree shape. Each leaf
+* descriptor becomes a function `(input) => factory(input, ctx)`;
+* nested namespace objects recurse.
+*/
+function createEntityHelpersFromNamespace(namespace, options, path = []) {
+	const result = {};
+	for (const [key, value] of Object.entries(namespace)) {
+		const currentPath = [...path, key];
+		if (isLeafEntityDescriptor(value)) {
+			result[key] = createEntityHelper(currentPath.join("."), value, options);
+			continue;
+		}
+		if (typeof value === "object" && value !== null && !Array.isArray(value)) result[key] = createEntityHelpersFromNamespace(value, options, currentPath);
+	}
+	return result;
+}
+function isLeafEntityDescriptor(value) {
+	if (typeof value !== "object" || value === null || value.kind !== "entity") return false;
+	const discriminator = value.discriminator;
+	return typeof discriminator === "string" && discriminator.length > 0;
+}
+function createEntityHelper(helperPath, descriptor, options) {
+	return (...args) => instantiateAuthoringEntityType(helperPath, descriptor, args, options.ctx);
+}
+function contractError(code, message, options) {
+	return structuredError(code, message, options);
+}
+function member(name, value) {
+	return {
+		name,
+		value: blindCast(value === void 0 ? name : value)
+	};
+}
+const ENUM_TYPE_HANDLE_BRAND = "__prismaNextEnumTypeHandle__";
+function enumType(name, codec, ...members) {
+	if (members.length === 0) throw contractError("CONTRACT.ENUM_INVALID", `enumType("${name}"): must have at least one member.`, { meta: {
+		enumName: name,
+		reason: "no-members"
+	} });
+	const seenNames = /* @__PURE__ */ new Set();
+	const seenValues = /* @__PURE__ */ new Set();
+	for (const m of members) {
+		if (seenNames.has(m.name)) throw contractError("CONTRACT.ENUM_INVALID", `enumType("${name}"): duplicate member name "${m.name}". Member names must be unique.`, { meta: {
+			enumName: name,
+			member: m.name,
+			reason: "duplicate-member-name"
+		} });
+		seenNames.add(m.name);
+		const loweredValue = String(m.value);
+		if (seenValues.has(loweredValue)) throw contractError("CONTRACT.ENUM_INVALID", `enumType("${name}"): duplicate member value "${loweredValue}". Member values must be unique.`, { meta: {
+			enumName: name,
+			member: loweredValue,
+			reason: "duplicate-member-value"
+		} });
+		seenValues.add(loweredValue);
+	}
+	const values = Object.freeze(members.map((m) => m.value));
+	const names = Object.freeze(members.map((m) => m.name));
+	const enumMembers = Object.freeze(members.map((m) => ({
+		name: m.name,
+		value: m.value
+	})));
+	const membersAccessor = Object.freeze(Object.fromEntries(members.map((m) => [m.name, m.value])));
+	const valueSet = new Set(values);
+	const valueToName = new Map(members.map((m) => [m.value, m.name]));
+	const valueToOrdinal = new Map(values.map((v, i) => [v, i]));
+	return {
+		[ENUM_TYPE_HANDLE_BRAND]: true,
+		enumName: name,
+		codecId: codec.codecId,
+		nativeType: codec.nativeType,
+		enumMembers,
+		values,
+		names,
+		members: membersAccessor,
+		has: (v) => valueSet.has(v),
+		nameOf: (v) => valueToName.get(v),
+		ordinalOf: (v) => valueToOrdinal.get(v) ?? -1
+	};
+}
+/**
+* Bind `enumType` to a target's codec typemap. The returned function is the
+* same runtime `enumType`, retyped so member values are constrained to the
+* codec's input type. Target packages call this with their pack's
+* `ExtractCodecTypesFromPack<Pack>` to expose a codec-aware `enumType`.
+*/
+function bindEnumType() {
+	return enumType;
+}
+/**
+* Returns true when the value is an `EnumTypeHandle` produced by
+* `enumType()`. Used in the lowering pipeline to detect enum handles
+* in field state without importing the brand key at every call site.
+*/
+function isEnumTypeHandle(value) {
+	return typeof value === "object" && value !== null && Reflect.get(value, "__prismaNextEnumTypeHandle__") === true;
+}
+//#endregion
+export { ENUM_TYPE_HANDLE_BRAND, bindEnumType, createEntityHelpersFromNamespace, enumType, isEnumTypeHandle, member, mergeCapabilityMatrices };
+
+//# sourceMappingURL=contract-authoring.mjs.map

package/dist/contract-authoring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-authoring.mjs","names":[],"sources":["../../../../1-framework/2-authoring/contract/dist/index.mjs"],"sourcesContent":["import { instantiateAuthoringEntityType } from \"@internal/framework-components/authoring\";\nimport { blindCast } from \"@internal/utils/casts\";\nimport { structuredError } from \"@internal/utils/structured-error\";\n//#region src/capability-registry.ts\n/**\n* Deep-merges any number of capability matrices into a single matrix.\n*\n* Merge is purely structural — namespaces and capability flags from later\n* sources overlay earlier ones. Undefined entries are skipped so callers\n* can pass optional sources without pre-filtering.\n*\n* The helper is target-agnostic: it contains no SQL or family-specific\n* knowledge. Higher layers contribute their own capability matrices (for\n* example, a target pack, an extension pack, or the contract author's\n* own `capabilities` block) and call this helper to fold them together.\n*/\nfunction mergeCapabilityMatrices(...sources) {\n\tconst result = {};\n\tfor (const source of sources) {\n\t\tif (source === void 0) continue;\n\t\tfor (const [namespace, capabilities] of Object.entries(source)) {\n\t\t\tconst existing = result[namespace];\n\t\t\tresult[namespace] = existing ? {\n\t\t\t\t...existing,\n\t\t\t\t...capabilities\n\t\t\t} : { ...capabilities };\n\t\t}\n\t}\n\treturn result;\n}\n//#endregion\n//#region src/composed-helpers-scaffolding.ts\n/**\n* Walks an entity-type namespace (after cross-pack merge) and produces the\n* runtime callable surface mirroring its tree shape. Each leaf\n* descriptor becomes a function `(input) => factory(input, ctx)`;\n* nested namespace objects recurse.\n*/\nfunction createEntityHelpersFromNamespace(namespace, options, path = []) {\n\tconst result = {};\n\tfor (const [key, value] of Object.entries(namespace)) {\n\t\tconst currentPath = [...path, key];\n\t\tif (isLeafEntityDescriptor(value)) {\n\t\t\tresult[key] = createEntityHelper(currentPath.join(\".\"), value, options);\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"object\" && value !== null && !Array.isArray(value)) result[key] = createEntityHelpersFromNamespace(value, options, currentPath);\n\t}\n\treturn result;\n}\nfunction isLeafEntityDescriptor(value) {\n\tif (typeof value !== \"object\" || value === null || value.kind !== \"entity\") return false;\n\tconst discriminator = value.discriminator;\n\treturn typeof discriminator === \"string\" && discriminator.length > 0;\n}\nfunction createEntityHelper(helperPath, descriptor, options) {\n\treturn (...args) => instantiateAuthoringEntityType(helperPath, descriptor, args, options.ctx);\n}\n//#endregion\n//#region src/contract-errors.ts\nfunction contractError(code, message, options) {\n\treturn structuredError(code, message, options);\n}\n//#endregion\n//#region src/enum-type.ts\nfunction member(name, value) {\n\treturn {\n\t\tname,\n\t\tvalue: blindCast(value === void 0 ? name : value)\n\t};\n}\nconst ENUM_TYPE_HANDLE_BRAND = \"__prismaNextEnumTypeHandle__\";\nfunction enumType(name, codec, ...members) {\n\tif (members.length === 0) throw contractError(\"CONTRACT.ENUM_INVALID\", `enumType(\"${name}\"): must have at least one member.`, { meta: {\n\t\tenumName: name,\n\t\treason: \"no-members\"\n\t} });\n\tconst seenNames = /* @__PURE__ */ new Set();\n\tconst seenValues = /* @__PURE__ */ new Set();\n\tfor (const m of members) {\n\t\tif (seenNames.has(m.name)) throw contractError(\"CONTRACT.ENUM_INVALID\", `enumType(\"${name}\"): duplicate member name \"${m.name}\". Member names must be unique.`, { meta: {\n\t\t\tenumName: name,\n\t\t\tmember: m.name,\n\t\t\treason: \"duplicate-member-name\"\n\t\t} });\n\t\tseenNames.add(m.name);\n\t\tconst loweredValue = String(m.value);\n\t\tif (seenValues.has(loweredValue)) throw contractError(\"CONTRACT.ENUM_INVALID\", `enumType(\"${name}\"): duplicate member value \"${loweredValue}\". Member values must be unique.`, { meta: {\n\t\t\tenumName: name,\n\t\t\tmember: loweredValue,\n\t\t\treason: \"duplicate-member-value\"\n\t\t} });\n\t\tseenValues.add(loweredValue);\n\t}\n\tconst values = Object.freeze(members.map((m) => m.value));\n\tconst names = Object.freeze(members.map((m) => m.name));\n\tconst enumMembers = Object.freeze(members.map((m) => ({\n\t\tname: m.name,\n\t\tvalue: m.value\n\t})));\n\tconst membersAccessor = Object.freeze(Object.fromEntries(members.map((m) => [m.name, m.value])));\n\tconst valueSet = new Set(values);\n\tconst valueToName = new Map(members.map((m) => [m.value, m.name]));\n\tconst valueToOrdinal = new Map(values.map((v, i) => [v, i]));\n\treturn {\n\t\t[ENUM_TYPE_HANDLE_BRAND]: true,\n\t\tenumName: name,\n\t\tcodecId: codec.codecId,\n\t\tnativeType: codec.nativeType,\n\t\tenumMembers,\n\t\tvalues,\n\t\tnames,\n\t\tmembers: membersAccessor,\n\t\thas: (v) => valueSet.has(v),\n\t\tnameOf: (v) => valueToName.get(v),\n\t\tordinalOf: (v) => valueToOrdinal.get(v) ?? -1\n\t};\n}\n/**\n* Bind `enumType` to a target's codec typemap. The returned function is the\n* same runtime `enumType`, retyped so member values are constrained to the\n* codec's input type. Target packages call this with their pack's\n* `ExtractCodecTypesFromPack<Pack>` to expose a codec-aware `enumType`.\n*/\nfunction bindEnumType() {\n\treturn enumType;\n}\n/**\n* Returns true when the value is an `EnumTypeHandle` produced by\n* `enumType()`. Used in the lowering pipeline to detect enum handles\n* in field state without importing the brand key at every call site.\n*/\nfunction isEnumTypeHandle(value) {\n\treturn typeof value === \"object\" && value !== null && Reflect.get(value, \"__prismaNextEnumTypeHandle__\") === true;\n}\n//#endregion\nexport { ENUM_TYPE_HANDLE_BRAND, bindEnumType, createEntityHelpersFromNamespace, enumType, isEnumTypeHandle, member, mergeCapabilityMatrices };\n\n//# sourceMappingURL=index.mjs.map"],"mappings":"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"}

package/dist/contract-types-CkdMH7F7-9EHXSwbH.d.mts

@@ -0,0 +1,77 @@
+import { A as ExecutionHashBase, J as StorageBase, S as ContractValueObject, T as CrossReference, W as ProfileHashBase, j as ExecutionMutationDefault, n as ApplicationDomain } from "./domain-envelope-D6Wn9AmZ-BqZKTT9U.mjs";
+//#region ../../../1-framework/0-foundation/contract/dist/contract-types-CkdMH7F7.d.mts
+//#region src/control-policy.d.ts
+/**
+ * Governance posture for a storage-plane node or for the contract as a whole.
+ *
+ * - `managed`  — Prisma Next owns the full lifecycle (DDL, migrations, verification).
+ * - `tolerated` — node was found in the database but is not schema-managed; Prisma Next
+ *   leaves it untouched while tracking its existence.
+ * - `external` — node is owned by an external system; Prisma Next never emits DDL for it.
+ * - `observed` — read-only access; Prisma Next does not write to or migrate the node.
+ */
+type ControlPolicy = 'managed' | 'tolerated' | 'external' | 'observed';
+/**
+ * Resolves the effective control policy for a storage-plane node.
+ *
+ * Precedence: node-level value → contract default → `'managed'`.
+ *
+ * Both parameters are optional raw values so this function stays node-type-agnostic
+ * and can be called by any consumer (verifier, planner, etc.) without importing IR classes.
+ */
+declare function effectiveControlPolicy(nodeControl: ControlPolicy | undefined, defaultControlPolicy: ControlPolicy | undefined): ControlPolicy;
+//#endregion
+//#region src/contract-types.d.ts
+/**
+ * Execution section for the unified contract (ADR 182).
+ *
+ * Unlike the legacy {@link import('./types').ExecutionSection}, this type
+ * requires `executionHash` — when an execution section is present, its
+ * hash must be too (consistent with `StorageBase.storageHash`).
+ *
+ * @template THash  Literal hash string type for type-safe hash tracking.
+ */
+type ContractExecutionSection<THash extends string = string> = {
+  readonly executionHash: ExecutionHashBase<THash>;
+  readonly mutations: {
+    readonly defaults: ReadonlyArray<ExecutionMutationDefault>;
+  };
+};
+/**
+ * Unified contract representation (ADR 182).
+ *
+ * A `Contract` is the canonical in-memory representation of a data contract.
+ * It is model-first (domain models carry their own storage bridge) and
+ * family-parameterized (SQL, Mongo, etc. specialize via `TStorage` and model
+ * storage generics on `ContractModel`).
+ *
+ * JSON persistence fields (`schemaVersion`, `sources`) are not represented
+ * here — they are handled at the serialization boundary.
+ *
+ * @template TStorage  Family-specific storage block (extends {@link StorageBase}).
+ */
+interface Contract<TStorage extends StorageBase = StorageBase> {
+  readonly target: string;
+  readonly targetFamily: string;
+  readonly roots: Record<string, CrossReference>;
+  /**
+   * Application plane (ADR 221): `domain.namespaces.<nsId>.{ models, valueObjects }`.
+   */
+  readonly domain: ApplicationDomain;
+  readonly storage: TStorage;
+  readonly capabilities: Record<string, Record<string, boolean>>;
+  readonly extensions: Record<string, unknown>;
+  readonly execution?: ContractExecutionSection;
+  readonly profileHash: ProfileHashBase<string>;
+  readonly meta: Record<string, unknown>;
+  readonly defaultControlPolicy?: ControlPolicy;
+}
+type ExactlyOneNamespace<T extends Record<string, unknown>> = keyof T extends (infer Only extends keyof T) ? [keyof T] extends [Only] ? Only : never : never;
+type NamespaceValueObjectsOf<TNamespace> = TNamespace extends {
+  readonly valueObjects?: infer VO;
+} ? VO extends Record<string, ContractValueObject> ? VO : Record<never, never> : Record<never, never>;
+/** Value-object map when the contract declares exactly one domain namespace. */
+type ContractValueObjectDefinitions<TContract extends Contract> = NamespaceValueObjectsOf<TContract['domain']['namespaces'][ExactlyOneNamespace<TContract['domain']['namespaces']>]> extends (infer Projected) ? Projected extends Record<string, ContractValueObject> ? Projected : Record<never, never> : Record<never, never>;
+//#endregion
+export { effectiveControlPolicy as a, ControlPolicy as i, ContractExecutionSection as n, ContractValueObjectDefinitions as r, Contract as t };
+//# sourceMappingURL=contract-types-CkdMH7F7-9EHXSwbH.d.mts.map

package/dist/contract-types-CkdMH7F7-9EHXSwbH.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-types-CkdMH7F7-9EHXSwbH.d.mts","names":[],"sources":["../../../../1-framework/0-foundation/contract/dist/contract-types-CkdMH7F7.d.mts"],"mappings":";;;;;;;;;;;;KAWK;;;;;;;;;iBASY,uBAAuB,aAAa,2BAA2B,sBAAsB,4BAA4B;;;;;;;;;;;;KAY7H,yBAAyB;WACnB,eAAe,kBAAkB;WACjC;aACE,UAAU,cAAc;;;;;;;;;;;;;;;;UAgB3B,SAAS,iBAAiB,cAAc;WACvC;WACA;WACA,OAAO,eAAe;;;;WAItB,QAAQ;WACR,SAAS;WACT,cAAc,eAAe;WAC7B,YAAY;WACZ,YAAY;WACZ,aAAa;WACb,MAAM;WACN,uBAAuB;;KAE7B,oBAAoB,UAAU,iCAAiC,iBAAiB,mBAAmB,YAAY,YAAY,QAAQ;KACnI,wBAAwB,cAAc;WAChC,qBAAqB;IAC5B,WAAW,eAAe,uBAAuB,KAAK,uBAAuB;;KAE5E,+BAA+B,kBAAkB,YAAY,wBAAwB,kCAAkC,oBAAoB,oDAAoD,aAAa,kBAAkB,eAAe,uBAAuB,YAAY,uBAAuB"}

package/dist/contract-validation-error-DEiWp_EI-CRwtUgRw.mjs

@@ -0,0 +1,14 @@
+//#region ../../../1-framework/0-foundation/contract/dist/contract-validation-error-DEiWp_EI.mjs
+var ContractValidationError = class extends Error {
+	code = "CONTRACT.VALIDATION_FAILED";
+	phase;
+	constructor(message, phase) {
+		super(message);
+		this.name = "ContractValidationError";
+		this.phase = phase;
+	}
+};
+//#endregion
+export { ContractValidationError as t };
+
+//# sourceMappingURL=contract-validation-error-DEiWp_EI-CRwtUgRw.mjs.map

package/dist/contract-validation-error-DEiWp_EI-CRwtUgRw.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-validation-error-DEiWp_EI-CRwtUgRw.mjs","names":[],"sources":["../../../../1-framework/0-foundation/contract/dist/contract-validation-error-DEiWp_EI.mjs"],"sourcesContent":["//#region src/contract-validation-error.ts\nvar ContractValidationError = class extends Error {\n\tcode = \"CONTRACT.VALIDATION_FAILED\";\n\tphase;\n\tconstructor(message, phase) {\n\t\tsuper(message);\n\t\tthis.name = \"ContractValidationError\";\n\t\tthis.phase = phase;\n\t}\n};\n//#endregion\nexport { ContractValidationError as t };\n\n//# sourceMappingURL=contract-validation-error-DEiWp_EI.mjs.map"],"mappings":";AACA,IAAI,0BAA0B,cAAc,MAAM;CACjD,OAAO;CACP;CACA,YAAY,SAAS,OAAO;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,QAAQ;CACd;AACD"}

package/dist/contract-validation-error-R7cMoK04.d.mts

@@ -0,0 +1,11 @@
+//#region ../../../1-framework/0-foundation/contract/dist/contract-validation-error.d.mts
+//#region src/contract-validation-error.d.ts
+type ContractValidationPhase = 'structural' | 'domain' | 'storage';
+declare class ContractValidationError extends Error {
+  readonly code = "CONTRACT.VALIDATION_FAILED";
+  readonly phase: ContractValidationPhase;
+  constructor(message: string, phase: ContractValidationPhase);
+}
+//#endregion
+export { ContractValidationPhase as n, ContractValidationError as t };
+//# sourceMappingURL=contract-validation-error-R7cMoK04.d.mts.map

package/dist/contract-validation-error-R7cMoK04.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-validation-error-R7cMoK04.d.mts","names":[],"sources":["../../../../1-framework/0-foundation/contract/dist/contract-validation-error.d.mts"],"mappings":";;KACK;cACS,gCAAgC;WACnC;WACA,OAAO;EAChB,YAAY,iBAAiB,OAAO"}

package/dist/contract.d.mts

@@ -0,0 +1,14 @@
+import { $ as ValueObjectFieldType, A as ExecutionHashBase, B as LedgerEntryRecord, C as ContractVariantEntry, D as DocCollection, E as CrossReferenceSchema, F as Expr, G as ReferenceRelationKeys, H as NamespaceId, I as FieldType, J as StorageBase, K as ScalarFieldType, L as GeneratedValueSpec, M as ExecutionMutationDefaultPhases, N as ExecutionMutationDefaultValue, O as DocIndex, P as ExecutionSection, Q as UnionFieldType, R as JsonPrimitive, S as ContractValueObject, T as CrossReference, U as PlanMeta, V as ModelStorageBase, W as ProfileHashBase, X as StorageHashBase, Y as StorageEntitySlot, Z as StorageNamespace, _ as ContractNonJunctionRelation, a as ColumnDefault, at as isColumnDefault, b as ContractRelationOn, c as ContractDiscriminator, ct as profileHash, d as ContractField, et as ValueSetRef, f as ContractFieldType, g as ContractModelBase, h as ContractModel, i as Brand, it as executionHash, j as ExecutionMutationDefault, k as EmbedRelationKeys, l as ContractEmbedRelation, m as ContractMarkerRecord, n as ApplicationDomain, nt as coreHash, o as ColumnDefaultLiteralInputValue, ot as isColumnDefaultLiteralInputValue, p as ContractManyToManyRelation, q as Source, r as ApplicationDomainNamespace, rt as crossRef, s as ColumnDefaultLiteralValue, st as isExecutionMutationDefaultValue, t as $, tt as asNamespaceId, u as ContractEnum, v as ContractReferenceRelation, w as ContractWithDomain, x as ContractRelationThrough, y as ContractRelation, z as JsonValue } from "./domain-envelope-D6Wn9AmZ-BqZKTT9U.mjs";
+import { a as effectiveControlPolicy, i as ControlPolicy, n as ContractExecutionSection, r as ContractValueObjectDefinitions, t as Contract } from "./contract-types-CkdMH7F7-9EHXSwbH.mjs";
+import { n as soleDomainNamespaceId, t as UNBOUND_DOMAIN_NAMESPACE_ID } from "./default-namespace-D5X_k6hJ-GH8P1ror.mjs";
+import { n as resolveDomainModel, t as ResolvedDomainModel } from "./resolve-domain-model-BVSb5wS5-C6Yq0dsD.mjs";
+import { n as domainValueObjectsAtDefaultNamespace, t as domainModelsAtDefaultNamespace } from "./types-ByeQhU9p.mjs";
+import { a as canonicalizeContract, i as StorageSort, n as PreserveEmptyPredicate, o as canonicalizeContractToObject, r as SerializeContract, t as CanonicalizeContractOptions } from "./canonicalization-DFpB09nP-4OdB2nsy.mjs";
+import { n as computeProfileHash, r as computeStorageHash, t as computeExecutionHash } from "./hashing-CccSPELN.mjs";
+import { t as isPlainRecord } from "./is-plain-record-C9BWiqcw.mjs";
+import { t as applySpecifierDefaultControlPolicy } from "./apply-specifier-default-control-policy-CAxiXxKg.mjs";
+import { n as ContractValidationPhase, t as ContractValidationError } from "./contract-validation-error-R7cMoK04.mjs";
+import { a as EnumValues, c as buildEnumsMapForNamespace, i as EnumMemberNames, l as buildNamespacedEnums, n as EnumAccessor, o as NamespaceEnumAccessors, r as EnumEntriesToAccessors, s as NamespacedEnums, t as ContractEnumAccessor, u as createEnumAccessor } from "./enum-accessor-PH5vjghI.mjs";
+import { a as compareByNameProperty, c as matchesPathPattern, i as PathSegment$1, n as PathPattern, o as createPreserveEmptyPredicate, r as PathSegment, s as createStorageSort, t as NamedArraySortTarget } from "./hashing-utils-qKu59RSC.mjs";
+import { n as DomainModelShape, r as validateContractDomain, t as DomainContractShape } from "./validate-domain-BNBs-TVv.mjs";
+export { type $, type ApplicationDomain, type ApplicationDomainNamespace, type Brand, type CanonicalizeContractOptions, type ColumnDefault, type ColumnDefaultLiteralInputValue, type ColumnDefaultLiteralValue, type Contract, type ContractDiscriminator, type ContractEmbedRelation, type ContractEnum, type ContractEnumAccessor, type ContractExecutionSection, type ContractField, type ContractFieldType, type ContractManyToManyRelation, type ContractMarkerRecord, type ContractModel, type ContractModelBase, type ContractNonJunctionRelation, type ContractReferenceRelation, type ContractRelation, type ContractRelationOn, type ContractRelationThrough, ContractValidationError, type ContractValidationPhase, type ContractValueObject, type ContractValueObjectDefinitions, type ContractVariantEntry, type ContractWithDomain, type ControlPolicy, type CrossReference, CrossReferenceSchema, type DocCollection, type DocIndex, type DomainContractShape, type DomainModelShape, type EmbedRelationKeys, type EnumAccessor, type EnumEntriesToAccessors, type EnumMemberNames, type EnumValues, type ExecutionHashBase, type ExecutionMutationDefault, type ExecutionMutationDefaultPhases, type ExecutionMutationDefaultValue, type ExecutionSection, type Expr, type FieldType, type GeneratedValueSpec, type JsonPrimitive, type JsonValue, type LedgerEntryRecord, type ModelStorageBase, type NamedArraySortTarget, type NamespaceEnumAccessors, type NamespaceId, type NamespacedEnums, type PathPattern, type PlanMeta, type PathSegment as PreserveEmptyPathSegment, type PreserveEmptyPredicate, type ProfileHashBase, type ReferenceRelationKeys, type ResolvedDomainModel, type ScalarFieldType, type SerializeContract, type Source, type StorageBase, type StorageEntitySlot, type StorageHashBase, type StorageNamespace, type StorageSort, type PathSegment$1 as StorageSortPathSegment, UNBOUND_DOMAIN_NAMESPACE_ID, type UnionFieldType, type ValueObjectFieldType, type ValueSetRef, applySpecifierDefaultControlPolicy, asNamespaceId, buildEnumsMapForNamespace, buildNamespacedEnums, canonicalizeContract, canonicalizeContractToObject, compareByNameProperty, computeExecutionHash, computeProfileHash, computeStorageHash, coreHash, createEnumAccessor, createPreserveEmptyPredicate, createStorageSort, crossRef, domainModelsAtDefaultNamespace, domainValueObjectsAtDefaultNamespace, effectiveControlPolicy, executionHash, isColumnDefault, isColumnDefaultLiteralInputValue, isExecutionMutationDefaultValue, isPlainRecord, matchesPathPattern, profileHash, resolveDomainModel, soleDomainNamespaceId, validateContractDomain };

package/dist/contract.mjs

@@ -0,0 +1,13 @@
+import { t as applySpecifierDefaultControlPolicy } from "./apply-specifier-default-control-policy-CsYHsfTF.mjs";
+import { t as ContractValidationError } from "./contract-validation-error-DEiWp_EI-CRwtUgRw.mjs";
+import { r as soleDomainNamespaceId, t as UNBOUND_DOMAIN_NAMESPACE_ID } from "./default-namespace-D4vCwkXg-BaiW8LNK.mjs";
+import { n as buildNamespacedEnums, r as createEnumAccessor, t as buildEnumsMapForNamespace } from "./enum-accessor-Db5DaTNX.mjs";
+import { n as matchesPathPattern, t as createPreserveEmptyPredicate } from "./canonicalization-path-match-CNgHuwM_-CCPBeUuk.mjs";
+import { t as isPlainRecord } from "./is-plain-record-CUofyVQ7-DWEzdhIx.mjs";
+import { a as computeStorageHash, i as computeProfileHash, n as canonicalizeContractToObject, r as computeExecutionHash, t as canonicalizeContract } from "./hashing-BtIZVNYX.mjs";
+import { n as createStorageSort, t as compareByNameProperty } from "./hashing-utils-DQgS3nOe.mjs";
+import { t as resolveDomainModel } from "./resolve-domain-model-BovPAsW2-8rwyzjxp.mjs";
+import { t as asNamespaceId } from "./namespace-id-asbWpwMw-3yxn-tRe.mjs";
+import { a as domainValueObjectsAtDefaultNamespace, c as isColumnDefault, d as profileHash, i as domainModelsAtDefaultNamespace, l as isColumnDefaultLiteralInputValue, n as coreHash, o as effectiveControlPolicy, r as crossRef, s as executionHash, t as CrossReferenceSchema, u as isExecutionMutationDefaultValue } from "./types-DgdgskBY.mjs";
+import { t as validateContractDomain } from "./validate-domain-BkvFlY3B.mjs";
+export { ContractValidationError, CrossReferenceSchema, UNBOUND_DOMAIN_NAMESPACE_ID, applySpecifierDefaultControlPolicy, asNamespaceId, buildEnumsMapForNamespace, buildNamespacedEnums, canonicalizeContract, canonicalizeContractToObject, compareByNameProperty, computeExecutionHash, computeProfileHash, computeStorageHash, coreHash, createEnumAccessor, createPreserveEmptyPredicate, createStorageSort, crossRef, domainModelsAtDefaultNamespace, domainValueObjectsAtDefaultNamespace, effectiveControlPolicy, executionHash, isColumnDefault, isColumnDefaultLiteralInputValue, isExecutionMutationDefaultValue, isPlainRecord, matchesPathPattern, profileHash, resolveDomainModel, soleDomainNamespaceId, validateContractDomain };

package/dist/contract__apply-specifier-default-control-policy.d.mts

@@ -0,0 +1,2 @@
+import { t as applySpecifierDefaultControlPolicy } from "./apply-specifier-default-control-policy-CAxiXxKg.mjs";
+export { applySpecifierDefaultControlPolicy };

package/dist/contract__apply-specifier-default-control-policy.mjs

@@ -0,0 +1,2 @@
+import { t as applySpecifierDefaultControlPolicy } from "./apply-specifier-default-control-policy-CsYHsfTF.mjs";
+export { applySpecifierDefaultControlPolicy };

package/dist/contract__contract-validation-error.d.mts

@@ -0,0 +1,2 @@
+import { n as ContractValidationPhase, t as ContractValidationError } from "./contract-validation-error-R7cMoK04.mjs";
+export { ContractValidationError, type ContractValidationPhase };

package/dist/contract__contract-validation-error.mjs

@@ -0,0 +1,2 @@
+import { t as ContractValidationError } from "./contract-validation-error-DEiWp_EI-CRwtUgRw.mjs";
+export { ContractValidationError };

package/dist/contract__default-namespace.d.mts

@@ -0,0 +1,2 @@
+import { n as soleDomainNamespaceId, t as UNBOUND_DOMAIN_NAMESPACE_ID } from "./default-namespace-D5X_k6hJ-GH8P1ror.mjs";
+export { UNBOUND_DOMAIN_NAMESPACE_ID, soleDomainNamespaceId };

package/dist/contract__default-namespace.mjs

@@ -0,0 +1,2 @@
+import { r as soleDomainNamespaceId, t as UNBOUND_DOMAIN_NAMESPACE_ID } from "./default-namespace-D4vCwkXg-BaiW8LNK.mjs";
+export { UNBOUND_DOMAIN_NAMESPACE_ID, soleDomainNamespaceId };

package/dist/contract__enum-accessor.d.mts

@@ -0,0 +1,2 @@
+import { a as EnumValues, c as buildEnumsMapForNamespace, i as EnumMemberNames, l as buildNamespacedEnums, n as EnumAccessor, o as NamespaceEnumAccessors, r as EnumEntriesToAccessors, s as NamespacedEnums, t as ContractEnumAccessor, u as createEnumAccessor } from "./enum-accessor-PH5vjghI.mjs";
+export { type ContractEnumAccessor, type EnumAccessor, type EnumEntriesToAccessors, type EnumMemberNames, type EnumValues, type NamespaceEnumAccessors, type NamespacedEnums, buildEnumsMapForNamespace, buildNamespacedEnums, createEnumAccessor };

package/dist/contract__enum-accessor.mjs

@@ -0,0 +1,2 @@
+import { n as buildNamespacedEnums, r as createEnumAccessor, t as buildEnumsMapForNamespace } from "./enum-accessor-Db5DaTNX.mjs";
+export { buildEnumsMapForNamespace, buildNamespacedEnums, createEnumAccessor };

package/dist/contract__hashing-utils.d.mts

@@ -0,0 +1,2 @@
+import { a as compareByNameProperty, c as matchesPathPattern, i as PathSegment$1, n as PathPattern, o as createPreserveEmptyPredicate, r as PathSegment, s as createStorageSort, t as NamedArraySortTarget } from "./hashing-utils-qKu59RSC.mjs";
+export { type NamedArraySortTarget, type PathPattern, type PathSegment as PreserveEmptyPathSegment, type PathSegment$1 as StorageSortPathSegment, compareByNameProperty, createPreserveEmptyPredicate, createStorageSort, matchesPathPattern };

package/dist/contract__hashing-utils.mjs

@@ -0,0 +1,3 @@
+import { n as matchesPathPattern, t as createPreserveEmptyPredicate } from "./canonicalization-path-match-CNgHuwM_-CCPBeUuk.mjs";
+import { n as createStorageSort, t as compareByNameProperty } from "./hashing-utils-DQgS3nOe.mjs";
+export { compareByNameProperty, createPreserveEmptyPredicate, createStorageSort, matchesPathPattern };

package/dist/contract__hashing.d.mts

@@ -0,0 +1,3 @@
+import { a as canonicalizeContract, i as StorageSort, n as PreserveEmptyPredicate, o as canonicalizeContractToObject, r as SerializeContract, t as CanonicalizeContractOptions } from "./canonicalization-DFpB09nP-4OdB2nsy.mjs";
+import { n as computeProfileHash, r as computeStorageHash, t as computeExecutionHash } from "./hashing-CccSPELN.mjs";
+export { type CanonicalizeContractOptions, type PreserveEmptyPredicate, type SerializeContract, type StorageSort, canonicalizeContract, canonicalizeContractToObject, computeExecutionHash, computeProfileHash, computeStorageHash };

package/dist/contract__hashing.mjs

@@ -0,0 +1,2 @@
+import { a as computeStorageHash, i as computeProfileHash, n as canonicalizeContractToObject, r as computeExecutionHash, t as canonicalizeContract } from "./hashing-BtIZVNYX.mjs";
+export { canonicalizeContract, canonicalizeContractToObject, computeExecutionHash, computeProfileHash, computeStorageHash };

package/dist/contract__is-plain-record.d.mts

@@ -0,0 +1,2 @@
+import { t as isPlainRecord } from "./is-plain-record-C9BWiqcw.mjs";
+export { isPlainRecord };

package/dist/contract__is-plain-record.mjs

@@ -0,0 +1,2 @@
+import { t as isPlainRecord } from "./is-plain-record-CUofyVQ7-DWEzdhIx.mjs";
+export { isPlainRecord };

package/dist/contract__resolve-domain-model.d.mts

@@ -0,0 +1,2 @@
+import { n as resolveDomainModel, t as ResolvedDomainModel } from "./resolve-domain-model-BVSb5wS5-C6Yq0dsD.mjs";
+export { type ResolvedDomainModel, resolveDomainModel };

package/dist/contract__resolve-domain-model.mjs

@@ -0,0 +1,2 @@
+import { t as resolveDomainModel } from "./resolve-domain-model-BovPAsW2-8rwyzjxp.mjs";
+export { resolveDomainModel };

package/dist/contract__types.d.mts

@@ -0,0 +1,6 @@
+import { $ as ValueObjectFieldType, A as ExecutionHashBase, B as LedgerEntryRecord, C as ContractVariantEntry, D as DocCollection, E as CrossReferenceSchema, F as Expr, G as ReferenceRelationKeys, H as NamespaceId, I as FieldType, J as StorageBase, K as ScalarFieldType, L as GeneratedValueSpec, M as ExecutionMutationDefaultPhases, N as ExecutionMutationDefaultValue, O as DocIndex, P as ExecutionSection, Q as UnionFieldType, R as JsonPrimitive, S as ContractValueObject, T as CrossReference, U as PlanMeta, V as ModelStorageBase, W as ProfileHashBase, X as StorageHashBase, Y as StorageEntitySlot, Z as StorageNamespace, _ as ContractNonJunctionRelation, a as ColumnDefault, at as isColumnDefault, b as ContractRelationOn, c as ContractDiscriminator, ct as profileHash, d as ContractField, et as ValueSetRef, f as ContractFieldType, g as ContractModelBase, h as ContractModel, i as Brand, it as executionHash, j as ExecutionMutationDefault, k as EmbedRelationKeys, l as ContractEmbedRelation, m as ContractMarkerRecord, n as ApplicationDomain, nt as coreHash, o as ColumnDefaultLiteralInputValue, ot as isColumnDefaultLiteralInputValue, p as ContractManyToManyRelation, q as Source, r as ApplicationDomainNamespace, rt as crossRef, s as ColumnDefaultLiteralValue, st as isExecutionMutationDefaultValue, t as $, tt as asNamespaceId, u as ContractEnum, v as ContractReferenceRelation, w as ContractWithDomain, x as ContractRelationThrough, y as ContractRelation, z as JsonValue } from "./domain-envelope-D6Wn9AmZ-BqZKTT9U.mjs";
+import { a as effectiveControlPolicy, i as ControlPolicy, n as ContractExecutionSection, r as ContractValueObjectDefinitions, t as Contract } from "./contract-types-CkdMH7F7-9EHXSwbH.mjs";
+import { n as soleDomainNamespaceId, t as UNBOUND_DOMAIN_NAMESPACE_ID } from "./default-namespace-D5X_k6hJ-GH8P1ror.mjs";
+import { n as resolveDomainModel, t as ResolvedDomainModel } from "./resolve-domain-model-BVSb5wS5-C6Yq0dsD.mjs";
+import { n as domainValueObjectsAtDefaultNamespace, t as domainModelsAtDefaultNamespace } from "./types-ByeQhU9p.mjs";
+export { type $, type ApplicationDomain, type ApplicationDomainNamespace, type Brand, type ColumnDefault, type ColumnDefaultLiteralInputValue, type ColumnDefaultLiteralValue, type Contract, type ContractDiscriminator, type ContractEmbedRelation, type ContractEnum, type ContractExecutionSection, type ContractField, type ContractFieldType, type ContractManyToManyRelation, type ContractMarkerRecord, type ContractModel, type ContractModelBase, type ContractNonJunctionRelation, type ContractReferenceRelation, type ContractRelation, type ContractRelationOn, type ContractRelationThrough, type ContractValueObject, type ContractValueObjectDefinitions, type ContractVariantEntry, type ContractWithDomain, type ControlPolicy, type CrossReference, CrossReferenceSchema, type DocCollection, type DocIndex, type EmbedRelationKeys, type ExecutionHashBase, type ExecutionMutationDefault, type ExecutionMutationDefaultPhases, type ExecutionMutationDefaultValue, type ExecutionSection, type Expr, type FieldType, type GeneratedValueSpec, type JsonPrimitive, type JsonValue, type LedgerEntryRecord, type ModelStorageBase, type NamespaceId, type PlanMeta, type ProfileHashBase, type ReferenceRelationKeys, type ResolvedDomainModel, type ScalarFieldType, type Source, type StorageBase, type StorageEntitySlot, type StorageHashBase, type StorageNamespace, UNBOUND_DOMAIN_NAMESPACE_ID, type UnionFieldType, type ValueObjectFieldType, type ValueSetRef, asNamespaceId, coreHash, crossRef, domainModelsAtDefaultNamespace, domainValueObjectsAtDefaultNamespace, effectiveControlPolicy, executionHash, isColumnDefault, isColumnDefaultLiteralInputValue, isExecutionMutationDefaultValue, profileHash, resolveDomainModel, soleDomainNamespaceId };

package/dist/contract__types.mjs

@@ -0,0 +1,5 @@
+import { r as soleDomainNamespaceId, t as UNBOUND_DOMAIN_NAMESPACE_ID } from "./default-namespace-D4vCwkXg-BaiW8LNK.mjs";
+import { t as resolveDomainModel } from "./resolve-domain-model-BovPAsW2-8rwyzjxp.mjs";
+import { t as asNamespaceId } from "./namespace-id-asbWpwMw-3yxn-tRe.mjs";
+import { a as domainValueObjectsAtDefaultNamespace, c as isColumnDefault, d as profileHash, i as domainModelsAtDefaultNamespace, l as isColumnDefaultLiteralInputValue, n as coreHash, o as effectiveControlPolicy, r as crossRef, s as executionHash, t as CrossReferenceSchema, u as isExecutionMutationDefaultValue } from "./types-DgdgskBY.mjs";
+export { CrossReferenceSchema, UNBOUND_DOMAIN_NAMESPACE_ID, asNamespaceId, coreHash, crossRef, domainModelsAtDefaultNamespace, domainValueObjectsAtDefaultNamespace, effectiveControlPolicy, executionHash, isColumnDefault, isColumnDefaultLiteralInputValue, isExecutionMutationDefaultValue, profileHash, resolveDomainModel, soleDomainNamespaceId };

package/dist/contract__validate-domain.d.mts

@@ -0,0 +1,2 @@
+import { n as DomainModelShape, r as validateContractDomain, t as DomainContractShape } from "./validate-domain-BNBs-TVv.mjs";
+export { type DomainContractShape, type DomainModelShape, validateContractDomain };

package/dist/contract__validate-domain.mjs

@@ -0,0 +1,2 @@
+import { t as validateContractDomain } from "./validate-domain-BkvFlY3B.mjs";
+export { validateContractDomain };

package/dist/control-B87KWI_K-C_R8WfEr.d.mts

@@ -0,0 +1,213 @@
+import { r as StructuredError } from "./structured-error-BVmv2aPB.mjs";
+//#region ../../../1-framework/1-core/errors/dist/control-B87KWI_K.d.mts
+//#region src/control.d.ts
+/**
+ * CLI error envelope for output formatting.
+ * This is the serialized form of a CliStructuredError.
+ */
+interface CliErrorEnvelope {
+  readonly ok: false;
+  readonly code: string;
+  readonly severity: 'error' | 'warn' | 'info';
+  readonly summary: string;
+  readonly why?: string;
+  readonly fix?: string;
+  readonly where?: {
+    readonly path?: string;
+    readonly line?: number;
+  };
+  readonly meta?: Record<string, unknown>;
+  readonly docsUrl?: string;
+}
+/**
+ * Minimal conflict data structure expected by CLI output.
+ */
+interface CliErrorConflict {
+  readonly kind: string;
+  readonly summary: string;
+  readonly why?: string;
+}
+/**
+ * Structured CLI error that contains all information needed for error envelopes.
+ * Call sites throw these errors with full context.
+ *
+ * A `CliStructuredError` is a `StructuredError` (see
+ * `@internal/utils/structured-error`): `code` is a dotted
+ * `NAMESPACE.SUBCODE` string, and the namespace prefix is the error's
+ * category — there is no separate `domain` field. See
+ * [ADR 239](../../../../../docs/architecture%20docs/adrs/ADR%20239%20-%20Errors%20are%20structural%20envelopes%20with%20dotted%20namespace%20codes.md)
+ * for the namespace taxonomy.
+ */
+declare class CliStructuredError extends Error implements StructuredError {
+  readonly code: `${string}.${string}`;
+  readonly severity: 'error' | 'warn' | 'info';
+  readonly why?: string;
+  readonly fix?: string;
+  readonly where?: {
+    readonly path?: string;
+    readonly line?: number;
+  };
+  readonly meta?: Record<string, unknown>;
+  readonly docsUrl?: string;
+  constructor(code: `${string}.${string}`, summary: string, options?: {
+    readonly severity?: 'error' | 'warn' | 'info';
+    readonly why?: string;
+    readonly fix?: string;
+    readonly where?: {
+      readonly path?: string;
+      readonly line?: number;
+    };
+    readonly meta?: Record<string, unknown>;
+    readonly docsUrl?: string;
+  });
+  /**
+   * Converts this error to a CLI error envelope for output formatting.
+   */
+  toEnvelope(): CliErrorEnvelope;
+  /**
+   * Type guard to check if an error is a CliStructuredError.
+   * Uses duck-typing to work across module boundaries where instanceof may fail.
+   */
+  static is(error: unknown): error is CliStructuredError;
+}
+/**
+ * Config file not found or missing.
+ */
+declare function errorConfigFileNotFound(configPath?: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract configuration missing from config.
+ */
+declare function errorContractConfigMissing(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract validation failed.
+ */
+declare function errorContractValidationFailed(reason: string, options?: {
+  readonly where?: {
+    readonly path?: string;
+    readonly line?: number;
+  };
+}): CliStructuredError;
+/**
+ * File not found.
+ */
+declare function errorFileNotFound(filePath: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly docsUrl?: string;
+}): CliStructuredError;
+/**
+ * Database connection is required but not provided.
+ */
+declare function errorDatabaseConnectionRequired(options?: {
+  readonly why?: string;
+  readonly commandName?: string;
+  readonly retryCommand?: string;
+  readonly missingFlags?: readonly string[];
+}): CliStructuredError;
+/**
+ * Query runner factory is required but not provided in config.
+ */
+declare function errorQueryRunnerFactoryRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Family verify.readMarker is required but not provided.
+ */
+declare function errorFamilyReadMarkerSqlRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * JSON output format not supported.
+ */
+declare function errorJsonFormatNotSupported(options: {
+  readonly command: string;
+  readonly format: string;
+  readonly supportedFormats: readonly string[];
+}): CliStructuredError;
+/**
+ * Driver is required for DB-connected commands but not provided.
+ */
+declare function errorDriverRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract requires extension packs that are not provided by config descriptors.
+ */
+declare function errorContractMissingExtensions(options: {
+  readonly missingExtensions: readonly string[];
+  readonly providedComponentIds: readonly string[];
+}): CliStructuredError;
+/**
+ * Migration planning failed due to conflicts.
+ */
+declare function errorMigrationPlanningFailed(options: {
+  readonly conflicts: readonly CliErrorConflict[];
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Target does not support migrations (missing createPlanner/createRunner).
+ */
+declare function errorTargetMigrationNotSupported(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * The migration-file CLI received `--config` without a path argument (either
+ * a bare trailing `--config`, or `--config` followed by another flag like
+ * `--config --dry-run`). Surfacing this as a structured error fails fast
+ * rather than silently consuming the next flag as the config path or
+ * falling back to default discovery against the wrong project.
+ */
+declare function errorMigrationCliInvalidConfigArg(options?: {
+  readonly nextToken?: string;
+}): CliStructuredError;
+/**
+ * The migration-file CLI received a flag it does not recognise. Surfaced as a
+ * structured error so consumers can render their own "did you mean"
+ * suggestions from `meta.knownFlags` rather than parsing the message.
+ *
+ * Designed to wrap clipanion's `UnknownSyntaxError` at the parser boundary:
+ * pass the offending token as `flag` and the option declarations as
+ * `knownFlags`.
+ */
+declare function errorMigrationCliUnknownFlag(options: {
+  readonly flag: string;
+  readonly knownFlags: readonly string[];
+}): CliStructuredError;
+/**
+ * The main CLI received an unsupported `--format` value.
+ */
+declare function errorInvalidOutputFormat(value: string): CliStructuredError;
+/**
+ * The main CLI received mutually exclusive output format flags
+ * (`--format pretty` together with `--json`).
+ */
+declare function errorOutputFormatMutex(): CliStructuredError;
+/**
+ * Config validation error (missing required fields).
+ */
+declare function errorConfigValidation(field: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * An enum declares a codecId that no component in the contract's pack stack provides,
+ * so its member values cannot be encoded. Thrown by both authoring paths (TS `defineContract`
+ * and PSL interpretation) when the codec lookup built from the contract's packs has no
+ * descriptor for the codecId.
+ */
+declare function errorEnumCodecNotInPackStack(options: {
+  readonly codecId: string;
+}): CliStructuredError;
+/**
+ * Generic unexpected error.
+ */
+declare function errorUnexpected(message: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+}): CliStructuredError;
+//#endregion
+export { errorUnexpected as S, errorMigrationCliUnknownFlag as _, errorConfigValidation as a, errorQueryRunnerFactoryRequired as b, errorContractValidationFailed as c, errorEnumCodecNotInPackStack as d, errorFamilyReadMarkerSqlRequired as f, errorMigrationCliInvalidConfigArg as g, errorJsonFormatNotSupported as h, errorConfigFileNotFound as i, errorDatabaseConnectionRequired as l, errorInvalidOutputFormat as m, CliErrorEnvelope as n, errorContractConfigMissing as o, errorFileNotFound as p, CliStructuredError as r, errorContractMissingExtensions as s, CliErrorConflict as t, errorDriverRequired as u, errorMigrationPlanningFailed as v, errorTargetMigrationNotSupported as x, errorOutputFormatMutex as y };
+//# sourceMappingURL=control-B87KWI_K-C_R8WfEr.d.mts.map

package/dist/control-B87KWI_K-C_R8WfEr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-B87KWI_K-C_R8WfEr.d.mts","names":[],"sources":["../../../../1-framework/1-core/errors/dist/control-B87KWI_K.d.mts"],"mappings":";;;;;;;UAMU;WACC;WACA;WACA;WACA;WACA;WACA;WACA;aACE;aACA;;WAEF,OAAO;WACP;;;;;UAKD;WACC;WACA;WACA;;;;;;;;;;;;;cAaG,2BAA2B,iBAAiB;WAC/C;WACA;WACA;WACA;WACA;aACE;aACA;;WAEF,OAAO;WACP;EACT,YAAY,6BAA6B,iBAAiB;aAC/C;aACA;aACA;aACA;eACE;eACA;;aAEF,OAAO;aACP;;;;;EAKX,cAAc;;;;;SAKP,GAAG,iBAAiB,SAAS;;;;;iBAKrB,wBAAwB,qBAAqB;WACnD;IACP;;;;iBAIa,2BAA2B;WACjC;IACP;;;;iBAIa,8BAA8B,gBAAgB;WACpD;aACE;aACA;;IAET;;;;iBAIa,kBAAkB,kBAAkB;WAC1C;WACA;WACA;IACP;;;;iBAIa,gCAAgC;WACtC;WACA;WACA;WACA;IACP;;;;iBAIa,gCAAgC;WACtC;IACP;;;;iBAIa,iCAAiC;WACvC;IACP;;;;iBAIa,4BAA4B;WAClC;WACA;WACA;IACP;;;;iBAIa,oBAAoB;WAC1B;IACP;;;;iBAIa,+BAA+B;WACrC;WACA;IACP;;;;iBAIa,6BAA6B;WACnC,oBAAoB;WACpB;IACP;;;;iBAIa,iCAAiC;WACvC;IACP;;;;;;;;iBAQa,kCAAkC;WACxC;IACP;;;;;;;;;;iBAUa,6BAA6B;WACnC;WACA;IACP;;;;iBAIa,yBAAyB,gBAAgB;;;;;iBAKzC,0BAA0B;;;;iBAI1B,sBAAsB,eAAe;WAC3C;IACP;;;;;;;iBAOa,6BAA6B;WACnC;IACP;;;;iBAIa,gBAAgB,iBAAiB;WACvC;WACA;IACP"}