@voltro/database 0.84.0 → 0.86.0

package/dist/columns.js

@@ -0,0 +1,326 @@
+//#region src/columns.ts
+var e = (e) => {
+	let t = [];
+	for (let [n, r] of Object.entries(e.fields)) r.serverOnly === !0 && t.push(n);
+	return t;
+}, t = (e) => {
+	let t = [];
+	for (let [n, r] of Object.entries(e.fields)) r.crdtManaged === !0 && t.push(n);
+	return t;
+}, n = (e) => {
+	let t = [];
+	for (let [n, r] of Object.entries(e.fields)) {
+		let e = r.readableBy;
+		e !== void 0 && e.length > 0 && t.push({
+			column: n,
+			scopes: e
+		});
+	}
+	return t;
+}, r = (e) => {
+	let t = [];
+	for (let [n, r] of Object.entries(e.fields)) r.crdtManaged === !0 && t.push(n);
+	return t;
+}, i = class e {
+	definition;
+	constructor(e) {
+		this.definition = e;
+	}
+	rejectIfRaw(e) {
+		if (this.definition.type === "raw") throw Error(`raw(...) column rejects .${e}() — the DDL fragment is the single source of truth for type/nullability/default. Encode ${e === "nullable" ? "NULL" : e === "unique" ? "UNIQUE" : "DEFAULT"} directly in the raw fragment instead.`);
+	}
+	nullable() {
+		return this.rejectIfRaw("nullable"), new e({
+			...this.definition,
+			nullable: !0
+		});
+	}
+	externalId() {
+		if (this.rejectIfRaw("externalId"), this.definition.type === "reference" || this.definition.type === "id") throw Error(`.externalId() requires a scalar non-primary-key column (got ${this.definition.type}) — \`reference()\` is local by definition and \`id()\` identifies this row.`);
+		return new e({
+			...this.definition,
+			externalId: !0
+		});
+	}
+	encrypted() {
+		return this.rejectIfRaw("encrypted"), new e({
+			...this.definition,
+			encrypted: !0
+		});
+	}
+	serverOnly() {
+		if (this.rejectIfRaw("serverOnly"), this.definition.crdtManaged === !0) throw Error("serverOnly() on a CRDT column (crdtText()/crdtDoc()) is a contradiction: clients write CRDT updates and must read the merged state back. Remove serverOnly(), or use a plain bytes() column if only the server touches it.");
+		return new e({
+			...this.definition,
+			serverOnly: !0
+		});
+	}
+	readableBy(...t) {
+		if (this.rejectIfRaw("readableBy"), t.length === 0) throw Error(".readableBy() needs at least one scope — a column readable by nobody is .serverOnly(). List the scopes that may read it, e.g. .readableBy('billing:read').");
+		if (t.find((e) => typeof e != "string" || e.trim() === "") !== void 0) throw Error(`.readableBy(...) rejects a blank scope — every scope must be a non-empty string (a blank scope can never be held, so it would hide the column from everyone). Got: ${JSON.stringify(t)}.`);
+		let n = [...new Set(t)];
+		return new e({
+			...this.definition,
+			readableBy: n
+		});
+	}
+	version() {
+		if (this.rejectIfRaw("version"), this.definition.type !== "integer") throw Error(`.version() requires an integer() column (got ${this.definition.type}). The store increments it, so it has to be a number — and a timestamp version reintroduces exactly the clock problem optimistic locking exists to avoid: two writes in the same millisecond are indistinguishable, and replica clocks disagree.`);
+		return new e({
+			...this.definition,
+			versionColumn: !0,
+			hasDefault: !0,
+			defaultValue: 1
+		});
+	}
+	sensitive(t) {
+		return new e({
+			...this.definition,
+			sensitive: { class: t }
+		});
+	}
+	safe() {
+		return new e({
+			...this.definition,
+			safe: !0
+		});
+	}
+	unique(t) {
+		return this.rejectIfRaw("unique"), t?.dedup === void 0 ? new e({
+			...this.definition,
+			unique: !0
+		}) : new e({
+			...this.definition,
+			unique: !0,
+			uniqueSpec: { dedup: t.dedup }
+		});
+	}
+	default(t) {
+		return this.rejectIfRaw("default"), typeof t == "function" ? new e({
+			...this.definition,
+			hasDefault: !0,
+			defaultFactory: t
+		}) : new e({
+			...this.definition,
+			hasDefault: !0,
+			defaultValue: t
+		});
+	}
+	computed(t) {
+		return new e({
+			...this.definition,
+			computed: t
+		});
+	}
+	onUpdate(t) {
+		return new e({
+			...this.definition,
+			onUpdate: t
+		});
+	}
+	generatedAs(t, n) {
+		return new e({
+			...this.definition,
+			generatedAs: {
+				expr: t,
+				stored: n?.stored ?? !1
+			}
+		});
+	}
+	backfill(t, n) {
+		let r = typeof t == "function" ? {
+			kind: "js",
+			fn: t,
+			...n?.batchSize === void 0 ? {} : { batchSize: n.batchSize },
+			...n?.sleepMs === void 0 ? {} : { sleepMs: n.sleepMs }
+		} : {
+			kind: "sql",
+			sql: t,
+			...n?.batchSize === void 0 ? {} : { batchSize: n.batchSize },
+			...n?.sleepMs === void 0 ? {} : { sleepMs: n.sleepMs }
+		};
+		return new e({
+			...this.definition,
+			backfill: r
+		});
+	}
+	renamedFrom(t) {
+		return new e({
+			...this.definition,
+			renamedFrom: t
+		});
+	}
+	narrowedFrom(t, n) {
+		let r = n?.using === void 0 ? { from: t } : {
+			from: t,
+			using: n.using
+		};
+		return new e({
+			...this.definition,
+			narrowedFrom: r
+		});
+	}
+	oneOf(t) {
+		return new e({
+			...this.definition,
+			oneOf: t
+		});
+	}
+	maxLength(t) {
+		return new e({
+			...this.definition,
+			maxLength: t
+		});
+	}
+	check(t) {
+		let n = this.definition.checks ? [...this.definition.checks, t] : [t];
+		return new e({
+			...this.definition,
+			checks: n
+		});
+	}
+	__definition() {
+		return this.definition;
+	}
+}, a = (e) => new i({
+	type: e,
+	nullable: !1,
+	unique: !1,
+	hasDefault: !1
+});
+function o(e) {
+	return new i({
+		type: "id",
+		nullable: !1,
+		unique: !0,
+		hasDefault: !1,
+		idSchemeInput: e
+	});
+}
+var s = () => a("text"), c = () => a("integer"), l = () => a("real"), u = (e, t = 0) => {
+	if (!Number.isInteger(e) || e <= 0) throw Error(`decimal(${String(e)}, ${String(t)}): precision must be a positive integer (the total number of significant digits, e.g. decimal(12, 2)).`);
+	if (!Number.isInteger(t) || t < 0 || t > e) throw Error(`decimal(${String(e)}, ${String(t)}): scale must be an integer between 0 and precision (${e}).`);
+	return new i({
+		type: "decimal",
+		nullable: !1,
+		unique: !1,
+		hasDefault: !1,
+		precision: e,
+		scale: t,
+		sqliteDecimalEncoding: "sortable-v1"
+	});
+}, d = u, f = () => a("bigint"), p = (e, t) => {
+	if (t.length === 0) throw Error(`dbEnum('${e}', []): enum must have at least one value`);
+	return {
+		name: e,
+		values: t,
+		column: () => new i({
+			type: "enum",
+			nullable: !1,
+			unique: !1,
+			hasDefault: !1,
+			enumName: e,
+			enumValues: t
+		})
+	};
+}, m = () => a("boolean"), h = () => a("timestamp"), g = () => a("date"), _ = () => a("json"), v = () => a("bytes"), y = () => new i({
+	type: "bytes",
+	nullable: !0,
+	unique: !1,
+	hasDefault: !1,
+	crdtManaged: !0
+}), b = () => new i({
+	type: "bytes",
+	nullable: !0,
+	unique: !1,
+	hasDefault: !1,
+	crdtManaged: !0
+}), x = () => new i({
+	type: "bytes",
+	nullable: !0,
+	unique: !1,
+	hasDefault: !1,
+	crdtSealed: !0
+}), S = () => new i({
+	type: "bytes",
+	nullable: !0,
+	unique: !1,
+	hasDefault: !1,
+	crdtManaged: !0
+}), C = () => {
+	throw Error("selfReference(): the target is resolved by table() — a column built with selfReference() must be declared inside a table({ … }) literal, not read before the table exists");
+};
+function w(e) {
+	return T(C, e);
+}
+function T(e, t) {
+	return new i({
+		type: "reference",
+		nullable: !1,
+		unique: !1,
+		hasDefault: !1,
+		references: e,
+		referenceStorage: t?.storage ?? "text",
+		referenceColumn: t?.column ?? "id",
+		onDelete: t?.onDelete ?? "restrict",
+		refOnUpdate: t?.onUpdate ?? "noAction",
+		...t?.onSoftDelete === void 0 ? {} : { refOnSoftDelete: t.onSoftDelete },
+		fkAutoIndex: t?.index ?? !0,
+		...t?.orphanPolicy ? { orphanPolicy: t.orphanPolicy } : {}
+	});
+}
+var E = () => new i({
+	type: "text",
+	nullable: !0,
+	unique: !1,
+	hasDefault: !1,
+	dropped: !0
+}), D = (e) => Object.keys(e.fields).filter((t) => e.fields[t]?.dropped !== !0), O = (e, t) => {
+	if (!Number.isInteger(e) || e <= 0) throw Error(`vector(${String(e)}): dimension must be a positive integer (the embedding length, e.g. vector(1536)).`);
+	return new i({
+		type: "vector",
+		nullable: !1,
+		unique: !1,
+		hasDefault: !1,
+		vectorDim: e,
+		vectorPrecision: t?.precision ?? "float32"
+	});
+}, k = (e) => new i({
+	type: "array",
+	nullable: !1,
+	unique: !1,
+	hasDefault: !1,
+	arrayElement: e.__definition().type
+}), A = () => a("interval"), j = (e, t = 4326) => new i({
+	type: "text",
+	nullable: !1,
+	unique: !1,
+	hasDefault: !1,
+	spatial: {
+		kind: "geography",
+		geomKind: e,
+		srid: t
+	}
+}), M = (e, t = 4326) => new i({
+	type: "text",
+	nullable: !1,
+	unique: !1,
+	hasDefault: !1,
+	spatial: {
+		kind: "geometry",
+		geomKind: e,
+		srid: t
+	}
+}), N = (e) => new i({
+	type: "raw",
+	nullable: !1,
+	unique: !1,
+	hasDefault: !1,
+	rawDdl: e
+}), P = (e) => {
+	let t = {};
+	for (let [n, r] of Object.entries(e)) t[n] = r.__definition();
+	return t;
+};
+//#endregion
+export { i as ColumnBuilder, C as SELF_REFERENCE_TARGET, k as array, f as bigint, m as boolean, v as bytes, b as crdtCounter, S as crdtDoc, r as crdtManagedColumns, t as crdtManagedColumnsOf, x as crdtSealed, y as crdtText, g as date, p as dbEnum, u as decimal, E as dropped, j as geography, M as geometry, o as id, c as integer, A as interval, _ as json, P as materializeFields, d as numeric, D as persistedColumns, N as raw, n as readableByColumns, l as real, T as reference, w as selfReference, e as serverOnlyColumns, s as text, h as timestamp, O as vector };

package/dist/committedChanges.js

@@ -0,0 +1,12 @@
+//#region src/committedChanges.ts
+var e = Symbol.for("voltro.database.committedChanges"), t = globalThis, n = t[e] ??= /* @__PURE__ */ new WeakMap(), r = (e, t) => {
+	let r = {};
+	for (let t of e) n.set(t, r);
+	try {
+		for (let n of e) t(n);
+	} finally {
+		for (let t of e) n.delete(t);
+	}
+}, i = (e) => n.get(e);
+//#endregion
+export { i as committedChangeBatchOf, r as emitCommittedChanges };

package/dist/connectionIdentity.js

@@ -0,0 +1,36 @@
+import { createHash as e } from "node:crypto";
+//#region src/connectionIdentity.ts
+var t = {
+	postgres: 5432,
+	mysql: 3306,
+	mariadb: 3306,
+	mssql: 1433
+}, n = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"::1",
+	"[::1]",
+	"0.0.0.0"
+]), r = (e) => {
+	let r = e.host, i = e.port, a = e.database;
+	if (e.url !== void 0 && e.url !== "") try {
+		let t = new URL(e.url);
+		r ??= decodeURIComponent(t.hostname), i === void 0 && t.port !== "" && (i = Number(t.port)), a ??= decodeURIComponent(t.pathname.replace(/^\//, ""));
+	} catch {
+		return;
+	}
+	if (r === void 0 || r === "" || a === void 0 || a === "") return;
+	let o = i ?? t[(e.dialect ?? "").toLowerCase()];
+	if (o === void 0 || !Number.isFinite(o)) return;
+	let s = r.toLowerCase();
+	return {
+		host: n.has(s) ? "localhost" : s,
+		port: o,
+		database: a.toLowerCase()
+	};
+}, i = (t) => {
+	let n = r(t);
+	if (n !== void 0) return e("sha256").update(`${n.host}\u0000${n.port}\u0000${n.database}`).digest("hex").slice(0, 32);
+}, a = (e, t) => e === void 0 || t === void 0 ? "unknown" : e === t ? "same" : "different";
+//#endregion
+export { i as connectionIdentity, r as normaliseTarget, a as sameDatabase };

package/dist/coreTables.js

@@ -0,0 +1,16 @@
+import { id as e, text as t, timestamp as n } from "./columns.js";
+import { table as r } from "./table.js";
+//#region src/coreTables.ts
+var i = r("actors", {
+	id: e(),
+	kind: t().oneOf([
+		"user",
+		"serviceAccount",
+		"apiKey",
+		"system"
+	]).safe(),
+	displayName: t().nullable().sensitive("fullName"),
+	createdAt: n().default("now")
+});
+//#endregion
+export { i as actorsTable };

package/dist/coreTablesRegistry.js

@@ -0,0 +1,10 @@
+//#region src/coreTablesRegistry.ts
+var e = Symbol.for("@voltro/database/coreTablesRegistry"), t = globalThis, n = t[e] ?? (t[e] = {}), r = (e) => {
+	e.actors !== void 0 && (n.actors = e.actors), e.tenants !== void 0 && (n.tenants = e.tenants);
+}, i = (e, t) => () => {
+	let n = e();
+	if (n === void 0) throw Error(`core '${t}' table not registered; expected the framework CLI or your migrate step to call registerCoreTables({ ${t}: () => ${t}Table }) before the database handle is constructed`);
+	return n();
+}, a = () => i(() => n.actors, "actors"), o = () => i(() => n.tenants, "tenants");
+//#endregion
+export { r as registerCoreTables, a as requireActors, o as requireTenants };

package/dist/dataTransfers.js

@@ -0,0 +1,22 @@
+import { boolean as e, id as t, integer as n, text as r, timestamp as i } from "./columns.js";
+import { table as a } from "./table.js";
+//#region src/dataTransfers.ts
+var o = "_voltro_data_transfers", s = a(o, {
+	id: t({ prefix: "dimp" }),
+	startedAt: i().default("now"),
+	finishedAt: i().nullable(),
+	direction: r().default("import"),
+	mode: r(),
+	via: r(),
+	bundle: r().nullable(),
+	sourceFingerprint: r().nullable(),
+	tablesWritten: n().default(0),
+	rowsWritten: n().default(0),
+	failure: r().nullable(),
+	staged: e().nullable()
+}).renamedFrom("_voltro_data_imports").nonReactive(), c = (e) => {
+	let t = Number.isFinite(e.startedAt.getTime()) ? e.startedAt.toISOString() : "an unknown time", n = e.direction === "import" ? e.mode : `${e.direction} ${e.mode}`, r = e.failure === null ? e.finishedAt === null ? `${n} — started and never reported finishing` : e.direction === "backup" || e.direction === "restore" ? `${n} — finished${e.rowsWritten > 0 ? ` (${e.rowsWritten} blob(s))` : ""}` : `${n} — ${e.rowsWritten} row(s) across ${e.tablesWritten} table(s)` : `FAILED ${n} — ${e.failure}`, i = e.staged === null ? "" : e.staged ? " · staged (target untouched until the swap)" : " · NOT staged (target emptied first)";
+	return `${t} · ${r} · via ${e.via}${i}` + (e.bundle === null ? "" : ` · from ${e.bundle}`) + (e.sourceFingerprint === null ? "" : ` · source schema ${e.sourceFingerprint}`);
+};
+//#endregion
+export { o as DATA_TRANSFERS_TABLE, s as _voltroDataTransfersTable, c as describeTransferRun };

package/dist/dbCause.js

@@ -0,0 +1,222 @@
+import { Cause as e, Exit as t } from "effect";
+//#region src/dbCause.ts
+var n = (n) => e.isCause(n) ? n : t.isExit(n) && t.isFailure(n) ? n.cause : typeof n == "object" && n && e.isCause(n.voltroCause) ? n.voltroCause : void 0, r = (t) => {
+	let r = n(t);
+	return r === void 0 ? t : e.squash(r);
+}, i = (t, r = 0) => {
+	let a = r >= 4 ? void 0 : n(t);
+	if (a === void 0) return [t];
+	let o = a.reasons.flatMap((t) => e.isFailReason(t) ? [t.error] : e.isDieReason(t) ? [t.defect] : []);
+	if (o.length === 0) return [e.squash(a)];
+	let s = [];
+	for (let e of o.slice(0, 8)) s.push(...i(e, r + 1));
+	return s;
+}, a = (e) => e.dbCode !== void 0 || e.dbErrno !== void 0 || e.dbNumber !== void 0 || e.dbSqlState !== void 0 || e.dbConstraint !== void 0, o = {
+	9: "SQLITE_INTERRUPT",
+	275: "SQLITE_CONSTRAINT_CHECK",
+	787: "SQLITE_CONSTRAINT_FOREIGNKEY",
+	1299: "SQLITE_CONSTRAINT_NOTNULL",
+	1555: "SQLITE_CONSTRAINT_PRIMARYKEY",
+	2067: "SQLITE_CONSTRAINT_UNIQUE"
+}, s = (e) => {
+	let t = {}, n = [], i = r(e);
+	for (let e = 0; e < 8 && typeof i == "object" && i; e++) {
+		let e = i;
+		t.dbCode === void 0 && (typeof e.code == "string" || typeof e.code == "number") && (t.dbCode = e.code), t.dbErrno === void 0 && typeof e.errno == "number" && (t.dbErrno = e.errno), t.dbErrno === void 0 && typeof e.errcode == "number" && (t.dbErrno = e.errcode), t.dbCode === "ERR_SQLITE_ERROR" && typeof t.dbErrno == "number" && (t.dbCode = o[t.dbErrno] ?? t.dbCode), t.dbNumber === void 0 && typeof e.number == "number" && (t.dbNumber = e.number), t.dbSqlState === void 0 && typeof e.sqlState == "string" && (t.dbSqlState = e.sqlState), t.dbBindings === void 0 && typeof e.voltroBindings == "string" && (t.dbBindings = e.voltroBindings), t.dbStatement === void 0 && typeof e.sql == "string" && e.sql.includes("?") && (t.dbStatement = e.sql, t.dbPlaceholders = (e.sql.match(/\?/g) ?? []).length), t.dbFatal === void 0 && typeof e.fatal == "boolean" && (t.dbFatal = e.fatal), t.dbConstraint === void 0 && typeof e.constraint == "string" && (t.dbConstraint = e.constraint), t.dbTable === void 0 && typeof e.table == "string" && (t.dbTable = e.table), t.dbColumn === void 0 && typeof e.column == "string" && (t.dbColumn = e.column), t.dbSchema === void 0 && typeof e.schema == "string" && (t.dbSchema = e.schema);
+		let a = e.sqlMessage ?? e.detail;
+		t.dbMessage === void 0 && typeof a == "string" && (t.dbMessage = a);
+		let s = typeof e.constructor == "function" ? e.constructor.name : void 0, c = typeof e._tag == "string" && e._tag || typeof e.name == "string" && e.name || (typeof s == "string" && s !== "Object" ? s : void 0), l = typeof e.message == "string" ? e.message : void 0;
+		(c || l) && n.push(`${c || "Error"}${l ? `: ${l.slice(0, 200)}` : ""}`), i = r(e.reason ?? e.cause);
+	}
+	return n.length > 0 && (t.dbCauseChain = n.join(" ← "), t.dbMessage === void 0 && (t.dbMessage = n[n.length - 1])), t;
+}, c = (e) => {
+	let t = i(e).map(s);
+	if (t.length <= 1) return t[0] ?? {};
+	let n = t.find(a) ?? t[0], r = t.filter((e) => e !== n).map((e) => e.dbCauseChain).filter((e) => typeof e == "string");
+	if (r.length === 0) return n;
+	let o = typeof n.dbCauseChain == "string" ? n.dbCauseChain : void 0;
+	return {
+		...n,
+		dbCauseChain: [o, ...r].filter(Boolean).join(" ‖ ")
+	};
+}, l = (e, t) => {
+	let n = f(e);
+	if (n !== void 0) return n;
+	let r = c(e), i = b(r, t);
+	if (i !== void 0) {
+		let e = i.constraint ?? i.column;
+		return e === void 0 ? i.kind : `${i.kind}: ${e}`;
+	}
+	let a = r.dbCode ?? r.dbSqlState ?? r.dbErrno ?? r.dbNumber, o = h(e);
+	return a !== void 0 && p.test(String(a)) ? `${o} (${String(a)})` : o;
+}, u = Symbol.for("@voltro/database/authoredMessage"), d = (e, t) => {
+	let n = t === void 0 ? Error(e) : Error(e, t);
+	return Object.defineProperty(n, u, {
+		value: !0,
+		enumerable: !1
+	}), n;
+}, f = (e) => {
+	for (let t of i(e)) {
+		let e = t;
+		for (let t = 0; typeof e == "object" && e && t < 8; t += 1) {
+			if (e[u] === !0) {
+				let t = e.message;
+				if (typeof t == "string" && t.length > 0) return t;
+			}
+			e = e.cause;
+		}
+	}
+}, p = /^[A-Za-z0-9_]{1,32}$/, m = /^[A-Za-z_][A-Za-z0-9_]{0,63}$/, h = (e) => {
+	let t = e?._tag, n = e?.name, r = (typeof t == "string" ? t : typeof n == "string" ? n : "").split(/[^A-Za-z0-9_]+/).filter(Boolean).pop();
+	return r !== void 0 && m.test(r) ? r : "unknown";
+}, g = /^[A-Za-z_][A-Za-z0-9_$]*$/, _ = (e) => e !== void 0 && e.length <= 128 && g.test(e) ? e : void 0, v = (e) => e === void 0 ? void 0 : e.split(".").pop() ?? e, y = (e, ...t) => {
+	for (let n of t) {
+		let t = n.exec(e);
+		if (t?.[1] !== void 0) return t[1];
+	}
+}, b = (e, t) => {
+	let n = e.dbCode, r = e.dbErrno, i = e.dbNumber, a = typeof e.dbMessage == "string" ? e.dbMessage : "", o = `${typeof e.dbCauseChain == "string" ? e.dbCauseChain : ""} ${a}`;
+	if (n === "23503") {
+		let t = _(e.dbConstraint);
+		return {
+			kind: /is still referenced from table/i.test(o) ? "foreignKeyInUse" : "foreignKey",
+			...t === void 0 ? {} : { constraint: t }
+		};
+	}
+	if (n === "23505") {
+		let t = _(e.dbConstraint);
+		return {
+			kind: "unique",
+			...t === void 0 ? {} : { constraint: t }
+		};
+	}
+	if (n === "23502") {
+		let t = _(e.dbColumn);
+		return {
+			kind: "notNull",
+			...t === void 0 ? {} : { column: t }
+		};
+	}
+	if (n === "23514") {
+		let t = _(e.dbConstraint);
+		return {
+			kind: "check",
+			...t === void 0 ? {} : { constraint: t }
+		};
+	}
+	if (r === 1452 || r === 1451) {
+		let e = _(y(o, /CONSTRAINT `([^`]+)`/));
+		return {
+			kind: r === 1451 ? "foreignKeyInUse" : "foreignKey",
+			...e === void 0 ? {} : { constraint: e }
+		};
+	}
+	if (r === 1062) {
+		let e = _(v(y(o, /for key '([^']+)'/)));
+		return {
+			kind: "unique",
+			...e === void 0 ? {} : { constraint: e }
+		};
+	}
+	if (r === 1048 || r === 1364) {
+		let e = _(y(o, /Column '([^']+)' cannot be null/, /Field '([^']+)' doesn't have a default value/));
+		return {
+			kind: "notNull",
+			...e === void 0 ? {} : { column: e }
+		};
+	}
+	if (r === 3819 || r === 4025) {
+		let e = _(y(o, /Check constraint '([^']+)'/, /CONSTRAINT `([^`]+)` failed/));
+		return {
+			kind: "check",
+			...e === void 0 ? {} : { constraint: e }
+		};
+	}
+	if (i === 547) {
+		let e = y(o, /(?:FOREIGN KEY|REFERENCE) constraint "([^"]+)"/), t = y(o, /CHECK constraint "([^"]+)"/);
+		if (t !== void 0 && e === void 0) {
+			let e = _(t);
+			return {
+				kind: "check",
+				...e === void 0 ? {} : { constraint: e }
+			};
+		}
+		let n = /REFERENCE constraint/.test(o), r = _(e);
+		return {
+			kind: n ? "foreignKeyInUse" : "foreignKey",
+			...r === void 0 ? {} : { constraint: r }
+		};
+	}
+	if (i === 2627 || i === 2601) {
+		let e = _(y(o, /(?:UNIQUE KEY|PRIMARY KEY) constraint '([^']+)'/, /index '([^']+)'/));
+		return {
+			kind: "unique",
+			...e === void 0 ? {} : { constraint: e }
+		};
+	}
+	if (i === 515) {
+		let e = _(y(o, /Cannot insert the value NULL into column '([^']+)'/));
+		return {
+			kind: "notNull",
+			...e === void 0 ? {} : { column: e }
+		};
+	}
+	if (n === "SQLITE_CONSTRAINT_FOREIGNKEY") return { kind: t === "delete" || t === "deleteMany" || t === "hardDelete" ? "foreignKeyInUse" : "foreignKey" };
+	if (n === "SQLITE_CONSTRAINT_UNIQUE" || n === "SQLITE_CONSTRAINT_PRIMARYKEY") {
+		let e = _(v(y(o, /UNIQUE constraint failed: ([^,\s]+)/)));
+		return {
+			kind: "unique",
+			...e === void 0 ? {} : { column: e }
+		};
+	}
+	if (n === "SQLITE_CONSTRAINT_NOTNULL") {
+		let e = _(v(y(o, /NOT NULL constraint failed: ([^,\s]+)/)));
+		return {
+			kind: "notNull",
+			...e === void 0 ? {} : { column: e }
+		};
+	}
+	if (n === "SQLITE_CONSTRAINT_CHECK") {
+		let e = _(y(a, /CHECK constraint failed: (.+)$/));
+		return {
+			kind: "check",
+			...e === void 0 ? {} : { constraint: e }
+		};
+	}
+}, x = (e) => {
+	let t = b(e)?.kind;
+	return t === "foreignKey" || t === "foreignKeyInUse";
+}, S = (e) => {
+	let t = e.dbCode, n = e.dbErrno;
+	return t === "57014" || n === 3024 || n === 1969 || t === "ETIMEOUT" || t === "SQLITE_INTERRUPT";
+}, C = (e) => {
+	if (e.dbErrno !== 1366) return;
+	let t = `${typeof e.dbCauseChain == "string" ? e.dbCauseChain : ""} ${typeof e.dbMessage == "string" ? e.dbMessage : ""}`;
+	if (/Incorrect string value: '\\x(F[0-4])/i.exec(t) === null) return;
+	let n = y(t, /for column [`']?(?:[^`'.]+[`']?\.[`']?)*([^`'.]+)[`']? at row/);
+	return `${n === void 0 ? "the column" : `column '${n}'`} is stored in a character set that cannot hold a 4-byte character (utf8mb3). Declare the store's character set in app.config.ts — store: { dialect: 'mariadb' | 'mysql', charset: 'utf8mb4' } — and run \`voltro db plan\`: every declared table is created with it and converted to it.`;
+}, w = (e) => {
+	let t = c(e), n = [
+		t.dbCode === void 0 ? void 0 : `code=${String(t.dbCode)}`,
+		t.dbErrno === void 0 ? void 0 : `errno=${String(t.dbErrno)}`,
+		t.dbNumber === void 0 ? void 0 : `number=${String(t.dbNumber)}`,
+		t.dbSqlState === void 0 ? void 0 : `sqlState=${String(t.dbSqlState)}`,
+		t.dbConstraint === void 0 ? void 0 : `constraint=${String(t.dbConstraint)}`,
+		t.dbPlaceholders === void 0 ? void 0 : `placeholders=${String(t.dbPlaceholders)}`
+	].filter((e) => e !== void 0), r = typeof e?.message == "string" ? e.message : void 0, i = typeof t.dbMessage == "string" ? t.dbMessage : void 0, a = i === void 0 ? void 0 : n.length > 0 || i !== r && i !== `Error: ${String(r)}` ? i : void 0, o = typeof t.dbBindings == "string" ? `\n  bindings:  ${t.dbBindings}` : "", s = typeof t.dbStatement == "string" ? `\n  statement: ${t.dbStatement.length <= 400 ? t.dbStatement : `${t.dbStatement.slice(0, 400)}…`}` : "";
+	if (a === void 0 && n.length === 0) return;
+	let l = C(t), u = l === void 0 ? "" : `\n  hint: ${l}`;
+	return [a, n.length > 0 ? `[${n.join(" ")}]` : void 0].filter((e) => e !== void 0 && e !== "").join(" ") + u + s + o;
+}, T = (e) => Object.entries(e).map(([e, t]) => `${e}:${E(t)}`).join(" "), E = (e) => {
+	if (e === null) return "null";
+	if (e === void 0) return "undefined";
+	if (typeof e == "bigint") return "bigint";
+	if (typeof e != "object") return typeof e;
+	if (e instanceof Date) return Number.isNaN(e.getTime()) ? "Date(Invalid)" : "Date";
+	if (Array.isArray(e)) return "Array";
+	if (globalThis.Buffer !== void 0 && globalThis.Buffer.isBuffer(e)) return "Buffer";
+	let t = e.constructor?.name;
+	return typeof t == "string" && t !== "" ? t : "Object";
+};
+//#endregion
+export { d as authoredError, f as authoredMessageOf, i as causeBranches, b as classifyConstraintViolation, C as describeCharsetRefusal, w as describeDriverError, T as describeRowBindings, c as extractDbCause, x as isForeignKeyViolation, S as isQueryTimeout, l as wireSafeCause };