@voltro/data-transfer 0.43.1 → 0.44.0

package/dist/index.js

@@ -2,16 +2,16 @@ import { Cause as e, Data as t, Effect as n, Exit as r, Metric as i, MetricBound
 import { classifyConstraintViolation as l, eq as u, extractDbCause as d, inSet as f, isNotNull as p, or as m, streamTable as h } from "@voltro/database";
 import { fingerprintSchema as g } from "@voltro/database/sql";
 import { createCipheriv as _, createDecipheriv as v, createHash as y, createHmac as b, randomBytes as x, scrypt as S } from "node:crypto";
-import { STORAGE_REFS_TABLE as C, fromNodeReadable as w, getObjectStream as ee, putObjectStream as te, toNodeReadable as ne } from "@voltro/plugin-storage";
-import * as T from "node:zlib";
-import { PassThrough as re, Readable as ie } from "node:stream";
-import { copyFile as ae, createReadStream as E, createWriteStream as D, existsSync as oe, unlinkSync as se } from "node:fs";
-import { mkdir as O, readdir as ce, stat as le } from "node:fs/promises";
-import { basename as ue, delimiter as de, dirname as fe, join as k, resolve as pe, sep as me } from "node:path";
-import { promisify as he } from "node:util";
-import { spawn as ge } from "node:child_process";
+import { STORAGE_REFS_TABLE as C, fromNodeReadable as w, getObjectStream as T, putObjectStream as E, toNodeReadable as D } from "@voltro/plugin-storage";
+import * as O from "node:zlib";
+import { PassThrough as k, Readable as A } from "node:stream";
+import { copyFile as ee, createReadStream as j, createWriteStream as te, existsSync as ne, unlinkSync as re } from "node:fs";
+import { mkdir as ie, readdir as ae, stat as oe } from "node:fs/promises";
+import { basename as se, delimiter as ce, dirname as le, join as M, resolve as ue, sep as de } from "node:path";
+import { promisify as fe } from "node:util";
+import { spawn as pe } from "node:child_process";
 //#region src/consistency.ts
-var _e = (e) => {
+var me = (e) => {
 	switch (e) {
 		case "postgres": return ["SET TRANSACTION ISOLATION LEVEL REPEATABLE READ"];
 		case "mysql":
@@ -21,7 +21,7 @@ var _e = (e) => {
 		case "turso": return [];
 		default: return [];
 	}
-}, ve = {
+}, he = {
 	email: { fake: "email" },
 	fullName: { fake: "fullName" },
 	firstName: { fake: "firstName" },
@@ -36,7 +36,7 @@ var _e = (e) => {
 	date: "dateShift",
 	secret: "null",
 	freeText: "redact"
-}, A = (e) => {
+}, N = (e) => {
 	let t = {};
 	for (let n of e.tables) {
 		let e = {};
@@ -48,15 +48,15 @@ var _e = (e) => {
 		t[n.name] = e;
 	}
 	return t;
-}, ye = (e, t, n, r) => {
+}, ge = (e, t, n, r) => {
 	let i = r.columns?.[`${e}.${t}`];
 	if (i) return i;
 	if (n?.sensitive) {
 		let e = n.sensitive.class;
-		return r.classes?.[e] ?? ve[e] ?? "redact";
+		return r.classes?.[e] ?? he[e] ?? "redact";
 	}
 	return n?.safe ? r.onSafe ?? "keep" : n?.columnType === "id" || n?.columnType === "reference" ? "keep" : r.onUnclassified ?? "error";
-}, be = (e, t) => b("sha256", e).update(t == null ? "∅" : String(t)).digest(), j = (e, t) => e.readUInt32BE(t * 4 % (e.length - 4)), M = [
+}, P = (e, t) => b("sha256", e).update(t == null ? "∅" : String(t)).digest(), F = (e, t) => e.readUInt32BE(t * 4 % (e.length - 4)), I = [
 	"Ada",
 	"Alan",
 	"Grace",
@@ -69,7 +69,7 @@ var _e = (e) => {
 	"Guido",
 	"Margaret",
 	"Bjarne"
-], xe = [
+], _e = [
 	"Lovelace",
 	"Turing",
 	"Hopper",
@@ -82,7 +82,7 @@ var _e = (e) => {
 	"Rossum",
 	"Hamilton",
 	"Stroustrup"
-], Se = [
+], ve = [
 	"Maple",
 	"Oak",
 	"Cedar",
@@ -91,7 +91,7 @@ var _e = (e) => {
 	"Birch",
 	"Willow",
 	"Ash"
-], Ce = [
+], ye = [
 	"Initech",
 	"Hooli",
 	"Umbrella",
@@ -100,23 +100,23 @@ var _e = (e) => {
 	"Soylent",
 	"Stark",
 	"Wayne"
-], N = (e, t, n) => e[j(t, n) % e.length], we = (e, t, n) => {
-	let r = be(n, `${e}:${String(t)}`), i = j(r, 1) % 1e4;
+], L = (e, t, n) => e[F(t, n) % e.length], be = (e, t, n) => {
+	let r = P(n, `${e}:${String(t)}`), i = F(r, 1) % 1e4;
 	switch (e) {
-		case "email": return `${N(M, r, 0).toLowerCase()}.${N(xe, r, 2).toLowerCase()}${i}@example.com`;
-		case "fullName": return `${N(M, r, 0)} ${N(xe, r, 1)}`;
-		case "firstName": return N(M, r, 0);
-		case "lastName": return N(xe, r, 1);
-		case "username": return `${N(M, r, 0).toLowerCase()}${i}`;
-		case "phone": return `+1${String(j(r, 0) % 1e10).padStart(10, "0")}`;
-		case "address": return `${j(r, 0) % 9899 + 100} ${N(Se, r, 1)} St`;
-		case "company": return N(Ce, r, 0);
+		case "email": return `${L(I, r, 0).toLowerCase()}.${L(_e, r, 2).toLowerCase()}${i}@example.com`;
+		case "fullName": return `${L(I, r, 0)} ${L(_e, r, 1)}`;
+		case "firstName": return L(I, r, 0);
+		case "lastName": return L(_e, r, 1);
+		case "username": return `${L(I, r, 0).toLowerCase()}${i}`;
+		case "phone": return `+1${String(F(r, 0) % 1e10).padStart(10, "0")}`;
+		case "address": return `${F(r, 0) % 9899 + 100} ${L(ve, r, 1)} St`;
+		case "company": return L(ye, r, 0);
 		case "url": return `https://example.com/${r.toString("hex").slice(0, 12)}`;
-		case "ip": return `${j(r, 0) % 256}.${j(r, 1) % 256}.${j(r, 2) % 256}.${j(r, 3) % 254 + 1}`;
-		case "creditCard": return Te(`4${r.toString("hex").replace(/\D/g, "").padEnd(14, "0").slice(0, 14)}`);
+		case "ip": return `${F(r, 0) % 256}.${F(r, 1) % 256}.${F(r, 2) % 256}.${F(r, 3) % 254 + 1}`;
+		case "creditCard": return xe(`4${r.toString("hex").replace(/\D/g, "").padEnd(14, "0").slice(0, 14)}`);
 		default: return `${e}_${r.toString("hex").slice(0, 8)}`;
 	}
-}, Te = (e) => {
+}, xe = (e) => {
 	let t = e.slice(0, 15).split("").map(Number), n = 0;
 	t.forEach((e, t) => {
 		let r = e;
@@ -124,31 +124,31 @@ var _e = (e) => {
 	});
 	let r = (10 - n % 10) % 10;
 	return e.slice(0, 15) + String(r);
-}, Ee = 864e5, De = (e, t) => {
+}, Se = 864e5, Ce = (e, t) => {
 	let n = e instanceof Date ? e.getTime() : Date.parse(String(e));
 	if (Number.isNaN(n)) return e;
-	let r = j(be(t, "date-shift-offset"), 0) % 730 - 365, i = new Date(n + r * Ee);
+	let r = F(P(t, "date-shift-offset"), 0) % 730 - 365, i = new Date(n + r * Se);
 	return e instanceof Date ? i : i.toISOString();
-}, Oe = (e, t) => {
+}, we = (e, t) => {
 	if (t.value === null || t.value === void 0) return null;
 	if (e === "error") throw Error(`masking: unresolved 'error' action for ${t.table}.${t.column}`);
 	if (e === "keep") return t.value;
 	if (e === "null") return null;
 	if (e === "redact") return t.columnType === "text" || typeof t.value == "string" ? "[redacted]" : null;
-	if (e === "hash") return be(t.seed, t.value).toString("hex").slice(0, 16);
-	if (e === "dateShift") return De(t.value, t.seed);
-	if (typeof e == "object" && "fake" in e) return we(e.fake, t.value, t.seed);
+	if (e === "hash") return P(t.seed, t.value).toString("hex").slice(0, 16);
+	if (e === "dateShift") return Ce(t.value, t.seed);
+	if (typeof e == "object" && "fake" in e) return be(e.fake, t.value, t.seed);
 	if (typeof e == "object" && "custom" in e) return e.custom(t);
 	throw Error(`masking: '${t.table}.${t.column}' resolved to an action this build does not understand (${JSON.stringify(e)}). Refusing to copy the value through. Valid actions: 'keep' | 'null' | 'redact' | 'hash' | 'dateShift' | { fake: '<class>' } | { custom: fn }.`);
-}, ke = (e) => typeof e == "string" ? e === "keep" || e === "null" || e === "redact" || e === "hash" || e === "dateShift" || e === "error" : typeof e != "object" || !e ? !1 : "fake" in e ? typeof e.fake == "string" : "custom" in e && typeof e.custom == "function", Ae = (e, t, n) => {
+}, Te = (e) => typeof e == "string" ? e === "keep" || e === "null" || e === "redact" || e === "hash" || e === "dateShift" || e === "error" : typeof e != "object" || !e ? !1 : "fake" in e ? typeof e.fake == "string" : "custom" in e && typeof e.custom == "function", Ee = (e, t, n) => {
 	let r = {}, i = [], a = [];
 	for (let o of e) for (let e of o.columns) {
-		let s = `${o.name}.${e.name}`, c = ye(o.name, e.name, t[o.name]?.[e.name], n);
+		let s = `${o.name}.${e.name}`, c = ge(o.name, e.name, t[o.name]?.[e.name], n);
 		if (c === "error") {
 			i.push(s);
 			continue;
 		}
-		if (!ke(c)) {
+		if (!Te(c)) {
 			a.push({
 				column: s,
 				action: c
@@ -162,7 +162,7 @@ var _e = (e) => {
 		unclassified: i,
 		invalid: a
 	};
-}, je = [
+}, De = [
 	{
 		name: "email",
 		re: /[\w.+-]+@[\w-]+\.[\w.-]+/
@@ -179,7 +179,7 @@ var _e = (e) => {
 		name: "creditCard",
 		re: /\b(?:\d[ -]?){13,16}\b/
 	}
-], Me = (e, t, n) => {
+], Oe = (e, t, n) => {
 	let r = [], i = /* @__PURE__ */ new Set();
 	for (let [a, o] of Object.entries(n)) {
 		if (!a.startsWith(`${t}.`) || o !== "keep") continue;
@@ -187,7 +187,7 @@ var _e = (e) => {
 		for (let a of e) {
 			let e = a[n];
 			if (typeof e != "string" || e.length === 0) continue;
-			let o = je.find((t) => t.re.test(e));
+			let o = De.find((t) => t.re.test(e));
 			if (o && !i.has(n)) {
 				i.add(n), r.push({
 					table: t,
@@ -200,9 +200,9 @@ var _e = (e) => {
 		}
 	}
 	return r;
-}, Ne = (e, t, n, r, i) => {
+}, ke = (e, t, n, r, i) => {
 	let a = {};
-	for (let [o, s] of Object.entries(e)) a[o] = Oe(n[`${t}.${o}`] ?? "keep", {
+	for (let [o, s] of Object.entries(e)) a[o] = we(n[`${t}.${o}`] ?? "keep", {
 		value: s,
 		table: t,
 		column: o,
@@ -210,17 +210,17 @@ var _e = (e) => {
 		...i?.[o] ? { columnType: i[o] } : {}
 	});
 	return a;
-}, P = class extends s.TaggedError()("BundleError", {
+}, R = class extends s.TaggedError()("BundleError", {
 	reason: s.String,
 	path: s.optional(s.String)
-}) {}, Pe = class extends s.TaggedError()("CodecError", {
+}) {}, Ae = class extends s.TaggedError()("CodecError", {
 	table: s.String,
 	reason: s.String
-}) {}, F = class extends s.TaggedError()("IntegrityError", {
+}) {}, z = class extends s.TaggedError()("IntegrityError", {
 	what: s.String,
 	expected: s.String,
 	actual: s.String
-}) {}, Fe = class extends t.TaggedError("CompressionError") {}, I = class extends s.TaggedError()("ScopeError", { reason: s.String }) {}, Ie = class extends s.TaggedError()("RowsRefusedError", {
+}) {}, je = class extends t.TaggedError("CompressionError") {}, B = class extends s.TaggedError()("ScopeError", { reason: s.String }) {}, Me = class extends s.TaggedError()("RowsRefusedError", {
 	rows: s.Array(s.Struct({
 		table: s.String,
 		id: s.String,
@@ -229,29 +229,29 @@ var _e = (e) => {
 	})),
 	primaryCount: s.Number,
 	totalCount: s.Number
-}) {}, Le = class extends s.TaggedError()("SchemaDriftError", {
+}) {}, Ne = class extends s.TaggedError()("SchemaDriftError", {
 	bundleFingerprint: s.String,
 	targetFingerprint: s.String,
 	diff: s.Array(s.String)
-}) {}, L = class extends t.TaggedError("NativeToolError") {
+}) {}, V = class extends t.TaggedError("NativeToolError") {
 	get message() {
 		let e = this.stderr?.trim();
 		return `${this.tool}: ${this.reason}${e ? `\n${e}` : ""}`;
 	}
-}, Re = class extends s.TaggedError()("MaskingError", {
+}, Pe = class extends s.TaggedError()("MaskingError", {
 	unclassified: s.Array(s.String),
 	invalidActions: s.optional(s.Array(s.String))
-}) {}, ze = class extends s.TaggedError()("ImportModeError", {
+}) {}, Fe = class extends s.TaggedError()("ImportModeError", {
 	mode: s.String,
 	reason: s.String
-}) {}, Be = class extends s.TaggedError()("CrossDialectError", {
+}) {}, Ie = class extends s.TaggedError()("CrossDialectError", {
 	sourceDialect: s.String,
 	targetDialect: s.String,
 	blocking: s.Array(s.String)
-}) {}, R = (e, t) => e.tables.find((e) => e.name === t)?.columns.find((e) => e.type === "id")?.name ?? "id", Ve = (e, t) => (e.tables.find((e) => e.name === t)?.columns ?? []).filter((e) => e.references).map((e) => ({
+}) {}, H = (e, t) => e.tables.find((e) => e.name === t)?.columns.find((e) => e.type === "id")?.name ?? "id", Le = (e, t) => (e.tables.find((e) => e.name === t)?.columns ?? []).filter((e) => e.references).map((e) => ({
 	col: e.name,
 	refTable: e.references.table
-})), z = (e, t, r) => n.gen(function* () {
+})), Re = (e, t, r) => n.gen(function* () {
 	let i = r.maxDepth ?? 12, a = new Set(r.pinned ?? []), o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), u = (e) => {
 		let t = s.get(e) ?? /* @__PURE__ */ new Set();
 		return s.set(e, t), t;
@@ -269,10 +269,10 @@ var _e = (e) => {
 			for (let t of n) d(t.refTable, e[t.col]);
 		};
 	}, g = (r, i) => {
-		let a = p(r, R(t, r), Ve(t, r));
+		let a = p(r, H(t, r), Le(t, r));
 		return c.runForEach(h(e, {
 			table: r,
-			pk: R(t, r),
+			pk: H(t, r),
 			...i === void 0 ? {} : { where: i }
 		}), (e) => n.sync(() => a(e)));
 	}, _ = n.gen(function* () {
@@ -281,7 +281,7 @@ var _e = (e) => {
 			l.clear();
 			for (let [n, r] of e) {
 				let e = [...r].filter((e) => !s.get(n)?.has(e));
-				e.length !== 0 && (yield* g(n, f(R(t, n), e)));
+				e.length !== 0 && (yield* g(n, f(H(t, n), e)));
 			}
 		}
 	});
@@ -304,13 +304,13 @@ var _e = (e) => {
 		}
 	}
 	return o;
-}), He = (e, t) => ({
+}), ze = (e, t) => ({
 	tables: [...e.keys()],
 	predicateFor: (n) => {
 		let r = e.get(n);
-		return r ? f(R(t, n), [...r]) : void 0;
+		return r ? f(H(t, n), [...r]) : void 0;
 	}
-}), B = "tenantId", V = (e, t, r) => n.gen(function* () {
+}), U = "tenantId", Be = (e, t, r) => n.gen(function* () {
 	let i = t.tables.map((e) => e.name), a = new Map(t.tables.map((e) => [e.name, e]));
 	if (e.kind === "all") return {
 		tables: i,
@@ -318,7 +318,7 @@ var _e = (e) => {
 	};
 	if (e.kind === "tables") {
 		let t = e.tables ?? [], r = new Set(i), a = t.filter((e) => !r.has(e));
-		if (a.length > 0) return yield* n.fail(new I({ reason: `scope { kind: 'tables' } names ${a.length} table(s) that are not in the schema: ${a.join(", ")}. Refusing to write a bundle that silently omits them. Known tables: ${i.length}.` }));
+		if (a.length > 0) return yield* n.fail(new B({ reason: `scope { kind: 'tables' } names ${a.length} table(s) that are not in the schema: ${a.join(", ")}. Refusing to write a bundle that silently omits them. Known tables: ${i.length}.` }));
 		let o = new Set(t);
 		return {
 			tables: i.filter((e) => o.has(e)),
@@ -326,30 +326,30 @@ var _e = (e) => {
 		};
 	}
 	let o = e.tenantId;
-	if (o === void 0 || o === "") return yield* n.fail(new I({ reason: "scope { kind: 'tenant' } requires a tenantId — pass --tenant <id> (CLI) or scope.tenantId (API). Refusing to fall back to an unfiltered export." }));
-	let s = r.tenantTables ? r.tenantTables.filter((e) => a.has(e)) : i.filter((e) => a.get(e)?.columns.some((e) => e.name === B) ?? !1);
-	if (s.length === 0) return yield* n.fail(new I({ reason: r.tenantTables ? "tenant scope: none of the provided tenantTables exist in the schema — nothing to filter." : `tenant scope: no table carries a '${B}' column — nothing to filter. A tenant export of a schema without tenant-scoped tables would be the full database; refusing.` }));
-	let c = yield* z(r.store, t, {
-		seeds: Object.fromEntries(s.map((e) => [e, u(B, o)])),
+	if (o === void 0 || o === "") return yield* n.fail(new B({ reason: "scope { kind: 'tenant' } requires a tenantId — pass --tenant <id> (CLI) or scope.tenantId (API). Refusing to fall back to an unfiltered export." }));
+	let s = r.tenantTables ? r.tenantTables.filter((e) => a.has(e)) : i.filter((e) => a.get(e)?.columns.some((e) => e.name === U) ?? !1);
+	if (s.length === 0) return yield* n.fail(new B({ reason: r.tenantTables ? "tenant scope: none of the provided tenantTables exist in the schema — nothing to filter." : `tenant scope: no table carries a '${U}' column — nothing to filter. A tenant export of a schema without tenant-scoped tables would be the full database; refusing.` }));
+	let c = yield* Re(r.store, t, {
+		seeds: Object.fromEntries(s.map((e) => [e, u(U, o)])),
 		pinned: s,
 		children: { roots: s }
 	}), l = [...c.entries()].filter(([, e]) => e.size > 0).map(([e]) => e), d = new Set(s);
 	return {
 		tables: [...s, ...l],
-		predicateFor: (e) => d.has(e) ? u(B, o) : c.has(e) ? f(R(t, e), [...c.get(e)]) : void 0
+		predicateFor: (e) => d.has(e) ? u(U, o) : c.has(e) ? f(H(t, e), [...c.get(e)]) : void 0
 	};
-}), Ue = (e, t) => ({
+}), Ve = (e, t) => ({
 	list: t,
-	open: (t) => ee(e, t)
-}), We = (e) => ({
-	write: (t, n, r) => te(e, t, n, r),
+	open: (t) => T(e, t)
+}), He = (e) => ({
+	write: (t, n, r) => E(e, t, n, r),
 	has: (t) => e.head(t).pipe(n.map((e) => e !== null))
-}), Ge = (e, t) => n.tryPromise({
+}), Ue = (e, t) => n.tryPromise({
 	try: async () => {
 		let { createWriteStream: n } = await import("node:fs"), r = await import("node:fs/promises"), { createHash: i, randomUUID: a } = await import("node:crypto"), { pipeline: o } = await import("node:stream/promises"), { Transform: s } = await import("node:stream"), c = await import("node:path"), l = c.join(t, `.tmp-${a()}`), u = i("sha256"), d = 0, f = new s({ transform(e, t, n) {
 			u.update(e), d += e.length, n(null, e);
 		} });
-		await o(await ne(e.stream), f, n(l));
+		await o(await D(e.stream), f, n(l));
 		let p = u.digest("hex"), m = c.join(t, p);
 		try {
 			await r.access(m), await r.rm(l, { force: !0 });
@@ -362,23 +362,23 @@ var _e = (e) => {
 			contentType: e.contentType
 		};
 	},
-	catch: (e) => new P({
+	catch: (e) => new R({
 		reason: `asset write failed: ${String(e?.message ?? e)}`,
 		path: t
 	})
-}), Ke = (e, t, r) => n.gen(function* () {
+}), We = (e, t, r) => n.gen(function* () {
 	let i = yield* n.promise(() => import("node:path")), { createReadStream: a } = yield* n.promise(() => import("node:fs")), { createHash: o } = yield* n.promise(() => import("node:crypto")), s = i.join(t, r.sha256), l = o("sha256"), u = w("bundle", () => a(s)).pipe(c.tap((e) => n.sync(() => l.update(e))));
 	yield* e.write(r.key, u, {
 		contentType: r.contentType,
 		totalSize: r.size
 	});
 	let d = l.digest("hex");
-	if (d !== r.sha256) return yield* n.fail(new F({
+	if (d !== r.sha256) return yield* n.fail(new z({
 		what: `asset ${r.key}`,
 		expected: r.sha256,
 		actual: d
 	}));
-}), qe = () => typeof T.createZstdCompress == "function", Je = (e) => e === "none" ? "none" : e === "gzip" ? "gzip" : qe() ? "zstd" : "gzip", Ye = (e) => e === "zstd" ? ".zst" : e === "gzip" ? ".gz" : "", Xe = (e) => e === "zstd" ? T.createZstdCompress() : e === "gzip" ? T.createGzip() : new re(), Ze = (e) => e === "zstd" ? T.createZstdDecompress() : e === "gzip" ? T.createGunzip() : new re(), Qe = 1, $e = s.Struct({
+}), Ge = () => typeof O.createZstdCompress == "function", Ke = (e) => e === "none" ? "none" : e === "gzip" ? "gzip" : Ge() ? "zstd" : "gzip", qe = (e) => e === "zstd" ? ".zst" : e === "gzip" ? ".gz" : "", Je = (e) => e === "zstd" ? O.createZstdCompress() : e === "gzip" ? O.createGzip() : new k(), Ye = (e) => e === "zstd" ? O.createZstdDecompress() : e === "gzip" ? O.createGunzip() : new k(), Xe = 1, Ze = s.Struct({
 	name: s.String,
 	file: s.String,
 	rowCount: s.Number,
@@ -388,11 +388,11 @@ var _e = (e) => {
 		value: s.String
 	}),
 	primaryKey: s.String
-}), et = s.Struct({
+}), Qe = s.Struct({
 	kind: s.Literal("all", "tenant", "tables"),
 	tenantId: s.optional(s.String),
 	tables: s.optional(s.Array(s.String))
-}), tt = s.Struct({
+}), $e = s.Struct({
 	count: s.Number,
 	totalBytes: s.Number,
 	index: s.optional(s.String)
@@ -403,23 +403,23 @@ s.Struct({
 	size: s.Number,
 	contentType: s.String
 });
-var nt = s.Struct({
+var et = s.Struct({
 	formatVersion: s.Number,
 	createdAt: s.String,
 	source: s.Struct({
 		dialect: s.String,
 		schemaFingerprint: s.String
 	}),
-	scope: et,
+	scope: Qe,
 	consistency: s.Literal("live", "snapshot"),
 	compression: s.Literal("zstd", "gzip", "none"),
-	tables: s.Array($e),
-	assets: tt,
+	tables: s.Array(Ze),
+	assets: $e,
 	masking: s.optional(s.Struct({
 		policyId: s.optional(s.String),
 		transformed: s.Array(s.String)
 	}))
-}), rt = s.encodeSync(s.parseJson(nt)), it = s.decodeUnknownSync(s.parseJson(nt)), H = "manifest.json", at = "README.md", U = "data", W = "assets", G = "assets/index.ndjson", ot = ".ledger.json", st = (e) => e.kind === "tenant" ? `tenant \`${e.tenantId}\`` : e.kind === "tables" ? `tables \`${(e.tables ?? []).join(", ")}\`` : "all tables", ct = (e, t) => {
+}), tt = s.encodeSync(s.parseJson(et)), nt = s.decodeUnknownSync(s.parseJson(et)), W = "manifest.json", rt = "README.md", it = "data", G = "assets", at = "assets/index.ndjson", ot = ".ledger.json", st = (e) => e.kind === "tenant" ? `tenant \`${e.tenantId}\`` : e.kind === "tables" ? `tables \`${(e.tables ?? []).join(", ")}\`` : "all tables", ct = (e, t) => {
 	let n = e.tables.reduce((e, t) => e + t.rowCount, 0), r = e.masking ? `✅ **Masked at the source** — ${e.masking.transformed.length} column(s) transformed${e.masking.policyId ? ` (policy \`${e.masking.policyId}\`)` : ""}. Personal data was replaced with realistic, referentially-consistent fakes before any byte was written.` : "⚠️ **NOT masked — this bundle contains REAL data (PII included).** Treat it as production data: do not copy it into a lower environment or share it without review. To produce a safe copy, re-export under a masking profile (`--profile`).", i = e.masking && e.masking.transformed.length > 0 ? `\n\nMasked columns: ${e.masking.transformed.map((e) => `\`${e}\``).join(", ")}.` : "", a = e.assets.count > 0 ? `${e.assets.count} object(s), ${e.assets.totalBytes} bytes` : "none", o = e.tables.map((e) => `| \`${e.name}\` | ${e.rowCount} |`).join("\n");
 	return `# Voltro data export
 
@@ -482,7 +482,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		let n = await import("node:fs/promises"), { randomUUID: r } = await import("node:crypto"), i = `${e}.tmp-${r()}`;
 		await n.writeFile(i, JSON.stringify(t)), await n.rename(i, e);
 	},
-	catch: (t) => new P({
+	catch: (t) => new R({
 		reason: `ledger write failed: ${String(t?.message ?? t)}`,
 		path: e
 	})
@@ -520,7 +520,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 	return n;
 }, Dt = new TextEncoder(), Ot = (e, t) => e.pipe(c.map((e) => Dt.encode(`${JSON.stringify(Tt(e, t))}\n`))), kt = (e, t, r) => e.pipe(c.decodeText(), c.splitLines, c.filter((e) => e.trim().length > 0), c.mapEffect((e) => n.try({
 	try: () => Et(JSON.parse(e), r),
-	catch: (e) => new Pe({
+	catch: (e) => new Ae({
 		table: t,
 		reason: String(e?.message ?? e)
 	})
@@ -585,7 +585,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 			n(null, e);
 		} }), m = l.fromWeb(c.toReadableStream(e)), h = `${t}.tmp-${o()}`;
 		try {
-			await s(m, p, Xe(r), n(h)), await i.rename(h, t);
+			await s(m, p, Je(r), n(h)), await i.rename(h, t);
 		} catch (e) {
 			throw await i.rm(h, { force: !0 }).catch(() => {}), e;
 		}
@@ -594,7 +594,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 			checksum: d.digest("hex")
 		};
 	},
-	catch: (e) => new P({
+	catch: (e) => new R({
 		reason: `write table failed: ${J(e)}`,
 		path: t
 	})
@@ -602,7 +602,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 	try: async () => {
 		await (await import("node:fs/promises")).appendFile(e, `${t}\n`);
 	},
-	catch: (t) => new P({
+	catch: (t) => new R({
 		reason: `append failed: ${J(t)}`,
 		path: e
 	})
@@ -610,8 +610,8 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 	let r = [], i = t.ordered.length;
 	for (let a = 0; a < t.ordered.length; a++) {
 		let o = t.ordered[a], s = Mt(t.snapshot, o), l = Ft(t.snapshot, o);
-		if ("refusal" in l) return yield* n.fail(new I({ reason: `export: ${l.refusal}` }));
-		let u = l.column, d = `${U}/${o}.ndjson${Ye(t.compression)}`;
+		if ("refusal" in l) return yield* n.fail(new B({ reason: `export: ${l.refusal}` }));
+		let u = l.column, d = `${it}/${o}.ndjson${qe(t.compression)}`;
 		if (ht(t.ledger, o)) {
 			let e = t.ledger.tables[o];
 			K(t.onProgress, {
@@ -646,7 +646,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 			chunkSize: t.chunkSize,
 			retry: t.retry,
 			...f === void 0 ? {} : { where: f }
-		}), m = Nt(t.snapshot, o), g = m.length === 0 ? p : p.pipe(c.map((e) => Pt(e, m))), _ = t.mask ? g.pipe(c.map((e) => Ne(e, o, t.mask.actions, t.mask.seed, s))) : g, { rowCount: v, checksum: y } = yield* ft("export", o, a, i, (e) => e.rowCount, It(Ot(_, s), t.bundleFile(d), t.compression));
+		}), m = Nt(t.snapshot, o), g = m.length === 0 ? p : p.pipe(c.map((e) => Pt(e, m))), _ = t.mask ? g.pipe(c.map((e) => ke(e, o, t.mask.actions, t.mask.seed, s))) : g, { rowCount: v, checksum: y } = yield* ft("export", o, a, i, (e) => e.rowCount, It(Ot(_, s), t.bundleFile(d), t.compression));
 		t.ledger.tables[o] = {
 			rowCount: v,
 			checksum: y
@@ -674,37 +674,37 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 	values: []
 }), Bt = (t, i, a) => n.tryPromise({
 	try: () => t.transactional(async (t) => {
-		if (t.raw) for (let e of _e(i)) await t.raw(zt(e));
+		if (t.raw) for (let e of me(i)) await t.raw(zt(e));
 		let o = await n.runPromiseExit(a(t));
 		if (r.isFailure(o)) throw Error(e.pretty(o.cause));
 		return o.value;
 	}),
-	catch: (e) => e instanceof P ? e : new P({ reason: `snapshot export failed: ${J(e)}` })
+	catch: (e) => e instanceof R ? e : new R({ reason: `snapshot export failed: ${J(e)}` })
 }), Vt = (e) => n.gen(function* () {
-	let t = e.scope ?? { kind: "all" }, r = Je(e.compression), i = e.chunkSize ?? 1e3, a = e.retryTimes ?? 5, s = o.exponential("50 millis").pipe(o.jittered, o.intersect(o.recurs(a))), l = yield* n.promise(() => import("node:path")), u = (t) => l.join(e.outDir, t);
+	let t = e.scope ?? { kind: "all" }, r = Ke(e.compression), i = e.chunkSize ?? 1e3, a = e.retryTimes ?? 5, s = o.exponential("50 millis").pipe(o.jittered, o.intersect(o.recurs(a))), l = yield* n.promise(() => import("node:path")), u = (t) => l.join(e.outDir, t);
 	yield* n.tryPromise({
 		try: async () => {
 			let t = await import("node:fs/promises");
-			await t.mkdir(u(U), { recursive: !0 }), e.assets && await t.mkdir(u(W), { recursive: !0 });
+			await t.mkdir(u(it), { recursive: !0 }), e.assets && await t.mkdir(u(G), { recursive: !0 });
 		},
-		catch: (t) => new P({
+		catch: (t) => new R({
 			reason: `mkdir failed: ${J(t)}`,
 			path: e.outDir
 		})
 	});
-	let d = u(ot), f = yield* mt(d), p = e.subset ? He(yield* z(e.store, e.snapshot, e.subset), e.snapshot) : yield* V(t, e.snapshot, {
+	let d = u(ot), f = yield* mt(d), p = e.subset ? ze(yield* Re(e.store, e.snapshot, e.subset), e.snapshot) : yield* Be(t, e.snapshot, {
 		store: e.store,
 		...e.tenantTables ? { tenantTables: e.tenantTables } : {}
 	}), m = At(p.tables, e.snapshot), h = e.consistency ?? "live", _, v;
 	if (e.masking) {
-		let t = e.classification ?? A(e.snapshot), r = Ae(m.map((t) => ({
+		let t = e.classification ?? N(e.snapshot), r = Ee(m.map((t) => ({
 			name: t,
 			columns: (e.snapshot.tables.find((e) => e.name === t)?.columns ?? []).map((e) => ({
 				name: e.name,
 				type: e.type
 			}))
 		})), t, e.masking);
-		if (r.unclassified.length > 0 || r.invalid.length > 0) return yield* n.fail(new Re({
+		if (r.unclassified.length > 0 || r.invalid.length > 0) return yield* n.fail(new Pe({
 			unclassified: r.unclassified,
 			...r.invalid.length > 0 ? { invalidActions: r.invalid.map((e) => `${e.column}: ${JSON.stringify(e.action)}`) } : {}
 		}));
@@ -732,8 +732,8 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		...e.onProgress ? { onProgress: e.onProgress } : {}
 	}, b = h === "snapshot" ? yield* Bt(e.store, e.dialect, (e) => Rt(e, y)) : yield* Rt(e.store, y), x = 0, S = 0;
 	if (e.assets) {
-		let t = u(G);
-		yield* c.runForEach(e.assets.list(), (r) => r.key in f.assets ? n.void : e.assets.open(r.key).pipe(n.flatMap((e) => Ge(e, u(W))), n.flatMap((e) => {
+		let t = u(at);
+		yield* c.runForEach(e.assets.list(), (r) => r.key in f.assets ? n.void : e.assets.open(r.key).pipe(n.flatMap((e) => Ue(e, u(G))), n.flatMap((e) => {
 			let i = {
 				key: r.key,
 				sha256: e.sha256,
@@ -741,7 +741,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 				contentType: e.contentType
 			};
 			return x++, S += e.size, f.assets[r.key] = !0, Lt(t, JSON.stringify(i)).pipe(n.andThen(q(d, f)));
-		}))).pipe(n.mapError((e) => e instanceof P ? e : new P({ reason: `asset export failed: ${String(e)}` })));
+		}))).pipe(n.mapError((e) => e instanceof R ? e : new R({ reason: `asset export failed: ${String(e)}` })));
 	}
 	let C = {
 		formatVersion: 1,
@@ -757,7 +757,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		assets: x > 0 ? {
 			count: x,
 			totalBytes: S,
-			index: G
+			index: at
 		} : {
 			count: 0,
 			totalBytes: 0
@@ -766,23 +766,42 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 	};
 	return yield* n.tryPromise({
 		try: async () => {
-			await (await import("node:fs/promises")).writeFile(u(H), rt(C));
+			await (await import("node:fs/promises")).writeFile(u(W), tt(C));
 		},
-		catch: (e) => new P({
+		catch: (e) => new R({
 			reason: `manifest write failed: ${J(e)}`,
-			path: H
+			path: W
 		})
 	}), yield* n.tryPromise({
 		try: async () => {
 			let e = await import("node:fs/promises"), t = await import("node:os");
-			await e.writeFile(u(at), ct(C, { hostname: t.hostname() }));
+			await e.writeFile(u(rt), ct(C, { hostname: t.hostname() }));
 		},
-		catch: (e) => new P({
+		catch: (e) => new R({
 			reason: `readme write failed: ${J(e)}`,
-			path: at
+			path: rt
 		})
 	}), C;
-}), Ht = (e) => {
+}), Ht = (e, t) => {
+	let n = new Set(t), r = [];
+	for (let t of e.tables) if (!n.has(t.name)) for (let e of t.columns) {
+		let i = e.references?.table;
+		i !== void 0 && n.has(i) && r.push({
+			from: t.name,
+			column: e.name,
+			to: i
+		});
+	}
+	return r;
+}, Ut = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) t.set(n.from, [...t.get(n.from) ?? [], n]);
+	let n = [...t.entries()].map(([e, t]) => {
+		let n = t[0].rowCount, r = t.map((e) => `${e.column} → ${e.to}`).join(", ");
+		return `  ${e} (${n} row${n === 1 ? "" : "s"}): ${r}`;
+	});
+	return `replace cannot empty this target: ${t.size} table(s) OUTSIDE the bundle hold rows that reference tables INSIDE it. Emptying the bundle's tables would leave those rows pointing at nothing, and the bundle cannot restore them.\n${n.join("\n")}\nNothing has been deleted. Either re-export with a scope that includes those tables, or use --mode upsert if those rows are meant to survive.`;
+}, Wt = (e) => {
 	switch (e) {
 		case "id":
 		case "text":
@@ -801,12 +820,12 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		case "raw": return "raw";
 		default: return "string";
 	}
-}, Ut = {
+}, Gt = {
 	vector: /* @__PURE__ */ new Set(["postgres"]),
 	array: /* @__PURE__ */ new Set(["postgres"]),
 	interval: /* @__PURE__ */ new Set(["postgres"])
-}, Wt = (e, t, n, r) => {
-	let i = Ht(n);
+}, Kt = (e, t, n, r) => {
+	let i = Wt(n);
 	if (i === "raw") return {
 		table: e,
 		column: t,
@@ -814,7 +833,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		severity: "block",
 		reason: `raw() is verbatim source-dialect SQL — it cannot be assumed valid on ${r}`
 	};
-	let a = Ut[i];
+	let a = Gt[i];
 	return !a || a.has(r) ? null : i === "array" || i === "interval" ? {
 		table: e,
 		column: t,
@@ -828,15 +847,15 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		severity: "block",
 		reason: `${i} columns require a ${[...a].join("/")} target; ${r} has no compatible column type`
 	};
-}, Gt = (e, t, n) => {
+}, qt = (e, t, n) => {
 	if (t === n) return [];
 	let r = [];
 	for (let t of e) for (let [e, i] of Object.entries(t.columnTypes)) {
-		let a = Wt(t.name, e, i, n);
+		let a = Kt(t.name, e, i, n);
 		a && r.push(a);
 	}
 	return r;
-}, Kt = (e) => `[${e.severity}] ${e.table}.${e.column} (${e.type}): ${e.reason}`, qt = (e) => {
+}, Jt = (e) => `[${e.severity}] ${e.table}.${e.column} (${e.type}): ${e.reason}`, Yt = (e) => {
 	let t = e.constraint ?? e.column, n = t === void 0 ? "" : ` ${t}`;
 	switch (e.kind) {
 		case "foreignKey": return `foreign key${n}: the referenced row does not exist (import it first, or check the bundle's table order)`;
@@ -845,22 +864,29 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		case "notNull": return `not-null constraint${n}: the column requires a value`;
 		case "check": return `check constraint${n}: the row does not satisfy it`;
 	}
-}, Jt = (e) => {
+}, Xt = (e) => {
 	let t = [e.dbCode, e.dbErrno ?? e.dbNumber].filter((e) => e !== void 0).map(String);
 	return t.length > 0 ? t.join("/") : void 0;
-}, Yt = (e) => {
-	let t = d(e), n = l(t), r = Jt(t), i = r === void 0 ? "" : ` [${r}]`;
-	if (n !== void 0) return `${qt(n)}${i}`;
+}, Zt = (e) => {
+	let t = d(e), n = l(t), r = Xt(t), i = r === void 0 ? "" : ` [${r}]`;
+	if (n !== void 0) return `${Yt(n)}${i}`;
 	let a = typeof t.dbMessage == "string" ? t.dbMessage : void 0, o = e?.message, s = typeof o == "string" && o.length > 0 ? o : String(e), c = a !== void 0 && a !== s && !a.startsWith("SqlError:") ? a : s, u = c === "Failed to execute statement" ? `the database refused the write and the driver gave no detail${i}` : `${c}${i}`;
 	return u.length <= 300 ? u : `${u.slice(0, 300)}…`;
-}, Xt = (e, t) => e.tables.find((e) => e.name === t), Zt = (e, t) => new Map((Xt(e, t)?.columns ?? []).map((e) => [e.name, e])), Qt = (e, t) => {
+}, Qt = (e) => {
+	let t = d(e), n = l(t);
+	if (n?.kind === "foreignKeyInUse") {
+		let e = n.constraint ?? n.column, r = e === void 0 ? "" : ` ${e}`, i = Xt(t);
+		return `foreign key${r}: rows elsewhere still reference this table${i === void 0 ? "" : ` [${i}]`}`;
+	}
+	return Zt(e);
+}, $t = (e, t) => e.tables.find((e) => e.name === t), en = (e, t) => new Map(($t(e, t)?.columns ?? []).map((e) => [e.name, e])), tn = (e, t) => {
 	let n = [];
 	for (let r of [...e.tables].sort((e, t) => e.name.localeCompare(t.name))) {
-		if (Xt(t, r.name) === void 0) {
+		if ($t(t, r.name) === void 0) {
 			n.push(`table '${r.name}' is in the bundle but MISSING from the target — its rows have nowhere to go`);
 			continue;
 		}
-		let e = Zt(t, r.name), i = new Map(r.columns.map((e) => [e.name, e]));
+		let e = en(t, r.name), i = new Map(r.columns.map((e) => [e.name, e]));
 		for (let [t, a] of i) {
 			let i = e.get(t);
 			if (i === void 0) {
@@ -872,7 +898,7 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		for (let [t, a] of e) i.has(t) || !a.nullable && !a.hasDefault && n.push(`${r.name}.${t}: the target requires it (NOT NULL, no default) and the bundle carries no value — every row of this table would fail`);
 	}
 	return n.length > 30 ? [...n.slice(0, 30), `… and ${n.length - 30} more difference(s)`] : n;
-}, $t = (e, t, n) => {
+}, nn = (e, t, n) => {
 	let r = g(t);
 	if (r === e || n === void 0) return {
 		drifted: !1,
@@ -880,28 +906,28 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		targetFingerprint: r,
 		diff: []
 	};
-	let i = Qt(n, t);
+	let i = tn(n, t);
 	return {
 		drifted: i.length > 0,
 		bundleFingerprint: e,
 		targetFingerprint: r,
 		diff: i
 	};
-}, en = (e) => n.tryPromise({
+}, rn = 200, an = (e) => n.tryPromise({
 	try: async () => {
 		let t = await import("node:fs/promises"), n = await import("node:path");
-		return it(await t.readFile(n.join(e, H), "utf8"));
+		return nt(await t.readFile(n.join(e, W), "utf8"));
 	},
-	catch: (e) => new P({
+	catch: (e) => new R({
 		reason: `manifest read/parse failed: ${String(e?.message ?? e)}`,
-		path: H
+		path: W
 	})
-}), tn = (t) => n.gen(function* () {
-	let i = yield* n.promise(() => import("node:path")), a = yield* en(t.bundleDir);
-	if (a.formatVersion !== 1) return yield* n.fail(new P({ reason: `unsupported bundle formatVersion ${a.formatVersion} (expected 1)` }));
+}), on = (t) => n.gen(function* () {
+	let i = yield* n.promise(() => import("node:path")), a = yield* an(t.bundleDir);
+	if (a.formatVersion !== 1) return yield* n.fail(new R({ reason: `unsupported bundle formatVersion ${a.formatVersion} (expected 1)` }));
 	if (t.tables !== void 0) {
 		let e = new Set(a.tables.map((e) => e.name)), r = t.tables.filter((t) => !e.has(t));
-		if (r.length > 0) return yield* n.fail(new P({ reason: `--tables names ${r.length} table(s) this bundle does not carry: ${r.join(", ")}. The bundle carries: ${[...e].sort().join(", ")}.` }));
+		if (r.length > 0) return yield* n.fail(new R({ reason: `--tables names ${r.length} table(s) this bundle does not carry: ${r.join(", ")}. The bundle carries: ${[...e].sort().join(", ")}.` }));
 	}
 	let o = t.tables === void 0 ? void 0 : new Set(t.tables), s = o === void 0 ? a : {
 		...a,
@@ -918,9 +944,9 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 				unique: !1,
 				hasDefault: !1
 			}))
-		})) }, r = $t(s.source.schemaFingerprint, t.targetSnapshot, e);
+		})) }, r = nn(s.source.schemaFingerprint, t.targetSnapshot, e);
 		if (r.drifted) {
-			if (!t.force) return yield* n.fail(new Le({
+			if (!t.force) return yield* n.fail(new Ne({
 				bundleFingerprint: r.bundleFingerprint,
 				targetFingerprint: r.targetFingerprint,
 				diff: r.diff
@@ -929,43 +955,81 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		}
 	}
 	if (t.targetDialect && t.targetDialect !== s.source.dialect) {
-		let e = Gt(s.tables, s.source.dialect, t.targetDialect).filter((e) => e.severity === "block");
-		if (e.length > 0 && !t.allowIncompatible) return yield* n.fail(new Be({
+		let e = qt(s.tables, s.source.dialect, t.targetDialect).filter((e) => e.severity === "block");
+		if (e.length > 0 && !t.allowIncompatible) return yield* n.fail(new Ie({
 			sourceDialect: s.source.dialect,
 			targetDialect: t.targetDialect,
-			blocking: e.map(Kt)
+			blocking: e.map(Jt)
 		}));
 	}
-	let l = t.verify ?? !0, u = t.mode ?? "upsert", d = t.onConflict ?? "skip", f = t.ledgerPath ?? i.join(t.bundleDir, ".import..ledger.json"), m = yield* mt(f);
-	if (u === "replace" && s.scope.kind !== "all") return yield* n.fail(new ze({
+	let l = t.verify ?? !0, u = t.mode ?? "upsert", d = t.atomic ?? u === "replace", f = t.onConflict ?? "skip", m = t.ledgerPath ?? i.join(t.bundleDir, ".import..ledger.json"), h = yield* mt(m);
+	if (u === "replace" && s.scope.kind !== "all") return yield* n.fail(new Fe({
 		mode: u,
 		reason: `replace refuses a partial bundle (scope='${s.scope.kind}') — truncating would delete rows not in the bundle. Use --mode upsert, or re-export with full scope.`
 	}));
-	if (t.dryRun === !0) return s;
-	let h = /* @__PURE__ */ new Map();
+	if (u === "replace") {
+		let e = s.tables.map((e) => e.name), r = t.store.incomingForeignKeys ? yield* n.tryPromise({
+			try: () => t.store.incomingForeignKeys(e),
+			catch: (e) => new R({ reason: `foreign-key pre-flight failed: ${Qt(e)}` })
+		}) : t.targetSnapshot === void 0 ? [] : Ht(t.targetSnapshot, e), i = [], a = /* @__PURE__ */ new Map();
+		for (let e of r) {
+			if (!a.has(e.from)) {
+				let r = yield* n.tryPromise({
+					try: () => t.store.query({
+						table: e.from,
+						predicate: void 0,
+						order: [],
+						take: void 0,
+						skip: void 0,
+						projection: []
+					}),
+					catch: () => new R({ reason: `unreadable: ${e.from}` })
+				}).pipe(n.map((e) => e.length), n.orElseSucceed(() => 0));
+				a.set(e.from, r);
+			}
+			let r = a.get(e.from) ?? 0;
+			r > 0 && i.push({
+				...e,
+				rowCount: r
+			});
+		}
+		if (i.length > 0) return yield* n.fail(new Fe({
+			mode: u,
+			reason: Ut(i)
+		}));
+	}
+	if (t.dryRun === !0) return {
+		manifest: s,
+		tablesWritten: 0,
+		rowsWritten: 0,
+		tablesSkipped: 0,
+		rowsSkipped: 0,
+		fullyResumed: !1
+	};
+	let g = /* @__PURE__ */ new Map();
 	for (let e of t.targetSnapshot?.tables ?? []) {
 		let t = e.columns.filter((e) => e.generatedAs !== void 0).map((e) => e.name);
-		t.length > 0 && h.set(e.name, t);
+		t.length > 0 && g.set(e.name, t);
 	}
-	let g = (e, t) => {
-		let n = h.get(e);
+	let _ = (e, t) => {
+		let n = g.get(e);
 		if (n === void 0) return t;
 		let r;
 		for (let e of n) e in t && (r ??= { ...t }, delete r[e]);
 		return r ?? t;
-	}, _ = (e, t, n) => {
-		let r = t.name, i = t.primaryKey, a = g(r, n);
-		return u === "append" ? d === "fail" ? e.insert(r, a) : e.insertIgnore(r, a, { conflictColumns: [i] }) : u === "replace" ? e.insert(r, a) : e.upsert(r, a, { conflictColumns: [i] });
-	}, v = (e, t, r = !0) => n.tryPromise({
+	}, v = (e, t, n, r = !1) => {
+		let i = t.name, a = t.primaryKey, o = _(i, n);
+		return u === "append" ? f === "fail" ? e.insert(i, o) : e.insertIgnore(i, o, { conflictColumns: [a] }) : u === "replace" ? r ? e.upsert(i, o, { conflictColumns: [a] }) : e.insert(i, o) : e.upsert(i, o, { conflictColumns: [a] });
+	}, y = (e, t) => e.savepoint ? e.savepoint(t) : t(), b = (e, t, r = !0) => n.tryPromise({
 		try: e,
-		catch: (e) => Yt(e)
-	}).pipe(n.map(() => !0), n.catchAll((e) => n.sync(() => (r && (t.reason = e), !1)))), y = (e) => {
+		catch: (e) => Zt(e)
+	}).pipe(n.map(() => !0), n.catchAll((e) => n.sync(() => (r && (t.reason = e), !1)))), x = (e) => {
 		let t = Object.entries(e.entry.columnTypes).filter(([t, n]) => n === "reference" && e.row[t] !== null && e.row[t] !== void 0).map(([e]) => e);
 		if (t.length !== 0) return {
 			...e.row,
 			...Object.fromEntries(t.map((e) => [e, null]))
 		};
-	}, b = (e) => {
+	}, S = (e) => {
 		let t = new Set(e.map((e) => String(e.row[e.entry.primaryKey]))), n = (e) => Object.entries(e.entry.columnTypes).some(([n, r]) => {
 			if (r !== "reference") return !1;
 			let i = e.row[n];
@@ -976,78 +1040,83 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 			reason: e.reason,
 			derived: n(e)
 		}));
-		return new Ie({
+		return new Me({
 			rows: [...r.filter((e) => !e.derived), ...r.filter((e) => e.derived)].slice(0, 20),
 			primaryCount: r.filter((e) => !e.derived).length,
 			totalCount: e.length
 		});
-	}, x = (e, t) => n.gen(function* () {
+	}, C = (e, t) => n.gen(function* () {
 		let r = t, i = [], a = !0;
 		for (; r.length > 0 && a;) {
 			a = !1;
 			let t = [];
-			for (let n of r) (yield* v(() => _(e, n.entry, n.row), n)) ? a = !0 : t.push(n);
+			for (let n of r) (yield* b(() => y(e, () => v(e, n.entry, n.row, !0)), n)) ? a = !0 : t.push(n);
 			if (!a && t.length > 0) for (let n = t.length - 1; n >= 0; n--) {
-				let r = t[n], o = y(r);
-				o !== void 0 && (yield* v(() => _(e, r.entry, o), r, !1)) && (i.push(r), t.splice(n, 1), a = !0);
+				let r = t[n], o = x(r);
+				o !== void 0 && (yield* b(() => y(e, () => v(e, r.entry, o, !0)), r, !1)) && (i.push(r), t.splice(n, 1), a = !0);
 			}
 			r = t;
 		}
-		for (let t of i) (yield* v(() => e.upsert(t.entry.name, t.row, { conflictColumns: [t.entry.primaryKey] }), t)) || (r = [...r, t]);
-		if (r.length > 0) return yield* n.fail(b(r));
-	}), S = (e, r) => n.gen(function* () {
-		if (u === "replace" && !(r && m.truncated)) {
-			for (let t of [...s.tables].reverse()) yield* n.tryPromise({
-				try: () => e.deleteMany(t.name, { where: p(t.primaryKey) }),
-				catch: (e) => new P({ reason: `truncate ${t.name} failed: ${String(e?.message ?? e)}` })
+		for (let t of i) (yield* b(() => y(e, () => e.upsert(t.entry.name, t.row, { conflictColumns: [t.entry.primaryKey] })), t)) || (r = [...r, t]);
+		if (r.length > 0) return yield* n.fail(S(r));
+	}), T = !1, E = 0, D = 0, O = 0, k = 0, A = (e, r) => n.gen(function* () {
+		if (u === "replace" && !(r && h.truncated)) {
+			let t = [...s.tables].reverse().map((e) => e.name), i = !r, a = e.emptyTables ? () => e.emptyTables(t) : i ? async () => {
+				for (let t of [...s.tables].reverse()) await e.deleteMany(t.name, { where: p(t.primaryKey) });
+			} : () => e.transactional(async (e) => {
+				for (let t of [...s.tables].reverse()) await e.deleteMany(t.name, { where: p(t.primaryKey) });
 			});
-			r && (m.truncated = !0, yield* q(f, m));
+			yield* n.tryPromise({
+				try: a,
+				catch: (e) => new R({ reason: `emptying the target for --mode replace failed (nothing was deleted): ${Qt(e)}` })
+			}), r && (h.truncated = !0, yield* q(m, h));
 		}
-		let a = [], o = [], d = [], h = s.tables.length;
+		let a = [], o = [], f = [], g = s.tables.length;
 		for (let p = 0; p < s.tables.length; p++) {
-			let g = s.tables[p];
-			if (r && g.name in m.tables) {
-				d.push(g.name), K(t.onProgress, {
+			let _ = s.tables[p];
+			if (r && _.name in h.tables) {
+				f.push(_.name), k++, O += h.tables[_.name].rowCount, K(t.onProgress, {
 					phase: "import",
-					table: g.name,
+					table: _.name,
 					index: p,
-					tableCount: h,
+					tableCount: g,
 					event: "done",
-					rowsDone: m.tables[g.name].rowCount,
-					total: g.rowCount
+					rowsDone: h.tables[_.name].rowCount,
+					total: _.rowCount
 				});
 				continue;
 			}
-			let v = i.join(t.bundleDir, g.file);
+			let b = i.join(t.bundleDir, _.file);
 			K(t.onProgress, {
 				phase: "import",
-				table: g.name,
+				table: _.name,
 				index: p,
-				tableCount: h,
+				tableCount: g,
 				event: "start",
 				rowsDone: 0,
-				total: g.rowCount
+				total: _.rowCount
 			});
-			let y = a.length, b = n.gen(function* () {
-				let { createHash: r } = yield* n.promise(() => import("node:crypto")), i = r("sha256"), o = 0, l = w("bundle", () => E(v).pipe(Ze(s.compression))).pipe(c.tap((e) => n.sync(() => i.update(e)))), d = async (t) => {
+			let x = a.length, S = n.gen(function* () {
+				let { createHash: r } = yield* n.promise(() => import("node:crypto")), i = r("sha256"), o = 0, l = w("bundle", () => j(b).pipe(Ye(s.compression))).pipe(c.tap((e) => n.sync(() => i.update(e)))), f = async (t) => {
 					let n = {
-						entry: g,
+						entry: _,
 						row: t,
 						reason: ""
 					};
 					try {
-						await _(e, g, t);
+						await y(e, () => v(e, _, t));
 					} catch (e) {
-						n.reason = Yt(e), a.push(n);
+						n.reason = Zt(e), a.push(n);
 					}
-				}, f = yield* n.promise(async () => {
+				}, p = yield* n.promise(async () => {
 					let n = t.copyLoader;
-					if (!n || n.dialect !== "postgres" || t.atomic) return !1;
+					if (!n || n.dialect !== "postgres") return !1;
+					if (d) return T || (T = !0, t.onWarn?.("bulk COPY is off for this run: it needs its own connection and this import runs in ONE transaction (the default for --mode replace, so a failure mid-load cannot leave the target emptied and unfilled). Pass --no-atomic to trade that guarantee back for COPY.")), !1;
 					if (u === "replace") return !0;
 					if (u !== "upsert") return !1;
 					try {
 						return (await e.query({
-							table: g.name,
+							table: _.name,
 							predicate: void 0,
 							order: [],
 							take: 1,
@@ -1057,101 +1126,123 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 					} catch {
 						return !1;
 					}
-				}), p = Object.keys(g.columnTypes), m = Math.max(1, t.copyBatchSize ?? 5e3), h = [], y = async () => {
-					if (h.length === 0) return;
-					let e = h;
-					h = [];
+				}), m = Object.keys(_.columnTypes), h = Math.max(1, t.copyBatchSize ?? 5e3), g = [], x = async () => {
+					if (g.length === 0) return;
+					let e = g;
+					g = [];
 					try {
 						await t.copyLoader.copyInto({
-							table: g.name,
-							columns: p,
-							columnTypes: g.columnTypes,
+							table: _.name,
+							columns: m,
+							columnTypes: _.columnTypes,
 							rows: e
 						});
 					} catch (n) {
-						f = !1, t.onWarn?.(`bulk COPY into ${g.name} failed (${String(n?.message ?? n)}); falling back to per-row writes for this table`);
-						for (let t of e) await d(t);
+						p = !1, t.onWarn?.(`bulk COPY into ${_.name} failed (${String(n?.message ?? n)}); falling back to per-row writes for this table`);
+						for (let t of e) await f(t);
+					}
+				}, S = Math.max(1, t.savepointBatchSize ?? 200), C = typeof e.savepoint == "function", E = [], D = async () => {
+					if (E.length === 0) return;
+					let t = E;
+					E = [];
+					try {
+						await e.savepoint(async () => {
+							for (let n of t) await v(e, _, n);
+						});
+					} catch {
+						for (let e of t) await f(e);
 					}
 				};
-				return yield* c.runForEach(kt(l, g.name, g.columnTypes), (e) => n.promise(async () => {
-					if (o++, f) {
-						h.push(e), h.length >= m && await y();
+				return yield* c.runForEach(kt(l, _.name, _.columnTypes), (e) => n.promise(async () => {
+					if (o++, p) {
+						g.push(e), g.length >= h && await x();
 						return;
 					}
-					await d(e);
-				})), yield* n.promise(y), {
+					if (C) {
+						E.push(e), E.length >= S && await D();
+						return;
+					}
+					await f(e);
+				})), yield* n.promise(D), yield* n.promise(x), {
 					rowCount: o,
 					checksum: i.digest("hex")
 				};
-			}), { rowCount: x, checksum: S } = yield* ft("import", g.name, p, h, (e) => e.rowCount, b);
+			}), { rowCount: C, checksum: A } = yield* ft("import", _.name, p, g, (e) => e.rowCount, S);
 			if (l) {
-				if (S !== g.checksum) return yield* n.fail(new F({
-					what: `table ${g.name} checksum`,
-					expected: g.checksum,
-					actual: S
+				if (A !== _.checksum) return yield* n.fail(new z({
+					what: `table ${_.name} checksum`,
+					expected: _.checksum,
+					actual: A
 				}));
-				if (x !== g.rowCount) return yield* n.fail(new F({
-					what: `table ${g.name} rowCount`,
-					expected: String(g.rowCount),
-					actual: String(x)
+				if (C !== _.rowCount) return yield* n.fail(new z({
+					what: `table ${_.name} rowCount`,
+					expected: String(_.rowCount),
+					actual: String(C)
 				}));
 			}
 			K(t.onProgress, {
 				phase: "import",
-				table: g.name,
+				table: _.name,
 				index: p,
-				tableCount: h,
+				tableCount: g,
 				event: "done",
-				rowsDone: x,
-				total: g.rowCount
-			}), r && (a.length > y ? o.push({
-				name: g.name,
-				rowCount: x
-			}) : (m.tables[g.name] = {
-				rowCount: x,
-				checksum: g.checksum
-			}, yield* q(f, m)));
+				rowsDone: C,
+				total: _.rowCount
+			}), D++, E += C, r && (a.length > x ? o.push({
+				name: _.name,
+				rowCount: C
+			}) : (h.tables[_.name] = {
+				rowCount: C,
+				checksum: _.checksum
+			}, yield* q(m, h)));
 		}
-		if (a.length > 0 && (yield* x(e, a)), r && o.length > 0) {
+		if (a.length > 0 && (yield* C(e, a)), r && o.length > 0) {
 			for (let e of o) {
 				let t = s.tables.find((t) => t.name === e.name);
-				m.tables[e.name] = {
+				h.tables[e.name] = {
 					rowCount: e.rowCount,
 					checksum: t.checksum
 				};
 			}
-			yield* q(f, m);
+			yield* q(m, h);
 		}
-		if (d.length > 0) {
-			let e = d.length === s.tables.length;
-			t.onWarn?.(`resume: ${d.length} of ${s.tables.length} table(s) were already applied by an earlier run of THIS bundle directory, so this run wrote NO rows for them${e ? " — that is every table in the bundle, so nothing was written at all" : ""}. Tables: ${d.join(", ")}. Delete ${f} to force a full re-import.`);
+		if (f.length > 0) {
+			let e = f.length === s.tables.length;
+			t.onWarn?.(`resume: ${f.length} of ${s.tables.length} table(s) were already applied by an earlier run of THIS bundle directory, so this run wrote NO rows for them${e ? " — that is every table in the bundle, so nothing was written at all" : ""}. Tables: ${f.join(", ")}. Delete ${m} to force a full re-import.`);
 		}
 	});
-	if (t.atomic ? yield* n.tryPromise({
+	if (d ? yield* n.tryPromise({
 		try: () => t.store.transactional(async (t) => {
-			let i = await n.runPromiseExit(S(t, !1));
+			let i = await n.runPromiseExit(A(t, !1));
 			if (r.isFailure(i)) throw Error(e.pretty(i.cause));
 		}),
-		catch: (e) => new P({ reason: `atomic import failed (rolled back): ${String(e?.message ?? e)}` })
-	}) : yield* S(t.store, !0), t.assets && s.assets.index && !t.assetsAlreadyRestored) {
-		let e = t.assets, r = i.join(t.bundleDir, W), a = i.join(t.bundleDir, s.assets.index ?? "assets/index.ndjson"), o = w("bundle", () => E(a)).pipe(c.decodeText(), c.splitLines, c.filter((e) => e.trim().length > 0), c.map((e) => JSON.parse(e)));
-		yield* c.runForEach(o, (t) => t.key in m.assets ? n.void : Ke(e, r, t).pipe(n.andThen(n.sync(() => {
-			m.assets[t.key] = !0;
-		})), n.andThen(q(f, m))));
+		catch: (e) => new R({ reason: `atomic import failed (rolled back): ${String(e?.message ?? e)}` })
+	}) : yield* A(t.store, !0), t.assets && s.assets.index && !t.assetsAlreadyRestored) {
+		let e = t.assets, r = i.join(t.bundleDir, G), a = i.join(t.bundleDir, s.assets.index ?? "assets/index.ndjson"), o = w("bundle", () => j(a)).pipe(c.decodeText(), c.splitLines, c.filter((e) => e.trim().length > 0), c.map((e) => JSON.parse(e)));
+		yield* c.runForEach(o, (t) => t.key in h.assets ? n.void : We(e, r, t).pipe(n.andThen(n.sync(() => {
+			h.assets[t.key] = !0;
+		})), n.andThen(q(m, h))));
 	}
-	return s;
-}), nn = (e) => e, rn = (e) => {
+	return {
+		manifest: s,
+		tablesWritten: D,
+		rowsWritten: E,
+		tablesSkipped: k,
+		rowsSkipped: O,
+		fullyResumed: D === 0 && k > 0
+	};
+}), sn = (e) => e, cn = (e) => {
 	if (e.allowLive || e.liveInstance === null || e.sameTarget === "different") return { refuse: !1 };
 	let t = e.targetLabel === void 0 ? "" : ` Target: ${e.targetLabel}.`, n = e.sameTarget === "same" ? " That instance is connected to the SAME database." : " We could not confirm which database that instance is connected to, so this is refused on the conservative reading — an older instance, or one whose connection could not be parsed, reports nothing to compare.";
 	return {
 		refuse: !0,
 		message: `refusing to write into a target with a LIVE instance (${e.liveInstance}).${t}${n} A direct import is an uncoordinated concurrent writer — readers see partial state, the reactive layer either storms or goes stale, and rows race with live writes. Re-run with --allow-live to override, or use a live-safe strategy (shadow-swap for replace, or the api target).`
 	};
-}, Y = Buffer.from("VBUNDLE2"), an = 0, on = 1, sn = 2, cn = 32, ln = async (e) => {
+}, Y = Buffer.from("VBUNDLE2"), ln = 0, un = 1, dn = 2, fn = 32, pn = async (e) => {
 	let t = [], n = async (r) => {
 		let i;
 		try {
-			i = await ce(k(e, r), { withFileTypes: !0 });
+			i = await ae(M(e, r), { withFileTypes: !0 });
 		} catch {
 			return;
 		}
@@ -1161,21 +1252,21 @@ voltro data import <this-directory> --target api --api-url <url> --token <secret
 		}
 	};
 	return await n(""), t.sort();
-}, un = (e, t) => {
+}, mn = (e, t) => {
 	let n = Buffer.from(e, "utf8"), r = Buffer.alloc(5 + n.length + 8);
-	return r.writeUInt8(on, 0), r.writeUInt32BE(n.length, 1), n.copy(r, 5), r.writeBigUInt64BE(BigInt(t), 5 + n.length), r;
-}, dn = (e, t, n) => {
+	return r.writeUInt8(un, 0), r.writeUInt32BE(n.length, 1), n.copy(r, 5), r.writeBigUInt64BE(BigInt(t), 5 + n.length), r;
+}, hn = (e, t, n) => {
 	let r = Buffer.from(e, "utf8"), i = Buffer.from(t, "utf8"), a = Buffer.alloc(5 + r.length + 2 + i.length + 8), o = 0;
-	return a.writeUInt8(sn, o), o += 1, a.writeUInt32BE(r.length, o), o += 4, r.copy(a, o), o += r.length, a.writeUInt16BE(i.length, o), o += 2, i.copy(a, o), o += i.length, a.writeBigUInt64BE(BigInt(n), o), a;
+	return a.writeUInt8(dn, o), o += 1, a.writeUInt32BE(r.length, o), o += 4, r.copy(a, o), o += r.length, a.writeUInt16BE(i.length, o), o += 2, i.copy(a, o), o += i.length, a.writeBigUInt64BE(BigInt(n), o), a;
 };
-async function* fn(e) {
+async function* gn(e) {
 	yield new Uint8Array(Y);
-	for (let t of await ln(e.dir)) {
-		let n = k(e.dir, t), r = await le(n);
-		if (yield new Uint8Array(un(t, r.size)), r.size > 0) for await (let e of E(n)) yield new Uint8Array(e);
+	for (let t of await pn(e.dir)) {
+		let n = M(e.dir, t), r = await oe(n);
+		if (yield new Uint8Array(mn(t, r.size)), r.size > 0) for await (let e of j(n)) yield new Uint8Array(e);
 	}
 	if (e.blobs) for await (let t of e.blobs.list()) {
-		yield new Uint8Array(dn(t.key, t.contentType, t.size));
+		yield new Uint8Array(hn(t.key, t.contentType, t.size));
 		let n = y("sha256"), r = 0;
 		for await (let i of e.blobs.open(t.key)) {
 			let e = Buffer.from(i);
@@ -1184,11 +1275,11 @@ async function* fn(e) {
 		if (r !== t.size) throw Error(`blob '${t.key}' size mismatch: header ${t.size}, streamed ${r}`);
 		yield new Uint8Array(n.digest());
 	}
-	yield new Uint8Array(Buffer.from([an]));
+	yield new Uint8Array(Buffer.from([ln]));
 }
-var pn = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), mn = (e) => new Promise((t) => e.end(t)), hn = async (e, t) => {
-	let n = pe(t.dir);
-	await O(n, { recursive: !0 });
+var _n = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), vn = (e) => new Promise((t) => e.end(t)), yn = async (e, t) => {
+	let n = ue(t.dir);
+	await ie(n, { recursive: !0 });
 	let r = Buffer.alloc(0), i = e[Symbol.asyncIterator](), a = !1, o = async () => {
 		let { value: e, done: t } = await i.next();
 		return t ? (a = !0, !1) : (r = r.length === 0 ? Buffer.from(e) : Buffer.concat([r, Buffer.from(e)]), !0);
@@ -1203,24 +1294,24 @@ var pn = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), mn
 		for (;;) {
 			await s(1);
 			let e = c(1).readUInt8(0);
-			if (e === an) return;
-			if (e === on) {
+			if (e === ln) return;
+			if (e === un) {
 				await s(4);
 				let e = c(4).readUInt32BE(0);
 				await s(e);
 				let t = c(e).toString("utf8");
 				await s(8);
-				let i = c(8).readBigUInt64BE(0), a = pe(n, t);
-				if (a !== n && !a.startsWith(n + me)) throw Error(`archive path '${t}' escapes the destination`);
-				await O(fe(a), { recursive: !0 });
-				let o = D(a);
+				let i = c(8).readBigUInt64BE(0), a = ue(n, t);
+				if (a !== n && !a.startsWith(n + de)) throw Error(`archive path '${t}' escapes the destination`);
+				await ie(le(a), { recursive: !0 });
+				let o = te(a);
 				for (; i > 0n;) {
 					r.length === 0 && await s(1);
 					let e = i < BigInt(r.length) ? Number(i) : r.length;
-					await pn(o, c(e)), i -= BigInt(e);
+					await _n(o, c(e)), i -= BigInt(e);
 				}
-				await mn(o);
-			} else if (e === sn) {
+				await vn(o);
+			} else if (e === dn) {
 				await s(4);
 				let e = c(4).readUInt32BE(0);
 				await s(e);
@@ -1230,24 +1321,24 @@ var pn = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), mn
 				await s(i);
 				let a = c(i).toString("utf8");
 				await s(8);
-				let o = c(8).readBigUInt64BE(0), l = await t.blobs.has(n), u = y("sha256"), d = new re(), f = l ? Promise.resolve() : t.blobs.write(n, d, {
+				let o = c(8).readBigUInt64BE(0), l = await t.blobs.has(n), u = y("sha256"), d = new k(), f = l ? Promise.resolve() : t.blobs.write(n, d, {
 					contentType: a,
 					size: Number(o)
 				}), p = o;
 				for (; p > 0n;) {
 					r.length === 0 && await s(1);
 					let e = p < BigInt(r.length) ? Number(p) : r.length, t = c(e);
-					u.update(t), l || await pn(d, t), p -= BigInt(e);
+					u.update(t), l || await _n(d, t), p -= BigInt(e);
 				}
-				l ? d.destroy() : await mn(d), await f, await s(cn);
-				let m = c(cn);
+				l ? d.destroy() : await vn(d), await f, await s(fn);
+				let m = c(fn);
 				if (!u.digest().equals(m)) throw Error(`blob '${n}' failed integrity (sha mismatch)`);
 			} else throw Error(`unknown bundle entry kind ${e}`);
 		}
 	} finally {
 		a || await Promise.resolve(i.return?.()).catch(() => void 0);
 	}
-}, gn = async (e, t) => {
+}, bn = async (e, t) => {
 	let n = new Set(t), r = /* @__PURE__ */ new Map(), i = Buffer.alloc(0), a = e[Symbol.asyncIterator](), o = async () => {
 		let { value: e, done: t } = await a.next();
 		return !t && (i = i.length === 0 ? Buffer.from(e) : Buffer.concat([i, Buffer.from(e)]), !0);
@@ -1269,8 +1360,8 @@ var pn = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), mn
 	if (!await s(Y.length) || !c(Y.length).equals(Y)) throw Error("not a bundle archive (bad magic)");
 	for (; await s(1);) {
 		let e = c(1).readUInt8(0);
-		if (e === an || e === sn) break;
-		if (e !== on) throw Error(`unknown bundle entry kind ${e}`);
+		if (e === ln || e === dn) break;
+		if (e !== un) throw Error(`unknown bundle entry kind ${e}`);
 		if (!await s(4)) break;
 		let t = c(4).readUInt32BE(0);
 		if (!await s(t)) break;
@@ -1280,22 +1371,22 @@ var pn = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), mn
 		if (a === null || n.has(i) && (r.set(i, a), n.delete(i), n.size === 0)) break;
 	}
 	return r;
-}, _n = (e, t) => hn(e, {
+}, xn = (e, t) => yn(e, {
 	dir: t,
-	blobs: vn(t)
-}), vn = (e) => {
+	blobs: Sn(t)
+}), Sn = (e) => {
 	let t = /* @__PURE__ */ new Set();
 	return {
 		has: async (e) => t.has(e),
 		write: async (n, r, i) => {
-			let a = await import("node:fs/promises"), { pipeline: o } = await import("node:stream/promises"), { Transform: s } = await import("node:stream"), c = k(e, "assets");
-			await O(c, { recursive: !0 });
+			let a = await import("node:fs/promises"), { pipeline: o } = await import("node:stream/promises"), { Transform: s } = await import("node:stream"), c = M(e, "assets");
+			await ie(c, { recursive: !0 });
 			let l = y("sha256"), u = 0, d = new s({ transform(e, t, n) {
 				l.update(e), u += e.length, n(null, e);
-			} }), f = k(c, `.tmp-${Date.now()}-${t.size}`);
-			await o(r, d, D(f));
+			} }), f = M(c, `.tmp-${Date.now()}-${t.size}`);
+			await o(r, d, te(f));
 			let p = l.digest("hex");
-			await a.rename(f, k(c, p)), await a.appendFile(k(c, "index.ndjson"), `${JSON.stringify({
+			await a.rename(f, M(c, p)), await a.appendFile(M(c, "index.ndjson"), `${JSON.stringify({
 				key: n,
 				sha256: p,
 				size: u,
@@ -1303,33 +1394,33 @@ var pn = (e, t) => new Promise((n, r) => e.write(t, (e) => e ? r(e) : n())), mn
 			})}\n`), t.add(n);
 		}
 	};
-}, yn = he(S), bn = Buffer.from("VENC1\0\0\0"), xn = 32, Sn = 16, Cn = 7, X = 16, wn = 262144, Z = {
+}, Cn = fe(S), wn = Buffer.from("VENC1\0\0\0"), Tn = 32, En = 16, Dn = 7, X = 16, On = 262144, Z = {
 	N: 32768,
 	r: 8,
 	p: 1
-}, Tn = 134217728, Q = 43, En = (e, t, n) => {
+}, kn = 134217728, Q = 43, An = (e, t, n) => {
 	let r = Buffer.alloc(12);
-	return e.copy(r, 0, 0, Cn), r.writeUInt32BE(t >>> 0, Cn), r.writeUInt8(+!!n, 11), r;
+	return e.copy(r, 0, 0, Dn), r.writeUInt32BE(t >>> 0, Dn), r.writeUInt8(+!!n, 11), r;
 };
-async function* Dn(e, t) {
+async function* jn(e, t) {
 	if (!t) throw Error("encryptStream: a non-empty passphrase is required");
-	let n = x(Sn), r = x(Cn), i = await yn(t, n, xn, {
+	let n = x(En), r = x(Dn), i = await Cn(t, n, Tn, {
 		...Z,
-		maxmem: Tn
+		maxmem: kn
 	}), a = Buffer.alloc(Q);
-	bn.copy(a, 0), a.writeUInt32BE(Z.N, 8), a.writeUInt32BE(Z.r, 12), a.writeUInt32BE(Z.p, 16), n.copy(a, 20), r.copy(a, 36), yield new Uint8Array(a);
+	wn.copy(a, 0), a.writeUInt32BE(Z.N, 8), a.writeUInt32BE(Z.r, 12), a.writeUInt32BE(Z.p, 16), n.copy(a, 20), r.copy(a, 36), yield new Uint8Array(a);
 	let o = 0, s = (e, t) => {
-		let n = _("aes-256-gcm", i, En(r, o, t));
+		let n = _("aes-256-gcm", i, An(r, o, t));
 		o === 0 && n.setAAD(a);
 		let s = Buffer.concat([n.update(e), n.final()]), c = n.getAuthTag();
 		o++;
 		let l = Buffer.alloc(5 + s.length + X);
 		return l.writeUInt8(+!!t, 0), l.writeUInt32BE(s.length + X, 1), s.copy(l, 5), c.copy(l, 5 + s.length), new Uint8Array(l);
 	}, c = Buffer.alloc(0);
-	for await (let t of e) for (c = c.length === 0 ? Buffer.from(t) : Buffer.concat([c, Buffer.from(t)]); c.length > wn;) yield s(c.subarray(0, wn), !1), c = c.subarray(wn);
+	for await (let t of e) for (c = c.length === 0 ? Buffer.from(t) : Buffer.concat([c, Buffer.from(t)]); c.length > On;) yield s(c.subarray(0, On), !1), c = c.subarray(On);
 	yield s(c, !0);
 }
-async function* On(e, t) {
+async function* Mn(e, t) {
 	if (!t) throw Error("decryptStream: a non-empty passphrase is required");
 	let n = e[Symbol.asyncIterator](), r = Buffer.alloc(0), i = !1, a = async () => {
 		let { value: e, done: t } = await n.next();
@@ -1340,12 +1431,12 @@ async function* On(e, t) {
 	};
 	if (!await o(Q)) throw Error("encrypted bundle truncated (no header)");
 	let s = r.subarray(0, Q);
-	if (!s.subarray(0, 8).equals(bn)) throw Error("not an encrypted bundle (bad magic / wrong passphrase target)");
-	let c = s.readUInt32BE(8), l = s.readUInt32BE(12), u = s.readUInt32BE(16), d = Buffer.from(s.subarray(20, 36)), f = Buffer.from(s.subarray(36, Q)), p = await yn(t, d, xn, {
+	if (!s.subarray(0, 8).equals(wn)) throw Error("not an encrypted bundle (bad magic / wrong passphrase target)");
+	let c = s.readUInt32BE(8), l = s.readUInt32BE(12), u = s.readUInt32BE(16), d = Buffer.from(s.subarray(20, 36)), f = Buffer.from(s.subarray(36, Q)), p = await Cn(t, d, Tn, {
 		N: c,
 		r: l,
 		p: u,
-		maxmem: Tn
+		maxmem: kn
 	});
 	r = r.subarray(Q);
 	let m = 0, h = !1;
@@ -1360,7 +1451,7 @@ async function* On(e, t) {
 		if (!await o(5 + t)) throw Error("encrypted bundle truncated (frame body)");
 		let n = r.subarray(5, 5 + t - X), i = r.subarray(5 + t - X, 5 + t);
 		r = r.subarray(5 + t);
-		let a = v("aes-256-gcm", p, En(f, m, e));
+		let a = v("aes-256-gcm", p, An(f, m, e));
 		m === 0 && a.setAAD(s), a.setAuthTag(i);
 		let c = Buffer.concat([a.update(n), a.final()]);
 		m++, e && (h = !0), c.length > 0 && (yield new Uint8Array(c));
@@ -1368,7 +1459,7 @@ async function* On(e, t) {
 }
 //#endregion
 //#region src/blobStorage.ts
-var kn = (e, t) => ({
+var Nn = (e, t) => ({
 	list: () => {
 		let e = t();
 		return { async *[Symbol.asyncIterator]() {
@@ -1381,29 +1472,29 @@ var kn = (e, t) => ({
 		} };
 	},
 	open: (t) => ({ async *[Symbol.asyncIterator]() {
-		let r = await n.runPromise(ee(e, t)), i = await ne(r.stream);
+		let r = await n.runPromise(T(e, t)), i = await D(r.stream);
 		for await (let e of i) yield e instanceof Uint8Array ? e : new Uint8Array(e);
 	} })
-}), An = (e, t) => kn(e, () => h(t, {
+}), Pn = (e, t) => Nn(e, () => h(t, {
 	table: C,
 	chunkSize: 500
 }).pipe(c.map((e) => ({
 	key: String(e.key),
 	contentType: String(e.contentType ?? "application/octet-stream"),
 	size: Number(e.size ?? 0)
-})))), jn = (e) => ({
+})))), Fn = (e) => ({
 	has: (t) => n.runPromise(e.head(t).pipe(n.map((e) => e !== null))),
 	write: async (t, r, i) => {
-		let a = w("storage", () => ie.from(r));
-		await n.runPromise(te(e, t, a, {
+		let a = w("storage", () => A.from(r));
+		await n.runPromise(E(e, t, a, {
 			contentType: i.contentType,
 			totalSize: i.size
 		}));
 	}
-}), Mn = (e, t) => {
+}), In = (e, t) => {
 	let n = t === "dump" ? "mariadb-dump" : "mariadb", r = t === "dump" ? "mysqldump" : "mysql";
-	return e === "mariadb" && Nn(n) ? n : r;
-}, Nn = (e) => (process.env.PATH ?? "").split(de).filter((e) => e !== "").some((t) => oe(k(t, e))), Pn = (e) => {
+	return e === "mariadb" && Ln(n) ? n : r;
+}, Ln = (e) => (process.env.PATH ?? "").split(ce).filter((e) => e !== "").some((t) => ne(M(t, e))), Rn = (e) => {
 	switch (e) {
 		case "postgres": return "db.dump";
 		case "mysql":
@@ -1413,7 +1504,7 @@ var kn = (e, t) => ({
 		case "mssql": return "db.bacpac";
 		default: return "db.dump";
 	}
-}, Fn = (e) => e.filename ?? e.database ?? ((e.url ?? "").replace(/^file:/, "") || "app.sqlite"), $ = (e) => {
+}, zn = (e) => e.filename ?? e.database ?? ((e.url ?? "").replace(/^file:/, "") || "app.sqlite"), $ = (e) => {
 	if (e.host || e.database) return {
 		host: e.host ?? "localhost",
 		port: e.port ?? 3306,
@@ -1429,7 +1520,7 @@ var kn = (e, t) => ({
 		password: decodeURIComponent(t.password) || "",
 		database: t.pathname.replace(/^\//, "") || ""
 	};
-}, In = (e) => `Server=${e.host},${e.port};Database=${e.database};User ID=${e.username};Password=${e.password};TrustServerCertificate=True`, Ln = (e, t, n) => {
+}, Bn = (e) => `Server=${e.host},${e.port};Database=${e.database};User ID=${e.username};Password=${e.password};TrustServerCertificate=True`, Vn = (e, t, n) => {
 	switch (e) {
 		case "postgres": {
 			if (t.url) return {
@@ -1476,7 +1567,7 @@ var kn = (e, t) => ({
 			let r = $(t);
 			return {
 				kind: "spawn",
-				tool: Mn(e, "dump"),
+				tool: In(e, "dump"),
 				args: [
 					"--single-transaction",
 					"--routines",
@@ -1498,7 +1589,7 @@ var kn = (e, t) => ({
 		case "sqlite":
 		case "turso": return {
 			kind: "copy",
-			from: Fn(t),
+			from: zn(t),
 			to: n
 		};
 		case "mssql": return {
@@ -1506,7 +1597,7 @@ var kn = (e, t) => ({
 			tool: "sqlpackage",
 			args: [
 				"/Action:Export",
-				`/SourceConnectionString:${In($({
+				`/SourceConnectionString:${Bn($({
 					...t,
 					port: t.port ?? 1433
 				}))}`,
@@ -1514,12 +1605,12 @@ var kn = (e, t) => ({
 			],
 			env: {}
 		};
-		default: throw new L({
+		default: throw new V({
 			tool: "backup",
 			reason: `no native backup for dialect '${e}'`
 		});
 	}
-}, Rn = (e, t, n) => {
+}, Hn = (e, t, n) => {
 	switch (e) {
 		case "postgres": {
 			if (t.url) return {
@@ -1564,7 +1655,7 @@ var kn = (e, t) => ({
 			let r = $(t);
 			return {
 				kind: "spawn",
-				tool: Mn(e, "client"),
+				tool: In(e, "client"),
 				args: [
 					"--protocol=TCP",
 					"-h",
@@ -1583,14 +1674,14 @@ var kn = (e, t) => ({
 		case "turso": return {
 			kind: "copy",
 			from: n,
-			to: Fn(t)
+			to: zn(t)
 		};
 		case "mssql": return {
 			kind: "spawn",
 			tool: "sqlpackage",
 			args: [
 				"/Action:Import",
-				`/TargetConnectionString:${In($({
+				`/TargetConnectionString:${Bn($({
 					...t,
 					port: t.port ?? 1433
 				}))}`,
@@ -1598,18 +1689,18 @@ var kn = (e, t) => ({
 			],
 			env: {}
 		};
-		default: throw new L({
+		default: throw new V({
 			tool: "restore",
 			reason: `no native restore for dialect '${e}'`
 		});
 	}
-}, zn = (e) => e.kind === "copy" ? n.async((t) => {
-	ae(e.from, e.to, (r) => t(r ? n.fail(new L({
+}, Un = (e) => e.kind === "copy" ? n.async((t) => {
+	ee(e.from, e.to, (r) => t(r ? n.fail(new V({
 		tool: "copy",
 		reason: `copy ${e.from} → ${e.to}: ${r.message}`
 	})) : n.void));
 }) : n.async((t) => {
-	let r = ge(e.tool, [...e.args], {
+	let r = pe(e.tool, [...e.args], {
 		env: {
 			...process.env,
 			...e.env
@@ -1622,14 +1713,14 @@ var kn = (e, t) => ({
 	}), i = "";
 	r.stderr?.on("data", (e) => {
 		i += String(e);
-	}), e.stdoutFile && r.stdout && r.stdout.pipe(D(e.stdoutFile)), e.stdinFile && r.stdin && E(e.stdinFile).pipe(r.stdin);
+	}), e.stdoutFile && r.stdout && r.stdout.pipe(te(e.stdoutFile)), e.stdinFile && r.stdin && j(e.stdinFile).pipe(r.stdin);
 	let a = () => {
 		if (e.stdoutFile !== void 0) try {
-			se(e.stdoutFile);
+			re(e.stdoutFile);
 		} catch {}
 	};
 	r.on("error", (r) => {
-		a(), t(n.fail(new L({
+		a(), t(n.fail(new V({
 			tool: e.tool,
 			reason: `failed to launch (is '${e.tool}' installed + on PATH?): ${r.message}`
 		})));
@@ -1638,17 +1729,17 @@ var kn = (e, t) => ({
 			t(n.void);
 			return;
 		}
-		a(), t(n.fail(new L({
+		a(), t(n.fail(new V({
 			tool: e.tool,
-			reason: `exited with code ${r}` + (e.stdoutFile === void 0 ? "" : ` — the partial ${ue(e.stdoutFile)} was removed, so it cannot be mistaken for a backup`),
+			reason: `exited with code ${r}` + (e.stdoutFile === void 0 ? "" : ` — the partial ${se(e.stdoutFile)} was removed, so it cannot be mistaken for a backup`),
 			stderr: i.slice(-2e3)
 		})));
 	});
-}), Bn = (e) => typeof e == "object" && e ? "fake" in e ? `fake:${e.fake}` : "custom" : String(e), Vn = (e) => n.gen(function* () {
-	let t = yield* V(e.scope ?? { kind: "all" }, e.snapshot, {
+}), Wn = (e) => typeof e == "object" && e ? "fake" in e ? `fake:${e.fake}` : "custom" : String(e), Gn = (e) => n.gen(function* () {
+	let t = yield* Be(e.scope ?? { kind: "all" }, e.snapshot, {
 		store: e.store,
 		...e.tenantTables ? { tenantTables: e.tenantTables } : {}
-	}), r = At(t.tables, e.snapshot), i = e.classification ?? A(e.snapshot), a = e.sampleSize ?? 20, o = Ae(r.map((t) => ({
+	}), r = At(t.tables, e.snapshot), i = e.classification ?? N(e.snapshot), a = e.sampleSize ?? 20, o = Ee(r.map((t) => ({
 		name: t,
 		columns: (e.snapshot.tables.find((e) => e.name === t)?.columns ?? []).map((e) => ({
 			name: e.name,
@@ -1660,15 +1751,15 @@ var kn = (e, t) => ({
 			table: i,
 			chunkSize: a,
 			...r === void 0 ? {} : { where: r }
-		}).pipe(c.take(a), c.runCollect, n.map((e) => [...e])), d = u.map((t) => Ne(t, i, o.actions, e.masking.seed));
-		l.push(...Me(d, i, o.actions));
+		}).pipe(c.take(a), c.runCollect, n.map((e) => [...e])), d = u.map((t) => ke(t, i, o.actions, e.masking.seed));
+		l.push(...Oe(d, i, o.actions));
 		let f = u[0], p = d[0], m = [];
 		if (f && p) for (let [e, t] of Object.entries(o.actions)) {
 			if (!e.startsWith(`${i}.`) || t === "keep") continue;
 			let n = e.slice(i.length + 1);
 			m.push({
 				column: n,
-				action: Bn(t),
+				action: Wn(t),
 				before: f[n],
 				after: p[n]
 			});
@@ -1683,7 +1774,7 @@ var kn = (e, t) => ({
 		leaks: l,
 		unclassified: o.unclassified
 	};
-}), Hn = (e, t) => {
+}), Kn = (e, t) => {
 	let n = new Map(t.map((e) => [e.name, e])), r = [], i = {};
 	for (let t of e) {
 		let e = n.get(t.name);
@@ -1738,7 +1829,7 @@ var kn = (e, t) => ({
 		skipColumns: i,
 		refuse: r.some((e) => e.verdict === "refuse")
 	};
-}, Un = (e) => {
+}, qn = (e) => {
 	if (e.findings.length === 0) return ["  schema matches the bundle"];
 	let t = {
 		safe: "✓",
@@ -1749,4 +1840,4 @@ var kn = (e, t) => ({
 	return n.push(""), n.push(`  discarded: ${r("value-dropped")}   defaulted: ${r("filled-by-default")}   refused: ${r("refuse")}`), e.refuse && (n.push(""), n.push("  REFUSED — no row was written. These are the differences that would make"), n.push("  imported rows WRONG rather than merely incomplete.")), n;
 };
 //#endregion
-export { W as ASSETS_DIR, G as ASSET_INDEX_FILE, P as BundleError, Pe as CodecError, Fe as CompressionError, Be as CrossDialectError, U as DATA_DIR, ve as DEFAULT_CLASS_ACTIONS, Qe as FORMAT_VERSION, ze as ImportModeError, F as IntegrityError, ot as LEDGER_FILE, H as MANIFEST_FILE, Re as MaskingError, L as NativeToolError, Ie as RowsRefusedError, Le as SchemaDriftError, I as ScopeError, Oe as applyAction, rn as assessLiveImport, gt as assetDone, Pn as backupArtifactName, Ln as backupCommand, Ht as canonicalType, Gt as checkPortability, $t as checkSchemaDrift, A as classificationFromSnapshot, Hn as classifyImportDrift, Ye as compressionExt, z as computeSubsetIds, it as decodeManifest, Et as decodeRow, wt as decodeValue, On as decryptStream, nn as defineDataProfile, Qt as diffSnapshots, vn as dirBlobSink, pt as emptyLedger, rt as encodeManifest, Tt as encodeRow, St as encodeValue, Dn as encryptStream, Un as formatImportDrift, Kt as formatIssue, qe as hasZstd, Xe as makeCompressor, Ze as makeDecompressor, Ne as maskRow, kt as ndjsonToRows, fn as packBundle, gn as peekBundle, Je as pickCompression, Ae as planMasking, Vn as previewMasking, mt as readLedger, ye as resolveAction, V as resolveScope, Ke as restoreAssetFromCas, Rn as restoreCommand, Ot as rowsToNdjson, Vt as runExport, tn as runImport, zn as runNativeStep, Me as scanForLeaks, We as storageAssetSink, Ue as storageAssetSource, jn as storageBlobSink, kn as storageBlobSource, An as storageRefsBlobSource, He as subsetToScope, ht as tableDone, At as topoSortTables, hn as unpackBundle, _n as unpackBundleToDir, Ge as writeAssetToCas, q as writeLedger };
+export { G as ASSETS_DIR, at as ASSET_INDEX_FILE, R as BundleError, Ae as CodecError, je as CompressionError, Ie as CrossDialectError, it as DATA_DIR, he as DEFAULT_CLASS_ACTIONS, Xe as FORMAT_VERSION, Fe as ImportModeError, z as IntegrityError, ot as LEDGER_FILE, W as MANIFEST_FILE, Pe as MaskingError, V as NativeToolError, Me as RowsRefusedError, rn as SAVEPOINT_BATCH_SIZE, Ne as SchemaDriftError, B as ScopeError, we as applyAction, cn as assessLiveImport, gt as assetDone, Rn as backupArtifactName, Vn as backupCommand, Wt as canonicalType, qt as checkPortability, nn as checkSchemaDrift, N as classificationFromSnapshot, Kn as classifyImportDrift, qe as compressionExt, Re as computeSubsetIds, nt as decodeManifest, Et as decodeRow, wt as decodeValue, Mn as decryptStream, sn as defineDataProfile, tn as diffSnapshots, Sn as dirBlobSink, pt as emptyLedger, tt as encodeManifest, Tt as encodeRow, St as encodeValue, jn as encryptStream, qn as formatImportDrift, Jt as formatIssue, Ge as hasZstd, Je as makeCompressor, Ye as makeDecompressor, ke as maskRow, kt as ndjsonToRows, Ut as outsideReferenceRefusal, Ht as outsideReferencesInto, gn as packBundle, bn as peekBundle, Ke as pickCompression, Ee as planMasking, Gn as previewMasking, mt as readLedger, ge as resolveAction, Be as resolveScope, We as restoreAssetFromCas, Hn as restoreCommand, Ot as rowsToNdjson, Vt as runExport, on as runImport, Un as runNativeStep, Oe as scanForLeaks, He as storageAssetSink, Ve as storageAssetSource, Fn as storageBlobSink, Nn as storageBlobSource, Pn as storageRefsBlobSource, ze as subsetToScope, ht as tableDone, At as topoSortTables, yn as unpackBundle, xn as unpackBundleToDir, Ue as writeAssetToCas, q as writeLedger };