@prisma-next/migration-tools 0.3.0-dev.99 → 0.3.0

package/dist/exports/migration-ts.mjs

@@ -0,0 +1,125 @@
+import { stat, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "pathe";
+
+//#region src/migration-ts.ts
+/**
+* Utilities for scaffolding and evaluating migration.ts files.
+*
+* - scaffoldMigrationTs: writes a migration.ts file with boilerplate
+* - evaluateMigrationTs: loads migration.ts via native Node import, returns descriptors
+*
+* Shared by migration plan (scaffold), migration new (scaffold), and
+* migration verify (evaluate).
+*/
+const MIGRATION_TS_FILE = "migration.ts";
+function serializeQueryInput(input) {
+	if (typeof input === "boolean") return String(input);
+	if (typeof input === "symbol") return "TODO /* fill in using db.sql.from(...) */";
+	if (input === null || input === void 0) return "null";
+	if (Array.isArray(input)) {
+		if (input.length === 0) return "[]";
+		if (input.every((item) => typeof item === "symbol")) return "[TODO /* fill in using db.sql.from(...) */]";
+		return `[${input.map(serializeQueryInput).join(", ")}]`;
+	}
+	return JSON.stringify(input);
+}
+function descriptorToBuilderCall(desc) {
+	switch (desc.kind) {
+		case "createTable": return `createTable(${JSON.stringify(desc["table"])})`;
+		case "dropTable": return `dropTable(${JSON.stringify(desc["table"])})`;
+		case "addColumn": {
+			const args = [JSON.stringify(desc["table"]), JSON.stringify(desc["column"])];
+			if (desc["overrides"]) args.push(JSON.stringify(desc["overrides"]));
+			return `addColumn(${args.join(", ")})`;
+		}
+		case "dropColumn": return `dropColumn(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])})`;
+		case "alterColumnType": {
+			const opts = {};
+			if (desc["using"]) opts["using"] = desc["using"];
+			if (desc["toType"]) opts["toType"] = desc["toType"];
+			return Object.keys(opts).length > 0 ? `alterColumnType(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])}, ${JSON.stringify(opts)})` : `alterColumnType(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])})`;
+		}
+		case "setNotNull": return `setNotNull(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])})`;
+		case "dropNotNull": return `dropNotNull(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])})`;
+		case "setDefault": return `setDefault(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])})`;
+		case "dropDefault": return `dropDefault(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["column"])})`;
+		case "addPrimaryKey": return `addPrimaryKey(${JSON.stringify(desc["table"])})`;
+		case "addUnique": return `addUnique(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["columns"])})`;
+		case "addForeignKey": return `addForeignKey(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["columns"])})`;
+		case "dropConstraint": return `dropConstraint(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["constraintName"])})`;
+		case "createIndex": return `createIndex(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["columns"])})`;
+		case "dropIndex": return `dropIndex(${JSON.stringify(desc["table"])}, ${JSON.stringify(desc["indexName"])})`;
+		case "createEnumType": return desc["values"] ? `createEnumType(${JSON.stringify(desc["typeName"])}, ${JSON.stringify(desc["values"])})` : `createEnumType(${JSON.stringify(desc["typeName"])})`;
+		case "addEnumValues": return `addEnumValues(${JSON.stringify(desc["typeName"])}, ${JSON.stringify(desc["values"])})`;
+		case "dropEnumType": return `dropEnumType(${JSON.stringify(desc["typeName"])})`;
+		case "renameType": return `renameType(${JSON.stringify(desc["fromName"])}, ${JSON.stringify(desc["toName"])})`;
+		case "createDependency": return `createDependency(${JSON.stringify(desc["dependencyId"])})`;
+		case "dataTransform": return `dataTransform(${JSON.stringify(desc["name"])}, {\n    check: ${serializeQueryInput(desc["check"])},\n    run: ${serializeQueryInput(desc["run"])},\n  })`;
+		default: throw new Error(`Unknown descriptor kind: ${desc.kind}`);
+	}
+}
+/**
+* Scaffolds a migration.ts file in the given package directory.
+* Serializes operation descriptors as builder calls that the user can edit.
+* On verify, this file is re-evaluated to produce the final ops.
+*/
+async function scaffoldMigrationTs(packageDir, options = {}) {
+	const filePath = join(packageDir, MIGRATION_TS_FILE);
+	const descriptors = options.descriptors ?? [];
+	const hasDataTransform = descriptors.some((d) => d.kind === "dataTransform");
+	const lines = [];
+	if (hasDataTransform && options.contractJsonPath) {
+		const relativeContractDts = relative(packageDir, options.contractJsonPath).replace(/\.json$/, ".d");
+		lines.push(`import type { Contract } from "${relativeContractDts}"`);
+		lines.push(`import { createBuilders } from "@prisma-next/target-postgres/migration-builders"`);
+		lines.push("");
+		const importList = [...new Set(descriptors.map((d) => d.kind))];
+		importList.push("TODO");
+		lines.push(`const { ${importList.join(", ")} } = createBuilders<Contract>()`);
+	} else {
+		const importList = [...new Set(descriptors.map((d) => d.kind))];
+		if (importList.length === 0) importList.push("createTable");
+		if (hasDataTransform) importList.push("TODO");
+		lines.push(`import { ${importList.join(", ")} } from "@prisma-next/target-postgres/migration-builders"`);
+	}
+	const calls = descriptors.map((d) => `  ${descriptorToBuilderCall(d)},`).join("\n");
+	const body = calls.length > 0 ? `\n${calls}\n` : "";
+	lines.push("");
+	lines.push(`export default () => [${body}]`);
+	lines.push("");
+	await writeFile(filePath, lines.join("\n"));
+}
+/**
+* Checks whether a migration.ts file exists in the package directory.
+*/
+async function hasMigrationTs(packageDir) {
+	try {
+		return (await stat(join(packageDir, MIGRATION_TS_FILE))).isFile();
+	} catch {
+		return false;
+	}
+}
+/**
+* Evaluates a migration.ts file by loading it via native Node import.
+* Returns the result of calling the default export (expected to be a
+* function returning an array of operation descriptors).
+*
+* Requires Node ≥24 for native TypeScript support.
+*/
+async function evaluateMigrationTs(packageDir) {
+	const filePath = resolve(join(packageDir, MIGRATION_TS_FILE));
+	try {
+		await stat(filePath);
+	} catch {
+		throw new Error(`migration.ts not found at "${filePath}"`);
+	}
+	const mod = await import(filePath);
+	if (typeof mod.default !== "function") throw new Error(`migration.ts must export a default function returning an operation list. Got: ${typeof mod.default}`);
+	const result = mod.default();
+	if (!Array.isArray(result)) throw new Error(`migration.ts default export must return an array of operations. Got: ${typeof result}`);
+	return result;
+}
+
+//#endregion
+export { evaluateMigrationTs, hasMigrationTs, scaffoldMigrationTs };
+//# sourceMappingURL=migration-ts.mjs.map

package/dist/exports/migration-ts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-ts.mjs","names":["opts: Record<string, unknown>","lines: string[]","result: unknown"],"sources":["../../src/migration-ts.ts"],"sourcesContent":["/**\n * Utilities for scaffolding and evaluating migration.ts files.\n *\n * - scaffoldMigrationTs: writes a migration.ts file with boilerplate\n * - evaluateMigrationTs: loads migration.ts via native Node import, returns descriptors\n *\n * Shared by migration plan (scaffold), migration new (scaffold), and\n * migration verify (evaluate).\n */\n\nimport { stat, writeFile } from 'node:fs/promises';\nimport type { OperationDescriptor } from '@prisma-next/framework-components/control';\nimport { join, relative, resolve } from 'pathe';\n\nconst MIGRATION_TS_FILE = 'migration.ts';\n\n/**\n * Options for scaffolding a migration.ts file.\n */\nexport interface ScaffoldOptions {\n  /** Operation descriptors to serialize as builder calls. */\n  readonly descriptors?: readonly OperationDescriptor[];\n  /** Absolute path to contract.json — used to derive contract.d.ts import for typed builders. */\n  readonly contractJsonPath?: string;\n}\n\nfunction serializeQueryInput(input: unknown): string {\n  if (typeof input === 'boolean') return String(input);\n  if (typeof input === 'symbol') return 'TODO /* fill in using db.sql.from(...) */';\n  if (input === null || input === undefined) return 'null';\n  if (Array.isArray(input)) {\n    if (input.length === 0) return '[]';\n    if (input.every((item) => typeof item === 'symbol'))\n      return '[TODO /* fill in using db.sql.from(...) */]';\n    return `[${input.map(serializeQueryInput).join(', ')}]`;\n  }\n  return JSON.stringify(input);\n}\n\nfunction descriptorToBuilderCall(desc: OperationDescriptor): string {\n  switch (desc.kind) {\n    case 'createTable':\n      return `createTable(${JSON.stringify(desc['table'])})`;\n    case 'dropTable':\n      return `dropTable(${JSON.stringify(desc['table'])})`;\n    case 'addColumn': {\n      const args = [JSON.stringify(desc['table']), JSON.stringify(desc['column'])];\n      if (desc['overrides']) {\n        args.push(JSON.stringify(desc['overrides']));\n      }\n      return `addColumn(${args.join(', ')})`;\n    }\n    case 'dropColumn':\n      return `dropColumn(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])})`;\n    case 'alterColumnType': {\n      const opts: Record<string, unknown> = {};\n      if (desc['using']) opts['using'] = desc['using'];\n      if (desc['toType']) opts['toType'] = desc['toType'];\n      const hasOpts = Object.keys(opts).length > 0;\n      return hasOpts\n        ? `alterColumnType(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])}, ${JSON.stringify(opts)})`\n        : `alterColumnType(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])})`;\n    }\n    case 'setNotNull':\n      return `setNotNull(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])})`;\n    case 'dropNotNull':\n      return `dropNotNull(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])})`;\n    case 'setDefault':\n      return `setDefault(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])})`;\n    case 'dropDefault':\n      return `dropDefault(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['column'])})`;\n    case 'addPrimaryKey':\n      return `addPrimaryKey(${JSON.stringify(desc['table'])})`;\n    case 'addUnique':\n      return `addUnique(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['columns'])})`;\n    case 'addForeignKey':\n      return `addForeignKey(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['columns'])})`;\n    case 'dropConstraint':\n      return `dropConstraint(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['constraintName'])})`;\n    case 'createIndex':\n      return `createIndex(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['columns'])})`;\n    case 'dropIndex':\n      return `dropIndex(${JSON.stringify(desc['table'])}, ${JSON.stringify(desc['indexName'])})`;\n    case 'createEnumType':\n      return desc['values']\n        ? `createEnumType(${JSON.stringify(desc['typeName'])}, ${JSON.stringify(desc['values'])})`\n        : `createEnumType(${JSON.stringify(desc['typeName'])})`;\n    case 'addEnumValues':\n      return `addEnumValues(${JSON.stringify(desc['typeName'])}, ${JSON.stringify(desc['values'])})`;\n    case 'dropEnumType':\n      return `dropEnumType(${JSON.stringify(desc['typeName'])})`;\n    case 'renameType':\n      return `renameType(${JSON.stringify(desc['fromName'])}, ${JSON.stringify(desc['toName'])})`;\n    case 'createDependency':\n      return `createDependency(${JSON.stringify(desc['dependencyId'])})`;\n    case 'dataTransform':\n      return `dataTransform(${JSON.stringify(desc['name'])}, {\\n    check: ${serializeQueryInput(desc['check'])},\\n    run: ${serializeQueryInput(desc['run'])},\\n  })`;\n    default:\n      throw new Error(`Unknown descriptor kind: ${desc.kind}`);\n  }\n}\n\n/**\n * Scaffolds a migration.ts file in the given package directory.\n * Serializes operation descriptors as builder calls that the user can edit.\n * On verify, this file is re-evaluated to produce the final ops.\n */\nexport async function scaffoldMigrationTs(\n  packageDir: string,\n  options: ScaffoldOptions = {},\n): Promise<void> {\n  const filePath = join(packageDir, MIGRATION_TS_FILE);\n\n  const descriptors = options.descriptors ?? [];\n  const hasDataTransform = descriptors.some((d) => d.kind === 'dataTransform');\n\n  const lines: string[] = [];\n\n  if (hasDataTransform && options.contractJsonPath) {\n    const relativeContractDts = relative(packageDir, options.contractJsonPath).replace(\n      /\\.json$/,\n      '.d',\n    );\n    lines.push(`import type { Contract } from \"${relativeContractDts}\"`);\n    lines.push(`import { createBuilders } from \"@prisma-next/target-postgres/migration-builders\"`);\n    lines.push('');\n    const importList = [...new Set(descriptors.map((d) => d.kind))];\n    importList.push('TODO');\n    lines.push(`const { ${importList.join(', ')} } = createBuilders<Contract>()`);\n  } else {\n    const importList = [...new Set(descriptors.map((d) => d.kind))];\n    if (importList.length === 0) {\n      importList.push('createTable');\n    }\n    if (hasDataTransform) {\n      importList.push('TODO');\n    }\n    lines.push(\n      `import { ${importList.join(', ')} } from \"@prisma-next/target-postgres/migration-builders\"`,\n    );\n  }\n\n  const calls = descriptors.map((d) => `  ${descriptorToBuilderCall(d)},`).join('\\n');\n  const body = calls.length > 0 ? `\\n${calls}\\n` : '';\n\n  lines.push('');\n  lines.push(`export default () => [${body}]`);\n  lines.push('');\n\n  await writeFile(filePath, lines.join('\\n'));\n}\n\n/**\n * Checks whether a migration.ts file exists in the package directory.\n */\nexport async function hasMigrationTs(packageDir: string): Promise<boolean> {\n  try {\n    const s = await stat(join(packageDir, MIGRATION_TS_FILE));\n    return s.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Evaluates a migration.ts file by loading it via native Node import.\n * Returns the result of calling the default export (expected to be a\n * function returning an array of operation descriptors).\n *\n * Requires Node ≥24 for native TypeScript support.\n */\nexport async function evaluateMigrationTs(packageDir: string): Promise<readonly unknown[]> {\n  const filePath = resolve(join(packageDir, MIGRATION_TS_FILE));\n\n  try {\n    await stat(filePath);\n  } catch {\n    throw new Error(`migration.ts not found at \"${filePath}\"`);\n  }\n\n  // Use native Node TS import (Node ≥24, stable type stripping)\n  const mod = (await import(filePath)) as { default?: unknown };\n\n  if (typeof mod.default !== 'function') {\n    throw new Error(\n      `migration.ts must export a default function returning an operation list. Got: ${typeof mod.default}`,\n    );\n  }\n\n  const result: unknown = mod.default();\n\n  if (!Array.isArray(result)) {\n    throw new Error(\n      `migration.ts default export must return an array of operations. Got: ${typeof result}`,\n    );\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAM,oBAAoB;AAY1B,SAAS,oBAAoB,OAAwB;AACnD,KAAI,OAAO,UAAU,UAAW,QAAO,OAAO,MAAM;AACpD,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,MAAI,MAAM,OAAO,SAAS,OAAO,SAAS,SAAS,CACjD,QAAO;AACT,SAAO,IAAI,MAAM,IAAI,oBAAoB,CAAC,KAAK,KAAK,CAAC;;AAEvD,QAAO,KAAK,UAAU,MAAM;;AAG9B,SAAS,wBAAwB,MAAmC;AAClE,SAAQ,KAAK,MAAb;EACE,KAAK,cACH,QAAO,eAAe,KAAK,UAAU,KAAK,SAAS,CAAC;EACtD,KAAK,YACH,QAAO,aAAa,KAAK,UAAU,KAAK,SAAS,CAAC;EACpD,KAAK,aAAa;GAChB,MAAM,OAAO,CAAC,KAAK,UAAU,KAAK,SAAS,EAAE,KAAK,UAAU,KAAK,UAAU,CAAC;AAC5E,OAAI,KAAK,aACP,MAAK,KAAK,KAAK,UAAU,KAAK,aAAa,CAAC;AAE9C,UAAO,aAAa,KAAK,KAAK,KAAK,CAAC;;EAEtC,KAAK,aACH,QAAO,cAAc,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EACxF,KAAK,mBAAmB;GACtB,MAAMA,OAAgC,EAAE;AACxC,OAAI,KAAK,SAAU,MAAK,WAAW,KAAK;AACxC,OAAI,KAAK,UAAW,MAAK,YAAY,KAAK;AAE1C,UADgB,OAAO,KAAK,KAAK,CAAC,SAAS,IAEvC,mBAAmB,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC,IAAI,KAAK,UAAU,KAAK,CAAC,KAC7G,mBAAmB,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;;EAE1F,KAAK,aACH,QAAO,cAAc,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EACxF,KAAK,cACH,QAAO,eAAe,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EACzF,KAAK,aACH,QAAO,cAAc,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EACxF,KAAK,cACH,QAAO,eAAe,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EACzF,KAAK,gBACH,QAAO,iBAAiB,KAAK,UAAU,KAAK,SAAS,CAAC;EACxD,KAAK,YACH,QAAO,aAAa,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,WAAW,CAAC;EACxF,KAAK,gBACH,QAAO,iBAAiB,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,WAAW,CAAC;EAC5F,KAAK,iBACH,QAAO,kBAAkB,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,kBAAkB,CAAC;EACpG,KAAK,cACH,QAAO,eAAe,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,WAAW,CAAC;EAC1F,KAAK,YACH,QAAO,aAAa,KAAK,UAAU,KAAK,SAAS,CAAC,IAAI,KAAK,UAAU,KAAK,aAAa,CAAC;EAC1F,KAAK,iBACH,QAAO,KAAK,YACR,kBAAkB,KAAK,UAAU,KAAK,YAAY,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC,KACtF,kBAAkB,KAAK,UAAU,KAAK,YAAY,CAAC;EACzD,KAAK,gBACH,QAAO,iBAAiB,KAAK,UAAU,KAAK,YAAY,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EAC9F,KAAK,eACH,QAAO,gBAAgB,KAAK,UAAU,KAAK,YAAY,CAAC;EAC1D,KAAK,aACH,QAAO,cAAc,KAAK,UAAU,KAAK,YAAY,CAAC,IAAI,KAAK,UAAU,KAAK,UAAU,CAAC;EAC3F,KAAK,mBACH,QAAO,oBAAoB,KAAK,UAAU,KAAK,gBAAgB,CAAC;EAClE,KAAK,gBACH,QAAO,iBAAiB,KAAK,UAAU,KAAK,QAAQ,CAAC,kBAAkB,oBAAoB,KAAK,SAAS,CAAC,cAAc,oBAAoB,KAAK,OAAO,CAAC;EAC3J,QACE,OAAM,IAAI,MAAM,4BAA4B,KAAK,OAAO;;;;;;;;AAS9D,eAAsB,oBACpB,YACA,UAA2B,EAAE,EACd;CACf,MAAM,WAAW,KAAK,YAAY,kBAAkB;CAEpD,MAAM,cAAc,QAAQ,eAAe,EAAE;CAC7C,MAAM,mBAAmB,YAAY,MAAM,MAAM,EAAE,SAAS,gBAAgB;CAE5E,MAAMC,QAAkB,EAAE;AAE1B,KAAI,oBAAoB,QAAQ,kBAAkB;EAChD,MAAM,sBAAsB,SAAS,YAAY,QAAQ,iBAAiB,CAAC,QACzE,WACA,KACD;AACD,QAAM,KAAK,kCAAkC,oBAAoB,GAAG;AACpE,QAAM,KAAK,mFAAmF;AAC9F,QAAM,KAAK,GAAG;EACd,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC;AAC/D,aAAW,KAAK,OAAO;AACvB,QAAM,KAAK,WAAW,WAAW,KAAK,KAAK,CAAC,iCAAiC;QACxE;EACL,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC;AAC/D,MAAI,WAAW,WAAW,EACxB,YAAW,KAAK,cAAc;AAEhC,MAAI,iBACF,YAAW,KAAK,OAAO;AAEzB,QAAM,KACJ,YAAY,WAAW,KAAK,KAAK,CAAC,2DACnC;;CAGH,MAAM,QAAQ,YAAY,KAAK,MAAM,KAAK,wBAAwB,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK;CACnF,MAAM,OAAO,MAAM,SAAS,IAAI,KAAK,MAAM,MAAM;AAEjD,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,yBAAyB,KAAK,GAAG;AAC5C,OAAM,KAAK,GAAG;AAEd,OAAM,UAAU,UAAU,MAAM,KAAK,KAAK,CAAC;;;;;AAM7C,eAAsB,eAAe,YAAsC;AACzE,KAAI;AAEF,UADU,MAAM,KAAK,KAAK,YAAY,kBAAkB,CAAC,EAChD,QAAQ;SACX;AACN,SAAO;;;;;;;;;;AAWX,eAAsB,oBAAoB,YAAiD;CACzF,MAAM,WAAW,QAAQ,KAAK,YAAY,kBAAkB,CAAC;AAE7D,KAAI;AACF,QAAM,KAAK,SAAS;SACd;AACN,QAAM,IAAI,MAAM,8BAA8B,SAAS,GAAG;;CAI5D,MAAM,MAAO,MAAM,OAAO;AAE1B,KAAI,OAAO,IAAI,YAAY,WACzB,OAAM,IAAI,MACR,iFAAiF,OAAO,IAAI,UAC7F;CAGH,MAAMC,SAAkB,IAAI,SAAS;AAErC,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MACR,wEAAwE,OAAO,SAChF;AAGH,QAAO"}

package/dist/exports/refs.mjs

@@ -1,4 +1,4 @@
-import { c as errorInvalidRefValue, l as errorInvalidRefs, s as errorInvalidRefName, t as MigrationToolsError } from "../errors-CqLiJwqA.mjs";
+import { c as errorInvalidRefValue, l as errorInvalidRefs, s as errorInvalidRefName, t as MigrationToolsError } from "../errors-CSAAto11.mjs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { type } from "arktype";
 import { dirname, join } from "pathe";

package/dist/exports/types.d.mts

@@ -1,4 +1,4 @@
-import { a as MigrationChainEntry, c as MigrationManifest, i as MigrationBundle, l as MigrationOps, n as AttestedMigrationManifest, o as MigrationGraph, r as DraftMigrationManifest, s as MigrationHints, t as AttestedMigrationBundle, u as isAttested } from "../types-9YQfIg6N.mjs";
+import { a as DraftMigrationManifest, c as MigrationHints, d as isAttested, f as isDraft, i as DraftMigrationBundle, l as MigrationManifest, n as AttestedMigrationManifest, o as MigrationChainEntry, r as BaseMigrationBundle, s as MigrationGraph, t as AttestedMigrationBundle, u as MigrationOps } from "../types-BW_pJEe8.mjs";
 
 //#region src/errors.d.ts
 
@@ -7,7 +7,7 @@ import { a as MigrationChainEntry, c as MigrationManifest, i as MigrationBundle,
  *
  * Follows the NAMESPACE.SUBCODE convention from ADR 027. All codes live under
  * the MIGRATION namespace. These are tooling-time errors (file I/O, attestation,
- * migration-chain reconstruction), distinct from the runtime MIGRATION.* codes for apply-time
+ * migration history reconstruction), distinct from the runtime MIGRATION.* codes for apply-time
  * failures (PRECHECK_FAILED, POSTCHECK_FAILED, etc.).
  *
  * Fields:
@@ -31,5 +31,5 @@ declare class MigrationToolsError extends Error {
   static is(error: unknown): error is MigrationToolsError;
 }
 //#endregion
-export { type AttestedMigrationBundle, type AttestedMigrationManifest, type DraftMigrationManifest, type MigrationBundle, type MigrationBundle as MigrationPackage, type MigrationChainEntry, type MigrationGraph, type MigrationHints, type MigrationManifest, type MigrationOps, MigrationToolsError, isAttested };
+export { type AttestedMigrationBundle, type AttestedMigrationManifest, type BaseMigrationBundle, type BaseMigrationBundle as MigrationBundle, type BaseMigrationBundle as MigrationPackage, type DraftMigrationBundle, type DraftMigrationManifest, type MigrationChainEntry, type MigrationGraph, type MigrationHints, type MigrationManifest, type MigrationOps, MigrationToolsError, isAttested, isDraft };
 //# sourceMappingURL=types.d.mts.map

package/dist/exports/types.mjs

@@ -1,4 +1,4 @@
-import { t as MigrationToolsError } from "../errors-CqLiJwqA.mjs";
+import { t as MigrationToolsError } from "../errors-CSAAto11.mjs";
 
 //#region src/types.ts
 /**
@@ -8,7 +8,10 @@ import { t as MigrationToolsError } from "../errors-CqLiJwqA.mjs";
 function isAttested(bundle) {
 	return typeof bundle.manifest.migrationId === "string";
 }
+function isDraft(bundle) {
+	return bundle.manifest.migrationId === null;
+}
 
 //#endregion
-export { MigrationToolsError, isAttested };
+export { MigrationToolsError, isAttested, isDraft };
 //# sourceMappingURL=types.mjs.map

package/dist/exports/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../src/types.ts"],"sourcesContent":["import type { ContractIR } from '@prisma-next/contract/ir';\nimport type { MigrationPlanOperation } from '@prisma-next/core-control-plane/types';\n\nexport interface MigrationHints {\n  readonly used: readonly string[];\n  readonly applied: readonly string[];\n  readonly plannerVersion: string;\n  readonly planningStrategy: string;\n}\n\n/**\n * Shared fields for all migration manifests (draft and attested).\n */\ninterface MigrationManifestBase {\n  readonly from: string;\n  readonly to: string;\n  readonly kind: 'regular' | 'baseline';\n  readonly fromContract: ContractIR | null;\n  readonly toContract: ContractIR;\n  readonly hints: MigrationHints;\n  readonly labels: readonly string[];\n  readonly authorship?: { readonly author?: string; readonly email?: string };\n  readonly signature?: { readonly keyId: string; readonly value: string } | null;\n  readonly createdAt: string;\n}\n\n/**\n * A draft migration that has been planned but not yet attested.\n * Draft migrations have `migrationId: null` and are excluded from\n * graph reconstruction and apply.\n */\nexport interface DraftMigrationManifest extends MigrationManifestBase {\n  readonly migrationId: null;\n}\n\n/**\n * An attested migration with a content-addressed migrationId.\n * Only attested migrations participate in the migration graph.\n */\nexport interface AttestedMigrationManifest extends MigrationManifestBase {\n  readonly migrationId: string;\n}\n\n/**\n * Union of draft and attested manifests. This is what the on-disk\n * format represents — `migrationId` is `null` for drafts, a string\n * for attested migrations.\n */\nexport type MigrationManifest = DraftMigrationManifest | AttestedMigrationManifest;\n\nexport type MigrationOps = readonly MigrationPlanOperation[];\n\n/**\n * An on-disk migration directory containing a manifest and operations.\n * The manifest may be draft or attested.\n */\nexport interface MigrationBundle {\n  readonly dirName: string;\n  readonly dirPath: string;\n  readonly manifest: MigrationManifest;\n  readonly ops: MigrationOps;\n}\n\n/**\n * A bundle known to be attested (migrationId is a string).\n * Use this after filtering bundles to attested-only.\n */\nexport interface AttestedMigrationBundle extends MigrationBundle {\n  readonly manifest: AttestedMigrationManifest;\n}\n\n/**\n * An entry in the migration graph. Only attested migrations appear in the\n * graph, so `migrationId` is always a string.\n */\nexport interface MigrationChainEntry {\n  readonly from: string;\n  readonly to: string;\n  readonly migrationId: string;\n  readonly dirName: string;\n  readonly createdAt: string;\n  readonly labels: readonly string[];\n}\n\nexport interface MigrationGraph {\n  readonly nodes: ReadonlySet<string>;\n  readonly forwardChain: ReadonlyMap<string, readonly MigrationChainEntry[]>;\n  readonly reverseChain: ReadonlyMap<string, readonly MigrationChainEntry[]>;\n  readonly migrationById: ReadonlyMap<string, MigrationChainEntry>;\n}\n\n/**\n * Type guard that narrows a MigrationBundle to an AttestedMigrationBundle.\n * Use with `.filter(isAttested)` to get a typed array of attested bundles.\n */\nexport function isAttested(bundle: MigrationBundle): bundle is AttestedMigrationBundle {\n  return typeof bundle.manifest.migrationId === 'string';\n}\n"],"mappings":";;;;;;;AA+FA,SAAgB,WAAW,QAA4D;AACrF,QAAO,OAAO,OAAO,SAAS,gBAAgB"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/types.ts"],"sourcesContent":["import type { Contract } from '@prisma-next/contract/types';\nimport type { MigrationPlanOperation } from '@prisma-next/framework-components/control';\n\nexport interface MigrationHints {\n  readonly used: readonly string[];\n  readonly applied: readonly string[];\n  readonly plannerVersion: string;\n  readonly planningStrategy: string;\n}\n\n/**\n * Shared fields for all migration manifests (draft and attested).\n */\ninterface MigrationManifestBase {\n  readonly from: string;\n  readonly to: string;\n  readonly kind: 'regular' | 'baseline';\n  readonly fromContract: Contract | null;\n  readonly toContract: Contract;\n  readonly hints: MigrationHints;\n  readonly labels: readonly string[];\n  readonly authorship?: { readonly author?: string; readonly email?: string };\n  readonly signature?: { readonly keyId: string; readonly value: string } | null;\n  readonly createdAt: string;\n}\n\n/**\n * A draft migration that has been planned but not yet attested.\n * Draft migrations have `migrationId: null` and are excluded from\n * graph reconstruction and apply.\n */\nexport interface DraftMigrationManifest extends MigrationManifestBase {\n  readonly migrationId: null;\n}\n\n/**\n * An attested migration with a content-addressed migrationId.\n * Only attested migrations participate in the migration graph.\n */\nexport interface AttestedMigrationManifest extends MigrationManifestBase {\n  readonly migrationId: string;\n}\n\n/**\n * Union of draft and attested manifests. This is what the on-disk\n * format represents — `migrationId` is `null` for drafts, a string\n * for attested migrations.\n */\nexport type MigrationManifest = DraftMigrationManifest | AttestedMigrationManifest;\n\nexport type MigrationOps = readonly MigrationPlanOperation[];\n\n/**\n * An on-disk migration directory containing a manifest and operations.\n * The manifest may be draft or attested.\n */\nexport interface BaseMigrationBundle {\n  readonly dirName: string;\n  readonly dirPath: string;\n  readonly manifest: MigrationManifest;\n  readonly ops: MigrationOps;\n}\n\n/**\n * A bundle known to be attested (migrationId is a string).\n * Use this after filtering bundles to attested-only.\n */\nexport interface AttestedMigrationBundle extends BaseMigrationBundle {\n  readonly manifest: AttestedMigrationManifest;\n}\n\nexport interface DraftMigrationBundle extends BaseMigrationBundle {\n  readonly manifest: DraftMigrationManifest;\n}\n\n/**\n * An entry in the migration graph. Only attested migrations appear in the\n * graph, so `migrationId` is always a string.\n */\nexport interface MigrationChainEntry {\n  readonly from: string;\n  readonly to: string;\n  readonly migrationId: string;\n  readonly dirName: string;\n  readonly createdAt: string;\n  readonly labels: readonly string[];\n}\n\nexport interface MigrationGraph {\n  readonly nodes: ReadonlySet<string>;\n  readonly forwardChain: ReadonlyMap<string, readonly MigrationChainEntry[]>;\n  readonly reverseChain: ReadonlyMap<string, readonly MigrationChainEntry[]>;\n  readonly migrationById: ReadonlyMap<string, MigrationChainEntry>;\n}\n\n/**\n * Type guard that narrows a MigrationBundle to an AttestedMigrationBundle.\n * Use with `.filter(isAttested)` to get a typed array of attested bundles.\n */\nexport function isAttested(bundle: BaseMigrationBundle): bundle is AttestedMigrationBundle {\n  return typeof bundle.manifest.migrationId === 'string';\n}\n\nexport function isDraft(bundle: BaseMigrationBundle): bundle is DraftMigrationBundle {\n  return bundle.manifest.migrationId === null;\n}\n"],"mappings":";;;;;;;AAmGA,SAAgB,WAAW,QAAgE;AACzF,QAAO,OAAO,OAAO,SAAS,gBAAgB;;AAGhD,SAAgB,QAAQ,QAA6D;AACnF,QAAO,OAAO,SAAS,gBAAgB"}

package/dist/{io-afog-e8J.mjs → io-LsuurzNb.mjs}

@@ -1,4 +1,4 @@
-import { a as errorInvalidJson, d as errorMissingFile, o as errorInvalidManifest, r as errorDirectoryExists, u as errorInvalidSlug } from "./errors-CqLiJwqA.mjs";
+import { a as errorInvalidJson, d as errorMissingFile, o as errorInvalidManifest, r as errorDirectoryExists, u as errorInvalidSlug } from "./errors-CSAAto11.mjs";
 import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { type } from "arktype";
 import { basename, dirname, join } from "pathe";
@@ -37,7 +37,7 @@ const MigrationManifestSchema = type({
 const MigrationOpsSchema = type({
 	id: "string",
 	label: "string",
-	operationClass: "'additive' | 'widening' | 'destructive'"
+	operationClass: "'additive' | 'widening' | 'destructive' | 'data'"
 }).array();
 async function writeMigrationPackage(dir, manifest, ops) {
 	await mkdir(dirname(dir), { recursive: true });
@@ -50,6 +50,12 @@ async function writeMigrationPackage(dir, manifest, ops) {
 	await writeFile(join(dir, MANIFEST_FILE), JSON.stringify(manifest, null, 2), { flag: "wx" });
 	await writeFile(join(dir, OPS_FILE), JSON.stringify(ops, null, 2), { flag: "wx" });
 }
+async function writeMigrationManifest(dir, manifest) {
+	await writeFile(join(dir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\n`);
+}
+async function writeMigrationOps(dir, ops) {
+	await writeFile(join(dir, OPS_FILE), `${JSON.stringify(ops, null, 2)}\n`);
+}
 async function readMigrationPackage(dir) {
 	const manifestPath = join(dir, MANIFEST_FILE);
 	const opsPath = join(dir, OPS_FILE);
@@ -126,5 +132,5 @@ function formatMigrationDirName(timestamp, slug) {
 }
 
 //#endregion
-export { writeMigrationPackage as i, readMigrationPackage as n, readMigrationsDir as r, formatMigrationDirName as t };
-//# sourceMappingURL=io-afog-e8J.mjs.map
+export { writeMigrationOps as a, writeMigrationManifest as i, readMigrationPackage as n, writeMigrationPackage as o, readMigrationsDir as r, formatMigrationDirName as t };
+//# sourceMappingURL=io-LsuurzNb.mjs.map

package/dist/io-LsuurzNb.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-LsuurzNb.mjs","names":["manifestRaw: string","opsRaw: string","manifest: MigrationManifest","ops: MigrationOps","entries: string[]","packages: BaseMigrationBundle[]"],"sources":["../src/io.ts"],"sourcesContent":["import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';\nimport { type } from 'arktype';\nimport { basename, dirname, join } from 'pathe';\nimport {\n  errorDirectoryExists,\n  errorInvalidJson,\n  errorInvalidManifest,\n  errorInvalidSlug,\n  errorMissingFile,\n} from './errors';\nimport type { BaseMigrationBundle, MigrationManifest, MigrationOps } from './types';\n\nconst MANIFEST_FILE = 'migration.json';\nconst OPS_FILE = 'ops.json';\nconst MAX_SLUG_LENGTH = 64;\n\nfunction hasErrnoCode(error: unknown, code: string): boolean {\n  return error instanceof Error && (error as { code?: string }).code === code;\n}\n\nconst MigrationHintsSchema = type({\n  used: 'string[]',\n  applied: 'string[]',\n  plannerVersion: 'string',\n  planningStrategy: 'string',\n});\n\nconst MigrationManifestSchema = type({\n  from: 'string',\n  to: 'string',\n  migrationId: 'string | null',\n  kind: \"'regular' | 'baseline'\",\n  fromContract: 'object | null',\n  toContract: 'object',\n  hints: MigrationHintsSchema,\n  labels: 'string[]',\n  'authorship?': type({\n    'author?': 'string',\n    'email?': 'string',\n  }),\n  'signature?': type({\n    keyId: 'string',\n    value: 'string',\n  }).or('null'),\n  createdAt: 'string',\n});\n\nconst MigrationOpSchema = type({\n  id: 'string',\n  label: 'string',\n  operationClass: \"'additive' | 'widening' | 'destructive' | 'data'\",\n});\n\n// Intentionally shallow: operation-specific payload validation is owned by planner/runner layers.\nconst MigrationOpsSchema = MigrationOpSchema.array();\n\nexport async function writeMigrationPackage(\n  dir: string,\n  manifest: MigrationManifest,\n  ops: MigrationOps,\n): Promise<void> {\n  await mkdir(dirname(dir), { recursive: true });\n\n  try {\n    await mkdir(dir);\n  } catch (error) {\n    if (hasErrnoCode(error, 'EEXIST')) {\n      throw errorDirectoryExists(dir);\n    }\n    throw error;\n  }\n\n  await writeFile(join(dir, MANIFEST_FILE), JSON.stringify(manifest, null, 2), { flag: 'wx' });\n  await writeFile(join(dir, OPS_FILE), JSON.stringify(ops, null, 2), { flag: 'wx' });\n}\n\nexport async function writeMigrationManifest(\n  dir: string,\n  manifest: MigrationManifest,\n): Promise<void> {\n  await writeFile(join(dir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\\n`);\n}\n\nexport async function writeMigrationOps(dir: string, ops: MigrationOps): Promise<void> {\n  await writeFile(join(dir, OPS_FILE), `${JSON.stringify(ops, null, 2)}\\n`);\n}\n\nexport async function readMigrationPackage(dir: string): Promise<BaseMigrationBundle> {\n  const manifestPath = join(dir, MANIFEST_FILE);\n  const opsPath = join(dir, OPS_FILE);\n\n  let manifestRaw: string;\n  try {\n    manifestRaw = await readFile(manifestPath, 'utf-8');\n  } catch (error) {\n    if (hasErrnoCode(error, 'ENOENT')) {\n      throw errorMissingFile(MANIFEST_FILE, dir);\n    }\n    throw error;\n  }\n\n  let opsRaw: string;\n  try {\n    opsRaw = await readFile(opsPath, 'utf-8');\n  } catch (error) {\n    if (hasErrnoCode(error, 'ENOENT')) {\n      throw errorMissingFile(OPS_FILE, dir);\n    }\n    throw error;\n  }\n\n  let manifest: MigrationManifest;\n  try {\n    manifest = JSON.parse(manifestRaw);\n  } catch (e) {\n    throw errorInvalidJson(manifestPath, e instanceof Error ? e.message : String(e));\n  }\n\n  let ops: MigrationOps;\n  try {\n    ops = JSON.parse(opsRaw);\n  } catch (e) {\n    throw errorInvalidJson(opsPath, e instanceof Error ? e.message : String(e));\n  }\n\n  validateManifest(manifest, manifestPath);\n  validateOps(ops, opsPath);\n\n  return {\n    dirName: basename(dir),\n    dirPath: dir,\n    manifest,\n    ops,\n  };\n}\n\nfunction validateManifest(\n  manifest: unknown,\n  filePath: string,\n): asserts manifest is MigrationManifest {\n  const result = MigrationManifestSchema(manifest);\n  if (result instanceof type.errors) {\n    throw errorInvalidManifest(filePath, result.summary);\n  }\n}\n\nfunction validateOps(ops: unknown, filePath: string): asserts ops is MigrationOps {\n  const result = MigrationOpsSchema(ops);\n  if (result instanceof type.errors) {\n    throw errorInvalidManifest(filePath, result.summary);\n  }\n}\n\nexport async function readMigrationsDir(\n  migrationsRoot: string,\n): Promise<readonly BaseMigrationBundle[]> {\n  let entries: string[];\n  try {\n    entries = await readdir(migrationsRoot);\n  } catch (error) {\n    if (hasErrnoCode(error, 'ENOENT')) {\n      return [];\n    }\n    throw error;\n  }\n\n  const packages: BaseMigrationBundle[] = [];\n\n  for (const entry of entries.sort()) {\n    const entryPath = join(migrationsRoot, entry);\n    const entryStat = await stat(entryPath);\n    if (!entryStat.isDirectory()) continue;\n\n    const manifestPath = join(entryPath, MANIFEST_FILE);\n    try {\n      await stat(manifestPath);\n    } catch {\n      continue; // skip non-migration directories\n    }\n\n    packages.push(await readMigrationPackage(entryPath));\n  }\n\n  return packages;\n}\n\nexport function formatMigrationDirName(timestamp: Date, slug: string): string {\n  const sanitized = slug\n    .toLowerCase()\n    .replace(/[^a-z0-9]/g, '_')\n    .replace(/_+/g, '_')\n    .replace(/^_|_$/g, '');\n\n  if (sanitized.length === 0) {\n    throw errorInvalidSlug(slug);\n  }\n\n  const truncated = sanitized.slice(0, MAX_SLUG_LENGTH);\n\n  const y = timestamp.getUTCFullYear();\n  const mo = String(timestamp.getUTCMonth() + 1).padStart(2, '0');\n  const d = String(timestamp.getUTCDate()).padStart(2, '0');\n  const h = String(timestamp.getUTCHours()).padStart(2, '0');\n  const mi = String(timestamp.getUTCMinutes()).padStart(2, '0');\n\n  return `${y}${mo}${d}T${h}${mi}_${truncated}`;\n}\n"],"mappings":"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"}

package/dist/{types-9YQfIg6N.d.mts → types-BW_pJEe8.d.mts}

@@ -1,5 +1,5 @@
-import { ContractIR } from "@prisma-next/contract/ir";
-import { MigrationPlanOperation } from "@prisma-next/core-control-plane/types";
+import { Contract } from "@prisma-next/contract/types";
+import { MigrationPlanOperation } from "@prisma-next/framework-components/control";
 
 //#region src/types.d.ts
 interface MigrationHints {
@@ -15,8 +15,8 @@ interface MigrationManifestBase {
   readonly from: string;
   readonly to: string;
   readonly kind: 'regular' | 'baseline';
-  readonly fromContract: ContractIR | null;
-  readonly toContract: ContractIR;
+  readonly fromContract: Contract | null;
+  readonly toContract: Contract;
   readonly hints: MigrationHints;
   readonly labels: readonly string[];
   readonly authorship?: {
@@ -55,7 +55,7 @@ type MigrationOps = readonly MigrationPlanOperation[];
  * An on-disk migration directory containing a manifest and operations.
  * The manifest may be draft or attested.
  */
-interface MigrationBundle {
+interface BaseMigrationBundle {
   readonly dirName: string;
   readonly dirPath: string;
   readonly manifest: MigrationManifest;
@@ -65,9 +65,12 @@ interface MigrationBundle {
  * A bundle known to be attested (migrationId is a string).
  * Use this after filtering bundles to attested-only.
  */
-interface AttestedMigrationBundle extends MigrationBundle {
+interface AttestedMigrationBundle extends BaseMigrationBundle {
   readonly manifest: AttestedMigrationManifest;
 }
+interface DraftMigrationBundle extends BaseMigrationBundle {
+  readonly manifest: DraftMigrationManifest;
+}
 /**
  * An entry in the migration graph. Only attested migrations appear in the
  * graph, so `migrationId` is always a string.
@@ -90,7 +93,8 @@ interface MigrationGraph {
  * Type guard that narrows a MigrationBundle to an AttestedMigrationBundle.
  * Use with `.filter(isAttested)` to get a typed array of attested bundles.
  */
-declare function isAttested(bundle: MigrationBundle): bundle is AttestedMigrationBundle;
+declare function isAttested(bundle: BaseMigrationBundle): bundle is AttestedMigrationBundle;
+declare function isDraft(bundle: BaseMigrationBundle): bundle is DraftMigrationBundle;
 //#endregion
-export { MigrationChainEntry as a, MigrationManifest as c, MigrationBundle as i, MigrationOps as l, AttestedMigrationManifest as n, MigrationGraph as o, DraftMigrationManifest as r, MigrationHints as s, AttestedMigrationBundle as t, isAttested as u };
-//# sourceMappingURL=types-9YQfIg6N.d.mts.map
+export { DraftMigrationManifest as a, MigrationHints as c, isAttested as d, isDraft as f, DraftMigrationBundle as i, MigrationManifest as l, AttestedMigrationManifest as n, MigrationChainEntry as o, BaseMigrationBundle as r, MigrationGraph as s, AttestedMigrationBundle as t, MigrationOps as u };
+//# sourceMappingURL=types-BW_pJEe8.d.mts.map

package/dist/types-BW_pJEe8.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BW_pJEe8.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,cAAA;;EAAA,SAAA,OAAA,EAAc,SAAA,MAAA,EAAA;EAUrB,SAAA,cAAA,EAAqB,MAAA;EAIN,SAAA,gBAAA,EAAA,MAAA;;;;AAczB;AAQA,UA1BU,qBAAA,CA0BiC;EAS/B,SAAA,IAAA,EAAA,MAAiB;EAEjB,SAAA,EAAA,EAAA,MAAY;EAMP,SAAA,IAAA,EAAA,SAAmB,GAAA,UAGf;EAQJ,SAAA,YAAA,EAlDQ,QAkDgB,GAAA,IACpB;EAGJ,SAAA,UAAA,EArDM,QAqDe;EAQrB,SAAA,KAAA,EA5DC,cA4DkB;EASnB,SAAA,MAAA,EAAc,SAAA,MAAA,EAAA;EACb,SAAA,UAAA,CAAA,EAAA;IACoC,SAAA,MAAA,CAAA,EAAA,MAAA;IAA7B,SAAA,KAAA,CAAA,EAAA,MAAA;EAC6B,CAAA;EAA7B,SAAA,SAAA,CAAA,EAAA;IACqB,SAAA,KAAA,EAAA,MAAA;IAApB,SAAA,KAAA,EAAA,MAAA;EAAW,CAAA,GAAA,IAAA;EAOrB,SAAA,SAAU,EAAA,MAAS;AAInC;;;;;;UAxEiB,sBAAA,SAA+B;;;;;;;UAQ/B,yBAAA,SAAkC;;;;;;;;KASvC,iBAAA,GAAoB,yBAAyB;KAE7C,YAAA,YAAwB;;;;;UAMnB,mBAAA;;;qBAGI;gBACL;;;;;;UAOC,uBAAA,SAAgC;qBAC5B;;UAGJ,oBAAA,SAA6B;qBACzB;;;;;;UAOJ,mBAAA;;;;;;;;UASA,cAAA;kBACC;yBACO,6BAA6B;yBAC7B,6BAA6B;0BAC5B,oBAAoB;;;;;;iBAO9B,UAAA,SAAmB,gCAAgC;iBAInD,OAAA,SAAgB,gCAAgC"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@prisma-next/migration-tools",
-  "version": "0.3.0-dev.99",
+  "version": "0.3.0",
   "type": "module",
   "sideEffects": false,
   "description": "On-disk migration persistence, attestation, and chain reconstruction for Prisma Next",
   "dependencies": {
     "arktype": "^2.1.29",
     "pathe": "^2.0.3",
-    "@prisma-next/contract": "0.3.0-dev.99",
-    "@prisma-next/utils": "0.3.0-dev.99",
-    "@prisma-next/core-control-plane": "0.3.0-dev.99"
+    "@prisma-next/contract": "0.3.0",
+    "@prisma-next/framework-components": "0.3.0",
+    "@prisma-next/utils": "0.3.0"
   },
   "devDependencies": {
     "tsdown": "0.18.4",
@@ -46,6 +46,14 @@
       "types": "./dist/exports/refs.d.mts",
       "import": "./dist/exports/refs.mjs"
     },
+    "./constants": {
+      "types": "./dist/exports/constants.d.mts",
+      "import": "./dist/exports/constants.mjs"
+    },
+    "./migration-ts": {
+      "types": "./dist/exports/migration-ts.d.mts",
+      "import": "./dist/exports/migration-ts.mjs"
+    },
     "./package.json": "./package.json"
   },
   "repository": {

package/src/attestation.ts

@@ -1,9 +1,7 @@
 import { createHash } from 'node:crypto';
-import { writeFile } from 'node:fs/promises';
-import { canonicalizeContract } from '@prisma-next/core-control-plane/emission';
-import { join } from 'pathe';
+import { canonicalizeContract } from '@prisma-next/contract/hashing';
 import { canonicalizeJson } from './canonicalize-json';
-import { readMigrationPackage } from './io';
+import { readMigrationPackage, writeMigrationManifest } from './io';
 import type { MigrationManifest, MigrationOps } from './types';
 
 export interface VerifyResult {
@@ -49,7 +47,7 @@ export async function attestMigration(dir: string): Promise<string> {
   const migrationId = computeMigrationId(pkg.manifest, pkg.ops);
 
   const updated = { ...pkg.manifest, migrationId };
-  await writeFile(join(dir, 'migration.json'), JSON.stringify(updated, null, 2));
+  await writeMigrationManifest(dir, updated);
 
   return migrationId;
 }

package/src/constants.ts

@@ -0,0 +1,5 @@
+/**
+ * Sentinel value representing the absence of a contract (empty/new project).
+ * This is a human-readable marker, not a real SHA-256 hash.
+ */
+export const EMPTY_CONTRACT_HASH = 'sha256:empty' as const;

package/src/dag.ts

@@ -1,11 +1,11 @@
-import { EMPTY_CONTRACT_HASH } from '@prisma-next/core-control-plane/constants';
 import { ifDefined } from '@prisma-next/utils/defined';
+import { EMPTY_CONTRACT_HASH } from './constants';
 import {
-  errorAmbiguousLeaf,
+  errorAmbiguousTarget,
   errorDuplicateMigrationId,
-  errorNoResolvableLeaf,
-  errorNoRoot,
-  errorSelfLoop,
+  errorNoInitialMigration,
+  errorNoTarget,
+  errorSameSourceAndTarget,
 } from './errors';
 import type { AttestedMigrationBundle, MigrationChainEntry, MigrationGraph } from './types';
 
@@ -19,7 +19,7 @@ export function reconstructGraph(packages: readonly AttestedMigrationBundle[]):
     const { from, to } = pkg.manifest;
 
     if (from === to) {
-      throw errorSelfLoop(pkg.dirName, from);
+      throw errorSameSourceAndTarget(pkg.dirName, from);
     }
 
     nodes.add(from);
@@ -203,7 +203,7 @@ export function findPathWithDecision(
 }
 
 /**
- * Walk ancestors of each leaf back from the leaves to find the last node
+ * Walk ancestors of each branch tip back to find the last node
  * that appears on all paths. Returns `fromHash` if no shared ancestor is found.
  */
 function findDivergencePoint(
@@ -246,8 +246,8 @@ function findDivergencePoint(
 }
 
 /**
- * Find all leaf nodes reachable from `fromHash` via forward edges.
- * A leaf is a node with no outgoing edges in the graph.
+ * Find all branch tips (nodes with no outgoing edges) reachable from
+ * `fromHash` via forward edges.
  */
 export function findReachableLeaves(graph: MigrationGraph, fromHash: string): readonly string[] {
   const visited = new Set<string>();
@@ -276,10 +276,10 @@ export function findReachableLeaves(graph: MigrationGraph, fromHash: string): re
 }
 
 /**
- * Find the leaf contract hash of the migration graph reachable from
- * EMPTY_CONTRACT_HASH. Throws NO_ROOT if the graph has nodes but none
- * originate from the empty hash (e.g. root migration was deleted).
- * Throws AMBIGUOUS_LEAF if multiple leaves exist.
+ * Find the target contract hash of the migration graph reachable from
+ * EMPTY_CONTRACT_HASH. Throws NO_INITIAL_MIGRATION if the graph has
+ * nodes but none originate from the empty hash.
+ * Throws AMBIGUOUS_TARGET if multiple branch tips exist.
  */
 export function findLeaf(graph: MigrationGraph): string {
   if (graph.nodes.size === 0) {
@@ -287,7 +287,7 @@ export function findLeaf(graph: MigrationGraph): string {
   }
 
   if (!graph.nodes.has(EMPTY_CONTRACT_HASH)) {
-    throw errorNoRoot([...graph.nodes]);
+    throw errorNoInitialMigration([...graph.nodes]);
   }
 
   const leaves = findReachableLeaves(graph, EMPTY_CONTRACT_HASH);
@@ -295,21 +295,21 @@ export function findLeaf(graph: MigrationGraph): string {
   if (leaves.length === 0) {
     const reachable = [...graph.nodes].filter((n) => n !== EMPTY_CONTRACT_HASH);
     if (reachable.length > 0) {
-      throw errorNoResolvableLeaf(reachable);
+      throw errorNoTarget(reachable);
     }
     return EMPTY_CONTRACT_HASH;
   }
 
   if (leaves.length > 1) {
     const divergencePoint = findDivergencePoint(graph, EMPTY_CONTRACT_HASH, leaves);
-    const branches = leaves.map((leaf) => {
-      const path = findPath(graph, divergencePoint, leaf);
+    const branches = leaves.map((tip) => {
+      const path = findPath(graph, divergencePoint, tip);
       return {
-        leaf,
+        tip,
         edges: (path ?? []).map((e) => ({ dirName: e.dirName, from: e.from, to: e.to })),
       };
     });
-    throw errorAmbiguousLeaf(leaves, { divergencePoint, branches });
+    throw errorAmbiguousTarget(leaves, { divergencePoint, branches });
   }
 
   const leaf = leaves[0];
@@ -318,8 +318,8 @@ export function findLeaf(graph: MigrationGraph): string {
 
 /**
  * Find the latest migration entry by traversing from EMPTY_CONTRACT_HASH
- * to the single leaf. Returns null for an empty graph.
- * Throws AMBIGUOUS_LEAF if the graph has multiple leaves.
+ * to the single target. Returns null for an empty graph.
+ * Throws AMBIGUOUS_TARGET if the graph has multiple branch tips.
  */
 export function findLatestMigration(graph: MigrationGraph): MigrationChainEntry | null {
   if (graph.nodes.size === 0) {

package/src/errors.ts

@@ -3,7 +3,7 @@
  *
  * Follows the NAMESPACE.SUBCODE convention from ADR 027. All codes live under
  * the MIGRATION namespace. These are tooling-time errors (file I/O, attestation,
- * migration-chain reconstruction), distinct from the runtime MIGRATION.* codes for apply-time
+ * migration history reconstruction), distinct from the runtime MIGRATION.* codes for apply-time
  * failures (PRECHECK_FAILED, POSTCHECK_FAILED, etc.).
  *
  * Fields:
@@ -84,40 +84,44 @@ export function errorInvalidSlug(slug: string): MigrationToolsError {
   });
 }
 
-export function errorSelfLoop(dirName: string, hash: string): MigrationToolsError {
-  return new MigrationToolsError('MIGRATION.SELF_LOOP', 'Self-loop in migration graph', {
-    why: `Migration "${dirName}" has from === to === "${hash}". A migration must transition between two different contract states.`,
-    fix: 'Delete the invalid migration directory and re-run migration plan.',
-    details: { dirName, hash },
-  });
+export function errorSameSourceAndTarget(dirName: string, hash: string): MigrationToolsError {
+  return new MigrationToolsError(
+    'MIGRATION.SAME_SOURCE_AND_TARGET',
+    'Migration has same source and target',
+    {
+      why: `Migration "${dirName}" has from === to === "${hash}". A migration must transition between two different contract states.`,
+      fix: 'Delete the invalid migration directory and re-run migration plan.',
+      details: { dirName, hash },
+    },
+  );
 }
 
-export function errorAmbiguousLeaf(
-  leaves: readonly string[],
+export function errorAmbiguousTarget(
+  branchTips: readonly string[],
   context?: {
     divergencePoint: string;
     branches: readonly {
-      leaf: string;
+      tip: string;
       edges: readonly { dirName: string; from: string; to: string }[];
     }[];
   },
 ): MigrationToolsError {
   const divergenceInfo = context
-    ? `\nDivergence point: ${context.divergencePoint}\nBranches:\n${context.branches.map((b) => `  → ${b.leaf} (${b.edges.length} edge(s): ${b.edges.map((e) => e.dirName).join(' → ') || 'direct'})`).join('\n')}`
+    ? `\nDivergence point: ${context.divergencePoint}\nBranches:\n${context.branches.map((b) => `  → ${b.tip} (${b.edges.length} edge(s): ${b.edges.map((e) => e.dirName).join(' → ') || 'direct'})`).join('\n')}`
     : '';
-  return new MigrationToolsError('MIGRATION.AMBIGUOUS_LEAF', 'Ambiguous migration graph', {
-    why: `Multiple leaf nodes found: ${leaves.join(', ')}. The migration graph has diverged — this typically happens when two developers plan migrations from the same starting point.${divergenceInfo}`,
+  return new MigrationToolsError('MIGRATION.AMBIGUOUS_TARGET', 'Ambiguous migration target', {
+    why: `The migration history has diverged into multiple branches: ${branchTips.join(', ')}. This typically happens when two developers plan migrations from the same starting point.${divergenceInfo}`,
     fix: 'Use `migration ref set <name> <hash>` to target a specific branch, delete one of the conflicting migration directories and re-run `migration plan`, or use --from <hash> to explicitly select a starting point.',
     details: {
-      leaves,
+      branchTips,
       ...(context ? { divergencePoint: context.divergencePoint, branches: context.branches } : {}),
     },
   });
 }
 
-export function errorNoRoot(nodes: readonly string[]): MigrationToolsError {
-  return new MigrationToolsError('MIGRATION.NO_ROOT', 'Migration graph has no root', {
-    why: `No root migration found in the migration graph (nodes: ${nodes.join(', ')}). No migration starts from the empty contract hash, or all edges form a disconnected subgraph.`,
+export function errorNoInitialMigration(nodes: readonly string[]): MigrationToolsError {
+  return new MigrationToolsError('MIGRATION.NO_INITIAL_MIGRATION', 'No initial migration found', {
+    why: `No migration starts from the empty contract state (known hashes: ${nodes.join(', ')}). At least one migration must originate from the empty state.`,
     fix: 'Inspect the migrations directory for corrupted migration.json files. At least one migration must start from the empty contract hash.',
     details: { nodes },
   });
@@ -131,6 +135,14 @@ export function errorInvalidRefs(refsPath: string, reason: string): MigrationToo
   });
 }
 
+export function errorInvalidRefFile(filePath: string, reason: string): MigrationToolsError {
+  return new MigrationToolsError('MIGRATION.INVALID_REF_FILE', 'Invalid ref file', {
+    why: `Ref file at "${filePath}" is invalid: ${reason}`,
+    fix: 'Ensure the ref file contains valid JSON with { "hash": "sha256:<64 hex chars>", "invariants": ["..."] }.',
+    details: { path: filePath, reason },
+  });
+}
+
 export function errorInvalidRefName(refName: string): MigrationToolsError {
   return new MigrationToolsError('MIGRATION.INVALID_REF_NAME', 'Invalid ref name', {
     why: `Ref name "${refName}" is invalid. Names must be lowercase alphanumeric with hyphens or forward slashes (no "." or ".." segments).`,
@@ -139,16 +151,12 @@ export function errorInvalidRefName(refName: string): MigrationToolsError {
   });
 }
 
-export function errorNoResolvableLeaf(reachableNodes: readonly string[]): MigrationToolsError {
-  return new MigrationToolsError(
-    'MIGRATION.NO_RESOLVABLE_LEAF',
-    'Migration graph has no resolvable leaf',
-    {
-      why: `The migration graph contains cycles and no node has zero outgoing edges (reachable nodes: ${reachableNodes.join(', ')}). This typically happens after rollback migrations (e.g., C1→C2→C1).`,
-      fix: 'Use --from <hash> to specify the planning origin explicitly.',
-      details: { reachableNodes },
-    },
-  );
+export function errorNoTarget(reachableHashes: readonly string[]): MigrationToolsError {
+  return new MigrationToolsError('MIGRATION.NO_TARGET', 'No migration target could be resolved', {
+    why: `The migration history contains cycles and no target can be resolved automatically (reachable hashes: ${reachableHashes.join(', ')}). This typically happens after rollback migrations (e.g., C1→C2→C1).`,
+    fix: 'Use --from <hash> to specify the planning origin explicitly.',
+    details: { reachableHashes },
+  });
 }
 
 export function errorInvalidRefValue(value: string): MigrationToolsError {

package/src/exports/constants.ts

@@ -0,0 +1 @@
+export { EMPTY_CONTRACT_HASH } from '../constants';