prisma-next 0.12.0-dev.5 → 0.12.0-dev.51

package/dist/{client-KgJorIvG.mjs → client-DC-UlBLy.mjs}

@@ -1,15 +1,15 @@
-import { A as CliStructuredError } from "./command-helpers-Bbw1GbwL.mjs";
-import { t as assertFrameworkComponentsCompatible } from "./framework-components-fYXjz_in.mjs";
+import { F as CliStructuredError } from "./command-helpers-esJGBD4W.mjs";
+import { t as assertFrameworkComponentsCompatible } from "./framework-components-BO9VO43s.mjs";
 import { t as enrichContract } from "./contract-enrichment-a0V5Y_mL.mjs";
-import { n as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-DvZwdkrr.mjs";
+import { t as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-CpNVrBqW.mjs";
 import { emit } from "@prisma-next/emitter";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { APP_SPACE_ID, createControlStack, hasMigrations, hasOperationPreview, hasPslContractInfer, hasSchemaView } from "@prisma-next/framework-components/control";
-import { graphWalkStrategy, planMigration, requireHeadRef, verifyMigration } from "@prisma-next/migration-tools/aggregate";
+import { castAs } from "@prisma-next/utils/casts";
+import { buildSynthMigrationEdge, graphWalkStrategy, planMigration, requireHeadRef, verifyMigration } from "@prisma-next/migration-tools/aggregate";
 import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
 import { errorNoInvariantPath } from "@prisma-next/migration-tools/errors";
-import { castAs } from "@prisma-next/utils/casts";
 import { findPathWithDecision } from "@prisma-next/migration-tools/migration-graph";
 //#region src/control-api/errors.ts
 var ContractValidationError = class extends Error {
@@ -21,14 +21,27 @@ var ContractValidationError = class extends Error {
 	}
 };
 //#endregion
-//#region src/control-api/operations/apply.ts
+//#region src/control-api/operations/migration-helpers.ts
 /**
-* Span id emitted via `onProgress` for the apply phase. Stable
+* Strips operation objects to their public shape (id, label, operationClass).
+* Used at the API boundary to avoid leaking internal fields (precheck, execute, postcheck, etc.).
+*/
+function stripOperations(operations) {
+	return operations.map((op) => ({
+		id: op.id,
+		label: op.label,
+		operationClass: op.operationClass
+	}));
+}
+//#endregion
+//#region src/control-api/operations/run-migration.ts
+/**
+* Span id emitted via `onProgress` for the run phase. Stable
 * identifier consumed by the structured-output renderer and by tests.
 */
-const APPLY_SPAN_ID = "apply";
+const RUN_SPAN_ID = "apply";
 /**
-* Runner-driving tail shared by every apply caller — `db init`,
+* Runner-driving tail shared by every run caller — `db init`,
 * `db update`, and `migrate`. Consumes already-resolved per-space
 * plans (the planner-vs-replay distinction is owned by the caller) and
 * dispatches them to the runner in canonical order.
@@ -43,14 +56,14 @@ const APPLY_SPAN_ID = "apply";
 * so callers don't have to duplicate it; the `action` field on each
 * progress event is taken from the caller's `action` argument.
 */
-async function applyMigration(inputs) {
+async function runMigration(inputs) {
 	const { aggregate, perSpacePlans, applyOrder, driver, familyInstance, migrations, frameworkComponents, policy, action, onProgress } = inputs;
 	const orderedResolutions = collectOrdered(applyOrder, perSpacePlans);
 	const runner = migrations.createRunner(familyInstance);
 	onProgress?.({
 		action,
 		kind: "spanStart",
-		spanId: APPLY_SPAN_ID,
+		spanId: RUN_SPAN_ID,
 		label: progressLabelForAction(action)
 	});
 	const perSpaceOptions = orderedResolutions.map((r) => ({
@@ -60,6 +73,7 @@ async function applyMigration(inputs) {
 		destinationContract: r.entry.destinationContract,
 		policy,
 		frameworkComponents,
+		migrationEdges: r.entry.migrationEdges,
 		strictVerification: false
 	}));
 	const runnerResult = await runner.execute({
@@ -70,7 +84,7 @@ async function applyMigration(inputs) {
 		onProgress?.({
 			action,
 			kind: "spanEnd",
-			spanId: APPLY_SPAN_ID,
+			spanId: RUN_SPAN_ID,
 			outcome: "error"
 		});
 		return notOk({
@@ -86,7 +100,7 @@ async function applyMigration(inputs) {
 	onProgress?.({
 		action,
 		kind: "spanEnd",
-		spanId: APPLY_SPAN_ID,
+		spanId: RUN_SPAN_ID,
 		outcome: "ok"
 	});
 	return ok({
@@ -105,7 +119,7 @@ async function applyMigration(inputs) {
 * advances as the last step of each space's transaction) and `false`
 * for plan-mode (no marker has been written yet).
 *
-* Exported alongside {@link applyMigration} so plan-mode callers can
+* Exported alongside {@link runMigration} so plan-mode callers can
 * assemble the same per-space block without going through the runner.
 */
 function buildPerSpaceBreakdown(orderedResolutions, appSpaceId, options) {
@@ -146,8 +160,8 @@ function collectOrdered(applyOrder, perSpace) {
 	});
 }
 /**
-* Action-appropriate label for the `spanStart` event the apply
-* primitive emits. `applyMigration` is shared by `db init`, `db update`,
+* Action-appropriate label for the `spanStart` event the run
+* primitive emits. `runMigration` is shared by `db init`, `db update`,
 * and `migrate`; the span label tracks the user-visible action
 * so structured-progress output reads naturally for each surface.
 */
@@ -155,29 +169,16 @@ function progressLabelForAction(action) {
 	switch (action) {
 		case "dbInit": return "Initialising database across spaces";
 		case "dbUpdate": return "Updating database across spaces";
-		case "migrationApply": return "Applying migration plan across spaces";
+		case "migrate": return "Running migration plan across spaces";
 	}
 }
 //#endregion
-//#region src/control-api/operations/migration-helpers.ts
-/**
-* Strips operation objects to their public shape (id, label, operationClass).
-* Used at the API boundary to avoid leaking internal fields (precheck, execute, postcheck, etc.).
-*/
-function stripOperations(operations) {
-	return operations.map((op) => ({
-		id: op.id,
-		label: op.label,
-		operationClass: op.operationClass
-	}));
-}
-//#endregion
-//#region src/control-api/operations/db-apply.ts
+//#region src/control-api/operations/db-run.ts
 /**
-* Span IDs emitted via `onProgress` during the apply flow.
+* Span IDs emitted via `onProgress` during the run flow.
 * Stable identifiers consumed by the structured-output renderer and by
 * tests asserting on span ids. The `apply` span itself is owned by
-* the {@link applyMigration} primitive — only the introspect / plan
+* the {@link runMigration} primitive — only the introspect / plan
 * spans are emitted directly here.
 */
 const SPAN_IDS$1 = {
@@ -203,7 +204,7 @@ const SPAN_IDS$1 = {
 *    transaction across every space; failure on any space rolls back
 *    every space's writes.
 */
-async function executeApply(options) {
+async function executeRun(options) {
 	const { driver, familyInstance, contract, mode, migrations, frameworkComponents, migrationsDir, extensionPacks, targetId, policy, action, onProgress } = options;
 	const loaded = await buildContractSpaceAggregate({
 		targetId,
@@ -266,6 +267,7 @@ async function executeApply(options) {
 		outcome: "ok"
 	});
 	const orderedResolutions = collectOrdered(planResult.value.applyOrder, planResult.value.perSpace);
+	const plannerWarnings = aggregatePlannerWarnings(orderedResolutions);
 	const appResolution = orderedResolutions.find((r) => r.spaceId === aggregate.app.spaceId);
 	if (!appResolution) throw new Error("Aggregate planner returned no plan for the app member — the planner is supposed to always emit one.");
 	const appPlan = appResolution.entry.plan;
@@ -279,10 +281,11 @@ async function executeApply(options) {
 			destination: appPlan.destination,
 			preview,
 			perSpace,
-			summary
+			summary,
+			...ifDefined("warnings", plannerWarnings)
 		});
 	}
-	const applied = await applyMigration({
+	const applied = await runMigration({
 		aggregate,
 		perSpacePlans: planResult.value.perSpace,
 		applyOrder: planResult.value.applyOrder,
@@ -297,7 +300,8 @@ async function executeApply(options) {
 	if (!applied.ok) return buildRunnerFailure({
 		summary: applied.failure.summary,
 		...ifDefined("why", applied.failure.why),
-		meta: applied.failure.meta
+		meta: applied.failure.meta,
+		...ifDefined("warnings", plannerWarnings)
 	});
 	const aggregateOps = applied.value.orderedResolutions.flatMap((r) => r.entry.displayOps);
 	const summary = action === "dbInit" ? `Applied ${applied.value.totalOpsExecuted} operation(s) across ${applied.value.orderedResolutions.length} space(s), database signed` : applied.value.totalOpsExecuted === 0 ? `Database already matches contract across ${applied.value.orderedResolutions.length} space(s), signature updated` : `Applied ${applied.value.totalOpsExecuted} operation(s) across ${applied.value.orderedResolutions.length} space(s), signature updated`;
@@ -307,9 +311,14 @@ async function executeApply(options) {
 		operationsPlanned: applied.value.totalOpsPlanned,
 		operationsExecuted: applied.value.totalOpsExecuted,
 		perSpace: applied.value.perSpace,
-		summary
+		summary,
+		...ifDefined("warnings", plannerWarnings)
 	});
 }
+function aggregatePlannerWarnings(orderedResolutions) {
+	const warnings = orderedResolutions.flatMap((r) => r.entry.warnings ?? []);
+	return warnings.length > 0 ? warnings : void 0;
+}
 /**
 * Compare the live `_prisma_marker` rows against the aggregate's
 * declared members. Any marker row whose `space` is not a member of
@@ -383,7 +392,8 @@ function wrapPlanResult(args) {
 			...ifDefined("profileHash", args.destination.profileHash)
 		},
 		perSpace: args.perSpace,
-		summary: args.summary
+		summary: args.summary,
+		...ifDefined("warnings", args.warnings)
 	});
 }
 function wrapApplyResult(args) {
@@ -403,7 +413,8 @@ function wrapApplyResult(args) {
 			profileHash: args.destination.profileHash
 		} : { storageHash: args.destination.storageHash },
 		perSpace: args.perSpace,
-		summary: args.summary
+		summary: args.summary,
+		...ifDefined("warnings", args.warnings)
 	});
 }
 function buildRunnerFailure(args) {
@@ -412,7 +423,8 @@ function buildRunnerFailure(args) {
 		summary: args.summary,
 		why: args.why,
 		meta: args.meta,
-		conflicts: void 0
+		conflicts: void 0,
+		...ifDefined("warnings", args.warnings)
 	});
 }
 //#endregion
@@ -425,7 +437,7 @@ function buildRunnerFailure(args) {
 * changes belong to `db update`.
 */
 async function executeDbInit(options) {
-	return await executeApply({
+	return await executeRun({
 		driver: options.driver,
 		familyInstance: options.familyInstance,
 		contract: options.contract,
@@ -474,7 +486,7 @@ async function executeDbUpdate(options) {
 		const gate = await guardDestructiveChanges(sharedInputs);
 		if (gate !== null) return gate;
 	}
-	return await executeApply({
+	return await executeRun({
 		...sharedInputs,
 		mode: options.mode
 	});
@@ -487,7 +499,7 @@ async function executeDbUpdate(options) {
 * run.
 */
 async function guardDestructiveChanges(sharedInputs) {
-	const planResult = await executeApply({
+	const planResult = await executeRun({
 		...sharedInputs,
 		mode: "plan"
 	});
@@ -730,7 +742,7 @@ function mapMarkerCheckFailures(appSpaceId, section) {
 	});
 }
 //#endregion
-//#region src/control-api/operations/migration-apply.ts
+//#region src/control-api/operations/migrate.ts
 /**
 * Apply pending migrations across every contract space (app +
 * extensions). Replay-only: graph-walk against the on-disk graph for
@@ -745,14 +757,14 @@ function mapMarkerCheckFailures(appSpaceId, section) {
 *    marker to `member.headRef.hash` (or `refHash` for the app
 *    member when provided). Empty-graph members fail loudly — a
 *    "never planned" space is a user-error condition for replay.
-* 4. Hand off to {@link applyMigration} (the runner-driving tail
+* 4. Hand off to {@link runMigration} (the runner-driving tail
 *    shared with `db init` / `db update`). Marker advancement is
 *    inside the per-space transaction.
 *
 * Encodes the replay-only contract: every contract space must have an
 * authored migration graph on disk before this operation can advance it.
 */
-async function executeMigrationApply(options) {
+async function executeMigrate(options) {
 	const { driver, familyInstance, contract, migrations, frameworkComponents, migrationsDir, extensionPacks, targetId, refHash, refInvariants, refName, onProgress } = options;
 	const loaded = await buildContractSpaceAggregate({
 		targetId,
@@ -840,7 +852,7 @@ async function executeMigrationApply(options) {
 			summary: totalSpaces === 0 ? "Already up to date — no contract spaces are loaded" : totalSpaces === 1 ? "Already up to date" : `Already up to date across ${totalSpaces} space(s)`
 		}));
 	}
-	const applied = await applyMigration({
+	const applied = await runMigration({
 		aggregate,
 		perSpacePlans,
 		applyOrder,
@@ -854,7 +866,7 @@ async function executeMigrationApply(options) {
 			"destructive",
 			"data"
 		] },
-		action: "migrationApply",
+		action: "migrate",
 		...ifDefined("onProgress", onProgress)
 	});
 	if (!applied.ok) return notOk({
@@ -876,7 +888,7 @@ async function executeMigrationApply(options) {
 		};
 	});
 	const perSpaceAll = buildPerSpaceBreakdown(orderedAll, aggregate.app.spaceId, { includeMarkers: true });
-	const summary = `Applied ${applied.value.orderedResolutions.reduce((sum, r) => sum + (r.entry.migrationEdges?.length ?? 0), 0)} migration(s) (${applied.value.totalOpsExecuted} operation(s)) across ${orderedAll.length} contract space(s)`;
+	const summary = `Applied ${applied.value.orderedResolutions.reduce((sum, r) => sum + r.entry.migrationEdges.length, 0)} migration(s) (${applied.value.totalOpsExecuted} operation(s)) across ${orderedAll.length} contract space(s)`;
 	return ok(buildSuccess({
 		aggregate,
 		orderedResolutions: orderedAll,
@@ -906,7 +918,11 @@ function buildAtHeadResolution(args) {
 		displayOps: [],
 		destinationContract: member.contract(),
 		strategy: "graph-walk",
-		migrationEdges: []
+		migrationEdges: [buildSynthMigrationEdge({
+			currentMarkerStorageHash: liveMarker?.storageHash,
+			destinationStorageHash: targetHash,
+			operationCount: 0
+		})]
 	};
 }
 function sumPlannedOps(applyOrder, perSpacePlans) {
@@ -922,7 +938,7 @@ function buildSuccess(args) {
 	const appResolution = args.orderedResolutions.find((r) => r.spaceId === args.aggregate.app.spaceId);
 	const appMarkerHash = appResolution?.entry.plan.destination.storageHash ?? requireHeadRef(args.aggregate.app).hash;
 	const applied = args.orderedResolutions.flatMap((r) => {
-		return (r.entry.migrationEdges ?? []).map((edge) => ({
+		return r.entry.migrationEdges.map((edge) => ({
 			spaceId: r.spaceId,
 			dirName: edge.dirName,
 			migrationHash: edge.migrationHash,
@@ -1302,9 +1318,17 @@ var ControlClientImpl = class {
 		const { driver, familyInstance } = await this.ensureConnected();
 		return familyInstance.readAllMarkers({ driver });
 	}
-	async migrationApply(options) {
+	/** Reads the per-migration journal; omit `space` to return every space. */
+	async readLedger(space) {
+		const { driver, familyInstance } = await this.ensureConnected();
+		return familyInstance.readLedger({
+			driver,
+			...ifDefined("space", space)
+		});
+	}
+	async migrate(options) {
 		const { onProgress } = options;
-		await this.connectWithProgress(options.connection, "migrationApply", onProgress);
+		await this.connectWithProgress(options.connection, "migrate", onProgress);
 		const { driver, familyInstance, frameworkComponents } = await this.ensureConnected();
 		if (!hasMigrations(this.options.target)) throw new Error(`Target "${this.options.target.targetId}" does not support migrations`);
 		let contract;
@@ -1313,7 +1337,7 @@ var ControlClientImpl = class {
 		} catch (error) {
 			throw new ContractValidationError(error instanceof Error ? error.message : String(error), error);
 		}
-		return executeMigrationApply({
+		return executeMigrate({
 			driver,
 			familyInstance,
 			contract,
@@ -1444,8 +1468,9 @@ var ControlClientImpl = class {
 		});
 		try {
 			const enrichedIR = enrichContract(contractRaw, this.frameworkComponents ?? []);
+			let deserializedContract;
 			try {
-				this.familyInstance.deserializeContract(enrichedIR);
+				deserializedContract = this.familyInstance.deserializeContract(enrichedIR);
 			} catch (error) {
 				onProgress?.({
 					action: "emit",
@@ -1460,7 +1485,7 @@ var ControlClientImpl = class {
 					meta: void 0
 				});
 			}
-			const result = await emit(enrichedIR, this.stack, this.options.family.emission, { serializeContract: (contract) => this.options.target.contractSerializer.serializeContract(contract) });
+			const result = await emit(deserializedContract, this.stack, this.options.family.emission, { serializeContract: (contract) => this.options.target.contractSerializer.serializeContract(contract) });
 			onProgress?.({
 				action: "emit",
 				kind: "spanEnd",
@@ -1493,4 +1518,4 @@ var ControlClientImpl = class {
 //#endregion
 export { ContractValidationError as a, executeDbInit as i, executeDbVerify as n, executeDbUpdate as r, createControlClient as t };
 
-//# sourceMappingURL=client-KgJorIvG.mjs.map
+//# sourceMappingURL=client-DC-UlBLy.mjs.map