@voltro/protocol 0.63.0 → 0.65.0

package/dist/rest.d.ts

@@ -71,8 +71,30 @@ declare interface AnyApprovalPolicy {
     readonly reason?: string;
 }
 
-/** A guard is either a scope check or a relationship check. */
-declare type AnyGuardSpec<Input = unknown> = GuardSpec<Input> | PolicyGuardSpec<Input>;
+/** A guard is a scope check, a relationship check, or an identity check. */
+declare type AnyGuardSpec<Input = unknown> = GuardSpec<Input> | PolicyGuardSpec<Input> | AuthenticatedGuardSpec;
+
+/**
+ * "The caller must have an identity" — and nothing narrower.
+ *
+ * The third case the vocabulary was missing, and the gap was not theoretical.
+ * An app whose authority lives per-team in its executors holds NO raw scopes on
+ * the identity, so `{ scope }` refuses every real user; a relationship guard
+ * cannot help when the resource does not exist yet (the first message of a new
+ * thread); and `openAccess` would be a lie whenever the auth fallback is a
+ * deliberate anonymous subject. The one thing left to decide — is anybody
+ * there — had no spelling, so apps wrote a resource policy whose entire content
+ * was "you are logged in".
+ *
+ * `checkGuards` has always distinguished this internally: its return type is
+ * `ScopeError | Unauthenticated | null`. This makes the distinction sayable.
+ *
+ * It is a real DECISION, so it satisfies `security.defaultDeny` — unlike
+ * `openAccess`, it also enforces something.
+ */
+declare interface AuthenticatedGuardSpec {
+    readonly authenticated: true;
+}
 
 export declare const bytes: (stream: ReadableStream<Uint8Array> | (() => ReadableStream<Uint8Array>), options?: {
     readonly contentType?: string;
@@ -532,7 +554,10 @@ declare interface PluginHttpRouteResult {
     readonly status: number;
     readonly body?: string | Uint8Array;
     readonly contentType?: string;
-    readonly headers?: Record<string, string>;
+    /** Response headers. A header that repeats — two `Set-Cookie` lines, a
+     *  session and a CSRF cookie from one login — is an ARRAY; `set-cookie`
+     *  arrays become separate lines, every other array joins with `, `. */
+    readonly headers?: Record<string, string | ReadonlyArray<string>>;
     /** Stream the response (SSE) instead of sending `body`. See
      *  {@link PluginHttpRouteStream}. */
     readonly stream?: PluginHttpRouteStream;

package/dist/rest.js

@@ -1,5 +1,5 @@
-import { P as e } from "./scopes-B0kGvAnI.js";
-import { a as t, i as n, o as r, r as i, t as a } from "./serverErrorBus-BeN9pOpY.js";
+import { F as e } from "./scopes-C86BDyNJ.js";
+import { a as t, c as n, o as r, s as i, t as a } from "./serverErrorBus-QQgyq6fV.js";
 import { Effect as o, Schema as s } from "effect";
 //#region src/publicApi.ts
 var c = (e, t) => t.method ?? (e === "query" ? "GET" : "POST"), l = (e, t) => t.path ?? `/${t.version ?? "v1"}/${e.replace(/\./g, "/")}`, u = (e, t, n) => {
@@ -141,9 +141,9 @@ var c = (e, t) => t.method ?? (e === "query" ? "GET" : "POST"), l = (e, t) => t.
 				let t = await e(g);
 				if (t) return x(t.status, { error: t.message }, f);
 			}
-			let v = l.idempotency, S = v && E.has(c.method) ? s.headers[v.header.toLowerCase()] : void 0, C = v && S ? r(h.tenantId, c.method, c.path) : "";
+			let v = l.idempotency, S = v && E.has(c.method) ? s.headers[v.header.toLowerCase()] : void 0, C = v && S ? n(h.tenantId, c.method, c.path) : "";
 			if (v && S) {
-				let e = await i(v.store, C, S, v.ttlMs, Date.now());
+				let e = await t(v.store, C, S, v.ttlMs, Date.now());
 				if (e.kind === "replay") return x(e.response.status, e.response.body, {
 					...f,
 					"Idempotency-Replayed": "true"
@@ -152,7 +152,7 @@ var c = (e, t) => t.method ?? (e === "query" ? "GET" : "POST"), l = (e, t) => t.
 			}
 			try {
 				let e = await c.handler(m, g);
-				if (_(e) || y(e)) return v && S && await n(v.store, C, S), y(e) ? {
+				if (_(e) || y(e)) return v && S && await r(v.store, C, S), y(e) ? {
 					status: 200,
 					headers: f,
 					byteStream: e.byteStream,
@@ -162,26 +162,26 @@ var c = (e, t) => t.method ?? (e === "query" ? "GET" : "POST"), l = (e, t) => t.
 					headers: f,
 					stream: e.stream
 				};
-				let r = await o.runPromise(d(e));
-				if (v && S && await t(v.store, C, S, {
+				let t = await o.runPromise(d(e));
+				if (v && S && await i(v.store, C, S, {
 					status: 200,
-					body: r
+					body: t
 				}, Date.now()), c.etag === !0 && c.method === "GET") {
-					let e = `W/"${await b(JSON.stringify(r))}"`, t = s.headers["if-none-match"];
-					return t !== void 0 && t.split(",").some((t) => t.trim() === e) ? {
+					let e = `W/"${await b(JSON.stringify(t))}"`, n = s.headers["if-none-match"];
+					return n !== void 0 && n.split(",").some((t) => t.trim() === e) ? {
 						status: 304,
 						headers: {
 							...f,
 							ETag: e
 						}
-					} : x(200, r, {
+					} : x(200, t, {
 						...f,
 						ETag: e
 					});
 				}
-				return x(200, r, f);
+				return x(200, t, f);
 			} catch (e) {
-				if (v && S && await n(v.store, C, S), typeof e == "object" && e && typeof e.status == "number") {
+				if (v && S && await r(v.store, C, S), typeof e == "object" && e && typeof e.status == "number") {
 					let t = e;
 					return x(t.status, { error: t.message ?? "Error" }, f);
 				}

package/dist/{scopes-B0kGvAnI.js → scopes-C86BDyNJ.js}

@@ -33,21 +33,21 @@ var i = n.Record({
 	tenantId: n.Null,
 	scopes: a,
 	metadata: n.optional(i)
-}), ee = n.Union(o, s, c, l, u), d = n.Union(o.omit("scopes"), s.omit("scopes"), c.omit("scopes"), l, u.omit("scopes")), f = (e) => {
+}), d = n.Union(o, s, c, l, u), f = n.Union(o.omit("scopes"), s.omit("scopes"), c.omit("scopes"), l, u.omit("scopes")), p = (e) => {
 	if (e.type === "anonymous") return e;
 	let { scopes: t, ...n } = e;
 	return n;
-}, te = (e) => e.scopes ?? [], p = (e, t) => ({
+}, m = (e) => e.scopes ?? [], h = (e, t) => ({
 	type: "anonymous",
 	id: null,
 	tenantId: e,
 	...t === void 0 ? {} : { credentialRejected: t }
-}), m = (e, t = ["admin:full"]) => ({
+}), ee = (e, t = ["admin:full"]) => ({
 	type: "system",
 	id: e,
 	tenantId: null,
 	scopes: t
-}), h = (e, t) => {
+}), te = (e, t) => {
 	let n = e;
 	return {
 		type: "serviceAccount",
@@ -56,15 +56,16 @@ var i = n.Record({
 		scopes: n.scopes ?? ["admin:full"],
 		...n.metadata === void 0 ? {} : { metadata: n.metadata }
 	};
-}, g = (e) => e.type === "system", _ = "impersonation", v = (e) => e.metadata?.impersonation ?? null, y = class extends e.Tag("@voltro/Subject")() {}, b = class extends e.Tag("@voltro/ConnectionInfo")() {}, x = class extends r.Tag()("@voltro/AuthMiddleware", { provides: y }) {}, S = class extends r.Tag()("@voltro/ConnectionInfoMiddleware", { provides: b }) {}, C = (e) => typeof e.mountRoutes == "function", w = (e) => Array.isArray(e) ? {
+}, g = (e) => e.type === "system", _ = "impersonation", v = (e) => e.metadata?.impersonation ?? null, y = class extends e.Tag("@voltro/Subject")() {}, b = class extends e.Tag("@voltro/ConnectionInfo")() {}, x = class extends r.Tag()("@voltro/AuthMiddleware", { provides: y }) {}, S = class extends r.Tag()("@voltro/ConnectionInfoMiddleware", { provides: b }) {}, ne = (e) => typeof e.mountRoutes == "function", C = (e) => Array.isArray(e) ? {
 	kind: "grant",
 	scopes: e
-} : e, T = (e, t) => {
+} : e, w = (e, t) => {
+	if (t.kind === "vetoed") throw new k({ reason: `${t.code}: ${t.message}` });
 	if (e.type === "anonymous") return {
 		subject: e,
 		removed: []
 	};
-	let n = te(e);
+	let n = m(e);
 	if (t.kind === "grant") {
 		if (t.scopes.length === 0) return {
 			subject: e,
@@ -87,7 +88,7 @@ var i = n.Record({
 		},
 		removed: i
 	};
-}, ne = 3e4, re = 1e4, E = (e) => `${e.type}\u0000${e.tenantId ?? ""}\u0000${e.id ?? ""}`, ie = () => {
+}, T = 3e4, re = 1e4, E = (e) => `${e.type}\u0000${e.tenantId ?? ""}\u0000${e.id ?? ""}`, ie = () => {
 	if (typeof process > "u") return;
 	let e = process.env.VOLTRO_AUTH_SCOPE_CACHE_TTL_MS;
 	if (e === void 0 || e === "") return;
@@ -130,85 +131,113 @@ var i = n.Record({
 			};
 		}
 	};
-}, O = (e) => typeof e.resolve == "function", k = (e, t) => {
-	let n = t?.resolveScopes, r = n === void 0 || t?.scopeCache === !1 ? null : t?.scopeCache !== void 0 && O(t.scopeCache) ? t.scopeCache : D(t?.scopeCache ?? {});
-	return async (i) => {
-		let a = t?.getStore?.(), o = a === void 0 ? i : {
-			...i,
-			store: a
-		}, s;
-		for (let i of e) {
-			let e = await i.resolve(o);
+}, ae = (e) => typeof e.resolve == "function", O = (e, t) => {
+	let n = t?.resolveScopes, r = t?.subjectGuards ?? [], i = n !== void 0 || r.length > 0, a = !i || t?.scopeCache === !1 ? null : t?.scopeCache !== void 0 && ae(t.scopeCache) ? t.scopeCache : D(t?.scopeCache ?? {});
+	return async (o) => {
+		let s = t?.getStore?.(), c = s === void 0 ? o : {
+			...o,
+			store: s
+		}, l;
+		for (let o of e) {
+			let e = await o.resolve(c);
 			if (e.kind === "matched") {
-				let a = e.subject;
-				if (n !== void 0) {
-					let s = async () => w(await n(e.subject, o)), { decision: c, fresh: l } = r === null ? {
-						decision: await s(),
+				let s = e.subject;
+				if (i) {
+					let i = async () => {
+						let t = n === void 0 ? {
+							kind: "grant",
+							scopes: []
+						} : C(await n(e.subject, c));
+						if (t.kind === "unavailable" || r.length === 0) return t;
+						let i = w(e.subject, t).subject, a = {
+							origin: "request",
+							headers: c.headers,
+							clientId: c.clientId,
+							store: c.store
+						};
+						for (let e of r) {
+							let t = await e(i, a);
+							if (!t.ok) return {
+								kind: "vetoed",
+								code: t.code,
+								message: t.message
+							};
+						}
+						return t;
+					}, { decision: l, fresh: u } = a === null ? {
+						decision: await i(),
 						fresh: !0
-					} : await r.resolve(E(e.subject), s);
-					if (c.kind === "unavailable") {
-						let e = `scope resolution unavailable: ${c.reason}`;
+					} : await a.resolve(E(e.subject), i);
+					if (l.kind === "vetoed") {
+						let e = `${l.code}: ${l.message}`;
 						throw t?.onStrategyFailed?.({
-							strategyId: i.id,
+							strategyId: o.id,
 							reason: e
-						}), new A({ reason: e });
+						}), new k({ reason: e });
 					}
-					let u = T(e.subject, c);
-					l && u.removed.length > 0 && t?.onScopesNarrowed?.({
-						strategyId: i.id,
+					if (l.kind === "unavailable") {
+						let e = `scope resolution unavailable: ${l.reason}`;
+						throw t?.onStrategyFailed?.({
+							strategyId: o.id,
+							reason: e
+						}), new k({ reason: e });
+					}
+					let d = w(e.subject, l);
+					u && d.removed.length > 0 && t?.onScopesNarrowed?.({
+						strategyId: o.id,
 						subjectType: e.subject.type,
 						subjectId: e.subject.id,
-						removed: u.removed,
-						granted: c.scopes
-					}), a = u.subject;
+						removed: d.removed,
+						granted: l.scopes
+					}), s = d.subject;
 				}
-				return e.credentialExpiresAt === void 0 ? { subject: a } : {
-					subject: a,
+				return e.credentialExpiresAt === void 0 ? { subject: s } : {
+					subject: s,
 					credentialExpiresAt: e.credentialExpiresAt
 				};
 			}
 			if (e.kind === "failed") {
 				t?.onStrategyFailed?.({
-					strategyId: i.id,
+					strategyId: o.id,
 					reason: e.reason
-				}), s = e.reason;
+				}), l = e.reason;
 				break;
 			}
 		}
-		let c = (e) => s !== void 0 && e.type === "anonymous" ? {
+		let u = (e) => l !== void 0 && e.type === "anonymous" ? {
 			...e,
-			credentialRejected: s
+			credentialRejected: l
 		} : e;
-		if (t?.fallback) return { subject: c(await t.fallback(o)) };
-		let l = o.headers["x-tenant"] ?? null;
-		if (l === null && t?.anonymousTenantRequired === !0) throw new A({ reason: "tenant required (x-tenant header missing)" });
-		return { subject: c(p(l)) };
+		if (t?.fallback) return { subject: u(await t.fallback(c)) };
+		let d = c.headers["x-tenant"] ?? null;
+		if (d === null && t?.anonymousTenantRequired === !0) throw new k({ reason: "tenant required (x-tenant header missing)" });
+		return { subject: u(h(d)) };
 	};
-}, A = class extends n.TaggedError()("Unauthenticated", { reason: n.optional(n.String) }) {}, j = (e, t) => {
-	if (e.type === "anonymous") throw new A(t === void 0 ? {} : { reason: t });
-}, M = "admin:full", N = "apikeys:issue:self", P = "apikeys:issue:org", F = "apikeys:issue:other", I = class extends n.TaggedError()("ScopeError", {
+}, k = class extends n.TaggedError()("Unauthenticated", { reason: n.optional(n.String) }) {}, A = (e, t) => {
+	if (e.type === "anonymous") throw new k(t === void 0 ? {} : { reason: t });
+}, j = "admin:full", M = "apikeys:issue:self", N = "apikeys:issue:org", P = "apikeys:issue:other", F = class extends n.TaggedError()("ScopeError", {
 	required: n.String,
 	message: n.String
-}) {}, L = (e) => "scopes" in e && e.scopes ? e.scopes : [], R = /* @__PURE__ */ new WeakMap(), z = (e, t) => {
-	typeof e == "object" && e && R.set(e, t);
-}, B = (e) => {
+}) {}, I = (e) => "scopes" in e && e.scopes ? e.scopes : [], L = /* @__PURE__ */ new WeakMap(), R = (e, t) => {
+	typeof e == "object" && e && L.set(e, t);
+}, z = (e) => {
 	if (typeof e == "object" && e) {
-		let t = R.get(e);
+		let t = L.get(e);
 		if (t) return t;
 	}
-	return L(e);
-}, V = (e, t) => {
-	let n = B(e);
+	return I(e);
+}, B = (e, t) => {
+	let n = z(e);
 	return n.includes("admin:full") || n.includes(t);
-}, H = (e, t) => {
-	let n = L(e);
+}, V = (e, t) => {
+	let n = I(e);
 	return n.includes("admin:full") || n.includes(t);
-}, ae = (e, n) => V(e, n) ? t.void : t.fail(new I({
+}, H = (e, n) => B(e, n) ? t.void : t.fail(new F({
 	required: n,
 	message: `missing required scope '${n}'`
-})), U = (e) => typeof e.action == "string" && typeof e.resourceType == "string", W = (e) => typeof e.open == "string", G = (e) => ({ open: e }), K = (e) => typeof e == "string" ? [e] : e, q, J = (e) => {
-	q = e;
-}, oe = (e) => q === void 0 ? e.filter((e) => (e.guards ?? []).some((e) => !U(e) && e.resource !== void 0)).map((e) => e.tag) : [], se = (e) => [
+})), U = (e) => typeof e.action == "string" && typeof e.resourceType == "string", W = (e) => typeof e.open == "string", G = (e) => e.authenticated === !0, K = (e) => ({ open: e }), q = (e) => typeof e == "string" ? [e] : e, J, oe = (e) => {
+	J = e;
+}, se = (e) => J === void 0 ? e.filter((e) => (e.guards ?? []).some((e) => !U(e) && e.resource !== void 0)).map((e) => e.tag) : [], ce = (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`] : [],
@@ -222,43 +251,50 @@ var i = n.Record({
 	"    • 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"), ce = () => q, Y, le = (e) => {
+].join("\n"), le = () => J, Y, X = (e) => {
 	Y = e;
-}, X = () => Y, Z = (e) => new I({
+}, ue = () => 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 A({ 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 k({ 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;
 	for (let n of t) {
 		if (W(n)) continue;
+		if (G(n)) {
+			if (e.id !== null && e.id !== void 0) continue;
+			return Q(e, new F({
+				required: "authenticated",
+				message: "this procedure requires an authenticated caller"
+			}));
+		}
 		if (U(n)) {
-			if (V(e, "admin:full")) continue;
-			return Q(e, new I({
+			if (B(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 = K(n.scope);
+		let t = q(n.scope);
 		if (t.length === 0) continue;
-		let r = t.filter((t) => V(e, t));
+		let r = t.filter((t) => B(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) => !V(e, t));
-			return Q(e, new I({
+			let r = (n.mode ?? "all") === "any" ? t[0] : t.find((t) => !B(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;
-}, ue = (e, n, r) => {
-	let i = (e) => new I({
+}, de = (e, n, r) => {
+	let i = (e) => new F({
 		required: `${n.resourceType}:${n.action}`,
 		message: e
 	});
-	if (V(e, "admin:full")) return t.succeed(null);
+	if (B(e, "admin:full")) return t.succeed(null);
 	let a = Y;
 	if (a === void 0) return t.succeed(i(`no policy resolver registered — cannot authorize '${n.action}' on '${n.resourceType}'`));
 	let o = n.resource(r);
@@ -268,22 +304,29 @@ var i = n.Record({
 		resourceType: n.resourceType,
 		resourceId: o
 	})).pipe(t.catchAllCause(() => t.succeed(!1)), t.map((e) => e ? null : i(`no '${n.action}' relation on ${n.resourceType}:${o}`)));
-}, de = (e, n, r, i) => {
+}, fe = (e, n, r, i) => {
 	if (!n || n.length === 0) return t.succeed($(e, n, i));
-	let a = q;
+	let a = J;
 	return !n.some(U) && (!a || !n.some((e) => e.resource !== void 0)) ? t.succeed($(e, n, i)) : t.gen(function* () {
 		for (let i of n) {
 			if (W(i)) continue;
+			if (G(i)) {
+				if (e.id !== null && e.id !== void 0) continue;
+				return Q(e, new F({
+					required: "authenticated",
+					message: "this procedure requires an authenticated caller"
+				}));
+			}
 			if (U(i)) {
-				let t = yield* ue(e, i, r);
+				let t = yield* de(e, i, r);
 				if (t) return t;
 				continue;
 			}
-			let n = K(i.scope);
+			let n = q(i.scope);
 			if (n.length === 0) continue;
 			let o = i.resource ? i.resource(r) : void 0, s = [];
 			for (let r of n) {
-				if (V(e, r)) {
+				if (B(e, r)) {
 					s.push(!0);
 					continue;
 				}
@@ -299,7 +342,7 @@ var i = n.Record({
 			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 I({
+				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}'`)
 				});
@@ -309,4 +352,4 @@ var i = n.Record({
 	});
 };
 //#endregion
-export { ee as A, D as B, L as C, re as D, S as E, T as F, h as G, E as H, j as I, k as L, y as M, A as N, ne as O, p as P, C as R, J as S, b as T, f as U, v as V, m as W, Z as _, I as a, z as b, de as c, X as d, ce as f, U as g, W as h, N as i, d as j, _ as k, B as l, H as m, P as n, se as o, V as p, F as r, $ as s, M as t, oe as u, G as v, x as w, le as x, ae as y, g as z };
+export { _ as A, g as B, oe as C, S as D, b as E, h as F, ee as G, v as H, w as I, te as K, A as L, f as M, y as N, re as O, k as P, O as R, X as S, x as T, E as U, D as V, p as W, U as _, F as a, H as b, fe as c, ue as d, le as f, W as g, G as h, M as i, d as j, T as k, z as l, V as m, N as n, ce as o, B as p, P as r, $ as s, j as t, se as u, Z as v, I as w, R as x, K as y, ne as z };

package/dist/{serverErrorBus-BeN9pOpY.js → serverErrorBus-QQgyq6fV.js}

@@ -1,11 +1,12 @@
+import { Schema as e } from "effect";
 //#region src/idempotency.ts
-var e = (e, t, n) => `${e ?? "(global)"}|${t.toUpperCase()}|${n}`, t = (e, t, n) => `${e ?? "(global)"}|${t ?? "(anon)"}|WS|${n}`, n = async (e, t, n, r, i) => {
+var t = (e, t, n) => `${e ?? "(global)"}|${t.toUpperCase()}|${n}`, n = (e, t, n) => `${e ?? "(global)"}|${t ?? "(anon)"}|WS|${n}`, r = async (e, t, n, r, i) => {
 	let a = await e.claim(t, n, i, r);
 	return a === "claimed" ? { kind: "fresh" } : a.status === "completed" && a.response ? {
 		kind: "replay",
 		response: a.response
 	} : { kind: "conflict" };
-}, r = (e, t, n, r, i) => e.complete(t, n, r, i), i = (e, t, n) => e.release(t, n), a = () => {
+}, i = (e, t, n, r, i) => e.complete(t, n, r, i), a = (e, t, n) => e.release(t, n), o = () => {
 	let e = /* @__PURE__ */ new Map(), t = (e, t) => `${e}\u0000${t}`;
 	return {
 		get: async (n, r) => e.get(t(n, r)) ?? null,
@@ -32,12 +33,19 @@ var e = (e, t, n) => `${e ?? "(global)"}|${t.toUpperCase()}|${n}`, t = (e, t, n)
 			e.delete(t(n, r));
 		}
 	};
-}, o = /* @__PURE__ */ new Set(), s = (e) => {
-	for (let t of o) try {
+}, s = class extends e.TaggedError()("MutationInFlight", {
+	traceId: e.String,
+	retryAfterMs: e.Number
+}) {
+	get message() {
+		return `a request with this idempotency key is still in flight — replay the same key after ${this.retryAfterMs}ms`;
+	}
+}, c = 1e3, l = /* @__PURE__ */ new Set(), u = (e) => {
+	for (let t of l) try {
 		t(e);
 	} catch {}
-}, c = (e) => (o.add(e), () => {
-	o.delete(e);
+}, d = (e) => (l.add(e), () => {
+	l.delete(e);
 });
 //#endregion
-export { r as a, t as c, i, c as n, e as o, n as r, a as s, s as t };
+export { r as a, t as c, s as i, o as l, d as n, a as o, c as r, i as s, u as t, n as u };

package/dist/session.js

@@ -1,11 +1,11 @@
-import { C as e, U as t, j as n } from "./scopes-B0kGvAnI.js";
+import { M as e, W as t, w as n } from "./scopes-C86BDyNJ.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.63.0",
+  "version": "0.65.0",
   "description": "The Voltro wire + plugin contract — defineQuery/Mutation/Action/Stream, definePlugin, sessions / JWT / API-keys, and the RPC protocol.",
   "keywords": [
     "voltro",
@@ -59,8 +59,8 @@
   },
   "dependencies": {
     "@effect/sql": "^0.52.0",
-    "@voltro/database": "0.63.0",
-    "@voltro/logger": "0.63.0",
+    "@voltro/database": "0.65.0",
+    "@voltro/logger": "0.65.0",
     "jose": "^6.2.8"
   },
   "peerDependencies": {