@prisma-next/migration-tools 0.4.0-dev.6 → 0.4.0-dev.8

package/dist/attestation-DnebS4XZ.mjs

@@ -0,0 +1,64 @@
+import { a as writeMigrationManifest, r as readMigrationPackage } from "./io-Cun81AIZ.mjs";
+import { createHash } from "node:crypto";
+
+//#region src/canonicalize-json.ts
+function sortKeys(value) {
+	if (value === null || typeof value !== "object") return value;
+	if (Array.isArray(value)) return value.map(sortKeys);
+	const sorted = {};
+	for (const key of Object.keys(value).sort()) sorted[key] = sortKeys(value[key]);
+	return sorted;
+}
+function canonicalizeJson(value) {
+	return JSON.stringify(sortKeys(value));
+}
+
+//#endregion
+//#region src/attestation.ts
+function sha256Hex(input) {
+	return createHash("sha256").update(input).digest("hex");
+}
+/**
+* Content-addressed migration identity over (manifest envelope sans
+* contracts/hints, ops). See ADR 199 "Storage-only migration identity"
+* for the rationale: contracts are anchored separately by the
+* storage-hash bookends inside the envelope; planner hints are advisory
+* and must not affect identity.
+*/
+function computeMigrationId(manifest, ops) {
+	const { migrationId: _migrationId, signature: _signature, fromContract: _fromContract, toContract: _toContract, hints: _hints, ...strippedMeta } = manifest;
+	return `sha256:${sha256Hex(canonicalizeJson([canonicalizeJson(strippedMeta), canonicalizeJson(ops)].map(sha256Hex)))}`;
+}
+/** Compute and persist `migrationId` to `manifest.json`. */
+async function attestMigration(dir) {
+	const pkg = await readMigrationPackage(dir);
+	const migrationId = computeMigrationId(pkg.manifest, pkg.ops);
+	await writeMigrationManifest(dir, {
+		...pkg.manifest,
+		migrationId
+	});
+	return migrationId;
+}
+async function verifyMigration(dir) {
+	const pkg = await readMigrationPackage(dir);
+	if (pkg.manifest.migrationId === null) return {
+		ok: false,
+		reason: "draft"
+	};
+	const computed = computeMigrationId(pkg.manifest, pkg.ops);
+	if (pkg.manifest.migrationId === computed) return {
+		ok: true,
+		storedMigrationId: pkg.manifest.migrationId,
+		computedMigrationId: computed
+	};
+	return {
+		ok: false,
+		reason: "mismatch",
+		storedMigrationId: pkg.manifest.migrationId,
+		computedMigrationId: computed
+	};
+}
+
+//#endregion
+export { computeMigrationId as n, verifyMigration as r, attestMigration as t };
+//# sourceMappingURL=attestation-DnebS4XZ.mjs.map

package/dist/attestation-DnebS4XZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation-DnebS4XZ.mjs","names":["sorted: Record<string, unknown>"],"sources":["../src/canonicalize-json.ts","../src/attestation.ts"],"sourcesContent":["function sortKeys(value: unknown): unknown {\n  if (value === null || typeof value !== 'object') {\n    return value;\n  }\n  if (Array.isArray(value)) {\n    return value.map(sortKeys);\n  }\n  const sorted: Record<string, unknown> = {};\n  for (const key of Object.keys(value).sort()) {\n    sorted[key] = sortKeys((value as Record<string, unknown>)[key]);\n  }\n  return sorted;\n}\n\nexport function canonicalizeJson(value: unknown): string {\n  return JSON.stringify(sortKeys(value));\n}\n","import { createHash } from 'node:crypto';\nimport { canonicalizeJson } from './canonicalize-json';\nimport { readMigrationPackage, writeMigrationManifest } from './io';\nimport type { MigrationManifest, MigrationOps } from './types';\n\nexport interface VerifyResult {\n  readonly ok: boolean;\n  readonly reason?: 'draft' | 'mismatch';\n  readonly storedMigrationId?: string;\n  readonly computedMigrationId?: string;\n}\n\nfunction sha256Hex(input: string): string {\n  return createHash('sha256').update(input).digest('hex');\n}\n\n/**\n * Content-addressed migration identity over (manifest envelope sans\n * contracts/hints, ops). See ADR 199 \"Storage-only migration identity\"\n * for the rationale: contracts are anchored separately by the\n * storage-hash bookends inside the envelope; planner hints are advisory\n * and must not affect identity.\n */\nexport function computeMigrationId(manifest: MigrationManifest, ops: MigrationOps): string {\n  const {\n    migrationId: _migrationId,\n    signature: _signature,\n    fromContract: _fromContract,\n    toContract: _toContract,\n    hints: _hints,\n    ...strippedMeta\n  } = manifest;\n\n  const canonicalManifest = canonicalizeJson(strippedMeta);\n  const canonicalOps = canonicalizeJson(ops);\n\n  const partHashes = [canonicalManifest, canonicalOps].map(sha256Hex);\n  const hash = sha256Hex(canonicalizeJson(partHashes));\n\n  return `sha256:${hash}`;\n}\n\n/** Compute and persist `migrationId` to `manifest.json`. */\nexport async function attestMigration(dir: string): Promise<string> {\n  const pkg = await readMigrationPackage(dir);\n  const migrationId = computeMigrationId(pkg.manifest, pkg.ops);\n\n  const updated = { ...pkg.manifest, migrationId };\n  await writeMigrationManifest(dir, updated);\n\n  return migrationId;\n}\n\nexport async function verifyMigration(dir: string): Promise<VerifyResult> {\n  const pkg = await readMigrationPackage(dir);\n\n  if (pkg.manifest.migrationId === null) {\n    return { ok: false, reason: 'draft' };\n  }\n\n  const computed = computeMigrationId(pkg.manifest, pkg.ops);\n\n  if (pkg.manifest.migrationId === computed) {\n    return { ok: true, storedMigrationId: pkg.manifest.migrationId, computedMigrationId: computed };\n  }\n\n  return {\n    ok: false,\n    reason: 'mismatch',\n    storedMigrationId: pkg.manifest.migrationId,\n    computedMigrationId: computed,\n  };\n}\n"],"mappings":";;;;AAAA,SAAS,SAAS,OAAyB;AACzC,KAAI,UAAU,QAAQ,OAAO,UAAU,SACrC,QAAO;AAET,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,IAAI,SAAS;CAE5B,MAAMA,SAAkC,EAAE;AAC1C,MAAK,MAAM,OAAO,OAAO,KAAK,MAAM,CAAC,MAAM,CACzC,QAAO,OAAO,SAAU,MAAkC,KAAK;AAEjE,QAAO;;AAGT,SAAgB,iBAAiB,OAAwB;AACvD,QAAO,KAAK,UAAU,SAAS,MAAM,CAAC;;;;;ACHxC,SAAS,UAAU,OAAuB;AACxC,QAAO,WAAW,SAAS,CAAC,OAAO,MAAM,CAAC,OAAO,MAAM;;;;;;;;;AAUzD,SAAgB,mBAAmB,UAA6B,KAA2B;CACzF,MAAM,EACJ,aAAa,cACb,WAAW,YACX,cAAc,eACd,YAAY,aACZ,OAAO,QACP,GAAG,iBACD;AAQJ,QAAO,UAFM,UAAU,iBADJ,CAHO,iBAAiB,aAAa,EACnC,iBAAiB,IAAI,CAEU,CAAC,IAAI,UAAU,CAChB,CAAC;;;AAMtD,eAAsB,gBAAgB,KAA8B;CAClE,MAAM,MAAM,MAAM,qBAAqB,IAAI;CAC3C,MAAM,cAAc,mBAAmB,IAAI,UAAU,IAAI,IAAI;AAG7D,OAAM,uBAAuB,KADb;EAAE,GAAG,IAAI;EAAU;EAAa,CACN;AAE1C,QAAO;;AAGT,eAAsB,gBAAgB,KAAoC;CACxE,MAAM,MAAM,MAAM,qBAAqB,IAAI;AAE3C,KAAI,IAAI,SAAS,gBAAgB,KAC/B,QAAO;EAAE,IAAI;EAAO,QAAQ;EAAS;CAGvC,MAAM,WAAW,mBAAmB,IAAI,UAAU,IAAI,IAAI;AAE1D,KAAI,IAAI,SAAS,gBAAgB,SAC/B,QAAO;EAAE,IAAI;EAAM,mBAAmB,IAAI,SAAS;EAAa,qBAAqB;EAAU;AAGjG,QAAO;EACL,IAAI;EACJ,QAAQ;EACR,mBAAmB,IAAI,SAAS;EAChC,qBAAqB;EACtB"}

package/dist/{constants-DARNL_LD.mjs → constants-BRi0X7B_.mjs}

@@ -7,4 +7,4 @@ const EMPTY_CONTRACT_HASH = "sha256:empty";
 
 //#endregion
 export { EMPTY_CONTRACT_HASH as t };
-//# sourceMappingURL=constants-DARNL_LD.mjs.map
+//# sourceMappingURL=constants-BRi0X7B_.mjs.map

package/dist/{constants-DARNL_LD.mjs.map → constants-BRi0X7B_.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"constants-DARNL_LD.mjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Sentinel value representing the absence of a contract (empty/new project).\n * This is a human-readable marker, not a real SHA-256 hash.\n */\nexport const EMPTY_CONTRACT_HASH = 'sha256:empty' as const;\n"],"mappings":";;;;;AAIA,MAAa,sBAAsB"}
+{"version":3,"file":"constants-BRi0X7B_.mjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Sentinel value representing the absence of a contract (empty/new project).\n * This is a human-readable marker, not a real SHA-256 hash.\n */\nexport const EMPTY_CONTRACT_HASH = 'sha256:empty' as const;\n"],"mappings":";;;;;AAIA,MAAa,sBAAsB"}

package/dist/exports/attestation.d.mts

@@ -1,4 +1,4 @@
-import { l as MigrationManifest, u as MigrationOps } from "../types-DXjq7Fum.mjs";
+import { l as MigrationManifest, u as MigrationOps } from "../types-D2uX4ql7.mjs";
 
 //#region src/attestation.d.ts
 interface VerifyResult {

package/dist/exports/attestation.mjs

@@ -1,64 +1,4 @@
-import { i as writeMigrationManifest, n as readMigrationPackage } from "../io-BO18-Evu.mjs";
-import { createHash } from "node:crypto";
+import "../io-Cun81AIZ.mjs";
+import { n as computeMigrationId, r as verifyMigration, t as attestMigration } from "../attestation-DnebS4XZ.mjs";
 
-//#region src/canonicalize-json.ts
-function sortKeys(value) {
-	if (value === null || typeof value !== "object") return value;
-	if (Array.isArray(value)) return value.map(sortKeys);
-	const sorted = {};
-	for (const key of Object.keys(value).sort()) sorted[key] = sortKeys(value[key]);
-	return sorted;
-}
-function canonicalizeJson(value) {
-	return JSON.stringify(sortKeys(value));
-}
-
-//#endregion
-//#region src/attestation.ts
-function sha256Hex(input) {
-	return createHash("sha256").update(input).digest("hex");
-}
-/**
-* Content-addressed migration identity over (manifest envelope sans
-* contracts/hints, ops). See ADR 199 "Storage-only migration identity"
-* for the rationale: contracts are anchored separately by the
-* storage-hash bookends inside the envelope; planner hints are advisory
-* and must not affect identity.
-*/
-function computeMigrationId(manifest, ops) {
-	const { migrationId: _migrationId, signature: _signature, fromContract: _fromContract, toContract: _toContract, hints: _hints, ...strippedMeta } = manifest;
-	return `sha256:${sha256Hex(canonicalizeJson([canonicalizeJson(strippedMeta), canonicalizeJson(ops)].map(sha256Hex)))}`;
-}
-/** Compute and persist `migrationId` to `manifest.json`. */
-async function attestMigration(dir) {
-	const pkg = await readMigrationPackage(dir);
-	const migrationId = computeMigrationId(pkg.manifest, pkg.ops);
-	await writeMigrationManifest(dir, {
-		...pkg.manifest,
-		migrationId
-	});
-	return migrationId;
-}
-async function verifyMigration(dir) {
-	const pkg = await readMigrationPackage(dir);
-	if (pkg.manifest.migrationId === null) return {
-		ok: false,
-		reason: "draft"
-	};
-	const computed = computeMigrationId(pkg.manifest, pkg.ops);
-	if (pkg.manifest.migrationId === computed) return {
-		ok: true,
-		storedMigrationId: pkg.manifest.migrationId,
-		computedMigrationId: computed
-	};
-	return {
-		ok: false,
-		reason: "mismatch",
-		storedMigrationId: pkg.manifest.migrationId,
-		computedMigrationId: computed
-	};
-}
-
-//#endregion
-export { attestMigration, computeMigrationId, verifyMigration };
-//# sourceMappingURL=attestation.mjs.map
+export { attestMigration, computeMigrationId, verifyMigration };

package/dist/exports/constants.mjs

@@ -1,3 +1,3 @@
-import { t as EMPTY_CONTRACT_HASH } from "../constants-DARNL_LD.mjs";
+import { t as EMPTY_CONTRACT_HASH } from "../constants-BRi0X7B_.mjs";
 
 export { EMPTY_CONTRACT_HASH };

package/dist/exports/dag.d.mts

@@ -1,4 +1,4 @@
-import { o as MigrationChainEntry, s as MigrationGraph, t as AttestedMigrationBundle } from "../types-DXjq7Fum.mjs";
+import { o as MigrationChainEntry, s as MigrationGraph, t as AttestedMigrationBundle } from "../types-D2uX4ql7.mjs";
 
 //#region src/dag.d.ts
 declare function reconstructGraph(packages: readonly AttestedMigrationBundle[]): MigrationGraph;

package/dist/exports/dag.mjs

@@ -1,5 +1,5 @@
 import { f as errorNoInitialMigration, i as errorDuplicateMigrationId, m as errorSameSourceAndTarget, n as errorAmbiguousTarget, p as errorNoTarget } from "../errors-C_XuSbX7.mjs";
-import { t as EMPTY_CONTRACT_HASH } from "../constants-DARNL_LD.mjs";
+import { t as EMPTY_CONTRACT_HASH } from "../constants-BRi0X7B_.mjs";
 import { ifDefined } from "@prisma-next/utils/defined";
 
 //#region src/dag.ts

package/dist/exports/io.d.mts

@@ -1,12 +1,24 @@
-import { l as MigrationManifest, r as BaseMigrationBundle, u as MigrationOps } from "../types-DXjq7Fum.mjs";
+import { l as MigrationManifest, r as BaseMigrationBundle, u as MigrationOps } from "../types-D2uX4ql7.mjs";
 
 //#region src/io.d.ts
 declare function writeMigrationPackage(dir: string, manifest: MigrationManifest, ops: MigrationOps): Promise<void>;
+/**
+ * Copy the destination contract artifacts (`contract.json` and the
+ * colocated `contract.d.ts`) into the migration package directory so
+ * authors of the scaffolded `migration.ts` can import the typed
+ * contract relative to the migration directory
+ * (`import type { Contract } from './contract'`).
+ *
+ * A missing `.d.ts` is tolerated (only the `.json` is required) so the
+ * helper stays usable in tests that hand-roll a bare `contract.json`.
+ * A missing `contract.json` — or any other I/O failure — throws.
+ */
+declare function copyContractToMigrationDir(packageDir: string, contractJsonPath: string): Promise<void>;
 declare function writeMigrationManifest(dir: string, manifest: MigrationManifest): Promise<void>;
 declare function writeMigrationOps(dir: string, ops: MigrationOps): Promise<void>;
 declare function readMigrationPackage(dir: string): Promise<BaseMigrationBundle>;
 declare function readMigrationsDir(migrationsRoot: string): Promise<readonly BaseMigrationBundle[]>;
 declare function formatMigrationDirName(timestamp: Date, slug: string): string;
 //#endregion
-export { formatMigrationDirName, readMigrationPackage, readMigrationsDir, writeMigrationManifest, writeMigrationOps, writeMigrationPackage };
+export { copyContractToMigrationDir, formatMigrationDirName, readMigrationPackage, readMigrationsDir, writeMigrationManifest, writeMigrationOps, writeMigrationPackage };
 //# sourceMappingURL=io.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"io.d.mts","names":[],"sources":["../../src/io.ts"],"sourcesContent":[],"mappings":";;;iBAwDsB,qBAAA,wBAEV,wBACL,eACJ;iBAgBmB,sBAAA,wBAEV,oBACT;AAvBmB,iBA2BA,iBAAA,CA3BqB,GAAA,EAAA,MAAA,EAAA,GAAA,EA2Be,YA3Bf,CAAA,EA2B8B,OA3B9B,CAAA,IAAA,CAAA;AAE/B,iBA6BU,oBAAA,CA7BV,GAAA,EAAA,MAAA,CAAA,EA6B6C,OA7B7C,CA6BqD,mBA7BrD,CAAA;AACL,iBA8Fe,iBAAA,CA9Ff,cAAA,EAAA,MAAA,CAAA,EAgGJ,OAhGI,CAAA,SAgGa,mBAhGb,EAAA,CAAA;AACJ,iBA8Ha,sBAAA,CA9Hb,SAAA,EA8H+C,IA9H/C,EAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA"}
+{"version":3,"file":"io.d.mts","names":[],"sources":["../../src/io.ts"],"sourcesContent":[],"mappings":";;;iBAwDsB,qBAAA,wBAEV,wBACL,eACJ;;AAJH;;;;;AA+BA;AAcA;AAOA;AAIA;AAkEA;AAiCgB,iBA5HM,0BAAA,CA4HgC,UAAA,EAAA,MAAA,EAAA,gBAAA,EAAA,MAAA,CAAA,EAzHnD,OAyHmD,CAAA,IAAA,CAAA;iBA9GhC,sBAAA,wBAEV,oBACT;iBAImB,iBAAA,mBAAoC,eAAe;iBAInD,oBAAA,eAAmC,QAAQ;iBAkE3C,iBAAA,0BAEnB,iBAAiB;iBA+BJ,sBAAA,YAAkC"}

package/dist/exports/io.mjs

@@ -1,3 +1,3 @@
-import { a as writeMigrationOps, i as writeMigrationManifest, n as readMigrationPackage, o as writeMigrationPackage, r as readMigrationsDir, t as formatMigrationDirName } from "../io-BO18-Evu.mjs";
+import { a as writeMigrationManifest, i as readMigrationsDir, n as formatMigrationDirName, o as writeMigrationOps, r as readMigrationPackage, s as writeMigrationPackage, t as copyContractToMigrationDir } from "../io-Cun81AIZ.mjs";
 
-export { formatMigrationDirName, readMigrationPackage, readMigrationsDir, writeMigrationManifest, writeMigrationOps, writeMigrationPackage };
+export { copyContractToMigrationDir, formatMigrationDirName, readMigrationPackage, readMigrationsDir, writeMigrationManifest, writeMigrationOps, writeMigrationPackage };

package/dist/exports/migration-ts.d.mts

@@ -1,34 +1,43 @@
-import { OperationDescriptor } from "@prisma-next/framework-components/control";
-
 //#region src/migration-ts.d.ts
-
 /**
- * Options for scaffolding a migration.ts file.
+ * Utilities for reading/writing `migration.ts` files.
+ *
+ * Rendering migration.ts source is now the target's responsibility — the CLI
+ * obtains source strings either from a class-flow planner's
+ * `plan.renderTypeScript()` or from a descriptor-flow target's
+ * `migrations.renderDescriptorTypeScript(descriptors, context)`. The helper
+ * here is limited to file I/O: writing the returned source with the right
+ * executable bit, probing for existence, and evaluating legacy descriptor-
+ * flow files.
  */
-interface ScaffoldOptions {
-  /** Operation descriptors to serialize as builder calls. */
-  readonly descriptors?: readonly OperationDescriptor[];
-  /** Absolute path to contract.json — used to derive contract.d.ts import for typed builders. */
-  readonly contractJsonPath?: string;
-}
 /**
- * Scaffolds a migration.ts file in the given package directory.
- * Serializes operation descriptors as builder calls that the user can edit.
- * On emit, this file is re-evaluated to produce the final ops.
+ * Writes a pre-rendered `migration.ts` source string to the given package
+ * directory. If the source begins with a shebang, the file is written with
+ * executable permissions (0o755) so it can be run directly via
+ * `./migration.ts` by the authoring class's `Migration.run(...)` guard.
  */
-declare function scaffoldMigrationTs(packageDir: string, options?: ScaffoldOptions): Promise<void>;
+declare function writeMigrationTs(packageDir: string, content: string): Promise<void>;
 /**
  * Checks whether a migration.ts file exists in the package directory.
  */
 declare function hasMigrationTs(packageDir: string): Promise<boolean>;
 /**
- * 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).
+ * Evaluates a descriptor-flow 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).
+ *
+ * Class-flow migration.ts files use a different shape — their default
+ * export is a class that extends `Migration` — and are evaluated by the
+ * target's `emit` capability, not this helper.
  *
  * Requires Node ≥24 for native TypeScript support.
  */
 declare function evaluateMigrationTs(packageDir: string): Promise<readonly unknown[]>;
 //#endregion
-export { type ScaffoldOptions, evaluateMigrationTs, hasMigrationTs, scaffoldMigrationTs };
+//#region src/runtime-detection.d.ts
+type ScaffoldRuntime = 'node' | 'bun' | 'deno';
+declare function detectScaffoldRuntime(): ScaffoldRuntime;
+declare function shebangLineFor(runtime: ScaffoldRuntime): string;
+//#endregion
+export { type ScaffoldRuntime, detectScaffoldRuntime, evaluateMigrationTs, hasMigrationTs, shebangLineFor, writeMigrationTs };
 //# sourceMappingURL=migration-ts.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-ts.d.mts","names":[],"sources":["../../src/migration-ts.ts"],"sourcesContent":[],"mappings":";;;;;;;UAmBiB,eAAA;;kCAEiB;;;;;;;;;iBAsFZ,mBAAA,+BAEX,kBACR;;;;iBA6CmB,cAAA,sBAAoC;;;;;;;;iBAgBpC,mBAAA,sBAAyC"}
+{"version":3,"file":"migration-ts.d.mts","names":[],"sources":["../../src/migration-ts.ts","../../src/runtime-detection.ts"],"sourcesContent":[],"mappings":";;AAuBA;AAYA;AAoBA;;;;ACvDA;AAEA;AAMA;;;;;;;;iBDesB,gBAAA,uCAAuD;;;;iBAYvD,cAAA,sBAAoC;;;;;;;;;;;;iBAoBpC,mBAAA,sBAAyC;;;KCvDnD,eAAA;ADuBU,iBCrBN,qBAAA,CAAA,CDqBoE,ECrB3C,eDqB2C;AAY9D,iBC3BN,cAAA,CD2B0C,OAAO,EC3BzB,eD2ByB,CAAA,EAAA,MAAA"}

package/dist/exports/migration-ts.mjs

@@ -1,93 +1,28 @@
 import { stat, writeFile } from "node:fs/promises";
-import { join, relative, resolve } from "pathe";
+import { join, resolve } from "pathe";
 
 //#region src/migration-ts.ts
 /**
-* Utilities for scaffolding and evaluating migration.ts files.
+* Utilities for reading/writing `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 emit (evaluate).
+* Rendering migration.ts source is now the target's responsibility — the CLI
+* obtains source strings either from a class-flow planner's
+* `plan.renderTypeScript()` or from a descriptor-flow target's
+* `migrations.renderDescriptorTypeScript(descriptors, context)`. The helper
+* here is limited to file I/O: writing the returned source with the right
+* executable bit, probing for existence, and evaluating legacy descriptor-
+* flow files.
 */
 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 emit, this file is re-evaluated to produce the final ops.
+* Writes a pre-rendered `migration.ts` source string to the given package
+* directory. If the source begins with a shebang, the file is written with
+* executable permissions (0o755) so it can be run directly via
+* `./migration.ts` by the authoring class's `Migration.run(...)` guard.
 */
-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"));
+async function writeMigrationTs(packageDir, content) {
+	const isExecutable = content.startsWith("#!");
+	await writeFile(join(packageDir, MIGRATION_TS_FILE), content, isExecutable ? { mode: 493 } : void 0);
 }
 /**
 * Checks whether a migration.ts file exists in the package directory.
@@ -100,9 +35,13 @@ async function hasMigrationTs(packageDir) {
 	}
 }
 /**
-* 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).
+* Evaluates a descriptor-flow 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).
+*
+* Class-flow migration.ts files use a different shape — their default
+* export is a class that extends `Migration` — and are evaluated by the
+* target's `emit` capability, not this helper.
 *
 * Requires Node ≥24 for native TypeScript support.
 */
@@ -121,5 +60,20 @@ async function evaluateMigrationTs(packageDir) {
 }
 
 //#endregion
-export { evaluateMigrationTs, hasMigrationTs, scaffoldMigrationTs };
+//#region src/runtime-detection.ts
+function detectScaffoldRuntime() {
+	if (typeof globalThis.Bun !== "undefined") return "bun";
+	if (typeof globalThis.Deno !== "undefined") return "deno";
+	return "node";
+}
+function shebangLineFor(runtime) {
+	switch (runtime) {
+		case "bun": return "#!/usr/bin/env -S bun";
+		case "deno": return "#!/usr/bin/env -S deno run -A";
+		case "node": return "#!/usr/bin/env -S node";
+	}
+}
+
+//#endregion
+export { detectScaffoldRuntime, evaluateMigrationTs, hasMigrationTs, shebangLineFor, writeMigrationTs };
 //# sourceMappingURL=migration-ts.mjs.map

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

@@ -1 +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 emit (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 emit, 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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"}
+{"version":3,"file":"migration-ts.mjs","names":["result: unknown"],"sources":["../../src/migration-ts.ts","../../src/runtime-detection.ts"],"sourcesContent":["/**\n * Utilities for reading/writing `migration.ts` files.\n *\n * Rendering migration.ts source is now the target's responsibility — the CLI\n * obtains source strings either from a class-flow planner's\n * `plan.renderTypeScript()` or from a descriptor-flow target's\n * `migrations.renderDescriptorTypeScript(descriptors, context)`. The helper\n * here is limited to file I/O: writing the returned source with the right\n * executable bit, probing for existence, and evaluating legacy descriptor-\n * flow files.\n */\n\nimport { stat, writeFile } from 'node:fs/promises';\nimport { join, resolve } from 'pathe';\n\nconst MIGRATION_TS_FILE = 'migration.ts';\n\n/**\n * Writes a pre-rendered `migration.ts` source string to the given package\n * directory. If the source begins with a shebang, the file is written with\n * executable permissions (0o755) so it can be run directly via\n * `./migration.ts` by the authoring class's `Migration.run(...)` guard.\n */\nexport async function writeMigrationTs(packageDir: string, content: string): Promise<void> {\n  const isExecutable = content.startsWith('#!');\n  await writeFile(\n    join(packageDir, MIGRATION_TS_FILE),\n    content,\n    isExecutable ? { mode: 0o755 } : undefined,\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 descriptor-flow migration.ts file by loading it via native\n * Node import. Returns the result of calling the default export (expected\n * to be a function returning an array of operation descriptors).\n *\n * Class-flow migration.ts files use a different shape — their default\n * export is a class that extends `Migration` — and are evaluated by the\n * target's `emit` capability, not this helper.\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  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","export type ScaffoldRuntime = 'node' | 'bun' | 'deno';\n\nexport function detectScaffoldRuntime(): ScaffoldRuntime {\n  if (typeof (globalThis as { Bun?: unknown }).Bun !== 'undefined') return 'bun';\n  if (typeof (globalThis as { Deno?: unknown }).Deno !== 'undefined') return 'deno';\n  return 'node';\n}\n\nexport function shebangLineFor(runtime: ScaffoldRuntime): string {\n  switch (runtime) {\n    case 'bun':\n      return '#!/usr/bin/env -S bun';\n    case 'deno':\n      return '#!/usr/bin/env -S deno run -A';\n    case 'node':\n      return '#!/usr/bin/env -S node';\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,oBAAoB;;;;;;;AAQ1B,eAAsB,iBAAiB,YAAoB,SAAgC;CACzF,MAAM,eAAe,QAAQ,WAAW,KAAK;AAC7C,OAAM,UACJ,KAAK,YAAY,kBAAkB,EACnC,SACA,eAAe,EAAE,MAAM,KAAO,GAAG,OAClC;;;;;AAMH,eAAsB,eAAe,YAAsC;AACzE,KAAI;AAEF,UADU,MAAM,KAAK,KAAK,YAAY,kBAAkB,CAAC,EAChD,QAAQ;SACX;AACN,SAAO;;;;;;;;;;;;;;AAeX,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;;CAG5D,MAAM,MAAO,MAAM,OAAO;AAE1B,KAAI,OAAO,IAAI,YAAY,WACzB,OAAM,IAAI,MACR,iFAAiF,OAAO,IAAI,UAC7F;CAGH,MAAMA,SAAkB,IAAI,SAAS;AAErC,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MACR,wEAAwE,OAAO,SAChF;AAGH,QAAO;;;;;AC9ET,SAAgB,wBAAyC;AACvD,KAAI,OAAQ,WAAiC,QAAQ,YAAa,QAAO;AACzE,KAAI,OAAQ,WAAkC,SAAS,YAAa,QAAO;AAC3E,QAAO;;AAGT,SAAgB,eAAe,SAAkC;AAC/D,SAAQ,SAAR;EACE,KAAK,MACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,OACH,QAAO"}

package/dist/exports/migration.d.mts

@@ -1,3 +1,5 @@
+import { MigrationPlan, MigrationPlanOperation } from "@prisma-next/framework-components/control";
+
 //#region src/migration-base.d.ts
 interface MigrationMeta {
   readonly from: string;
@@ -5,14 +7,41 @@ interface MigrationMeta {
   readonly kind?: 'regular' | 'baseline';
   readonly labels?: readonly string[];
 }
-declare abstract class Migration<TOperation = unknown> {
-  abstract plan(): TOperation[];
-  describe(): MigrationMeta | undefined;
+/**
+ * Base class for class-flow migrations.
+ *
+ * A `Migration` subclass is itself a `MigrationPlan`: CLI commands and the
+ * runner can consume it directly via `targetId`, `operations`, `origin`, and
+ * `destination`. The manifest-shaped inputs come from `describe()`, which
+ * every migration must implement — `migration.json` is required for a
+ * migration to be valid.
+ */
+declare abstract class Migration<TOperation extends MigrationPlanOperation = MigrationPlanOperation> implements MigrationPlan {
+  abstract readonly targetId: string;
+  /**
+   * Ordered list of operations this migration performs.
+   *
+   * Implemented as a getter so that subclasses can either precompute the list
+   * in their constructor or build it lazily per access.
+   */
+  abstract get operations(): readonly TOperation[];
+  /**
+   * Metadata inputs used to build `migration.json` and to derive the plan's
+   * origin/destination identities. Every migration must provide this —
+   * omitting it would produce an invalid on-disk migration package.
+   */
+  abstract describe(): MigrationMeta;
+  get origin(): {
+    readonly storageHash: string;
+  } | null;
+  get destination(): {
+    readonly storageHash: string;
+  };
   /**
    * 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
+   * detects whether the file is being run directly (e.g. `node migration.ts`)
+   * and if so, serializes the migration plan to `ops.json` and
+   * `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):

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

@@ -1 +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"}
+{"version":3,"file":"migration.d.mts","names":[],"sources":["../../src/migration-base.ts"],"sourcesContent":[],"mappings":";;;UAaiB,aAAA;;EAAA,SAAA,EAAA,EAAA,MAAa;EAuBR,SAAA,IAAS,CAAA,EAAA,SAAA,GAAA,UAAA;EAAoB,SAAA,MAAA,CAAA,EAAA,SAAA,MAAA,EAAA;;;;;;;;;;;uBAA7B,6BAA6B,yBAAyB,mCAC/D;;;;;;;;sCAUyB;;;;;;uBAOf;;;;;;;;;;;;;;;;;;;;8DA4BuC"}