@voltro/plugin-openapi 0.85.0 → 0.87.0

package/dist/index.js

@@ -1,497 +1,10 @@
-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 === "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: 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: m(e.element, 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: m(e.error, t) } }
-	} };
-	return {
-		tags: [o],
-		summary: c(n, r),
-		description: l(n),
-		"x-voltro-rpc": {
-			kind: n,
-			procedure: r
-		},
-		requestBody: i,
-		responses: {
-			200: a,
-			...u,
-			500: y("Internal Server Error — an untyped defect.")
-		}
-	};
-}, d = (e, t) => {
-	let n = {};
-	for (let r of e) {
-		let e = `${a}/${r.name}`;
-		n[e] = { post: u(r, t) };
-	}
-	return n;
-}, 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)}` : h(r);
-		return t;
-	}
-	return e;
-}, g = (e, t) => {
-	if (!e) return {
-		parameters: [],
-		requestBody: void 0
-	};
-	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;
-		let i = n.properties ?? {}, o = new Set(n.required ?? []);
-		for (let [e, n] of Object.entries(i)) a.push({
-			name: e,
-			in: t,
-			required: t === "path" || o.has(e),
-			schema: n
-		});
-	}
-	let o = r.body;
-	return {
-		parameters: a,
-		requestBody: o && typeof o == "object" ? {
-			required: i.has("body"),
-			content: { "application/json": { schema: o } }
-		} : void 0
-	};
-}, _ = "VoltroHttpError", v = {
-	type: "object",
-	description: "The serve pipeline's error envelope.",
-	properties: {
-		error: {
-			type: "string",
-			description: "Human-readable error message."
-		},
-		detail: {
-			type: "string",
-			description: "Decode failure detail (400 only)."
-		},
-		replacement: {
-			type: "string",
-			description: "Replacement endpoint hint (410 only)."
-		}
-	},
-	required: ["error"]
-}, y = (e) => ({
-	description: e,
-	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: {
-		type: {
-			type: "string",
-			format: "uri",
-			description: "The error type — `urn:voltro:error:<Tag>`."
-		},
-		title: { type: "string" },
-		status: { type: "integer" },
-		detail: { type: "string" }
-	},
-	required: [
-		"type",
-		"title",
-		"status"
-	],
-	additionalProperties: !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" ? 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 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) => 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;
-	switch (Array.isArray(o) ? o.find((e) => e !== "null") : o) {
-		case "string": {
-			let t = e.format;
-			if (t === "date-time") return "2026-01-01T00:00:00.000Z";
-			if (t === "date") return "2026-01-01";
-			if (t === "email") return "user@example.com";
-			if (t === "uri" || t === "url") return "https://example.com";
-			if (t === "uuid") return "00000000-0000-4000-8000-000000000000";
-			let n = typeof e.minLength == "number" ? e.minLength : 0;
-			return "string".padEnd(Math.max(n, 6), "x");
-		}
-		case "integer": return typeof e.minimum == "number" ? e.minimum : 1;
-		case "number": return typeof e.minimum == "number" ? e.minimum : 1;
-		case "boolean": return !0;
-		case "null": return null;
-		case "array": {
-			let r = e.items;
-			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] = S(a, t, n + 1);
-			return i;
-		}
-		default: return typeof e.properties == "object" ? S({
-			...e,
-			type: "object"
-		}, t, n) : null;
-	}
-}, C = {
-	400: {
-		tag: "InvalidRequest",
-		detail: "Invalid request"
-	},
-	401: {
-		tag: "Unauthorized",
-		detail: "Authentication required"
-	},
-	403: {
-		tag: "Forbidden",
-		detail: "Missing required scope: <scope>"
-	},
-	410: {
-		tag: "Gone",
-		detail: "Gone"
-	},
-	500: {
-		tag: "InternalServerError",
-		detail: "Internal Server Error"
-	}
-}, w = {
-	400: "Bad Request",
-	401: "Unauthorized",
-	403: "Forbidden",
-	404: "Not Found",
-	409: "Conflict",
-	410: "Gone",
-	422: "Unprocessable Content",
-	429: "Too Many Requests",
-	500: "Internal Server Error"
-}, 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 = 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,
-			...c
-		} : {
-			error: e.tag,
-			...c
-		};
-		t.push({
-			tag: e.tag,
-			example: l,
-			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 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,
-			detail: n.detail
-		} };
-		return {
-			description: t,
-			content: { [i]: {
-				schema: { $ref: `#/components/schemas/${b}` },
-				...a
-			} }
-		};
-	}, s = {};
-	s[400] = o(400, "Invalid request — the input failed schema decode."), t.security !== "none" && (s[401] = o(401, "Unauthorized — no valid bearer.")), (t.security === "required" || (e.guards?.length ?? 0) > 0) && (s[403] = o(403, "Forbidden — the caller lacks a required scope."));
-	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: `${w[e] ?? "Error"} — ${n.join(" | ")}`,
-			content: { [i]: {
-				schema: t.length === 1 ? t[0].schema : { oneOf: t.map((e) => e.schema) },
-				example: t[0].example
-			} }
-		};
-	}
-	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;
-}, 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 ? {
-			required: l.length > 0,
-			content: {
-				"application/json": { schema: {
-					...r,
-					properties: c,
-					required: l
-				} },
-				"application/x-www-form-urlencoded": { schema: {
-					...r,
-					properties: c,
-					required: l
-				} }
-			}
-		} : void 0
-	};
-}, 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 = 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,
-			...a ? { next: {
-				type: "string",
-				description: "The next page's cursor, when there is one."
-			} } : {}
-		},
-		required: ["data"]
-	} : i.envelope === "jsonapi" ? {
-		type: "object",
-		properties: {
-			data: { description: "One resource or an array of resources — `{ type, id, attributes }`." },
-			links: {
-				type: "object",
-				properties: { next: { type: "string" } }
-			}
-		},
-		required: ["data"]
-	} : r : { description: `Encoded by the '${i.name}' format.` }, s = i.envelope === "jsonapi" ? "application/vnd.api+json" : "application/json", c = {
-		...a ? { Link: {
-			description: "RFC 8288 — `<url>; rel=\"next\"` when there is a next page.",
-			schema: { type: "string" }
-		} } : {},
-		...e.etag === !0 ? { ETag: {
-			description: "Weak validator; send it back as `If-None-Match` for a 304.",
-			schema: { type: "string" }
-		} } : {},
-		...e.cache !== void 0 && e.method === "GET" ? {
-			"Cache-Control": {
-				description: `\`public, max-age=${e.cache.maxAge}\` for a request without a credential; \`private, no-cache\` for one with \`Authorization\` or a cookie.`,
-				schema: { type: "string" }
-			},
-			...e.cache.tags === void 0 ? {} : {
-				"Cache-Tag": {
-					description: "Purge tags, comma-separated (only on a public answer).",
-					schema: { type: "string" }
-				},
-				"Surrogate-Key": {
-					description: "The same purge tags, space-separated (only on a public answer).",
-					schema: { type: "string" }
-				}
-			}
-		} : {}
-	};
-	return {
-		description: "OK",
-		...Object.keys(c).length > 0 ? { headers: c } : {},
-		content: { [s]: {
-			schema: o,
-			...k(e.example?.response, o, 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;
-}, k = (e, t, n) => e === void 0 ? {
-	example: S(t, n),
-	"x-voltro-example": "derived"
-} : { 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: 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: y(`Gone — the route is past its sunset date (${e.sunset}).`) },
-	500: y("Internal Server Error.")
-});
-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 ? 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,
-			description: "A previously returned ETag. A matching validator returns 304 without a body.",
-			schema: { type: "string" }
-		}] : n, c = i ? { 304: {
-			description: "Not Modified",
-			headers: { ETag: {
-				description: "The current representation validator.",
-				schema: { type: "string" }
-			} }
-		} } : {}, l = t.guards !== void 0 && t.guards.length > 0;
-		if (r !== void 0) {
-			let e = r.content;
-			e["application/json"] = {
-				...e["application/json"],
-				...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: [] }, {}] } : {}, 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 },
-			...p === void 0 ? {} : { tags: p },
-			...h === void 0 ? {} : { "x-voltro-api-version": h },
-			...s.length > 0 ? { parameters: s } : {},
-			...r ? { requestBody: r } : {},
-			...d,
-			responses: e === void 0 ? {
-				200: t.streaming === !0 ? {
-					description: "Server-Sent Events stream (`snapshot`, then `delta` per change)",
-					content: { "text/event-stream": { schema: { type: "string" } } }
-				} : {
-					description: "OK",
-					content: { "application/json": {
-						schema: m(t.output, o),
-						...k(t.example?.response, m(t.output, o), o)
-					} }
-				},
-				...A(t),
-				...c
-			} : {
-				200: D(t, e, o),
-				...c,
-				...T(t, e, o)
-			}
-		};
-		e?.format.describe !== void 0 && (_ = e.format.describe(_, {
-			tag: e.tag,
-			method: t.method,
-			path: t.path
-		}));
-		let v = f(t.path), y = a[v] ?? {};
-		y[t.method.toLowerCase()] = _, a[v] = y;
-	}
-	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 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] }
-	})), S = (r.servers ?? []).map((e) => ({
-		url: e.url,
-		...e.description === void 0 ? {} : { description: e.description },
-		...e.environment === void 0 ? {} : { "x-voltro-environment": e.environment }
-	}));
-	return {
-		openapi: "3.1.0",
-		info: {
-			title: t.title ?? "API",
-			version: t.version ?? "1.0.0",
-			...t.description ? { description: t.description } : {},
-			...t.contact === void 0 ? {} : { contact: t.contact },
-			...t.license === void 0 ? {} : { license: t.license },
-			...t.termsOfService === void 0 ? {} : { termsOfService: t.termsOfService },
-			...t.logo === void 0 ? {} : { "x-logo": t.logo }
-		},
-		...S.length > 0 ? { servers: S } : {},
-		...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) } : {},
-		...y.length > 0 ? { tags: y } : {},
-		paths: h(a),
-		components: {
-			schemas: {
-				...h(o),
-				[_]: v,
-				...l ? { [b]: x } : {}
-			},
-			...s || c ? { securitySchemes: { bearerAuth: {
-				type: "http",
-				scheme: "bearer"
-			} } } : {}
-		}
-	};
-}
-//#endregion
-//#region src/swaggerUi.ts
-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="${F}" integrity="${N}" crossorigin="anonymous" />
-  <style>body { margin: 0 }</style>
-</head>
-<body>
-  <div id="swagger-ui"></div>
-  <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>`, R = r([
+import { PROBLEM_DETAILS_SCHEMA_NAME as e, deriveExample as t, generateOpenApiSpec as n } from "./generate.js";
+import { swaggerUiHtml as r } from "./swaggerUi.js";
+import { Effect as i } from "effect";
+import { definePlugin as a } from "@voltro/protocol";
+import { pluginEnv as o } from "@voltro/env";
+//#region src/index.ts
+var s = o([
 	{
 		name: "OPENAPI_DOCS_TOKEN",
 		required: !1,
@@ -510,132 +23,136 @@ var M = "5.17.14", N = "sha384-wxLW6kwyHktdDGr6Pv1zgm/VGJh99lfUbzSn6HNHBENZlCN7W
 		secret: !1,
 		description: "The environment this instance serves (dev | staging | production) — x-voltro-environment on the spec."
 	}
-]), z = (e, t) => {
+]), c = (e, t) => {
 	if (e) return (t.headers.authorization ?? t.headers.Authorization) === `Bearer ${e}` ? void 0 : {
 		status: 401,
 		body: "unauthorized",
 		contentType: "text/plain"
 	};
-}, B = (e) => e.projection?.version ?? e.version, V = (e) => {
+}, l = (e) => e.projection?.version ?? e.version, u = (e) => {
 	let t = /^v(\d+)$/.exec(e);
 	return t === null ? -1 : Number(t[1]);
-}, 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) => {
+}, d = (e) => [...new Set(e.map(l).filter((e) => e !== void 0))].sort((e, t) => u(t) - u(e) || t.localeCompare(e)), f = (e, t) => {
 	let n;
 	for (let r of t) {
-		if (B(r) !== e) continue;
+		if (l(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 = {
-		...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, 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);
+}, p = (e) => {
+	let t = e.specPath ?? "/openapi.json", o = e.docsPath ?? "/docs", f = s.read("OPENAPI_DOCS_TOKEN", e.token), p = e.name ? `@voltro/plugin-openapi#${e.name}` : "@voltro/plugin-openapi", m = e.routes ?? [], h = e.procedures ?? [], g = h, _ = e.includeAppRoutes ?? !0, v = e.includeAppProcedures ?? !1, y = m, b = e.environment ?? s.read("VOLTRO_ENVIRONMENT", void 0) ?? (process.env.NODE_ENV === "production" ? "production" : "dev"), x = s.read("VOLTRO_PUBLIC_API_ORIGIN", void 0), S = e.servers ?? (x === void 0 ? [] : [{
+		url: x,
+		description: `${b} — this instance`,
+		environment: b
+	}]), C = {
+		...e.tagDescriptions === void 0 ? {} : { tagDescriptions: e.tagDescriptions },
+		...e.tagExternalDocs === void 0 ? {} : { tagExternalDocs: e.tagExternalDocs },
+		...e.externalDocs === void 0 ? {} : { externalDocs: e.externalDocs },
+		...S.length > 0 ? { servers: S } : {},
+		environment: b
+	}, w = (t, r, i) => JSON.stringify(n(t, e.info ?? {}, r ? { procedures: i } : {}, C), null, 2), T = t.endsWith(".json") ? t.slice(0, -5) : `${t}/versions`, E = (e) => `${T}/${e}.json`, D = /* @__PURE__ */ new Map(), O = [], k = "", A = (n = y, i = g) => {
+		let a = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map();
+		for (let e of n) {
+			let t = l(e);
+			if (t === void 0) continue;
+			let n = a.get(t);
+			n === void 0 && (n = [], a.set(t, n)), n.push(e);
+			let r = e.sunset, i = s.get(t);
+			r !== void 0 && (i === void 0 || r < i) && s.set(t, 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
+		let c = [...a.keys()].sort((e, t) => u(t) - u(e) || t.localeCompare(e)), d = new Map([["", w(n, !0, i)], ...c.map((e) => [e, w(a.get(e), !1, i)])]), f = c.length > 1 ? [...c.map((e) => ({
+			url: E(e),
+			name: s.has(e) ? `${e} — sunset ${s.get(e)}` : e
 		})), {
-			url: r,
+			url: t,
 			name: "all versions"
-		}] : void 0, d = i === !1 ? "" : L(r, n.info?.title ?? "API docs", u === void 0 ? {} : {
-			urls: u,
-			primaryName: u[0].name
+		}] : void 0, p = o === !1 ? "" : r(t, e.info?.title ?? "API docs", f === void 0 ? {} : {
+			urls: f,
+			primaryName: f[0].name
 		});
-		b = c, x = s, S = d, f = e, l = t;
+		D = d, O = c, k = p, y = n, g = i;
 	};
-	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}`));
-		C([...s, ...n]);
-	}, T = (e) => {
-		if (!d) return;
-		let t = new Set(c.map((e) => e.name));
-		C(f, [...c, ...e.filter((e) => !t.has(e.name))]);
-	}, E = (e) => ({
+	A();
+	let j = (e) => {
+		if (!_) return;
+		let t = new Set(m.map((e) => `${e.method} ${e.path}`)), n = e.filter((e) => !t.has(`${e.method} ${e.path}`));
+		A([...m, ...n]);
+	}, M = (e) => {
+		if (!v) return;
+		let t = new Set(h.map((e) => e.name));
+		A(y, [...h, ...e.filter((e) => !t.has(e.name))]);
+	}, N = (e) => ({
 		status: 404,
 		contentType: "application/json",
 		body: JSON.stringify({
 			error: `no API version '${e}' is mounted`,
-			versions: x
+			versions: O
 		})
-	}), D = [{
+	}), P = [{
+		workload: "rest",
 		method: "GET",
-		path: r,
+		path: t,
 		match: "exact",
 		handle: async (e) => {
-			let t = z(a, e);
+			let t = c(f, e);
 			if (t) return t;
 			let n = new URLSearchParams(e.query).get("version") ?? void 0;
-			return n !== void 0 && !b.has(n) ? E(n) : {
+			return n !== void 0 && !D.has(n) ? N(n) : {
 				status: 200,
-				body: b.get(n ?? ""),
+				body: D.get(n ?? ""),
 				contentType: "application/json"
 			};
 		}
 	}, {
+		workload: "rest",
 		method: "GET",
-		path: v,
+		path: T,
 		handle: async (e) => {
-			let t = z(a, e);
+			let t = c(f, e);
 			if (t) return t;
 			let n = /\/([^/]+)\.json$/.exec(e.path)?.[1];
-			return n === void 0 || n === "" || !b.has(n) ? E(n ?? "") : {
+			return n === void 0 || n === "" || !D.has(n) ? N(n ?? "") : {
 				status: 200,
-				body: b.get(n),
+				body: D.get(n),
 				contentType: "application/json"
 			};
 		}
 	}];
-	return i !== !1 && D.push({
+	return o !== !1 && P.push({
+		workload: "rest",
 		method: "GET",
-		path: i,
+		path: o,
 		match: "exact",
-		handle: async (e) => z(a, e) || {
+		handle: async (e) => c(f, e) || {
 			status: 200,
-			body: S,
+			body: k,
 			contentType: "text/html; charset=utf-8"
 		}
-	}), t({
-		name: o,
+	}), a({
+		name: p,
+		workloads: ["rest"],
 		description: "OpenAPI 3.1 spec + Swagger-UI docs from defineRestRoute descriptors + rpc procedures.",
 		permissions: [],
-		declaredEnv: R.declared,
-		httpRoutes: D,
-		onRestSurface: w,
-		onProcedureSurface: T,
-		onActivate: (t) => e.sync(() => {
-			t.logger.info("openapi docs active", {
-				specPath: r,
-				docsPath: i,
-				routes: f.length,
-				appRoutes: u ? "included once mounted" : "excluded",
-				procedures: l.length,
-				appProcedures: d ? "included once discovered" : "excluded",
-				environment: p,
-				servers: h.map((e) => e.url),
-				versions: H(f),
-				tokenGated: !!a
+		declaredEnv: s.declared,
+		httpRoutes: P,
+		onRestSurface: j,
+		onProcedureSurface: M,
+		onActivate: (e) => i.sync(() => {
+			e.logger.info("openapi docs active", {
+				specPath: t,
+				docsPath: o,
+				routes: y.length,
+				appRoutes: _ ? "included once mounted" : "excluded",
+				procedures: g.length,
+				appProcedures: v ? "included once discovered" : "excluded",
+				environment: b,
+				servers: S.map((e) => e.url),
+				versions: d(y),
+				tokenGated: !!f
 			});
 		})
 	});
 };
 //#endregion
-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 };
+export { e as PROBLEM_DETAILS_SCHEMA_NAME, t as deriveExample, n as generateOpenApiSpec, d as mountedVersions, p as openapiPlugin, r as swaggerUiHtml, f as versionLabel };