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

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":"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"}

package/dist/exports/migration.d.mts

@@ -0,0 +1,28 @@
+//#region src/migration-base.d.ts
+interface MigrationMeta {
+  readonly from: string;
+  readonly to: string;
+  readonly kind?: 'regular' | 'baseline';
+  readonly labels?: readonly string[];
+}
+declare abstract class Migration<TOperation = unknown> {
+  abstract plan(): TOperation[];
+  describe(): MigrationMeta | undefined;
+  /**
+   * Entrypoint guard for migration files. When called at module scope,
+   * detects whether the file is being run directly (e.g. `tsx migration.ts`)
+   * and if so, serializes the migration plan to `ops.json` (and optionally
+   * `migration.json`) in the same directory. When the file is imported by
+   * another module, this is a no-op.
+   *
+   * Usage (at module scope, after the class definition):
+   *
+   *     class MyMigration extends Migration { ... }
+   *     export default MyMigration;
+   *     Migration.run(import.meta.url, MyMigration);
+   */
+  static run(importMetaUrl: string, MigrationClass: new () => Migration): void;
+}
+//#endregion
+export { Migration, type MigrationMeta };
+//# sourceMappingURL=migration.d.mts.map

package/dist/exports/migration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.mts","names":[],"sources":["../../src/migration-base.ts"],"sourcesContent":[],"mappings":";UAKiB,aAAA;EAAA,SAAA,IAAA,EAAA,MAAa;EAcR,SAAA,EAAA,EAAS,MAAA;EACZ,SAAA,IAAA,CAAA,EAAA,SAAA,GAAA,UAAA;EAEL,SAAA,MAAA,CAAA,EAAA,SAAA,MAAA,EAAA;;AAiByD,uBApBjD,SAoBiD,CAAA,aAAA,OAAA,CAAA,CAAA;mBAnBpD;cAEL;;;;;;;;;;;;;;8DAiBgD"}

package/dist/exports/migration.mjs

@@ -0,0 +1,105 @@
+import { type } from "arktype";
+import { dirname, join } from "pathe";
+import { realpathSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+//#region src/migration-base.ts
+const MigrationMetaSchema = type({
+	from: "string",
+	to: "string",
+	"kind?": "'regular' | 'baseline'",
+	"labels?": "string[]"
+});
+var Migration = class {
+	describe() {}
+	/**
+	* Entrypoint guard for migration files. When called at module scope,
+	* detects whether the file is being run directly (e.g. `tsx migration.ts`)
+	* and if so, serializes the migration plan to `ops.json` (and optionally
+	* `migration.json`) in the same directory. When the file is imported by
+	* another module, this is a no-op.
+	*
+	* Usage (at module scope, after the class definition):
+	*
+	*     class MyMigration extends Migration { ... }
+	*     export default MyMigration;
+	*     Migration.run(import.meta.url, MyMigration);
+	*/
+	static run(importMetaUrl, MigrationClass) {
+		if (!importMetaUrl) return;
+		const metaFilename = fileURLToPath(importMetaUrl);
+		const argv1 = process.argv[1];
+		if (!argv1) return;
+		let isEntrypoint;
+		try {
+			isEntrypoint = realpathSync(metaFilename) === realpathSync(argv1);
+		} catch {
+			return;
+		}
+		if (!isEntrypoint) return;
+		const args = process.argv.slice(2);
+		if (args.includes("--help")) {
+			printHelp();
+			return;
+		}
+		const dryRun = args.includes("--dry-run");
+		const migrationDir = dirname(metaFilename);
+		try {
+			serializeMigration(MigrationClass, migrationDir, dryRun);
+		} catch (err) {
+			process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+			process.exitCode = 1;
+		}
+	}
+};
+function printHelp() {
+	process.stdout.write([
+		"Usage: tsx <migration-file> [options]",
+		"",
+		"Options:",
+		"  --dry-run  Print operations to stdout without writing files",
+		"  --help     Show this help message",
+		""
+	].join("\n"));
+}
+function buildManifest(meta) {
+	return {
+		migrationId: null,
+		from: meta.from,
+		to: meta.to,
+		kind: meta.kind ?? "regular",
+		labels: meta.labels ?? [],
+		createdAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+function serializeMigration(MigrationClass, migrationDir, dryRun) {
+	const instance = new MigrationClass();
+	const ops = instance.plan();
+	if (!Array.isArray(ops)) throw new Error("plan() must return an array of operations");
+	const serializedOps = JSON.stringify(ops, null, 2);
+	let manifest;
+	if (typeof instance.describe === "function") {
+		const rawMeta = instance.describe();
+		if (rawMeta !== void 0) {
+			const parsed = MigrationMetaSchema(rawMeta);
+			if (parsed instanceof type.errors) throw new Error(`describe() returned invalid metadata: ${parsed.summary}`);
+			manifest = buildManifest(parsed);
+		}
+	}
+	if (dryRun) {
+		if (manifest) {
+			process.stdout.write(`--- migration.json ---\n${JSON.stringify(manifest, null, 2)}\n`);
+			process.stdout.write("--- ops.json ---\n");
+		}
+		process.stdout.write(`${serializedOps}\n`);
+		return;
+	}
+	writeFileSync(join(migrationDir, "ops.json"), serializedOps);
+	if (manifest) writeFileSync(join(migrationDir, "migration.json"), JSON.stringify(manifest, null, 2));
+	const files = manifest ? "ops.json + migration.json" : "ops.json";
+	process.stdout.write(`Wrote ${files} to ${migrationDir}\n`);
+}
+
+//#endregion
+export { Migration };
+//# sourceMappingURL=migration.mjs.map

package/dist/exports/migration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.mjs","names":["isEntrypoint: boolean","manifest: Record<string, unknown> | undefined","rawMeta: unknown"],"sources":["../../src/migration-base.ts"],"sourcesContent":["import { realpathSync, writeFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { type } from 'arktype';\nimport { dirname, join } from 'pathe';\n\nexport interface MigrationMeta {\n  readonly from: string;\n  readonly to: string;\n  readonly kind?: 'regular' | 'baseline';\n  readonly labels?: readonly string[];\n}\n\nconst MigrationMetaSchema = type({\n  from: 'string',\n  to: 'string',\n  'kind?': \"'regular' | 'baseline'\",\n  'labels?': 'string[]',\n});\n\nexport abstract class Migration<TOperation = unknown> {\n  abstract plan(): TOperation[];\n\n  describe(): MigrationMeta | undefined {\n    return undefined;\n  }\n\n  /**\n   * Entrypoint guard for migration files. When called at module scope,\n   * detects whether the file is being run directly (e.g. `tsx migration.ts`)\n   * and if so, serializes the migration plan to `ops.json` (and optionally\n   * `migration.json`) in the same directory. When the file is imported by\n   * another module, this is a no-op.\n   *\n   * Usage (at module scope, after the class definition):\n   *\n   *     class MyMigration extends Migration { ... }\n   *     export default MyMigration;\n   *     Migration.run(import.meta.url, MyMigration);\n   */\n  static run(importMetaUrl: string, MigrationClass: new () => Migration): void {\n    if (!importMetaUrl) return;\n\n    const metaFilename = fileURLToPath(importMetaUrl);\n    const argv1 = process.argv[1];\n    if (!argv1) return;\n\n    let isEntrypoint: boolean;\n    try {\n      isEntrypoint = realpathSync(metaFilename) === realpathSync(argv1);\n    } catch {\n      return;\n    }\n    if (!isEntrypoint) return;\n\n    const args = process.argv.slice(2);\n\n    if (args.includes('--help')) {\n      printHelp();\n      return;\n    }\n\n    const dryRun = args.includes('--dry-run');\n    const migrationDir = dirname(metaFilename);\n\n    try {\n      serializeMigration(MigrationClass, migrationDir, dryRun);\n    } catch (err) {\n      process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`);\n      process.exitCode = 1;\n    }\n  }\n}\n\nfunction printHelp(): void {\n  process.stdout.write(\n    [\n      'Usage: tsx <migration-file> [options]',\n      '',\n      'Options:',\n      '  --dry-run  Print operations to stdout without writing files',\n      '  --help     Show this help message',\n      '',\n    ].join('\\n'),\n  );\n}\n\nfunction buildManifest(meta: MigrationMeta): Record<string, unknown> {\n  return {\n    migrationId: null,\n    from: meta.from,\n    to: meta.to,\n    kind: meta.kind ?? 'regular',\n    labels: meta.labels ?? [],\n    createdAt: new Date().toISOString(),\n  };\n}\n\nfunction serializeMigration(\n  MigrationClass: new () => Migration,\n  migrationDir: string,\n  dryRun: boolean,\n): void {\n  const instance = new MigrationClass();\n\n  const ops = instance.plan();\n\n  if (!Array.isArray(ops)) {\n    throw new Error('plan() must return an array of operations');\n  }\n\n  const serializedOps = JSON.stringify(ops, null, 2);\n\n  let manifest: Record<string, unknown> | undefined;\n  if (typeof instance.describe === 'function') {\n    const rawMeta: unknown = instance.describe();\n    if (rawMeta !== undefined) {\n      const parsed = MigrationMetaSchema(rawMeta);\n      if (parsed instanceof type.errors) {\n        throw new Error(`describe() returned invalid metadata: ${parsed.summary}`);\n      }\n      manifest = buildManifest(parsed);\n    }\n  }\n\n  if (dryRun) {\n    if (manifest) {\n      process.stdout.write(`--- migration.json ---\\n${JSON.stringify(manifest, null, 2)}\\n`);\n      process.stdout.write('--- ops.json ---\\n');\n    }\n    process.stdout.write(`${serializedOps}\\n`);\n    return;\n  }\n\n  writeFileSync(join(migrationDir, 'ops.json'), serializedOps);\n  if (manifest) {\n    writeFileSync(join(migrationDir, 'migration.json'), JSON.stringify(manifest, null, 2));\n  }\n\n  const files = manifest ? 'ops.json + migration.json' : 'ops.json';\n  process.stdout.write(`Wrote ${files} to ${migrationDir}\\n`);\n}\n"],"mappings":";;;;;;AAYA,MAAM,sBAAsB,KAAK;CAC/B,MAAM;CACN,IAAI;CACJ,SAAS;CACT,WAAW;CACZ,CAAC;AAEF,IAAsB,YAAtB,MAAsD;CAGpD,WAAsC;;;;;;;;;;;;;;CAiBtC,OAAO,IAAI,eAAuB,gBAA2C;AAC3E,MAAI,CAAC,cAAe;EAEpB,MAAM,eAAe,cAAc,cAAc;EACjD,MAAM,QAAQ,QAAQ,KAAK;AAC3B,MAAI,CAAC,MAAO;EAEZ,IAAIA;AACJ,MAAI;AACF,kBAAe,aAAa,aAAa,KAAK,aAAa,MAAM;UAC3D;AACN;;AAEF,MAAI,CAAC,aAAc;EAEnB,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE;AAElC,MAAI,KAAK,SAAS,SAAS,EAAE;AAC3B,cAAW;AACX;;EAGF,MAAM,SAAS,KAAK,SAAS,YAAY;EACzC,MAAM,eAAe,QAAQ,aAAa;AAE1C,MAAI;AACF,sBAAmB,gBAAgB,cAAc,OAAO;WACjD,KAAK;AACZ,WAAQ,OAAO,MAAM,GAAG,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC,IAAI;AAC7E,WAAQ,WAAW;;;;AAKzB,SAAS,YAAkB;AACzB,SAAQ,OAAO,MACb;EACE;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK,CACb;;AAGH,SAAS,cAAc,MAA8C;AACnE,QAAO;EACL,aAAa;EACb,MAAM,KAAK;EACX,IAAI,KAAK;EACT,MAAM,KAAK,QAAQ;EACnB,QAAQ,KAAK,UAAU,EAAE;EACzB,4BAAW,IAAI,MAAM,EAAC,aAAa;EACpC;;AAGH,SAAS,mBACP,gBACA,cACA,QACM;CACN,MAAM,WAAW,IAAI,gBAAgB;CAErC,MAAM,MAAM,SAAS,MAAM;AAE3B,KAAI,CAAC,MAAM,QAAQ,IAAI,CACrB,OAAM,IAAI,MAAM,4CAA4C;CAG9D,MAAM,gBAAgB,KAAK,UAAU,KAAK,MAAM,EAAE;CAElD,IAAIC;AACJ,KAAI,OAAO,SAAS,aAAa,YAAY;EAC3C,MAAMC,UAAmB,SAAS,UAAU;AAC5C,MAAI,YAAY,QAAW;GACzB,MAAM,SAAS,oBAAoB,QAAQ;AAC3C,OAAI,kBAAkB,KAAK,OACzB,OAAM,IAAI,MAAM,yCAAyC,OAAO,UAAU;AAE5E,cAAW,cAAc,OAAO;;;AAIpC,KAAI,QAAQ;AACV,MAAI,UAAU;AACZ,WAAQ,OAAO,MAAM,2BAA2B,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC,IAAI;AACtF,WAAQ,OAAO,MAAM,qBAAqB;;AAE5C,UAAQ,OAAO,MAAM,GAAG,cAAc,IAAI;AAC1C;;AAGF,eAAc,KAAK,cAAc,WAAW,EAAE,cAAc;AAC5D,KAAI,SACF,eAAc,KAAK,cAAc,iBAAiB,EAAE,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;CAGxF,MAAM,QAAQ,WAAW,8BAA8B;AACvD,SAAQ,OAAO,MAAM,SAAS,MAAM,MAAM,aAAa,IAAI"}

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-C_XuSbX7.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-DXjq7Fum.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-C_XuSbX7.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-BO18-Evu.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-C_XuSbX7.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-BO18-Evu.mjs.map

package/dist/io-BO18-Evu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-BO18-Evu.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-DXjq7Fum.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-DXjq7Fum.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-DXjq7Fum.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,22 +1,22 @@
 {
   "name": "@prisma-next/migration-tools",
-  "version": "0.3.0-dev.99",
+  "version": "0.4.0-dev.1",
   "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.4.0-dev.1",
+    "@prisma-next/utils": "0.4.0-dev.1",
+    "@prisma-next/framework-components": "0.4.0-dev.1"
   },
   "devDependencies": {
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
-    "@prisma-next/tsconfig": "0.0.0",
-    "@prisma-next/tsdown": "0.0.0"
+    "@prisma-next/tsdown": "0.0.0",
+    "@prisma-next/tsconfig": "0.0.0"
   },
   "files": [
     "dist",
@@ -46,6 +46,18 @@
       "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"
+    },
+    "./migration": {
+      "types": "./dist/exports/migration.d.mts",
+      "import": "./dist/exports/migration.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;