@prisma/orm-toolchain 8.0.0-rc.11-dev.6 → 8.0.0-rc.11-dev.7

package/dist/cli__control-api.d.mts

@@ -1,7 +1,7 @@
 import { i as Refs, n as RefEntry } from "./refs-BNCUu58Y-BIso5Jfg.mjs";
 import { n as MigrationGraph } from "./graph-bDjJ4GL9-BhFevsJS.mjs";
 import { r as MigrationRef, t as ContractRef } from "./ref-resolution-CaHQJXE0.mjs";
-import { A as SchemaVerifyOptions, C as EmitResult, D as IntrospectOptions, E as ExecuteDbVerifyResult, M as VerifyOptions, N as executeDbVerify, S as EmitOptions, T as ExecuteDbVerifyOptions, _ as DbUpdateResult, a as ControlClient, b as EmitFailure, c as CreateControlClient, d as DbInitOptions, f as DbInitResult, g as DbUpdateOptions, h as DbUpdateFailureCode, i as ControlActionName, j as SignOptions, k as OnControlProgress, l as DbInitFailure, m as DbUpdateFailure, n as ContractEmitOptions, o as ControlClientOptions, p as DbInitSuccess, r as ContractEmitResult, s as ControlProgressEvent, t as CliStructuredError$2, u as DbInitFailureCode, v as DbUpdateSuccess, w as EmitSuccess, x as EmitFailureCode, y as EmitContractConfig } from "./db-verify-Yih5kWtB-B1kv76ec.mjs";
+import { A as RenderContractDtsFailure, C as EmitResult, D as IntrospectOptions, E as ExecuteDbVerifyResult, F as SchemaVerifyOptions, I as SignOptions, L as VerifyOptions, M as RenderContractDtsOptions, N as RenderContractDtsResult, P as RenderContractDtsSuccess, R as executeDbVerify, S as EmitOptions, T as ExecuteDbVerifyOptions, _ as DbUpdateResult, a as ControlClient, b as EmitFailure, c as CreateControlClient, d as DbInitOptions, f as DbInitResult, g as DbUpdateOptions, h as DbUpdateFailureCode, i as ControlActionName, j as RenderContractDtsFailureCode, k as OnControlProgress, l as DbInitFailure, m as DbUpdateFailure, n as ContractEmitOptions, o as ControlClientOptions, p as DbInitSuccess, r as ContractEmitResult, s as ControlProgressEvent, t as CliStructuredError$2, u as DbInitFailureCode, v as DbUpdateSuccess, w as EmitSuccess, x as EmitFailureCode, y as EmitContractConfig } from "./db-verify-BdKY7U7l-6VLIVuKF.mjs";
 import { a as emit } from "./index-D217lbiW.mjs";
 import { n as OnDiskMigrationPackage, t as MigrationOps } from "./package-CfWiDNrr-ZR4HM_Iz.mjs";
 import { c as ContractSpaceAggregate, d as IntegrityQueryOptions, p as IntegrityViolation, t as AggregateContractSpace } from "./aggregate-D_eX4zoo.mjs";
@@ -856,6 +856,7 @@ declare function executeRefDeleteCommand(name: string, options: RefOperationOpti
 declare function executeRefListCommand(options: RefOperationOptions): Promise<Result<RefListResult, CliStructuredError$2>>;
 //#endregion
 //#region src/control-api/operations/ref-advancement.d.ts
+/** A contract snapshot's two halves: the JSON and the declarations rendered from it. */
 interface ContractIR {
   readonly contract: unknown;
   readonly contractDts: string;
@@ -870,41 +871,43 @@ interface RefAdvancementFields {
     readonly hash: string;
   } | null;
 }
+declare const NO_REF_ADVANCEMENT: RefAdvancementFields;
 declare function computeRefAdvancementName(options: {
   readonly advanceRef?: string;
   readonly db?: string;
 }): string | null;
-declare function readContractIR(contractJson: Record<string, unknown>, contractJsonPath: string): Promise<ContractIR>;
+/**
+ * Everything `executeRefAdvancement` needs, produced before a command does the
+ * work that precedes the ref write: the ref name is validated and the
+ * declarations of the contract to snapshot are rendered from its JSON, with
+ * the import names the project owning `configPath` can resolve. Nothing is
+ * read or rendered after the database is touched, so a contract that cannot
+ * be snapshotted refuses the command before it changes anything.
+ */
+declare function preflightRefAdvancement(args: {
+  readonly name: string;
+  readonly contractJson: Record<string, unknown>;
+  readonly contractJsonPath: string;
+  readonly configPath: string;
+  readonly client: Pick<ControlClient, 'renderContractDts'>;
+}): Promise<Result<ContractIR, CliStructuredError$2>>;
 declare function executeRefAdvancement(refsDir: string, migrationsDir: string, name: string, hash: string, contractIR: ContractIR): Promise<{
   name: string;
   hash: string;
 }>;
+/**
+ * The ref-advancement tail of db init / db update, run after the database
+ * work with the `ContractIR` that `preflightRefAdvancement` produced before
+ * it. Plan mode reports the ref that an apply would advance without writing.
+ */
 declare function buildRefAdvancementFields(options: {
-  readonly advanceRef?: string;
-  readonly db?: string;
+  readonly name: string;
   readonly refsDir: string;
   readonly migrationsDir: string;
   readonly contractIR: ContractIR;
   readonly mode: 'plan' | 'apply';
   readonly hash: string;
-}): Promise<RefAdvancementFields>;
-interface ResolveRefAdvancementFieldsOptions {
-  readonly advanceRef?: string;
-  readonly db?: string;
-  readonly refsDir: string;
-  readonly migrationsDir: string;
-  readonly contractJson: Record<string, unknown>;
-  /** Path whose sibling .d.ts readContractIR derives (contract.json path). */
-  readonly contractJsonPath: string;
-  readonly mode: 'plan' | 'apply';
-  readonly hash: string;
-}
-/**
- * Full ref-advancement phase for db init/update: ok({advancedRef:null, plannedAdvanceRef:null})
- * when computeRefAdvancementName is null; else readContractIR + buildRefAdvancementFields with
- * MigrationToolsError mapped, other errors rethrown.
- */
-declare function resolveRefAdvancementFields(options: ResolveRefAdvancementFieldsOptions): Promise<Result<RefAdvancementFields, CliStructuredError$2>>;
+}): Promise<Result<RefAdvancementFields, CliStructuredError$2>>;
 /**
  * The --advance-ref tail of migrate and db sign: executeRefAdvancement with
  * MigrationToolsError failures passed through as notOk, others rethrown.
@@ -939,5 +942,5 @@ declare function readMigrationRefs(refsDir: string): Promise<Result<Refs, CliStr
 //#region src/utils/emit-queue.d.ts
 declare function disposeEmitQueue(outputJsonPath: string): void;
 //#endregion
-export { type BuildAggregateInputs, type CheckSpace, type ContractEmitOptions, type ContractEmitResult, type ContractIR, type ContractSpaceSeedPhaseInputs, type ContractSpaceSeedPhaseRecord, type ContractSpaceSeedPhaseResult, type ControlActionName, type ControlClient, type ControlClientOptions, type ControlProgressEvent, type ControlStack, type DbInitFailure, type DbInitFailureCode, type DbInitOptions, type DbInitResult, type DbInitSuccess, type DbUpdateFailure, type DbUpdateFailureCode, type DbUpdateOptions, type DbUpdateResult, type DbUpdateSuccess, type EmitContractConfig, type EmitFailure, type EmitFailureCode, type EmitOptions, type EmitResult, type EmitSuccess, type ExecuteDbInitOptions, type ExecuteDbUpdateOptions, type ExecuteDbVerifyOptions, type ExecuteDbVerifyResult, type ExecuteMigrateShowPlanOptions, type FromResolution, type IntrospectOptions, type MigrateShowMigration, type MigrateShowPlanSuccess, type MigrationCheckOutcome, type MigrationPlanResult, type OnControlProgress, type RefAdvancementFields, type ResolveContractRefToSnapshotOptions, type ResolveContractRefToSnapshotSuccess, type ResolvedContractRef, type RunMigrationCheckInputs, type RunMigrationListInputs, type SchemaVerifyOptions, type SignDatabaseResult, type SignOptions, type VerifyDatabaseResult, type VerifyDatabaseSchemaResult, type VerifyOptions, advanceRefSafely, appContractStandInFromIdentity, appliedHashesFromLedger, buildContractSpaceAggregate, buildMigrationSpaceGraphEntries, buildReadAggregate, buildRefAdvancementFields, checkSingleTarget, computeRefAdvancementName, createControlClient, deriveStatusEdgeAnnotations, disposeEmitQueue, enrichContract, enumerateCheckSpaces, executeContractEmit, executeDbInit, executeDbUpdate, executeDbVerify, executeMigrateShowPlan, executeMigrationNewCommand, executeMigrationPlanCommand, executeRefAdvancement, executeRefDeleteCommand, executeRefListCommand, executeRefSetCommand, hasMigrationPath, listRefsByContractHash, loadAggregateIntegrityViolations, loadContractRawSafely, loadContractSpaceAggregateForCli, mapCaughtMigrationError, mapContractAtError, mapIntegrityViolations, migrationSpaceListEntriesFromAggregate, originHashForStatus, readContractIR, readMigrationRefs, refuseContractSpaceIntegrity, refuseDeclaredExtensionTargetMismatch, refuseMarkerOutsideGraph, refuseMissingInvariantPath, refusePackageCorruptionOnAggregate, refuseUnknownInvariants, resolveContractRef, resolveContractRefToSnapshot, resolveFromForPlan, resolveMigrationRef, resolveRefAdvancementFields, resolveToForPlan, runContractSpaceSeedPhase, runMigrationCheck, runMigrationList, statusForMigrationHash };
+export { type BuildAggregateInputs, type CheckSpace, type ContractEmitOptions, type ContractEmitResult, type ContractIR, type ContractSpaceSeedPhaseInputs, type ContractSpaceSeedPhaseRecord, type ContractSpaceSeedPhaseResult, type ControlActionName, type ControlClient, type ControlClientOptions, type ControlProgressEvent, type ControlStack, type DbInitFailure, type DbInitFailureCode, type DbInitOptions, type DbInitResult, type DbInitSuccess, type DbUpdateFailure, type DbUpdateFailureCode, type DbUpdateOptions, type DbUpdateResult, type DbUpdateSuccess, type EmitContractConfig, type EmitFailure, type EmitFailureCode, type EmitOptions, type EmitResult, type EmitSuccess, type ExecuteDbInitOptions, type ExecuteDbUpdateOptions, type ExecuteDbVerifyOptions, type ExecuteDbVerifyResult, type ExecuteMigrateShowPlanOptions, type FromResolution, type IntrospectOptions, type MigrateShowMigration, type MigrateShowPlanSuccess, type MigrationCheckOutcome, type MigrationPlanResult, NO_REF_ADVANCEMENT, type OnControlProgress, type RefAdvancementFields, type RenderContractDtsFailure, type RenderContractDtsFailureCode, type RenderContractDtsOptions, type RenderContractDtsResult, type RenderContractDtsSuccess, type ResolveContractRefToSnapshotOptions, type ResolveContractRefToSnapshotSuccess, type ResolvedContractRef, type RunMigrationCheckInputs, type RunMigrationListInputs, type SchemaVerifyOptions, type SignDatabaseResult, type SignOptions, type VerifyDatabaseResult, type VerifyDatabaseSchemaResult, type VerifyOptions, advanceRefSafely, appContractStandInFromIdentity, appliedHashesFromLedger, buildContractSpaceAggregate, buildMigrationSpaceGraphEntries, buildReadAggregate, buildRefAdvancementFields, checkSingleTarget, computeRefAdvancementName, createControlClient, deriveStatusEdgeAnnotations, disposeEmitQueue, enrichContract, enumerateCheckSpaces, executeContractEmit, executeDbInit, executeDbUpdate, executeDbVerify, executeMigrateShowPlan, executeMigrationNewCommand, executeMigrationPlanCommand, executeRefAdvancement, executeRefDeleteCommand, executeRefListCommand, executeRefSetCommand, hasMigrationPath, listRefsByContractHash, loadAggregateIntegrityViolations, loadContractRawSafely, loadContractSpaceAggregateForCli, mapCaughtMigrationError, mapContractAtError, mapIntegrityViolations, migrationSpaceListEntriesFromAggregate, originHashForStatus, preflightRefAdvancement, readMigrationRefs, refuseContractSpaceIntegrity, refuseDeclaredExtensionTargetMismatch, refuseMarkerOutsideGraph, refuseMissingInvariantPath, refusePackageCorruptionOnAggregate, refuseUnknownInvariants, resolveContractRef, resolveContractRefToSnapshot, resolveFromForPlan, resolveMigrationRef, resolveToForPlan, runContractSpaceSeedPhase, runMigrationCheck, runMigrationList, statusForMigrationHash };
 //# sourceMappingURL=cli__control-api.d.mts.map

package/dist/cli__control-api.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli__control-api.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/control-api.d.mts"],"mappings":"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"}
+{"version":3,"file":"cli__control-api.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/control-api.d.mts"],"mappings":"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"}

package/dist/cli__control-api.mjs

@@ -1,2 +1,2 @@
-import { $ as loadAggregateIntegrityViolations, At as runMigrationList, B as executeDbInit, Ct as resolveFromForPlan, Et as resolveToForPlan, G as executeMigrationPlanCommand, H as executeDbVerify, J as executeRefListCommand, K as executeRefAdvancement, Mt as statusForMigrationHash, Ot as runContractSpaceSeedPhase, Q as listRefsByContractHash, St as resolveContractRefToSnapshot, Tt as resolveRefAdvancementFields, U as executeMigrateShowPlan, V as executeDbUpdate, W as executeMigrationNewCommand, Y as executeRefSetCommand, Z as hasMigrationPath, _ as enumerateCheckSpaces, _t as refusePackageCorruptionOnAggregate, a as buildContractSpaceAggregate, at as mapIntegrityViolations, c as buildRefAdvancementFields, ct as originHashForStatus, dt as readContractIR, et as loadContractRawSafely, f as computeRefAdvancementName, ft as readMigrationRefs, g as enrichContract, gt as refuseMissingInvariantPath, h as disposeEmitQueue, ht as refuseMarkerOutsideGraph, i as appliedHashesFromLedger, it as mapContractAtError, kt as runMigrationCheck, l as checkSingleTarget, m as deriveStatusEdgeAnnotations, mt as refuseDeclaredExtensionTargetMismatch, n as advanceRefSafely, o as buildMigrationSpaceGraphEntries, p as createControlClient, pt as refuseContractSpaceIntegrity, q as executeRefDeleteCommand, r as appContractStandInFromIdentity, rt as mapCaughtMigrationError, s as buildReadAggregate, st as migrationSpaceListEntriesFromAggregate, tt as loadContractSpaceAggregateForCli, vt as refuseUnknownInvariants, wt as resolveMigrationRef, xt as resolveContractRef$1, z as executeContractEmit } from "./ref-DcqFmceq-QaUjgZeM.mjs";
-export { advanceRefSafely, appContractStandInFromIdentity, appliedHashesFromLedger, buildContractSpaceAggregate, buildMigrationSpaceGraphEntries, buildReadAggregate, buildRefAdvancementFields, checkSingleTarget, computeRefAdvancementName, createControlClient, deriveStatusEdgeAnnotations, disposeEmitQueue, enrichContract, enumerateCheckSpaces, executeContractEmit, executeDbInit, executeDbUpdate, executeDbVerify, executeMigrateShowPlan, executeMigrationNewCommand, executeMigrationPlanCommand, executeRefAdvancement, executeRefDeleteCommand, executeRefListCommand, executeRefSetCommand, hasMigrationPath, listRefsByContractHash, loadAggregateIntegrityViolations, loadContractRawSafely, loadContractSpaceAggregateForCli, mapCaughtMigrationError, mapContractAtError, mapIntegrityViolations, migrationSpaceListEntriesFromAggregate, originHashForStatus, readContractIR, readMigrationRefs, refuseContractSpaceIntegrity, refuseDeclaredExtensionTargetMismatch, refuseMarkerOutsideGraph, refuseMissingInvariantPath, refusePackageCorruptionOnAggregate, refuseUnknownInvariants, resolveContractRef$1 as resolveContractRef, resolveContractRefToSnapshot, resolveFromForPlan, resolveMigrationRef, resolveRefAdvancementFields, resolveToForPlan, runContractSpaceSeedPhase, runMigrationCheck, runMigrationList, statusForMigrationHash };
+import { $ as listRefsByContractHash, B as executeContractEmit, Ct as resolveFromForPlan, Dt as runContractSpaceSeedPhase, G as executeMigrationNewCommand, H as executeDbUpdate, J as executeRefDeleteCommand, K as executeMigrationPlanCommand, Ot as runMigrationCheck, Q as hasMigrationPath, St as resolveContractRefToSnapshot, Tt as resolveToForPlan, U as executeDbVerify, V as executeDbInit, W as executeMigrateShowPlan, X as executeRefSetCommand, Y as executeRefListCommand, _ as enrichContract, _t as refusePackageCorruptionOnAggregate, a as appliedHashesFromLedger, at as mapContractAtError, c as buildReadAggregate, ct as migrationSpaceListEntriesFromAggregate, et as loadAggregateIntegrityViolations, ft as readMigrationRefs, g as disposeEmitQueue, gt as refuseMissingInvariantPath, h as deriveStatusEdgeAnnotations, ht as refuseMarkerOutsideGraph, i as appContractStandInFromIdentity, it as mapCaughtMigrationError, jt as statusForMigrationHash, kt as runMigrationList, l as buildRefAdvancementFields, lt as originHashForStatus, m as createControlClient, mt as refuseDeclaredExtensionTargetMismatch, n as NO_REF_ADVANCEMENT, nt as loadContractSpaceAggregateForCli, o as buildContractSpaceAggregate, ot as mapIntegrityViolations, p as computeRefAdvancementName, pt as refuseContractSpaceIntegrity, q as executeRefAdvancement, r as advanceRefSafely, s as buildMigrationSpaceGraphEntries, tt as loadContractRawSafely, u as checkSingleTarget, ut as preflightRefAdvancement, v as enumerateCheckSpaces, vt as refuseUnknownInvariants, wt as resolveMigrationRef, xt as resolveContractRef$1 } from "./ref-uqvZQnnQ-DpAQaLiM.mjs";
+export { NO_REF_ADVANCEMENT, advanceRefSafely, appContractStandInFromIdentity, appliedHashesFromLedger, buildContractSpaceAggregate, buildMigrationSpaceGraphEntries, buildReadAggregate, buildRefAdvancementFields, checkSingleTarget, computeRefAdvancementName, createControlClient, deriveStatusEdgeAnnotations, disposeEmitQueue, enrichContract, enumerateCheckSpaces, executeContractEmit, executeDbInit, executeDbUpdate, executeDbVerify, executeMigrateShowPlan, executeMigrationNewCommand, executeMigrationPlanCommand, executeRefAdvancement, executeRefDeleteCommand, executeRefListCommand, executeRefSetCommand, hasMigrationPath, listRefsByContractHash, loadAggregateIntegrityViolations, loadContractRawSafely, loadContractSpaceAggregateForCli, mapCaughtMigrationError, mapContractAtError, mapIntegrityViolations, migrationSpaceListEntriesFromAggregate, originHashForStatus, preflightRefAdvancement, readMigrationRefs, refuseContractSpaceIntegrity, refuseDeclaredExtensionTargetMismatch, refuseMarkerOutsideGraph, refuseMissingInvariantPath, refusePackageCorruptionOnAggregate, refuseUnknownInvariants, resolveContractRef$1 as resolveContractRef, resolveContractRefToSnapshot, resolveFromForPlan, resolveMigrationRef, resolveToForPlan, runContractSpaceSeedPhase, runMigrationCheck, runMigrationList, statusForMigrationHash };

package/dist/cli__control-api__testing.d.mts

@@ -1,4 +1,4 @@
-import { C as EmitResult, E as ExecuteDbVerifyResult, O as MigrateResult, _ as DbUpdateResult, a as ControlClient, f as DbInitResult } from "./db-verify-Yih5kWtB-B1kv76ec.mjs";
+import { C as EmitResult, E as ExecuteDbVerifyResult, N as RenderContractDtsResult, O as MigrateResult, _ as DbUpdateResult, a as ControlClient, f as DbInitResult } from "./db-verify-BdKY7U7l-6VLIVuKF.mjs";
 import { CoreSchemaView, OperationPreview, SignDatabaseResult, VerifyDatabaseResult, VerifyDatabaseSchemaResult } from "@prisma/orm-framework/components/control";
 import { ContractMarkerRecord, LedgerEntryRecord } from "@prisma/orm-framework/contract/types";
 import { AuthoringPslBlockDescriptorNamespace } from "@prisma/orm-framework/components/authoring";
@@ -33,6 +33,7 @@ interface ControlClientFixtures {
   readonly getPslBlockDescriptors: AuthoringPslBlockDescriptorNamespace;
   readonly toOperationPreview: OperationPreview | undefined;
   readonly emit: EmitResult;
+  readonly renderContractDts: RenderContractDtsResult;
 }
 interface FixtureControlClientCall {
   readonly operation: string;

package/dist/cli__control-api__testing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli__control-api__testing.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/control-api-testing.d.mts"],"mappings":";;;;;;;cAMc;cACA;cACA;;cAEA;;cAEA;;;;;UAKJ;WACC,QAAQ;WACR,cAAc;WACd,MAAM;WACN,QAAQ;WACR,UAAU;WACV,UAAU;WACV,YAAY;WACZ,gBAAgB,oBAAoB;WACpC,qBAAqB;WACrB,SAAS;WACT;WACA,cAAc;WACd,kBAAkB;WAClB,wBAAwB;WACxB,oBAAoB;WACpB,MAAM;;UAEP;WACC;WACA;;;;;;;;UAQD,6BAA6B;;WAE5B,gBAAgB;;WAEhB;;;;;;iBAMM,gCAAgC;;;;;;iBAMhC,2BAA2B,YAAY,QAAQ,yBAAyB"}
+{"version":3,"file":"cli__control-api__testing.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/control-api-testing.d.mts"],"mappings":";;;;;;;cAMc;cACA;cACA;;cAEA;;cAEA;;;;;UAKJ;WACC,QAAQ;WACR,cAAc;WACd,MAAM;WACN,QAAQ;WACR,UAAU;WACV,UAAU;WACV,YAAY;WACZ,gBAAgB,oBAAoB;WACpC,qBAAqB;WACrB,SAAS;WACT;WACA,cAAc;WACd,kBAAkB;WAClB,wBAAwB;WACxB,oBAAoB;WACpB,MAAM;WACN,mBAAmB;;UAEpB;WACC;WACA;;;;;;;;UAQD,6BAA6B;;WAE5B,gBAAgB;;WAEhB;;;;;;iBAMM,gCAAgC;;;;;;iBAMhC,2BAA2B,YAAY,QAAQ,yBAAyB"}

package/dist/cli__control-api__testing.mjs

@@ -135,7 +135,8 @@ function defaultControlClientFixtures() {
 			profileHash: FIXTURE_PROFILE_HASH,
 			contractJson: `{"targetFamily":"${FIXTURE_FAMILY_ID}"}`,
 			contractDts: `export type Contract = { targetFamily: "${FIXTURE_FAMILY_ID}" };`
-		})
+		}),
+		renderContractDts: ok({ contractDts: `export type Contract = { targetFamily: "${FIXTURE_FAMILY_ID}" };` })
 	};
 }
 var FixtureControlClientImpl = class {
@@ -241,6 +242,9 @@ var FixtureControlClientImpl = class {
 	async emit(options) {
 		return this.record("emit", options, this.fixtures.emit);
 	}
+	async renderContractDts(options) {
+		return this.record("renderContractDts", options, this.fixtures.renderContractDts);
+	}
 };
 /**
 * Creates a fixture-backed {@link ControlClient} double for host and product

package/dist/cli__control-api__testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli__control-api__testing.mjs","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/control-api-testing.mjs"],"sourcesContent":["import { CliStructuredError } from \"@internal/errors/control\";\nimport { APP_SPACE_ID } from \"@internal/framework-components/control\";\nimport { ok } from \"@internal/utils/result\";\n//#region src/control-api/testing/fixture-client.ts\nconst FIXTURE_STORAGE_HASH = \"7f9c2ba4e88f827d616045507605853ed73b8093f6efbc88eb1a6eacfa66ef26\";\nconst FIXTURE_PROFILE_HASH = \"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae\";\nconst FIXTURE_MIGRATION_HASH = \"fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9\";\nconst FIXTURE_TIMESTAMP = \"2026-01-01T00:00:00.000Z\";\n/** Target id the default fixtures report; overridable per test. */\nconst FIXTURE_TARGET_ID = \"fixture-target\";\n/** Family id the default fixtures report in emitted contract payloads. */\nconst FIXTURE_FAMILY_ID = \"fixture-family\";\nconst fixtureOperation = {\n\tid: \"op-1\",\n\tlabel: \"create User\",\n\toperationClass: \"additive\"\n};\nfunction fixtureMarker() {\n\treturn {\n\t\tstorageHash: FIXTURE_STORAGE_HASH,\n\t\tprofileHash: FIXTURE_PROFILE_HASH,\n\t\tcontractJson: null,\n\t\tcanonicalVersion: 1,\n\t\tupdatedAt: /* @__PURE__ */ new Date(FIXTURE_TIMESTAMP),\n\t\tappTag: null,\n\t\tmeta: {},\n\t\tinvariants: []\n\t};\n}\n/**\n* Target-neutral defaults for every operation: a healthy database whose\n* marker, ledger, and schema all match the fixture contract.\n*/\nfunction defaultControlClientFixtures() {\n\tconst contract = {\n\t\tstorageHash: FIXTURE_STORAGE_HASH,\n\t\tprofileHash: FIXTURE_PROFILE_HASH\n\t};\n\tconst target = {\n\t\texpected: FIXTURE_TARGET_ID,\n\t\tactual: FIXTURE_TARGET_ID\n\t};\n\tconst schemaVerify = {\n\t\tok: true,\n\t\tsummary: \"Schema satisfies contract\",\n\t\tcontract,\n\t\ttarget,\n\t\tschema: { issues: [] },\n\t\ttimings: { total: 5 }\n\t};\n\tconst applySuccess = {\n\t\tmode: \"apply\",\n\t\tplan: { operations: [fixtureOperation] },\n\t\tdestination: contract,\n\t\texecution: {\n\t\t\toperationsPlanned: 1,\n\t\t\toperationsExecuted: 1\n\t\t},\n\t\tmarker: contract,\n\t\tperSpace: [{\n\t\t\tspaceId: APP_SPACE_ID,\n\t\t\tkind: \"app\",\n\t\t\toperations: [fixtureOperation],\n\t\t\tmarker: { storageHash: FIXTURE_STORAGE_HASH }\n\t\t}],\n\t\tsummary: \"Applied 1 operation\"\n\t};\n\treturn {\n\t\tverify: {\n\t\t\tok: true,\n\t\t\tsummary: \"Database matches contract\",\n\t\t\tcontract,\n\t\t\tmarker: contract,\n\t\t\ttarget,\n\t\t\ttimings: { total: 5 }\n\t\t},\n\t\tschemaVerify,\n\t\tsign: {\n\t\t\tok: true,\n\t\t\tsummary: \"Signature written\",\n\t\t\tcontract,\n\t\t\ttarget,\n\t\t\tmarker: {\n\t\t\t\tcreated: true,\n\t\t\t\tupdated: false\n\t\t\t},\n\t\t\ttimings: { total: 5 }\n\t\t},\n\t\tdbInit: ok(applySuccess),\n\t\tdbUpdate: ok(applySuccess),\n\t\tdbVerify: ok({\n\t\t\tschemaResults: /* @__PURE__ */ new Map([[APP_SPACE_ID, schemaVerify]]),\n\t\t\tunclaimed: [],\n\t\t\tspaceOrder: [APP_SPACE_ID],\n\t\t\tappSpaceId: APP_SPACE_ID,\n\t\t\tmarkerDrift: null\n\t\t}),\n\t\treadMarker: fixtureMarker(),\n\t\treadAllMarkers: /* @__PURE__ */ new Map([[APP_SPACE_ID, fixtureMarker()]]),\n\t\treadLedger: [{\n\t\t\tspace: APP_SPACE_ID,\n\t\t\tmigrationName: \"20260101000000_init\",\n\t\t\tmigrationHash: FIXTURE_MIGRATION_HASH,\n\t\t\tfrom: null,\n\t\t\tto: FIXTURE_STORAGE_HASH,\n\t\t\tappliedAt: /* @__PURE__ */ new Date(FIXTURE_TIMESTAMP),\n\t\t\toperationCount: 1\n\t\t}],\n\t\tmigrate: ok({\n\t\t\tmigrationsApplied: 1,\n\t\t\tmarkerHash: FIXTURE_STORAGE_HASH,\n\t\t\tapplied: [{\n\t\t\t\tspaceId: APP_SPACE_ID,\n\t\t\t\tdirName: \"20260101000000_init\",\n\t\t\t\tmigrationHash: FIXTURE_MIGRATION_HASH,\n\t\t\t\tfrom: FIXTURE_PROFILE_HASH,\n\t\t\t\tto: FIXTURE_STORAGE_HASH,\n\t\t\t\toperationsExecuted: 1\n\t\t\t}],\n\t\t\tsummary: \"Applied 1 migration\",\n\t\t\tperSpace: [{\n\t\t\t\tspaceId: APP_SPACE_ID,\n\t\t\t\tkind: \"app\",\n\t\t\t\toperations: [fixtureOperation],\n\t\t\t\tmarker: { storageHash: FIXTURE_STORAGE_HASH }\n\t\t\t}]\n\t\t}),\n\t\tintrospect: {},\n\t\ttoSchemaView: void 0,\n\t\tinferPslContract: void 0,\n\t\tgetPslBlockDescriptors: {},\n\t\ttoOperationPreview: void 0,\n\t\temit: ok({\n\t\t\tstorageHash: FIXTURE_STORAGE_HASH,\n\t\t\tprofileHash: FIXTURE_PROFILE_HASH,\n\t\t\tcontractJson: `{\"targetFamily\":\"${FIXTURE_FAMILY_ID}\"}`,\n\t\t\tcontractDts: `export type Contract = { targetFamily: \"${FIXTURE_FAMILY_ID}\" };`\n\t\t})\n\t};\n}\nvar FixtureControlClientImpl = class {\n\tcalls = [];\n\tconnected = false;\n\tinitialized = false;\n\tfixtures;\n\tconstructor(overrides) {\n\t\tthis.fixtures = {\n\t\t\t...defaultControlClientFixtures(),\n\t\t\t...overrides\n\t\t};\n\t}\n\trecord(operation, options, value) {\n\t\tthis.init();\n\t\tthis.calls.push({\n\t\t\toperation,\n\t\t\toptions\n\t\t});\n\t\treturn value;\n\t}\n\t/**\n\t* Records an operation the real client runs against a driver, so a caller\n\t* that skipped `connect()` fails here exactly as it would in production.\n\t*/\n\trecordConnected(operation, options, value) {\n\t\tconst supplied = typeof options === \"object\" && options !== null ? Reflect.get(options, \"connection\") : void 0;\n\t\tif (supplied !== void 0) this.markConnected(supplied);\n\t\tif (!this.connected) throw new CliStructuredError(\"DRIVER.NOT_CONNECTED\", \"Not connected. Call connect(connection) first.\");\n\t\treturn this.record(operation, options, value);\n\t}\n\tinit() {\n\t\tif (this.initialized) return;\n\t\tthis.initialized = true;\n\t\tthis.calls.push({\n\t\t\toperation: \"init\",\n\t\t\toptions: void 0\n\t\t});\n\t}\n\tmarkConnected(connection) {\n\t\tthis.init();\n\t\tthis.calls.push({\n\t\t\toperation: \"connect\",\n\t\t\toptions: connection\n\t\t});\n\t\tthis.connected = true;\n\t}\n\tasync connect(connection) {\n\t\tthis.markConnected(connection);\n\t}\n\tasync close() {\n\t\tthis.calls.push({\n\t\t\toperation: \"close\",\n\t\t\toptions: void 0\n\t\t});\n\t\tthis.connected = false;\n\t}\n\tasync verify(options) {\n\t\treturn this.recordConnected(\"verify\", options, this.fixtures.verify);\n\t}\n\tasync schemaVerify(options) {\n\t\treturn this.recordConnected(\"schemaVerify\", options, this.fixtures.schemaVerify);\n\t}\n\tasync sign(options) {\n\t\treturn this.recordConnected(\"sign\", options, this.fixtures.sign);\n\t}\n\tasync dbInit(options) {\n\t\treturn this.recordConnected(\"dbInit\", options, this.fixtures.dbInit);\n\t}\n\tasync dbUpdate(options) {\n\t\treturn this.recordConnected(\"dbUpdate\", options, this.fixtures.dbUpdate);\n\t}\n\tasync dbVerify(options) {\n\t\treturn this.recordConnected(\"dbVerify\", options, this.fixtures.dbVerify);\n\t}\n\tasync readMarker() {\n\t\treturn this.recordConnected(\"readMarker\", void 0, this.fixtures.readMarker);\n\t}\n\tasync readAllMarkers() {\n\t\treturn this.recordConnected(\"readAllMarkers\", void 0, this.fixtures.readAllMarkers);\n\t}\n\tasync readLedger(space) {\n\t\treturn this.recordConnected(\"readLedger\", space, this.fixtures.readLedger);\n\t}\n\tasync migrate(options) {\n\t\treturn this.recordConnected(\"migrate\", options, this.fixtures.migrate);\n\t}\n\tasync introspect(options) {\n\t\treturn this.recordConnected(\"introspect\", options, this.fixtures.introspect);\n\t}\n\ttoSchemaView(schemaIR) {\n\t\treturn this.record(\"toSchemaView\", schemaIR, this.fixtures.toSchemaView);\n\t}\n\tinferPslContract(schemaIR) {\n\t\treturn this.record(\"inferPslContract\", schemaIR, this.fixtures.inferPslContract);\n\t}\n\tgetPslBlockDescriptors() {\n\t\treturn this.record(\"getPslBlockDescriptors\", void 0, this.fixtures.getPslBlockDescriptors);\n\t}\n\ttoOperationPreview(operations) {\n\t\treturn this.record(\"toOperationPreview\", operations, this.fixtures.toOperationPreview);\n\t}\n\tasync emit(options) {\n\t\treturn this.record(\"emit\", options, this.fixtures.emit);\n\t}\n};\n/**\n* Creates a fixture-backed {@link ControlClient} double for host and product\n* tests: every operation resolves a realistic fixture payload without a\n* database or driver, and each fixture is overridable per test.\n*/\nfunction createFixtureControlClient(overrides) {\n\treturn new FixtureControlClientImpl(overrides);\n}\n//#endregion\nexport { FIXTURE_FAMILY_ID, FIXTURE_MIGRATION_HASH, FIXTURE_PROFILE_HASH, FIXTURE_STORAGE_HASH, FIXTURE_TARGET_ID, createFixtureControlClient, defaultControlClientFixtures };\n\n//# sourceMappingURL=control-api-testing.mjs.map"],"mappings":"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"}
+{"version":3,"file":"cli__control-api__testing.mjs","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/control-api-testing.mjs"],"sourcesContent":["import { CliStructuredError } from \"@internal/errors/control\";\nimport { APP_SPACE_ID } from \"@internal/framework-components/control\";\nimport { ok } from \"@internal/utils/result\";\n//#region src/control-api/testing/fixture-client.ts\nconst FIXTURE_STORAGE_HASH = \"7f9c2ba4e88f827d616045507605853ed73b8093f6efbc88eb1a6eacfa66ef26\";\nconst FIXTURE_PROFILE_HASH = \"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae\";\nconst FIXTURE_MIGRATION_HASH = \"fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9\";\nconst FIXTURE_TIMESTAMP = \"2026-01-01T00:00:00.000Z\";\n/** Target id the default fixtures report; overridable per test. */\nconst FIXTURE_TARGET_ID = \"fixture-target\";\n/** Family id the default fixtures report in emitted contract payloads. */\nconst FIXTURE_FAMILY_ID = \"fixture-family\";\nconst fixtureOperation = {\n\tid: \"op-1\",\n\tlabel: \"create User\",\n\toperationClass: \"additive\"\n};\nfunction fixtureMarker() {\n\treturn {\n\t\tstorageHash: FIXTURE_STORAGE_HASH,\n\t\tprofileHash: FIXTURE_PROFILE_HASH,\n\t\tcontractJson: null,\n\t\tcanonicalVersion: 1,\n\t\tupdatedAt: /* @__PURE__ */ new Date(FIXTURE_TIMESTAMP),\n\t\tappTag: null,\n\t\tmeta: {},\n\t\tinvariants: []\n\t};\n}\n/**\n* Target-neutral defaults for every operation: a healthy database whose\n* marker, ledger, and schema all match the fixture contract.\n*/\nfunction defaultControlClientFixtures() {\n\tconst contract = {\n\t\tstorageHash: FIXTURE_STORAGE_HASH,\n\t\tprofileHash: FIXTURE_PROFILE_HASH\n\t};\n\tconst target = {\n\t\texpected: FIXTURE_TARGET_ID,\n\t\tactual: FIXTURE_TARGET_ID\n\t};\n\tconst schemaVerify = {\n\t\tok: true,\n\t\tsummary: \"Schema satisfies contract\",\n\t\tcontract,\n\t\ttarget,\n\t\tschema: { issues: [] },\n\t\ttimings: { total: 5 }\n\t};\n\tconst applySuccess = {\n\t\tmode: \"apply\",\n\t\tplan: { operations: [fixtureOperation] },\n\t\tdestination: contract,\n\t\texecution: {\n\t\t\toperationsPlanned: 1,\n\t\t\toperationsExecuted: 1\n\t\t},\n\t\tmarker: contract,\n\t\tperSpace: [{\n\t\t\tspaceId: APP_SPACE_ID,\n\t\t\tkind: \"app\",\n\t\t\toperations: [fixtureOperation],\n\t\t\tmarker: { storageHash: FIXTURE_STORAGE_HASH }\n\t\t}],\n\t\tsummary: \"Applied 1 operation\"\n\t};\n\treturn {\n\t\tverify: {\n\t\t\tok: true,\n\t\t\tsummary: \"Database matches contract\",\n\t\t\tcontract,\n\t\t\tmarker: contract,\n\t\t\ttarget,\n\t\t\ttimings: { total: 5 }\n\t\t},\n\t\tschemaVerify,\n\t\tsign: {\n\t\t\tok: true,\n\t\t\tsummary: \"Signature written\",\n\t\t\tcontract,\n\t\t\ttarget,\n\t\t\tmarker: {\n\t\t\t\tcreated: true,\n\t\t\t\tupdated: false\n\t\t\t},\n\t\t\ttimings: { total: 5 }\n\t\t},\n\t\tdbInit: ok(applySuccess),\n\t\tdbUpdate: ok(applySuccess),\n\t\tdbVerify: ok({\n\t\t\tschemaResults: /* @__PURE__ */ new Map([[APP_SPACE_ID, schemaVerify]]),\n\t\t\tunclaimed: [],\n\t\t\tspaceOrder: [APP_SPACE_ID],\n\t\t\tappSpaceId: APP_SPACE_ID,\n\t\t\tmarkerDrift: null\n\t\t}),\n\t\treadMarker: fixtureMarker(),\n\t\treadAllMarkers: /* @__PURE__ */ new Map([[APP_SPACE_ID, fixtureMarker()]]),\n\t\treadLedger: [{\n\t\t\tspace: APP_SPACE_ID,\n\t\t\tmigrationName: \"20260101000000_init\",\n\t\t\tmigrationHash: FIXTURE_MIGRATION_HASH,\n\t\t\tfrom: null,\n\t\t\tto: FIXTURE_STORAGE_HASH,\n\t\t\tappliedAt: /* @__PURE__ */ new Date(FIXTURE_TIMESTAMP),\n\t\t\toperationCount: 1\n\t\t}],\n\t\tmigrate: ok({\n\t\t\tmigrationsApplied: 1,\n\t\t\tmarkerHash: FIXTURE_STORAGE_HASH,\n\t\t\tapplied: [{\n\t\t\t\tspaceId: APP_SPACE_ID,\n\t\t\t\tdirName: \"20260101000000_init\",\n\t\t\t\tmigrationHash: FIXTURE_MIGRATION_HASH,\n\t\t\t\tfrom: FIXTURE_PROFILE_HASH,\n\t\t\t\tto: FIXTURE_STORAGE_HASH,\n\t\t\t\toperationsExecuted: 1\n\t\t\t}],\n\t\t\tsummary: \"Applied 1 migration\",\n\t\t\tperSpace: [{\n\t\t\t\tspaceId: APP_SPACE_ID,\n\t\t\t\tkind: \"app\",\n\t\t\t\toperations: [fixtureOperation],\n\t\t\t\tmarker: { storageHash: FIXTURE_STORAGE_HASH }\n\t\t\t}]\n\t\t}),\n\t\tintrospect: {},\n\t\ttoSchemaView: void 0,\n\t\tinferPslContract: void 0,\n\t\tgetPslBlockDescriptors: {},\n\t\ttoOperationPreview: void 0,\n\t\temit: ok({\n\t\t\tstorageHash: FIXTURE_STORAGE_HASH,\n\t\t\tprofileHash: FIXTURE_PROFILE_HASH,\n\t\t\tcontractJson: `{\"targetFamily\":\"${FIXTURE_FAMILY_ID}\"}`,\n\t\t\tcontractDts: `export type Contract = { targetFamily: \"${FIXTURE_FAMILY_ID}\" };`\n\t\t}),\n\t\trenderContractDts: ok({ contractDts: `export type Contract = { targetFamily: \"${FIXTURE_FAMILY_ID}\" };` })\n\t};\n}\nvar FixtureControlClientImpl = class {\n\tcalls = [];\n\tconnected = false;\n\tinitialized = false;\n\tfixtures;\n\tconstructor(overrides) {\n\t\tthis.fixtures = {\n\t\t\t...defaultControlClientFixtures(),\n\t\t\t...overrides\n\t\t};\n\t}\n\trecord(operation, options, value) {\n\t\tthis.init();\n\t\tthis.calls.push({\n\t\t\toperation,\n\t\t\toptions\n\t\t});\n\t\treturn value;\n\t}\n\t/**\n\t* Records an operation the real client runs against a driver, so a caller\n\t* that skipped `connect()` fails here exactly as it would in production.\n\t*/\n\trecordConnected(operation, options, value) {\n\t\tconst supplied = typeof options === \"object\" && options !== null ? Reflect.get(options, \"connection\") : void 0;\n\t\tif (supplied !== void 0) this.markConnected(supplied);\n\t\tif (!this.connected) throw new CliStructuredError(\"DRIVER.NOT_CONNECTED\", \"Not connected. Call connect(connection) first.\");\n\t\treturn this.record(operation, options, value);\n\t}\n\tinit() {\n\t\tif (this.initialized) return;\n\t\tthis.initialized = true;\n\t\tthis.calls.push({\n\t\t\toperation: \"init\",\n\t\t\toptions: void 0\n\t\t});\n\t}\n\tmarkConnected(connection) {\n\t\tthis.init();\n\t\tthis.calls.push({\n\t\t\toperation: \"connect\",\n\t\t\toptions: connection\n\t\t});\n\t\tthis.connected = true;\n\t}\n\tasync connect(connection) {\n\t\tthis.markConnected(connection);\n\t}\n\tasync close() {\n\t\tthis.calls.push({\n\t\t\toperation: \"close\",\n\t\t\toptions: void 0\n\t\t});\n\t\tthis.connected = false;\n\t}\n\tasync verify(options) {\n\t\treturn this.recordConnected(\"verify\", options, this.fixtures.verify);\n\t}\n\tasync schemaVerify(options) {\n\t\treturn this.recordConnected(\"schemaVerify\", options, this.fixtures.schemaVerify);\n\t}\n\tasync sign(options) {\n\t\treturn this.recordConnected(\"sign\", options, this.fixtures.sign);\n\t}\n\tasync dbInit(options) {\n\t\treturn this.recordConnected(\"dbInit\", options, this.fixtures.dbInit);\n\t}\n\tasync dbUpdate(options) {\n\t\treturn this.recordConnected(\"dbUpdate\", options, this.fixtures.dbUpdate);\n\t}\n\tasync dbVerify(options) {\n\t\treturn this.recordConnected(\"dbVerify\", options, this.fixtures.dbVerify);\n\t}\n\tasync readMarker() {\n\t\treturn this.recordConnected(\"readMarker\", void 0, this.fixtures.readMarker);\n\t}\n\tasync readAllMarkers() {\n\t\treturn this.recordConnected(\"readAllMarkers\", void 0, this.fixtures.readAllMarkers);\n\t}\n\tasync readLedger(space) {\n\t\treturn this.recordConnected(\"readLedger\", space, this.fixtures.readLedger);\n\t}\n\tasync migrate(options) {\n\t\treturn this.recordConnected(\"migrate\", options, this.fixtures.migrate);\n\t}\n\tasync introspect(options) {\n\t\treturn this.recordConnected(\"introspect\", options, this.fixtures.introspect);\n\t}\n\ttoSchemaView(schemaIR) {\n\t\treturn this.record(\"toSchemaView\", schemaIR, this.fixtures.toSchemaView);\n\t}\n\tinferPslContract(schemaIR) {\n\t\treturn this.record(\"inferPslContract\", schemaIR, this.fixtures.inferPslContract);\n\t}\n\tgetPslBlockDescriptors() {\n\t\treturn this.record(\"getPslBlockDescriptors\", void 0, this.fixtures.getPslBlockDescriptors);\n\t}\n\ttoOperationPreview(operations) {\n\t\treturn this.record(\"toOperationPreview\", operations, this.fixtures.toOperationPreview);\n\t}\n\tasync emit(options) {\n\t\treturn this.record(\"emit\", options, this.fixtures.emit);\n\t}\n\tasync renderContractDts(options) {\n\t\treturn this.record(\"renderContractDts\", options, this.fixtures.renderContractDts);\n\t}\n};\n/**\n* Creates a fixture-backed {@link ControlClient} double for host and product\n* tests: every operation resolves a realistic fixture payload without a\n* database or driver, and each fixture is overridable per test.\n*/\nfunction createFixtureControlClient(overrides) {\n\treturn new FixtureControlClientImpl(overrides);\n}\n//#endregion\nexport { FIXTURE_FAMILY_ID, FIXTURE_MIGRATION_HASH, FIXTURE_PROFILE_HASH, FIXTURE_STORAGE_HASH, FIXTURE_TARGET_ID, createFixtureControlClient, defaultControlClientFixtures };\n\n//# sourceMappingURL=control-api-testing.mjs.map"],"mappings":"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"}

package/dist/{db-verify-Yih5kWtB-B1kv76ec.d.mts → db-verify-BdKY7U7l-6VLIVuKF.d.mts}

@@ -1,4 +1,5 @@
 import "./ref-resolution-CaHQJXE0.mjs";
+import { ImportSpecifierResolver } from "@prisma/orm-framework/components/emission";
 import { CliStructuredError as CliStructuredError$2 } from "@prisma/orm-framework/errors/control";
 import { ControlAdapterDescriptor, ControlDriverDescriptor, ControlDriverInstance, ControlExtensionDescriptor, ControlFamilyDescriptor, ControlFamilyInstance, ControlTargetDescriptor, CoreSchemaView, MigrationPlanOperation, MigrationPlannerConflict, OperationPreview, SignDatabaseResult, VerifyDatabaseResult, VerifyDatabaseSchemaResult } from "@prisma/orm-framework/components/control";
 import { Result } from "@prisma/orm-framework/utils/result";
@@ -10,7 +11,36 @@ import "@prisma/cli-engine/protocol";
 import { ContractSourceDiagnostics, ContractSourceProvider, PrismaNextConfig } from "@prisma/orm-framework/config/config-types";
 import { AuthoringPslBlockDescriptorNamespace } from "@prisma/orm-framework/components/authoring";
 import { PslDocumentAst } from "@prisma/orm-framework/components/psl-ast";
-//#region ../../../1-framework/3-tooling/cli/dist/db-verify-Yih5kWtB.d.mts
+//#region ../../../1-framework/3-tooling/cli/dist/db-verify-BdKY7U7l.d.mts
+//#region src/control-api/render-contract-dts.d.ts
+/**
+ * Options for rendering the `contract.d.ts` text of an already-emitted
+ * contract, as read from `contract.json`.
+ */
+interface RenderContractDtsOptions {
+  /** The parsed `contract.json` to render types for. */
+  readonly contract: unknown;
+  /**
+   * Rewrites the package names the declarations import from, for the import
+   * root of the project that keeps them. Defaults to leaving every specifier
+   * as authored.
+   */
+  readonly resolveImportSpecifier?: ImportSpecifierResolver;
+}
+interface RenderContractDtsSuccess {
+  /** The declarations, rendered through the same emitter as `emit`, with the import specifiers the caller asked for. */
+  readonly contractDts: string;
+}
+type RenderContractDtsFailureCode = 'CONTRACT_VALIDATION_FAILED' | 'RENDER_FAILED';
+interface RenderContractDtsFailure {
+  readonly code: RenderContractDtsFailureCode;
+  readonly summary: string;
+  readonly why: string | undefined;
+  /** Underlying error for diagnostics; never serialized into envelopes. */
+  readonly cause?: unknown;
+}
+type RenderContractDtsResult = Result<RenderContractDtsSuccess, RenderContractDtsFailure>;
+//#endregion
 //#region src/control-api/types.d.ts
 /**
  * Options for creating a control client.
@@ -884,6 +914,14 @@ interface ControlClient {
    * @returns Result pattern: Ok with emit details, NotOk with failure details
    */
   emit(options: EmitOptions): Promise<EmitResult>;
+  /**
+   * Renders the `contract.d.ts` text for a `contract.json` that was already
+   * emitted. A snapshot of a contract is that JSON plus these declarations, so
+   * whoever writes a snapshot renders them from the JSON it is storing rather
+   * than reading a sibling file that may have drifted or gone missing.
+   * Offline: uses `init()` but never `connect()`.
+   */
+  renderContractDts(options: RenderContractDtsOptions): Promise<RenderContractDtsResult>;
 }
 //#endregion
 //#region src/control-api/operations/db-verify.d.ts
@@ -959,5 +997,5 @@ type ExecuteDbVerifyResult = Result<ExecuteDbVerifySuccess, CliStructuredError$2
  */
 declare function executeDbVerify<TFamilyId extends string, TTargetId extends string>(options: ExecuteDbVerifyOptions<TFamilyId, TTargetId>): Promise<ExecuteDbVerifyResult>;
 //#endregion
-export { SchemaVerifyOptions as A, EmitResult as C, IntrospectOptions as D, ExecuteDbVerifyResult as E, VerifyOptions as M, executeDbVerify as N, MigrateResult as O, EmitOptions as S, ExecuteDbVerifyOptions as T, DbUpdateResult as _, ControlClient as a, EmitFailure as b, CreateControlClient as c, DbInitOptions as d, DbInitResult as f, DbUpdateOptions as g, DbUpdateFailureCode as h, ControlActionName as i, SignOptions as j, OnControlProgress as k, DbInitFailure as l, DbUpdateFailure as m, ContractEmitOptions as n, ControlClientOptions as o, DbInitSuccess as p, ContractEmitResult as r, ControlProgressEvent as s, CliStructuredError$2 as t, DbInitFailureCode as u, DbUpdateSuccess as v, EmitSuccess as w, EmitFailureCode as x, EmitContractConfig as y };
-//# sourceMappingURL=db-verify-Yih5kWtB-B1kv76ec.d.mts.map
+export { RenderContractDtsFailure as A, EmitResult as C, IntrospectOptions as D, ExecuteDbVerifyResult as E, SchemaVerifyOptions as F, SignOptions as I, VerifyOptions as L, RenderContractDtsOptions as M, RenderContractDtsResult as N, MigrateResult as O, RenderContractDtsSuccess as P, executeDbVerify as R, EmitOptions as S, ExecuteDbVerifyOptions as T, DbUpdateResult as _, ControlClient as a, EmitFailure as b, CreateControlClient as c, DbInitOptions as d, DbInitResult as f, DbUpdateOptions as g, DbUpdateFailureCode as h, ControlActionName as i, RenderContractDtsFailureCode as j, OnControlProgress as k, DbInitFailure as l, DbUpdateFailure as m, ContractEmitOptions as n, ControlClientOptions as o, DbInitSuccess as p, ContractEmitResult as r, ControlProgressEvent as s, CliStructuredError$2 as t, DbInitFailureCode as u, DbUpdateSuccess as v, EmitSuccess as w, EmitFailureCode as x, EmitContractConfig as y };
+//# sourceMappingURL=db-verify-BdKY7U7l-6VLIVuKF.d.mts.map

package/dist/db-verify-BdKY7U7l-6VLIVuKF.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-verify-BdKY7U7l-6VLIVuKF.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/db-verify-BdKY7U7l.d.mts"],"mappings":"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"}

package/dist/{ref-DcqFmceq-QaUjgZeM.mjs → ref-uqvZQnnQ-DpAQaLiM.mjs}

@@ -11,13 +11,14 @@ import { d as writeRef, i as readRefs, l as validateRefName, n as deleteRef, o a
 import { a as isValidSpaceId, c as spaceMigrationDirectory, l as spaceRefsDirectory, o as listContractSpaceDirectories, s as readContractSpaceHeadRef, t as APP_SPACE_ID$1 } from "./verify-contract-spaces-CrxvgpwD-D5LLXGci.mjs";
 import { d as resolveRecordedPath, f as verifyMigration, l as planMigration, n as buildFabricatedMigrationEdge, r as collectAggregateNamespaces, s as loadContractSpaceAggregate, t as allStorageElementsExternal, u as requireHeadRef } from "./aggregate-B4HKshLQ.mjs";
 import { i as emitContractSpaceArtifacts, o as planAllSpaces } from "./spaces-BCZiAZQn.mjs";
-import { c as internalImportRoot, o as importRootForDependencies, r as createImportSpecifierResolver } from "./import-roots-BHOrDJbI.mjs";
+import { c as internalImportRoot, o as importRootForDependencies, r as createImportSpecifierResolver, t as ImportRootError } from "./import-roots-BHOrDJbI.mjs";
 import { n as parseContractRef, r as parseMigrationRef } from "./ref-resolution-BWpwb8_b.mjs";
 import { i as writeMigrationTs } from "./migration-ts-DdVm0rws.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { ifDefined } from "@prisma/orm-framework/utils/defined";
 import { structuredError } from "@prisma/orm-framework/utils/structured-error";
+import { keepInternalSpecifiers } from "@prisma/orm-framework/components/emission";
 import { blindCast, castAs } from "@prisma/orm-framework/utils/casts";
 import { InternalError } from "@prisma/orm-framework/utils/internal-error";
 import { CliStructuredError, CliStructuredError as CliStructuredError$1, errorConfigValidation as errorConfigValidation$1, errorContractConfigMissing, errorContractValidationFailed, errorDatabaseConnectionRequired, errorDriverRequired, errorFileNotFound, errorMigrationPlanningFailed, errorTargetMigrationNotSupported, errorUnexpected } from "@prisma/orm-framework/errors/control";
@@ -32,7 +33,7 @@ import { createHash } from "node:crypto";
 import { canonicalizeJson } from "@prisma/orm-framework/components/utils";
 import { abortable } from "@prisma/orm-framework/utils/abortable";
 import { resolve as resolve$1 } from "node:path";
-//#region ../../../1-framework/3-tooling/cli/dist/ref-DcqFmceq.mjs
+//#region ../../../1-framework/3-tooling/cli/dist/ref-uqvZQnnQ.mjs
 /**
 * The typed remediation the CLI attaches to its own errors and findings.
 * Constructors live here rather than in any library the CLI calls: naming a
@@ -2542,10 +2543,7 @@ var ControlClientImpl = class {
 					meta: void 0
 				});
 			}
-			const result = await emit(deserializedContract, this.stack, this.options.family.emission, {
-				serializeContract: (contract) => this.options.target.contractSerializer.serializeContract(contract),
-				...ifDefined("supportsNamespaces", this.options.target.supportsNamespaces)
-			});
+			const result = await this.emitArtifacts(deserializedContract, keepInternalSpecifiers);
 			onProgress?.({
 				action: "emit",
 				kind: "spanEnd",
@@ -2574,6 +2572,39 @@ var ControlClientImpl = class {
 			});
 		}
 	}
+	async renderContractDts(options) {
+		this.init();
+		if (!this.familyInstance) throw new InternalError("Family instance was not initialized. This is a bug.");
+		let contract;
+		try {
+			contract = this.familyInstance.deserializeContract(options.contract);
+		} catch (error) {
+			return notOk({
+				code: "CONTRACT_VALIDATION_FAILED",
+				summary: "Contract validation failed",
+				why: error instanceof Error ? error.message : String(error),
+				cause: error
+			});
+		}
+		try {
+			const { contractDts } = await this.emitArtifacts(contract, options.resolveImportSpecifier ?? keepInternalSpecifiers);
+			return ok({ contractDts });
+		} catch (error) {
+			return notOk({
+				code: "RENDER_FAILED",
+				summary: "Failed to render contract types",
+				why: error instanceof Error ? error.message : String(error),
+				cause: error
+			});
+		}
+	}
+	emitArtifacts(contract, resolveImportSpecifier) {
+		return emit(contract, this.stack, this.options.family.emission, {
+			serializeContract: (c) => this.options.target.contractSerializer.serializeContract(c),
+			resolveImportSpecifier,
+			...ifDefined("supportsNamespaces", this.options.target.supportsNamespaces)
+		});
+	}
 };
 /**
 * Per-output FIFO queue for `executeContractEmit`.
@@ -2662,7 +2693,10 @@ function nearestManifest(from) {
 			fix: `Make \`${path}\` a JSON object with the usual manifest fields, then re-run the command. Emission reads it to decide which package names generated files should import.`,
 			meta: { path }
 		});
-		return parsed;
+		return {
+			manifest: parsed,
+			path
+		};
 	}
 }
 function declaredDependencies(manifest) {
@@ -2680,9 +2714,19 @@ function declaredDependencies(manifest) {
 * project that has not moved to published names is unaffected.
 */
 function projectImportRoot(configPath) {
-	const manifest = nearestManifest(configPath === void 0 ? resolve(".") : dirname(resolve(configPath)));
-	if (manifest === void 0) return internalImportRoot;
-	return importRootForDependencies(declaredDependencies(manifest));
+	const nearest = nearestManifest(configPath === void 0 ? resolve(".") : dirname(resolve(configPath)));
+	if (nearest === void 0) return internalImportRoot;
+	try {
+		return importRootForDependencies(declaredDependencies(nearest.manifest));
+	} catch (cause) {
+		if (!(cause instanceof ImportRootError)) throw cause;
+		throw errorRuntime("CLI.PROJECT_MANIFEST_INVALID", `Failed to read ${nearest.path}`, {
+			why: `\`${nearest.path}\` states dependencies emission cannot import from: ${cause.message}.`,
+			fix: `Keep one database facade in \`${nearest.path}\`, then re-run the command. Emission reads it to decide which package names generated files should import.`,
+			meta: { path: nearest.path },
+			cause
+		});
+	}
 }
 /** The specifier resolver emission should use for the project owning `configPath`. */
 function createProjectSpecifierResolver(configPath) {
@@ -2983,47 +3027,54 @@ async function executeContractEmit(options, dependencies = defaultContractEmitDe
 		};
 	});
 }
+const NO_REF_ADVANCEMENT = {
+	advancedRef: null,
+	plannedAdvanceRef: null
+};
 function computeRefAdvancementName(options) {
 	if (options.advanceRef !== void 0) return options.advanceRef;
 	if (options.db === void 0) return "db";
 	return null;
 }
-function contractDtsPathOf(contractJsonPath) {
-	return contractJsonPath.replace(/\.json$/i, ".d.ts");
-}
-async function readContractIR(contractJson, contractJsonPath) {
-	return {
-		contract: contractJson,
-		contractDts: await readFile(contractDtsPathOf(contractJsonPath), "utf-8")
-	};
-}
-function fsErrorCodeOf(error) {
-	const code = error instanceof Error ? Reflect.get(error, "code") : void 0;
-	return typeof code === "string" ? code : void 0;
-}
-function errorUnreadableContractDts(contractJsonPath, cause) {
-	const contractDtsPath = contractDtsPathOf(contractJsonPath);
-	const code = fsErrorCodeOf(cause);
-	return errorFileNotFound(contractDtsPath, {
-		why: code === "ENOENT" ? `The contract types next to ${contractJsonPath} are missing: ${contractDtsPath}` : `The contract types next to ${contractJsonPath} could not be read${code === void 0 ? "" : ` (${code})`}: ${contractDtsPath}`,
-		fix: "Run {bin} contract emit to regenerate the contract artifacts, then advance the ref again.",
-		cause
+function errorContractDtsRenderFailed(contractJsonPath, failure) {
+	const why = failure.why ?? failure.summary;
+	if (failure.code === "CONTRACT_VALIDATION_FAILED") return errorContractValidationFailed(`Contract at ${contractJsonPath} failed to deserialize: ${why}`, {
+		where: { path: contractJsonPath },
+		...ifDefined("cause", failure.cause)
+	});
+	return new CliStructuredError$1("CONTRACT.TYPES_RENDER_FAILED", "Failed to render contract types", {
+		why: `The types for the contract at ${contractJsonPath} could not be rendered: ${why}`,
+		fix: "Run {bin} contract emit to see why the contract does not emit, fix it, then advance the ref again.",
+		where: { path: contractJsonPath },
+		...ifDefined("cause", failure.cause)
 	});
 }
 /**
-* Everything `advanceRefSafely` needs from disk, loaded before a command does
-* the work that precedes the ref write: the ref name is validated and the
-* sibling `.d.ts` of the contract to snapshot is read. The returned
-* `ContractIR` is what the command then hands to `advanceRefSafely`, so no
-* file is read after the database is signed.
+* Everything `executeRefAdvancement` needs, produced before a command does the
+* work that precedes the ref write: the ref name is validated and the
+* declarations of the contract to snapshot are rendered from its JSON, with
+* the import names the project owning `configPath` can resolve. Nothing is
+* read or rendered after the database is touched, so a contract that cannot
+* be snapshotted refuses the command before it changes anything.
 */
 async function preflightRefAdvancement(args) {
 	if (!validateRefName(args.name)) return notOk(errorInvalidRefName(args.name));
+	let resolveImportSpecifier;
 	try {
-		return ok(await readContractIR(args.contractJson, args.contractJsonPath));
+		resolveImportSpecifier = createProjectSpecifierResolver(args.configPath);
 	} catch (error) {
-		return notOk(errorUnreadableContractDts(args.contractJsonPath, error));
+		if (CliStructuredError$1.is(error)) return notOk(error);
+		throw error;
 	}
+	const rendered = await args.client.renderContractDts({
+		contract: args.contractJson,
+		resolveImportSpecifier
+	});
+	if (!rendered.ok) return notOk(errorContractDtsRenderFailed(args.contractJsonPath, rendered.failure));
+	return ok({
+		contract: args.contractJson,
+		contractDts: rendered.value.contractDts
+	});
 }
 async function executeRefAdvancement(refsDir, migrationsDir, name, hash, contractIR) {
 	if (!validateRefName(name)) throw errorInvalidRefName(name);
@@ -3040,55 +3091,31 @@ async function executeRefAdvancement(refsDir, migrationsDir, name, hash, contrac
 		hash
 	};
 }
+/**
+* The ref-advancement tail of db init / db update, run after the database
+* work with the `ContractIR` that `preflightRefAdvancement` produced before
+* it. Plan mode reports the ref that an apply would advance without writing.
+*/
 async function buildRefAdvancementFields(options) {
-	const name = computeRefAdvancementName({
-		...ifDefined("advanceRef", options.advanceRef),
-		...ifDefined("db", options.db)
-	});
-	if (name === null) return {
-		advancedRef: null,
-		plannedAdvanceRef: null
-	};
-	if (options.mode === "plan") return {
+	if (options.mode === "plan") return ok({
 		advancedRef: null,
 		plannedAdvanceRef: {
-			name,
+			name: options.name,
 			hash: options.hash
 		}
-	};
-	return {
-		advancedRef: await executeRefAdvancement(options.refsDir, options.migrationsDir, name, options.hash, options.contractIR),
-		plannedAdvanceRef: null
-	};
-}
-/**
-* Full ref-advancement phase for db init/update: ok({advancedRef:null, plannedAdvanceRef:null})
-* when computeRefAdvancementName is null; else readContractIR + buildRefAdvancementFields with
-* MigrationToolsError mapped, other errors rethrown.
-*/
-async function resolveRefAdvancementFields(options) {
-	if (computeRefAdvancementName({
-		...ifDefined("advanceRef", options.advanceRef),
-		...ifDefined("db", options.db)
-	}) === null) return ok({
-		advancedRef: null,
+	});
+	const advanced = await advanceRefSafely({
+		refsDir: options.refsDir,
+		migrationsDir: options.migrationsDir,
+		name: options.name,
+		hash: options.hash,
+		contractIR: options.contractIR
+	});
+	if (!advanced.ok) return advanced;
+	return ok({
+		advancedRef: advanced.value,
 		plannedAdvanceRef: null
 	});
-	try {
-		const contractIR = await readContractIR(options.contractJson, options.contractJsonPath);
-		return ok(await buildRefAdvancementFields({
-			...ifDefined("advanceRef", options.advanceRef),
-			...ifDefined("db", options.db),
-			refsDir: options.refsDir,
-			migrationsDir: options.migrationsDir,
-			contractIR,
-			mode: options.mode,
-			hash: options.hash
-		}));
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(error);
-		throw error;
-	}
 }
 /**
 * The --advance-ref tail of migrate and db sign: executeRefAdvancement with
@@ -4784,6 +4811,6 @@ async function executeRefListCommand(options) {
 	}
 }
 //#endregion
-export { loadAggregateIntegrityViolations as $, errorMigrationPackageNotFound as A, runMigrationList as At, executeDbInit as B, errorDatabaseConnectionRequired as C, resolveFromForPlan as Ct, errorHashMismatch as D, runCommandAction as Dt, errorFileNotFound as E, resolveToForPlan as Et, errorRuntime as F, executeMigrationPlanCommand as G, executeDbVerify as H, errorTargetMigrationNotSupported as I, executeRefListCommand as J, executeRefAdvancement as K, errorTargetMismatch as L, errorNoMigrations as M, statusForMigrationHash as Mt, errorPathUnreachable as N, targetSupportsMigrations as Nt, errorLegendHumanOnly as O, runContractSpaceSeedPhase as Ot, errorRunnerFailed as P, toDeclaredExtensionsFromRaw as Pt, listRefsByContractHash as Q, errorUnexpected as R, errorContractValidationFailed as S, resolveContractRefToSnapshot as St, errorDriverRequired as T, resolveRefAdvancementFields as Tt, executeMigrateShowPlan as U, executeDbUpdate as V, executeMigrationNewCommand as W, findPackageByDirPath as X, executeRefSetCommand as Y, hasMigrationPath as Z, enumerateCheckSpaces as _, refusePackageCorruptionOnAggregate as _t, buildContractSpaceAggregate as a, mapIntegrityViolations as at, errorConsentPlanMismatch as b, resolveAppTargetPath as bt, buildRefAdvancementFields as c, originHashForStatus as ct, closeQuietly as d, readContractIR as dt, loadContractRawSafely as et, computeRefAdvancementName as f, readMigrationRefs as ft, enrichContract as g, refuseMissingInvariantPath as gt, disposeEmitQueue as h, refuseMarkerOutsideGraph as ht, appliedHashesFromLedger as i, mapContractAtError as it, errorMigrationPlanningFailed as j, sanitizeErrorMessage as jt, errorMarkerMissing as k, runMigrationCheck as kt, checkSingleTarget as l, preflightRefAdvancement as lt, deriveStatusEdgeAnnotations as m, refuseDeclaredExtensionTargetMismatch as mt, advanceRefSafely as n, looksLikePath as nt, buildMigrationSpaceGraphEntries as o, maskConnectionUrl as ot, createControlClient as p, refuseContractSpaceIntegrity as pt, executeRefDeleteCommand as q, appContractStandInFromIdentity as r, mapCaughtMigrationError as rt, buildReadAggregate as s, migrationSpaceListEntriesFromAggregate as st, CliStructuredError$1 as t, loadContractSpaceAggregateForCli as tt, chooseAction as u, readContractEnvelope as ut, errorAdvanceRefArgConflict as v, refuseUnknownInvariants as vt, errorDestructiveChanges as w, resolveMigrationRef as wt, errorContractArgConflict as x, resolveContractRef$1 as xt, errorConfigValidation$1 as y, requireLiveDatabase as yt, executeContractEmit as z };
+export { listRefsByContractHash as $, errorMarkerMissing as A, sanitizeErrorMessage as At, executeContractEmit as B, errorContractValidationFailed as C, resolveFromForPlan as Ct, errorFileNotFound as D, runContractSpaceSeedPhase as Dt, errorDriverRequired as E, runCommandAction as Et, errorRunnerFailed as F, executeMigrationNewCommand as G, executeDbUpdate as H, errorRuntime as I, executeRefDeleteCommand as J, executeMigrationPlanCommand as K, errorTargetMigrationNotSupported as L, errorMigrationPlanningFailed as M, targetSupportsMigrations as Mt, errorNoMigrations as N, toDeclaredExtensionsFromRaw as Nt, errorHashMismatch as O, runMigrationCheck as Ot, errorPathUnreachable as P, hasMigrationPath as Q, errorTargetMismatch as R, errorContractArgConflict as S, resolveContractRefToSnapshot as St, errorDestructiveChanges as T, resolveToForPlan as Tt, executeDbVerify as U, executeDbInit as V, executeMigrateShowPlan as W, executeRefSetCommand as X, executeRefListCommand as Y, findPackageByDirPath as Z, enrichContract as _, refusePackageCorruptionOnAggregate as _t, appliedHashesFromLedger as a, mapContractAtError as at, errorConfigValidation$1 as b, resolveAppTargetPath as bt, buildReadAggregate as c, migrationSpaceListEntriesFromAggregate as ct, chooseAction as d, readContractEnvelope as dt, loadAggregateIntegrityViolations as et, closeQuietly as f, readMigrationRefs as ft, disposeEmitQueue as g, refuseMissingInvariantPath as gt, deriveStatusEdgeAnnotations as h, refuseMarkerOutsideGraph as ht, appContractStandInFromIdentity as i, mapCaughtMigrationError as it, errorMigrationPackageNotFound as j, statusForMigrationHash as jt, errorLegendHumanOnly as k, runMigrationList as kt, buildRefAdvancementFields as l, originHashForStatus as lt, createControlClient as m, refuseDeclaredExtensionTargetMismatch as mt, NO_REF_ADVANCEMENT as n, loadContractSpaceAggregateForCli as nt, buildContractSpaceAggregate as o, mapIntegrityViolations as ot, computeRefAdvancementName as p, refuseContractSpaceIntegrity as pt, executeRefAdvancement as q, advanceRefSafely as r, looksLikePath as rt, buildMigrationSpaceGraphEntries as s, maskConnectionUrl as st, CliStructuredError$1 as t, loadContractRawSafely as tt, checkSingleTarget as u, preflightRefAdvancement as ut, enumerateCheckSpaces as v, refuseUnknownInvariants as vt, errorDatabaseConnectionRequired as w, resolveMigrationRef as wt, errorConsentPlanMismatch as x, resolveContractRef$1 as xt, errorAdvanceRefArgConflict as y, requireLiveDatabase as yt, errorUnexpected as z };
 
-//# sourceMappingURL=ref-DcqFmceq-QaUjgZeM.mjs.map
+//# sourceMappingURL=ref-uqvZQnnQ-DpAQaLiM.mjs.map