@adhd/apigen-plugin-openapi 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.1 (2026-07-28)
+
+This was a version bump only for apigen-plugin-openapi to align it with other projects, there were no code changes.
+
 ## 0.1.7 (2026-07-25)
 
 

package/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require("ts-morph");require("node:fs");require("node:path");require("ts-json-schema-generator");const d=new Set(["string","number","boolean","integer"]);function v(e){if(typeof e!="object"||e===null)return!1;const t=e;if(t.$ref!==void 0||t.oneOf||t.anyOf||t.allOf)return!1;const{type:r}=t;return typeof r=="string"?d.has(r):Array.isArray(r)?r.every(o=>d.has(o)||o==="null"):Array.isArray(t.enum)&&t.enum.length>0?t.enum.every(o=>["string","number","boolean"].includes(typeof o)):!1}function O(e){if(!e||typeof e!="object")return!1;const t=e.properties;return t===void 0||typeof t!="object"||t===null?!1:Object.values(t).every(v)}const q={"decimal.js":"Decimal"};function A(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(q).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${A(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));function m(e){return e.words.join("-")}function y(e){return e.words.map(P).join("")}function g(e){return e.words.join("_")}function w(e,t={}){var r,o;const n=[e.namespace,...e.path],i=e.safe||O(e.input)?"GET":"POST",c=((o=(r=t.http)==null?void 0:r.verb)==null?void 0:o[e.id])??i,l="/"+n.map(s=>m(s)).join("/"),a=n.map(s=>g(s)).join("_"),f=n.map(s=>g(s)).slice(0,-1).join("."),u=y(n[n.length-2]??n[0]),p=y(n[n.length-1]),j=n.map(s=>m(s));return{http:{verb:c,route:l},mcp:{name:a},grpc:{package:f,service:u,method:p},cli:{path:j}}}function P(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function S(e,t={}){const r=t.title??"API",o=t.version??"0.0.0",n={};for(const i of e){const c=w(i),{verb:l,route:a}=c.http,f=l.toLowerCase(),u={operationId:i.id,summary:i.id,responses:{200:_(i.output)}};if(l==="GET")u.parameters=T(i.input);else{const p=i.input;typeof p=="object"&&p!==null&&Object.keys(p).length>0&&(u.requestBody={required:!0,content:{"application/json":{schema:p}}})}n[a]===void 0&&(n[a]={}),n[a][f]=u}return{openapi:"3.1.0",info:{title:r,version:o},paths:n}}function _(e){return typeof e=="object"&&e!==null&&Object.keys(e).length>0?{description:"Success",content:{"application/json":{schema:e}}}:{description:"Success"}}function T(e){if(typeof e!="object"||e===null||typeof e.properties!="object"||e.properties===null)return[];const t=Array.isArray(e.required)?e.required:[],r=e.properties;return Object.entries(r).map(([o,n])=>({name:o,in:"query",required:t.includes(o),schema:n}))}function b(e){return{raw:e,words:e.split(/(?=[A-Z])|[-_]/).map(t=>t.toLowerCase()).filter(Boolean)}}function k(e,t={}){return[{id:"_meta/openapi",host:e.host,namespace:b("meta"),path:[b("openapi")],kind:"query",async:!1,streaming:!1,safe:!0,input:{},output:{type:"object"},envelope:{},typeText:null,transports:["http"],handler:r=>S(e.operations,{title:t.title,version:t.version})}]}const h={id:"openapi",description:"Mount plugin: serves the OpenAPI 3.1 doc at GET /meta/openapi",language:"ts",optionsSchema:{type:"object",properties:{title:{type:"string",description:"OpenAPI info.title"},version:{type:"string",description:"OpenAPI info.version"}},additionalProperties:!1},capabilities:{mount:{operations(e,t){return k(e,t)}}}};exports.default=h;exports.openapiPlugin=h;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require("ts-morph");require("node:fs");require("node:path");require("ts-json-schema-generator");function m(e){return{raw:e,words:e.split(/(?=[A-Z])|[-_]/).map(t=>t.toLowerCase()).filter(Boolean)}}function j(e,t,n={}){const o=e.split("/");if(o.length<2||o.some(l=>l.length===0))throw new Error(`syntheticOp: id "${e}" must be "<namespace>/<path...>" with non-empty segments`);const[r,...i]=o,c=r.replace(/^_+/,""),p=n.kind??"action",s={id:e,host:t.host,namespace:m(c),path:i.map(m),kind:p,async:n.async??!1,streaming:n.streaming??!1,safe:n.safe??p==="query",input:n.input??{},output:n.output??{},envelope:n.envelope??{},typeText:n.typeText??null};return n.hasCtx!==void 0&&(s.hasCtx=n.hasCtx),n.transports!==void 0&&(s.transports=n.transports),s}const O={"decimal.js":"Decimal"};function w(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(O).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${w(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));const d=new Set(["string","number","boolean","integer"]);function q(e){if(typeof e!="object"||e===null)return!1;const t=e;if(t.$ref!==void 0||t.oneOf||t.anyOf||t.allOf)return!1;const{type:n}=t;return typeof n=="string"?d.has(n):Array.isArray(n)?n.every(o=>d.has(o)||o==="null"):Array.isArray(t.enum)&&t.enum.length>0?t.enum.every(o=>["string","number","boolean"].includes(typeof o)):!1}function A(e){if(!e||typeof e!="object")return!1;const t=e.properties;return t===void 0||typeof t!="object"||t===null?!1:Object.values(t).every(q)}const P={"decimal.js":"Decimal"};function k(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}Object.entries(P).map(([e,t])=>({pattern:new RegExp(`import\\(["'][^"']*${k(e)}[^"']*["']\\)\\.\\w+`,"g"),key:t}));function y(e){return e.words.join("-")}function h(e){return e.words.map(S).join("")}function g(e){return e.words.join("_")}function x(e,t={}){var n,o;const r=[e.namespace,...e.path],i=e.safe||A(e.input)?"GET":"POST",c=((o=(n=t.http)==null?void 0:n.verb)==null?void 0:o[e.id])??i,p="/"+r.map(a=>y(a)).join("/"),s=r.map(a=>g(a)).join("_"),l=r.map(a=>g(a)).slice(0,-1).join("."),f=h(r[r.length-2]??r[0]),u=h(r[r.length-1]),b=r.map(a=>y(a));return{http:{verb:c,route:p},mcp:{name:s},grpc:{package:l,service:f,method:u},cli:{path:b}}}function S(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function _(e,t={}){const n=t.title??"API",o=t.version??"0.0.0",r={};for(const i of e){const c=x(i),{verb:p,route:s}=c.http,l=p.toLowerCase(),f={operationId:i.id,summary:i.id,responses:{200:$(i.output)}};if(p==="GET")f.parameters=E(i.input);else{const u=i.input;typeof u=="object"&&u!==null&&Object.keys(u).length>0&&(f.requestBody={required:!0,content:{"application/json":{schema:u}}})}r[s]===void 0&&(r[s]={}),r[s][l]=f}return{openapi:"3.1.0",info:{title:n,version:o},paths:r}}function $(e){return typeof e=="object"&&e!==null&&Object.keys(e).length>0?{description:"Success",content:{"application/json":{schema:e}}}:{description:"Success"}}function E(e){if(typeof e!="object"||e===null||typeof e.properties!="object"||e.properties===null)return[];const t=Array.isArray(e.required)?e.required:[],n=e.properties;return Object.entries(n).map(([o,r])=>({name:o,in:"query",required:t.includes(o),schema:r}))}function T(e,t={}){return[{...j("_meta/openapi",e,{kind:"query",safe:!0,output:{type:"object"},transports:["http"]}),handler:n=>_(e.operations,{title:t.title,version:t.version})}]}const v={id:"openapi",description:"Mount plugin: serves the OpenAPI 3.1 doc at GET /meta/openapi",language:"ts",optionsSchema:{type:"object",properties:{title:{type:"string",description:"OpenAPI info.title"},version:{type:"string",description:"OpenAPI info.version"}},additionalProperties:!1},capabilities:{mount:{operations(e,t){return T(e,t)}}}};exports.default=v;exports.openapiPlugin=v;

package/index.mjs

@@ -2,31 +2,78 @@ import "ts-morph";
 import "node:fs";
 import "node:path";
 import "ts-json-schema-generator";
-const m = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
-function j(e) {
+function m(e) {
+  return {
+    raw: e,
+    words: e.split(/(?=[A-Z])|[-_]/).map((t) => t.toLowerCase()).filter(Boolean)
+  };
+}
+function b(e, t, n = {}) {
+  const o = e.split("/");
+  if (o.length < 2 || o.some((l) => l.length === 0))
+    throw new Error(
+      `syntheticOp: id "${e}" must be "<namespace>/<path...>" with non-empty segments`
+    );
+  const [r, ...i] = o, c = r.replace(/^_+/, ""), p = n.kind ?? "action", s = {
+    id: e,
+    host: t.host,
+    namespace: m(c),
+    path: i.map(m),
+    kind: p,
+    async: n.async ?? !1,
+    streaming: n.streaming ?? !1,
+    safe: n.safe ?? p === "query",
+    input: n.input ?? {},
+    output: n.output ?? {},
+    envelope: n.envelope ?? {},
+    typeText: n.typeText ?? null
+  };
+  return n.hasCtx !== void 0 && (s.hasCtx = n.hasCtx), n.transports !== void 0 && (s.transports = n.transports), s;
+}
+const j = {
+  "decimal.js": "Decimal"
+};
+function O(e) {
+  return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+Object.entries(j).map(([e, t]) => ({
+  // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
+  // The module specifier appears inside an absolute path, so we allow any
+  // characters between the quote and the specifier, and between the specifier
+  // and the closing quote. The trailing member accessor (`.default`, `.Decimal`,
+  // …) is matched generically (`\w+`) rather than anchored to one spelling —
+  // see the doc comment above for why.
+  pattern: new RegExp(
+    `import\\(["'][^"']*${O(e)}[^"']*["']\\)\\.\\w+`,
+    "g"
+  ),
+  key: t
+}));
+const d = /* @__PURE__ */ new Set(["string", "number", "boolean", "integer"]);
+function w(e) {
   if (typeof e != "object" || e === null)
     return !1;
   const t = e;
   if (t.$ref !== void 0 || t.oneOf || t.anyOf || t.allOf)
     return !1;
-  const { type: o } = t;
-  return typeof o == "string" ? m.has(o) : Array.isArray(o) ? o.every((r) => m.has(r) || r === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((r) => ["string", "number", "boolean"].includes(typeof r)) : !1;
+  const { type: n } = t;
+  return typeof n == "string" ? d.has(n) : Array.isArray(n) ? n.every((o) => d.has(o) || o === "null") : Array.isArray(t.enum) && t.enum.length > 0 ? t.enum.every((o) => ["string", "number", "boolean"].includes(typeof o)) : !1;
 }
-function v(e) {
+function A(e) {
   if (!e || typeof e != "object")
     return !1;
   const t = e.properties;
   return t === void 0 || typeof t != "object" || t === null ? !1 : Object.values(t).every(
-    j
+    w
   );
 }
-const O = {
+const q = {
   "decimal.js": "Decimal"
 };
-function A(e) {
+function x(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-Object.entries(O).map(([e, t]) => ({
+Object.entries(q).map(([e, t]) => ({
   // Matches: import("...{modSpec}...").<anyMemberName>  (single or double quotes)
   // The module specifier appears inside an absolute path, so we allow any
   // characters between the quote and the specifier, and between the specifier
@@ -34,65 +81,65 @@ Object.entries(O).map(([e, t]) => ({
   // …) is matched generically (`\w+`) rather than anchored to one spelling —
   // see the doc comment above for why.
   pattern: new RegExp(
-    `import\\(["'][^"']*${A(e)}[^"']*["']\\)\\.\\w+`,
+    `import\\(["'][^"']*${x(e)}[^"']*["']\\)\\.\\w+`,
     "g"
   ),
   key: t
 }));
-function d(e) {
-  return e.words.join("-");
-}
 function y(e) {
-  return e.words.map(q).join("");
+  return e.words.join("-");
 }
 function h(e) {
+  return e.words.map($).join("");
+}
+function g(e) {
   return e.words.join("_");
 }
-function w(e, t = {}) {
-  var o, r;
-  const n = [e.namespace, ...e.path], i = e.safe || v(e.input) ? "GET" : "POST", l = ((r = (o = t.http) == null ? void 0 : o.verb) == null ? void 0 : r[e.id]) ?? i, c = "/" + n.map((p) => d(p)).join("/"), a = n.map((p) => h(p)).join("_"), f = n.map((p) => h(p)).slice(0, -1).join("."), u = y(n[n.length - 2] ?? n[0]), s = y(n[n.length - 1]), g = n.map((p) => d(p));
+function k(e, t = {}) {
+  var n, o;
+  const r = [e.namespace, ...e.path], i = e.safe || A(e.input) ? "GET" : "POST", c = ((o = (n = t.http) == null ? void 0 : n.verb) == null ? void 0 : o[e.id]) ?? i, p = "/" + r.map((a) => y(a)).join("/"), s = r.map((a) => g(a)).join("_"), l = r.map((a) => g(a)).slice(0, -1).join("."), f = h(r[r.length - 2] ?? r[0]), u = h(r[r.length - 1]), v = r.map((a) => y(a));
   return {
-    http: { verb: l, route: c },
-    mcp: { name: a },
-    grpc: { package: f, service: u, method: s },
-    cli: { path: g }
+    http: { verb: c, route: p },
+    mcp: { name: s },
+    grpc: { package: l, service: f, method: u },
+    cli: { path: v }
   };
 }
-function q(e) {
+function $(e) {
   return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
 }
-function P(e, t = {}) {
-  const o = t.title ?? "API", r = t.version ?? "0.0.0", n = {};
+function E(e, t = {}) {
+  const n = t.title ?? "API", o = t.version ?? "0.0.0", r = {};
   for (const i of e) {
-    const l = w(i), { verb: c, route: a } = l.http, f = c.toLowerCase(), u = {
+    const c = k(i), { verb: p, route: s } = c.http, l = p.toLowerCase(), f = {
       operationId: i.id,
       summary: i.id,
       responses: {
-        200: S(i.output)
+        200: P(i.output)
       }
     };
-    if (c === "GET")
-      u.parameters = k(i.input);
+    if (p === "GET")
+      f.parameters = C(i.input);
     else {
-      const s = i.input;
-      typeof s == "object" && s !== null && Object.keys(s).length > 0 && (u.requestBody = {
+      const u = i.input;
+      typeof u == "object" && u !== null && Object.keys(u).length > 0 && (f.requestBody = {
         required: !0,
         content: {
           "application/json": {
-            schema: s
+            schema: u
           }
         }
       });
     }
-    n[a] === void 0 && (n[a] = {}), n[a][f] = u;
+    r[s] === void 0 && (r[s] = {}), r[s][l] = f;
   }
   return {
     openapi: "3.1.0",
-    info: { title: o, version: r },
-    paths: n
+    info: { title: n, version: o },
+    paths: r
   };
 }
-function S(e) {
+function P(e) {
   return typeof e == "object" && e !== null && Object.keys(e).length > 0 ? {
     description: "Success",
     content: {
@@ -100,54 +147,39 @@ function S(e) {
     }
   } : { description: "Success" };
 }
-function k(e) {
+function C(e) {
   if (typeof e != "object" || e === null || typeof e.properties != "object" || e.properties === null)
     return [];
-  const t = Array.isArray(e.required) ? e.required : [], o = e.properties;
-  return Object.entries(o).map(([r, n]) => ({
-    name: r,
+  const t = Array.isArray(e.required) ? e.required : [], n = e.properties;
+  return Object.entries(n).map(([o, r]) => ({
+    name: o,
     in: "query",
-    required: t.includes(r),
-    schema: n
+    required: t.includes(o),
+    schema: r
   }));
 }
-function b(e) {
-  return {
-    raw: e,
-    words: e.split(/(?=[A-Z])|[-_]/).map((t) => t.toLowerCase()).filter(Boolean)
-  };
-}
-function E(e, t = {}) {
+function I(e, t = {}) {
   return [
     {
-      // Canonical id — the `_meta` prefix is a convention for meta-endpoints.
-      id: "_meta/openapi",
-      host: e.host,
-      namespace: b("meta"),
-      path: [b("openapi")],
-      // query + safe → GET /meta/openapi (SPEC §5)
-      kind: "query",
-      async: !1,
-      streaming: !1,
-      safe: !0,
-      // Input: no domain params — this is a zero-arg metadata endpoint.
-      input: {},
-      // Output: an object (the full OpenAPI doc shape; not narrowed further
-      // here because the exact schema varies with the descriptor content).
-      output: { type: "object" },
-      envelope: {},
-      typeText: null,
-      // Expose only on HTTP — the doc is a tooling artefact (SPEC §7.2b).
-      transports: ["http"],
+      ...b("_meta/openapi", e, {
+        // query + safe → GET /meta/openapi (SPEC §5)
+        kind: "query",
+        safe: !0,
+        // Output: an object (the full OpenAPI doc shape; not narrowed further
+        // here because the exact schema varies with the descriptor content).
+        output: { type: "object" },
+        // Expose only on HTTP — the doc is a tooling artefact (SPEC §7.2b).
+        transports: ["http"]
+      }),
       // Handler: derive the doc from the descriptor at request time.
-      handler: (o) => P(e.operations, {
+      handler: (n) => E(e.operations, {
         title: t.title,
         version: t.version
       })
     }
   ];
 }
-const x = {
+const B = {
   id: "openapi",
   description: "Mount plugin: serves the OpenAPI 3.1 doc at GET /meta/openapi",
   language: "ts",
@@ -162,7 +194,7 @@ const x = {
   capabilities: {
     mount: {
       operations(e, t) {
-        return E(
+        return I(
           e,
           t
         );
@@ -171,6 +203,6 @@ const x = {
   }
 };
 export {
-  x as default,
-  x as openapiPlugin
+  B as default,
+  B as openapiPlugin
 };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@adhd/apigen-plugin-openapi",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "main": "./index.js",
   "dependencies": {
-    "@adhd/apigen-core-client": "^0.2.0",
-    "@adhd/apigen-codegen-openapi": "^0.2.0"
+    "@adhd/apigen-core-client": "^0.2.1",
+    "@adhd/apigen-codegen-openapi": "^0.2.1"
   },
   "publishConfig": {
     "access": "public"