@voltro/database 0.86.0 → 0.88.0

package/dist/migrations/boot.js

@@ -13,7 +13,7 @@ import { verifySqliteDecimalStorage as g } from "./sqliteDecimalBoot.js";
 import { describesSchema as _ } from "./ledgerRows.js";
 import { convergeUndeclaredCharset as v, describeUndeclaredCharsetWork as y, isUndeclaredCharsetWorkEmpty as b, readUndeclaredCharsetColumns as x, undeclaredCharsetWork as S } from "./undeclaredCharset.js";
 import { Effect as C } from "effect";
-//#region src/migrations/boot.ts
+// src/migrations/boot.ts
 var w = (e) => e.operations.filter((e) => e.blocked).map((e) => `  - ${e.op.kind} ${"table" in e.op ? `[${e.op.table}]` : ""}: ${e.reason ?? "<no reason>"}\n    fix: ${e.blocked?.fix ?? "<no fix>"}`).join("\n"), T = (e) => e`
     SELECT fingerprint
     FROM _voltro_migration_plans
@@ -170,7 +170,7 @@ var w = (e) => e.operations.filter((e) => e.blocked).map((e) => `  - ${e.op.kind
 		case "up-to-date": return `auto-migrate: schema up to date (${t}, fingerprint=${o(e.fingerprint)})`;
 		case "applied": {
 			let t = e.plan.summary;
-			return `auto-migrate: applied ${e.applied.appliedOps} op(s) in ${e.applied.durationMs}ms [safe=${t.safe} needs-default=${t.needsDefault} needs-backfill=${t.needsBackfill} rename=${t.needsRenameAnnotation} lossy=${t.lossy}] fingerprint=${o(e.applied.fingerprint)}`;
+			return `auto-migrate: applied ${e.applied.appliedOps} op(s) in ${e.applied.durationMs}ms [safe=${t.safe} needs-default=${t.needsDefault} needs-backfill=${t.needsBackfill} rename=${t.needsRenameAnnotation} lossy=${t.lossy}] fingerprint=${o(e.applied.fingerprint)} (planner pass; excludes framework bootstrap and file migrations)`;
 		}
 		case "prod-mismatch": return `auto-migrate: SCHEMA FINGERPRINT MISMATCH — declared=${o(e.expected)}` + (e.actual ? ` live=${o(e.actual)}` : " live=<no _voltro_migration_plans row>") + ". Run `voltro db apply --plan plan.json` from the deploy pipeline before serving.";
 		case "refused-blocked": {
@@ -192,5 +192,4 @@ var w = (e) => e.operations.filter((e) => e.blocked).map((e) => `  - ${e.op.kind
 		}
 	}
 };
-//#endregion
 export { R as describeOutcome, M as destructiveScope, T as fetchLastFingerprint, j as ignoreTablesFromEnv, E as recordUpToDate, L as runPlannedMigrations, P as unblockLossy };

package/dist/migrations/branchRehearsal.js

@@ -1,5 +1,5 @@
 import { unblockLossy as e } from "./boot.js";
-//#region src/migrations/branchRehearsal.ts
+// src/migrations/branchRehearsal.ts
 var t = (e) => {
 	let t = e.table;
 	if (typeof t == "string") return t;
@@ -118,5 +118,4 @@ var t = (e) => {
 	}
 	return t.push(e.tornDown ? `  branch ${e.branchId} torn down.` : `  branch ${e.branchId} KEPT — drop it when you are done.`), t.join("\n");
 };
-//#endregion
 export { a as branchRehearsalExitCode, s as formatBranchRehearsal, i as rehearseMigrationOnBranch, n as rehearsedOperation };

package/dist/migrations/columnEquivalence.js

@@ -2,7 +2,7 @@ import { indexStorageShape as e } from "../indexStorage.js";
 import { mssqlTextStorageLength as t } from "../mssqlTextStorage.js";
 import { sqlType as n } from "../migrate.js";
 import { normalizeIndexPredicate as r } from "./indexPredicate.js";
-//#region src/migrations/columnEquivalence.ts
+// src/migrations/columnEquivalence.ts
 var i = (e, t) => t.name === "id" && e.primaryKey?.length === 1 && e.primaryKey[0] === "id", a = /* @__PURE__ */ new Set(["integer", "bigint"]), o = (e) => a.has(e) ? "numeric" : "text", s = (e) => e.idScheme?.kind === "numeric" ? "numeric" : "text", c = (e) => e.idStorage ?? (b(e) ? "numeric" : "text"), l = (e) => e.idScheme ? s(e) : c(e), u = (e) => e.type === "text" || e.type === "id" && l(e) === "text", d = (e, t) => t && (e.type === "text" || e.type === "id") ? {
 	...e,
 	type: "id",
@@ -81,5 +81,4 @@ var i = (e, t) => t.name === "id" && e.primaryKey?.length === 1 && e.primaryKey[
 		return;
 	}
 };
-//#endregion
 export { d as canonicalIdColumn, _ as canonicalJson, y as comparableDefault, g as comparableIndex, m as comparableSpatial, s as declaredIdStorage, p as hasComparableType, o as idStorageOfType, b as isPgSequenceDefault, i as isSolePrimaryKeyId, u as isTextStorage, c as liveIdStorage, x as normRef, v as normalizeDefault, S as renderedTextWidth, l as resolvedIdStorage, f as sameIdSpelling, h as sameSpatial };

package/dist/migrations/ddlError.js

@@ -1,4 +1,4 @@
-//#region src/migrations/ddlError.ts
+// src/migrations/ddlError.ts
 var e = [
 	"sqlMessage",
 	"code",
@@ -59,5 +59,4 @@ var e = [
 	let u = r(c("code"));
 	return u !== void 0 && l.push("", u), l.push(""), l.join("\n");
 }, r = (e) => e === "3F000" ? "remedy: the connection's search_path names a schema that does not exist. Voltro sets it from DB_SCHEMA — create the schema (`CREATE SCHEMA \"<name>\"`) or unset DB_SCHEMA to use the connection default. Voltro creates TABLES, never the schema itself: that is a namespace decision, and inventing one from a typo is how a migration lands somewhere nobody is looking." : void 0;
-//#endregion
 export { n as formatDdlError };

package/dist/migrations/ddlStatements.js

@@ -0,0 +1,8 @@
+import { splitStatements as e } from "../migrate.js";
+// src/migrations/ddlStatements.ts
+var t = (t, n) => {
+	if (t !== "postgres") return [n];
+	let r = e(n);
+	return r.length <= 1 ? [n] : r;
+};
+export { t as ddlStatementsFor };

package/dist/migrations/declaredSchema.js

@@ -6,7 +6,7 @@ import { indexKindForDialect as a, indexStorageShape as o, resolveHnswOptions as
 import { lowerUniqueActive as c } from "./uniqueActiveLowering.js";
 import { renderedTextWidth as l } from "./columnEquivalence.js";
 import { stampDeclaredCharset as u } from "./storeCharset.js";
-//#region src/migrations/declaredSchema.ts
+// src/migrations/declaredSchema.ts
 var d = (e, i, a) => {
 	let o = i.references ? {
 		table: i.references().tableName,
@@ -141,7 +141,7 @@ var d = (e, i, a) => {
 	return {
 		...e,
 		columns: e.columns.map((e) => {
-			if (n === "mssql" && !e.generatedAs && (e.type === "json" || e.type === "array") && (e = {
+			if (n !== "mssql" || e.generatedAs || e.type !== "json" && e.type !== "array" || (e = {
 				...e,
 				jsonValidation: e.type === "json" ? "value" : "container"
 			}), t(n)) {
@@ -158,5 +158,4 @@ var d = (e, i, a) => {
 		})
 	};
 };
-//#endregion
 export { h as declaredSnapshot, d as snapshotColumn };

package/dist/migrations/deployLedger.js

@@ -1,7 +1,7 @@
 import { id as e, text as t } from "../columns.js";
 import { table as n } from "../table.js";
 import { Effect as r } from "effect";
-//#region src/migrations/deployLedger.ts
+// src/migrations/deployLedger.ts
 var i = "_voltro_deploys", a = n(i, {
 	id: e({ prefix: "dpl" }),
 	status: t(),
@@ -15,5 +15,4 @@ var i = "_voltro_deploys", a = n(i, {
 	...e,
 	startedAt: String(e.startedAt)
 }))), r.catch(() => r.succeed([])));
-//#endregion
 export { i as DEPLOY_LEDGER_TABLE, a as _voltroDeploysTable, s as closeDeploy, c as failDeploy, o as openDeploy, l as unfinishedDeploys };

package/dist/migrations/fileBased.js

@@ -1,5 +1,5 @@
 import { Effect as e } from "effect";
-//#region src/migrations/fileBased.ts
+// src/migrations/fileBased.ts
 var t = ["before-schema", "after-schema"], n = (e) => {
 	if (!e.id || e.id.length === 0) throw Error("migration: `id` is required + must be non-empty");
 	if (!e.up || !e.down) throw Error(`migration ${e.id}: both \`up\` and \`down\` must be functions`);
@@ -53,5 +53,4 @@ var t = ["before-schema", "after-schema"], n = (e) => {
 		super(`rewrite of ${e} did not stabilise after ${t.passes} pass(es): ${t.rewritten} rewritten, ${t.contended} contended on the last pass. Check for concurrent writes and guard values that cannot round-trip exactly before raising maxPasses.`), this.table = e, this.report = t, this.name = "RewriteUnstableError";
 	}
 }, f = /^\d{8}_\d{6}_[a-z0-9_]+\.ts$/, p = (e) => typeof e == "object" && !!e && "id" in e && "up" in e && "down" in e && typeof e.id == "string" && typeof e.up == "function" && typeof e.down == "function";
-//#endregion
 export { f as FILE_MIGRATION_PATTERN, i as IrreversibleMigrationError, t as MIGRATION_PHASES, c as MigrationExpectationFailed, u as MigrationNeedsSqlClient, s as MigrationSkipped, d as RewriteUnstableError, l as TransactionBrokenByBodyError, a as irreversible, o as irreversibleReason, p as isFileMigration, n as migration };

package/dist/migrations/fileContext.js

@@ -12,7 +12,7 @@ import { introspectSchema as h } from "./introspect.js";
 import { runMigrationOp as g, runSchemaOp as _ } from "./applier.js";
 import { unblockLossy as v } from "./boot.js";
 import { Effect as y } from "effect";
-//#region src/migrations/fileContext.ts
+// src/migrations/fileContext.ts
 var b = (t) => typeof t.__definition == "function" ? e({ c: t }).c : t, x = (e) => {
 	if (typeof e != "string") return e;
 	let t = e.trim().replace(/::[a-zA-Z0-9_ "]+$/, "").trim();
@@ -478,5 +478,4 @@ var b = (t) => typeof t.__definition == "function" ? e({ c: t }).c : t, x = (e)
 	for (let { description: n, check: r } of e) (yield* j(r())) || t.push(n);
 	return t;
 });
-//#endregion
 export { U as failedExpectations, H as makeFileMigrationContext, C as materialiseSnapshot };

package/dist/migrations/fileDiscovery.js

@@ -1,22 +1,23 @@
 import { causeBranches as e, classifyConstraintViolation as t, extractDbCause as n } from "../dbCause.js";
-import { FILE_MIGRATION_PATTERN as r, IrreversibleMigrationError as i, MigrationExpectationFailed as a, MigrationSkipped as o, TransactionBrokenByBodyError as s, irreversibleReason as c, isFileMigration as l } from "./fileBased.js";
-import { acquireMigrationLock as u } from "./lock.js";
-import { MIGRATION_OPS_TABLE as d, dialectOf as f } from "./resumeLedger.js";
-import { migrationTableExists as p } from "./migrationTableExists.js";
-import { appliedAtValue as m } from "./appliedAtValue.js";
-import { ensureLedgerTable as h, ensurePlanLedgerTable as g } from "./applier.js";
-import { isFileMigrationRow as _ } from "./ledgerRows.js";
-import { failedExpectations as v, makeFileMigrationContext as y } from "./fileContext.js";
-import { withSchemaProbeRecorder as b } from "./fileSkipProbes.js";
-import { Effect as x } from "effect";
-import { createHash as S } from "node:crypto";
-import { SqlClient as C } from "effect/sql";
-import { createLogger as w } from "@voltro/logger";
-import { promises as T } from "node:fs";
-import { join as E } from "node:path";
-import { pathToFileURL as D } from "node:url";
-//#region src/migrations/fileDiscovery.ts
-var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest("hex").slice(0, 16), A = [{
+import { derivedRowId as r } from "../derivedRowId.js";
+import { FILE_MIGRATION_PATTERN as i, IrreversibleMigrationError as a, MigrationExpectationFailed as o, MigrationSkipped as s, TransactionBrokenByBodyError as c, irreversibleReason as l, isFileMigration as u } from "./fileBased.js";
+import { acquireMigrationLock as d } from "./lock.js";
+import { MIGRATION_OPS_TABLE as f, dialectOf as p } from "./resumeLedger.js";
+import { migrationTableExists as m } from "./migrationTableExists.js";
+import { appliedAtValue as h } from "./appliedAtValue.js";
+import { ensureLedgerTable as g, ensurePlanLedgerTable as _ } from "./applier.js";
+import { isFileMigrationRow as v } from "./ledgerRows.js";
+import { failedExpectations as y, makeFileMigrationContext as b } from "./fileContext.js";
+import { withSchemaProbeRecorder as x } from "./fileSkipProbes.js";
+import { Effect as S } from "effect";
+import { createHash as C } from "node:crypto";
+import { SqlClient as w } from "effect/sql";
+import { createLogger as T } from "@voltro/logger";
+import { promises as E } from "node:fs";
+import { join as D } from "node:path";
+import { pathToFileURL as O } from "node:url";
+// src/migrations/fileDiscovery.ts
+var k = T({ scope: "voltro:migrate" }), A = (e) => C("sha256").update(e).digest("hex").slice(0, 16), j = [{
 	codemod: "0.78.0/01_file-migration-phase",
 	inverse: (e) => {
 		let t = /\n {2}phase: 'before-schema',\n {2}/g, n = /\n {2}phase: 'before-schema'(?=\r?\n[ \t]*\})/g, r = e.includes("\r\n") ? "\r\n" : "\n", i = (t) => {
@@ -25,7 +26,7 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 		};
 		return [e.replace(t, (e, t) => r + i(t)).replace(n, ""), e.replace(t, " ").replace(n, "")];
 	}
-}], j = (e) => new Set([e, ...A.flatMap((t) => t.inverse(e))].map(k)), M = /* @__PURE__ */ new Set([
+}], M = (e) => new Set([e, ...j.flatMap((t) => t.inverse(e))].map(A)), N = /* @__PURE__ */ new Set([
 	"node_modules",
 	"dist",
 	"build",
@@ -34,56 +35,67 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 	".next",
 	".git",
 	".framework"
-]), N = async (e) => {
+]), P = async (e) => {
 	let t = [], n = async (e) => {
-		let i = await T.readdir(e, { withFileTypes: !0 }).catch(() => []);
-		for (let a of i) {
-			if (M.has(a.name)) continue;
-			let i = E(e, a.name);
-			a.isDirectory() ? await n(i) : a.isFile() && r.test(a.name) && t.push(i);
+		let r = await E.readdir(e, { withFileTypes: !0 }).catch(() => []);
+		for (let a of r) {
+			if (N.has(a.name)) continue;
+			let r = D(e, a.name);
+			a.isDirectory() ? await n(r) : a.isFile() && i.test(a.name) && t.push(r);
 		}
 	};
 	return await n(e), t.sort((e, t) => {
 		let n = e.split("/").pop() ?? e, r = t.split("/").pop() ?? t;
 		return n.localeCompare(r);
 	});
-}, P = async (e) => await import(D(e).href), F = async (e, t = P) => {
+}, F = async (e) => await import(O(e).href), I = async (e, t = F) => {
 	let n = [];
 	for (let r of e) {
 		let e = (await t(r)).default;
-		if (!l(e)) {
-			O.warn("migration file has no default-exported `migration(...)` — skipped", { file: r });
+		if (!u(e)) {
+			k.warn("migration file has no default-exported `migration(...)` — skipped", { file: r });
 			continue;
 		}
-		let i = await T.readFile(r, "utf8").catch(() => "");
+		let i = await E.readFile(r, "utf8").catch(() => "");
 		n.push({
 			file: r,
 			migration: e,
-			hash: k(i),
-			accepted: j(i)
+			hash: A(i),
+			accepted: M(i)
 		});
 	}
 	return n;
-}, I = "_voltro_migration_plans", L = (e) => R(e).pipe(x.map((e) => e.map((e) => e.id))), R = (e) => p(e, I).pipe(x.flatMap((t) => t ? e`
+}, L = "_voltro_migration_plans", R = (e) => z(e).pipe(S.map((e) => e.map((e) => e.id))), z = (e) => m(e, L).pipe(S.flatMap((t) => t ? e`
           SELECT ${e("id")}, ${e("fingerprint")}
-          FROM ${e(I)}
-          WHERE ${_(e)}
-        `.pipe(x.map((e) => e.map((e) => ({
+          FROM ${e(L)}
+          WHERE ${v(e)}
+        `.pipe(S.map((e) => e.map((e) => ({
 	id: e.id,
 	hash: e.fingerprint ?? ""
-})))) : x.succeed([]))), z = (e, t) => t.filter((t) => {
+})))) : S.succeed([]))), B = (e, t) => t.filter((t) => {
 	let n = e.get(t.migration.id);
 	return n !== void 0 && n !== "" && !t.accepted.has(n);
-}).map((e) => e.migration.id), B = /* @__PURE__ */ new Set(), V = (e) => t(n(e))?.kind === "unique", H = class extends Error {
+}).map((e) => e.migration.id), V = /* @__PURE__ */ new Set(), H = (e) => t(n(e))?.kind === "unique", U = class extends Error {
 	migrationId;
 	file;
 	cause;
 	_tag = "FileMigrationLedgerError";
 	constructor(e, t, n) {
-		super(V(n) ? `migration ${e}: up() SUCCEEDED here, and ANOTHER process had already recorded the same migration.\n  The body has run TWICE. The ledger row is correct — do not delete it; the next run will not apply ${t} again.\n  Two processes applied it without being serialised by the migration lock: check that both reach the same database and lock schema.\n  Cause: ${n instanceof Error ? n.message : String(n)}` : `migration ${e}: up() SUCCEEDED but the ledger row could not be written.\n  The change IS in the database. It is NOT recorded, so the next run would apply it AGAIN.\n  Do not re-run ${t} until this is resolved.\n  Cause: ${n instanceof Error ? n.message : String(n)}`), this.migrationId = e, this.file = t, this.cause = n, this.name = "FileMigrationLedgerError";
+		super(H(n) ? `migration ${e}: up() SUCCEEDED here, and ANOTHER process had already recorded the same migration.\n  The body has run TWICE. The ledger row is correct — do not delete it; the next run will not apply ${t} again.\n  Two processes applied it without being serialised by the migration lock: check that both reach the same database and lock schema.\n  Cause: ${n instanceof Error ? n.message : String(n)}` : `migration ${e}: up() SUCCEEDED but the ledger row could not be written.\n  The change IS in the database. It is NOT recorded, so the next run would apply it AGAIN.\n  Do not re-run ${t} until this is resolved.\n  Cause: ${n instanceof Error ? n.message : String(n)}`), this.migrationId = e, this.file = t, this.cause = n, this.name = "FileMigrationLedgerError";
 	}
-}, U = (e, t, n) => x.gen(function* () {
-	let r = yield* m(e, n.appliedAtIso);
+}, W = /* @__PURE__ */ new Set([
+	"mysql",
+	"mariadb",
+	"mssql"
+]), G = (e, t) => W.has(e) ? t.filter((e) => e.length > 64) : [], K = class extends Error {
+	dialect;
+	migrationIds;
+	_tag = "MigrationIdTooLongError";
+	constructor(e, t) {
+		super(`migration id(s) longer than 64 characters cannot be recorded on ${e}: ` + t.map((e) => `${e} (${e.length})`).join(", ") + ". Nothing was applied. Rename the migration file and its `id` to at most 64 characters."), this.dialect = e, this.migrationIds = t, this.name = "MigrationIdTooLongError";
+	}
+}, q = (e, t, n) => S.gen(function* () {
+	let r = yield* h(e, n.appliedAtIso);
 	yield* e`
       INSERT INTO ${e("_voltro_migration_plans")}
         (${e("id")}, ${e("fingerprint")}, ${e("operations")},
@@ -97,93 +109,93 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 	}])},
          ${n.appliedBy}, ${n.env}, ${"file"},
          ${n.durationMs}, ${r}, ${n.notes})
-    `.pipe(x.mapError((e) => new H(t.migration.id, t.file, e)));
-}), W = (t) => {
-	for (let n of e(t)) if (n instanceof o) return n.reason;
-}, G = (e, t, n) => x.gen(function* () {
-	let r = b(t), i = r.ctx, o = e.migration.up(i), s = !x.isEffect(o), c = yield* (x.isEffect(o) ? o : x.tryPromise({
-		try: () => o,
+    `.pipe(S.mapError((e) => new U(t.migration.id, t.file, e)));
+}), J = (t) => {
+	for (let n of e(t)) if (n instanceof s) return n.reason;
+}, Y = (e, t, n) => S.gen(function* () {
+	let r = x(t), i = r.ctx, a = e.migration.up(i), s = !S.isEffect(a), c = yield* (S.isEffect(a) ? a : S.tryPromise({
+		try: () => a,
 		catch: (e) => e
-	})).pipe(x.as(void 0), x.catch((e) => {
-		let t = W(e);
-		return t === void 0 ? x.fail(e) : x.succeed(t);
+	})).pipe(S.as(void 0), S.catch((e) => {
+		let t = J(e);
+		return t === void 0 ? S.fail(e) : S.succeed(t);
 	}));
 	if (c === void 0) {
-		let t = yield* v(n);
-		if (t.length > 0) return yield* x.fail(new a(e.migration.id, t));
+		let t = yield* y(n);
+		if (t.length > 0) return yield* S.fail(new o(e.migration.id, t));
 	}
 	return {
 		skipped: c,
 		promiseForm: s,
 		absent: r.absent()
 	};
-}), K = (e, t, n, r, i, a, o, c) => x.gen(function* () {
-	let l = Date.now(), u = (/* @__PURE__ */ new Date()).toISOString(), p = f(e), m = `migrations:file:${n.migration.id}`, g = (e) => ({
-		durationMs: Date.now() - l,
+}), X = (e, t, n, i, a, o, s, l) => S.gen(function* () {
+	let u = Date.now(), d = (/* @__PURE__ */ new Date()).toISOString(), m = p(e), h = `migrations:file:${n.migration.id}`, _ = (e) => ({
+		durationMs: Date.now() - u,
 		notes: e.skipped === void 0 ? n.migration.description : `skipped: ${e.skipped}`
 	});
-	if (n.migration.transactional !== !1 && !a) {
-		if (t.run === void 0) return yield* x.fail(/* @__PURE__ */ Error(`migration ${n.migration.id}: transactional: true needs a SQL-backed store`));
-		let a = p === "mysql" || p === "mariadb", l = `probe_${n.migration.id}_${Date.now().toString(36)}`;
-		a && (yield* h(e, p, o));
-		let f = (e) => e.executeUnprepared(`SELECT COUNT(*) AS n FROM \`${d}\` WHERE \`runId\` = ?`, [l], void 0), _ = () => (c === void 0 ? x.scoped(x.flatMap(e.reserve, f)) : f(c)).pipe(x.map((e) => Number(e[0]?.n ?? 0) > 0)), v = yield* x.tryPromise({
+	if (n.migration.transactional !== !1 && !o) {
+		if (t.run === void 0) return yield* S.fail(/* @__PURE__ */ Error(`migration ${n.migration.id}: transactional: true needs a SQL-backed store`));
+		let o = m === "mysql" || m === "mariadb", u = `probe_${n.migration.id}_${Date.now().toString(36)}`;
+		o && (yield* g(e, m, s));
+		let p = (e) => e.executeUnprepared(`SELECT COUNT(*) AS n FROM \`${f}\` WHERE \`runId\` = ?`, [u], void 0), v = () => (l === void 0 ? S.scoped(S.flatMap(e.reserve, p)) : p(l)).pipe(S.map((e) => Number(e[0]?.n ?? 0) > 0)), y = yield* S.tryPromise({
 			try: () => t.transactional(async (t) => {
-				a && await t.run(e`INSERT INTO ${e(d)} (${e("id")}, ${e("runId")}, ${e("planFingerprint")}, ${e("opIndex")}, ${e("status")}, ${e("opKind")}, ${e("opTarget")}, ${e("payload")})
-              VALUES (${`mop_${l}`}, ${l}, ${""}, ${0}, ${"pending"}, ${"probe"}, ${""}, ${"{}"})`);
-				let { ctx: o, expectations: s } = y({
+				o && await t.run(e`INSERT INTO ${e(f)} (${e("id")}, ${e("runId")}, ${e("planFingerprint")}, ${e("opIndex")}, ${e("status")}, ${e("opKind")}, ${e("opTarget")}, ${e("payload")})
+              VALUES (${r("mop", u)}, ${u}, ${""}, ${0}, ${"pending"}, ${"probe"}, ${""}, ${"{}"})`);
+				let { ctx: s, expectations: c } = b({
 					sql: e,
 					store: t,
-					dialect: p,
+					dialect: m,
 					migrationId: n.migration.id,
-					appliedAt: u
-				}), c = await t.run(G(n, o, s)), f = a && await x.runPromise(_().pipe(x.provideService(C.SqlClient, e))), { durationMs: m, notes: h } = g(c);
-				return await t.run(U(e, n, {
-					env: r,
-					appliedBy: i,
-					durationMs: m,
-					appliedAtIso: u,
-					notes: f ? `${h} — transactional guarantee broken by the body (DDL on ${p})` : h
-				})), a && await t.run(e`DELETE FROM ${e(d)} WHERE ${e("runId")} = ${l}`), {
-					...c,
-					durationMs: m,
-					broken: f
+					appliedAt: d
+				}), l = await t.run(Y(n, s, c)), p = o && await S.runPromise(v().pipe(S.provideService(w.SqlClient, e))), { durationMs: h, notes: g } = _(l);
+				return await t.run(q(e, n, {
+					env: i,
+					appliedBy: a,
+					durationMs: h,
+					appliedAtIso: d,
+					notes: p ? `${g} — transactional guarantee broken by the body (DDL on ${m})` : g
+				})), o && await t.run(e`DELETE FROM ${e(f)} WHERE ${e("runId")} = ${u}`), {
+					...l,
+					durationMs: h,
+					broken: p
 				};
 			}),
 			catch: (e) => e
 		});
-		return v.broken ? yield* x.fail(new s(n.migration.id, p)) : (v.skipped !== void 0 && (yield* x.logInfo(`migration ${n.migration.id} skipped: ${v.skipped}`).pipe(x.annotateLogs({ scope: m }))), {
-			durationMs: v.durationMs,
-			skip: v.skipped === void 0 ? void 0 : {
+		return y.broken ? yield* S.fail(new c(n.migration.id, m)) : (y.skipped !== void 0 && (yield* S.logInfo(`migration ${n.migration.id} skipped: ${y.skipped}`).pipe(S.annotateLogs({ scope: h }))), {
+			durationMs: y.durationMs,
+			skip: y.skipped === void 0 ? void 0 : {
 				id: n.migration.id,
-				reason: v.skipped,
-				absent: v.absent
+				reason: y.skipped,
+				absent: y.absent
 			}
 		});
 	}
-	let { ctx: _, expectations: v } = y({
+	let { ctx: v, expectations: y } = b({
 		sql: e,
 		store: t,
-		dialect: p,
+		dialect: m,
 		migrationId: n.migration.id,
-		appliedAt: u
-	}), b = yield* G(n, _, v), { durationMs: S, notes: w } = g(b);
-	return b.promiseForm && b.skipped === void 0 && S < 2 && (yield* x.logWarning(`migration ${n.migration.id}: up() resolved in ${S}ms — did the body \`await\` an \`effect/sql\` Effect by accident? \`sql.unsafe(...)\` returns an Effect, not a Promise; \`await\` on it is a silent no-op. Switch the body to \`Effect.gen(function* () { yield* sql.unsafe(...) })\` form.`).pipe(x.annotateLogs({ scope: m }))), b.skipped !== void 0 && (yield* x.logInfo(`migration ${n.migration.id} skipped: ${b.skipped}`).pipe(x.annotateLogs({ scope: m }))), yield* U(e, n, {
-		env: r,
-		appliedBy: i,
-		durationMs: S,
-		appliedAtIso: u,
-		notes: w
+		appliedAt: d
+	}), x = yield* Y(n, v, y), { durationMs: C, notes: T } = _(x);
+	return x.promiseForm && x.skipped === void 0 && C < 2 && (yield* S.logWarning(`migration ${n.migration.id}: up() resolved in ${C}ms — did the body \`await\` an \`effect/sql\` Effect by accident? \`sql.unsafe(...)\` returns an Effect, not a Promise; \`await\` on it is a silent no-op. Switch the body to \`Effect.gen(function* () { yield* sql.unsafe(...) })\` form.`).pipe(S.annotateLogs({ scope: h }))), x.skipped !== void 0 && (yield* S.logInfo(`migration ${n.migration.id} skipped: ${x.skipped}`).pipe(S.annotateLogs({ scope: h }))), yield* q(e, n, {
+		env: i,
+		appliedBy: a,
+		durationMs: C,
+		appliedAtIso: d,
+		notes: T
 	}), {
-		durationMs: S,
-		skip: b.skipped === void 0 ? void 0 : {
+		durationMs: C,
+		skip: x.skipped === void 0 ? void 0 : {
 			id: n.migration.id,
-			reason: b.skipped,
-			absent: b.absent
+			reason: x.skipped,
+			absent: x.absent
 		}
 	};
-}), q = (e, t, n, r) => x.gen(function* () {
-	let i = yield* x.tryPromise({
-		try: () => N(E(t, "migrations")),
+}), Z = (e, t, n, r) => S.gen(function* () {
+	let i = yield* S.tryPromise({
+		try: () => P(D(t, "migrations")),
 		catch: (e) => e
 	});
 	if (i.length === 0) return {
@@ -191,8 +203,8 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 		alreadyApplied: [],
 		drifted: []
 	};
-	let a = yield* x.tryPromise({
-		try: () => F(i, r),
+	let a = yield* S.tryPromise({
+		try: () => I(i, r),
 		catch: (e) => e
 	});
 	if (a.length === 0) return {
@@ -200,11 +212,11 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 		alreadyApplied: [],
 		drifted: []
 	};
-	let o = new Map((yield* R(e)).map((e) => [e.id, e.hash])), s = z(o, a), c = s.length >= 32 ? /* @__PURE__ */ new Map() : void 0;
+	let o = new Map((yield* z(e)).map((e) => [e.id, e.hash])), s = B(o, a), c = s.length >= 32 ? /* @__PURE__ */ new Map() : void 0;
 	if (c !== void 0) for (let e of a) c.has(e.migration.id) || c.set(e.migration.id, e);
 	for (let e of s) {
 		let t = c === void 0 ? a.find((t) => t.migration.id === e) : c.get(e), n = `${t?.file ?? e}:${t?.hash ?? ""}`;
-		B.has(n) || (B.add(n), O.warn("file migration: the body on disk is not the one that was applied — the file no longer describes this database", {
+		V.has(n) || (V.add(n), k.warn("file migration: the body on disk is not the one that was applied — the file no longer describes this database", {
 			id: e,
 			file: t?.file
 		}));
@@ -215,11 +227,11 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 		alreadyApplied: l.filter((e) => o.has(e.migration.id)),
 		drifted: s
 	};
-}), J = (e, t, n, r) => q(e, t, n, r).pipe(x.map((e) => e.pending.map((e) => e.migration.id))), Y = (e, t, n) => q(e, t, n).pipe(x.map((e) => e.pending.map((e) => ({
+}), Q = (e, t, n, r) => Z(e, t, n, r).pipe(S.map((e) => e.pending.map((e) => e.migration.id))), ee = (e, t, n) => Z(e, t, n).pipe(S.map((e) => e.pending.map((e) => ({
 	id: e.migration.id,
 	phase: e.migration.phase,
-	irreversible: c(e.migration.down)
-})))), X = (e, t) => q(e, t).pipe(x.map((e) => {
+	irreversible: l(e.migration.down)
+})))), te = (e, t) => Z(e, t).pipe(S.map((e) => {
 	let t = new Set(e.drifted);
 	return [...e.alreadyApplied.map((e) => ({
 		id: e.migration.id,
@@ -232,17 +244,19 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 		applied: !1,
 		bodyChanged: !1
 	}))].sort((e, t) => e.id < t.id ? -1 : 1);
-})), Z = (e, t) => x.gen(function* () {
-	let { pending: n, alreadyApplied: r } = yield* q(e, t.projectRoot, t.phase), i = r.map((e) => e.migration.id);
+})), ne = (e, t) => S.gen(function* () {
+	let { pending: n, alreadyApplied: r } = yield* Z(e, t.projectRoot, t.phase), i = r.map((e) => e.migration.id);
 	if (n.length === 0) return {
 		applied: [],
 		skipped: i,
 		skips: []
 	};
-	yield* g(e, f(e), t.charset);
-	let a = yield* x.acquireUseRelease(u(e, { schema: t.lockSchema }), (r) => x.gen(function* () {
-		let i = new Set((yield* R(e)).map((e) => e.id)), a = n.filter((e) => !i.has(e.migration.id));
-		a.length < n.length && (yield* x.logInfo("file-based migrations applied by another process while this one waited for the migration lock").pipe(x.annotateLogs({
+	let a = G(p(e), n.map((e) => e.migration.id));
+	if (a.length > 0) return yield* S.fail(new K(p(e), a));
+	yield* _(e, p(e), t.charset);
+	let o = yield* S.acquireUseRelease(d(e, { schema: t.lockSchema }), (r) => S.gen(function* () {
+		let i = new Set((yield* z(e)).map((e) => e.id)), a = n.filter((e) => !i.has(e.migration.id));
+		a.length < n.length && (yield* S.logInfo("file-based migrations applied by another process while this one waited for the migration lock").pipe(S.annotateLogs({
 			scope: "voltro:migrate",
 			ids: n.filter((e) => i.has(e.migration.id)).map((e) => e.migration.id).join(",")
 		})));
@@ -250,17 +264,17 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 		a.length > 0 && t.beforeExecute !== void 0 && (yield* t.beforeExecute);
 		let s = [];
 		for (let n of a) {
-			yield* x.logInfo("file-based migration applying").pipe(x.annotateLogs({
+			yield* S.logInfo("file-based migration applying").pipe(S.annotateLogs({
 				scope: "voltro:migrate",
 				id: n.migration.id,
 				file: n.file,
 				phase: n.migration.phase
 			}));
-			let { durationMs: i, skip: a } = yield* K(e, t.store, n, t.env, t.appliedBy, t.enclosed === !0, t.charset, r.connection);
+			let { durationMs: i, skip: a } = yield* X(e, t.store, n, t.env, t.appliedBy, t.enclosed === !0, t.charset, r.connection);
 			o.push({
 				id: n.migration.id,
 				durationMs: i
-			}), a !== void 0 && s.push(a), yield* x.logInfo("file-based migration applied").pipe(x.annotateLogs({
+			}), a !== void 0 && s.push(a), yield* S.logInfo("file-based migration applied").pipe(S.annotateLogs({
 				scope: "voltro:migrate",
 				id: n.migration.id,
 				durationMs: i,
@@ -271,39 +285,39 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 			done: o,
 			skips: s
 		};
-	}), (e) => e.release.pipe(x.orDie));
+	}), (e) => e.release.pipe(S.orDie));
 	return {
-		applied: a.done,
+		applied: o.done,
 		skipped: i,
-		skips: a.skips
+		skips: o.skips
 	};
-}), Q = (e, t) => e`
+}), $ = (e, t) => e`
     SELECT ${e("id")}
     FROM ${e("_voltro_migration_plans")}
     WHERE ${e("id")} = ${t} AND ${e("source")} = 'file'
-  `, $ = (e, t) => x.gen(function* () {
-	if (!(yield* Q(e, t.id))[0]) return yield* x.fail(/* @__PURE__ */ Error(`rollback: ${t.id} not found in _voltro_migration_plans (file source)`));
-	let n = yield* x.tryPromise({
-		try: () => N(E(t.projectRoot, "migrations")),
+  `, re = (e, t) => S.gen(function* () {
+	if (!(yield* $(e, t.id))[0]) return yield* S.fail(/* @__PURE__ */ Error(`rollback: ${t.id} not found in _voltro_migration_plans (file source)`));
+	let n = yield* S.tryPromise({
+		try: () => P(D(t.projectRoot, "migrations")),
 		catch: (e) => e
-	}), r = (yield* x.tryPromise({
-		try: () => F(n),
+	}), r = (yield* S.tryPromise({
+		try: () => I(n),
 		catch: (e) => e
 	})).find((e) => e.migration.id === t.id);
-	if (!r) return yield* x.fail(/* @__PURE__ */ Error(`rollback: file for migration ${t.id} not found on disk under ${t.projectRoot}/migrations/`));
-	let a = c(r.migration.down);
-	return a === void 0 ? yield* x.acquireUseRelease(u(e, { schema: t.lockSchema }), () => x.gen(function* () {
-		if ((yield* Q(e, t.id))[0] === void 0) return yield* x.fail(/* @__PURE__ */ Error(`rollback: ${t.id} was rolled back by another process while this one waited for the migration lock — nothing to do`));
-		let n = Date.now(), { ctx: i } = y({
+	if (!r) return yield* S.fail(/* @__PURE__ */ Error(`rollback: file for migration ${t.id} not found on disk under ${t.projectRoot}/migrations/`));
+	let i = l(r.migration.down);
+	return i === void 0 ? yield* S.acquireUseRelease(d(e, { schema: t.lockSchema }), () => S.gen(function* () {
+		if ((yield* $(e, t.id))[0] === void 0) return yield* S.fail(/* @__PURE__ */ Error(`rollback: ${t.id} was rolled back by another process while this one waited for the migration lock — nothing to do`));
+		let n = Date.now(), { ctx: i } = b({
 			sql: e,
 			store: t.store,
-			dialect: f(e),
+			dialect: p(e),
 			migrationId: t.id,
 			appliedAt: (/* @__PURE__ */ new Date()).toISOString()
 		});
 		t.beforeExecute !== void 0 && (yield* t.beforeExecute);
 		let a = r.migration.down(i);
-		x.isEffect(a) ? yield* a : yield* x.tryPromise({
+		S.isEffect(a) ? yield* a : yield* S.tryPromise({
 			try: () => a,
 			catch: (e) => e
 		});
@@ -312,7 +326,6 @@ var O = w({ scope: "voltro:migrate" }), k = (e) => S("sha256").update(e).digest(
 			id: t.id,
 			durationMs: o
 		};
-	}), (e) => e.release.pipe(x.orDie)) : yield* x.fail(new i(t.id, a));
+	}), (e) => e.release.pipe(S.orDie)) : yield* S.fail(new a(t.id, i));
 });
-//#endregion
-export { r as FILE_MIGRATION_PATTERN, A as FRAMEWORK_MIGRATION_EDITS, H as FileMigrationLedgerError, j as acceptedBodyHashes, L as appliedFileMigrationIds, R as appliedFileMigrations, X as fileMigrationStatus, k as migrationBodyHash, J as pendingFileMigrationIds, Y as pendingFileMigrationSummary, $ as rollbackFileBasedMigration, Z as runFileBasedMigrations, N as walkMigrationFiles };
+export { i as FILE_MIGRATION_PATTERN, j as FRAMEWORK_MIGRATION_EDITS, U as FileMigrationLedgerError, K as MigrationIdTooLongError, M as acceptedBodyHashes, R as appliedFileMigrationIds, z as appliedFileMigrations, te as fileMigrationStatus, A as migrationBodyHash, Q as pendingFileMigrationIds, ee as pendingFileMigrationSummary, re as rollbackFileBasedMigration, ne as runFileBasedMigrations, G as unrecordableMigrationIds, P as walkMigrationFiles };

package/dist/migrations/fileSkipProbes.js

@@ -1,5 +1,5 @@
 import { Effect as e } from "effect";
-//#region src/migrations/fileSkipProbes.ts
+// src/migrations/fileSkipProbes.ts
 var t = (e) => e.kind === "table" ? e.table : `${e.table}.${e.name}`, n = (e, n) => e.kind === n.kind && e.table === n.table && t(e) === t(n), r = (e) => JSON.stringify([
 	e.kind,
 	e.table,
@@ -113,5 +113,4 @@ var t = (e) => e.kind === "table" ? e.table : `${e.table}.${e.name}`, n = (e, n)
 		}];
 	});
 };
-//#endregion
 export { t as describeProbe, s as permanentSkips, o as plannedCreations, a as withSchemaProbeRecorder };

package/dist/migrations/fingerprint.js

@@ -1,7 +1,7 @@
 import { isSoftDropSnapshotName as e } from "./frameworkLiveTables.js";
 import { canonicalIdColumn as t, comparableDefault as n, comparableIndex as r, comparableSpatial as i, isPgSequenceDefault as a, isSolePrimaryKeyId as o, normRef as s } from "./columnEquivalence.js";
 import { createHash as c } from "node:crypto";
-//#region src/migrations/fingerprint.ts
+// src/migrations/fingerprint.ts
 var l = (e) => {
 	if (e == null) return e;
 	if (Array.isArray(e)) return e.map(l);
@@ -42,5 +42,4 @@ var l = (e) => {
 	let t = { tables: m(e.tables) }, n = JSON.stringify(l(t));
 	return c("sha256").update(n).digest("hex");
 }, g = (e) => e.slice(0, 16);
-//#endregion
 export { h as fingerprintSchema, g as shortFingerprint };