@voltro/plugin-openapi 0.86.0 → 0.88.0

package/dist/generate.js

@@ -1,7 +1,7 @@
 import { rpcPathItems as e } from "./rpc.js";
 import { jsonSchemaDocumentOf as t } from "@voltro/protocol";
 import { publicSurfaceDigest as n } from "@voltro/protocol/rest";
-//#region src/generate.ts
+// src/generate.ts
 var r = (e) => e.replace(/:([A-Za-z0-9_]+)/g, "{$1}"), i = (e) => {
 	let t = e.anyOf ?? e.oneOf;
 	if (!Array.isArray(t)) return e;
@@ -162,7 +162,8 @@ var r = (e) => e.replace(/:([A-Za-z0-9_]+)/g, "{$1}"), i = (e) => {
 	410: "Gone",
 	422: "Unprocessable Content",
 	429: "Too Many Requests",
-	500: "Internal Server Error"
+	500: "Internal Server Error",
+	503: "Service Unavailable"
 }, g = (e, t, n) => {
 	let r = t.format.errors === "problem-details" && t.format.encodeError === void 0, i = r ? "application/problem+json" : "application/json", o = /* @__PURE__ */ new Map();
 	for (let e of t.errorResponses) {
@@ -173,6 +174,7 @@ var r = (e) => e.replace(/:([A-Za-z0-9_]+)/g, "{$1}"), i = (e) => {
 			...l
 		} : {
 			error: e.tag,
+			_tag: e.tag,
 			...l
 		};
 		t.push({
@@ -200,18 +202,18 @@ var r = (e) => e.replace(/:([A-Za-z0-9_]+)/g, "{$1}"), i = (e) => {
 			} }
 		};
 	}, c = {};
-	c[400] = s(400, "Invalid request — the input failed schema decode."), t.security !== "none" && (c[401] = s(401, "Unauthorized — no valid bearer.")), (t.security === "required" || (e.guards?.length ?? 0) > 0) && (c[403] = s(403, "Forbidden — the caller lacks a required scope."));
+	c[400] = s(400, "Invalid request — the input failed schema decode."), t.security !== "none" && (c[401] = s(401, "Unauthorized — no valid bearer.")), (t.security === "required" || (e.guards?.length ?? 0) > 0) && (c[403] = s(403, "Forbidden — the caller lacks a required scope.")), e.sunset !== void 0 && (c[410] = s(410, `Gone — the route is past its sunset date (${e.sunset}).`)), c[500] = s(500, "Internal Server Error.");
 	for (let [e, t] of [...o.entries()].sort((e, t) => e[0] - t[0])) {
-		let n = t.map((e) => e.tag);
+		let n = t.map((e) => e.tag), r = c[String(e)], a = r?.content, o = t.length === 1 ? t[0].schema : { oneOf: t.map((e) => e.schema) }, s = a?.[i] === void 0 ? o : { anyOf: [o, a[i].schema] };
 		c[String(e)] = {
-			description: `${h[e] ?? "Error"} — ${n.join(" | ")}`,
+			description: `${h[e] ?? "Error"} — ${n.join(" | ")}${r === void 0 ? "" : `; ${r.description}`}`,
 			content: { [i]: {
-				schema: t.length === 1 ? t[0].schema : { oneOf: t.map((e) => e.schema) },
+				schema: s,
 				example: t[0].example
 			} }
 		};
 	}
-	return e.sunset !== void 0 && (c[410] = s(410, `Gone — the route is past its sunset date (${e.sunset}).`)), c[500] = s(500, "Internal Server Error."), c;
+	return c;
 }, _ = (e, t, n) => {
 	let r = a(t.input, n), o = r.properties ?? {}, s = new Set(r.required ?? []), c = new Set(t.pathParams), l = [], u = {}, d = [], f = e.example?.request, p = (e) => typeof f == "object" && f && e in f ? { example: f[e] } : {};
 	for (let [t, n] of Object.entries(o)) {
@@ -432,5 +434,4 @@ function S(t, i = {}, u = {}, p = {}) {
 		}
 	};
 }
-//#endregion
 export { l as HTTP_ERROR_SCHEMA, c as HTTP_ERROR_SCHEMA_NAME, f as PROBLEM_DETAILS_SCHEMA, d as PROBLEM_DETAILS_SCHEMA_NAME, p as deriveExample, u as errorResponse, S as generateOpenApiSpec, o as rewriteRefs, a as toJsonSchema };

package/dist/index.js

@@ -3,7 +3,7 @@ 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
+// src/index.ts
 var s = o([
 	{
 		name: "OPENAPI_DOCS_TOKEN",
@@ -90,6 +90,7 @@ var s = o([
 			versions: O
 		})
 	}), P = [{
+		workload: "rest",
 		method: "GET",
 		path: t,
 		match: "exact",
@@ -104,6 +105,7 @@ var s = o([
 			};
 		}
 	}, {
+		workload: "rest",
 		method: "GET",
 		path: T,
 		handle: async (e) => {
@@ -118,6 +120,7 @@ var s = o([
 		}
 	}];
 	return o !== !1 && P.push({
+		workload: "rest",
 		method: "GET",
 		path: o,
 		match: "exact",
@@ -128,6 +131,7 @@ var s = o([
 		}
 	}), a({
 		name: p,
+		workloads: ["rest"],
 		description: "OpenAPI 3.1 spec + Swagger-UI docs from defineRestRoute descriptors + rpc procedures.",
 		permissions: [],
 		declaredEnv: s.declared,
@@ -150,5 +154,4 @@ var s = o([
 		})
 	});
 };
-//#endregion
 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 };

package/dist/rpc.js

@@ -1,5 +1,5 @@
 import { errorResponse as e, toJsonSchema as t } from "./generate.js";
-//#region src/rpc.ts
+// src/rpc.ts
 var n = "/rpc", r = "rpc", i = (e) => e.ast._tag === "Never", a = (e, t) => `${e} ${t}`, o = (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.`, s = (n, s) => {
 	let { kind: c, name: l } = n, u = {
 		required: !0,
@@ -41,5 +41,4 @@ var n = "/rpc", r = "rpc", i = (e) => e.ast._tag === "Never", a = (e, t) => `${e
 	}
 	return r;
 };
-//#endregion
 export { c as rpcPathItems };

package/dist/swaggerUi.js

@@ -1,4 +1,4 @@
-//#region src/swaggerUi.ts
+// src/swaggerUi.ts
 var e = "5.17.14", t = `https://unpkg.com/swagger-ui-dist@${e}/swagger-ui.css`, n = `https://unpkg.com/swagger-ui-dist@${e}/swagger-ui-bundle.js`, r = (e, r = "API docs", i = {}) => `<!doctype html>
 <html lang="en">
 <head>
@@ -16,5 +16,4 @@ var e = "5.17.14", t = `https://unpkg.com/swagger-ui-dist@${e}/swagger-ui.css`,
   <\/script>
 </body>
 </html>`;
-//#endregion
 export { r as swaggerUiHtml };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-openapi",
-  "version": "0.86.0",
+  "version": "0.88.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.86.0",
-    "@voltro/protocol": "0.86.0"
+    "@voltro/env": "0.88.0",
+    "@voltro/protocol": "0.88.0"
   },
   "peerDependencies": {
-    "effect": "4.0.1"
+    "effect": "4.1.0"
   },
   "publishConfig": {
     "access": "public"