@cognisivelabs/openapi-to-express 0.1.0

package/dist/generate.js

@@ -0,0 +1,144 @@
+/**
+ * Main generation orchestrator.
+ *
+ * Reads an OpenAPI spec, classifies schemas, and writes all generated files
+ * into the target directory with configurable folder names.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join, resolve, extname } from "node:path";
+import YAML from "yaml";
+import { parseSpec, classifySchemas } from "./parser/spec-parser.js";
+import { generateTypesFile } from "./generators/types-generator.js";
+import { generateControllerInterface } from "./generators/controller-generator.js";
+import { generateExpressRoutes } from "./generators/routes-express-generator.js";
+const HEADER = `// ============================================================================
+// AUTO-GENERATED by openapi-to-express — do not edit manually.
+// Regenerate with: npm run generate
+// ============================================================================
+
+`;
+const DEFAULT_DIRS = {
+    types: "types",
+    controllers: "controllers",
+    routes: "routes",
+};
+function parseSpecContent(raw, hint) {
+    const trimmed = raw.trimStart();
+    // Try JSON first if it looks like JSON or hint says so
+    if (trimmed.startsWith("{") || hint === ".json") {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // Fall through to YAML
+        }
+    }
+    // Try YAML (also handles JSON since JSON is valid YAML)
+    try {
+        return YAML.parse(raw);
+    }
+    catch {
+        throw new Error("Failed to parse input as JSON or YAML.");
+    }
+}
+async function resolveInput(input) {
+    // URL
+    if (input.startsWith("http://") || input.startsWith("https://")) {
+        const res = await fetch(input);
+        if (!res.ok)
+            throw new Error(`Failed to fetch spec from ${input}: ${res.status} ${res.statusText}`);
+        const raw = await res.text();
+        return parseSpecContent(raw, extname(new URL(input).pathname));
+    }
+    // File path
+    const filePath = resolve(input);
+    if (existsSync(filePath)) {
+        const raw = readFileSync(filePath, "utf-8");
+        return parseSpecContent(raw, extname(filePath));
+    }
+    // String content (JSON or YAML)
+    const trimmed = input.trimStart();
+    if (trimmed.startsWith("{") || trimmed.startsWith("openapi")) {
+        return parseSpecContent(input);
+    }
+    throw new Error(`Cannot resolve input: "${input}" is not a valid file path, URL, or JSON/YAML string.`);
+}
+export async function generate(options) {
+    const outDir = resolve(options.output);
+    const dirs = { ...DEFAULT_DIRS, ...options.dirs };
+    const dryRun = options.dryRun ?? false;
+    const spec = await resolveInput(options.input);
+    const parsed = parseSpec(spec);
+    const { common, perTag } = classifySchemas(parsed.byTag, parsed.schemas);
+    const commonSet = new Set(common);
+    if (!dryRun) {
+        mkdirSync(join(outDir, dirs.types), { recursive: true });
+        mkdirSync(join(outDir, dirs.controllers), { recursive: true });
+        mkdirSync(join(outDir, dirs.routes), { recursive: true });
+    }
+    const AUTO_GENERATED_MARKER = "AUTO-GENERATED by openapi-to-express";
+    let totalFiles = 0;
+    let skippedFiles = 0;
+    const filesPerDir = new Map();
+    function write(dir, name, content) {
+        const filePath = join(outDir, dir, name);
+        // Overwrite protection: skip files that exist but don't have our marker
+        if (!dryRun && existsSync(filePath)) {
+            const existing = readFileSync(filePath, "utf-8");
+            if (!existing.includes(AUTO_GENERATED_MARKER)) {
+                console.log(`  ${dir}/${name} (skipped — manually modified)`);
+                skippedFiles++;
+                return;
+            }
+        }
+        if (!dryRun) {
+            writeFileSync(filePath, HEADER + content, "utf-8");
+        }
+        const list = filesPerDir.get(dir) ?? [];
+        list.push(name);
+        filesPerDir.set(dir, list);
+        console.log(`  ${dir}/${name}`);
+        totalFiles++;
+    }
+    // 1. Common types (only if shared schemas exist)
+    if (common.length > 0) {
+        const { content } = generateTypesFile(common, parsed.schemas, new Set());
+        write(dirs.types, "common.types.ts", content);
+    }
+    // 2. Per-tag files
+    for (const [tag, operations] of parsed.byTag) {
+        const tagLower = tag.toLowerCase();
+        const tagSchemas = (perTag.get(tag) ?? []).sort();
+        // Types
+        const { content, imports } = generateTypesFile(tagSchemas, parsed.schemas, commonSet);
+        let typesContent = "";
+        if (imports.length > 0) {
+            typesContent += `import type { ${imports.join(", ")} } from "./common.types";\n\n`;
+        }
+        typesContent += content;
+        // Ensure file is a valid module even if no schemas were generated
+        if (!typesContent.trim()) {
+            typesContent = "export {};\n";
+        }
+        write(dirs.types, `${tagLower}.types.ts`, typesContent);
+        // Controller interface
+        write(dirs.controllers, `${tagLower}.controller.interface.ts`, generateControllerInterface(tag, operations));
+        // Routes
+        write(dirs.routes, `${tagLower}.routes.ts`, generateExpressRoutes(tag, operations, dirs));
+    }
+    // 3. Barrel (index.ts) files per directory
+    for (const [dir, files] of filesPerDir) {
+        const exports = files
+            .map((f) => `export * from "./${f.replace(/\.ts$/, "")}";`)
+            .join("\n");
+        write(dir, "index.ts", exports + "\n");
+    }
+    const prefix = dryRun ? "Would generate" : "Generated";
+    let summary = `\n${prefix} ${totalFiles} files from ${parsed.byTag.size} tag(s)` +
+        (common.length > 0 ? ` (${common.length} shared types in common.types.ts)` : "");
+    if (skippedFiles > 0) {
+        summary += ` — ${skippedFiles} file(s) skipped (manually modified)`;
+    }
+    console.log(summary + ".");
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/generators/controller-generator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates controller interface files from parsed operations.
+ *
+ * The controller owns the HTTP layer — it receives Request/Response
+ * and is responsible for param extraction, response formatting, and error handling.
+ */
+import type { OperationInfo } from "../parser/spec-parser.js";
+export declare function generateControllerInterface(tag: string, operations: OperationInfo[]): string;

package/dist/generators/controller-generator.js

@@ -0,0 +1,33 @@
+/**
+ * Generates controller interface files from parsed operations.
+ *
+ * The controller owns the HTTP layer — it receives Request/Response
+ * and is responsible for param extraction, response formatting, and error handling.
+ */
+import { toPascalCase, toMethodName, toJsDocLines } from "../utils/strings.js";
+export function generateControllerInterface(tag, operations) {
+    const interfaceName = `${toPascalCase(tag)}Controller`;
+    const lines = [];
+    lines.push(`import type { Request, Response } from "express";`);
+    lines.push("");
+    lines.push(`export interface ${interfaceName} {`);
+    for (const op of operations) {
+        const methodName = toMethodName(op.operationId);
+        if (op.summary || op.description || op.deprecated) {
+            lines.push(`  /**`);
+            if (op.summary)
+                lines.push(...toJsDocLines(op.summary));
+            if (op.summary && op.description)
+                lines.push(`   *`);
+            if (op.description)
+                lines.push(...toJsDocLines(op.description));
+            if (op.deprecated)
+                lines.push(`   * @deprecated`);
+            lines.push(`   */`);
+        }
+        lines.push(`  ${methodName}(req: Request, res: Response): Promise<void>;`);
+    }
+    lines.push(`}`, "");
+    return lines.join("\n");
+}
+//# sourceMappingURL=controller-generator.js.map

package/dist/generators/controller-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-generator.js","sourceRoot":"","sources":["../../src/generators/controller-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,UAAU,2BAA2B,CACzC,GAAW,EACX,UAA2B;IAE3B,MAAM,aAAa,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,oBAAoB,aAAa,IAAI,CAAC,CAAC;IAClD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,YAAY,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,EAAE,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,EAAE,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,IAAI,EAAE,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,+CAA+C,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/generators/routes-express-generator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generates lean Express router files — one line per endpoint.
+ *
+ * Routes are pure wiring: HTTP method + path → controller method.
+ * The controller handles param extraction, response formatting, and errors.
+ */
+import type { OperationInfo } from "../parser/spec-parser.js";
+import type { DirectoryConfig } from "../generate.js";
+export declare function generateExpressRoutes(tag: string, operations: OperationInfo[], dirs: DirectoryConfig): string;

package/dist/generators/routes-express-generator.js

@@ -0,0 +1,39 @@
+/**
+ * Generates lean Express router files — one line per endpoint.
+ *
+ * Routes are pure wiring: HTTP method + path → controller method.
+ * The controller handles param extraction, response formatting, and errors.
+ */
+import { computeRelativeImport } from "../utils/paths.js";
+import { toPascalCase, toMethodName } from "../utils/strings.js";
+function toExpressPath(path) {
+    return path.replace(/\{(\w+)\}/g, ":$1");
+}
+export function generateExpressRoutes(tag, operations, dirs) {
+    const pascalTag = toPascalCase(tag);
+    const interfaceName = `${pascalTag}Controller`;
+    const tagLower = tag.toLowerCase();
+    const toControllers = computeRelativeImport(dirs.routes, dirs.controllers);
+    const lines = [
+        `import { Router } from "express";`,
+        `import type { ${interfaceName} } from "${toControllers}/${tagLower}.controller.interface";`,
+        ``,
+        `export function create${pascalTag}Router(controller: ${interfaceName}, middleware?: any[]): Router {`,
+        `  const router = Router();`,
+        ``,
+        `  if (middleware) {`,
+        `    middleware.forEach((mw) => router.use(mw));`,
+        `  }`,
+        ``,
+    ];
+    for (const op of operations) {
+        const expressPath = toExpressPath(op.path);
+        const methodName = toMethodName(op.operationId);
+        lines.push(`  router.${op.method}("${expressPath}", (req, res) => controller.${methodName}(req, res));`);
+    }
+    lines.push(``);
+    lines.push(`  return router;`);
+    lines.push(`}`, "");
+    return lines.join("\n");
+}
+//# sourceMappingURL=routes-express-generator.js.map

package/dist/generators/routes-express-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-express-generator.js","sourceRoot":"","sources":["../../src/generators/routes-express-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEjE,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,GAAW,EACX,UAA2B,EAC3B,IAAqB;IAErB,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,aAAa,GAAG,GAAG,SAAS,YAAY,CAAC;IAC/C,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAE3E,MAAM,KAAK,GAAG;QACZ,mCAAmC;QACnC,iBAAiB,aAAa,YAAY,aAAa,IAAI,QAAQ,yBAAyB;QAC5F,EAAE;QACF,yBAAyB,SAAS,sBAAsB,aAAa,iCAAiC;QACtG,4BAA4B;QAC5B,EAAE;QACF,qBAAqB;QACrB,iDAAiD;QACjD,KAAK;QACL,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,KAAK,WAAW,+BAA+B,UAAU,cAAc,CAAC,CAAC;IAC3G,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/generators/types-generator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates plain TypeScript interfaces from OpenAPI component schemas.
+ *
+ * Supports:
+ *   - type: "object" with properties
+ *   - allOf (intersection / extends)
+ *   - oneOf / anyOf (union types)
+ *   - $ref, enum, array, primitives
+ *   - nullable
+ */
+export declare function generateTypesFile(schemaNames: string[], allSchemas: Record<string, any>, definedElsewhere: Set<string>): {
+    content: string;
+    imports: string[];
+};

package/dist/generators/types-generator.js

@@ -0,0 +1,240 @@
+/**
+ * Generates plain TypeScript interfaces from OpenAPI component schemas.
+ *
+ * Supports:
+ *   - type: "object" with properties
+ *   - allOf (intersection / extends)
+ *   - oneOf / anyOf (union types)
+ *   - $ref, enum, array, primitives
+ *   - nullable
+ */
+import { refToTypeName, collectRefsFromSchema } from "../parser/spec-parser.js";
+import { capitalize, enumKeyFromValue, safePropertyName, escapeJsDoc } from "../utils/strings.js";
+function toTsType(schema) {
+    if (!schema)
+        return "unknown";
+    if (schema.$ref)
+        return refToTypeName(schema.$ref);
+    if (schema.enum)
+        return schema.enum.map((v) => typeof v === "string" ? `"${v}"` : String(v)).join(" | ");
+    if (schema.oneOf)
+        return schema.oneOf.map((s) => toTsType(s)).join(" | ");
+    if (schema.anyOf)
+        return schema.anyOf.map((s) => toTsType(s)).join(" | ");
+    if (schema.allOf)
+        return schema.allOf.map((s) => toTsType(s)).join(" & ");
+    if (schema.type === "string")
+        return "string";
+    if (schema.type === "integer" || schema.type === "number")
+        return "number";
+    if (schema.type === "boolean")
+        return "boolean";
+    if (schema.type === "array")
+        return `${toTsType(schema.items)}[]`;
+    if (schema.type === "object" && schema.properties) {
+        const required = new Set(schema.required ?? []);
+        const fields = Object.entries(schema.properties)
+            .map(([k, v]) => `${safePropertyName(k)}${required.has(k) ? "" : "?"}: ${toTsType(v)}`)
+            .join("; ");
+        return `{ ${fields} }`;
+    }
+    if (schema.type === "object" && schema.additionalProperties) {
+        const valType = schema.additionalProperties === true ? "unknown" : toTsType(schema.additionalProperties);
+        return `Record<string, ${valType}>`;
+    }
+    if (schema.type === "object")
+        return "Record<string, unknown>";
+    return "unknown";
+}
+function addNullable(tsType, schema) {
+    if (schema.nullable)
+        return `${tsType} | null`;
+    return tsType;
+}
+/**
+ * Determines if a schema is a composition type (allOf/oneOf/anyOf at the top level
+ * without its own properties) and should be generated as a type alias rather than interface.
+ */
+function isTypeAlias(schema) {
+    if (schema.oneOf || schema.anyOf)
+        return true;
+    if (schema.allOf) {
+        // If any sub-schema has properties, this is "extends" → interface, not type alias
+        const hasInlineProperties = schema.properties || schema.allOf.some((s) => s.properties);
+        return !hasInlineProperties;
+    }
+    return false;
+}
+/**
+ * For allOf schemas that mix $ref with inline properties, collect all inline properties
+ * and all $ref base types. This is the "extends" pattern:
+ *   allOf:
+ *     - $ref: "#/components/schemas/Base"
+ *     - type: object
+ *       properties: { extra: ... }
+ */
+function decomposeAllOf(schema) {
+    const bases = [];
+    let properties = {};
+    let required = [];
+    for (const sub of schema.allOf) {
+        if (sub.$ref) {
+            bases.push(refToTypeName(sub.$ref));
+        }
+        else if (sub.properties || sub.type === "object") {
+            properties = { ...properties, ...sub.properties };
+            required = [...required, ...(sub.required ?? [])];
+        }
+    }
+    // Also merge top-level properties if present alongside allOf
+    if (schema.properties) {
+        properties = { ...properties, ...schema.properties };
+        required = [...required, ...(schema.required ?? [])];
+    }
+    return { bases, properties, required };
+}
+export function generateTypesFile(schemaNames, allSchemas, definedElsewhere) {
+    const defined = new Set(schemaNames);
+    const imports = new Set();
+    const lines = [];
+    const enums = [];
+    for (const name of schemaNames.sort()) {
+        const schema = allSchemas[name];
+        if (!schema)
+            continue;
+        // Collect all referenced types to determine imports
+        const refs = new Set();
+        collectRefsFromSchema(schema, refs);
+        for (const ref of refs) {
+            if (!defined.has(ref) && definedElsewhere.has(ref)) {
+                imports.add(ref);
+            }
+        }
+        // --- Type alias: oneOf / anyOf / pure allOf ---
+        if (isTypeAlias(schema)) {
+            const discriminator = schema.discriminator?.propertyName;
+            if (schema.description && !discriminator) {
+                lines.push(`/** ${escapeJsDoc(schema.description)} */`);
+            }
+            else if (schema.description || discriminator) {
+                lines.push(`/**`);
+                if (schema.description)
+                    lines.push(` * ${escapeJsDoc(schema.description)}`);
+                if (discriminator)
+                    lines.push(` * @discriminator ${discriminator}`);
+                lines.push(` */`);
+            }
+            if (schema.allOf && !schema.properties) {
+                const parts = schema.allOf.map((s) => toTsType(s));
+                lines.push(`export type ${name} = ${parts.join(" & ")};`);
+            }
+            else if (schema.oneOf) {
+                const parts = schema.oneOf.map((s) => toTsType(s));
+                lines.push(`export type ${name} = ${parts.join(" | ")};`);
+            }
+            else if (schema.anyOf) {
+                const parts = schema.anyOf.map((s) => toTsType(s));
+                lines.push(`export type ${name} = ${parts.join(" | ")};`);
+            }
+            lines.push("");
+            continue;
+        }
+        // --- Interface: object with properties, or allOf with inline properties ---
+        let properties = {};
+        let required = new Set();
+        let extendsClause = "";
+        if (schema.allOf) {
+            const decomposed = decomposeAllOf(schema);
+            properties = decomposed.properties;
+            required = new Set(decomposed.required);
+            if (decomposed.bases.length > 0) {
+                extendsClause = ` extends ${decomposed.bases.join(", ")}`;
+            }
+        }
+        else if (schema.type === "object" || schema.properties) {
+            properties = schema.properties ?? {};
+            required = new Set(schema.required ?? []);
+        }
+        else {
+            // Primitive type alias: type: string, enum, array, etc.
+            if (schema.description) {
+                lines.push(`/** ${escapeJsDoc(schema.description)} */`);
+            }
+            const tsType = toTsType(schema);
+            lines.push(`export type ${name} = ${tsType};`);
+            lines.push("");
+            continue;
+        }
+        if (schema.description || schema.deprecated) {
+            if (schema.description && !schema.deprecated) {
+                lines.push(`/** ${escapeJsDoc(schema.description)} */`);
+            }
+            else {
+                lines.push(`/**`);
+                if (schema.description)
+                    lines.push(` * ${escapeJsDoc(schema.description)}`);
+                if (schema.deprecated)
+                    lines.push(` * @deprecated`);
+                lines.push(` */`);
+            }
+        }
+        lines.push(`export interface ${name}${extendsClause} {`);
+        for (const [prop, propDef] of Object.entries(properties)) {
+            const optional = required.has(prop) ? "" : "?";
+            let tsType;
+            if (propDef.enum) {
+                // Generate a named enum const — use InterfaceProp naming
+                const enumName = `${name}${capitalize(prop)}`;
+                enums.push({ name: enumName, values: propDef.enum });
+                tsType = enumName;
+            }
+            else {
+                tsType = toTsType(propDef);
+            }
+            tsType = addNullable(tsType, propDef);
+            // JSDoc: description + annotations
+            const docParts = [];
+            if (propDef.description)
+                docParts.push(escapeJsDoc(propDef.description));
+            if (propDef.format)
+                docParts.push(`@format ${propDef.format}`);
+            if (propDef.readOnly)
+                docParts.push(`@readonly`);
+            if (propDef.writeOnly)
+                docParts.push(`@writeOnly`);
+            if (propDef.default !== undefined) {
+                const defaultVal = typeof propDef.default === "string" ? `"${propDef.default}"` : String(propDef.default);
+                docParts.push(`@default ${defaultVal}`);
+            }
+            if (propDef.deprecated)
+                docParts.push(`@deprecated`);
+            if (docParts.length === 1) {
+                lines.push(`  /** ${docParts[0]} */`);
+            }
+            else if (docParts.length > 1) {
+                lines.push(`  /**`);
+                for (const part of docParts)
+                    lines.push(`   * ${part}`);
+                lines.push(`   */`);
+            }
+            lines.push(`  ${safePropertyName(prop)}${optional}: ${tsType};`);
+        }
+        lines.push(`}`, "");
+    }
+    // Append enum const objects
+    if (enums.length > 0) {
+        for (const e of enums) {
+            lines.push(`export const ${e.name} = {`);
+            for (const val of e.values) {
+                const key = typeof val === "string" ? enumKeyFromValue(val) : `Value${val}`;
+                const literal = typeof val === "string" ? `"${val}"` : String(val);
+                lines.push(`  ${key}: ${literal},`);
+            }
+            lines.push(`} as const;`);
+            lines.push(`export type ${e.name} = (typeof ${e.name})[keyof typeof ${e.name}];`);
+            lines.push("");
+        }
+    }
+    return { content: lines.join("\n"), imports: Array.from(imports).sort() };
+}
+//# sourceMappingURL=types-generator.js.map

package/dist/generators/types-generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { generate } from "./generate.js";
+export type { GenerateOptions, DirectoryConfig } from "./generate.js";
+export { loadConfig } from "./config.js";
+export type { ConfigFile } from "./config.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { generate } from "./generate.js";
+export { loadConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/parser/spec-parser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Parses an OpenAPI 3.x spec and extracts structured data for code generation.
+ */
+export interface ParamInfo {
+    name: string;
+    in: "path" | "query" | "header";
+    required: boolean;
+    type: string;
+}
+export interface OperationInfo {
+    path: string;
+    method: string;
+    operationId: string;
+    requestType: string | null;
+    requestRequired: boolean;
+    responseType: string;
+    errorTypes: {
+        status: string;
+        type: string;
+    }[];
+    tag: string;
+    pathParams: ParamInfo[];
+    queryParams: ParamInfo[];
+    headerParams: ParamInfo[];
+    summary?: string;
+    description?: string;
+    deprecated?: boolean;
+}
+export interface ParsedSpec {
+    operations: OperationInfo[];
+    schemas: Record<string, any>;
+    byTag: Map<string, OperationInfo[]>;
+}
+export declare function refToTypeName(ref: string): string;
+export declare function parseSpec(spec: any): ParsedSpec;
+/**
+ * Collect all $ref type names from a schema node (non-recursive into schemas map).
+ */
+export declare function collectRefsFromSchema(schema: any, refs: Set<string>): void;
+/**
+ * Walk a named schema recursively through the schemas map, collecting
+ * all transitively referenced schema names.
+ */
+export declare function walkSchemaRefs(name: string, schemas: Record<string, any>, collected: Set<string>): void;
+/**
+ * Classify schemas into common (multi-tag) vs tag-specific.
+ */
+export declare function classifySchemas(byTag: Map<string, OperationInfo[]>, schemas: Record<string, any>): {
+    common: string[];
+    perTag: Map<string, string[]>;
+};