@cerios/openapi-to-zod 0.6.0 → 1.0.0

package/dist/cli.mjs

@@ -5016,6 +5016,125 @@ var init_errors = __esm({
   }
 });
 
+// src/batch-executor.ts
+async function processSpec(spec, index, total, createGenerator) {
+  const specInput = spec.input || "spec";
+  const specOutput = spec.output || "output";
+  console.log(`Processing [${index + 1}/${total}] ${specInput}...`);
+  try {
+    const generator = createGenerator(spec);
+    generator.generate();
+    return {
+      spec,
+      success: true
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(`\u2717 Failed to generate ${specOutput}: ${errorMessage}`);
+    return {
+      spec,
+      success: false,
+      error: errorMessage
+    };
+  }
+}
+async function executeParallel(specs, createGenerator, batchSize) {
+  console.log(`
+Executing ${specs.length} specification(s) in parallel (batch size: ${batchSize})...
+`);
+  const results = [];
+  for (let i = 0; i < specs.length; i += batchSize) {
+    const batch = specs.slice(i, Math.min(i + batchSize, specs.length));
+    const batchPromises = batch.map(
+      (spec, batchIndex) => processSpec(spec, i + batchIndex, specs.length, createGenerator)
+    );
+    const batchResults = await Promise.allSettled(batchPromises);
+    for (let j = 0; j < batchResults.length; j++) {
+      const result = batchResults[j];
+      if (result.status === "fulfilled") {
+        results.push(result.value);
+      } else {
+        results.push({
+          spec: batch[j],
+          success: false,
+          error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+        });
+      }
+    }
+  }
+  return results;
+}
+async function executeSequential(specs, createGenerator) {
+  console.log(`
+Executing ${specs.length} spec(s) sequentially...
+`);
+  const results = [];
+  for (let i = 0; i < specs.length; i++) {
+    const result = await processSpec(specs[i], i, specs.length, createGenerator);
+    results.push(result);
+  }
+  return results;
+}
+function printSummary(summary) {
+  console.log(`
+${"=".repeat(50)}`);
+  console.log("Batch Execution Summary");
+  console.log("=".repeat(50));
+  console.log(`Total specs: ${summary.total}`);
+  console.log(`Successful: ${summary.successful}`);
+  console.log(`Failed: ${summary.failed}`);
+  if (summary.failed > 0) {
+    console.log("\nFailed specs:");
+    for (const result of summary.results) {
+      if (!result.success) {
+        const specInput = result.spec.input || "spec";
+        console.error(`  \u2717 ${specInput}`);
+        console.error(`    Error: ${result.error}`);
+      }
+    }
+  }
+  console.log(`${"=".repeat(50)}
+`);
+}
+async function executeBatch(specs, executionMode = "parallel", createGenerator, batchSize) {
+  if (specs.length === 0) {
+    throw new ConfigurationError("No specs provided for batch execution", { specsCount: 0, executionMode });
+  }
+  let results = [];
+  try {
+    results = executionMode === "parallel" ? await executeParallel(specs, createGenerator, batchSize) : await executeSequential(specs, createGenerator);
+    const summary = {
+      total: results.length,
+      successful: results.filter((r) => r.success).length,
+      failed: results.filter((r) => !r.success).length,
+      results
+    };
+    printSummary(summary);
+    return summary;
+  } finally {
+    if (results.length > batchSize) {
+      for (const result of results) {
+        if (result.spec) {
+          result.spec = null;
+        }
+      }
+      if (global.gc) {
+        global.gc();
+      }
+    }
+  }
+}
+function getBatchExitCode(summary) {
+  return summary.failed > 0 ? 1 : 0;
+}
+var init_batch_executor = __esm({
+  "src/batch-executor.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_errors();
+  }
+});
+
 // src/utils/name-utils.ts
 function toCamelCase(str, options) {
   let name = str.charAt(0).toLowerCase() + str.slice(1);
@@ -5181,6 +5300,9 @@ var init_lru_cache = __esm({
         this.cache = /* @__PURE__ */ new Map();
         this.maxSize = maxSize;
       }
+      get capacity() {
+        return this.maxSize;
+      }
       get(key) {
         if (!this.cache.has(key)) return void 0;
         const value = this.cache.get(key);
@@ -5766,6 +5888,11 @@ var init_object_validator = __esm({
 });
 
 // src/validators/string-validator.ts
+function configurePatternCache(size) {
+  if (size > 0 && size !== PATTERN_CACHE.capacity) {
+    PATTERN_CACHE = new LRUCache(size);
+  }
+}
 function generateStringValidation(schema, useDescribe) {
   let validation = FORMAT_MAP[schema.format || ""] || "z.string()";
   if (schema.minLength !== void 0) {
@@ -6411,6 +6538,7 @@ var init_operation_filters = __esm({
 // src/openapi-generator.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname, normalize } from "path";
+import { minimatch as minimatch2 } from "minimatch";
 import { parse } from "yaml";
 var OpenApiGenerator;
 var init_openapi_generator = __esm({
@@ -6423,6 +6551,7 @@ var init_openapi_generator = __esm({
     init_property_generator();
     init_name_utils();
     init_operation_filters();
+    init_string_validator();
     OpenApiGenerator = class {
       constructor(options) {
         this.schemas = /* @__PURE__ */ new Map();
@@ -6431,7 +6560,7 @@ var init_openapi_generator = __esm({
         this.schemaUsageMap = /* @__PURE__ */ new Map();
         this.needsZodImport = true;
         this.filterStats = createFilterStatistics();
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         if (!options.input) {
           throw new ConfigurationError("Input path is required", { providedOptions: options });
         }
@@ -6447,8 +6576,14 @@ var init_openapi_generator = __esm({
           showStats: (_c = options.showStats) != null ? _c : true,
           request: options.request,
           response: options.response,
-          operationFilters: options.operationFilters
+          operationFilters: options.operationFilters,
+          ignoreHeaders: options.ignoreHeaders,
+          cacheSize: (_d = options.cacheSize) != null ? _d : 1e3,
+          batchSize: (_e = options.batchSize) != null ? _e : 10
         };
+        if (this.options.cacheSize) {
+          configurePatternCache(this.options.cacheSize);
+        }
         try {
           const fs = __require("fs");
           if (!fs.existsSync(this.options.input)) {
@@ -6584,6 +6719,7 @@ var init_openapi_generator = __esm({
         const normalizedOutput = normalize(this.options.output);
         this.ensureDirectoryExists(normalizedOutput);
         writeFileSync(normalizedOutput, output);
+        console.log(`  \u2713 Generated ${normalizedOutput}`);
       }
       /**
        * Resolve options for a specific context (request or response)
@@ -6994,6 +7130,24 @@ ${propsCode}
           }
         }
       }
+      /**
+       * Check if a header should be ignored based on filter patterns
+       * @internal
+       */
+      shouldIgnoreHeader(headerName) {
+        const ignorePatterns = this.options.ignoreHeaders;
+        if (!ignorePatterns || ignorePatterns.length === 0) {
+          return false;
+        }
+        if (ignorePatterns.includes("*")) {
+          return true;
+        }
+        const headerLower = headerName.toLowerCase();
+        return ignorePatterns.some((pattern) => {
+          const patternLower = pattern.toLowerCase();
+          return minimatch2(headerLower, patternLower);
+        });
+      }
       /**
        * Generate header parameter schemas for each operation
        * Header parameters are always string type (HTTP header semantics)
@@ -7016,7 +7170,7 @@ ${propsCode}
               continue;
             }
             const headerParams = operation.parameters.filter(
-              (param) => param && typeof param === "object" && param.in === "header"
+              (param) => param && typeof param === "object" && param.in === "header" && !this.shouldIgnoreHeader(param.name)
             );
             if (headerParams.length === 0) {
               continue;
@@ -7215,120 +7369,108 @@ ${propsCode}
   }
 });
 
-// src/batch-executor.ts
-async function processSpec(spec, index, total) {
-  console.log(`Processing [${index + 1}/${total}] ${spec.input}...`);
-  try {
-    const generator = new OpenApiGenerator(spec);
-    generator.generate();
-    console.log(`\u2713 Successfully generated ${spec.output}`);
-    return {
-      spec,
-      success: true
-    };
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    console.error(`\u2717 Failed to generate ${spec.output}: ${errorMessage}`);
-    return {
-      spec,
-      success: false,
-      error: errorMessage
-    };
-  }
-}
-async function executeParallel(specs) {
-  console.log(`
-Executing ${specs.length} spec(s) in parallel...
-`);
-  const promises = specs.map((spec, index) => processSpec(spec, index, specs.length));
-  const results = await Promise.allSettled(promises);
-  return results.map((result, index) => {
-    if (result.status === "fulfilled") {
-      return result.value;
-    }
-    return {
-      spec: specs[index],
-      success: false,
-      error: result.reason instanceof Error ? result.reason.message : String(result.reason)
-    };
-  });
-}
-async function executeSequential(specs) {
-  console.log(`
-Executing ${specs.length} spec(s) sequentially...
-`);
-  const results = [];
-  for (let i = 0; i < specs.length; i++) {
-    const result = await processSpec(specs[i], i, specs.length);
-    results.push(result);
+// src/utils/config-schemas.ts
+import { z } from "zod";
+var RequestResponseOptionsSchema, OperationFiltersSchema;
+var init_config_schemas = __esm({
+  "src/utils/config-schemas.ts"() {
+    "use strict";
+    init_esm_shims();
+    RequestResponseOptionsSchema = z.strictObject({
+      mode: z.enum(["strict", "normal", "loose"]).optional(),
+      useDescribe: z.boolean().optional(),
+      includeDescriptions: z.boolean().optional()
+    });
+    OperationFiltersSchema = z.strictObject({
+      includeTags: z.array(z.string()).optional(),
+      excludeTags: z.array(z.string()).optional(),
+      includePaths: z.array(z.string()).optional(),
+      excludePaths: z.array(z.string()).optional(),
+      includeMethods: z.array(z.string()).optional(),
+      excludeMethods: z.array(z.string()).optional(),
+      includeOperationIds: z.array(z.string()).optional(),
+      excludeOperationIds: z.array(z.string()).optional(),
+      excludeDeprecated: z.boolean().optional()
+    });
   }
-  return results;
-}
-function printSummary(summary) {
-  console.log(`
-${"=".repeat(50)}`);
-  console.log("Batch Execution Summary");
-  console.log("=".repeat(50));
-  console.log(`Total specs: ${summary.total}`);
-  console.log(`Successful: ${summary.successful}`);
-  console.log(`Failed: ${summary.failed}`);
-  if (summary.failed > 0) {
-    console.log("\nFailed specs:");
-    for (const result of summary.results) {
-      if (!result.success) {
-        console.error(`  \u2717 ${result.spec.input}`);
-        console.error(`    Error: ${result.error}`);
-      }
-    }
+});
+
+// src/utils/config-validation.ts
+function formatConfigValidationError(error, filepath, configPath, additionalNotes) {
+  var _a;
+  const formattedErrors = ((_a = error.issues) == null ? void 0 : _a.map((err) => {
+    const path2 = err.path.length > 0 ? err.path.join(".") : "root";
+    return `  - ${path2}: ${err.message}`;
+  }).join("\n")) || "Unknown validation error";
+  const configSource = filepath || configPath || "config file";
+  const lines = [
+    `Invalid configuration file at: ${configSource}`,
+    "",
+    "Validation errors:",
+    formattedErrors,
+    "",
+    "Please check your configuration file and ensure:",
+    "  - All required fields are present (specs array with input/output)",
+    "  - Field names are spelled correctly (no typos)",
+    "  - Values match the expected types (e.g., mode: 'strict' | 'normal' | 'loose')",
+    "  - No unknown/extra properties are included"
+  ];
+  if (additionalNotes && additionalNotes.length > 0) {
+    lines.push(...additionalNotes.map((note) => `  - ${note}`));
   }
-  console.log(`${"=".repeat(50)}
-`);
+  return lines.join("\n");
 }
-async function executeBatch(specs, executionMode = "parallel") {
-  if (specs.length === 0) {
-    throw new ConfigurationError("No specs provided for batch execution", { specsCount: 0, executionMode });
+var init_config_validation = __esm({
+  "src/utils/config-validation.ts"() {
+    "use strict";
+    init_esm_shims();
   }
-  let results = [];
-  try {
-    results = executionMode === "parallel" ? await executeParallel(specs) : await executeSequential(specs);
-    const summary = {
-      total: results.length,
-      successful: results.filter((r) => r.success).length,
-      failed: results.filter((r) => !r.success).length,
-      results
-    };
-    printSummary(summary);
-    return summary;
-  } finally {
-    if (results.length > 10) {
-      for (const result of results) {
-        if (result.spec) {
-          result.spec = null;
-        }
-      }
-      if (global.gc) {
-        global.gc();
-      }
+});
+
+// src/utils/typescript-loader.ts
+function createTypeScriptLoader() {
+  return async (filepath) => {
+    try {
+      const esbuild = await import("esbuild");
+      const fs = await import("fs");
+      const path2 = await import("path");
+      const tsCode = fs.readFileSync(filepath, "utf-8");
+      const result = await esbuild.build({
+        stdin: {
+          contents: tsCode,
+          loader: "ts",
+          resolveDir: path2.dirname(filepath),
+          sourcefile: filepath
+        },
+        format: "cjs",
+        platform: "node",
+        target: "node18",
+        bundle: false,
+        write: false
+      });
+      const jsCode = result.outputFiles[0].text;
+      const module = { exports: {} };
+      const func = new Function("exports", "module", "require", "__filename", "__dirname", jsCode);
+      func(module.exports, module, __require, filepath, path2.dirname(filepath));
+      return module.exports.default || module.exports;
+    } catch (error) {
+      throw new Error(
+        `Failed to load TypeScript config from ${filepath}: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
-  }
-}
-function getBatchExitCode(summary) {
-  return summary.failed > 0 ? 1 : 0;
+  };
 }
-var init_batch_executor = __esm({
-  "src/batch-executor.ts"() {
+var init_typescript_loader = __esm({
+  "src/utils/typescript-loader.ts"() {
     "use strict";
     init_esm_shims();
-    init_errors();
-    init_openapi_generator();
   }
 });
 
 // src/utils/config-loader.ts
 import { cosmiconfig } from "cosmiconfig";
-import { z } from "zod";
+import { z as z2 } from "zod";
 async function loadConfig(configPath) {
-  var _a;
   const explorer = cosmiconfig("openapi-to-zod", {
     searchPlaces: ["openapi-to-zod.config.ts", "openapi-to-zod.config.json", "package.json"],
     loaders: {
@@ -7350,24 +7492,8 @@ async function loadConfig(configPath) {
     const validatedConfig = ConfigFileSchema.parse(result.config);
     return validatedConfig;
   } catch (error) {
-    if (error instanceof z.ZodError) {
-      const formattedErrors = ((_a = error.issues) == null ? void 0 : _a.map((err) => {
-        const path2 = err.path.length > 0 ? err.path.join(".") : "root";
-        return `  - ${path2}: ${err.message}`;
-      }).join("\n")) || "Unknown validation error";
-      const configSource = result.filepath || configPath || "config file";
-      const errorMessage = [
-        `Invalid configuration file at: ${configSource}`,
-        "",
-        "Validation errors:",
-        formattedErrors,
-        "",
-        "Please check your configuration file and ensure:",
-        "  - All required fields are present (specs array with input/output)",
-        "  - Field names are spelled correctly (no typos)",
-        "  - Values match the expected types (e.g., mode: 'strict' | 'normal' | 'loose')",
-        "  - No unknown/extra properties are included"
-      ].join("\n");
+    if (error instanceof z2.ZodError) {
+      const errorMessage = formatConfigValidationError(error, result.filepath, configPath);
       throw new Error(errorMessage);
     }
     throw error;
@@ -7394,90 +7520,53 @@ function mergeConfigWithDefaults(config) {
     return merged;
   });
 }
-var RequestResponseOptionsSchema, OperationFiltersSchema, OpenApiGeneratorOptionsSchema, ConfigFileSchema, createTypeScriptLoader;
+var OpenApiGeneratorOptionsSchema, ConfigFileSchema;
 var init_config_loader = __esm({
   "src/utils/config-loader.ts"() {
     "use strict";
     init_esm_shims();
-    RequestResponseOptionsSchema = z.strictObject({
-      mode: z.enum(["strict", "normal", "loose"]).optional(),
-      useDescribe: z.boolean().optional(),
-      includeDescriptions: z.boolean().optional()
-    });
-    OperationFiltersSchema = z.strictObject({
-      includeTags: z.array(z.string()).optional(),
-      excludeTags: z.array(z.string()).optional(),
-      includePaths: z.array(z.string()).optional(),
-      excludePaths: z.array(z.string()).optional(),
-      includeMethods: z.array(z.string()).optional(),
-      excludeMethods: z.array(z.string()).optional(),
-      includeOperationIds: z.array(z.string()).optional(),
-      excludeOperationIds: z.array(z.string()).optional(),
-      excludeDeprecated: z.boolean().optional()
-    });
-    OpenApiGeneratorOptionsSchema = z.strictObject({
-      mode: z.enum(["strict", "normal", "loose"]).optional(),
-      input: z.string(),
-      output: z.string(),
-      includeDescriptions: z.boolean().optional(),
-      useDescribe: z.boolean().optional(),
-      schemaType: z.enum(["all", "request", "response"]).optional(),
-      prefix: z.string().optional(),
-      suffix: z.string().optional(),
-      showStats: z.boolean().optional(),
+    init_config_schemas();
+    init_config_validation();
+    init_typescript_loader();
+    OpenApiGeneratorOptionsSchema = z2.strictObject({
+      mode: z2.enum(["strict", "normal", "loose"]).optional(),
+      input: z2.string(),
+      output: z2.string(),
+      includeDescriptions: z2.boolean().optional(),
+      useDescribe: z2.boolean().optional(),
+      schemaType: z2.enum(["all", "request", "response"]).optional(),
+      prefix: z2.string().optional(),
+      suffix: z2.string().optional(),
+      showStats: z2.boolean().optional(),
       request: RequestResponseOptionsSchema.optional(),
       response: RequestResponseOptionsSchema.optional(),
-      name: z.string().optional(),
-      operationFilters: OperationFiltersSchema.optional()
+      name: z2.string().optional(),
+      operationFilters: OperationFiltersSchema.optional(),
+      cacheSize: z2.number().positive().optional(),
+      batchSize: z2.number().positive().optional()
     });
-    ConfigFileSchema = z.strictObject({
-      defaults: z.strictObject({
-        mode: z.enum(["strict", "normal", "loose"]).optional(),
-        includeDescriptions: z.boolean().optional(),
-        useDescribe: z.boolean().optional(),
-        schemaType: z.enum(["all", "request", "response"]).optional(),
-        prefix: z.string().optional(),
-        suffix: z.string().optional(),
-        showStats: z.boolean().optional(),
+    ConfigFileSchema = z2.strictObject({
+      defaults: z2.strictObject({
+        mode: z2.enum(["strict", "normal", "loose"]).optional(),
+        includeDescriptions: z2.boolean().optional(),
+        useDescribe: z2.boolean().optional(),
+        schemaType: z2.enum(["all", "request", "response"]).optional(),
+        prefix: z2.string().optional(),
+        suffix: z2.string().optional(),
+        showStats: z2.boolean().optional(),
         request: RequestResponseOptionsSchema.optional(),
         response: RequestResponseOptionsSchema.optional(),
-        operationFilters: OperationFiltersSchema.optional()
+        operationFilters: OperationFiltersSchema.optional(),
+        cacheSize: z2.number().positive().optional(),
+        batchSize: z2.number().positive().optional()
       }).optional(),
-      specs: z.array(OpenApiGeneratorOptionsSchema).min(1, "At least one spec is required"),
-      executionMode: z.enum(["parallel", "sequential"]).optional()
+      specs: z2.array(OpenApiGeneratorOptionsSchema).min(1, {
+        message: "Configuration must include at least one specification. Each specification should have 'input' and 'output' paths."
+      }).refine((specs) => specs.every((spec) => spec.input && spec.output), {
+        message: "Each specification must have both 'input' and 'output' paths defined"
+      }),
+      executionMode: z2.enum(["parallel", "sequential"]).optional()
     });
-    createTypeScriptLoader = () => {
-      return async (filepath) => {
-        try {
-          const esbuild = await import("esbuild");
-          const fs = await import("fs");
-          const path2 = await import("path");
-          const tsCode = fs.readFileSync(filepath, "utf-8");
-          const result = await esbuild.build({
-            stdin: {
-              contents: tsCode,
-              loader: "ts",
-              resolveDir: path2.dirname(filepath),
-              sourcefile: filepath
-            },
-            format: "cjs",
-            platform: "node",
-            target: "node18",
-            bundle: false,
-            write: false
-          });
-          const jsCode = result.outputFiles[0].text;
-          const module = { exports: {} };
-          const func = new Function("exports", "module", "require", "__filename", "__dirname", jsCode);
-          func(module.exports, module, __require, filepath, path2.dirname(filepath));
-          return module.exports.default || module.exports;
-        } catch (error) {
-          throw new Error(
-            `Failed to load TypeScript config from ${filepath}: ${error instanceof Error ? error.message : String(error)}`
-          );
-        }
-      };
-    };
   }
 });
 
@@ -7491,6 +7580,7 @@ var require_cli = __commonJS({
     var import_prompts = __toESM(require_prompts3());
     init_batch_executor();
     init_errors();
+    init_openapi_generator();
     init_config_loader();
     var program = new Command();
     program.name("openapi-to-zod").description("Generate Zod v4 schemas from OpenAPI specifications").version("1.0.0").option("-c, --config <path>", "Path to config file (openapi-to-zod.config.{ts,json})").addHelpText(
@@ -7498,17 +7588,13 @@ var require_cli = __commonJS({
       `
 Examples:
   # Create a new config file
-  $ openapi-to-zod --init
+  $ openapi-to-zod init
 
   # Generate with auto-discovered config
   $ openapi-to-zod
 
   # Generate with custom config path
   $ openapi-to-zod --config custom.config.ts
-
-Breaking Changes (v2.0):
-  CLI options removed. Use configuration file instead.
-  Run 'openapi-to-zod --init' to create a config file.
 `
     ).action(async (options) => {
       try {
@@ -7565,17 +7651,19 @@ Breaking Changes (v2.0):
       return { files, totalCount };
     }
     async function executeConfigMode(options) {
+      var _a, _b;
       let config;
       try {
         config = await loadConfig(options.config);
       } catch {
-        throw new CliOptionsError("No config file found. Run 'openapi-to-zod --init' to create one.", {
+        throw new CliOptionsError("No config file found. Run 'openapi-to-zod init' to create one.", {
           configPath: options.config
         });
       }
       const specs = mergeConfigWithDefaults(config);
       const executionMode = config.executionMode || "parallel";
-      const summary = await executeBatch(specs, executionMode);
+      const batchSize = (_b = (_a = specs[0]) == null ? void 0 : _a.batchSize) != null ? _b : 10;
+      const summary = await executeBatch(specs, executionMode, (spec) => new OpenApiGenerator(spec), batchSize);
       const exitCode = getBatchExitCode(summary);
       if (exitCode !== 0) {
         process.exit(exitCode);
@@ -7699,7 +7787,7 @@ export default defineConfig({
     mode: 'strict',
     includeDescriptions: true,
 	useDescribe: false,
-    showStats: false,
+    showStats: true,
 	schemaType: 'all',
   },
   specs: [