@voltro/runtime 0.86.0 → 0.88.0

package/dist/snapshotValueCodec.js

@@ -0,0 +1,45 @@
+// src/snapshotValueCodec.ts
+var e = "\0", t = `${e}d`, n = `${e}n`, r = `${e}b`, i = `${e}o`, a = 1, o = (e) => {
+	if (typeof e != "object" || !e) return !1;
+	let t = Object.getPrototypeOf(e);
+	return t === Object.prototype || t === null;
+}, s = (a) => {
+	if (typeof a != "object" || !a) return typeof a == "bigint" ? { [n]: a.toString() } : a;
+	if (a instanceof Date) return { [t]: Number.isNaN(a.getTime()) ? null : a.toISOString() };
+	if (a instanceof Uint8Array) return { [r]: Buffer.from(a.buffer, a.byteOffset, a.byteLength).toString("base64") };
+	if (Array.isArray(a)) return a.map(s);
+	if (o(a)) {
+		let t = {}, n = !1;
+		for (let [r, i] of Object.entries(a)) r.startsWith(e) && (n = !0), t[r] = s(i);
+		return n ? { [i]: t } : t;
+	}
+	throw TypeError("A snapshot value carries a non-plain object; it cannot be cached faithfully.");
+}, c = (e) => {
+	if (typeof e != "object" || !e) return e;
+	if (Array.isArray(e)) return e.map(c);
+	let a = e, o = Object.keys(a);
+	if (o.length === 1) {
+		let e = o[0], s = a[e];
+		if (e === t) return s === null ? /* @__PURE__ */ new Date(NaN) : new Date(s);
+		if (e === n) return BigInt(s);
+		if (e === r) return new Uint8Array(Buffer.from(s, "base64"));
+		if (e === i) {
+			let e = {};
+			for (let [t, n] of Object.entries(s)) e[t] = c(n);
+			return e;
+		}
+	}
+	let s = {};
+	for (let [e, t] of Object.entries(a)) s[e] = c(t);
+	return s;
+}, l = (e) => ({
+	v: a,
+	value: s(e)
+}), u = (e) => {
+	if (o(e) && e.v === a && "value" in e) try {
+		return { value: c(e.value) };
+	} catch {
+		return;
+	}
+};
+export { u as decodeSnapshotValue, l as encodeSnapshotValue };

package/dist/sourceResolution.js

@@ -1,6 +1,6 @@
-import { declaredReactivityChannelKeys as e, isReactivityChannelKey as t, sourceKeys as n } from "@voltro/protocol";
-//#region src/sourceResolution.ts
-var r = (e, t) => {
+import { captureOptionalQuerySources as e, declaredReactivityChannelKeys as t, isReactivityChannelKey as n, sourceKeys as r } from "@voltro/protocol";
+// src/sourceResolution.ts
+var i = (e, t) => {
 	let n, r = 0;
 	for (let i of t) {
 		let t = 0;
@@ -11,32 +11,41 @@ var r = (e, t) => {
 		o > r && o >= .6 && (r = o, n = i);
 	}
 	return n;
-}, i = (i, a) => {
-	let o = e(), s = [], c = /* @__PURE__ */ new Map();
-	for (let e of i) for (let i of n(e.source)) if (t(i)) {
-		if (o.has(i)) continue;
-		s.push({
-			procedure: e.name,
-			source: i,
-			didYouMean: void 0,
-			channel: !0
-		});
-	} else a.size === 0 || a.has(i) || (c.has(i) || c.set(i, r(i, a)), s.push({
-		procedure: e.name,
-		source: i,
-		didYouMean: c.get(i),
-		channel: !1
-	}));
-	return s;
-}, a = (e) => {
+}, a = (a, o) => {
+	let s = t(), c = [], l = /* @__PURE__ */ new Map();
+	for (let t of a) {
+		let a = new Set(e(t.name, t.source, t.optionalSource));
+		for (let e of r(t.source)) if (n(e)) {
+			if (s.has(e)) continue;
+			c.push({
+				procedure: t.name,
+				source: e,
+				didYouMean: void 0,
+				channel: !0,
+				...a.has(e) ? { optional: !0 } : {}
+			});
+		} else o.size === 0 || o.has(e) || (l.has(e) || l.set(e, i(e, o)), c.push({
+			procedure: t.name,
+			source: e,
+			didYouMean: a.has(e) ? void 0 : l.get(e),
+			channel: !1,
+			...a.has(e) ? { optional: !0 } : {}
+		}));
+	}
+	return c;
+}, o = (e) => {
 	if (e.length === 0) return;
-	let t = e.map((e) => e.channel ? `  ${e.procedure}: source '${e.source}' names a reactivity channel nobody declared` : `  ${e.procedure}: source '${e.source}' matches no declared table` + (e.didYouMean === void 0 ? "" : ` — did you mean '${e.didYouMean}'?`)), n = e.some((e) => e.channel) ? "\nFor the `channel:` entries: declare it with `reactivityChannel(<name>)` and pass the\nCHANNEL as `source:`, not its key as a string. Authoring against the object is what\nmakes a channel source impossible to leave stale — you cannot import a declaration\nthat does not exist." : "";
-	return `${e.length} reactive source(s) name a table that does not exist:\n${t.join("\n")}\n
+	let t = e.filter((e) => e.optional === !0);
+	if (t.length > 0) {
+		let n = o(e.filter((e) => e.optional !== !0)), r = t.map((e) => `  ${e.procedure}: optional integration source '${e.source}' is unavailable`);
+		return [n, `${t.length} optional integration source(s) are unavailable:\n${r.join("\n")}\nTheir observers remain declared. Installed sources still trigger recomputation; executor authorization still applies.`].filter((e) => e !== void 0).join("\n\n");
+	}
+	let n = e.map((e) => e.channel ? `  ${e.procedure}: source '${e.source}' names a reactivity channel nobody declared` : `  ${e.procedure}: source '${e.source}' matches no declared table` + (e.didYouMean === void 0 ? "" : ` — did you mean '${e.didYouMean}'?`)), r = e.some((e) => e.channel) ? "\nFor the `channel:` entries: declare it with `reactivityChannel(<name>)` and pass the\nCHANNEL as `source:`, not its key as a string. Authoring against the object is what\nmakes a channel source impossible to leave stale — you cannot import a declaration\nthat does not exist." : "";
+	return `${e.length} reactive source(s) name a table that does not exist:\n${n.join("\n")}\n
 These queries are NOT broken. They serve their first snapshot and then never
 update again, which is indistinguishable from "nothing has changed" — so the
 symptom is silence, and silence is what this surface exists to eliminate.
 A \`source:\` is a STRING, so \`tsc\` cannot see a stale one and a rename leaves it
-behind quietly.` + n;
+behind quietly.` + r;
 };
-//#endregion
-export { a as formatUnresolvedSources, i as unresolvedSources };
+export { o as formatUnresolvedSources, a as unresolvedSources };