@voltro/protocol 0.80.0 → 0.81.0

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

@@ -63,7 +63,14 @@ 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")), h = (e) => {
 	if (e.type === "anonymous") return e;
 	let { scopes: t, ...n } = e;
 	return n;
@@ -72,35 +79,41 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 	id: null,
 	tenantId: e,
 	...t === void 0 ? {} : { credentialRejected: t }
-}), v = (e, t = ["admin:full"]) => ({
+}), ne = (e, t = ["admin:full"]) => ({
 	type: "system",
 	id: e,
 	tenantId: null,
 	scopes: t
-}), y = (e) => {
+}), re = (e) => ({
+	type: "service",
+	id: `service:${e}`,
+	service: e,
+	tenantId: null,
+	scopes: []
+}), ie = (e) => e.type === "service", ae = (e) => e.type === "system" || e.type === "service", v = (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) => {
+}, y = (e, t) => {
 	let n = e;
 	return {
 		type: "serviceAccount",
 		id: e.id ?? "system",
 		tenantId: t,
-		auditActorId: y(e),
+		auditActorId: v(e),
 		scopes: g(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) ? {
+}, b = (e) => e.type === "system", oe = "impersonation", se = (e) => e.metadata?.impersonation ?? null, x = class extends e.Tag("@voltro/Subject")() {}, S = class extends e.Tag("@voltro/ConnectionInfo")() {}, C = class extends n.TaggedError()("Unauthenticated", { reason: n.optional(n.String) }) {}, ce = class extends r.Tag()("@voltro/AuthMiddleware", {
+	provides: x,
+	failure: C
+}) {}, le = class extends r.Tag()("@voltro/ConnectionInfoMiddleware", { provides: S }) {}, ue = (e) => typeof e.mountRoutes == "function", de = (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, w = (e, t) => {
+	if (t.kind === "vetoed") throw new C({ reason: `${t.code}: ${t.message}` });
 	if (e.type === "anonymous") return {
 		subject: e,
 		removed: []
@@ -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 = () => {
+}, fe = 3e4, pe = 1e4, T = (e) => `${e.type}\u0000${e.tenantId ?? ""}\u0000${e.id ?? ""}`, me = () => {
 	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 = () => {
+}, E = (e = {}) => {
+	let t = e.ttlMs ?? me() ?? 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) => {
+}, he = (e) => typeof e.resolve == "function", ge = (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) => {
+}, _e = async (e, t, n, r) => {
 	if (!i(e)) return e;
 	let s = {
 		type: e.type,
@@ -203,40 +216,44 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 		}
 		return e;
 	}
-}, k = (e, t) => {
-	let n = ue(t);
+}, D = (e, t) => {
+	let n = ge(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) => {
+}, O = (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 && he(t.scopeCache) ? t.scopeCache : E(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 D(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 _e(e.subject, l, i, (e) => (t?.onStrategyFailed?.({
 					strategyId: s.id,
 					reason: e
-				}), new w({ reason: e }))), u = c;
+				}), new C({ reason: e }))), u = c;
 				if (a) {
 					let e = async () => {
 						let e = n === void 0 ? {
 							kind: "grant",
 							scopes: []
-						} : ae(await n(c, l));
+						} : de(await n(c, l));
 						if (e.kind === "unavailable" || r.length === 0) return e;
-						let t = E(c, e).subject, i = {
+						let t = w(c, e).subject, i = {
 							origin: "request",
 							headers: l.headers,
 							clientId: l.clientId,
@@ -254,22 +271,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(T(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 C({ 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 C({ reason: e });
 					}
-					let d = E(c, i);
+					let d = w(c, i);
 					a && d.removed.length > 0 && t?.onScopesNarrowed?.({
 						strategyId: s.id,
 						subjectType: c.type,
@@ -298,52 +315,62 @@ 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 (u !== void 0) throw new C({ 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)" });
+		if (d === null && t?.anonymousTenantRequired === !0) throw new C({ reason: "tenant required (x-tenant header missing)" });
 		return { subject: _(d) };
 	};
-}, 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", {
+}, k = (e, t) => {
+	if (e.type === "anonymous") throw new C(t === void 0 ? {} : { reason: t });
+}, A = "admin:full", j = "apikeys:issue:self", M = "apikeys:issue:org", N = "apikeys:issue:other", P = "devices:manage", F = 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) => {
+}) {}, I = (e) => "scopes" in e && e.scopes ? e.scopes : [], L = /* @__PURE__ */ new WeakMap(), ve = (e, t) => {
+	typeof e == "object" && e && L.set(e, t);
+}, R = (e) => {
 	if (typeof e == "object" && e) {
-		let t = z.get(e);
+		let t = L.get(e);
 		if (t) return t;
 	}
-	return R(e);
-}, H = (e, t) => {
-	let n = V(e);
-	return n.includes("admin:full") || n.includes(t);
-}, fe = (e, t) => {
+	return I(e);
+}, z = (e, t) => {
 	let n = R(e);
 	return n.includes("admin:full") || n.includes(t);
-}, pe = (e, n) => H(e, n) ? t.void : t.fail(new L({
+}, ye = (e, t) => {
+	let n = I(e);
+	return n.includes("admin:full") || n.includes(t);
+}, be = (e, n) => z(e, n) ? t.void : t.fail(new F({
 	required: n,
 	message: `missing required scope '${n}'`
-})), U = (e, t) => {
+})), B = (e, t) => {
 	let n;
 	try {
 		n = typeof e.action == "function" ? e.action(t) : e.action;
 	} catch {
-		throw new L({
+		throw new F({
 			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 F({
 		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) => {
+}, V = (e) => (typeof e.action == "string" || typeof e.action == "function") && typeof e.resourceType == "string", H = (e) => typeof e.open == "string", U = (e) => Array.isArray(e.service), xe = (e) => ({ service: [...e] }), W = (e) => e?.find(U)?.service, G = (e, t) => {
+	let n = W(t);
+	if (e.type === "service") return n !== void 0 && n.includes(e.service) ? null : new F({
+		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 Q(e, new F({
+		required: `service:${n.join("|")}`,
+		message: `this procedure is callable only by the service${n.length === 1 ? "" : "s"} [${n.join(", ")}]`
+	}));
+}, K = (e) => e.authenticated === !0, Se = (e) => ({ open: e }), q = (e) => typeof e == "string" ? [e] : e, J, Ce = (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) => [
+}, we = (e) => J === void 0 ? e.filter((e) => (e.guards ?? []).some((e) => !V(e) && e.resource !== void 0)).map((e) => e.tag) : [], Te = (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,56 +384,58 @@ 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) => {
+].join("\n"), Ee = () => J, Y, X = (e) => {
 	Y = e;
-}, X = () => Y, Z = (e) => new L({
+}, De = () => Y, Z = (e) => new F({
 	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) => {
 	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.` });
+	return n === void 0 ? t : new C({ 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) => {
+	let r = G(e, t);
+	if (r !== void 0) return r;
 	if (!t || t.length === 0) return n?.defaultDeny === !0 ? Z(n.procedure) : null;
 	for (let n of t) {
-		if (G(n)) continue;
+		if (H(n) || U(n)) continue;
 		if (K(n)) {
 			if (e.id !== null && e.id !== void 0) continue;
-			return Q(e, new L({
+			return Q(e, new F({
 				required: "authenticated",
 				message: "this procedure requires an authenticated caller"
 			}));
 		}
-		if (W(n)) {
-			if (H(e, "admin:full")) continue;
-			return Q(e, new L({
+		if (V(n)) {
+			if (z(e, "admin:full")) continue;
+			return Q(e, new F({
 				required: `${n.resourceType}:${n.action}`,
 				message: `relationship guard '${n.action}' on '${n.resourceType}' cannot be checked synchronously`
 			}));
 		}
 		let t = q(n.scope);
 		if (t.length === 0) continue;
-		let r = t.filter((t) => H(e, t));
+		let r = t.filter((t) => z(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) => !z(e, t));
+			return Q(e, new F({
 				required: r,
 				message: (n.mode ?? "all") === "any" ? `missing all of required scopes [${t.join(", ")}]` : `missing required scope '${r}'`
 			}));
 		}
 	}
 	return null;
-}, be = (e, n, r) => {
+}, Oe = (e, n, r) => {
 	let i;
 	try {
-		i = U(n, r);
+		i = B(n, r);
 	} catch (e) {
 		return t.succeed(e);
 	}
-	let a = (e) => new L({
+	let a = (e) => new F({
 		required: `${n.resourceType}:${i}`,
 		message: e
 	});
-	if (H(e, "admin:full")) return t.succeed(null);
+	if (z(e, "admin:full")) return t.succeed(null);
 	let o = Y;
 	if (o === void 0) return t.succeed(a(`no policy resolver registered — cannot authorize '${i}' on '${n.resourceType}'`));
 	let s = n.resource(r);
@@ -416,37 +445,39 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 		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) => {
+}, ke = (e, n, r, i) => {
+	let a = G(e, n);
+	if (a !== void 0) return t.succeed(a);
 	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* () {
+	let o = J;
+	return !n.some(V) && (!o || !n.some((e) => e.resource !== void 0)) ? t.succeed($(e, n, i)) : t.gen(function* () {
 		for (let i of n) {
-			if (G(i)) continue;
+			if (H(i) || U(i)) continue;
 			if (K(i)) {
 				if (e.id !== null && e.id !== void 0) continue;
-				return Q(e, new L({
+				return Q(e, new F({
 					required: "authenticated",
 					message: "this procedure requires an authenticated caller"
 				}));
 			}
-			if (W(i)) {
-				let t = yield* be(e, i, r);
+			if (V(i)) {
+				let t = yield* Oe(e, i, r);
 				if (t) return t;
 				continue;
 			}
 			let n = q(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 = [];
 			for (let r of n) {
-				if (H(e, r)) {
+				if (z(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);
 				} else s.push(!1);
@@ -454,9 +485,9 @@ var i = (e) => e.type === "user" || e.type === "apiKey" || e.type === "serviceAc
 			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({
+				return new F({
 					required: e,
-					message: c === "any" ? `missing all of required scopes [${n.join(", ")}]` : `missing required scope '${e}'` + (o === void 0 ? "" : ` on resource '${o}'`)
+					message: c === "any" ? `missing all of required scopes [${n.join(", ")}]` : `missing required scope '${e}'` + (a === void 0 ? "" : ` on resource '${a}'`)
 				});
 			}
 		}
@@ -464,4 +495,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 { v as $, ce as A, _ as B, B as C, X as D, ve as E, oe as F, ae as G, k as H, ee as I, E as J, ie as K, te as L, le as M, pe as N, Ce as O, fe as P, re as Q, x as R, be as S, W as T, O as U, w as V, ue as W, se as X, D as Y, T as Z, H as _, P as a, o as at, Z as b, $ as c, we as d, h as et, De as f, K as g, ye as h, j as i, i as it, S as j, I as k, ke as l, z as m, M as n, y as nt, F as o, Ee as p, b as q, N as r, a as rt, Te as s, A as t, ne as tt, R as u, V as v, xe as w, Se as x, U as y, C as z };

package/dist/session.d.ts

@@ -189,6 +189,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 +317,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 +373,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;

package/dist/session.js

@@ -1,11 +1,11 @@
-import { E as e, J as t, P as n } from "./scopes-BbIyym8y.js";
+import { L as e, et as t, k as n } from "./scopes-CvU5QBQ4.js";
 import { Schema as r } from "effect";
 import { createHmac as i, timingSafeEqual as a } from "node:crypto";
 import { createLogger as o } from "@voltro/logger";
 //#region src/session.ts
 var s = o({ scope: "@voltro/protocol:session" }), c = 2, l = r.Struct({
 	v: r.Literal(2),
-	subject: n,
+	subject: e,
 	exp: r.Number,
 	iat: r.Number,
 	kid: r.optional(r.String)
@@ -38,14 +38,14 @@ var s = o({ scope: "@voltro/protocol:session" }), c = 2, l = r.Struct({
 }, C = 604800, w = .7, T = (e, t) => x(i("sha256", t).update(e).digest()), E = (e) => typeof e == "string" ? {
 	kid: "k0",
 	secret: e
-} : e, D = (n, r, i = {}) => {
+} : e, D = (e, r, i = {}) => {
 	let a = E(r);
 	if (!a.secret) throw Error("signSession: secret must be a non-empty string");
-	let o = e(n);
-	if (o.length > 0) throw Error(`signSession: refusing to mint a session cookie for a ${n.type} subject carrying ${o.length} scope(s) (${o.slice(0, 5).join(", ")}). A session cookie carries IDENTITY only — authority is resolved per request, so that removing a role takes effect on the session that already exists instead of in up to 7 days. Mint the session from the identity and move the scopes into the auth.resolveScopes resolver, which runs on every request and can be invalidated the moment a role changes.`);
+	let o = n(e);
+	if (o.length > 0) throw Error(`signSession: refusing to mint a session cookie for a ${e.type} subject carrying ${o.length} scope(s) (${o.slice(0, 5).join(", ")}). A session cookie carries IDENTITY only — authority is resolved per request, so that removing a role takes effect on the session that already exists instead of in up to 7 days. Mint the session from the identity and move the scopes into the auth.resolveScopes resolver, which runs on every request and can be invalidated the moment a role changes.`);
 	let s = i.ttlSeconds ?? C, c = Math.floor((i.now ?? Date.now)() / 1e3), l = {
 		v: 2,
-		subject: t(n),
+		subject: t(e),
 		exp: c + s,
 		iat: c,
 		...typeof r == "string" ? {} : { kid: a.kid }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/protocol",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "The Voltro wire + plugin contract — defineQuery/Mutation/Action/Stream, definePlugin, sessions / JWT / API-keys, and the RPC protocol.",
   "keywords": [
     "voltro",
@@ -65,8 +65,8 @@
   "dependencies": {
     "@effect/experimental": "^0.61.1",
     "@effect/sql": "^0.52.1",
-    "@voltro/database": "0.80.0",
-    "@voltro/logger": "0.80.0",
+    "@voltro/database": "0.81.0",
+    "@voltro/logger": "0.81.0",
     "jose": "^6.2.12"
   },
   "peerDependencies": {