@voltro/runtime 0.85.0 → 0.86.0

package/dist/memoryQueryJoins.js

@@ -0,0 +1,114 @@
+import { evaluatePredicate as e, getTable as t, isColumnReference as n, preparePredicate as r } from "@voltro/database";
+//#region src/memoryQueryJoins.ts
+var i = (e) => e == null || typeof e == "string" || typeof e == "boolean" || typeof e == "bigint" || typeof e == "number" && !Number.isNaN(e), a = (e, t = /* @__PURE__ */ new WeakSet()) => {
+	if (typeof e != "object" || !e || Object.getPrototypeOf(e) !== Object.prototype || t.has(e)) return !1;
+	t.add(e);
+	for (let t of Reflect.ownKeys(e)) {
+		let n = Object.getOwnPropertyDescriptor(e, t);
+		if (n === void 0 || !("value" in n)) return !1;
+	}
+	if ("not" in e) return a(e.not, t);
+	let n = "and" in e ? e.and : "or" in e ? e.or : void 0;
+	if (!("and" in e) && !("or" in e)) return !0;
+	if (!Array.isArray(n) || Object.getPrototypeOf(n) !== Array.prototype || Object.getOwnPropertyDescriptor(n, "forEach") !== void 0) return !1;
+	for (let e = 0; e < n.length; e += 1) {
+		let r = Object.getOwnPropertyDescriptor(n, String(e));
+		if (r === void 0 || !("value" in r) || !a(r.value, t)) return !1;
+	}
+	return !0;
+}, o = (e, t) => {
+	if ("and" in e) {
+		for (let n of e.and) {
+			let e = o(n, t);
+			if (e) return e;
+		}
+		return;
+	}
+	if (!("op" in e) || e.op !== "eq" || e.path !== void 0 || !n(e.value)) return;
+	let r = e.column, i = e.value.column, a = `${t}.`;
+	if (r.startsWith(a) !== i.startsWith(a)) return r.startsWith(a) ? [i, r] : [r, i];
+}, s = (n, s, c, l) => {
+	let u = n.alias ?? n.table, d = (n.sourceTable?.tableName === n.table ? n.sourceTable : t(n.table))?.fields ?? {}, f = new Set(Object.keys(d));
+	for (let e of s) for (let t of Object.keys(e)) f.add(t);
+	let p = [...f], m = typeof u == "string" && s.length >= 16 ? p.map((e) => [e, `${u}.${e}`]) : void 0, h = { ...d };
+	for (let [e, t] of Object.entries(d)) h[`${u}.${e}`] = t;
+	let g = /* @__PURE__ */ new Set([u]), _ = (e) => {
+		let t = {};
+		for (let [n, r] of m) {
+			let i = e[n] ?? null;
+			r in t ? Object.defineProperty(t, r, {
+				value: i,
+				enumerable: !0,
+				writable: !0,
+				configurable: !0
+			}) : t[r] = i;
+		}
+		return t;
+	}, v = m === void 0 ? s.map((e) => ({
+		...e,
+		...Object.fromEntries(p.map((t) => [`${u}.${t}`, e[t] ?? null]))
+	})) : s.map((e) => ({
+		...e,
+		..._(e)
+	}));
+	for (let s of n.joins ?? []) {
+		if (g.has(s.alias)) throw Error(`Duplicate query alias: ${s.alias}`);
+		g.add(s.alias);
+		let u = [...c.get(s.table)?.values() ?? []], d = (s.sourceTable?.tableName === s.table ? s.sourceTable : t(s.table))?.fields ?? {};
+		for (let [e, t] of Object.entries(d)) h[`${s.alias}.${e}`] = t;
+		let f = new Set(Object.keys(d));
+		for (let e of u) for (let t of Object.keys(e)) f.add(t);
+		for (let e of n.joinedProjection ?? []) e.source.startsWith(`${s.alias}.`) && f.add(e.source.slice(s.alias.length + 1));
+		let p = [...f].map((e) => [e, `${s.alias}.${e}`]), m = u.length < 16 ? (e) => Object.fromEntries(p.map(([t, n]) => [n, e?.[t] ?? null])) : (e) => {
+			let t = {};
+			for (let [n, r] of p) {
+				let i = e?.[n] ?? null;
+				r in t ? Object.defineProperty(t, r, {
+					value: i,
+					enumerable: !0,
+					writable: !0,
+					configurable: !0
+				}) : t[r] = i;
+			}
+			return t;
+		}, _ = u.map(m), y = l(s.on), b, x = _.length * v.length < 16, S = !1, C, w = o(s.on, s.alias), T;
+		if (w && h[w[0]]?.type !== "decimal" && h[w[1]]?.type !== "decimal" && _.every((e) => i(e[w[1]]))) {
+			T = /* @__PURE__ */ new Map();
+			for (let e of _) {
+				let t = e[w[1]];
+				if (t == null) continue;
+				let n = T.get(t);
+				n ? n.push(e) : T.set(t, [e]);
+			}
+		}
+		v = v.flatMap((t) => {
+			let n = w === void 0 ? void 0 : t[w[0]], o = T && i(n) ? n == null ? [] : T.get(n) ?? [] : _, c = x ? o.map((e) => ({
+				...t,
+				...e
+			})).filter((t) => e(s.on, t, y, h)) : [];
+			if (!x) for (let n of o) {
+				let i = {
+					...t,
+					...n
+				};
+				if (!S) {
+					S = !0;
+					let e = Object.getOwnPropertyDescriptor(s, "on");
+					e !== void 0 && "value" in e && a(e.value) && (b = r(e.value, y, h));
+				}
+				(b === void 0 ? e(s.on, i, y, h) : b(i)) && c.push(i);
+			}
+			return c.length > 0 || s.kind === "inner" ? c : (C ??= m(null), [{
+				...t,
+				...C
+			}]);
+		});
+	}
+	return {
+		rows: v,
+		columns: h,
+		project: (e) => n.joinedProjection?.length ? Object.fromEntries(n.joinedProjection.map((t) => [t.outputKey, e[t.source]])) : Object.fromEntries((n.projection ?? p).map((t) => [t, e[t]]))
+	};
+};
+//#endregion
+export { s as memoryQueryJoins };

package/dist/metrics.js

@@ -0,0 +1,161 @@
+import { subscriptionSocketMetricSamples as e } from "./subscriptionSocketMetrics.js";
+import { Effect as t, Metric as n } from "effect";
+//#region src/metrics.ts
+var r = n.exponentialBoundaries({
+	start: .001,
+	factor: 2,
+	count: 16
+}), i = n.counter("voltro_rpc_requests_total", { description: "Total RPC handler invocations." }), a = n.counter("voltro_rpc_errors_total", { description: "RPC handler invocations that errored." }), o = n.histogram("voltro_rpc_duration_seconds", {
+	boundaries: r,
+	description: "RPC handler duration in seconds."
+}), s = n.counter("voltro_http_requests_total", { description: "Total HTTP route invocations." }), c = n.histogram("voltro_http_duration_seconds", {
+	boundaries: r,
+	description: "HTTP route duration in seconds."
+}), l = n.histogram("voltro_plugin_hook_duration_seconds", {
+	boundaries: r,
+	description: "Plugin interceptor duration in seconds."
+}), u = n.counter("voltro_plugin_hook_errors_total", { description: "Plugin interceptor invocations that errored." }), d = n.counter("voltro_subscription_deliveries_total", { description: "Total subscription deliveries (snapshot + delta)." }), f = n.histogram("voltro_subscription_delivery_seconds", {
+	boundaries: r,
+	description: "Subscription delivery produce→push latency in seconds."
+}), ee = n.gauge("voltro_subscriptions_active", { description: "Currently-open subscriptions." }), p = n.counter("voltro_schedule_runs_total", { description: "Schedule firings by name + outcome." }), m = n.histogram("voltro_schedule_duration_seconds", {
+	boundaries: r,
+	description: "Schedule handler duration in seconds."
+}), h = n.gauge("voltro_schedule_last_success_timestamp_seconds", { description: "UNIX time of the last successful firing, per schedule." }), g = n.gauge("voltro_schedule_queued", { description: "Firings waiting for their turn under onOverlap: 'queue', per schedule, on THIS replica." }), _ = n.histogram("voltro_schedule_queue_wait_seconds", {
+	boundaries: r,
+	description: "Time a queued firing waited before it started, in seconds."
+}), v = n.counter("voltro_schedule_queue_recoveries_total", { description: "Queued firings whose replica stopped reporting, by what happened to them." }), y = n.counter("voltro_schedule_external_triggers_total", { description: "External trigger arrivals by schedule and decision." }), b = n.counter("voltro_schedule_external_missed_total", { description: "Occurrences of an external schedule that were never triggered." }), x = n.counter("voltro_workflow_runs_total", { description: "Workflow run terminal outcomes by name + status." }), S = n.histogram("voltro_workflow_duration_seconds", {
+	boundaries: r,
+	description: "Workflow run duration in seconds."
+}), C = n.gauge("voltro_workflow_last_success_timestamp_seconds", { description: "UNIX time of the last successful run, per workflow." }), w = n.counter("voltro_event_published_total", { description: "Events published, by event name." }), T = n.counter("voltro_event_deliveries_total", { description: "Event deliveries handed to a subscriber, by event name." }), E = n.counter("voltro_event_dropped_total", { description: "Event deliveries a subscriber provably lost, by event name + reason." }), D = n.gauge("voltro_event_subscribers", { description: "Currently-attached event subscribers, by event name." }), O = /* @__PURE__ */ new Map(), k = (e, t, r) => {
+	let i = O.get(t);
+	if (i !== void 0) return i;
+	let a = e;
+	for (let [e, t] of r) a = n.withAttributes(a, { [e]: t });
+	return O.set(t, a), a;
+}, A = () => {
+	O.clear();
+}, j = () => O.size, M = (e) => {
+	t.runSync(n.update(k(w, `p:${e}`, [["event", e]]), 1));
+}, te = (e, r = 1) => {
+	r <= 0 || t.runSync(n.update(k(T, `d:${e}`, [["event", e]]), r));
+}, N = (e, r, i = 1) => {
+	i <= 0 || t.runSync(n.update(k(E, `x:${r}:${e}`, [["event", e], ["reason", r]]), i));
+}, P = (e, r) => {
+	r !== 0 && t.runSync(n.update(k(D, `s:${e}`, [["event", e]]), r));
+}, F = (e) => {
+	let r = e.durationMs / 1e3, d = e.kind === "rpc" ? t.andThen(n.update(i, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		tag: e.tag,
+		status: e.status
+	})), t.andThen(n.update(o, r).pipe(t.provideService(n.CurrentMetricAttributes, { tag: e.tag })), e.status === "error" ? n.update(a, 1).pipe(t.provideService(n.CurrentMetricAttributes, { tag: e.tag })) : t.void)) : e.kind === "request" ? t.andThen(n.update(s, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		route: e.tag,
+		status: e.status
+	})), n.update(c, r).pipe(t.provideService(n.CurrentMetricAttributes, { route: e.tag }))) : t.andThen(n.update(l, r).pipe(t.provideService(n.CurrentMetricAttributes, { hook: e.tag })), e.status === "error" ? n.update(u, 1).pipe(t.provideService(n.CurrentMetricAttributes, { hook: e.tag })) : t.void);
+	t.runSync(d);
+}, I = (e) => e.startsWith("subscription.") ? e.slice(13) : e, L = (e) => {
+	let r = I(e.label);
+	t.runSync(t.andThen(n.update(d, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		tag: r,
+		kind: e.kind
+	})), n.update(f, e.durationMs / 1e3).pipe(t.provideService(n.CurrentMetricAttributes, {
+		tag: r,
+		kind: e.kind
+	}))));
+}, R = /* @__PURE__ */ new Map(), z = (e, r) => {
+	let i = I(e), a = Math.max(0, (R.get(i) ?? 0) + r);
+	a === 0 ? R.delete(i) : R.set(i, a), t.runSync(n.update(ee, a).pipe(t.provideService(n.CurrentMetricAttributes, { tag: i })));
+}, B = (e) => {
+	let r = n.update(p, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		schedule: e.name,
+		status: e.status
+	})), i = n.update(m, e.durationMs / 1e3).pipe(t.provideService(n.CurrentMetricAttributes, { schedule: e.name })), a = e.status === "succeeded" && e.completedAtSec !== void 0 ? n.update(h, e.completedAtSec).pipe(t.provideService(n.CurrentMetricAttributes, { schedule: e.name })) : t.void;
+	t.runSync(t.andThen(r, t.andThen(i, a)));
+}, V = /* @__PURE__ */ new Map(), H = (e, r) => {
+	let i = Math.max(0, (V.get(e) ?? 0) + r);
+	i === 0 ? V.delete(e) : V.set(e, i), t.runSync(n.update(g, i).pipe(t.provideService(n.CurrentMetricAttributes, { schedule: e })));
+}, U = (e, r) => {
+	t.runSync(n.update(_, r / 1e3).pipe(t.provideService(n.CurrentMetricAttributes, { schedule: e })));
+}, W = (e, r) => {
+	t.runSync(n.update(v, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		schedule: e,
+		outcome: r
+	})));
+}, G = (e, r) => {
+	t.runSync(n.update(y, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		schedule: e,
+		outcome: r
+	})));
+}, K = (e, r = 1) => {
+	r <= 0 || t.runSync(n.update(b, r).pipe(t.provideService(n.CurrentMetricAttributes, { schedule: e })));
+}, q = (e) => {
+	let r = n.update(x, 1).pipe(t.provideService(n.CurrentMetricAttributes, {
+		workflow: e.name,
+		status: e.status
+	})), i = n.update(S, e.durationMs / 1e3).pipe(t.provideService(n.CurrentMetricAttributes, { workflow: e.name })), a = e.status === "succeeded" && e.completedAtSec !== void 0 ? n.update(C, e.completedAtSec).pipe(t.provideService(n.CurrentMetricAttributes, { workflow: e.name })) : t.void;
+	t.runSync(t.andThen(r, t.andThen(i, a)));
+}, J = (e, t) => n.counter(e, t === void 0 ? {} : { description: t }), Y = (e, t) => n.gauge(e, t === void 0 ? {} : { description: t }), X = (e, t = r, i) => n.histogram(e, {
+	boundaries: t,
+	...i === void 0 ? {} : { description: i }
+}), { exponentialBoundaries: Z, linearBoundaries: Q } = n, $ = n.snapshot.pipe(t.map((e) => e.map((e) => {
+	let t = e.id, n = { ...e.attributes ?? {} }, r = e.description === void 0 ? {} : { description: e.description };
+	switch (e.type) {
+		case "Histogram": return {
+			name: t,
+			labels: n,
+			...r,
+			type: "histogram",
+			buckets: e.state.buckets.map(([e, t]) => ({
+				le: e,
+				count: t
+			})),
+			sum: e.state.sum,
+			count: e.state.count
+		};
+		case "Gauge": return {
+			name: t,
+			labels: n,
+			...r,
+			type: "gauge",
+			value: Number(e.state.value)
+		};
+		case "Summary": {
+			let i = [];
+			for (let [t, n] of e.state.quantiles) n !== void 0 && i.push({
+				quantile: t,
+				value: n
+			});
+			return {
+				name: t,
+				labels: n,
+				...r,
+				type: "summary",
+				sum: e.state.sum,
+				count: e.state.count,
+				quantiles: i
+			};
+		}
+		case "Frequency": {
+			let i = {};
+			for (let [t, n] of e.state.occurrences) i[t] = n;
+			return {
+				name: t,
+				labels: n,
+				...r,
+				type: "frequency",
+				occurrences: i
+			};
+		}
+		case "Counter": return {
+			name: t,
+			labels: n,
+			...r,
+			type: "counter",
+			value: Number(e.state.count)
+		};
+	}
+})), t.map((t) => {
+	let n = e();
+	for (let e of n) t.push(e);
+	return t;
+})), ne = () => t.runSync($);
+//#endregion
+export { J as counter, j as eventMetricTagCacheSizeForTests, Z as exponentialBoundaries, Y as gauge, X as histogramMetric, Q as linearBoundaries, te as recordEventDelivered, N as recordEventDropped, M as recordEventPublished, P as recordEventSubscribers, K as recordExternalMissed, G as recordExternalTrigger, F as recordSample, W as recordScheduleQueueRecovery, U as recordScheduleQueueWait, H as recordScheduleQueued, B as recordScheduleRun, z as recordSubscriptionActive, L as recordSubscriptionDelivery, q as recordWorkflowRun, A as resetEventMetricTagCacheForTests, $ as snapshotMetrics, ne as snapshotMetricsSync };

package/dist/observability.js

@@ -0,0 +1,123 @@
+import { bootRefusal as e } from "./bootRefusal.js";
+import { Context as t, Effect as n, Layer as r, Option as i, Tracer as a } from "effect";
+import { AsyncLocalStorage as o } from "node:async_hooks";
+//#region src/observability.ts
+var s = () => {
+	let e = process.env.FRAMEWORK_TRACING?.toLowerCase();
+	return e === "console" || e === "otlp" || e === "off" ? e : process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ? "otlp" : "off";
+}, c = () => {
+	let e = process.env.FRAMEWORK_METRICS?.toLowerCase();
+	return e === "console" || e === "otlp" || e === "off" ? e : process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT ? "otlp" : "off";
+}, l = (e) => {
+	let t = [];
+	return e.mode !== "off" && t.push(`trace export is on (mode "${e.mode}" — from FRAMEWORK_TRACING or an OTEL_EXPORTER_OTLP_* endpoint); FRAMEWORK_TRACING=off turns it off`), e.metricsMode !== "off" && t.push(`metrics export is on (mode "${e.metricsMode}" — from FRAMEWORK_METRICS or an OTEL_EXPORTER_OTLP_* endpoint); FRAMEWORK_METRICS=off turns it off`), e.traceSink && t.push(e.traceSinkOrigin ?? "an in-process trace sink is installed"), (e.pluginSpanProcessors > 0 || e.pluginMetricReaders > 0) && t.push("a plugin contributes a span processor or metric reader (an observability plugin such as a vendor exporter); remove the plugin to drop this cause"), t;
+}, u = (e) => [
+	"`@effect/opentelemetry` is not installed, and this boot needs the OpenTelemetry SDK because:",
+	...e.map((e) => `  - ${e}`),
+	"It is an optional peer dependency of @voltro/runtime — needed only for an active tracer layer, and",
+	"carrying it unconditionally made every install print unmet-peer warnings for peers it declares and nobody uses.",
+	"  Install it:  pnpm add @effect/opentelemetry",
+	"  Or remove every cause listed above."
+].join("\n"), d = (t, n = []) => {
+	let r = t?.code;
+	return r === "ERR_MODULE_NOT_FOUND" || r === "MODULE_NOT_FOUND" ? e(u(n)) : t instanceof Error ? t : Error(String(t));
+}, f = async (e) => {
+	let [t, n, r, i, a] = await Promise.all([
+		import("@opentelemetry/sdk-trace-base"),
+		import("@opentelemetry/sdk-metrics"),
+		import("@opentelemetry/exporter-trace-otlp-http"),
+		import("@opentelemetry/exporter-metrics-otlp-http"),
+		import("@effect/opentelemetry/NodeSdk").catch((t) => {
+			throw d(t, e);
+		})
+	]);
+	return {
+		sdkTrace: t,
+		sdkMetrics: n,
+		otlpTrace: r,
+		otlpMetrics: i,
+		nodeSdk: a
+	};
+}, p = (e, t, n) => {
+	let { PeriodicExportingMetricReader: r, ConsoleMetricExporter: i, InMemoryMetricExporter: a, AggregationTemporality: o } = e.sdkMetrics;
+	if (t === "off") return {
+		reader: void 0,
+		inMemory: void 0
+	};
+	if (t === "memory") {
+		let e = new a(o.CUMULATIVE);
+		return {
+			reader: new r({
+				exporter: e,
+				exportIntervalMillis: n
+			}),
+			inMemory: e
+		};
+	}
+	return {
+		reader: new r({
+			exporter: t === "console" ? new i() : new e.otlpMetrics.OTLPMetricExporter(),
+			exportIntervalMillis: n
+		}),
+		inMemory: void 0
+	};
+}, m = async (e = {}) => {
+	let u = e.mode ?? s(), d = e.metricsMode ?? c(), m = e.extraSpanProcessors ?? [], h = e.extraMetricReaders ?? [];
+	if (u === "off" && e.traceSink === void 0 && d === "off" && m.length === 0 && h.length === 0) return {
+		layer: r.empty,
+		mode: u,
+		bufferOnly: !1,
+		inMemoryExporter: void 0,
+		metricsMode: d,
+		inMemoryMetricExporter: void 0
+	};
+	let g = await f(l({
+		mode: u,
+		metricsMode: d,
+		traceSink: e.traceSink !== void 0,
+		traceSinkOrigin: e.traceSinkOrigin,
+		pluginSpanProcessors: m.length,
+		pluginMetricReaders: h.length
+	})), { ConsoleSpanExporter: _, InMemorySpanExporter: v, SimpleSpanProcessor: y, BatchSpanProcessor: b } = g.sdkTrace, x = u === "off", S = e.serviceName ?? process.env.OTEL_SERVICE_NAME ?? "voltro-app", C, w;
+	e.spanProcessor ? w = e.spanProcessor : x ? w = void 0 : u === "memory" ? (C = new v(), w = new y(C)) : w = u === "console" ? new y(new _()) : new b(new g.otlpTrace.OTLPTraceExporter());
+	let T = [
+		...e.traceSink ? [e.traceSink] : [],
+		...w ? [w] : [],
+		...m
+	], E = T.length === 1 ? T[0] : T, { reader: D, inMemory: O } = p(g, d, e.metricExportIntervalMillis ?? (process.env.OTEL_METRIC_EXPORT_INTERVAL ? Number(process.env.OTEL_METRIC_EXPORT_INTERVAL) : 6e4)), k = [...D ? [D] : [], ...h], A = k.length === 0 ? void 0 : k.length === 1 ? k[0] : k, j = {
+		serviceName: S,
+		...e.serviceVersion ? { serviceVersion: e.serviceVersion } : {},
+		...e.resourceAttributes ? { attributes: e.resourceAttributes } : {}
+	}, M = g.nodeSdk.layer(() => ({
+		resource: j,
+		spanProcessor: E,
+		...A ? { metricReader: A } : {},
+		...e.sampler ? { tracerConfig: { sampler: e.sampler } } : {}
+	})), N = new o(), P = (e, t) => e["~effect/Effect/evaluate"](t);
+	return {
+		layer: r.unwrap(n.map(n.tracer, (e) => {
+			let n = e.context;
+			return r.succeed(a.Tracer, a.make({
+				span(t) {
+					let n = i.isNone(t.parent) ? N.getStore() : void 0;
+					return e.span(n === void 0 ? t : {
+						...t,
+						parent: i.some(n),
+						root: !1
+					});
+				},
+				context(e, r) {
+					let o = n ?? P, s = i.getOrUndefined(t.getOption(r.context, a.ParentSpan)) ?? N.getStore();
+					return s === void 0 ? o(e, r) : N.run(s, () => o(e, r));
+				}
+			}));
+		})).pipe(r.provideMerge(M)),
+		mode: u,
+		bufferOnly: x,
+		inMemoryExporter: C,
+		metricsMode: d,
+		inMemoryMetricExporter: O
+	};
+};
+//#endregion
+export { m as buildTracingLayer, l as describeOtelReasons, d as otelImportFailure };

package/dist/observedGraph.js

@@ -0,0 +1,52 @@
+import { AsyncLocalStorage as e } from "node:async_hooks";
+//#region src/observedGraph.ts
+var t = new e(), n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set(), i = "\0", a = process.env.VOLTRO_OBSERVE_GRAPH === "1", o = () => {
+	a = !0;
+}, s = () => a, c = (e, n) => a ? (r.add(e.tag), t.run(e, n)) : n(), l = (e, r) => {
+	if (!a) return;
+	let o = t.getStore();
+	o !== void 0 && (e.startsWith("_voltro_") || n.add(`${o.tag}${i}${o.kind}${i}${e}${i}${r}`));
+}, u = () => {
+	let e = Array(n.size), t = 0;
+	for (let r of n) {
+		let [n, a, o, s] = r.split(i);
+		e[t++] = {
+			tag: n,
+			kind: a,
+			table: o,
+			op: s
+		};
+	}
+	return {
+		version: 1,
+		edges: e.sort((e, t) => e.tag.localeCompare(t.tag) || e.table.localeCompare(t.table) || e.op.localeCompare(t.op)),
+		exercised: [...r].sort()
+	};
+}, d = () => {
+	n.clear(), r.clear();
+}, f = (e) => {
+	if (!a) return e;
+	let t = Object.create(Object.getPrototypeOf(e));
+	for (let n of Reflect.ownKeys(e)) Object.defineProperty(t, n, Object.getOwnPropertyDescriptor(e, n));
+	let n = (n, r, i) => {
+		let a = e[n];
+		if (typeof a != "function") return;
+		let o = a;
+		t[n] = (...t) => {
+			let n = r(t);
+			return n !== void 0 && l(n, i), o.apply(e, t);
+		};
+	}, r = (e) => typeof e[0] == "string" ? e[0] : void 0;
+	n("query", (e) => {
+		let t = e[0];
+		return typeof t?.table == "string" ? t.table : void 0;
+	}, "read"), n("insert", r, "insert"), n("insertMany", r, "insert"), n("insertIgnore", r, "insert"), n("insertIgnoreWithOutcome", r, "insert"), n("update", r, "update"), n("updateMany", r, "update"), n("patchJson", r, "update"), n("delete", r, "delete"), n("deleteMany", r, "delete"), n("upsert", r, "upsert");
+	let i = e.transactional;
+	if (typeof i == "function") {
+		let n = i;
+		t.transactional = (t) => n.call(e, (e) => t(f(e)));
+	}
+	return t;
+};
+//#endregion
+export { o as enableGraphObservation, s as isObservingGraph, f as observeStore, u as observedGraph, l as recordTableAccess, d as resetObservedGraph, c as runWithObservedProcedure };

package/dist/originGuard.js

@@ -0,0 +1,116 @@
+//#region src/originGuard.ts
+var e = (e) => {
+	let t = e.toUpperCase();
+	return t !== "GET" && t !== "HEAD" && t !== "OPTIONS";
+}, t = "/_voltro/inspect", n = (e, t) => e === t || e.startsWith(t.endsWith("/") ? t : `${t}/`), r = (e) => {
+	let r = [t];
+	for (let t of e.webhookPaths ?? []) r.push(t);
+	let i = /* @__PURE__ */ new Map();
+	for (let t of e.httpRoutes ?? []) {
+		let e = t.originGuard === "exempt";
+		i.set(t.path, (i.get(t.path) ?? !0) && e);
+	}
+	for (let [e, t] of i) t && r.push(e);
+	return (e) => r.some((t) => n(e, t));
+}, i = {
+	"http:": "80",
+	"https:": "443",
+	"ws:": "80",
+	"wss:": "443"
+}, a = (e) => {
+	let t = e.trim(), n;
+	try {
+		n = new URL(t);
+	} catch {
+		return t.toLowerCase();
+	}
+	let r = n.protocol.toLowerCase();
+	return `${r}//${n.hostname.toLowerCase()}${n.port === "" || n.port === i[r] ? "" : `:${n.port}`}`;
+}, o = (e, t) => {
+	if (t === void 0 || t.trim() === "") return !1;
+	let n;
+	try {
+		let t = new URL(e), r = t.protocol.toLowerCase(), a = t.port === "" || t.port === i[r] ? "" : `:${t.port}`;
+		n = `${t.hostname.toLowerCase()}${a}`;
+	} catch {
+		return !1;
+	}
+	let r = t.trim().toLowerCase(), a = r.lastIndexOf(":");
+	if (a > 0 && !r.slice(a + 1).includes("]")) {
+		let e = r.slice(a + 1);
+		(e === "80" || e === "443") && (r = r.slice(0, a));
+	}
+	return n === r;
+}, s = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"::1",
+	"0.0.0.0"
+]), c = (e) => {
+	let t = e.toLowerCase().replace(/^\[|\]$/g, "");
+	return s.has(t) || t.endsWith(".localhost") || t.startsWith("127.");
+}, l = (e, t) => {
+	if (t === void 0 || t.trim() === "") return !1;
+	let n;
+	try {
+		n = new URL(e).hostname;
+	} catch {
+		return !1;
+	}
+	if (!c(n)) return !1;
+	let r = t.trim(), i = r.lastIndexOf(":");
+	return i > 0 && !r.slice(i + 1).includes("]") && (r = r.slice(0, i)), c(r);
+}, u = (e) => {
+	let { headers: t, config: n } = e;
+	if (n.mode === "off") return {
+		allowed: !0,
+		reason: "guard-off"
+	};
+	let r = t.origin;
+	if (r !== void 0 && r.trim() !== "") {
+		if (r.trim().toLowerCase() === "null") return {
+			allowed: !1,
+			reason: "opaque-origin",
+			origin: "null"
+		};
+		let e = a(r);
+		return o(e, t.host) ? {
+			allowed: !0,
+			reason: "same-origin"
+		} : n.allowedOrigins.includes(e) ? {
+			allowed: !0,
+			reason: "allowlisted"
+		} : l(e, t.host) ? {
+			allowed: !0,
+			reason: "loopback"
+		} : {
+			allowed: !1,
+			reason: "cross-origin",
+			origin: e
+		};
+	}
+	let i = t["sec-fetch-site"];
+	if (i !== void 0 && i.trim() !== "") {
+		let e = i.trim().toLowerCase();
+		return e !== "same-origin" && e !== "none" ? {
+			allowed: !1,
+			reason: "cross-site-metadata",
+			origin: e
+		} : {
+			allowed: !0,
+			reason: "same-origin"
+		};
+	}
+	return {
+		allowed: !0,
+		reason: "no-browser-origin"
+	};
+}, d = (e, t = process.env) => {
+	let n = t.VOLTRO_ORIGIN_GUARD?.trim().toLowerCase(), r = e?.mode ?? (n === "off" ? "off" : "same-origin"), i = e?.allowedOrigins;
+	return {
+		mode: r,
+		allowedOrigins: (i !== void 0 && i.length > 0 ? i : (t.VOLTRO_ALLOWED_ORIGINS ?? "").split(",").map((e) => e.trim()).filter((e) => e.length > 0)).map(a)
+	};
+};
+//#endregion
+export { u as classifyRequestOrigin, e as isStateChangingMethod, r as makeOriginGuardExemption, a as normalizeOrigin, d as resolveOriginGuardConfig };