@voltro/runtime 0.86.0 → 0.88.0

package/dist/bootListener.js

@@ -1,76 +1,232 @@
 import { answerProbe as e, probeFor as t, resolveHealth as n } from "./healthProbes.js";
-import { createServer as r } from "node:http";
-//#region src/bootListener.ts
-var i = "no-store", a = "1", o = /* @__PURE__ */ new Set(["ready", "draining"]), s = async (s) => {
-	let c = s.now ?? Date.now, l = {
+import { trackEngineClient as r } from "./engineClients.js";
+import { createServer as i } from "node:http";
+// src/bootListener.ts
+var a = "no-store", o = "1", s = 3e4, c = 3e5, l = 512, u = () => {
+	let e = process.env.VOLTRO_BOOT_HOLD_MS;
+	if (e === void 0 || e.trim() === "") return s;
+	let t = Number(e);
+	return !Number.isFinite(t) || t < 0 ? s : Math.min(c, Math.trunc(t));
+}, d = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light dark"><meta http-equiv="refresh" content="${o}"><title>Starting…</title><style>body{margin:0;min-height:100vh;display:grid;place-items:center;font:16px/1.5 system-ui,sans-serif}</style></head><body><p role="status">Starting… this page reloads by itself.</p></body></html>`, f = (e) => (e.method === "GET" || e.method === "HEAD") && /\btext\/html\b/i.test(e.headers.accept ?? ""), p = (e, t) => {
+	if (t.headersSent || t.destroyed) return;
+	let n = f(e);
+	t.writeHead(503, {
+		"content-type": n ? "text/html; charset=utf-8" : "text/plain",
+		"cache-control": a,
+		"retry-after": o
+	}), t.end(e.method === "HEAD" ? void 0 : n ? d : "starting");
+}, m = (e) => {
+	e.destroyed || e.end(`HTTP/1.1 503 Service Unavailable\r
+Retry-After: ${o}\r\nCache-Control: no-store\r
+Connection: close\r
+Content-Length: 0\r
+\r
+`);
+}, h = (e, t, n, i) => {
+	e !== void 0 && (r(t, n), e.upgrade(t, n, i));
+}, g = /* @__PURE__ */ new Set(["ready", "draining"]), _ = /* @__PURE__ */ new Set([
+	"booting",
+	"migrating",
+	"ready"
+]), v = async (r) => {
+	let o = r.now ?? Date.now, s = {
 		phase: "booting",
-		startedAt: c()
-	}, u, d, f = () => l.phase === "ready", p = () => o.has(l.phase), m = n(s.health, () => f()), h = s.health?.readiness === void 0 ? async () => f() && (d === void 0 || await d()) : m.readiness, g = {
-		...m,
-		readiness: h
-	}, _ = () => ({
-		phase: l.phase,
-		ready: f(),
-		elapsedMs: c() - l.startedAt,
-		...l.tablesTotal === void 0 ? {} : { tablesTotal: l.tablesTotal },
-		...l.error === void 0 ? {} : { error: l.error }
-	}), v = r((n, r) => {
-		let o = n.url ?? "/", s = o.indexOf("?"), c = s === -1 ? o : o.slice(0, s), l = t(g, c);
-		l === void 0 ? u !== void 0 && p() ? u.request(n, r) : (r.writeHead(503, {
-			"content-type": "text/plain",
-			"cache-control": i,
-			"retry-after": a
-		}), r.end("starting")) : e(g, l, _).then((e) => {
+		startedAt: o()
+	}, c, d, f = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Map(), y, b = Math.max(0, r.holdMs ?? u()), x = Math.max(0, r.maxHeld ?? l), S = /* @__PURE__ */ new Set(), C = !1, w = !1, T = () => s.phase === "ready", E = () => g.has(s.phase), D = () => c !== void 0 && E(), O = () => _.has(s.phase) || D(), k = n(r.health, () => T()), A = r.health?.readiness === void 0 ? async () => T() && (d === void 0 || await d()) : k.readiness, j = () => {
+		if ((f.size > 0 || y !== void 0) && !T()) return !1;
+		for (let e of f.values()) try {
+			if (e() !== !0) return !1;
+		} catch {
+			return !1;
+		}
+		return !0;
+	}, M = () => {
+		for (let e of v.values()) try {
+			if (e() !== !0) return !1;
+		} catch {
+			return !1;
+		}
+		return !0;
+	}, N = {
+		...k,
+		readiness: async () => j() && await A() && j(),
+		liveness: async () => M() && await k.liveness() && M()
+	}, P = () => ({
+		phase: s.phase,
+		ready: T(),
+		elapsedMs: o() - s.startedAt,
+		...s.tablesTotal === void 0 ? {} : { tablesTotal: s.tablesTotal },
+		...s.error === void 0 ? {} : { error: s.error },
+		...S.size > 0 ? { held: S.size } : {}
+	}), F = i((n, r) => {
+		let i = n.url ?? "/", o = i.indexOf("?"), l = o === -1 ? i : i.slice(0, o);
+		if (l === "/_voltro/health" && (y !== void 0 || f.size > 0)) {
+			if (n.method !== "GET" && n.method !== "HEAD") {
+				r.writeHead(405, {
+					allow: "GET, HEAD",
+					"cache-control": a
+				}), r.end();
+				return;
+			}
+			e(N, "readiness", P).then((e) => {
+				let t = e.status === 200 && T() && j();
+				r.writeHead(t ? 200 : 503, {
+					"content-type": "application/json",
+					"cache-control": a
+				}), r.end(n.method === "HEAD" ? void 0 : JSON.stringify({
+					...y,
+					phase: s.phase,
+					ready: t
+				}));
+			});
+			return;
+		}
+		let u = t(N, l);
+		u === void 0 ? D() && S.size === 0 ? c?.request(n, r) : I({
+			attach: (e) => {
+				r.once("close", e);
+			},
+			detach: (e) => {
+				r.removeListener("close", e);
+			},
+			forward: (e) => {
+				e.request(n, r);
+			},
+			refuse: () => {
+				p(n, r);
+			}
+		}) : e(N, u, P).then((e) => {
 			r.writeHead(e.status, {
 				"content-type": e.contentType,
-				"cache-control": i
+				"cache-control": a
 			}), r.end(e.body);
 		});
 	});
-	v.on("upgrade", (e, t, n) => {
-		u !== void 0 && p() ? u.upgrade(e, t, n) : t.end(`HTTP/1.1 503 Service Unavailable\r
-Retry-After: ${a}\r\nCache-Control: no-store\r
-Connection: close\r
-Content-Length: 0\r
-\r
-`);
-	}), await new Promise((e, t) => {
+	F.on("upgrade", (e, t, n) => {
+		if (D() && S.size === 0) {
+			h(c, e, t, n);
+			return;
+		}
+		let r = () => {};
+		I({
+			attach: (e) => {
+				t.on("error", r), t.once("close", e);
+			},
+			detach: (e) => {
+				t.removeListener("error", r), t.removeListener("close", e);
+			},
+			forward: (r) => {
+				h(r, e, t, n);
+			},
+			refuse: () => {
+				m(t);
+			}
+		});
+	});
+	function I(e) {
+		let t = D();
+		if (!t && (!O() || b === 0 || S.size >= x)) {
+			e.refuse();
+			return;
+		}
+		let n, i = () => {
+			a();
+		}, a = () => {
+			n !== void 0 && clearTimeout(n), e.detach(i), S.delete(o);
+		}, o = {
+			forward: e.forward,
+			refuse: e.refuse,
+			release: a
+		};
+		t || (n = setTimeout(() => {
+			a(), C || (C = !0, r.log?.info("boot still running after the hold window — answering 503 to waiting requests", {
+				holdMs: b,
+				phase: s.phase
+			})), e.refuse();
+		}, b), n.unref()), e.attach(i), S.add(o), t && L();
+	}
+	function L() {
+		w || S.size === 0 || (w = !0, setImmediate(() => {
+			w = !1, R();
+		}));
+	}
+	function R() {
+		if (D()) {
+			let e = c;
+			if (e === void 0) return;
+			let t = S.size;
+			for (let t of [...S]) t.release(), t.forward(e);
+			t > 0 && r.log?.info("handed requests held during boot to the app", { count: t });
+		} else if (!O()) for (let e of [...S]) e.release(), e.refuse();
+	}
+	await new Promise((e, t) => {
 		let n = (e) => {
 			t(e);
 		};
-		v.once("error", n), v.listen(s.host === void 0 ? { port: s.port } : {
-			port: s.port,
-			host: s.host
+		F.once("error", n), F.listen(r.host === void 0 ? { port: r.port } : {
+			port: r.port,
+			host: r.host
 		}, () => {
-			v.removeListener("error", n), e();
+			F.removeListener("error", n), e();
 		});
 	});
-	let y = v.address()?.port ?? s.port;
-	return s.log?.info("listening early — probes answer on the app port from here on", { port: y }), {
-		server: v,
-		port: y,
+	let z = F.address()?.port ?? r.port;
+	return r.log?.info("listening early — probes answer on the app port from here on", { port: z }), {
+		server: F,
+		port: z,
 		get state() {
-			return l;
+			return s;
+		},
+		get held() {
+			return S.size;
 		},
 		set: (e) => {
-			l = {
-				...l,
+			s = {
+				...s,
 				...e
-			};
+			}, L();
 		},
-		isReady: f,
+		isReady: T,
 		delegate: (e) => {
-			u = e;
+			c = e, L();
 		},
 		setDependencyPing: (e) => {
 			d = e;
 		},
+		setRoleHealth: (e) => {
+			let t = (e) => {
+				if (!Array.isArray(e) || e.length === 0 || e.length > 64 || e.some((e) => typeof e != "string" || !/^[a-z][a-z0-9._-]{0,63}$/.test(e)) || new Set(e).size !== e.length) throw Error("Invalid role health identity");
+				return Object.freeze([...e]);
+			};
+			y = Object.freeze({
+				roles: t(e.roles),
+				workloads: t(e.workloads)
+			});
+		},
+		addReadinessGate: (e, t) => {
+			if (!/^[a-z][a-z0-9._-]{0,63}$/.test(e) || typeof t != "function") throw Error("Invalid readiness gate");
+			if (f.has(e)) throw Error("Readiness gate is already registered");
+			f.set(e, t);
+			let n = !1;
+			return () => {
+				n || (n = !0, f.get(e) === t && f.delete(e));
+			};
+		},
+		addLivenessGate: (e, t) => {
+			if (!/^[a-z][a-z0-9._-]{0,63}$/.test(e) || typeof t != "function") throw Error("Invalid liveness gate");
+			if (v.has(e)) throw Error("Liveness gate is already registered");
+			v.set(e, t);
+			let n = !1;
+			return () => {
+				n || (n = !0, v.get(e) === t && v.delete(e));
+			};
+		},
 		close: () => new Promise((e) => {
-			v.listening ? (v.closeAllConnections(), v.close(() => {
+			for (let e of [...S]) e.release(), e.refuse();
+			F.listening ? (F.closeAllConnections(), F.close(() => {
 				e();
 			})) : e();
 		})
 	};
 };
-//#endregion
-export { s as bindBootListener };
+export { v as bindBootListener, u as bootHoldMsFromEnv };

package/dist/bootStoreCodec.js

@@ -1,70 +1,70 @@
 import { getFieldCipher as e } from "./fieldCipher.js";
 import { upsertDestinationId as t } from "./upsertBinding.js";
-import { decryptFieldsOnRead as n, deserializeArraysOnRead as r, encryptFieldsForWrite as i, encryptFieldsForWriteBatch as a, encryptedColumnsOf as o, getTable as s, jsonPatchAssignments as c, serializeArraysForWrite as l, upsertUpdateValues as u } from "@voltro/database";
-import { createLogger as d } from "@voltro/logger";
-//#region src/bootStoreCodec.ts
-var f = d({ scope: "store.fieldEncryption" }), p = (d, m) => {
-	let h = m, g = process.env.VOLTRO_FIELD_DECRYPT_ON_ERROR === "null" ? "null" : "throw", _ = /* @__PURE__ */ new Set(), v = (e) => {
+import { decryptFieldsOnRead as n, deserializeArraysOnRead as r, encryptFieldsForWrite as i, encryptFieldsForWriteBatch as a, encryptedColumnsOf as o, getTable as s, jsonPatchAssignments as c, refuseIdChangeOfSealedRow as l, serializeArraysForWrite as u, upsertUpdateValues as d } from "@voltro/database";
+import { createLogger as f } from "@voltro/logger";
+// src/bootStoreCodec.ts
+var p = f({ scope: "store.fieldEncryption" }), m = (f, h) => {
+	let g = h, _ = process.env.VOLTRO_FIELD_DECRYPT_ON_ERROR === "null" ? "null" : "throw", v = /* @__PURE__ */ new Set(), y = (e) => {
 		let t = `${e.table}.${e.column}`;
-		_.has(t) || (_.add(t), f.warn("encrypted column degraded to null — could not decrypt with the active key", {
+		v.has(t) || (v.add(t), p.warn("encrypted column degraded to null — could not decrypt with the active key", {
 			table: e.table,
 			column: e.column,
 			reason: e.reason,
 			hint: "VOLTRO_FIELD_DECRYPT_ON_ERROR=null is set — this row was likely encrypted under a different key"
 		}));
-	}, y = (t, n, r) => {
-		let a = s(t), o = h ? l(n, a, h) : n;
+	}, b = (t, n, r) => {
+		let a = s(t), o = g ? u(n, a, g) : n;
 		return i(o, a, e(), r);
-	}, b = (t, i, a) => {
+	}, x = (t, i, a) => {
 		let o = s(t), c = n(i, o, e(), {
-			onError: g,
-			...g === "null" ? { warn: v } : {},
+			onError: _,
+			..._ === "null" ? { warn: y } : {},
 			...a === void 0 ? {} : { rowId: a }
 		});
-		return h ? r(c, o, h) : c;
-	}, x = (e, t, n) => t === null ? null : b(e, [t], n)[0];
+		return g ? r(c, o, g) : c;
+	}, S = (e, t, n) => t === null ? null : x(e, [t], n)[0];
 	return {
-		delete: (e, t) => d.delete(e, t),
-		deleteMany: (e, t) => d.deleteMany(e, t),
-		onChange: (e) => d.onChange(e),
+		delete: (e, t) => f.delete(e, t),
+		deleteMany: (e, t) => f.deleteMany(e, t),
+		onChange: (e) => f.onChange(e),
 		injectExternalChange: (e) => {
-			d.injectExternalChange(e);
+			f.injectExternalChange(e);
 		},
-		...d.changeScope === void 0 ? {} : { changeScope: d.changeScope },
-		...d.withNamespace === void 0 ? {} : { withNamespace: (e) => p(d.withNamespace(e), m) },
-		...d.raw === void 0 ? {} : { raw: ((...e) => d.raw(...e)) },
-		...d.close === void 0 ? {} : { close: (e) => d.close(e) },
-		...d.ping === void 0 ? {} : { ping: () => d.ping() },
-		query: async (e) => b(e.table, await d.query(e)),
-		insert: async (e, t) => x(e, await d.insert(e, y(e, t))),
-		insertMany: async (t, n) => {
-			let r = s(t), i = h ? n.map((e) => l(e, r, h)) : n, o = a(i, r, e());
-			return b(t, await d.insertMany(t, o));
+		...f.changeScope === void 0 ? {} : { changeScope: f.changeScope },
+		...f.withNamespace === void 0 ? {} : { withNamespace: (e) => m(f.withNamespace(e), h) },
+		...f.raw === void 0 ? {} : { raw: ((...e) => f.raw(...e)) },
+		...f.close === void 0 ? {} : { close: (e) => f.close(e) },
+		...f.ping === void 0 ? {} : { ping: () => f.ping() },
+		query: async (e) => x(e.table, await f.query(e)),
+		...f.integrityQuery === void 0 ? {} : { integrityQuery: async (e) => x(e.table, await f.integrityQuery(e)) },
+		insert: async (e, t) => S(e, await f.insert(e, b(e, t))),
+		insertMany: async (t, n, r) => {
+			let i = s(t), o = g ? n.map((e) => u(e, i, g)) : n, c = a(o, i, e());
+			return x(t, await f.insertMany(t, c, r));
 		},
-		update: async (e, t, n) => x(e, await d.update(e, t, y(e, n, t)), t),
+		update: async (e, t, n) => S(e, await f.update(e, t, (l(n, s(e), t), b(e, n, t))), t),
 		updateMany: async (e, t, n) => {
 			let r = s(e), i = (r === void 0 ? [] : o(r)).filter((e) => t[e] !== void 0 && t[e] !== null);
 			if (i.length > 0) throw Error(`updateMany on the boot store cannot write the .encrypted() column(s) ${i.join(", ")} on "${e}": an encrypted value is bound to its row and a set-based write has no row. Write them through the request-scoped store, or key the write with update(table, id, patch).`);
-			return d.updateMany(e, y(e, t), n);
+			return f.updateMany(e, b(e, t), n);
 		},
 		upsert: async (e, n, r) => {
-			let i = u(r), a = await t(d, e, n, r.conflictColumns);
-			return x(e, await d.upsert(e, y(e, n, a), {
+			let i = d(r), a = await t(f, e, n, r.conflictColumns);
+			return S(e, await f.upsert(e, b(e, n, a), {
 				...r,
-				...r.updateValues === void 0 ? {} : { updateValues: y(e, i, a) }
+				...r.updateValues === void 0 ? {} : { updateValues: b(e, i, a) }
 			}), a);
 		},
-		insertIgnore: async (e, t, n) => x(e, await d.insertIgnore(e, y(e, t), n)),
+		insertIgnore: async (e, t, n) => S(e, await f.insertIgnore(e, b(e, t), n)),
 		insertIgnoreWithOutcome: async (e, t, n) => {
-			let r = await d.insertIgnoreWithOutcome(e, y(e, t), n);
+			let r = await f.insertIgnoreWithOutcome(e, b(e, t), n);
 			return {
-				row: x(e, r.row),
+				row: S(e, r.row),
 				outcome: r.outcome
 			};
 		},
-		patchJson: async (e, t, n, r, i) => x(e, await d.patchJson(e, t, n, r, y(e, c(t, n, i), t)), t),
-		transactional: (e) => d.transactional((t) => e(p(t, m)))
+		patchJson: async (e, t, n, r, i) => S(e, await f.patchJson(e, t, n, r, b(e, c(t, n, i), t)), t),
+		transactional: (e) => f.transactional((t) => e(m(t, h)))
 	};
 };
-//#endregion
-export { p as wrapStoreWithBootCodec };
+export { m as wrapStoreWithBootCodec };

package/dist/businessRules.js

@@ -1,7 +1,7 @@
 import { getTable as e } from "@voltro/database";
 import { BusinessRuleViolation as t } from "@voltro/protocol";
 import { log as n } from "@voltro/logger";
-//#region src/businessRules.ts
+// src/businessRules.ts
 var r = (e) => e.startsWith("_voltro"), i = (e) => {
 	let t = e?.id;
 	return typeof t == "string" ? t : void 0;
@@ -63,5 +63,4 @@ var r = (e) => e.startsWith("_voltro"), i = (e) => {
 		}
 	}
 };
-//#endregion
 export { s as evaluateTouchedRules, a as makeRuleCapture };

package/dist/changeClaimsTable.js

@@ -1,5 +1,5 @@
 import { id as e, integer as t, table as n, text as r, timestamp as i } from "@voltro/database";
-//#region src/changeClaimsTable.ts
+// src/changeClaimsTable.ts
 var a = n("_voltro_change_claims", {
 	id: e({ prefix: "chclaim" }),
 	scope: r(),
@@ -8,5 +8,4 @@ var a = n("_voltro_change_claims", {
 	claimedAt: i(),
 	nextSlot: t().default(0)
 }).unique(["scope", "key"]).index(["claimedAt"]);
-//#endregion
 export { a as _voltroChangeClaimsTable };

package/dist/circuitBreaker.js

@@ -1,72 +1 @@
-import { Cause as e, Clock as t, Duration as n, Effect as r, Ref as i, Schema as a } from "effect";
-//#region src/circuitBreaker.ts
-var o = class extends a.TaggedError()("CircuitOpen", {
-	name: a.String,
-	retryAfterMs: a.Number
-}) {}, s = {
-	tag: "closed",
-	failureCount: 0,
-	halfOpenSuccesses: 0,
-	openedAt: 0
-}, c = { make: (a) => r.gen(function* () {
-	let c = a.name ?? "circuit", l = n.toMillis(n.fromInputUnsafe(a.resetTimeout)), u = a.halfOpenSuccessThreshold ?? 1, d = a.isFailure ?? (() => !0), f = yield* i.make(s), p = r.gen(function* () {
-		let e = yield* i.get(f);
-		if (e.tag === "half-open") {
-			let t = e.halfOpenSuccesses + 1;
-			yield* i.set(f, t >= u ? s : {
-				...e,
-				halfOpenSuccesses: t
-			});
-		} else e.failureCount !== 0 && (yield* i.set(f, s));
-	}), m = r.gen(function* () {
-		let e = yield* t.currentTimeMillis, n = yield* i.get(f);
-		if (n.tag === "half-open" || n.tag === "open") {
-			yield* i.set(f, {
-				tag: "open",
-				failureCount: a.failureThreshold,
-				halfOpenSuccesses: 0,
-				openedAt: e
-			});
-			return;
-		}
-		let r = n.failureCount + 1;
-		yield* i.set(f, r >= a.failureThreshold ? {
-			tag: "open",
-			failureCount: r,
-			halfOpenSuccesses: 0,
-			openedAt: e
-		} : {
-			...n,
-			failureCount: r
-		});
-	}), h = r.gen(function* () {
-		let e = yield* i.get(f);
-		if (e.tag !== "open") return null;
-		let n = (yield* t.currentTimeMillis) - e.openedAt;
-		return n >= l ? (yield* i.set(f, {
-			tag: "half-open",
-			failureCount: 0,
-			halfOpenSuccesses: 0,
-			openedAt: e.openedAt
-		}), null) : l - n;
-	}), g = (t) => r.gen(function* () {
-		let n = yield* h;
-		return n === null ? yield* t.pipe(r.tap(() => p), r.tapCause((t) => {
-			if (e.hasInterruptsOnly(t)) return r.void;
-			let n = e.findErrorOption(t), i = n._tag === "Some" ? n.value : void 0;
-			return d(i) ? m : r.void;
-		})) : yield* r.fail(new o({
-			name: c,
-			retryAfterMs: n
-		}));
-	}), _ = ((e) => g(e));
-	return Object.defineProperty(_, "state", {
-		value: i.get(f).pipe(r.map((e) => e.tag)),
-		enumerable: !0
-	}), Object.defineProperty(_, "reset", {
-		value: i.set(f, s),
-		enumerable: !0
-	}), _;
-}) };
-//#endregion
-export { c as CircuitBreaker, o as CircuitOpen };
+export { CircuitBreaker, CircuitOpen } from "@voltro/shared";

package/dist/columnOnUpdate.js

@@ -1,4 +1,4 @@
-//#region src/columnOnUpdate.ts
+// src/columnOnUpdate.ts
 var e = (e) => {
 	if (!(e.length < 32 || Object.getPrototypeOf(e) !== Array.prototype || Object.getOwnPropertySymbols(e).length > 0 || Object.hasOwn(e, "includes"))) {
 		for (let t = 0; t < e.length; t++) {
@@ -19,5 +19,4 @@ var e = (e) => {
 	}
 	return o;
 };
-//#endregion
 export { t as applyColumnOnUpdate };

package/dist/composeAnalytics.js

@@ -1,6 +1,6 @@
 import { AnalyticsCapabilityNotSupported as e } from "./analyticsSink.js";
 import { Effect as t } from "effect";
-//#region src/composeAnalytics.ts
+// src/composeAnalytics.ts
 var n = "noop", r = () => {
 	let r = (r) => t.fail(new e({
 		provider: n,
@@ -86,23 +86,43 @@ var n = "noop", r = () => {
 		...d === void 0 ? {} : { mirror: d }
 	};
 }, a = (e) => {
-	let n = e.filter((e) => e.dispose !== void 0);
-	return {
+	let n = [...e], r, a, o = () => t.suspend(() => t.forEach([...r ?? []].reverse(), (e) => e.released ? t.void : (e.released = !0, e.spec.dispose === void 0 ? t.void : t.suspend(() => e.spec.dispose(e.sink)).pipe(t.catchCause(() => t.logWarning("analytics member teardown failed")))), {
+		concurrency: 1,
+		discard: !0
+	})), s = () => t.promise(() => a ??= t.runPromise(o())), c = (e) => {
+		if (r !== void 0) throw Error("An analytics composite belongs to one app owner");
+		r = [];
+		for (let t of n) {
+			if (t.sql === "required" && e === void 0) throw Error("Analytics member requires SQL");
+			let n = t.sql === "required" ? t.build(e) : t.build();
+			r.push({
+				spec: t,
+				sink: n,
+				released: !1
+			});
+		}
+		return i(r.map((e) => e.sink));
+	}, l = {
 		kind: "compose",
-		build: (t) => i(e.map((e) => e.build(t))),
-		tables: e.flatMap((e) => e.tables ?? []),
-		initialize: (n) => t.forEach(e, (e) => e.initialize ? e.initialize(n) : t.void, {
+		tables: n.flatMap((e) => e.tables ?? []),
+		initialize: () => t.suspend(() => r === void 0 ? t.die(/* @__PURE__ */ Error("Build analytics members before initialization")) : t.forEach(r, (e) => e.spec.initialize === void 0 ? t.void : t.suspend(() => e.spec.initialize(e.sink)), {
 			concurrency: 1,
 			discard: !0
-		}),
-		...n.length > 0 ? { dispose: (e) => t.forEach(n, (t) => t.dispose(e), {
-			concurrency: 1,
-			discard: !0
-		}) } : {}
+		}).pipe(t.onError(s))),
+		...n.some((e) => e.dispose !== void 0) ? { dispose: s } : {}
+	};
+	return n.some((e) => e.sql === "required") ? {
+		...l,
+		sql: "required",
+		build: (e) => c(e)
+	} : {
+		...l,
+		sql: "none",
+		build: () => c()
 	};
 }, o = {
 	kind: "noop",
+	sql: "none",
 	build: () => r()
 };
-//#endregion
 export { n as NOOP_ANALYTICS_PROVIDER, a as composeAnalytics, i as composeAnalyticsSinks, r as noopAnalytics, o as noopAnalyticsSpec };

package/dist/computedQuery.js

@@ -1,4 +1,3 @@
-//#region src/computedQuery.ts
+// src/computedQuery.ts
 var e = (e) => typeof e == "object" && !!e && e.__voltroComputed === !0;
-//#endregion
 export { e as isComputedQuery };