@voltro/plugin-openapi 0.84.0 → 0.86.0

package/dist/rpc.js

@@ -0,0 +1,45 @@
+import { errorResponse as e, toJsonSchema as t } from "./generate.js";
+//#region 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,
+		content: { "application/json": { schema: t(n.input, s) } }
+	}, d = (() => {
+		if (c === "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: t(n.element, s) } }
+		};
+		let e = t(n.output, s);
+		return {
+			description: c === "query" ? "OK — the query snapshot (the first/initial snapshot over `POST /rpc`; the WebSocket channel then pushes reactive updates)." : "OK",
+			content: { "application/json": { schema: e } }
+		};
+	})(), f = i(n.error) ? {} : { 422: {
+		description: "A typed error from the procedure — one of its declared error variants (the rpc failure channel).",
+		content: { "application/json": { schema: t(n.error, s) } }
+	} };
+	return {
+		tags: [r],
+		summary: a(c, l),
+		description: o(c),
+		"x-voltro-rpc": {
+			kind: c,
+			procedure: l
+		},
+		requestBody: u,
+		responses: {
+			200: d,
+			...f,
+			500: e("Internal Server Error — an untyped defect.")
+		}
+	};
+}, c = (e, t) => {
+	let r = {};
+	for (let i of e) {
+		let e = `${n}/${i.name}`;
+		r[e] = { post: s(i, t) };
+	}
+	return r;
+};
+//#endregion
+export { c as rpcPathItems };

package/dist/swaggerUi.js

@@ -0,0 +1,20 @@
+//#region 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>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${r}</title>
+  <link rel="stylesheet" href="${t}" integrity="sha384-wxLW6kwyHktdDGr6Pv1zgm/VGJh99lfUbzSn6HNHBENZlCN7W602k9VkGdxuFvPn" crossorigin="anonymous" />
+  <style>body { margin: 0 }</style>
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="${n}" integrity="sha384-wmyclcVGX/WhUkdkATwhaK1X1JtiNrr2EoYJ+diV3vj4v6OC5yCeSu+yW13SYJep" crossorigin="anonymous"><\/script>
+  <script>
+    window.ui = SwaggerUIBundle({ ${i.urls !== void 0 && i.urls.length > 0 ? `urls: ${JSON.stringify(i.urls)}, ${i.primaryName === void 0 ? "" : `'urls.primaryName': ${JSON.stringify(i.primaryName)}, `}` : `url: ${JSON.stringify(e)}, `}dom_id: '#swagger-ui', deepLinking: true });
+  <\/script>
+</body>
+</html>`;
+//#endregion
+export { r as swaggerUiHtml };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-openapi",
-  "version": "0.84.0",
+  "version": "0.86.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.84.0",
-    "@voltro/protocol": "0.84.0"
+    "@voltro/env": "0.86.0",
+    "@voltro/protocol": "0.86.0"
   },
   "peerDependencies": {
-    "effect": "^3.22.2"
+    "effect": "4.0.1"
   },
   "publishConfig": {
     "access": "public"