@voltro/runtime 0.87.0 → 0.88.0

package/dist/engineClients.js

@@ -1,4 +1,4 @@
-//#region src/engineClients.ts
+// src/engineClients.ts
 var e = /* @__PURE__ */ new Map(), t = 0, n = (e) => {
 	let t = /^([a-z]{1,16})\/([0-9A-Za-z.+-]{1,100})(?:; surface=([0-9a-f]{64}))?$/.exec(e.trim());
 	return t ? {
@@ -20,5 +20,4 @@ var e = /* @__PURE__ */ new Map(), t = 0, n = (e) => {
 		e.delete(s);
 	});
 }, i = () => [...e.values()];
-//#endregion
 export { i as engineClientsSnapshot, n as parseEngineSdkHeader, r as trackEngineClient };

package/dist/eventBus.js

@@ -1,7 +1,7 @@
 import { recordEventDropped as e, recordEventPublished as t, recordEventSubscribers as n } from "./metrics.js";
 import { eventRoute as r, parseEventRoute as i } from "@voltro/protocol";
 import { createLogger as a } from "@voltro/logger";
-//#region src/eventBus.ts
+// src/eventBus.ts
 var o = a({ scope: "voltro:events" }), s = 64, c = 3e5, l = 1e4, u = class {
 	routes = /* @__PURE__ */ new Map();
 	origin;
@@ -256,5 +256,4 @@ var o = a({ scope: "voltro:events" }), s = 64, c = 3e5, l = 1e4, u = class {
 		this.routes.clear();
 	}
 };
-//#endregion
 export { u as EventBus };

package/dist/eventPublish.js

@@ -1,6 +1,6 @@
 import { Context as e, Effect as t, Schema as n } from "effect";
 import { EventKeyInvalid as r, EventPayloadInvalid as i, EventPayloadTooLarge as a, MAX_EVENT_ENVELOPE_BYTES as o } from "@voltro/protocol";
-//#region src/eventPublish.ts
+// src/eventPublish.ts
 var s = (e) => e instanceof Error ? e.message : String(e), c = (e, c, l, u) => t.gen(function* () {
 	let d = n.encodeEffect(c.key), f = n.encodeEffect(c.payload), p = yield* d(l).pipe(t.mapError((e) => new r({
 		event: c.name,
@@ -45,5 +45,4 @@ var s = (e) => e instanceof Error ? e.message : String(e), c = (e, c, l, u) => t
 	let n;
 	return Object.assign(e, { then: (r, i) => (n ??= t.runPromise(e), n.then(r, i)) });
 }, d = (e) => ({ publish: (t, n, r) => u(c(e, t, n, r)) });
-//#endregion
 export { l as OutboxEventPublisher, d as makeEventPublisher, c as publishEvent };

package/dist/events.js

@@ -1,5 +1,5 @@
 import { boolean as e, eq as t, id as n, json as r, table as i, text as a, timestamp as o } from "@voltro/database";
-//#region src/events.ts
+// src/events.ts
 var s = (e) => {
 	if ("on" in e) {
 		let { on: t, ...n } = e;
@@ -189,5 +189,4 @@ var s = (e) => {
 		};
 	} };
 };
-//#endregion
 export { m as _voltroWorkflowEventDeliveriesTable, p as _voltroWorkflowEventsTable, c as defineEventTrigger, l as isWorkflowEventTriggerDefinition, h as makeEventsFacade, s as triggerWorkflow };

package/dist/expectation.js

@@ -1,5 +1,5 @@
 import { Context as e, Effect as t } from "effect";
-//#region src/expectation.ts
+// src/expectation.ts
 var n = /* @__PURE__ */ new Set([
 	"info",
 	"warn",
@@ -48,5 +48,4 @@ var n = /* @__PURE__ */ new Set([
 }, a = (e) => typeof e == "object" && !!e && e._voltroExpectation === !0, o = class extends e.Service()("@voltro/ExpectationRegistry") {}, s = (e) => t.gen(function* () {
 	return (yield* o).get(e.name);
 });
-//#endregion
 export { o as ExpectationRegistry, i as defineExpectation, a as isExpectationDefinition, s as useExpectation };

package/dist/expectationEvaluator.js

@@ -1,6 +1,6 @@
 import { AggregateMaintainer as e } from "./aggregateIvm.js";
 import { collectProjectedRows as t } from "./projectedRows.js";
-//#region src/expectationEvaluator.ts
+// src/expectationEvaluator.ts
 var n = (e) => {
 	if (e instanceof Date) return e.getTime();
 	if (typeof e == "number" && Number.isFinite(e)) return e;
@@ -287,7 +287,7 @@ var n = (e) => {
 		let t = e ? [] : Array(i.size), n = 0;
 		return i.forEach((r) => {
 			let i = r.state();
-			(!e || i.status === "violated") && (t[n++] = i);
+			e && i.status !== "violated" || (t[n++] = i);
 		}), t;
 	};
 	return {
@@ -304,5 +304,4 @@ var n = (e) => {
 		runTick: d
 	};
 };
-//#endregion
 export { u as ExpectationEvaluator, d as attachExpectations };

package/dist/experiment.js

@@ -1,5 +1,5 @@
 import { Context as e, Effect as t } from "effect";
-//#region src/experiment.ts
+// src/experiment.ts
 var n = "holdout", r = (e, t) => /* @__PURE__ */ Error(`defineExperiment(${JSON.stringify(e)}): ${t}`), i = (e) => {
 	if (e == null) return null;
 	if (typeof e == "number") return Number.isFinite(e) ? String(e) : null;
@@ -92,5 +92,4 @@ var n = "holdout", r = (e, t) => /* @__PURE__ */ Error(`defineExperiment(${JSON.
 }, l = (e) => e.holdout > 0 ? [...e.variants.map((e) => e.name), n] : e.variants.map((e) => e.name), u = class extends e.Service()("@voltro/ExperimentRegistry") {}, d = (e) => t.gen(function* () {
 	return (yield* u).get(e.name);
 });
-//#endregion
 export { u as ExperimentRegistry, n as HOLDOUT_VARIANT, c as assignVariant, a as defineExperiment, s as hashUnitInterval, o as isExperimentDefinition, l as resultVariantNames, d as useExperiment };

package/dist/experimentEvaluator.js

@@ -1,7 +1,7 @@
 import { AggregateMaintainer as e } from "./aggregateIvm.js";
 import { collectProjectedRows as t } from "./projectedRows.js";
 import { assignVariant as n, resultVariantNames as r } from "./experiment.js";
-//#region src/experimentEvaluator.ts
+// src/experimentEvaluator.ts
 var i = "__voltro_variant", a = "__voltro_metric", o = class {
 	project;
 	maintainer;
@@ -241,5 +241,4 @@ var i = "__voltro_variant", a = "__voltro_metric", o = class {
 		registered: [...i.keys()]
 	};
 };
-//#endregion
 export { f as ExperimentEvaluator, p as attachExperiments };

package/dist/externalizedTasks.js

@@ -1,4 +1,4 @@
-//#region src/externalizedTasks.ts
+// src/externalizedTasks.ts
 var e = 6e4, t = (e) => {
 	if (!Number.isFinite(e) || e < 6e4 || e % 6e4 != 0) return;
 	let t = e / 6e4;
@@ -34,5 +34,4 @@ var e = 6e4, t = (e) => {
 	get: (t) => e.get(t),
 	names: () => [...e.keys()].sort()
 }), o = () => a(/* @__PURE__ */ new Map()), s = (e) => a(i()).register(e), c = (e) => i().get(e), l = () => [...i().keys()].sort();
-//#endregion
 export { e as MIN_EXTERNALIZABLE_INTERVAL_MS, t as cronForInterval, n as externalizationRefusal, c as externalizedTask, l as externalizedTaskNames, o as makeExternalizedTaskRegistry, s as registerExternalizedTask };

package/dist/fieldCipher.js

@@ -1,7 +1,7 @@
 import { recordFieldDecrypt as e } from "./metrics.js";
 import { BOUND_ENCRYPTED_PREFIX as t, ENCRYPTED_PREFIX as n, FIELD_KEY_ID_PATTERN as r, ciphertextKeyId as i, decodeFieldValue as a, encodeFieldValue as o, isEncrypted as s } from "@voltro/database";
 import { createCipheriv as c, createDecipheriv as l, createHmac as u, randomBytes as d, scryptSync as f } from "node:crypto";
-//#region src/fieldCipher.ts
+// src/fieldCipher.ts
 var p = (e) => /^[0-9a-f]{64}$/i.test(e) ? Buffer.from(e, "hex") : f(e, "voltro:field-encryption:v1", 32), m = (e, t) => {
 	let n = e === "r" ? t?.row : e === "c" ? t?.column : void 0;
 	if (n === void 0) throw Error(e === "r" || e === "c" ? `field cipher: ciphertext is bound to its ${e === "r" ? "row" : "column"} and was read without that binding` : "field cipher: malformed ciphertext");
@@ -126,5 +126,4 @@ var p = (e) => /^[0-9a-f]{64}$/i.test(e) ? Buffer.from(e, "hex") : f(e, "voltro:
 	if (!n) throw Error(`decryptField: ${w}`);
 	return a(n, e, void 0, t);
 };
-//#endregion
 export { _ as FieldKeyringConfigError, E as decryptField, p as deriveKey, T as encryptField, g as fieldKeyIdOf, C as getFieldCipher, v as isFieldKeyring, h as makeAesCipher, b as makeFieldCipher, y as makeFieldKeyring, S as setFieldCipher };

package/dist/fieldKeyRegistry.js

@@ -1,7 +1,7 @@
 import { derivedRowId as e, encryptedColumnsOf as t, eq as n, fieldBinding as r, fieldBindingsOf as i, id as a, isEncrypted as o, isNotNull as s, json as c, lt as l, table as u, text as d, timestamp as f } from "@voltro/database";
 import { randomUUID as p } from "node:crypto";
 import { hostname as m } from "node:os";
-//#region src/fieldKeyRegistry.ts
+// src/fieldKeyRegistry.ts
 var h = u("_voltro_field_keys", {
 	id: a({ prefix: "fkey" }),
 	keyId: d().maxLength(16).unique(),
@@ -291,5 +291,4 @@ var h = u("_voltro_field_keys", {
 		lacking: l
 	};
 });
-//#endregion
 export { v as FIELD_KEYS_TABLE, w as FIELD_KEY_HEARTBEAT_MS, S as FIELD_KEY_HOLDERS_TABLE, C as FIELD_KEY_LEASE_MS, y as FIELD_KEY_REPORTS_TABLE, A as FieldKeyringRefusal, g as _voltroFieldKeyHoldersTable, _ as _voltroFieldKeyReportsTable, h as _voltroFieldKeysTable, Z as activateFieldKeyNow, I as checkFieldKeyring, E as fieldKeyHolderId, L as heartbeatFieldKeys, W as readFieldKeyHolders, x as readFieldKeyReports, P as readFieldKeys, b as recordFieldKeyReport, J as registerFieldKey, R as releaseFieldKeyHolder, X as retireFieldKey, z as startFieldKeyHolder, F as verifyFieldKeyring };

package/dist/fieldKeyRekey.js

@@ -3,7 +3,7 @@ import { Effect as o } from "effect";
 import { ciphertextKeyId as s, fieldBinding as c, quoteIdent as l } from "@voltro/database";
 import { SqlClient as u } from "effect/sql";
 import { STEP_JOURNAL_BINDING as d, WORKFLOW_JOURNAL_BINDING as f } from "@voltro/workflow";
-//#region src/fieldKeyRekey.ts
+// src/fieldKeyRekey.ts
 var p = (e) => {
 	let t = e.renames?.get(e.table), n = t?.columns.get(e.column);
 	return {
@@ -282,5 +282,4 @@ var p = (e) => {
 		unreadableColumns: m
 	};
 });
-//#endregion
 export { D as nullUnreadableSealedValues, b as openCell, y as rekeyCell, C as rekeySealedValues, T as verifySealedValues };

package/dist/fieldKeyScan.js

@@ -3,7 +3,7 @@ import { Effect as n } from "effect";
 import { ciphertextKeyId as r, encryptedColumnsOf as i, quoteIdent as a } from "@voltro/database";
 import { SqlClient as o } from "effect/sql";
 import { introspectSchema as s } from "@voltro/database/sql";
-//#region src/fieldKeyScan.ts
+// src/fieldKeyScan.ts
 var c = /enc:v[12]:[A-Za-z0-9+/=:_-]+/g, l = 500, u = /* @__PURE__ */ new Set(["text", "json"]), d = (e, t, n) => e === "postgres" ? `CAST(${t} AS TEXT)` : n === "json" && (e === "mysql" || e === "mariadb") ? `CAST(${t} AS CHAR)` : t, f = (e) => {
 	let t = e instanceof Error ? e.message : String(e);
 	for (let n = e?.cause; n instanceof Error; n = n.cause) t = n.message;
@@ -132,5 +132,4 @@ var c = /enc:v[12]:[A-Za-z0-9+/=:_-]+/g, l = 500, u = /* @__PURE__ */ new Set(["
 		plaintext: S.reduce((e, t) => e + t.plaintext, 0)
 	};
 });
-//#endregion
 export { c as ENVELOPE_PATTERN, m as cellText, g as declaredEncryptedColumns, _ as declaredRenames, h as discoverSealedColumns, y as fieldKeyStatus, f as reasonOf };

package/dist/fieldKeyring.js

@@ -1,5 +1,5 @@
 import { FieldKeyringConfigError as e, deriveKey as t, fieldKeyIdOf as n } from "./fieldCipher.js";
-//#region src/fieldKeyring.ts
+// src/fieldKeyring.ts
 var r = "VOLTRO_FIELD_ENCRYPTION_KEYS", i = "VOLTRO_FIELD_ENCRYPTION_ACTIVE", a = "VOLTRO_FIELD_ENCRYPTION_KEY", o = "VOLTRO_FIELD_ENCRYPTION_KEY_PREVIOUS", s = [
 	r,
 	i,
@@ -73,5 +73,4 @@ var r = "VOLTRO_FIELD_ENCRYPTION_KEYS", i = "VOLTRO_FIELD_ENCRYPTION_ACTIVE", a
 	for (let n = 0; n < t.keys.length; n++) for (let r = n + 1; r < t.keys.length; r++) if (u(t.keys[n].secret, t.keys[r].secret)) throw new e(`field encryption: keys "${t.keys[n].id}" and "${t.keys[r].id}" are the same key — a rotation needs a NEW key, and two ids for one key make every count per key wrong`);
 	if (!n.has(t.active)) throw new e(`field encryption: the active key "${t.active}" is not one of the configured keys (${[...n].join(", ")})`);
 };
-//#endregion
 export { i as FIELD_ENCRYPTION_ACTIVE_ENV, r as FIELD_ENCRYPTION_KEYS_ENV, a as FIELD_ENCRYPTION_KEY_ENV, o as FIELD_ENCRYPTION_PREVIOUS_KEY_ENV, s as FIELD_KEYRING_ENV_NAMES, d as resolveFieldKeyring };

package/dist/fingerprint.js

@@ -1,5 +1,5 @@
 import { createHash as e } from "node:crypto";
-//#region src/fingerprint.ts
+// src/fingerprint.ts
 var t = (e) => {
 	if (e == null) return null;
 	if (Array.isArray(e)) return e.map(t);
@@ -17,5 +17,4 @@ var t = (e) => {
 	});
 	return e("sha256").update(JSON.stringify(a)).digest("hex").slice(0, 16);
 };
-//#endregion
 export { t as canonicalize, n as fingerprintFor };

package/dist/finops.js

@@ -1,5 +1,5 @@
 import { Context as e, Effect as t } from "effect";
-//#region src/finops.ts
+// src/finops.ts
 var n = /* @__PURE__ */ new Set([
 	"info",
 	"warn",
@@ -38,5 +38,4 @@ var n = /* @__PURE__ */ new Set([
 }, s = (e) => typeof e == "object" && !!e && e._voltroCostBudget === !0, c = class extends e.Service()("@voltro/CostRegistry") {}, l = (e, n) => t.gen(function* () {
 	return (yield* c).budget(e.name, n);
 });
-//#endregion
 export { c as CostRegistry, o as defineCostBudget, s as isCostBudgetDefinition, l as useCostBudget };

package/dist/finopsAccountant.js

@@ -1,4 +1,4 @@
-//#region src/finopsAccountant.ts
+// src/finopsAccountant.ts
 var e = class {
 	total = 0;
 	byUnit = /* @__PURE__ */ new Map();
@@ -212,5 +212,4 @@ var e = class {
 		runTick: u
 	};
 };
-//#endregion
 export { a as CostAccountant, o as attachFinops };

package/dist/handlerBody.js

@@ -1,8 +1,7 @@
 import { Effect as e } from "effect";
-//#region src/handlerBody.ts
+// src/handlerBody.ts
 function t(t, n) {
 	if (e.isEffect(t)) return n ? n(t) : e.runPromise(t);
 	if (t instanceof Promise) return t;
 }
-//#endregion
 export { t as settleHandlerBody };

package/dist/healthProbes.js

@@ -1,4 +1,4 @@
-//#region src/healthProbes.ts
+// src/healthProbes.ts
 var e = "/internal", t = (t, n) => ({
 	path: (t?.path ?? e).replace(/\/+$/, "") || e,
 	liveness: t?.liveness ?? (() => !0),
@@ -51,5 +51,4 @@ var e = "/internal", t = (t, n) => ({
 		};
 	}
 };
-//#endregion
 export { r as answerProbe, n as probeFor, t as resolveHealth };

package/dist/hotDataStore.js

@@ -4,7 +4,7 @@ import { Effect as i, Stream as a } from "effect";
 import { and as o, eq as s, generateId as c, gt as l, isNull as u, isSqliteFamily as d, or as f, queryFor as p, startsWith as m } from "@voltro/database";
 import { createHash as h } from "node:crypto";
 import { HotError as g, applyHotOperations as _, compareHotMembers as v, hotStoreFromRunner as y, validateHotOp as b } from "@voltro/kv/hot/contract";
-//#region src/hotDataStore.ts
+// src/hotDataStore.ts
 var x = n.tableName, S = r.tableName, C = "lock", w = (e) => h("sha256").update(e).digest("hex"), T = (h, T) => {
 	let { namespace: E } = T;
 	if (!E || !E.isWellFormed() || /[{}]/.test(E)) throw new g({
@@ -144,5 +144,4 @@ var x = n.tableName, S = r.tableName, C = "lock", w = (e) => h("sha256").update(
 		persistent: !0
 	});
 };
-//#endregion
 export { T as dataStoreHotStore };

package/dist/hotDataStoreSnapshot.js

@@ -1,5 +1,5 @@
 import { Schema as e } from "effect";
-//#region src/hotDataStoreSnapshot.ts
+// src/hotDataStoreSnapshot.ts
 var t = e.Number.pipe(e.check(e.makeFilter(Number.isFinite))), n = e.Union([
 	e.Struct({
 		kind: e.Literal("fixed"),
@@ -94,5 +94,4 @@ var t = e.Number.pipe(e.check(e.makeFilter(Number.isFinite))), n = e.Union([
 		};
 	}
 };
-//#endregion
 export { o as decodeHotSnapshot, a as encodeHotSnapshot };

package/dist/hotDataStoreTables.js

@@ -1,5 +1,5 @@
 import { id as e, real as t, table as n, text as r } from "@voltro/database";
-//#region src/hotDataStoreTables.ts
+// src/hotDataStoreTables.ts
 var i = n("_voltro_hot_kv", {
 	id: e({ prefix: "hot" }),
 	keyHash: r().maxLength(64),
@@ -14,5 +14,4 @@ var i = n("_voltro_hot_kv", {
 	member: r(),
 	score: t()
 }).unique("hotMemberHash", ["keyHash", "memberHash"]).index(["keyHash", "score"]).nonReactive(), o = [i, a];
-//#endregion
 export { o as hotDataStoreTables, i as hotKvTable, a as hotZTable };

package/dist/http-range.js

@@ -1,4 +1,4 @@
-//#region src/httpRange.ts
+// src/httpRange.ts
 var e = { _tag: "ignored" }, t = { _tag: "unsatisfiable" }, n = /^([!#$%&'*+.^_`|~0-9A-Za-z-]+)=(.*)$/s, r = /^(\d*)-(\d*)$/, i = (e) => {
 	let t = e.replace(/^0+(?=\d)/, "");
 	if (t.length > 16) return;
@@ -48,5 +48,4 @@ var e = { _tag: "ignored" }, t = { _tag: "unsatisfiable" }, n = /^([!#$%&'*+.^_`
 	let a = Math.floor(t.lastModifiedMs / 1e3);
 	return a * 1e3 === i && Math.floor(n / 1e3) > a;
 };
-//#endregion
 export { u as ifRangeAllowsRange, o as parseByteRange, l as parseHttpDate };

package/dist/httpClientSsrf.js

@@ -1,7 +1,7 @@
 import { Effect as e, Layer as t } from "effect";
 import { ssrfReason as n, ssrfReason as r } from "@voltro/protocol";
 import { HttpClient as i, HttpClientError as a } from "effect/http";
-//#region src/httpClientSsrf.ts
+// src/httpClientSsrf.ts
 var o = class extends Error {
 	url;
 	reason;
@@ -20,5 +20,4 @@ var o = class extends Error {
 	}));
 	return i.followRedirects(s, r.maxRedirects ?? 5);
 }));
-//#endregion
 export { o as SsrfBlockedError, s as ssrfGuardHttpClientLayer, r as ssrfReason };

package/dist/httpClientTracing.js

@@ -2,7 +2,7 @@ import { noteCacheVolatile as e } from "./computedQueryCache.js";
 import { formatTraceparent as t } from "./traceparent.js";
 import { Effect as n, Layer as r } from "effect";
 import { HttpClient as i, HttpClientRequest as a } from "effect/http";
-//#region src/httpClientTracing.ts
+// src/httpClientTracing.ts
 var o = r.effect(i.HttpClient, n.map(i.HttpClient, (r) => r.pipe(i.mapRequestEffect((r) => n.sync(() => {
 	e("HttpClient");
 }).pipe(n.andThen(n.currentSpan), n.map((e) => r.headers.traceparent === void 0 ? a.setHeader(r, "traceparent", t({
@@ -10,5 +10,4 @@ var o = r.effect(i.HttpClient, n.map(i.HttpClient, (r) => r.pipe(i.mapRequestEff
 	spanId: e.spanId,
 	sampled: e.sampled
 })) : r), n.catch(() => n.succeed(r)))))));
-//#endregion
 export { o as tracingHttpClientLayer };

package/dist/httpCompression.js

@@ -1,5 +1,5 @@
 import { brotliCompressSync as e, constants as t, gzipSync as n } from "node:zlib";
-//#region src/httpCompression.ts
+// src/httpCompression.ts
 var r = 1024, i = [
 	"text/",
 	"application/json",
@@ -72,5 +72,4 @@ var r = 1024, i = [
 	for (let [e, r] of Object.entries(t)) e.toLowerCase() === "vary" ? i(r) : n[e] = r;
 	return r.length > 0 && (n.vary = r.join(", ")), n;
 };
-//#endregion
 export { r as DEFAULT_COMPRESSION_MIN_BYTES, a as isCompressibleContentType, l as maybeCompress, u as mergeCompressionHeaders, o as negotiateEncoding, c as negotiatedCompression };

package/dist/httpInputStream.js

@@ -1,4 +1,4 @@
-//#region src/httpInputStream.ts
+// src/httpInputStream.ts
 var e = async (e, t, n, r, i) => {
 	let a = new AbortController(), o, s = !1, c = e.readableEnded, l = e.destroyed && !c, u = !1, d = 0, f = !1, p = !1, m = () => {
 		o?.();
@@ -78,5 +78,4 @@ var e = async (e, t, n, r, i) => {
 		s = !0, b !== void 0 && a.signal.removeEventListener("abort", b), a.abort(), m(), e.off("end", g), e.off("error", h), e.off("aborted", h), e.off("close", _), i.removeEventListener("abort", h), !e.destroyed && !e.readableEnded && e.resume();
 	}
 };
-//#endregion
 export { e as dispatchHttpInputStream };

package/dist/httpKeepAlive.js

@@ -1,4 +1,4 @@
-//#region src/httpKeepAlive.ts
+// src/httpKeepAlive.ts
 var e = 72e3, t = 5e3, n = (e) => typeof e == "number" && Number.isFinite(e) && e > 0 ? Math.floor(e) : void 0, r = (e) => {
 	let r = n(e?.http?.keepAliveTimeoutMs) ?? 72e3, i = n(e?.http?.headersTimeoutMs);
 	return {
@@ -8,5 +8,4 @@ var e = 72e3, t = 5e3, n = (e) => typeof e == "number" && Number.isFinite(e) &&
 }, i = (e, t) => {
 	e.keepAliveTimeout = t.keepAliveTimeoutMs, e.headersTimeout = t.headersTimeoutMs;
 };
-//#endregion
 export { e as DEFAULT_KEEP_ALIVE_MS, t as HEADERS_TIMEOUT_MARGIN_MS, i as applyKeepAlive, r as resolveKeepAlive };

package/dist/httpRouteMounts.js

@@ -1,6 +1,6 @@
 import { FindMyWay as e } from "effect/http";
 import { routeAcceptsPath as t } from "@voltro/protocol/rest";
-//#region src/httpRouteMounts.ts
+// src/httpRouteMounts.ts
 var n = (e) => e.split("/").map((e) => e.startsWith(":") ? ":param" : e).join("/"), r = (e) => {
 	if (e.some((e) => e.method === "*")) return ["*"];
 	let t = /* @__PURE__ */ new Set();
@@ -44,5 +44,4 @@ var n = (e) => e.split("/").map((e) => e.startsWith(":") ? ":param" : e).join("/
 		return n !== void 0 && n.routes.some((n) => t(n, e)) ? n : void 0;
 	};
 }, o = (e) => a(e.filter((e) => !e.methods.includes("*") && (e.routes.length > 1 || e.routes[0]?.answersOtherMethods === !0)));
-//#endregion
 export { a as makeHttpRouteGroupFinder, o as makeUnmatchedGroupFinder, i as planHttpRouteMounts };

package/dist/idempotencyStore.js

@@ -1,6 +1,6 @@
 import { and as e, eq as t, generateId as n, lte as r } from "@voltro/database";
 import { freshFor as i } from "@voltro/protocol";
-//#region src/idempotencyStore.ts
+// src/idempotencyStore.ts
 var a = "_voltro_idempotency", o = () => /* @__PURE__ */ Error("Stored idempotency receipt is invalid"), s = (e) => {
 	if (e === null) return null;
 	try {
@@ -106,5 +106,4 @@ var a = "_voltro_idempotency", o = () => /* @__PURE__ */ Error("Stored idempoten
 	renew: async (e, t) => await o.updateMany(a, { createdAt: new Date(t) }, { where: d(e) }) === 1,
 	release: async (e) => await o.deleteMany(a, { where: d(e) }) === 1
 });
-//#endregion
 export { f as dataStoreIdempotencyStore };

package/dist/idleDetector.js

@@ -1,5 +1,5 @@
 import { nextWakeup as e } from "./wakeRegistry.js";
-//#region src/idleDetector.ts
+// src/idleDetector.ts
 var t = async (t) => {
 	if (t.signals.connectedClients() > 0 || t.signals.inFlightRequests() > 0 || t.signals.activeWorkflowExecutions() > 0) return !1;
 	let n = (t.now?.() ?? /* @__PURE__ */ new Date()).getTime() + (t.wakeLookaheadMs ?? 3e4), r = await e(t.store);
@@ -17,5 +17,4 @@ var t = async (t) => {
 		}
 	};
 };
-//#endregion
 export { t as isIdleNow, n as makeIdleGate };

package/dist/index.d.ts

@@ -1687,6 +1687,13 @@ export declare interface BindBootListenerOptions {
     readonly host?: string;
     /** The app's `health` block — the prefix and the app's own answers. */
     readonly health?: HealthConfigInput;
+    /** How long a request that arrives while booting waits for the app before
+     *  it is answered 503. Absent → `VOLTRO_BOOT_HOLD_MS` (default 30 s); `0`
+     *  answers 503 at once. */
+    readonly holdMs?: number;
+    /** How many requests may wait at once; the next one is answered 503.
+     *  Absent → `MAX_HELD`. */
+    readonly maxHeld?: number;
     /** Deterministic "now" for `elapsedMs`; tests inject. */
     readonly now?: () => number;
     readonly log?: {
@@ -1879,6 +1886,14 @@ export declare const bindSubscriptionUntyped: (descriptor: QueryDescriptor, disp
 
 export declare const BOOT_REFUSAL_NAME = "VoltroBootRefusal";
 
+/**
+ * The hold window, from `VOLTRO_BOOT_HOLD_MS` (milliseconds), clamped to
+ * `[0, 5 min]`. `0` turns the hold off — every request that arrives while
+ * booting is answered 503 at once. A non-numeric or negative value falls back
+ * to the default rather than silently disabling the hold.
+ */
+export declare const bootHoldMsFromEnv: () => number;
+
 export declare interface BootListener {
     /** The bound server — the ONE socket this process serves on. */
     readonly server: Server;
@@ -1889,8 +1904,11 @@ export declare interface BootListener {
     readonly set: (patch: Partial<Omit<BootState, 'startedAt'>>) => void;
     /** Boot complete — the phase alone, never the dependency ping. */
     readonly isReady: () => boolean;
+    /** Requests waiting for the app right now (also `held` on the startup probe). */
+    readonly held: number;
     /** Hand over the real handlers. Consulted only once the phase is `ready`
-     *  (or `draining`); until then every non-probe request answers 503. */
+     *  (or `draining`); until then every non-probe request is held, and the
+     *  held ones reach these handlers in arrival order once both are true. */
     readonly delegate: (to: BootListenerDelegate) => void;
     /** The dependency probe readiness consults once ready — a DB `SELECT 1`.
      *  Installed by the boot path when its store exists, which is after the
@@ -2412,7 +2430,7 @@ export declare interface CompressionOptions {
 }
 
 /** Why a call is not looked up at all. */
-declare type ComputedCacheBypass = 'input-not-encodable' | 'no-tenant' | 'anonymous-subject';
+declare type ComputedCacheBypass = 'input-not-encodable' | 'no-tenant' | 'anonymous-subject' | 'subject-not-encodable';
 
 /**
  * The entry one call belongs to — or why it has none.
@@ -12602,6 +12620,8 @@ export declare interface StartupSnapshot {
     readonly elapsedMs: number;
     readonly tablesTotal?: number;
     readonly error?: string;
+    /** Requests waiting for the boot to finish — present only while some do. */
+    readonly held?: number;
 }
 
 /**