@adhd/apigen-codegen-openapi 0.1.0

package/index.d.ts

@@ -0,0 +1,3 @@
+export declare const __apigen_pkg = "@adhd/apigen-codegen-openapi";
+export { toOpenApi } from './lib/to-openapi';
+export type { OpenApiDocument, OpenApiPathItem, OpenApiOperation, OpenApiParameter, OpenApiRequestBody, OpenApiResponse, ToOpenApiOptions } from './lib/to-openapi';

package/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function h(e){return e.words.join("-")}function m(e){return e.words.map(y).join("")}function b(e){return e.words.join("_")}function j(e,r={}){var d,g;const t=[e.namespace,...e.path],s=e.safe?"GET":"POST",o=((g=(d=r.http)==null?void 0:d.verb)==null?void 0:g[e.id])??s,n="/"+t.map(c=>h(c)).join("/"),u=t.map(c=>b(c)).join("_"),a=t.map(c=>b(c)).slice(0,-1).join("."),l=m(t[t.length-2]??t[0]),p=m(t[t.length-1]),i=t.map(c=>h(c));return{http:{verb:o,route:n},mcp:{name:u},grpc:{package:a,service:l,method:p},cli:{path:i}}}function y(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function v(e,r={}){const t=r.title??"API",s=r.version??"0.0.0",o={};for(const n of e){const u=j(n),{verb:f,route:a}=u.http,l=f.toLowerCase(),p={operationId:n.id,summary:n.id,responses:{200:P(n.output)}};if(n.safe)p.parameters=S(n.input);else{const i=n.input;typeof i=="object"&&i!==null&&Object.keys(i).length>0&&(p.requestBody={required:!0,content:{"application/json":{schema:i}}})}o[a]===void 0&&(o[a]={}),o[a][l]=p}return{openapi:"3.1.0",info:{title:t,version:s},paths:o}}function P(e){return typeof e=="object"&&e!==null&&Object.keys(e).length>0?{description:"Success",content:{"application/json":{schema:e}}}:{description:"Success"}}function S(e){if(typeof e!="object"||e===null||typeof e.properties!="object"||e.properties===null)return[];const r=Array.isArray(e.required)?e.required:[],t=e.properties;return Object.entries(t).map(([s,o])=>({name:s,in:"query",required:r.includes(s),schema:o}))}const O="@adhd/apigen-codegen-openapi";exports.__apigen_pkg=O;exports.toOpenApi=v;

package/index.mjs

@@ -0,0 +1,77 @@
+function g(e) {
+  return e.words.join("-");
+}
+function m(e) {
+  return e.words.map(y).join("");
+}
+function j(e) {
+  return e.words.join("_");
+}
+function b(e, r = {}) {
+  var d, h;
+  const t = [e.namespace, ...e.path], s = e.safe ? "GET" : "POST", o = ((h = (d = r.http) == null ? void 0 : d.verb) == null ? void 0 : h[e.id]) ?? s, n = "/" + t.map((c) => g(c)).join("/"), u = t.map((c) => j(c)).join("_"), a = t.map((c) => j(c)).slice(0, -1).join("."), l = m(t[t.length - 2] ?? t[0]), p = m(t[t.length - 1]), i = t.map((c) => g(c));
+  return {
+    http: { verb: o, route: n },
+    mcp: { name: u },
+    grpc: { package: a, service: l, method: p },
+    cli: { path: i }
+  };
+}
+function y(e) {
+  return e.length === 0 ? e : e[0].toUpperCase() + e.slice(1);
+}
+function q(e, r = {}) {
+  const t = r.title ?? "API", s = r.version ?? "0.0.0", o = {};
+  for (const n of e) {
+    const u = b(n), { verb: f, route: a } = u.http, l = f.toLowerCase(), p = {
+      operationId: n.id,
+      summary: n.id,
+      responses: {
+        200: v(n.output)
+      }
+    };
+    if (n.safe)
+      p.parameters = P(n.input);
+    else {
+      const i = n.input;
+      typeof i == "object" && i !== null && Object.keys(i).length > 0 && (p.requestBody = {
+        required: !0,
+        content: {
+          "application/json": {
+            schema: i
+          }
+        }
+      });
+    }
+    o[a] === void 0 && (o[a] = {}), o[a][l] = p;
+  }
+  return {
+    openapi: "3.1.0",
+    info: { title: t, version: s },
+    paths: o
+  };
+}
+function v(e) {
+  return typeof e == "object" && e !== null && Object.keys(e).length > 0 ? {
+    description: "Success",
+    content: {
+      "application/json": { schema: e }
+    }
+  } : { description: "Success" };
+}
+function P(e) {
+  if (typeof e != "object" || e === null || typeof e.properties != "object" || e.properties === null)
+    return [];
+  const r = Array.isArray(e.required) ? e.required : [], t = e.properties;
+  return Object.entries(t).map(([s, o]) => ({
+    name: s,
+    in: "query",
+    required: r.includes(s),
+    schema: o
+  }));
+}
+const S = "@adhd/apigen-codegen-openapi";
+export {
+  S as __apigen_pkg,
+  q as toOpenApi
+};

package/lib/to-openapi.d.ts

@@ -0,0 +1,94 @@
+import { Operation, JSONSchema } from '@adhd/apigen-core';
+
+/**
+ * An OpenAPI 3.1 document.  The type is intentionally open (Record) because
+ * we cannot enumerate every valid 3.1 keyword here — downstream consumers can
+ * narrow as needed.
+ */
+export type OpenApiDocument = {
+    openapi: '3.1.0';
+    info: {
+        title: string;
+        version: string;
+    };
+    paths: Record<string, OpenApiPathItem>;
+    components?: {
+        schemas?: Record<string, JSONSchema>;
+    };
+    [key: string]: unknown;
+};
+/** An OpenAPI path-item object (subset sufficient for apigen projection). */
+export type OpenApiPathItem = {
+    [verb: string]: OpenApiOperation;
+};
+/** An OpenAPI operation object (subset). */
+export type OpenApiOperation = {
+    operationId: string;
+    summary?: string;
+    parameters?: OpenApiParameter[];
+    requestBody?: OpenApiRequestBody;
+    responses: Record<string, OpenApiResponse>;
+    [key: string]: unknown;
+};
+/** An OpenAPI parameter object (subset). */
+export type OpenApiParameter = {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    required?: boolean;
+    schema: JSONSchema;
+};
+/** An OpenAPI request-body object (subset). */
+export type OpenApiRequestBody = {
+    required: boolean;
+    content: {
+        'application/json': {
+            schema: JSONSchema;
+        };
+    };
+};
+/** An OpenAPI response object (subset). */
+export type OpenApiResponse = {
+    description: string;
+    content?: {
+        'application/json': {
+            schema: JSONSchema;
+        };
+    };
+};
+/**
+ * Options for {@link toOpenApi}.
+ */
+export interface ToOpenApiOptions {
+    /**
+     * The API title placed in `info.title`.
+     * @default 'API'
+     */
+    title?: string;
+    /**
+     * The API version placed in `info.version`.
+     * @default '0.0.0'
+     */
+    version?: string;
+}
+/**
+ * Projects an array of {@link Operation}s to an OpenAPI 3.1 document.
+ *
+ * HTTP verb derivation (SPEC §5): `safe → GET`, `!safe → POST`.
+ * - **GET**: domain params appear as query-string `parameters`.
+ * - **POST**: domain params are wrapped in a `requestBody` (`application/json`).
+ *
+ * The `input` and `output` JSON-Schema fragments are passed through verbatim
+ * (OpenAPI 3.1 natively supports JSON Schema 2020-12).
+ *
+ * @param operations - The canonical operations array from the merged descriptor.
+ * @param opts       - Optional document-level metadata (title, version).
+ * @returns A standards-conformant OpenAPI 3.1 document.
+ *
+ * @example
+ * ```ts
+ * const doc = toOpenApi(descriptor.operations, { title: 'My API', version: '1.0.0' })
+ * // doc.openapi === '3.1.0'
+ * // doc.paths['/transform/humanize/humanize-bytes']['post'] → { operationId, … }
+ * ```
+ */
+export declare function toOpenApi(operations: Operation[], opts?: ToOpenApiOptions): OpenApiDocument;

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@adhd/apigen-codegen-openapi",
+  "version": "0.1.0",
+  "main": "./index.js",
+  "module": "./index.mjs",
+  "typings": "./index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  }
+}