@voltro/protocol 0.86.0 → 0.88.0

package/dist/publicApi.js

@@ -1,19 +1,22 @@
-import { schemaShape as e, shapeDigest as t } from "./schemaShape.js";
-import { encodeRestError as n, encodeRestSuccess as r, resolveRestFormat as i, restViewSchema as a, toSnakeCase as o } from "./restFormat.js";
-import { RestRouteError as s, defineRestRoute as c, requireAuthenticated as l, requireScope as u, response as ee, sse as d, sseFrame as f } from "./rest.js";
-import { Effect as p, Schema as m, SchemaGetter as h, SchemaIssue as g } from "effect";
-import * as _ from "effect/SchemaAST";
-//#region src/publicApi.ts
-var v = (e, t, n) => t.method ?? (t.resource !== void 0 && n !== void 0 ? S("", t, n).method : void 0) ?? (e === "query" ? "GET" : "POST"), y = (e, t, n) => C(t.path ?? (t.resource !== void 0 && n !== void 0 ? S(e, t, n).path : `/${t.version ?? "v1"}/${e.replace(/\./g, "/")}`)), b = (e) => {
+import { checkGuardsEffect as e } from "./scopes.js";
+import { declaredErrorTags as t, errorMemberSchema as n } from "./errorSchema.js";
+import { schemaShape as r, shapeDigest as i } from "./schemaShape.js";
+import { validateHttpStreamMaxDuration as a } from "./httpStreamMaxDuration.js";
+import { encodeRestError as o, resolveRestFormat as s, restViewSchema as c, toSnakeCase as l } from "./restFormat.js";
+import { RestRouteError as u, defineRestRoute as ee, requireAuthenticated as d, requireScope as f, response as p, sse as te, sseFrame as m } from "./rest.js";
+import { Effect as h, Schema as g, SchemaGetter as _, SchemaIssue as ne } from "effect";
+import * as v from "effect/SchemaAST";
+// src/publicApi.ts
+var y = (e, t, n) => t.method ?? (t.resource !== void 0 && n !== void 0 ? C("", t, n).method : void 0) ?? (e === "query" ? "GET" : "POST"), b = (e, t, n) => w(t.path ?? (t.resource !== void 0 && n !== void 0 ? C(e, t, n).path : `/${t.version ?? "v1"}/${e.replace(/\./g, "/")}`)), x = (e) => {
 	let t = e.split("/").pop() ?? e;
 	return t.endsWith("ies") ? `${t.slice(0, -3)}y` : t.endsWith("ses") || t.endsWith("xes") ? t.slice(0, -2) : t.endsWith("s") ? t.slice(0, -1) : t;
-}, x = (e, t) => {
-	let n = t != null && (typeof t == "object" || typeof t == "function") && "ast" in t ? L(t) : void 0;
+}, S = (e, t) => {
+	let n = t != null && (typeof t == "object" || typeof t == "function") && "ast" in t ? F(t) : void 0;
 	if (n === void 0) return;
-	let r = `${b(e)}Id`;
+	let r = `${x(e)}Id`;
 	return n.has(r) ? r : n.has("id") ? "id" : void 0;
-}, S = (e, t, n) => {
-	let r = (t.resource ?? "").replace(/^\/+|\/+$/g, ""), i = `/${t.version ?? "v1"}/${r}`, a = x(r, n.input), o = a === void 0 ? i : `${i}/:${a}`, s = e.split(".").pop() ?? e, c = n.target?.op;
+}, C = (e, t, n) => {
+	let r = (t.resource ?? "").replace(/^\/+|\/+$/g, ""), i = `/${t.version ?? "v1"}/${r}`, a = S(r, n.input), o = a === void 0 ? i : `${i}/:${a}`, s = e.split(".").pop() ?? e, c = n.target?.op;
 	return n.kind === "query" || n.kind === "stream" ? {
 		method: "GET",
 		path: o
@@ -30,50 +33,50 @@ var v = (e, t, n) => t.method ?? (t.resource !== void 0 && n !== void 0 ? S("",
 		method: "POST",
 		path: `${o}/${s}`
 	};
-}, C = (e) => e.replace(/\{([A-Za-z0-9_]+)\}/g, ":$1"), w = (e) => [...e.matchAll(/:([A-Za-z0-9_]+)/g)].map((e) => e[1]), T = (e) => {
-	if (_.isUnion(e)) {
-		let t = e.types.filter((e) => !_.isUndefined(e));
+}, w = (e) => e.replace(/\{([A-Za-z0-9_]+)\}/g, ":$1"), T = (e) => [...e.matchAll(/:([A-Za-z0-9_]+)/g)].map((e) => e[1]), E = (e) => {
+	if (v.isUnion(e)) {
+		let t = e.types.filter((e) => !v.isUndefined(e));
 		if (t.length === 1) return t[0];
-		if (t.length !== e.types.length) return new _.Union(t);
+		if (t.length !== e.types.length) return new v.Union(t);
 	}
 	return e;
-}, E = /^-?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i, D = (e, t) => {
-	let n = T(t);
-	if (n.encoding !== void 0) return D(e, _.toEncoded(n));
-	if (_.isUnion(n)) {
+}, D = /^-?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i, O = (e, t) => {
+	let n = E(t);
+	if (n.encoding !== void 0) return O(e, v.toEncoded(n));
+	if (v.isUnion(n)) {
 		for (let t of n.types) {
-			let n = D(e, t);
+			let n = O(e, t);
 			if (n !== e) return n;
 		}
 		return e;
 	}
-	if (_.isArrays(n)) {
+	if (v.isArrays(n)) {
 		let t = Array.isArray(e) ? e : e === void 0 ? void 0 : [e];
 		if (t === void 0) return e;
 		let r = n.rest[0] ?? n.elements[0];
-		return r === void 0 ? t : t.map((e) => D(e, r));
+		return r === void 0 ? t : t.map((e) => O(e, r));
 	}
 	if (typeof e != "string") return e;
-	if (_.isNumber(n)) return E.test(e.trim()) ? Number(e) : e;
-	if (_.isBoolean(n)) return e === "true" || e !== "false" && e;
-	if (_.isLiteral(n)) {
+	if (v.isNumber(n)) return D.test(e.trim()) ? Number(e) : e;
+	if (v.isBoolean(n)) return e === "true" || e !== "false" && e;
+	if (v.isLiteral(n)) {
 		let t = n.literal;
-		return typeof t == "number" && E.test(e.trim()) && Number(e) === t || typeof t == "boolean" && String(t) === e ? t : e;
+		return typeof t == "number" && D.test(e.trim()) && Number(e) === t || typeof t == "boolean" && String(t) === e ? t : e;
 	}
 	return e;
-}, O = (e, t) => {
+}, k = (e, t) => {
 	if (typeof e != "object" || !e || Array.isArray(e)) return e;
-	let n = T(_.toEncoded(t.ast));
-	if (!_.isObjects(n)) return e;
+	let n = E(v.toEncoded(t.ast));
+	if (!v.isObjects(n)) return e;
 	let r = { ...e };
 	for (let e of n.propertySignatures) {
 		let t = String(e.name);
-		t in r && (r[t] = D(r[t], e.type));
+		t in r && (r[t] = O(r[t], e.type));
 	}
 	return r;
-}, k = (e) => {
-	let t = T(_.toEncoded(e.ast));
-	if (!_.isObjects(t)) return (e) => e;
+}, re = (e) => {
+	let t = E(v.toEncoded(e.ast));
+	if (!v.isObjects(t)) return (e) => e;
 	let n = t.propertySignatures, r = /* @__PURE__ */ new Map(), i = n.length >= 32 && n.every((e, t) => typeof e.name != "string" || e.name in Object.prototype || r.has(e.name) ? !1 : (r.set(e.name, {
 		type: e.type,
 		order: t
@@ -91,254 +94,231 @@ var v = (e, t, n) => t.method ?? (t.resource !== void 0 && n !== void 0 ? S("",
 				});
 			}
 			e.sort((e, t) => e.order - t.order);
-			for (let { key: n, type: r } of e) t[n] = D(t[n], r);
+			for (let { key: n, type: r } of e) t[n] = O(t[n], r);
 		} else for (let e of n) {
 			let n = String(e.name);
-			n in t && (t[n] = D(t[n], e.type));
+			n in t && (t[n] = O(t[n], e.type));
 		}
 		return t;
 	};
-}, A = (e) => {
-	let t = /* @__PURE__ */ new Set();
-	if (e === void 0) return t;
-	let n = (e) => {
-		if (_.isUnion(e)) for (let t of e.types) n(t);
-		else if (e.encoding !== void 0 && n(_.toEncoded(e)), _.isObjects(e)) {
-			let n = e.propertySignatures.find((e) => e.name === "_tag");
-			n !== void 0 && _.isLiteral(n.type) && typeof n.type.literal == "string" && t.add(n.type.literal);
-		}
-	};
-	return n(e.ast), t;
-}, j = (e, t, n) => {
+}, A = (e, t, n) => {
 	if (n !== void 0) try {
-		let r = m.encodeUnknownSync(n)(e);
-		if (typeof r == "object" && r) return {
+		let r = g.encodeUnknownSync(n)(e);
+		if (typeof r == "object" && r && !Array.isArray(r)) return {
 			error: t,
 			...r
 		};
 	} catch {}
-	let r = { error: t };
-	for (let [t, n] of Object.entries(e)) t !== "stack" && t !== "_tag" && (r[t] = n);
-	return r;
-}, M = (e, t, n, r = []) => N(e, t, n, r, A), N = (e, t, n, r, i) => {
+	throw Error("Typed REST failure is incompatible with its declared schema");
+}, j = (e, n, r, i = []) => M(e, n, r, i, t), M = (e, t, n, r, i) => {
 	if (typeof e != "object" || !e) return e;
 	let a = e._tag;
 	if (typeof a != "string" || a === "ScopeError" || a === "NoSuchResource") return e;
 	if (i(t.error).has(a)) {
 		let r = n.errorStatus?.[a] ?? 422;
-		return new s(r, j(e, a, t.error));
+		return new u(r, A(e, a, t.error));
 	}
 	let o = r.find((e) => i(e.schema).has(a));
 	if (o === void 0) return e;
-	let c = n.errorStatus?.[a] ?? o.rest?.status ?? 422, l = o.rest?.headers?.(e);
-	return new s(c, j(e, a, o.schema), l);
-}, P = (e, t, r, i, a, o, c) => {
-	let l = N(e, t, r, i, c);
-	if (!(l instanceof s) || a.errors === "tagged" && a.encodeError === void 0) return l;
-	let { error: u, _tag: ee, ...d } = l.body, f = typeof d.message == "string" ? d.message : typeof d.reason == "string" ? d.reason : "", p = n(a, {
-		status: l.status,
-		tag: u,
+	let s = n.errorStatus?.[a] ?? o.rest?.status ?? 422, c = o.rest?.headers?.(e);
+	return new u(s, A(e, a, o.schema), c);
+}, N = (e, t, n, r, i, a, s) => {
+	let c = M(e, t, n, r, s);
+	if (!(c instanceof u) || i.errors === "tagged" && i.encodeError === void 0) return c;
+	let { error: l, _tag: ee, ...d } = c.body, f = typeof d.message == "string" ? d.message : typeof d.reason == "string" ? d.reason : "", p = o(i, {
+		status: c.status,
+		tag: l,
 		message: f,
 		fields: d
 	}, {
-		...o,
-		status: l.status
+		...a,
+		status: c.status
 	});
-	return new s(l.status, p.body, {
-		...l.headers ?? {},
+	return new u(c.status, p.body, {
+		...c.headers ?? {},
 		...p.headers ?? {}
 	}, p.contentType);
-}, F = (e, t) => {
-	if (e === void 0) return;
-	let n = _.isUnion(e.ast) ? e.ast.types : [e.ast];
-	for (let e of n) {
-		let n = m.make(e);
-		if (A(n).has(t)) return n;
-	}
-}, I = (e) => e.split(".").map((e, t) => t === 0 ? e : e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_"), L = (e) => {
-	let t = T(_.toEncoded(e.ast));
-	return _.isObjects(t) && t.indexSignatures.length === 0 ? new Set(t.propertySignatures.map((e) => String(e.name))) : void 0;
-}, R = (e, t) => e === t || JSON.stringify(e) === JSON.stringify(t), te = (e) => {
-	let t = T(_.toEncoded(e.ast)), n = _.isObjects(t) ? new Map(t.propertySignatures.map((e) => [String(e.name), e.type])) : /* @__PURE__ */ new Map();
+}, P = (e) => e.split(".").map((e, t) => t === 0 ? e : e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_"), F = (e) => {
+	let t = E(v.toEncoded(e.ast));
+	return v.isObjects(t) && t.indexSignatures.length === 0 ? new Set(t.propertySignatures.map((e) => String(e.name))) : void 0;
+}, I = (e, t) => e === t || JSON.stringify(e) === JSON.stringify(t), ie = (e) => {
+	let t = E(v.toEncoded(e.ast)), n = v.isObjects(t) ? new Map(t.propertySignatures.map((e) => [String(e.name), e.type])) : /* @__PURE__ */ new Map();
 	return (e) => {
 		let t = {};
 		for (let [r, i] of Object.entries(e)) {
 			let e = n.get(r);
-			t[r] = e === void 0 ? i : D(i, e);
+			t[r] = e === void 0 ? i : O(i, e);
 		}
 		return t;
 	};
-}, z = (e, t) => {
+}, L = (e, t) => {
 	if (e !== void 0) {
 		try {
-			return m.encodeUnknownSync(t)(e);
+			return g.encodeUnknownSync(t)(e);
 		} catch {}
 		try {
-			return m.decodeUnknownSync(t)(e), e;
+			return g.decodeUnknownSync(t)(e), e;
 		} catch {}
 		return e;
 	}
-}, B = (e, t, n) => ({
-	...e.request === void 0 ? {} : { request: z(e.request, t) },
-	...e.response === void 0 ? {} : { response: z(e.response, n) }
-}), ne = () => (e) => {
+}, R = (e, t, n) => ({
+	...e.request === void 0 ? {} : { request: L(e.request, t) },
+	...e.response === void 0 ? {} : { response: L(e.response, n) }
+}), ae = () => (e) => {
 	if (e.subject.type !== "anonymous") return;
 	let t = e.subject.credentialRejected;
 	return t === void 0 ? void 0 : {
 		status: 401,
 		message: t
 	};
-}, V = (e, t, n, s = {}) => {
-	let b = e.publicApi;
-	if (b === void 0) throw Error(`publicApiRoute: descriptor '${e.name}' has no publicApi annotation`);
-	let x = i(s.profile, b.format), S = s.pluginErrors ?? [], C = /* @__PURE__ */ new WeakMap(), T = (e) => {
+}, z = (n, r, i, o = {}) => {
+	let u = n.publicApi;
+	if (u === void 0) throw Error(`publicApiRoute: descriptor '${n.name}' has no publicApi annotation`);
+	let x = s(o.profile, u.format), S = o.pluginErrors ?? [], C = /* @__PURE__ */ new WeakMap(), w = (e) => {
 		if (e === void 0) return /* @__PURE__ */ new Set();
-		let t = C.get(e.ast);
-		if (t !== void 0) return t;
-		let n = A(e);
-		return C.set(e.ast, n), n;
+		let n = C.get(e.ast);
+		if (n !== void 0) return n;
+		let r = t(e);
+		return C.set(e.ast, r), r;
 	}, E = /* @__PURE__ */ new WeakMap(), D = (e, t) => {
 		if (e === void 0) return;
 		let n = E.get(e.ast);
 		if (n === void 0) {
 			let t = /* @__PURE__ */ new Map();
-			for (let n of _.isUnion(e.ast) ? e.ast.types : [e.ast]) {
-				let e = m.make(n);
-				for (let n of T(e)) t.has(n) || t.set(n, e);
+			for (let n of v.isUnion(e.ast) ? e.ast.types : [e.ast]) {
+				let e = g.make(n);
+				for (let n of w(e)) t.has(n) || t.set(n, e);
 			}
 			n = t, E.set(e.ast, n);
 		}
 		return n.get(t);
 	}, O = {
-		kind: e.kind,
-		input: e.input,
-		target: e.target
-	}, j = v(e.kind, b, O), M = (e) => x.naming === "snake_case" ? o(e) : e, N = y(e.name, b, O), F = N.replace(/:([A-Za-z0-9_]+)/g, (e, t) => `:${M(t)}`), z = w(F), V = a(e.input, x), H = k(V), U = te(V), W = L(V);
-	if (W !== void 0) {
-		for (let t of z) if (!W.has(t)) throw Error(`publicApi: descriptor '${e.name}' — path '${N}' binds ':${t}', and the input declares no field of that name` + (W.size > 0 ? ` (fields: ${[...W].join(", ")})` : " (the input declares no fields)"));
+		kind: n.kind,
+		input: n.input,
+		target: n.target
+	}, k = y(n.kind, u, O), A = (e) => x.naming === "snake_case" ? l(e) : e, j = b(n.name, u, O), M = j.replace(/:([A-Za-z0-9_]+)/g, (e, t) => `:${A(t)}`), L = T(M), z = c(n.input, x), B = re(z), V = ie(z), H = F(z);
+	if (H !== void 0) {
+		for (let e of L) if (!H.has(e)) throw Error(`publicApi: descriptor '${n.name}' — path '${j}' binds ':${e}', and the input declares no field of that name` + (H.size > 0 ? ` (fields: ${[...H].join(", ")})` : " (the input declares no fields)"));
 	}
-	let G = a(e.output, x), re = m.Struct({ value: V }), K = j !== "GET" && W === void 0;
-	if (j !== "GET" && W !== void 0) {
-		let e = z.length >= 32 ? new Set(z) : void 0;
-		for (let t of W) if (!(e?.has(t) ?? z.includes(t))) {
-			K = !0;
+	let U = c(n.output, x), oe = g.Struct({ value: z }), W = k !== "GET" && H === void 0;
+	if (k !== "GET" && H !== void 0) {
+		let e = L.length >= 32 ? new Set(L) : void 0;
+		for (let t of H) if (!(e?.has(t) ?? L.includes(t))) {
+			W = !0;
 			break;
 		}
 	}
-	let q = {
-		query: m.Unknown,
-		params: m.Unknown,
-		form: m.Boolean
-	}, ie = (K ? m.Struct({
-		...q,
-		body: m.Unknown
-	}) : m.Struct(q)).pipe(m.decodeTo(re, {
-		decode: h.transformEffect((e) => {
-			let t = "body" in e ? e.body : void 0, n = j === "GET" ? H(e.query) : e.form ? H(t ?? {}) : t ?? {}, r = typeof e.params == "object" && e.params !== null ? U(e.params) : {};
-			if (typeof n != "object" || !n || Array.isArray(n)) return p.succeed({ value: n });
+	let G = {
+		query: g.Unknown,
+		params: g.Unknown,
+		form: g.Boolean
+	}, se = (W ? g.Struct({
+		...G,
+		body: g.Unknown
+	}) : g.Struct(G)).pipe(g.decodeTo(oe, {
+		decode: _.transformEffect((e) => {
+			let t = "body" in e ? e.body : void 0, n = k === "GET" ? B(e.query) : e.form ? B(t ?? {}) : t ?? {}, r = typeof e.params == "object" && e.params !== null ? V(e.params) : {};
+			if (typeof n != "object" || !n || Array.isArray(n)) return h.succeed({ value: n });
 			let i = n, a = Object.keys(r), o = 0;
-			for (let e of a) e in i && !R(i[e], r[e]) && (a[o++] = e);
+			for (let e of a) e in i && !I(i[e], r[e]) && (a[o++] = e);
 			if (a.length = o, a.length > 0) {
-				let t = j === "GET" ? "query string" : "body";
-				return p.fail(new g.InvalidValue({ message: `${a.map((e) => `'${e}'`).join(", ")} ${a.length === 1 ? "is" : "are"} bound by the path and sent with another value in the ${t}` }, e));
+				let t = k === "GET" ? "query string" : "body";
+				return h.fail(new ne.InvalidValue({ message: `${a.map((e) => `'${e}'`).join(", ")} ${a.length === 1 ? "is" : "are"} bound by the path and sent with another value in the ${t}` }, e));
 			}
-			return p.succeed({ value: {
+			return h.succeed({ value: {
 				...i,
 				...r
 			} });
 		}),
-		encode: h.transform((e) => e)
-	})), ae = [
-		ne(),
-		...e.openAccess === void 0 ? [l()] : [],
-		...(b.scopes ?? []).map((e) => u(e))
-	], J = (() => {
-		let t = e.source;
-		return typeof t == "string" ? t : Array.isArray(t) ? t[0] : void 0;
-	})(), Y = (t, n = 200) => ({
-		tag: e.name,
-		method: t.method,
-		path: t.path,
-		query: t.query,
-		source: J,
-		status: n
-	}), X = b.stream === "sse" && e.kind === "query" && n !== void 0, oe = m.encodeUnknownEffect(G), se = X ? (e, t) => d((r) => n(e.value, t, (e) => {
-		r(f(String(e._tag ?? "message"), e));
-	})) : async (n, i) => {
-		let a;
-		try {
-			a = await t(n.value, i);
-		} catch (t) {
-			throw P(t, e, b, S, x, Y(i), T);
-		}
-		let o = await p.runPromise(oe(a)), s = r(x, o, Y(i));
-		return ee(s.body, {
-			...s.headers === void 0 ? {} : { headers: s.headers },
-			...s.contentType === void 0 ? {} : { contentType: s.contentType }
-		});
-	}, Z = e.error, Q = T(Z), ce = [...Q], $ = [];
-	for (let e of ce) {
-		let t = D(Z, e);
-		t !== void 0 && $.push({
-			status: b.errorStatus?.[e] ?? 422,
+		encode: _.transform((e) => e)
+	})), K = [
+		ae(),
+		...n.openAccess === void 0 ? [d()] : [],
+		...(u.scopes ?? []).map((e) => f(e))
+	], q = (() => {
+		let e = n.source;
+		return typeof e == "string" ? e : Array.isArray(e) ? e[0] : void 0;
+	})(), ce = (e, t = 200) => ({
+		tag: n.name,
+		method: e.method,
+		path: e.path,
+		query: e.query,
+		source: q,
+		status: t
+	});
+	K.push(async (t, r) => {
+		if (r === void 0 || typeof r.input != "object" || r.input === null) throw Error("Projected REST admission input is unavailable");
+		let i = await h.runPromise(e(t.subject, n.guards, r.input.value, {
+			defaultDeny: r.defaultDeny,
+			procedure: n.name
+		}));
+		if (i) throw i;
+	});
+	let J = u.stream === "sse" && n.kind === "query" && i !== void 0, Y = a(u.streamMaxDurationMs);
+	if (Y !== void 0 && !J) throw Error(`${n.name}: streamMaxDurationMs requires an SSE query subscription`);
+	let le = J ? (e, t) => te((n) => i(e.value, t, (e) => {
+		n(m(String(e._tag ?? "message"), e));
+	}), Y === void 0 ? {} : { maxDurationMs: Y }) : async (e, t) => {
+		let n = await r(e.value, t);
+		return p(n);
+	}, X = n.error, Z = w(X), ue = [...Z], Q = [];
+	for (let e of Object.values(u.additionalErrorStatuses ?? {})) if (e.some((e) => !Number.isInteger(e) || e < 400 || e > 599)) throw Error(`publicApi.additionalErrorStatuses for ${n.name} must contain HTTP error statuses (400–599)`);
+	let $ = (e, t, n) => {
+		for (let r of /* @__PURE__ */ new Set([t, ...u.additionalErrorStatuses?.[e] ?? []])) Q.some((t) => t.tag === e && t.status === r) || Q.push({
+			status: r,
 			tag: e,
-			schema: t
-		});
-	}
-	for (let e of S) for (let t of T(e.schema)) {
-		if (Q.has(t)) continue;
-		let n = b.errorStatus?.[t] ?? e.rest?.status;
-		if (n === void 0) continue;
-		let r = D(e.schema, t) ?? e.schema;
-		$.push({
-			status: n,
-			tag: t,
-			schema: r
+			schema: n
 		});
+	};
+	for (let e of ue) {
+		let t = D(X, e);
+		t !== void 0 && $(e, u.errorStatus?.[e] ?? 422, t);
 	}
-	let le = b.security === !1 ? "none" : b.security ?? (e.openAccess === void 0 ? "required" : "optional"), ue = {
-		tag: e.name,
-		kind: e.kind,
-		version: b.version ?? "v1",
-		security: le,
-		idempotent: b.idempotent === !0,
-		input: V,
-		pathParams: z,
-		output: G,
-		source: J,
-		errorResponses: $,
+	for (let e of S) for (let t of w(e.schema)) Z.has(t) || $(t, u.errorStatus?.[t] ?? e.rest?.status ?? 422, D(e.schema, t) ?? e.schema);
+	let de = u.security === !1 ? "none" : u.security ?? (n.openAccess === void 0 ? "required" : "optional"), fe = {
+		tag: n.name,
+		kind: n.kind,
+		version: u.version ?? "v1",
+		security: de,
+		idempotent: u.idempotent === !0,
+		input: z,
+		pathParams: L,
+		output: U,
+		source: q,
+		errorResponses: Q,
 		format: x
 	};
-	return c({
-		method: j,
-		path: F,
-		input: ie,
-		output: m.Unknown,
-		handler: se,
-		...X ? { streaming: !0 } : {},
-		guards: ae,
-		operationId: b.operationId ?? I(e.name),
-		tags: b.tags ?? [e.name.split(".")[0] ?? e.name],
-		projection: ue,
-		...x.etag && j === "GET" && !X ? { etag: !0 } : {},
-		...b.cache !== void 0 && j === "GET" && !X ? { cache: b.cache } : {},
-		...b.example === void 0 ? {} : { example: B(b.example, V, G) },
-		...b.summary === void 0 ? {} : { summary: b.summary },
-		...b.description === void 0 ? {} : { description: b.description },
-		...b.deprecated === void 0 ? {} : { deprecated: b.deprecated },
-		...b.sunset === void 0 ? {} : { sunset: b.sunset }
+	return ee({
+		publicApiDescriptor: n,
+		mapFailure: (e, t) => N(e, n, u, S, x, ce(t), w),
+		method: k,
+		path: M,
+		input: se,
+		output: U,
+		handler: le,
+		...J ? { streaming: !0 } : {},
+		guards: K,
+		operationId: u.operationId ?? P(n.name),
+		tags: u.tags ?? [n.name.split(".")[0] ?? n.name],
+		projection: fe,
+		...x.etag && k === "GET" && !J ? { etag: !0 } : {},
+		...u.cache !== void 0 && k === "GET" && !J ? { cache: u.cache } : {},
+		...u.example === void 0 ? {} : { example: R(u.example, z, U) },
+		...u.summary === void 0 ? {} : { summary: u.summary },
+		...u.description === void 0 ? {} : { description: u.description },
+		...u.deprecated === void 0 ? {} : { deprecated: u.deprecated },
+		...u.sunset === void 0 ? {} : { sunset: u.sunset }
 	});
-}, H = (e, t = {}) => e.filter((e) => e.descriptor.publicApi !== void 0).map((e) => V(e.descriptor, e.invoke, e.subscribe, t)).sort((e, t) => e.path.localeCompare(t.path)), U = (n) => t(n.filter((e) => e.projection !== void 0).map((t) => {
-	let n = t.projection, r = {
-		tag: n.tag,
-		method: t.method,
-		path: t.path,
-		pathParams: n.pathParams,
-		version: n.version,
-		security: n.security,
-		errors: [...n.errorResponses].map((e) => `${e.status}:${e.tag}`).sort()
+}, B = (e, t = {}) => e.filter((e) => e.descriptor.publicApi !== void 0).map((e) => z(e.descriptor, e.invoke, e.subscribe, t)).sort((e, t) => e.path.localeCompare(t.path)), V = (e) => i(e.filter((e) => e.projection !== void 0).map((e) => {
+	let t = e.projection, n = {
+		tag: t.tag,
+		method: e.method,
+		path: e.path,
+		pathParams: t.pathParams,
+		version: t.version,
+		security: t.security,
+		errors: [...t.errorResponses].map((e) => `${e.status}:${e.tag}`).sort()
 	};
-	return `${JSON.stringify(r)} ${e(n.input.ast)} ${e(n.output.ast)}`;
+	return `${JSON.stringify(n)} ${r(t.input.ast)} ${r(t.output.ast)}`;
 }).sort().join("\n"));
-//#endregion
-export { O as coerceQueryObject, D as coerceQueryValue, H as collectPublicApiRoutes, A as declaredErrorTags, v as derivePublicMethod, y as derivePublicPath, S as deriveResource, F as errorMemberSchema, C as normalizePathParams, I as operationIdOf, w as pathParamNames, M as projectedFailure, V as publicApiRoute, U as publicSurfaceDigest, x as resourceIdField, B as wireExample };
+export { k as coerceQueryObject, O as coerceQueryValue, B as collectPublicApiRoutes, t as declaredErrorTags, y as derivePublicMethod, b as derivePublicPath, C as deriveResource, n as errorMemberSchema, w as normalizePathParams, P as operationIdOf, T as pathParamNames, j as projectedFailure, z as publicApiRoute, V as publicSurfaceDigest, S as resourceIdField, R as wireExample };

package/dist/queryOptionalSources.js

@@ -0,0 +1,13 @@
+// src/queryOptionalSources.ts
+var e = (e, t, n) => {
+	if (n === void 0) return;
+	let r = new Set(t === void 0 ? [] : typeof t == "string" ? [t] : t), i = () => /* @__PURE__ */ Error(`${e}: optionalSource must contain unique names already declared in source`);
+	if (!Array.isArray(n)) throw i();
+	let a = [];
+	for (let e of n) {
+		if (typeof e != "string" || e.length === 0 || !r.has(e) || a.includes(e)) throw i();
+		a.push(e);
+	}
+	return Object.freeze(a);
+};
+export { e as captureOptionalQuerySources };

package/dist/reactivityChannel.js

@@ -1,4 +1,4 @@
-//#region src/reactivityChannel.ts
+// src/reactivityChannel.ts
 var e = "channel:", t = Symbol.for("@voltro/protocol/reactivityChannels"), n = globalThis, r = n[t] ?? (n[t] = /* @__PURE__ */ new Map()), i = /^[a-z][a-z0-9-]*(\.[a-z0-9-]+)*$/, a = (t) => {
 	if (!i.test(t)) throw Error(`reactivityChannel('${t}'): invalid channel name.\n  Use lowercase kebab segments separated by dots — \`presence\`, \`job-queue\`,
   \`billing.usage\`. A \`:\` is refused because it is the namespace separator in
@@ -30,5 +30,4 @@ var e = "channel:", t = Symbol.for("@voltro/protocol/reactivityChannels"), n = g
 		origin: "inline"
 	}), !0);
 };
-//#endregion
 export { e as REACTIVITY_CHANNEL_PREFIX, c as declaredReactivityChannelKeys, o as isReactivityChannel, s as isReactivityChannelKey, d as normalizeSource, p as publishReactivity, a as reactivityChannel, u as sourceKeys, f as undeclaredChannelKeys };