@voltro/plugin-openapi 0.83.1 → 0.85.0

package/dist/index.js

@@ -1,25 +1,25 @@
-import { Effect as e, JSONSchema as t } from "effect";
-import { definePlugin as n } from "@voltro/protocol";
+import { Effect as e } from "effect";
+import { definePlugin as t, jsonSchemaDocumentOf as n } from "@voltro/protocol";
 import { pluginEnv as r } from "@voltro/env";
 import { publicSurfaceDigest as i } from "@voltro/protocol/rest";
 //#region src/rpc.ts
-var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t) => `${e} ${t}`, l = (e) => `Voltro rpc ${e}. This \`/rpc/<name>\` path is a documentation projection of the procedure's input/output schemas — live calls go through ${e === "query" || e === "stream" ? "the batched `POST /rpc` endpoint (first snapshot / element) or the WebSocket rpc channel (reactive/streaming)" : "the batched `POST /rpc` endpoint"}, NOT a REST request to this path. The request body below is the rpc payload.`, u = (e, t) => {
+var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "Never", c = (e, t) => `${e} ${t}`, l = (e) => `Voltro rpc ${e}. This \`/rpc/<name>\` path is a documentation projection of the procedure's input/output schemas — live calls go through ${e === "query" || e === "stream" ? "the batched `POST /rpc` endpoint (first snapshot / element) or the WebSocket rpc channel (reactive/streaming)" : "the batched `POST /rpc` endpoint"}, NOT a REST request to this path. The request body below is the rpc payload.`, u = (e, t) => {
 	let { kind: n, name: r } = e, i = {
 		required: !0,
-		content: { "application/json": { schema: p(e.input, t) } }
+		content: { "application/json": { schema: m(e.input, t) } }
 	}, a = (() => {
 		if (n === "stream") return {
 			description: "Stream of elements. The rpc transport pushes each element as it is produced (WebSocket) or drains to the first element over `POST /rpc`. The schema below is ONE element, not the whole response.",
-			content: { "application/x-ndjson": { schema: p(e.element, t) } }
+			content: { "application/x-ndjson": { schema: m(e.element, t) } }
 		};
-		let r = p(e.output, t);
+		let r = m(e.output, t);
 		return {
 			description: n === "query" ? "OK — the query snapshot (the first/initial snapshot over `POST /rpc`; the WebSocket channel then pushes reactive updates)." : "OK",
 			content: { "application/json": { schema: r } }
 		};
 	})(), u = s(e.error) ? {} : { 422: {
 		description: "A typed error from the procedure — one of its declared error variants (the rpc failure channel).",
-		content: { "application/json": { schema: p(e.error, t) } }
+		content: { "application/json": { schema: m(e.error, t) } }
 	} };
 	return {
 		tags: [o],
@@ -33,7 +33,7 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		responses: {
 			200: a,
 			...u,
-			500: v("Internal Server Error — an untyped defect.")
+			500: y("Internal Server Error — an untyped defect.")
 		}
 	};
 }, d = (e, t) => {
@@ -43,24 +43,29 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		n[e] = { post: u(r, t) };
 	}
 	return n;
-}, f = (e) => e.replace(/:([A-Za-z0-9_]+)/g, "{$1}"), p = (e, n) => {
-	let { $schema: r, $defs: i, ...a } = t.make(e);
-	if (i && typeof i == "object") for (let [e, t] of Object.entries(i)) n[e] = t;
-	return a;
-}, m = (e) => {
-	if (Array.isArray(e)) return e.map(m);
+}, f = (e) => e.replace(/:([A-Za-z0-9_]+)/g, "{$1}"), p = (e) => {
+	let t = e.anyOf ?? e.oneOf;
+	if (!Array.isArray(t)) return e;
+	let n = t.filter((e) => e.type !== "null");
+	return n.length === 1 && n.length < t.length ? n[0] : e;
+}, m = (e, t) => {
+	let r = n(e, { closed: !1 });
+	for (let [e, n] of Object.entries(r.definitions)) t[e] = n;
+	return r.schema;
+}, h = (e) => {
+	if (Array.isArray(e)) return e.map(h);
 	if (e && typeof e == "object") {
 		let t = {};
-		for (let [n, r] of Object.entries(e)) t[n] = n === "$ref" && typeof r == "string" && r.startsWith("#/$defs/") ? `#/components/schemas/${r.slice(8)}` : m(r);
+		for (let [n, r] of Object.entries(e)) t[n] = n === "$ref" && typeof r == "string" && r.startsWith("#/$defs/") ? `#/components/schemas/${r.slice(8)}` : h(r);
 		return t;
 	}
 	return e;
-}, h = (e, t) => {
+}, g = (e, t) => {
 	if (!e) return {
 		parameters: [],
 		requestBody: void 0
 	};
-	let n = p(e, t), r = n.properties ?? {}, i = new Set(n.required ?? []), a = [];
+	let n = m(e, t), r = n.properties ?? {}, i = new Set(n.required ?? []), a = [];
 	for (let [e, t] of [["query", "query"], ["params", "path"]]) {
 		let n = r[e];
 		if (!n || typeof n != "object") continue;
@@ -80,7 +85,7 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 			content: { "application/json": { schema: o } }
 		} : void 0
 	};
-}, g = "VoltroHttpError", _ = {
+}, _ = "VoltroHttpError", v = {
 	type: "object",
 	description: "The serve pipeline's error envelope.",
 	properties: {
@@ -98,10 +103,10 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		}
 	},
 	required: ["error"]
-}, v = (e) => ({
+}, y = (e) => ({
 	description: e,
-	content: { "application/json": { schema: { $ref: `#/components/schemas/${g}` } } }
-}), y = "ProblemDetails", b = {
+	content: { "application/json": { schema: { $ref: `#/components/schemas/${_}` } } }
+}), b = "ProblemDetails", x = {
 	type: "object",
 	description: "RFC 9457 Problem Details. Extension members carry the error's own fields.",
 	properties: {
@@ -120,22 +125,22 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		"status"
 	],
 	additionalProperties: !0
-}, x = (e, t, n = 0) => {
+}, S = (e, t, n = 0) => {
 	if (n > 6) return null;
 	let r = e.$ref;
 	if (typeof r == "string") {
 		let e = t[r.split("/").pop() ?? ""];
-		return e !== void 0 && typeof e == "object" ? x(e, t, n + 1) : null;
+		return e !== void 0 && typeof e == "object" ? S(e, t, n + 1) : null;
 	}
 	if (e.example !== void 0) return e.example;
 	if (Array.isArray(e.examples) && e.examples.length > 0) return e.examples[0];
 	if (e.const !== void 0) return e.const;
 	if (Array.isArray(e.enum) && e.enum.length > 0) return e.enum[0];
 	let i = e.anyOf ?? e.oneOf;
-	if (Array.isArray(i) && i.length > 0) return x(i.find((e) => e.type !== "null") ?? i[0], t, n + 1);
+	if (Array.isArray(i) && i.length > 0) return S(i.find((e) => e.type !== "null") ?? i[0], t, n + 1);
 	let a = e.allOf;
 	if (Array.isArray(a) && a.length > 0) {
-		let e = a.map((e) => x(e, t, n + 1));
+		let e = a.map((e) => S(e, t, n + 1));
 		return e.every((e) => typeof e == "object" && !!e && !Array.isArray(e)) ? Object.assign({}, ...e) : e[0];
 	}
 	let o = e.type;
@@ -156,19 +161,19 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		case "null": return null;
 		case "array": {
 			let r = e.items;
-			return r !== void 0 && typeof r == "object" && !Array.isArray(r) ? [x(r, t, n + 1)] : [];
+			return r !== void 0 && typeof r == "object" && !Array.isArray(r) ? [S(r, t, n + 1)] : [];
 		}
 		case "object": {
 			let r = e.properties ?? {}, i = {};
-			for (let [e, a] of Object.entries(r)) i[e] = x(a, t, n + 1);
+			for (let [e, a] of Object.entries(r)) i[e] = S(a, t, n + 1);
 			return i;
 		}
-		default: return typeof e.properties == "object" ? x({
+		default: return typeof e.properties == "object" ? S({
 			...e,
 			type: "object"
 		}, t, n) : null;
 	}
-}, S = {
+}, C = {
 	400: {
 		tag: "InvalidRequest",
 		detail: "Invalid request"
@@ -189,7 +194,7 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		tag: "InternalServerError",
 		detail: "Internal Server Error"
 	}
-}, C = {
+}, w = {
 	400: "Bad Request",
 	401: "Unauthorized",
 	403: "Forbidden",
@@ -199,10 +204,10 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 	422: "Unprocessable Content",
 	429: "Too Many Requests",
 	500: "Internal Server Error"
-}, w = (e, t, n) => {
+}, T = (e, t, n) => {
 	let r = t.format.errors === "problem-details" && t.format.encodeError === void 0, i = r ? "application/problem+json" : "application/json", a = /* @__PURE__ */ new Map();
 	for (let e of t.errorResponses) {
-		let t = a.get(e.status) ?? [], i = p(e.schema, n), o = x(i, n), { _tag: s, ...c } = typeof o == "object" && o ? o : {}, l = r ? {
+		let t = a.get(e.status) ?? [], i = m(e.schema, n), o = S(i, n), { _tag: s, ...c } = typeof o == "object" && o ? o : {}, l = r ? {
 			type: `urn:voltro:error:${e.tag}`,
 			title: e.tag.replace(/([a-z0-9])([A-Z])/g, "$1 $2"),
 			status: e.status,
@@ -214,15 +219,15 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		t.push({
 			tag: e.tag,
 			example: l,
-			schema: r ? { allOf: [{ $ref: `#/components/schemas/${y}` }, {
+			schema: r ? { allOf: [{ $ref: `#/components/schemas/${b}` }, {
 				type: "object",
 				properties: { type: { const: `urn:voltro:error:${e.tag}` } }
 			}] } : i
 		}), a.set(e.status, t);
 	}
 	let o = (e, t) => {
-		if (!r) return v(t);
-		let n = S[e], a = n === void 0 ? {} : { example: {
+		if (!r) return y(t);
+		let n = C[e], a = n === void 0 ? {} : { example: {
 			type: `urn:voltro:error:${n.tag}`,
 			title: n.tag.replace(/([a-z])([A-Z])/g, "$1 $2"),
 			status: e,
@@ -231,7 +236,7 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		return {
 			description: t,
 			content: { [i]: {
-				schema: { $ref: `#/components/schemas/${y}` },
+				schema: { $ref: `#/components/schemas/${b}` },
 				...a
 			} }
 		};
@@ -240,7 +245,7 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 	for (let [e, t] of [...a.entries()].sort((e, t) => e[0] - t[0])) {
 		let n = t.map((e) => e.tag);
 		s[String(e)] = {
-			description: `${C[e] ?? "Error"} — ${n.join(" | ")}`,
+			description: `${w[e] ?? "Error"} — ${n.join(" | ")}`,
 			content: { [i]: {
 				schema: t.length === 1 ? t[0].schema : { oneOf: t.map((e) => e.schema) },
 				example: t[0].example
@@ -248,21 +253,24 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		};
 	}
 	return e.sunset !== void 0 && (s[410] = o(410, `Gone — the route is past its sunset date (${e.sunset}).`)), s[500] = o(500, "Internal Server Error."), s;
-}, T = (e, t, n) => {
-	let r = p(t.input, n), i = r.properties ?? {}, a = new Set(r.required ?? []), o = new Set(t.pathParams), s = [], c = {}, l = [], u = e.example?.request, d = (e) => typeof u == "object" && u && e in u ? { example: u[e] } : {};
-	for (let [t, n] of Object.entries(i)) o.has(t) ? s.push({
-		name: t,
-		in: "path",
-		required: !0,
-		schema: n,
-		...d(t)
-	}) : e.method === "GET" ? s.push({
-		name: t,
-		in: "query",
-		required: a.has(t),
-		schema: n,
-		...d(t)
-	}) : (c[t] = n, a.has(t) && l.push(t));
+}, E = (e, t, n) => {
+	let r = m(t.input, n), i = r.properties ?? {}, a = new Set(r.required ?? []), o = new Set(t.pathParams), s = [], c = {}, l = [], u = e.example?.request, d = (e) => typeof u == "object" && u && e in u ? { example: u[e] } : {};
+	for (let [t, n] of Object.entries(i)) {
+		let r = a.has(t) ? n : p(n);
+		o.has(t) ? s.push({
+			name: t,
+			in: "path",
+			required: !0,
+			schema: r,
+			...d(t)
+		}) : e.method === "GET" ? s.push({
+			name: t,
+			in: "query",
+			required: a.has(t),
+			schema: r,
+			...d(t)
+		}) : (c[t] = r, a.has(t) && l.push(t));
+	}
 	return {
 		parameters: s,
 		requestBody: e.method !== "GET" && Object.keys(c).length > 0 ? {
@@ -281,12 +289,12 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 			}
 		} : void 0
 	};
-}, E = (e, t, n) => {
+}, D = (e, t, n) => {
 	if (e.streaming === !0) return {
 		description: "Server-Sent Events stream (`snapshot`, then `delta` per change)",
 		content: { "text/event-stream": { schema: { type: "string" } } }
 	};
-	let r = p(t.output, n), i = t.format, a = i.pagination === "link-header" && D(r, n, i.cursorField), o = i.encodeSuccess === void 0 ? i.envelope === "data" ? {
+	let r = m(t.output, n), i = t.format, a = i.pagination === "link-header" && O(r, n, i.cursorField), o = i.encodeSuccess === void 0 ? i.envelope === "data" ? {
 		type: "object",
 		properties: {
 			data: r,
@@ -337,28 +345,28 @@ var a = "/rpc", o = "rpc", s = (e) => e.ast._tag === "NeverKeyword", c = (e, t)
 		...Object.keys(c).length > 0 ? { headers: c } : {},
 		content: { [s]: {
 			schema: o,
-			...O(e.example?.response, o, n)
+			...k(e.example?.response, o, n)
 		} }
 	};
-}, D = (e, t, n) => {
+}, O = (e, t, n) => {
 	let r = e.$ref, i = (typeof r == "string" ? t[r.split("/").pop() ?? ""] : e)?.properties;
 	return typeof i == "object" && !!i && n in i;
-}, O = (e, t, n) => e === void 0 ? {
-	example: x(t, n),
+}, k = (e, t, n) => e === void 0 ? {
+	example: S(t, n),
 	"x-voltro-example": "derived"
-} : { example: e }, k = (e) => ({
-	...e.input === void 0 ? {} : { 400: v("Invalid request — the input failed schema decode.") },
+} : { example: e }, A = (e) => ({
+	...e.input === void 0 ? {} : { 400: y("Invalid request — the input failed schema decode.") },
 	...e.guards !== void 0 && e.guards.length > 0 ? {
-		401: v("Unauthorized — a guard rejected the unauthenticated request."),
-		403: v("Forbidden — a guard rejected the request (e.g. a required scope is missing).")
+		401: y("Unauthorized — a guard rejected the unauthenticated request."),
+		403: y("Forbidden — a guard rejected the request (e.g. a required scope is missing).")
 	} : {},
-	...e.sunset === void 0 ? {} : { 410: v(`Gone — the route is past its sunset date (${e.sunset}).`) },
-	500: v("Internal Server Error.")
+	...e.sunset === void 0 ? {} : { 410: y(`Gone — the route is past its sunset date (${e.sunset}).`) },
+	500: y("Internal Server Error.")
 });
-function A(e, t = {}, n = {}, r = {}) {
+function j(e, t = {}, n = {}, r = {}) {
 	let a = {}, o = {}, s = e.some((e) => e.guards !== void 0 && e.guards.length > 0), c = e.some((e) => e.projection !== void 0 && e.projection.security !== "none"), l = e.some((e) => e.projection?.format.errors === "problem-details" && e.projection.format.encodeError === void 0), u = /* @__PURE__ */ new Set();
 	for (let t of e) {
-		let e = t.projection, { parameters: n, requestBody: r } = e === void 0 ? h(t.input, o) : T(t, e, o), i = t.etag === !0 && t.method === "GET" && t.streaming !== !0, s = i ? [...n, {
+		let e = t.projection, { parameters: n, requestBody: r } = e === void 0 ? g(t.input, o) : E(t, e, o), i = t.etag === !0 && t.method === "GET" && t.streaming !== !0, s = i ? [...n, {
 			name: "If-None-Match",
 			in: "header",
 			required: !1,
@@ -375,19 +383,19 @@ function A(e, t = {}, n = {}, r = {}) {
 			let e = r.content;
 			e["application/json"] = {
 				...e["application/json"],
-				...O(t.example?.request, e["application/json"].schema, o)
+				...k(t.example?.request, e["application/json"].schema, o)
 			};
 		}
-		let d = e === void 0 ? l ? { security: [{ bearerAuth: [] }] } : {} : e.security === "required" ? { security: [{ bearerAuth: [] }] } : e.security === "optional" ? { security: [{ bearerAuth: [] }, {}] } : {}, m = t.tags ?? (t.version === void 0 ? void 0 : [t.version]);
-		for (let e of m ?? []) u.add(e);
-		let g = e?.version ?? t.version, _ = {
+		let d = e === void 0 ? l ? { security: [{ bearerAuth: [] }] } : {} : e.security === "required" ? { security: [{ bearerAuth: [] }] } : e.security === "optional" ? { security: [{ bearerAuth: [] }, {}] } : {}, p = t.tags ?? (t.version === void 0 ? void 0 : [t.version]);
+		for (let e of p ?? []) u.add(e);
+		let h = e?.version ?? t.version, _ = {
 			...t.operationId === void 0 ? {} : { operationId: t.operationId },
 			...t.summary ? { summary: t.summary } : {},
 			...t.description ? { description: t.description } : {},
 			...t.deprecated === void 0 ? {} : { deprecated: !0 },
 			...t.sunset === void 0 ? {} : { "x-sunset": t.sunset },
-			...m === void 0 ? {} : { tags: m },
-			...g === void 0 ? {} : { "x-voltro-api-version": g },
+			...p === void 0 ? {} : { tags: p },
+			...h === void 0 ? {} : { "x-voltro-api-version": h },
 			...s.length > 0 ? { parameters: s } : {},
 			...r ? { requestBody: r } : {},
 			...d,
@@ -398,16 +406,16 @@ function A(e, t = {}, n = {}, r = {}) {
 				} : {
 					description: "OK",
 					content: { "application/json": {
-						schema: p(t.output, o),
-						...O(t.example?.response, p(t.output, o), o)
+						schema: m(t.output, o),
+						...k(t.example?.response, m(t.output, o), o)
 					} }
 				},
-				...k(t),
+				...A(t),
 				...c
 			} : {
-				200: E(t, e, o),
+				200: D(t, e, o),
 				...c,
-				...w(t, e, o)
+				...T(t, e, o)
 			}
 		};
 		e?.format.describe !== void 0 && (_ = e.format.describe(_, {
@@ -418,15 +426,15 @@ function A(e, t = {}, n = {}, r = {}) {
 		let v = f(t.path), y = a[v] ?? {};
 		y[t.method.toLowerCase()] = _, a[v] = y;
 	}
-	let v = n.procedures ?? [];
-	if (v.length > 0) {
-		let e = d(v, o);
+	let p = n.procedures ?? [];
+	if (p.length > 0) {
+		let e = d(p, o);
 		for (let [t, n] of Object.entries(e)) a[t] = {
 			...n,
 			...a[t] ?? {}
 		};
 	}
-	let x = [...u].sort().map((e) => ({
+	let y = [...u].sort().map((e) => ({
 		name: e,
 		...r.tagDescriptions?.[e] === void 0 ? {} : { description: r.tagDescriptions[e] },
 		...r.tagExternalDocs?.[e] === void 0 ? {} : { externalDocs: r.tagExternalDocs[e] }
@@ -450,13 +458,13 @@ function A(e, t = {}, n = {}, r = {}) {
 		...r.externalDocs === void 0 ? {} : { externalDocs: r.externalDocs },
 		...r.environment === void 0 ? {} : { "x-voltro-environment": r.environment },
 		...e.some((e) => e.projection !== void 0) ? { "x-voltro-surface-digest": i(e) } : {},
-		...x.length > 0 ? { tags: x } : {},
-		paths: m(a),
+		...y.length > 0 ? { tags: y } : {},
+		paths: h(a),
 		components: {
 			schemas: {
-				...m(o),
-				[g]: _,
-				...l ? { [y]: b } : {}
+				...h(o),
+				[_]: v,
+				...l ? { [b]: x } : {}
 			},
 			...s || c ? { securitySchemes: { bearerAuth: {
 				type: "http",
@@ -467,23 +475,23 @@ function A(e, t = {}, n = {}, r = {}) {
 }
 //#endregion
 //#region src/swaggerUi.ts
-var j = "5.17.14", M = "sha384-wxLW6kwyHktdDGr6Pv1zgm/VGJh99lfUbzSn6HNHBENZlCN7W602k9VkGdxuFvPn", N = "sha384-wmyclcVGX/WhUkdkATwhaK1X1JtiNrr2EoYJ+diV3vj4v6OC5yCeSu+yW13SYJep", P = `https://unpkg.com/swagger-ui-dist@${j}/swagger-ui.css`, F = `https://unpkg.com/swagger-ui-dist@${j}/swagger-ui-bundle.js`, I = (e, t = "API docs", n = {}) => `<!doctype html>
+var M = "5.17.14", N = "sha384-wxLW6kwyHktdDGr6Pv1zgm/VGJh99lfUbzSn6HNHBENZlCN7W602k9VkGdxuFvPn", P = "sha384-wmyclcVGX/WhUkdkATwhaK1X1JtiNrr2EoYJ+diV3vj4v6OC5yCeSu+yW13SYJep", F = `https://unpkg.com/swagger-ui-dist@${M}/swagger-ui.css`, I = `https://unpkg.com/swagger-ui-dist@${M}/swagger-ui-bundle.js`, L = (e, t = "API docs", n = {}) => `<!doctype html>
 <html lang="en">
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>${t}</title>
-  <link rel="stylesheet" href="${P}" integrity="${M}" crossorigin="anonymous" />
+  <link rel="stylesheet" href="${F}" integrity="${N}" crossorigin="anonymous" />
   <style>body { margin: 0 }</style>
 </head>
 <body>
   <div id="swagger-ui"></div>
-  <script src="${F}" integrity="${N}" crossorigin="anonymous"><\/script>
+  <script src="${I}" integrity="${P}" crossorigin="anonymous"><\/script>
   <script>
     window.ui = SwaggerUIBundle({ ${n.urls !== void 0 && n.urls.length > 0 ? `urls: ${JSON.stringify(n.urls)}, ${n.primaryName === void 0 ? "" : `'urls.primaryName': ${JSON.stringify(n.primaryName)}, `}` : `url: ${JSON.stringify(e)}, `}dom_id: '#swagger-ui', deepLinking: true });
   <\/script>
 </body>
-</html>`, L = r([
+</html>`, R = r([
 	{
 		name: "OPENAPI_DOCS_TOKEN",
 		required: !1,
@@ -502,107 +510,117 @@ var j = "5.17.14", M = "sha384-wxLW6kwyHktdDGr6Pv1zgm/VGJh99lfUbzSn6HNHBENZlCN7W
 		secret: !1,
 		description: "The environment this instance serves (dev | staging | production) — x-voltro-environment on the spec."
 	}
-]), R = (e, t) => {
+]), z = (e, t) => {
 	if (e) return (t.headers.authorization ?? t.headers.Authorization) === `Bearer ${e}` ? void 0 : {
 		status: 401,
 		body: "unauthorized",
 		contentType: "text/plain"
 	};
-}, z = (e) => e.projection?.version ?? e.version, B = (e) => {
+}, B = (e) => e.projection?.version ?? e.version, V = (e) => {
 	let t = /^v(\d+)$/.exec(e);
 	return t === null ? -1 : Number(t[1]);
-}, V = (e) => [...new Set(e.map(z).filter((e) => e !== void 0))].sort((e, t) => B(t) - B(e) || t.localeCompare(e)), H = (e, t) => {
-	let n = t.filter((t) => z(t) === e && t.sunset !== void 0).map((e) => e.sunset).sort();
-	return n.length > 0 ? `${e} — sunset ${n[0]}` : e;
-}, U = (t) => {
-	let r = t.specPath ?? "/openapi.json", i = t.docsPath ?? "/docs", a = L.read("OPENAPI_DOCS_TOKEN", t.token), o = t.name ? `@voltro/plugin-openapi#${t.name}` : "@voltro/plugin-openapi", s = t.routes ?? [], c = t.procedures ?? [], l = c, u = t.includeAppRoutes ?? !0, d = t.includeAppProcedures ?? !1, f = s, p = t.environment ?? L.read("VOLTRO_ENVIRONMENT", void 0) ?? (process.env.NODE_ENV === "production" ? "production" : "dev"), m = L.read("VOLTRO_PUBLIC_API_ORIGIN", void 0), h = t.servers ?? (m === void 0 ? [] : [{
+}, H = (e) => [...new Set(e.map(B).filter((e) => e !== void 0))].sort((e, t) => V(t) - V(e) || t.localeCompare(e)), U = (e, t) => {
+	let n;
+	for (let r of t) {
+		if (B(r) !== e) continue;
+		let t = r.sunset;
+		t !== void 0 && (n === void 0 || t < n) && (n = t);
+	}
+	return n === void 0 ? e : `${e} — sunset ${n}`;
+}, W = (n) => {
+	let r = n.specPath ?? "/openapi.json", i = n.docsPath ?? "/docs", a = R.read("OPENAPI_DOCS_TOKEN", n.token), o = n.name ? `@voltro/plugin-openapi#${n.name}` : "@voltro/plugin-openapi", s = n.routes ?? [], c = n.procedures ?? [], l = c, u = n.includeAppRoutes ?? !0, d = n.includeAppProcedures ?? !1, f = s, p = n.environment ?? R.read("VOLTRO_ENVIRONMENT", void 0) ?? (process.env.NODE_ENV === "production" ? "production" : "dev"), m = R.read("VOLTRO_PUBLIC_API_ORIGIN", void 0), h = n.servers ?? (m === void 0 ? [] : [{
 		url: m,
 		description: `${p} — this instance`,
 		environment: p
 	}]), g = {
-		...t.tagDescriptions === void 0 ? {} : { tagDescriptions: t.tagDescriptions },
-		...t.tagExternalDocs === void 0 ? {} : { tagExternalDocs: t.tagExternalDocs },
-		...t.externalDocs === void 0 ? {} : { externalDocs: t.externalDocs },
+		...n.tagDescriptions === void 0 ? {} : { tagDescriptions: n.tagDescriptions },
+		...n.tagExternalDocs === void 0 ? {} : { tagExternalDocs: n.tagExternalDocs },
+		...n.externalDocs === void 0 ? {} : { externalDocs: n.externalDocs },
 		...h.length > 0 ? { servers: h } : {},
 		environment: p
-	}, _ = (e) => JSON.stringify(A(e === void 0 ? f : f.filter((t) => z(t) === e), t.info ?? {}, e === void 0 ? { procedures: l } : {}, g), null, 2), v = /* @__PURE__ */ new Map(), y = () => {
-		v = new Map([["", _()], ...V(f).map((e) => [e, _(e)])]);
+	}, _ = (e, t, r) => JSON.stringify(j(e, n.info ?? {}, t ? { procedures: r } : {}, g), null, 2), v = r.endsWith(".json") ? r.slice(0, -5) : `${r}/versions`, y = (e) => `${v}/${e}.json`, b = /* @__PURE__ */ new Map(), x = [], S = "", C = (e = f, t = l) => {
+		let a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
+		for (let t of e) {
+			let e = B(t);
+			if (e === void 0) continue;
+			let n = a.get(e);
+			n === void 0 && (n = [], a.set(e, n)), n.push(t);
+			let r = t.sunset, i = o.get(e);
+			r !== void 0 && (i === void 0 || r < i) && o.set(e, r);
+		}
+		let s = [...a.keys()].sort((e, t) => V(t) - V(e) || t.localeCompare(e)), c = new Map([["", _(e, !0, t)], ...s.map((e) => [e, _(a.get(e), !1, t)])]), u = s.length > 1 ? [...s.map((e) => ({
+			url: y(e),
+			name: o.has(e) ? `${e} — sunset ${o.get(e)}` : e
+		})), {
+			url: r,
+			name: "all versions"
+		}] : void 0, d = i === !1 ? "" : L(r, n.info?.title ?? "API docs", u === void 0 ? {} : {
+			urls: u,
+			primaryName: u[0].name
+		});
+		b = c, x = s, S = d, f = e, l = t;
 	};
-	y();
-	let b = (e) => {
+	C();
+	let w = (e) => {
 		if (!u) return;
 		let t = new Set(s.map((e) => `${e.method} ${e.path}`)), n = e.filter((e) => !t.has(`${e.method} ${e.path}`));
-		f = [...s, ...n], y();
-	}, x = (e) => {
+		C([...s, ...n]);
+	}, T = (e) => {
 		if (!d) return;
 		let t = new Set(c.map((e) => e.name));
-		l = [...c, ...e.filter((e) => !t.has(e.name))], y();
-	}, S = r.endsWith(".json") ? r.slice(0, -5) : `${r}/versions`, C = (e) => `${S}/${e}.json`, w = (e) => ({
+		C(f, [...c, ...e.filter((e) => !t.has(e.name))]);
+	}, E = (e) => ({
 		status: 404,
 		contentType: "application/json",
 		body: JSON.stringify({
 			error: `no API version '${e}' is mounted`,
-			versions: V(f)
+			versions: x
 		})
-	}), T = [{
+	}), D = [{
 		method: "GET",
 		path: r,
 		match: "exact",
 		handle: async (e) => {
-			let t = R(a, e);
+			let t = z(a, e);
 			if (t) return t;
 			let n = new URLSearchParams(e.query).get("version") ?? void 0;
-			return n !== void 0 && !v.has(n) ? w(n) : {
+			return n !== void 0 && !b.has(n) ? E(n) : {
 				status: 200,
-				body: v.get(n ?? ""),
+				body: b.get(n ?? ""),
 				contentType: "application/json"
 			};
 		}
 	}, {
 		method: "GET",
-		path: S,
+		path: v,
 		handle: async (e) => {
-			let t = R(a, e);
+			let t = z(a, e);
 			if (t) return t;
 			let n = /\/([^/]+)\.json$/.exec(e.path)?.[1];
-			return n === void 0 || n === "" || !v.has(n) ? w(n ?? "") : {
+			return n === void 0 || n === "" || !b.has(n) ? E(n ?? "") : {
 				status: 200,
-				body: v.get(n),
+				body: b.get(n),
 				contentType: "application/json"
 			};
 		}
 	}];
-	return i !== !1 && T.push({
+	return i !== !1 && D.push({
 		method: "GET",
 		path: i,
 		match: "exact",
-		handle: async (e) => {
-			let n = R(a, e);
-			if (n) return n;
-			let i = V(f), o = i.length > 1 ? [...i.map((e) => ({
-				url: C(e),
-				name: H(e, f)
-			})), {
-				url: r,
-				name: "all versions"
-			}] : void 0;
-			return {
-				status: 200,
-				body: I(r, t.info?.title ?? "API docs", o === void 0 ? {} : {
-					urls: o,
-					primaryName: o[0].name
-				}),
-				contentType: "text/html; charset=utf-8"
-			};
+		handle: async (e) => z(a, e) || {
+			status: 200,
+			body: S,
+			contentType: "text/html; charset=utf-8"
 		}
-	}), n({
+	}), t({
 		name: o,
 		description: "OpenAPI 3.1 spec + Swagger-UI docs from defineRestRoute descriptors + rpc procedures.",
 		permissions: [],
-		declaredEnv: L.declared,
-		httpRoutes: T,
-		onRestSurface: b,
-		onProcedureSurface: x,
+		declaredEnv: R.declared,
+		httpRoutes: D,
+		onRestSurface: w,
+		onProcedureSurface: T,
 		onActivate: (t) => e.sync(() => {
 			t.logger.info("openapi docs active", {
 				specPath: r,
@@ -613,11 +631,11 @@ var j = "5.17.14", M = "sha384-wxLW6kwyHktdDGr6Pv1zgm/VGJh99lfUbzSn6HNHBENZlCN7W
 				appProcedures: d ? "included once discovered" : "excluded",
 				environment: p,
 				servers: h.map((e) => e.url),
-				versions: V(f),
+				versions: H(f),
 				tokenGated: !!a
 			});
 		})
 	});
 };
 //#endregion
-export { y as PROBLEM_DETAILS_SCHEMA_NAME, x as deriveExample, A as generateOpenApiSpec, V as mountedVersions, U as openapiPlugin, I as swaggerUiHtml, H as versionLabel };
+export { b as PROBLEM_DETAILS_SCHEMA_NAME, S as deriveExample, j as generateOpenApiSpec, H as mountedVersions, W as openapiPlugin, L as swaggerUiHtml, U as versionLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-openapi",
-  "version": "0.83.1",
+  "version": "0.85.0",
   "description": "Generate an OpenAPI 3.1 spec from defineRestRoute descriptors and serve it + a Swagger-UI docs page. Zero hand-maintained API docs — the REST descriptors ARE the source of truth.",
   "keywords": [
     "voltro",
@@ -33,11 +33,11 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/env": "0.83.1",
-    "@voltro/protocol": "0.83.1"
+    "@voltro/env": "0.85.0",
+    "@voltro/protocol": "0.85.0"
   },
   "peerDependencies": {
-    "effect": "^3.22.2"
+    "effect": "4.0.1"
   },
   "publishConfig": {
     "access": "public"