@voltro/protocol 0.80.0 → 0.82.0

package/dist/{scopes-BbIyym8y.js → scopes-Di756ENh.js}

@@ -63,49 +63,62 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 	tenantId: n.Null,
 	scopes: c,
 	metadata: n.optional(s)
-}), m = n.Union(l, u, d, f, p), h = n.Union(l.omit("scopes"), u.omit("scopes"), d.omit("scopes"), f, p.omit("scopes")), ee = (e) => {
+}), m = n.Struct({
+	type: n.Literal("service"),
+	id: n.String,
+	service: n.String,
+	tenantId: n.Null,
+	scopes: c,
+	metadata: n.optional(s)
+}), ee = n.Union(l, u, d, f, p, m), te = n.Union(l.omit("scopes"), u.omit("scopes"), d.omit("scopes"), f, p.omit("scopes"), m.omit("scopes")), ne = (e) => {
 	if (e.type === "anonymous") return e;
 	let { scopes: t, ...n } = e;
 	return n;
-}, g = (e) => e.scopes ?? [], _ = (e, t) => ({
+}, h = (e) => e.scopes ?? [], g = (e, t) => ({
 	type: "anonymous",
 	id: null,
 	tenantId: e,
 	...t === void 0 ? {} : { credentialRejected: t }
-}), v = (e, t = ["admin:full"]) => ({
+}), re = (e, t = ["admin:full"]) => ({
 	type: "system",
 	id: e,
 	tenantId: null,
 	scopes: t
-}), y = (e) => {
+}), ie = (e) => ({
+	type: "service",
+	id: `service:${e}`,
+	service: e,
+	tenantId: null,
+	scopes: []
+}), ae = (e) => e.type === "service", oe = (e) => e.type === "system" || e.type === "service", _ = (e) => {
 	if (e.type === "system") return null;
 	if (e.type === "serviceAccount" && e.auditActorId !== void 0) return e.auditActorId;
 	if (e.type !== "apiKey") return e.id;
 	let t = e.metadata?.userId;
 	return typeof t == "string" && t !== "" ? t : e.id;
-}, te = (e, t) => {
+}, v = (e, t) => {
 	let n = e;
 	return {
 		type: "serviceAccount",
 		id: e.id ?? "system",
 		tenantId: t,
-		auditActorId: y(e),
-		scopes: g(e),
+		auditActorId: _(e),
+		scopes: h(e),
 		...n.metadata === void 0 ? {} : { metadata: n.metadata }
 	};
-}, ne = (e) => e.type === "system", b = "impersonation", x = (e) => e.metadata?.impersonation ?? null, S = class extends e.Tag("@voltro/Subject")() {}, C = class extends e.Tag("@voltro/ConnectionInfo")() {}, w = class extends n.TaggedError()("Unauthenticated", { reason: n.optional(n.String) }) {}, T = class extends r.Tag()("@voltro/AuthMiddleware", {
-	provides: S,
-	failure: w
-}) {}, re = class extends r.Tag()("@voltro/ConnectionInfoMiddleware", { provides: C }) {}, ie = (e) => typeof e.mountRoutes == "function", ae = (e) => Array.isArray(e) ? {
+}, se = (e) => e.type === "system", ce = "impersonation", le = (e) => e.metadata?.impersonation ?? null, y = class extends e.Tag("@voltro/Subject")() {}, b = class extends e.Tag("@voltro/ConnectionInfo")() {}, x = class extends n.TaggedError()("Unauthenticated", { reason: n.optional(n.String) }) {}, ue = class extends r.Tag()("@voltro/AuthMiddleware", {
+	provides: y,
+	failure: x
+}) {}, de = class extends r.Tag()("@voltro/ConnectionInfoMiddleware", { provides: b }) {}, fe = (e) => typeof e.mountRoutes == "function", pe = (e) => Array.isArray(e) ? {
 	kind: "grant",
 	scopes: e
-} : e, E = (e, t) => {
-	if (t.kind === "vetoed") throw new w({ reason: `${t.code}: ${t.message}` });
+} : e, S = (e, t) => {
+	if (t.kind === "vetoed") throw new x({ reason: `${t.code}: ${t.message}` });
 	if (e.type === "anonymous") return {
 		subject: e,
 		removed: []
 	};
-	let n = g(e);
+	let n = h(e);
 	if (t.kind === "grant") {
 		if (t.scopes.length === 0) return {
 			subject: e,
@@ -128,14 +141,14 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 		},
 		removed: i
 	};
-}, oe = 3e4, se = 1e4, D = (e) => `${e.type}\u0000${e.tenantId ?? ""}\u0000${e.id ?? ""}`, ce = () => {
+}, me = 3e4, he = 1e4, C = (e) => `${e.type}\u0000${e.tenantId ?? ""}\u0000${e.id ?? ""}`, ge = () => {
 	if (typeof process > "u") return;
 	let e = process.env.VOLTRO_AUTH_SCOPE_CACHE_TTL_MS;
 	if (e === void 0 || e === "") return;
 	let t = Number(e);
 	return Number.isFinite(t) && t >= 0 ? t : void 0;
-}, O = (e = {}) => {
-	let t = e.ttlMs ?? ce() ?? 3e4, n = e.maxEntries ?? 1e4, r = e.now ?? Date.now, i = /* @__PURE__ */ new Map(), a = () => {
+}, w = (e = {}) => {
+	let t = e.ttlMs ?? ge() ?? 3e4, n = e.maxEntries ?? 1e4, r = e.now ?? Date.now, i = /* @__PURE__ */ new Map(), a = () => {
 		if (i.size <= n) return;
 		let e = r();
 		for (let [t, n] of i) n.freshUntil <= e && i.delete(t);
@@ -171,10 +184,10 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 			};
 		}
 	};
-}, le = (e) => typeof e.resolve == "function", ue = (e) => {
+}, _e = (e) => typeof e.resolve == "function", ve = (e) => {
 	let t = e.authorization ?? e.Authorization;
 	if (t !== void 0) return /^Bearer\s+(.+)$/i.exec(t.trim())?.[1]?.trim();
-}, de = async (e, t, n, r) => {
+}, ye = async (e, t, n, r) => {
 	if (!i(e)) return e;
 	let s = {
 		type: e.type,
@@ -203,40 +216,52 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 		}
 		return e;
 	}
-}, k = (e, t) => {
-	let n = ue(t);
+}, T = (e, t) => {
+	let n = ve(t);
 	if (n === void 0) return e;
 	let r = e.filter((e) => e.claimsBearerPrefix !== void 0 && e.claimsBearerPrefix !== "" && n.startsWith(e.claimsBearerPrefix));
 	if (r.length === 0) return e;
 	let i = new Set(r);
 	return [...r, ...e.filter((e) => !i.has(e))];
-}, A = (e, t) => {
+}, be = (e, t) => {
+	if (e === "refuse") throw new x({ reason: "anonymous callers are refused" });
+	if (e === "no-tenant") return "";
+	if (e === "header") {
+		if (t === void 0 || t === "") throw new x({ reason: "tenant required (x-tenant header missing)" });
+		return t;
+	}
+	return "tenantId" in e ? e.tenantId : t !== void 0 && t !== "" ? t : e.headerOrTenant;
+}, E = (e, t) => {
 	let n = t?.resolveScopes, r = t?.subjectGuards ?? [];
 	if (t?.memberships === void 0 != (t?.tenantSelection === void 0)) throw Error("composeAuthStrategies: `memberships` and `tenantSelection` come together — a tenant selection is verified against the memberships and read from the store; configure both or neither.");
 	let i = t?.memberships !== void 0 && t.tenantSelection !== void 0 ? {
 		memberships: t.memberships,
 		store: t.tenantSelection
-	} : void 0, a = n !== void 0 || r.length > 0, o = !a || t?.scopeCache === !1 ? null : t?.scopeCache !== void 0 && le(t.scopeCache) ? t.scopeCache : O(t?.scopeCache ?? {});
+	} : void 0, a = n !== void 0 || r.length > 0, o = !a || t?.scopeCache === !1 ? null : t?.scopeCache !== void 0 && _e(t.scopeCache) ? t.scopeCache : w(t?.scopeCache ?? {});
 	return async (s) => {
 		let c = t?.getStore?.(), l = c === void 0 ? s : {
 			...s,
 			store: c
 		}, u;
-		for (let s of k(e, l.headers)) {
+		for (let s of T(e, l.headers)) {
 			let e = await s.resolve(l);
 			if (e.kind === "matched") {
-				let c = i === void 0 ? e.subject : await de(e.subject, l, i, (e) => (t?.onStrategyFailed?.({
+				if (e.subject.type === "service") return { subject: {
+					...e.subject,
+					scopes: []
+				} };
+				let c = i === void 0 ? e.subject : await ye(e.subject, l, i, (e) => (t?.onStrategyFailed?.({
 					strategyId: s.id,
 					reason: e
-				}), new w({ reason: e }))), u = c;
+				}), new x({ reason: e }))), u = c;
 				if (a) {
 					let e = async () => {
 						let e = n === void 0 ? {
 							kind: "grant",
 							scopes: []
-						} : ae(await n(c, l));
+						} : pe(await n(c, l));
 						if (e.kind === "unavailable" || r.length === 0) return e;
-						let t = E(c, e).subject, i = {
+						let t = S(c, e).subject, i = {
 							origin: "request",
 							headers: l.headers,
 							clientId: l.clientId,
@@ -254,22 +279,22 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 					}, { decision: i, fresh: a } = o === null ? {
 						decision: await e(),
 						fresh: !0
-					} : await o.resolve(D(c), e);
+					} : await o.resolve(C(c), e);
 					if (i.kind === "vetoed") {
 						let e = `${i.code}: ${i.message}`;
 						throw t?.onStrategyFailed?.({
 							strategyId: s.id,
 							reason: e
-						}), new w({ reason: e });
+						}), new x({ reason: e });
 					}
 					if (i.kind === "unavailable") {
 						let e = `scope resolution unavailable: ${i.reason}`;
 						throw t?.onStrategyFailed?.({
 							strategyId: s.id,
 							reason: e
-						}), new w({ reason: e });
+						}), new x({ reason: e });
 					}
-					let d = E(c, i);
+					let d = S(c, i);
 					a && d.removed.length > 0 && t?.onScopesNarrowed?.({
 						strategyId: s.id,
 						subjectType: c.type,
@@ -298,52 +323,63 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 				credentialRejected: u
 			} : e };
 		}
-		if (u !== void 0) throw new w({ reason: `credential rejected: ${u}` });
-		if (t?.anonymousTenantId !== void 0) return { subject: _(t.anonymousTenantId) };
-		let d = l.headers["x-tenant"] ?? t?.anonymousTenantDefault ?? null;
-		if (d === null && t?.anonymousTenantRequired === !0) throw new w({ reason: "tenant required (x-tenant header missing)" });
-		return { subject: _(d) };
+		if (u !== void 0) throw new x({ reason: `credential rejected: ${u}` });
+		return { subject: g(be(t?.anonymous ?? "no-tenant", l.headers["x-tenant"])) };
 	};
-}, j = (e, t) => {
-	if (e.type === "anonymous") throw new w(t === void 0 ? {} : { reason: t });
-}, M = "admin:full", N = "apikeys:issue:self", P = "apikeys:issue:org", F = "apikeys:issue:other", I = "devices:manage", L = class extends n.TaggedError()("ScopeError", {
+}, D = (e, t) => {
+	if (e.type === "anonymous") throw new x(t === void 0 ? {} : { reason: t });
+}, O = "admin:full", k = "apikeys:issue:self", A = "apikeys:issue:org", j = "apikeys:issue:other", M = "devices:manage", N = class extends n.TaggedError()("ScopeError", {
 	required: n.String,
 	message: n.String
-}) {}, R = (e) => "scopes" in e && e.scopes ? e.scopes : [], z = /* @__PURE__ */ new WeakMap(), B = (e, t) => {
-	typeof e == "object" && e && z.set(e, t);
-}, V = (e) => {
+}) {}, P = class extends n.TaggedError()("NoSuchResource", {
+	resourceType: n.NullOr(n.String),
+	resourceId: n.String,
+	message: n.String
+}) {}, F = (e) => "scopes" in e && e.scopes ? e.scopes : [], I = /* @__PURE__ */ new WeakMap(), xe = (e, t) => {
+	typeof e == "object" && e && I.set(e, t);
+}, L = (e) => {
 	if (typeof e == "object" && e) {
-		let t = z.get(e);
+		let t = I.get(e);
 		if (t) return t;
 	}
-	return R(e);
-}, H = (e, t) => {
-	let n = V(e);
+	return F(e);
+}, R = (e, t) => {
+	let n = L(e);
 	return n.includes("admin:full") || n.includes(t);
-}, fe = (e, t) => {
-	let n = R(e);
+}, Se = (e, t) => {
+	let n = F(e);
 	return n.includes("admin:full") || n.includes(t);
-}, pe = (e, n) => H(e, n) ? t.void : t.fail(new L({
+}, Ce = (e, n) => R(e, n) ? t.void : t.fail(new N({
 	required: n,
 	message: `missing required scope '${n}'`
-})), U = (e, t) => {
+})), z = (e, t) => {
 	let n;
 	try {
 		n = typeof e.action == "function" ? e.action(t) : e.action;
 	} catch {
-		throw new L({
+		throw new N({
 			required: e.resourceType,
 			message: "policy action selector failed"
 		});
 	}
-	if (typeof n != "string" || n.trim() === "") throw new L({
+	if (typeof n != "string" || n.trim() === "") throw new N({
 		required: e.resourceType,
 		message: "policy action selector returned no action"
 	});
 	return n;
-}, W = (e) => (typeof e.action == "string" || typeof e.action == "function") && typeof e.resourceType == "string", G = (e) => typeof e.open == "string", K = (e) => e.authenticated === !0, me = (e) => ({ open: e }), q = (e) => typeof e == "string" ? [e] : e, J, he = (e) => {
-	J = e;
-}, ge = (e) => J === void 0 ? e.filter((e) => (e.guards ?? []).some((e) => !W(e) && e.resource !== void 0)).map((e) => e.tag) : [], _e = (e) => [
+}, B = (e) => (typeof e.action == "string" || typeof e.action == "function") && typeof e.resourceType == "string", we = (e) => e !== void 0 && e.some((e) => B(e) || typeof e.resource == "function"), V = (e) => typeof e.open == "string", H = (e) => Array.isArray(e.service), Te = (e) => ({ service: [...e] }), U = (e) => e?.find(H)?.service, W = (e, t) => {
+	let n = U(t);
+	if (e.type === "service") return n !== void 0 && n.includes(e.service) ? null : new N({
+		required: "service-procedure",
+		message: n === void 0 ? `service '${e.service}' may only call procedures that declare it in \`service: { callers }\`` : `service '${e.service}' is not among this procedure's callers [${n.join(", ")}]`
+	});
+	if (n !== void 0) return Z(e, new N({
+		required: `service:${n.join("|")}`,
+		message: `this procedure is callable only by the service${n.length === 1 ? "" : "s"} [${n.join(", ")}]`
+	}));
+}, G = (e) => e.authenticated === !0, Ee = (e) => ({ open: e }), K = (e) => typeof e == "string" ? [e] : e, q, De = (e) => {
+	q = e;
+}, Oe = (e) => q === void 0 ? e.filter((e) => (e.guards ?? []).some((e) => !B(e) && e.resource !== void 0)).map((e) => e.tag) : [], ke = (e) => [
 	`${e.length} procedure${e.length === 1 ? "" : "s"} declare a per-resource guard that nothing enforces:`,
 	...e.slice(0, 10).map((e) => `    ${e}`),
 	...e.length > 10 ? [`    … and ${e.length - 10} more`] : [],
@@ -357,57 +393,59 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 	"    • setResourceScopeResolver((req) => Effect<boolean>) — answers \"does this",
 	"      subject hold `req.scope` on `req.resource`\" from your own tables.",
 	"    • Drop the `resource` extractor if a global scope check is what you meant."
-].join("\n"), ve = () => J, Y, ye = (e) => {
-	Y = e;
-}, X = () => Y, Z = (e) => new L({
+].join("\n"), Ae = () => q, J, je = (e) => {
+	J = e;
+}, Y = () => J, X = (e) => new N({
 	required: "access-decision",
 	message: `${e ?? "this procedure"} declares no access decision: it has neither \`guards:\` nor \`openAccess:\`, and the app runs with \`security.defaultDeny\`. Add the scope(s) a caller must hold (\`guards: [{ scope: '…' }]\`), or declare it open on purpose with \`openAccess: '<why anyone may call this>'\`.`
-}), Q = (e, t) => {
+}), Z = (e, t) => {
 	let n = e.credentialRejected;
-	return n === void 0 ? t : new w({ reason: `${n} — the request carried a credential and it was REJECTED, so this caller resolved to anonymous. The guard then refused (${t.message}); the scope is not the problem. Re-authenticate and retry.` });
-}, $ = (e, t, n) => {
-	if (!t || t.length === 0) return n?.defaultDeny === !0 ? Z(n.procedure) : null;
+	return n === void 0 ? t : new x({ reason: `${n} — the request carried a credential and it was REJECTED, so this caller resolved to anonymous. The guard then refused (${t.message}); the scope is not the problem. Re-authenticate and retry.` });
+}, Q = (e, t, n) => {
+	let r = W(e, t);
+	if (r !== void 0) return r;
+	if (!t || t.length === 0) return n?.defaultDeny === !0 ? X(n.procedure) : null;
 	for (let n of t) {
-		if (G(n)) continue;
-		if (K(n)) {
+		if (V(n) || H(n)) continue;
+		if (G(n)) {
 			if (e.id !== null && e.id !== void 0) continue;
-			return Q(e, new L({
+			return Z(e, new N({
 				required: "authenticated",
 				message: "this procedure requires an authenticated caller"
 			}));
 		}
-		if (W(n)) {
-			if (H(e, "admin:full")) continue;
-			return Q(e, new L({
+		if (B(n)) {
+			if (R(e, "admin:full")) continue;
+			return Z(e, new N({
 				required: `${n.resourceType}:${n.action}`,
 				message: `relationship guard '${n.action}' on '${n.resourceType}' cannot be checked synchronously`
 			}));
 		}
-		let t = q(n.scope);
+		let t = K(n.scope);
 		if (t.length === 0) continue;
-		let r = t.filter((t) => H(e, t));
+		let r = t.filter((t) => R(e, t));
 		if (!((n.mode ?? "all") === "any" ? r.length > 0 : r.length === t.length)) {
-			let r = (n.mode ?? "all") === "any" ? t[0] : t.find((t) => !H(e, t));
-			return Q(e, new L({
+			let r = (n.mode ?? "all") === "any" ? t[0] : t.find((t) => !R(e, t));
+			return Z(e, new N({
 				required: r,
 				message: (n.mode ?? "all") === "any" ? `missing all of required scopes [${t.join(", ")}]` : `missing required scope '${r}'`
 			}));
 		}
 	}
 	return null;
-}, be = (e, n, r) => {
+}, Me = (e, n, r) => {
 	let i;
 	try {
-		i = U(n, r);
+		i = z(n, r);
 	} catch (e) {
 		return t.succeed(e);
 	}
-	let a = (e) => new L({
+	let a = (e) => new N({
 		required: `${n.resourceType}:${i}`,
 		message: e
 	});
-	if (H(e, "admin:full")) return t.succeed(null);
-	let o = Y;
+	if (R(e, "admin:full")) return t.succeed(null);
+	let o = J;
 	if (o === void 0) return t.succeed(a(`no policy resolver registered — cannot authorize '${i}' on '${n.resourceType}'`));
 	let s = n.resource(r);
 	return s === void 0 || s === "" ? t.succeed(a(`input does not identify a '${n.resourceType}' to authorize`)) : t.suspend(() => o({
@@ -415,48 +453,61 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 		action: i,
 		resourceType: n.resourceType,
 		resourceId: s
-	})).pipe(t.catchAllCause(() => t.succeed(!1)), t.map((e) => e ? null : a(`no '${i}' relation on ${n.resourceType}:${s}`)));
-}, xe = (e, n, r, i) => {
-	if (!n || n.length === 0) return t.succeed($(e, n, i));
-	let a = J;
-	return !n.some(W) && (!a || !n.some((e) => e.resource !== void 0)) ? t.succeed($(e, n, i)) : t.gen(function* () {
+	})).pipe(t.catchAllCause(() => t.succeed(!1)), t.map((t) => $(e, t, n.resourceType, s, () => a(`no '${i}' relation on ${n.resourceType}:${s}`))));
+}, $ = (e, t, n, r, i) => t === !0 ? null : t === "missing" && e.id !== null && e.id !== void 0 ? new P({
+	resourceType: n,
+	resourceId: r,
+	message: n === null ? `no such resource '${r}'` : `no such ${n} '${r}'`
+}) : i(), Ne = (e, n, r, i) => {
+	let a = W(e, n);
+	if (a !== void 0) return t.succeed(a);
+	if (!n || n.length === 0) return t.succeed(Q(e, n, i));
+	let o = q;
+	return !n.some(B) && (!o || !n.some((e) => e.resource !== void 0)) ? t.succeed(Q(e, n, i)) : t.gen(function* () {
 		for (let i of n) {
-			if (G(i)) continue;
-			if (K(i)) {
+			if (V(i) || H(i)) continue;
+			if (G(i)) {
 				if (e.id !== null && e.id !== void 0) continue;
-				return Q(e, new L({
+				return Z(e, new N({
 					required: "authenticated",
 					message: "this procedure requires an authenticated caller"
 				}));
 			}
-			if (W(i)) {
-				let t = yield* be(e, i, r);
+			if (B(i)) {
+				let t = yield* Me(e, i, r);
 				if (t) return t;
 				continue;
 			}
-			let n = q(i.scope);
+			let n = K(i.scope);
 			if (n.length === 0) continue;
-			let o = i.resource ? i.resource(r) : void 0, s = [];
+			let a = i.resource ? i.resource(r) : void 0, s = [], c = !1;
 			for (let r of n) {
-				if (H(e, r)) {
+				if (R(e, r)) {
 					s.push(!0);
 					continue;
 				}
-				if (o !== void 0 && a !== void 0) {
-					let n = yield* t.suspend(() => a({
+				if (a !== void 0 && o !== void 0) {
+					let n = yield* t.suspend(() => o({
 						subject: e,
 						scope: r,
-						resource: o
+						resource: a
 					})).pipe(t.catchAllCause(() => t.succeed(!1)));
-					s.push(n);
+					n === "missing" && (c = !0), s.push(n === !0);
 				} else s.push(!1);
 			}
-			let c = i.mode ?? "all";
-			if (!(c === "any" ? s.some(Boolean) : s.every(Boolean))) {
-				let e = c === "any" ? n[0] : n[n.findIndex((e, t) => !s[t])];
-				return new L({
-					required: e,
-					message: c === "any" ? `missing all of required scopes [${n.join(", ")}]` : `missing required scope '${e}'` + (o === void 0 ? "" : ` on resource '${o}'`)
+			let l = i.mode ?? "all";
+			if (!(l === "any" ? s.some(Boolean) : s.every(Boolean))) {
+				let t = l === "any" ? n[0] : n[n.findIndex((e, t) => !s[t])];
+				if (c && a !== void 0) {
+					let n = $(e, "missing", null, a, () => new N({
+						required: t,
+						message: `missing required scope '${t}' on resource '${a}'`
+					}));
+					if (n !== null) return n;
+				}
+				return new N({
+					required: t,
+					message: l === "any" ? `missing all of required scopes [${n.join(", ")}]` : `missing required scope '${t}'` + (a === void 0 ? "" : ` on resource '${a}'`)
 				});
 			}
 		}
@@ -464,4 +515,4 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 	});
 };
 //#endregion
-export { o as $, se as A, A as B, B as C, T as D, R as E, S as F, x as G, ne as H, w as I, ee as J, D as K, _ as L, b as M, m as N, C as O, h as P, i as Q, E as R, U as S, he as T, O as U, ie as V, k as W, te as X, v as Y, a as Z, G as _, I as a, me as b, $ as c, ge as d, X as f, K as g, fe as h, N as i, oe as j, re as k, xe as l, H as m, P as n, L as o, ve as p, y as q, F as r, _e as s, M as t, V as u, W as v, ye as w, pe as x, Z as y, j as z };
+export { C as $, De as A, y as B, Ee as C, U as D, Te as E, he as F, E as G, g as H, me as I, ae as J, fe as K, ce as L, ue as M, b as N, xe as O, de as P, le as Q, ee as R, X as S, z as T, S as U, x as V, D as W, w as X, se as Y, T as Z, Se as _, M as a, a as at, B as b, ke as c, we as d, ie as et, L as f, R as g, Ae as h, k as i, v as it, F as j, je as k, Q as l, Y as m, A as n, ne as nt, P as o, i as ot, Oe as p, oe as q, j as r, re as rt, N as s, o as st, O as t, _ as tt, Ne as u, G as v, Ce as w, H as x, V as y, te as z };

package/dist/session.d.ts

@@ -74,6 +74,14 @@ export declare const MIN_SESSION_SECRET_LENGTH: 32;
  */
 export declare const readCookie: (header: string | undefined, name: string) => string | undefined;
 
+/**
+ * The session value this request presents — the `x-voltro-session` header a
+ * cookie-less client (React Native, a desktop shell) sets on every rpc frame,
+ * or the session cookie a browser carries. See `./sessionHeader.ts` for why
+ * it is a dedicated header and why the header wins.
+ */
+export declare const readSessionValue: (headers: Readonly<Record<string, string | undefined>>, cookieName?: string) => string | undefined;
+
 /**
  * Reset the once-per-process warning latch. Tests only — the latch is what
  * makes the diagnostic readable in production and unobservable in a second
@@ -125,6 +133,9 @@ export declare const resolveSessionSecrets: () => SessionSecrets;
  */
 export declare const SESSION_COOKIE_NAME: string;
 
+/** The request header carrying a framework session value outside a cookie. */
+export declare const SESSION_HEADER_NAME: "x-voltro-session";
+
 /**
  * The session payload format this build mints and accepts.
  *
@@ -189,6 +200,12 @@ declare const SessionPayload_2: Schema.Struct<{
         id: typeof Schema.String;
         tenantId: typeof Schema.Null;
         metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    }>, Schema.Struct<{
+        type: Schema.Literal<["service"]>;
+        id: typeof Schema.String;
+        tenantId: typeof Schema.Null;
+        metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        service: typeof Schema.String;
     }>]>;
     /** Unix seconds when this session expires. Verify rejects past expiry. */
     exp: typeof Schema.Number;
@@ -311,6 +328,14 @@ declare const Subject: Schema.Union<[Schema.Struct<{
     tenantId: typeof Schema.Null;
     scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
     metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["service"]>;
+    id: typeof Schema.String;
+    /** The calling app's name, as the callee lists it in `serviceCallers`. */
+    service: typeof Schema.String;
+    tenantId: typeof Schema.Null;
+    scopes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
 }>]>;
 
 declare type Subject = typeof Subject.Type;
@@ -359,6 +384,12 @@ declare const SubjectIdentity: Schema.Union<[Schema.Struct<{
     id: typeof Schema.String;
     tenantId: typeof Schema.Null;
     metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["service"]>;
+    id: typeof Schema.String;
+    tenantId: typeof Schema.Null;
+    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    service: typeof Schema.String;
 }>]>;
 
 declare type SubjectIdentity = typeof SubjectIdentity.Type;