@voltro/database 0.85.0 → 0.86.0

package/dist/migrations/squash.js

@@ -0,0 +1,81 @@
+import { withMigrationLock as e } from "./lock.js";
+import { withMigrationTransaction as t } from "./transactionCause.js";
+import { Effect as n } from "effect";
+import { createHash as r, randomUUID as i } from "node:crypto";
+import { SqlClient as a } from "effect/sql";
+//#region src/migrations/squash.ts
+var o = (e) => n.gen(function* () {
+	let t = yield* a.SqlClient;
+	if (!Number.isFinite(Date.parse(e.before))) return yield* n.fail(/* @__PURE__ */ Error("squash: cut-off must be a valid date"));
+	let i = yield* t`
+      SELECT id, fingerprint, ${t("appliedAt")} FROM _voltro_migration_plans
+      WHERE source = 'auto-diff'
+        AND ${t("squashedAt")} IS NULL
+        AND ${t("appliedAt")} <  ${e.before}
+      ORDER BY ${t("appliedAt")} DESC, id DESC
+    `;
+	if (i.length === 0) return yield* n.fail(/* @__PURE__ */ Error(`squash: no rows applied before ${e.before}`));
+	let o = i[0];
+	if (o.fingerprint !== e.fingerprint) return yield* n.fail(/* @__PURE__ */ Error(`squash: latest pre-squash fingerprint (${o.fingerprint.slice(0, 12)}…) differs from current declared-schema fingerprint (${e.fingerprint.slice(0, 12)}…). The cut-off may select an older schema state, or declared changes may not have been applied.\n\nCheck the cut-off and selected history against the current declarations. Apply genuinely pending changes with \`voltro db apply\`; otherwise choose a cut-off whose newest eligible fingerprint matches the current schema.`));
+	let s = r("sha256").update(JSON.stringify({
+		before: e.before,
+		fingerprint: e.fingerprint,
+		rows: i.map((e) => [
+			e.id,
+			e.fingerprint,
+			e.appliedAt
+		])
+	})).digest("hex");
+	return {
+		eligible: i,
+		preview: {
+			before: e.before,
+			fingerprint: e.fingerprint,
+			planIds: i.map((e) => e.id),
+			count: i.length,
+			token: s
+		}
+	};
+}), s = (e) => o(e).pipe(n.map((e) => e.preview)), c = (r) => n.gen(function* () {
+	let s = yield* a.SqlClient;
+	return yield* e(s, t(s, n.gen(function* () {
+		let { eligible: e, preview: t } = yield* o(r);
+		if (r.expectedPreview !== void 0 && r.expectedPreview !== t.token) return yield* n.fail(/* @__PURE__ */ Error("squash: selected history changed after preview; review a new preview before confirming"));
+		yield* s`
+        UPDATE _voltro_migration_plans
+        SET ${s("squashedAt")} = CURRENT_TIMESTAMP
+        WHERE id IN ${s.in(e.map((e) => e.id))}
+      `;
+		let a = `plan_squash_${i()}`;
+		return yield* s`
+        INSERT INTO _voltro_migration_plans
+          (id, fingerprint, operations, ${s("rollbackPlan")}, ${s("appliedBy")}, environment, source,
+           ${s("onlineStrategy")}, ${s("durationMs")}, notes, ${s("squashedAt")}, ${s("appliedAt")}, ${s("createdAt")}, ${s("updatedAt")})
+        VALUES (
+          ${a},
+          ${r.fingerprint},
+          ${JSON.stringify({
+			kind: "squash-snapshot",
+			rowsSquashed: e.length
+		})},
+          ${null},
+          ${r.appliedBy},
+          ${r.environment},
+          ${"squash-snapshot"},
+          ${null},
+          ${0},
+          ${r.note ?? null},
+          ${null},
+          CURRENT_TIMESTAMP,
+          CURRENT_TIMESTAMP,
+          CURRENT_TIMESTAMP
+        )
+      `, {
+			squashedCount: e.length,
+			snapshotFingerprint: r.fingerprint,
+			snapshotId: a
+		};
+	})));
+});
+//#endregion
+export { s as previewMigrationSquash, c as squashMigrationPlans };

package/dist/migrations/storeCharset.js

@@ -0,0 +1,66 @@
+import { isMysqlFamily as e } from "../dialect.js";
+import { isSoftDropSnapshotName as t } from "./frameworkLiveTables.js";
+//#region src/migrations/storeCharset.ts
+var n = ["utf8mb3", "utf8mb4"], r = (e) => e === "utf8mb3" || e === "utf8mb4", i = (e) => {
+	switch (e.type) {
+		case "text":
+		case "enum": return !0;
+		case "id": return e.idScheme?.kind !== "numeric" && e.idStorage !== "numeric";
+		case "reference": return e.referenceStorage !== "numeric";
+		default: return !1;
+	}
+}, a = (e, t) => e.map((e) => ({
+	...e,
+	columns: e.columns.map((e) => i(e) && e.charset === void 0 ? {
+		...e,
+		charset: t
+	} : e)
+})), o = (e) => e.columns.flatMap((e) => e.charset === void 0 ? [] : [{
+	column: e.name,
+	charset: e.charset
+}]), s = "utf8mb4", c = (e) => e.columns.some((e) => e.type === "json" || e.type === "array" || e.storageType === "json"), l = (n) => {
+	if (!e(n.dialect)) return [];
+	let r = [];
+	for (let e of [...n.live.tables].sort((e, t) => e.name.localeCompare(t.name))) {
+		if (t(e.name)) continue;
+		let i = o(e);
+		if (i.length === 0) continue;
+		if (n.charset !== void 0) {
+			let t = i.filter((e) => e.charset !== n.charset);
+			t.length > 0 && r.push({
+				table: e.name,
+				kind: "disagrees-with-declaration",
+				columns: t,
+				expected: n.charset
+			});
+			continue;
+		}
+		if (c(e)) {
+			let t = i.filter((e) => e.charset !== s);
+			t.length > 0 && r.push({
+				table: e.name,
+				kind: "json-outruns-text",
+				columns: t,
+				expected: s
+			});
+			continue;
+		}
+		let a = new Set(i.map((e) => e.charset));
+		a.size > 1 && r.push({
+			table: e.name,
+			kind: "mixed",
+			columns: i,
+			expected: [...a].sort().join(" / ")
+		});
+	}
+	return r;
+}, u = (e) => {
+	let t = e.columns.map((e) => `${e.column} (${e.charset})`).join(", ");
+	switch (e.kind) {
+		case "disagrees-with-declaration": return `${e.table}: declared ${e.expected}, stored otherwise — ${t}`;
+		case "json-outruns-text": return `${e.table}: its json column holds every character (utf8mb4); these text columns do not — ${t}`;
+		case "mixed": return `${e.table}: its string columns are not in one character set — ${t}`;
+	}
+}, d = "declare the store's character set in app.config.ts — store: { dialect: 'mariadb' | 'mysql', charset: 'utf8mb4' } — and run `voltro db plan`: every table the app declares is created with it and converted to it (a table rewrite; foreign keys are re-created around it). `utf8mb3` is accepted too, for a database that must stay there.";
+//#endregion
+export { n as MYSQL_CHARSETS, d as STORE_CHARSET_REMEDY, o as charsetColumnsOf, i as columnTakesCharset, u as describeStoreCharsetFinding, r as isMysqlCharset, a as stampDeclaredCharset, l as storeCharsetFindings };

package/dist/migrations/transactionCause.js

@@ -0,0 +1,10 @@
+import { Cause as e, Effect as t, Equal as n } from "effect";
+//#region src/migrations/transactionCause.ts
+var r = (r, i) => t.suspend(() => {
+	let a;
+	return r.withTransaction(i.pipe(t.tapCause((e) => t.sync(() => {
+		a = e;
+	})))).pipe(t.catchCause((r) => t.failCause(a !== void 0 && !n.equals(a, r) ? e.combine(a, r) : r)));
+});
+//#endregion
+export { r as withMigrationTransaction };

package/dist/migrations/undeclaredCharset.js

@@ -0,0 +1,40 @@
+import { isFrameworkOwnedLiveTable as e, isSoftDropSnapshotName as t, isStagingTableName as n } from "./frameworkLiveTables.js";
+import { withMigrationLock as r } from "./lock.js";
+import { columnLevelChecksMysql as i } from "./applier.js";
+import { Effect as a } from "effect";
+//#region src/migrations/undeclaredCharset.ts
+var o = "utf8mb4", s = (r, i) => e(r) && !i.has(r) && !r.startsWith("_cloud_") && !r.startsWith("__turso_internal_") && !t(r) && !n(r), c = (e) => e.columnDefault !== null && e.columnDefault.toUpperCase() !== "NULL", l = (e, t, n, r) => {
+	if (n !== o) return {
+		tables: [],
+		left: []
+	};
+	let i = e.filter((e) => s(e.table, t) && (r === void 0 || r.has(e.table)) && e.charset !== o), a = i.filter((e) => c(e) || e.generated), l = /* @__PURE__ */ new Map();
+	for (let e of i) c(e) || e.generated || l.set(e.table, [...l.get(e.table) ?? [], e]);
+	return {
+		tables: [...l.entries()].sort(([e], [t]) => e.localeCompare(t)).map(([e, t]) => ({
+			table: e,
+			columns: t
+		})),
+		left: a
+	};
+}, u = (e) => e.tables.length === 0 && e.left.length === 0, d = (e) => [...e.tables.map((e) => `${e.table}: ${e.columns.length} string column${e.columns.length === 1 ? "" : "s"} ${[...new Set(e.columns.map((e) => e.charset))].sort().join("/")} → ${o}`), ...e.left.map((e) => `${e.table}.${e.column} stays ${e.charset}: it has a ${e.generated ? "generation expression" : "default"}, which this step does not rewrite — convert it by hand`)], f = (e) => e.map((e) => Object.fromEntries(Object.entries(e).map(([e, t]) => [e.toLowerCase(), t]))), p = (e) => a.map(e.unsafe("SELECT c.table_name, c.column_name, c.character_set_name, c.column_type, c.is_nullable, c.column_default, c.extra\n         FROM information_schema.columns c\n         JOIN information_schema.tables t ON t.table_schema = c.table_schema AND t.table_name = c.table_name\n        WHERE c.table_schema = DATABASE() AND t.table_type = 'BASE TABLE' AND c.character_set_name IS NOT NULL\n        ORDER BY c.table_name, c.ordinal_position"), (e) => f(e).map((e) => ({
+	table: String(e.table_name),
+	column: String(e.column_name),
+	charset: String(e.character_set_name),
+	columnType: String(e.column_type),
+	nullable: String(e.is_nullable).toUpperCase() === "YES",
+	columnDefault: e.column_default === null || e.column_default === void 0 ? null : String(e.column_default),
+	generated: /GENERATED/i.test(String(e.extra ?? "")) && !/DEFAULT_GENERATED/i.test(String(e.extra ?? ""))
+}))), m = (e) => `\`${e.replace(/`/g, "``")}\``, h = (e, t = /* @__PURE__ */ new Map()) => e.tables.map((e) => `ALTER TABLE ${m(e.table)} ${e.columns.map((n) => {
+	let r = t.get(e.table)?.get(n.column);
+	return `MODIFY COLUMN ${m(n.column)} ${n.columnType} CHARACTER SET ${o}${n.nullable ? "" : " NOT NULL"}${r === void 0 ? "" : ` CHECK (${r})`}`;
+}).join(", ")}`), g = (e, t) => a.gen(function* () {
+	let n = /* @__PURE__ */ new Map();
+	for (let r of t.tables) n.set(r.table, yield* i(e, r.table));
+	for (let r of h(t, n)) yield* e.unsafe(r).unprepared;
+}), _ = (e, t) => r(e, a.gen(function* () {
+	let n = l(yield* p(e), t.declaredNames, t.charset);
+	return yield* g(e, n), n;
+}), { schema: t.lockSchema });
+//#endregion
+export { g as applyUndeclaredCharsetWork, _ as convergeUndeclaredCharset, d as describeUndeclaredCharsetWork, s as isUndeclaredCharsetTable, u as isUndeclaredCharsetWorkEmpty, p as readUndeclaredCharsetColumns, h as undeclaredCharsetStatements, l as undeclaredCharsetWork };

package/dist/migrations/uniqueActiveLowering.js

@@ -0,0 +1,39 @@
+//#region src/migrations/uniqueActiveLowering.ts
+var e = (e) => e.unique === !0 && typeof e.where == "string" && e.where.length > 0, t = (e) => e.replace(/"/g, "`"), n = (e) => typeof e == "string" ? e : e.name ?? String(e), r = (e, t) => `_ua_${t}_${e}`.slice(0, 64), i = (i, a) => {
+	if (a !== "mysql" && a !== "mariadb" || !i.appliedIndexes.some(e)) return i;
+	let o = { ...i.fields }, s = [], c = [];
+	for (let a of i.appliedIndexes) {
+		if (!e(a)) {
+			s.push(a);
+			continue;
+		}
+		let l = t(a.where), u = [];
+		for (let e of a.fields) {
+			let t = n(e);
+			if (!(t in i.fields)) throw Error(`@voltro/migrate: uniqueActive '${a.name}' on '${i.tableName}' references unknown column '${t}'.`);
+			let s = r(a.name, t);
+			u.push(s), o[s] = {
+				type: "text",
+				nullable: !0,
+				unique: !1,
+				maxLength: 255,
+				generatedAs: {
+					expr: `CASE WHEN ${l} THEN CAST(\`${t}\` AS CHAR(255)) ELSE NULL END`,
+					stored: !0
+				}
+			};
+		}
+		c.push({
+			name: a.name,
+			fields: u
+		});
+	}
+	return {
+		...i,
+		fields: o,
+		appliedIndexes: s,
+		appliedUniques: [...i.appliedUniques ?? [], ...c]
+	};
+};
+//#endregion
+export { i as lowerUniqueActive };

package/dist/mixins.js

@@ -0,0 +1,22 @@
+import { materializeFields as e } from "./columns.js";
+//#region src/mixins.ts
+var t = (t) => ({
+	fields: e(t.fields),
+	...t.id === void 0 ? {} : { id: t.id },
+	...t.requires === void 0 ? {} : { requires: t.requires },
+	...t.indexes === void 0 ? {} : { indexes: t.indexes },
+	...t.behaviors === void 0 ? {} : { behaviors: t.behaviors },
+	...t.policies === void 0 ? {} : { policies: t.policies }
+}), n = t, r = (e) => {
+	let t = /* @__PURE__ */ new Set(), n = [], r = (e) => {
+		let i = e.id ?? e;
+		if (!t.has(i)) {
+			if (t.add(i), e.requires !== void 0) for (let t of e.requires) r(t);
+			n.push(e);
+		}
+	};
+	for (let t of e) r(t);
+	return n;
+};
+//#endregion
+export { n as defineMixin, t as mixin, r as resolveMixinGraph };

package/dist/mssqlDecimalDistinct.js

@@ -0,0 +1,51 @@
+import { getTable as e } from "./tableRegistry.js";
+import { prepareProjectedColumn as t } from "./projectedColumn.js";
+//#region src/mssqlDecimalDistinct.ts
+var n = (n) => {
+	if (!n.distinct && !n.distinctOn?.length || n.aggregations?.length || n.setOp) return;
+	let r = t(n), i = n.sourceTable?.tableName === n.table ? n.sourceTable : e(n.table), a = n.joinedProjection ?? (n.projection?.length ? n.projection : Object.keys(i?.fields ?? {})).map((e) => ({
+		source: e,
+		outputKey: e.split(".").at(-1)
+	})), o = {};
+	for (let e of a) {
+		let t = r(e.source);
+		if (!t) return;
+		o[e.outputKey] = t;
+	}
+	if (!Object.values(o).some((e) => e.type === "decimal")) return;
+	let s = new Set([
+		n.table,
+		...(n.ctes ?? []).map((e) => e.name),
+		...(n.joins ?? []).map((e) => e.table)
+	].map((e) => e.toLowerCase())), c = "__voltro_mssql_decimal_result";
+	for (; s.has(c.toLowerCase());) c += "_";
+	let l = n.order.length >= 8 && a.length >= 8 ? /* @__PURE__ */ new Map() : void 0;
+	if (l) for (let e of a) l.has(e.source) || l.set(e.source, e.outputKey);
+	return {
+		table: c,
+		sourceTable: {
+			tableName: c,
+			fields: o
+		},
+		predicate: void 0,
+		projection: void 0,
+		order: n.order.map((e) => ({
+			...e,
+			column: (l === void 0 ? a.find((t) => t.source === e.column)?.outputKey : l.get(e.column)) ?? e.column
+		})),
+		take: n.take,
+		skip: n.skip,
+		ctes: [...n.ctes ?? [], {
+			name: c,
+			descriptor: {
+				...n,
+				ctes: [],
+				order: [],
+				take: void 0,
+				skip: void 0
+			}
+		}]
+	};
+};
+//#endregion
+export { n as mssqlDecimalDistinct };

package/dist/mssqlJsonValueCheck.js

@@ -0,0 +1,42 @@
+//#region src/mssqlJsonValueCheck.ts
+var e = (e) => {
+	let t = `(N'{"v":' + ${e} + N'}')`, n = `ISJSON(${t}) = 1`, r = `JSON_MODIFY(CASE WHEN ${n} THEN ${t} ELSE N'{}' END, '$.v', NULL)`;
+	return `(${e} IS NULL OR (${n} AND ${[
+		32,
+		9,
+		10,
+		13
+	].reduce((e, t) => `REPLACE(${e}, NCHAR(${t}), N'')`, r)} = N'{}'))`;
+}, t = (e) => {
+	let t = [], n = /\s+|N?'(?:''|[^'])*'|\[(?:\]\]|[^\]])*\]|[A-Za-z_][A-Za-z_0-9]*|[0-9]+|[()+,=]/giy, r = 0;
+	for (; r < e.length;) {
+		n.lastIndex = r;
+		let i = n.exec(e);
+		if (!i) return;
+		let a = i[0];
+		/^\s+$/.test(a) || t.push(/^(?:N?')|^\[/i.test(a) ? a.replace(/^n'/, "N'") : a.toLowerCase()), r = n.lastIndex;
+	}
+	return t;
+}, n = (n, r) => {
+	let i = `[${n.replaceAll("]", "]]")}]`, a = `(N'{"v":'+${i})+N'}'`, o = `isjson(${a})=(1)`, s = `json_modify(case when ${o} then ${a} else N'{}' end,'$.v',NULL)`, c = [
+		32,
+		9,
+		10,
+		13
+	].reduce((e, t) => `replace(${e},nchar((${t})),N'')`, s), l = [
+		["value", e(i)],
+		["value", `(${i} IS NULL OR ${o} AND ${c}=N'{}')`],
+		["container", `(${i} IS NULL OR ISJSON(${i}) = 1)`],
+		["container", `(${i} IS NULL OR isjson(${i})=(1))`]
+	], u = t(r);
+	if (u) return l.find(([, e]) => {
+		let n = t(e);
+		return n?.length === u.length && n.every((e, t) => e === u[t]);
+	})?.[0];
+}, r = (e) => {
+	if (e.length === 0) return;
+	let t = e.filter((e) => e.enabled);
+	return t.some((e) => e.validation === "container") ? t.some((e) => e.validation === "container" && e.trusted) ? "container" : "unverified" : t.some((e) => e.validation === "value" && e.trusted) ? "value" : "unverified";
+};
+//#endregion
+export { n as classifyMssqlJsonCheck, r as mssqlJsonValidation, e as mssqlJsonValueCheck };

package/dist/mssqlTextStorage.js

@@ -0,0 +1,9 @@
+//#region src/mssqlTextStorage.ts
+var e = (e, t) => {
+	if (e.type === "text" && e.generatedAs === void 0) {
+		if (e.maxLength !== void 0) return e.maxLength;
+		if (t || e.hasDefault && e.defaultFactory === void 0 || e.oneOf !== void 0 && e.oneOf.length > 0) return 450;
+	}
+};
+//#endregion
+export { e as mssqlTextStorageLength };

package/dist/namespace.js

@@ -0,0 +1,21 @@
+//#region src/namespace.ts
+var e = class extends Error {
+	_tag = "TenantNamespaceUnresolved";
+	constructor(e) {
+		super(e), this.name = "TenantNamespaceUnresolved";
+	}
+}, t = class extends Error {
+	_tag = "TenantNamespaceInvalid";
+	constructor(e) {
+		super(e), this.name = "TenantNamespaceInvalid";
+	}
+}, n = 63, r = "tenant_", i = (e) => e.toLowerCase().replace(/[^a-z0-9_]/g, "_"), a = (a) => {
+	if (a == null || a === "") throw new e("namespace isolation is on but the request has no resolvable tenant (subject.tenantId is null/empty). Refusing to run against a shared/default namespace — this would be a cross-tenant read. Authenticate with a tenant-scoped subject, or disable namespace isolation for this surface.");
+	let o = i(a);
+	if (o.replace(/_/g, "") === "") throw new t(`tenant id '${a}' has no usable identifier characters after sanitisation — cannot derive a distinct namespace.`);
+	let s = `${r}${o}`;
+	if (s.length > n) throw new t(`namespace '${s}' for tenant '${a}' exceeds the ${n}-byte identifier limit. Use a shorter tenant id.`);
+	return s;
+}, o = (e, t) => e === null ? t : `${e}.${t}`;
+//#endregion
+export { t as TenantNamespaceInvalid, e as TenantNamespaceUnresolved, o as qualifyTable, a as resolveTenantNamespace, i as sanitizeIdentifierFragment };

package/dist/{wire-CG2j7J3f.js → optimisticVersion.js}

@@ -27,6 +27,6 @@ var t = class extends e.TaggedError()("VersionConflict", {
 		expected: e.expected,
 		actual: e.current
 	});
-}, a = 1, o = e.DateFromMillis.annotate({ description: "A point in time: a Date in the handler, epoch milliseconds on the wire." }), s = e.NullOr(o);
+}, a = 1;
 //#endregion
-export { r as a, t as i, s as n, i as o, a as r, n as s, o as t };
+export { a as INITIAL_VERSION, t as VersionConflict, r as planVersionedUpdate, i as settleVersionedUpdate, n as versionColumnOf };

package/dist/pendingAttribution.js

@@ -0,0 +1,79 @@
+//#region src/pendingAttribution.ts
+var e = 3e4, t = 1e4, n = /* @__PURE__ */ new Map(), r = [], i = (e, t) => {
+	let n = r[e];
+	r[e] = r[t], r[t] = n, r[e].heapIndex = e, n.heapIndex = t;
+}, a = (e) => {
+	for (; e > 0;) {
+		let t = Math.floor((e - 1) / 2);
+		if (r[t].at <= r[e].at) break;
+		i(t, e), e = t;
+	}
+	return e;
+}, o = (e) => {
+	for (; e * 2 + 1 < r.length;) {
+		let t = e * 2 + 1;
+		if (t + 1 < r.length && r[t + 1].at < r[t].at && t++, r[e].at <= r[t].at) break;
+		i(e, t), e = t;
+	}
+}, s = (e) => {
+	let t = n.get(e.key);
+	e.previous ? e.previous.next = e.next : e.next && (t.head = e.next), e.next ? e.next.previous = e.previous : e.previous && (t.tail = e.previous), !e.previous && !e.next && n.delete(e.key);
+	let i = e.heapIndex, s = r.pop();
+	i < r.length && (r[i] = s, s.heapIndex = i, o(a(i)));
+}, c = (e, t, n) => `${e}\u0000${t}\u0000${String(n)}`, l = (t) => {
+	for (; r[0] !== void 0 && t - r[0].at >= e;) s(r[0]);
+}, u = (e, i) => {
+	if (i.traceId === void 0 && i.subjectId === void 0 && i.procedure === void 0 && i.via === void 0) return;
+	let o = Date.now();
+	if (r.length >= t && l(o), r.length >= t) return;
+	let s = n.get(e), c = {
+		key: e,
+		attribution: i,
+		at: o,
+		heapIndex: r.length,
+		previous: s?.tail
+	};
+	s ? (s.tail.next = c, s.tail = c) : n.set(e, {
+		head: c,
+		tail: c
+	}), r.push(c), a(c.heapIndex);
+}, d = (t) => {
+	let r = n.get(t)?.head;
+	if (r !== void 0 && (s(r), !(Date.now() - r.at >= e))) return r.attribution;
+}, f = (e) => n.has(e), p = /* @__PURE__ */ new Map(), m = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map(), g = 250, _ = (e) => {
+	let t = m.get(e);
+	if (t === void 0) return;
+	m.delete(e);
+	let n = h.get(e);
+	n !== void 0 && (clearTimeout(n), h.delete(e));
+	for (let e of t) e();
+}, v = (e) => {
+	p.set(e, (p.get(e) ?? 0) + 1);
+}, y = (e) => {
+	let t = (p.get(e) ?? 0) - 1;
+	t > 0 ? p.set(e, t) : (p.delete(e), _(e));
+}, b = (e, t, n, r) => {
+	let i = n == null ? void 0 : c(e, t, n), a = () => r(i === void 0 ? void 0 : d(i));
+	if (i === void 0 || f(i)) {
+		a();
+		return;
+	}
+	let o = m.get(e);
+	if (o === void 0 && (p.get(e) ?? 0) === 0) {
+		a();
+		return;
+	}
+	if (o !== void 0) {
+		o.push(a);
+		return;
+	}
+	m.set(e, [a]);
+	let s = setTimeout(() => _(e), g);
+	typeof s == "object" && typeof s.unref == "function" && s.unref(), h.set(e, s);
+}, x = () => {
+	n.clear(), r.length = 0, p.clear();
+	for (let e of h.values()) clearTimeout(e);
+	h.clear(), m.clear();
+}, S = () => r.length;
+//#endregion
+export { c as attributionKey, v as beginLocalWrite, d as claimPendingAttribution, x as clearPendingAttribution, y as endLocalWrite, S as pendingAttributionCount, u as registerPendingAttribution, b as resolveEchoAttribution };

package/dist/pluginRef.js

@@ -0,0 +1,17 @@
+import { ColumnBuilder as e, text as t } from "./columns.js";
+//#region src/pluginRef.ts
+var n = Symbol.for("@voltro/database/pluginRefSpec"), r = (e) => {
+	if (typeof e == "object" && e) return ("__definition" in e && typeof e.__definition == "function" ? e.__definition() : e)[n];
+}, i = (r, i = {}) => {
+	let a = {
+		target: r,
+		orphanPolicy: i.orphanPolicy ?? "keep",
+		onSoftDelete: i.onSoftDelete ?? !1
+	}, o = {
+		...t().__definition(),
+		[n]: a
+	};
+	return new e(o);
+};
+//#endregion
+export { i as pluginRef, r as pluginRefSpecOf };