@cognisivelabs/openapi-to-express 0.1.0

package/dist/parser/spec-parser.js

@@ -0,0 +1,216 @@
+/**
+ * Parses an OpenAPI 3.x spec and extracts structured data for code generation.
+ */
+import { toPascalCase } from "../utils/strings.js";
+export function refToTypeName(ref) {
+    const raw = ref.split("/").pop();
+    return toPascalCase(raw);
+}
+function schemaTypeToTs(schema) {
+    if (!schema)
+        return "string";
+    if (schema.type === "integer" || schema.type === "number")
+        return "number";
+    if (schema.type === "boolean")
+        return "boolean";
+    if (schema.type === "array")
+        return `${schemaTypeToTs(schema.items)}[]`;
+    return "string";
+}
+function resolveParam(p, spec) {
+    if (p.$ref) {
+        // Use raw name (not PascalCased) — parameter keys aren't schema names
+        const rawName = p.$ref.split("/").pop();
+        return spec.components?.parameters?.[rawName] ?? p;
+    }
+    return p;
+}
+function extractParams(operation, pathItem, spec) {
+    const pathParams = pathItem.parameters ?? [];
+    const opParams = operation.parameters ?? [];
+    const merged = new Map();
+    for (const p of pathParams) {
+        const resolved = resolveParam(p, spec);
+        merged.set(`${resolved.in}:${resolved.name}`, resolved);
+    }
+    for (const p of opParams) {
+        const resolved = resolveParam(p, spec);
+        merged.set(`${resolved.in}:${resolved.name}`, resolved);
+    }
+    return Array.from(merged.values())
+        .filter((p) => p.in === "path" || p.in === "query" || p.in === "header")
+        .map((p) => ({
+        name: p.name,
+        in: p.in,
+        required: p.required ?? p.in === "path",
+        type: schemaTypeToTs(p.schema),
+    }));
+}
+function resolveSchema(schema, operationId, suffix, schemas) {
+    if (!schema)
+        return null;
+    if (schema.$ref)
+        return refToTypeName(schema.$ref);
+    // Inline schema — generate a name and register it
+    if (schema.type === "object" || schema.properties || schema.allOf || schema.oneOf || schema.anyOf) {
+        const name = `${toPascalCase(operationId)}${suffix}`;
+        schemas[name] = schema;
+        return name;
+    }
+    return null;
+}
+export function parseSpec(spec) {
+    const operations = [];
+    // Sanitize schema names to valid PascalCase identifiers
+    const rawSchemas = spec.components?.schemas ?? {};
+    const schemas = {};
+    for (const [name, schema] of Object.entries(rawSchemas)) {
+        schemas[toPascalCase(name)] = schema;
+    }
+    const HTTP_METHODS = new Set(["get", "put", "post", "delete", "options", "head", "patch", "trace"]);
+    const SUCCESS_CODES = ["200", "201", "202", "204"];
+    for (const [path, pathItem] of Object.entries(spec.paths ?? {})) {
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (!HTTP_METHODS.has(method))
+                continue;
+            if (!operation.operationId)
+                continue;
+            const tag = operation.tags?.[0] ?? "Default";
+            let requestType = null;
+            let requestRequired = true;
+            if (operation.requestBody) {
+                const bodySchema = operation.requestBody.content?.["application/json"]?.schema;
+                requestType = resolveSchema(bodySchema, operation.operationId, "Request", schemas);
+                requestRequired = operation.requestBody.required ?? false;
+            }
+            let responseType = "void";
+            for (const code of SUCCESS_CODES) {
+                const response = operation.responses?.[code];
+                if (response) {
+                    if (code === "204") {
+                        // 204 No Content — void return, no body
+                        responseType = "void";
+                        break;
+                    }
+                    const respSchema = response.content?.["application/json"]?.schema;
+                    const resolved = resolveSchema(respSchema, operation.operationId, "Response", schemas);
+                    if (resolved) {
+                        responseType = resolved;
+                        break;
+                    }
+                }
+            }
+            // Extract error response types (4xx, 5xx)
+            const errorTypes = [];
+            for (const [code, resp] of Object.entries(operation.responses ?? {})) {
+                if (code.startsWith("4") || code.startsWith("5")) {
+                    const errSchema = resp.content?.["application/json"]?.schema;
+                    const errType = resolveSchema(errSchema, operation.operationId, `Error${code}`, schemas);
+                    if (errType) {
+                        errorTypes.push({ status: code, type: errType });
+                    }
+                }
+            }
+            const allParams = extractParams(operation, pathItem, spec);
+            const pathParams = allParams.filter((p) => p.in === "path");
+            const queryParams = allParams.filter((p) => p.in === "query");
+            const headerParams = allParams.filter((p) => p.in === "header");
+            operations.push({
+                path, method, operationId: operation.operationId,
+                requestType, requestRequired, responseType, errorTypes, tag,
+                pathParams, queryParams, headerParams,
+                summary: operation.summary,
+                description: operation.description,
+                deprecated: operation.deprecated ?? false,
+            });
+        }
+    }
+    const byTag = new Map();
+    for (const op of operations) {
+        const ops = byTag.get(op.tag) ?? [];
+        ops.push(op);
+        byTag.set(op.tag, ops);
+    }
+    return {
+        operations,
+        schemas,
+        byTag,
+    };
+}
+/**
+ * Collect all $ref type names from a schema node (non-recursive into schemas map).
+ */
+export function collectRefsFromSchema(schema, refs) {
+    if (!schema)
+        return;
+    if (schema.$ref)
+        refs.add(refToTypeName(schema.$ref));
+    if (schema.items)
+        collectRefsFromSchema(schema.items, refs);
+    for (const key of ["allOf", "oneOf", "anyOf"]) {
+        if (schema[key]) {
+            for (const sub of schema[key])
+                collectRefsFromSchema(sub, refs);
+        }
+    }
+    if (schema.additionalProperties && typeof schema.additionalProperties === "object") {
+        collectRefsFromSchema(schema.additionalProperties, refs);
+    }
+    for (const propDef of Object.values(schema.properties ?? {})) {
+        collectRefsFromSchema(propDef, refs);
+    }
+}
+/**
+ * Walk a named schema recursively through the schemas map, collecting
+ * all transitively referenced schema names.
+ */
+export function walkSchemaRefs(name, schemas, collected) {
+    if (collected.has(name))
+        return;
+    collected.add(name);
+    const schema = schemas[name];
+    if (!schema)
+        return;
+    const refs = new Set();
+    collectRefsFromSchema(schema, refs);
+    for (const ref of refs) {
+        walkSchemaRefs(ref, schemas, collected);
+    }
+}
+/**
+ * Classify schemas into common (multi-tag) vs tag-specific.
+ */
+export function classifySchemas(byTag, schemas) {
+    const schemaToTags = new Map();
+    for (const [tag, operations] of byTag) {
+        const tagSchemas = new Set();
+        for (const op of operations) {
+            if (op.requestType)
+                walkSchemaRefs(op.requestType, schemas, tagSchemas);
+            if (op.responseType !== "void")
+                walkSchemaRefs(op.responseType, schemas, tagSchemas);
+            for (const err of op.errorTypes)
+                walkSchemaRefs(err.type, schemas, tagSchemas);
+        }
+        for (const schema of tagSchemas) {
+            const tags = schemaToTags.get(schema) ?? new Set();
+            tags.add(tag);
+            schemaToTags.set(schema, tags);
+        }
+    }
+    const common = [];
+    const perTag = new Map();
+    for (const [schema, tags] of schemaToTags) {
+        if (tags.size > 1) {
+            common.push(schema);
+        }
+        else {
+            const tag = [...tags][0];
+            const list = perTag.get(tag) ?? [];
+            list.push(schema);
+            perTag.set(tag, list);
+        }
+    }
+    return { common: common.sort(), perTag };
+}
+//# sourceMappingURL=spec-parser.js.map

package/dist/parser/spec-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.js","sourceRoot":"","sources":["../../src/parser/spec-parser.ts"],"names":[],"mappings":"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"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compute a relative import path from one directory to another.
+ *
+ * Example: computeRelativeImport("controllers", "types") → "../types"
+ *          computeRelativeImport("src/controllers", "src/types") → "../types"
+ *          computeRelativeImport("types", "types") → "."
+ */
+export declare function computeRelativeImport(fromDir: string, toDir: string): string;

package/dist/utils/paths.js

@@ -0,0 +1,17 @@
+import { relative, posix } from "node:path";
+/**
+ * Compute a relative import path from one directory to another.
+ *
+ * Example: computeRelativeImport("controllers", "types") → "../types"
+ *          computeRelativeImport("src/controllers", "src/types") → "../types"
+ *          computeRelativeImport("types", "types") → "."
+ */
+export function computeRelativeImport(fromDir, toDir) {
+    const rel = relative(fromDir, toDir).split("\\").join(posix.sep);
+    if (rel === "")
+        return ".";
+    if (!rel.startsWith("."))
+        return `./${rel}`;
+    return rel;
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,KAAa;IAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,GAAG,EAAE,CAAC;IAC5C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/strings.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared string utilities.
+ */
+export declare function capitalize(s: string): string;
+/**
+ * Convert a string to PascalCase.
+ * "repos" → "Repos", "pull-requests" → "PullRequests", "code_scanning" → "CodeScanning"
+ */
+export declare function toPascalCase(s: string): string;
+/**
+ * Convert an operationId to a valid JS identifier.
+ * "repos/list-for-org" → "reposListForOrg"
+ * "get-user" → "getUser"
+ * "get.user.by-id_v2" → "getUserByIdV2"
+ */
+export declare function toMethodName(operationId: string): string;
+/**
+ * Escape `* /` sequences that would break JSDoc comments.
+ */
+export declare function escapeJsDoc(text: string): string;
+/**
+ * Sanitize a description for JSDoc — handle multi-line content.
+ * Returns lines with `   * ` prefix (indented for interface methods).
+ */
+export declare function toJsDocLines(text: string): string[];
+/**
+ * Quote a property name if it's not a valid JS identifier.
+ */
+export declare function safePropertyName(name: string): string;
+export declare function enumKeyFromValue(value: any): string;

package/dist/utils/strings.js

@@ -0,0 +1,68 @@
+/**
+ * Shared string utilities.
+ */
+export function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * Convert a string to PascalCase.
+ * "repos" → "Repos", "pull-requests" → "PullRequests", "code_scanning" → "CodeScanning"
+ */
+export function toPascalCase(s) {
+    return s
+        .split(/[_\-\s\/\.]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+/**
+ * Convert an operationId to a valid JS identifier.
+ * "repos/list-for-org" → "reposListForOrg"
+ * "get-user" → "getUser"
+ * "get.user.by-id_v2" → "getUserByIdV2"
+ */
+export function toMethodName(operationId) {
+    const parts = operationId.split(/[\/\-_\.\s]+/).filter(Boolean);
+    if (parts.length === 0)
+        return operationId;
+    return parts[0] + parts.slice(1).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
+}
+/**
+ * Escape `* /` sequences that would break JSDoc comments.
+ */
+export function escapeJsDoc(text) {
+    return text.replace(/\*\//g, "*\\/");
+}
+/**
+ * Sanitize a description for JSDoc — handle multi-line content.
+ * Returns lines with `   * ` prefix (indented for interface methods).
+ */
+export function toJsDocLines(text) {
+    return escapeJsDoc(text).split("\n").map((line) => `   * ${line}`);
+}
+/**
+ * Check if a string is a valid JS identifier (can be used unquoted as a property name).
+ */
+function isValidIdentifier(s) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(s);
+}
+/**
+ * Quote a property name if it's not a valid JS identifier.
+ */
+export function safePropertyName(name) {
+    return isValidIdentifier(name) ? name : `"${name}"`;
+}
+export function enumKeyFromValue(value) {
+    const str = String(value);
+    const cleaned = str
+        .replace(/[^a-zA-Z0-9_]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    if (!cleaned || /^[0-9]/.test(cleaned)) {
+        return `Value_${cleaned || str.replace(/[^a-zA-Z0-9]/g, "")}`;
+    }
+    return cleaned
+        .split("_")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+        .join("");
+}
+//# sourceMappingURL=strings.js.map

package/dist/utils/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC;SACL,KAAK,CAAC,cAAc,CAAC;SACrB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAU;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,GAAG;SAChB,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,OAAO,SAAS,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,OAAO;SACX,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@cognisivelabs/openapi-to-express",
+  "version": "0.1.0",
+  "description": "Generate Express routes, controller interfaces, and TypeScript types from an OpenAPI spec. Design-first API development.",
+  "author": "Sachin Gupta",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cognisivelabs/openapi-to-express"
+  },
+  "homepage": "https://github.com/cognisivelabs/openapi-to-express#readme",
+  "bugs": {
+    "url": "https://github.com/cognisivelabs/openapi-to-express/issues"
+  },
+  "keywords": [
+    "openapi",
+    "express",
+    "codegen",
+    "typescript",
+    "design-first",
+    "contract-first",
+    "api",
+    "code-generator",
+    "routes",
+    "controller"
+  ],
+  "bin": {
+    "openapi-to-express": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc && chmod +x dist/cli.js",
+    "test": "node --import tsx --test tests/**/*.test.ts",
+    "dev": "tsx src/cli.ts",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  }
+}