@cerios/openapi-to-zod 0.2.0 → 0.4.0

package/dist/index.d.mts

@@ -63,11 +63,9 @@ type TypeMode = "inferred" | "native";
  */
 type NativeEnumType = "union" | "enum";
 /**
- * Options that can be overridden per request/response context
- * These options override root-level options when specified.
- * Resolution order: root options → request/response overrides (nested wins silently)
+ * Common options shared by both request and response contexts
  */
-interface RequestResponseOptions {
+interface CommonSchemaOptions {
     /**
      * Object validation mode
      * - 'strict': Uses z.strictObject() - no additional properties allowed
@@ -90,10 +88,16 @@ interface RequestResponseOptions {
      * Whether to include descriptions as JSDoc comments
      */
     includeDescriptions?: boolean;
+}
+/**
+ * Request-specific options that can override root-level options
+ * Requests support native TypeScript type generation as an alternative to Zod schemas
+ */
+interface RequestOptions extends CommonSchemaOptions {
     /**
-     * Type generation mode (only for requests)
+     * Type generation mode
      * - 'inferred': Generate Zod schemas with z.infer types (default)
-     * - 'native': Generate native TypeScript types
+     * - 'native': Generate native TypeScript types without Zod validation
      */
     typeMode?: TypeMode;
     /**
@@ -103,7 +107,13 @@ interface RequestResponseOptions {
      */
     nativeEnumType?: NativeEnumType;
 }
-interface GeneratorOptions {
+/**
+ * Response-specific options that can override root-level options
+ * Responses always use Zod schemas for runtime validation
+ */
+interface ResponseOptions extends CommonSchemaOptions {
+}
+interface OpenApiGeneratorOptions {
     /**
      * Object validation mode
      * - 'strict': Uses z.strictObject() - no additional properties allowed
@@ -168,13 +178,15 @@ interface GeneratorOptions {
     /**
      * Request-specific options that override root-level options
      * Applied when schemas are used in request contexts
+     * Supports native TypeScript type generation
      */
-    request?: Partial<RequestResponseOptions>;
+    request?: RequestOptions;
     /**
      * Response-specific options that override root-level options
      * Applied when schemas are used in response contexts
+     * Always generates Zod schemas for runtime validation
      */
-    response?: Partial<RequestResponseOptions>;
+    response?: ResponseOptions;
 }
 interface OpenAPISchema {
     type?: string | string[];
@@ -251,12 +263,12 @@ interface ConfigFile {
      * Global default options applied to all specs
      * Can be overridden by individual spec configurations
      */
-    defaults?: Partial<Omit<GeneratorOptions, "input" | "output">>;
+    defaults?: Partial<Omit<OpenApiGeneratorOptions, "input" | "output">>;
     /**
      * Array of OpenAPI specifications to process
      * Each spec must have input and output paths
      */
-    specs: GeneratorOptions[];
+    specs: OpenApiGeneratorOptions[];
     /**
      * Execution mode for batch processing
      * @default "parallel"
@@ -285,7 +297,7 @@ interface ConfigFile {
  */
 declare function defineConfig(config: ConfigFile): ConfigFile;
 
-declare class ZodSchemaGenerator {
+declare class OpenApiGenerator {
     private schemas;
     private types;
     private enums;
@@ -299,7 +311,7 @@ declare class ZodSchemaGenerator {
     private requestOptions;
     private responseOptions;
     private needsZodImport;
-    constructor(options: GeneratorOptions);
+    constructor(options: OpenApiGeneratorOptions);
     /**
      * Generate schemas as a string (without writing to file)
      * @returns The generated TypeScript code as a string
@@ -400,4 +412,4 @@ declare class ZodSchemaGenerator {
     private generateStats;
 }
 
-export { CircularReferenceError, CliOptionsError, type ConfigFile, ConfigValidationError, type ExecutionMode, FileOperationError, GeneratorError, type GeneratorOptions, type OpenAPISpec, SchemaGenerationError, SpecValidationError, ZodSchemaGenerator, defineConfig };
+export { CircularReferenceError, CliOptionsError, type ConfigFile, ConfigValidationError, type ExecutionMode, FileOperationError, GeneratorError, type OpenAPISpec, OpenApiGenerator, type OpenApiGeneratorOptions, SchemaGenerationError, SpecValidationError, defineConfig };

package/dist/index.d.ts

@@ -63,11 +63,9 @@ type TypeMode = "inferred" | "native";
  */
 type NativeEnumType = "union" | "enum";
 /**
- * Options that can be overridden per request/response context
- * These options override root-level options when specified.
- * Resolution order: root options → request/response overrides (nested wins silently)
+ * Common options shared by both request and response contexts
  */
-interface RequestResponseOptions {
+interface CommonSchemaOptions {
     /**
      * Object validation mode
      * - 'strict': Uses z.strictObject() - no additional properties allowed
@@ -90,10 +88,16 @@ interface RequestResponseOptions {
      * Whether to include descriptions as JSDoc comments
      */
     includeDescriptions?: boolean;
+}
+/**
+ * Request-specific options that can override root-level options
+ * Requests support native TypeScript type generation as an alternative to Zod schemas
+ */
+interface RequestOptions extends CommonSchemaOptions {
     /**
-     * Type generation mode (only for requests)
+     * Type generation mode
      * - 'inferred': Generate Zod schemas with z.infer types (default)
-     * - 'native': Generate native TypeScript types
+     * - 'native': Generate native TypeScript types without Zod validation
      */
     typeMode?: TypeMode;
     /**
@@ -103,7 +107,13 @@ interface RequestResponseOptions {
      */
     nativeEnumType?: NativeEnumType;
 }
-interface GeneratorOptions {
+/**
+ * Response-specific options that can override root-level options
+ * Responses always use Zod schemas for runtime validation
+ */
+interface ResponseOptions extends CommonSchemaOptions {
+}
+interface OpenApiGeneratorOptions {
     /**
      * Object validation mode
      * - 'strict': Uses z.strictObject() - no additional properties allowed
@@ -168,13 +178,15 @@ interface GeneratorOptions {
     /**
      * Request-specific options that override root-level options
      * Applied when schemas are used in request contexts
+     * Supports native TypeScript type generation
      */
-    request?: Partial<RequestResponseOptions>;
+    request?: RequestOptions;
     /**
      * Response-specific options that override root-level options
      * Applied when schemas are used in response contexts
+     * Always generates Zod schemas for runtime validation
      */
-    response?: Partial<RequestResponseOptions>;
+    response?: ResponseOptions;
 }
 interface OpenAPISchema {
     type?: string | string[];
@@ -251,12 +263,12 @@ interface ConfigFile {
      * Global default options applied to all specs
      * Can be overridden by individual spec configurations
      */
-    defaults?: Partial<Omit<GeneratorOptions, "input" | "output">>;
+    defaults?: Partial<Omit<OpenApiGeneratorOptions, "input" | "output">>;
     /**
      * Array of OpenAPI specifications to process
      * Each spec must have input and output paths
      */
-    specs: GeneratorOptions[];
+    specs: OpenApiGeneratorOptions[];
     /**
      * Execution mode for batch processing
      * @default "parallel"
@@ -285,7 +297,7 @@ interface ConfigFile {
  */
 declare function defineConfig(config: ConfigFile): ConfigFile;
 
-declare class ZodSchemaGenerator {
+declare class OpenApiGenerator {
     private schemas;
     private types;
     private enums;
@@ -299,7 +311,7 @@ declare class ZodSchemaGenerator {
     private requestOptions;
     private responseOptions;
     private needsZodImport;
-    constructor(options: GeneratorOptions);
+    constructor(options: OpenApiGeneratorOptions);
     /**
      * Generate schemas as a string (without writing to file)
      * @returns The generated TypeScript code as a string
@@ -400,4 +412,4 @@ declare class ZodSchemaGenerator {
     private generateStats;
 }
 
-export { CircularReferenceError, CliOptionsError, type ConfigFile, ConfigValidationError, type ExecutionMode, FileOperationError, GeneratorError, type GeneratorOptions, type OpenAPISpec, SchemaGenerationError, SpecValidationError, ZodSchemaGenerator, defineConfig };
+export { CircularReferenceError, CliOptionsError, type ConfigFile, ConfigValidationError, type ExecutionMode, FileOperationError, GeneratorError, type OpenAPISpec, OpenApiGenerator, type OpenApiGeneratorOptions, SchemaGenerationError, SpecValidationError, defineConfig };

package/dist/index.js

@@ -25,9 +25,9 @@ __export(src_exports, {
   ConfigValidationError: () => ConfigValidationError,
   FileOperationError: () => FileOperationError,
   GeneratorError: () => GeneratorError,
+  OpenApiGenerator: () => OpenApiGenerator,
   SchemaGenerationError: () => SchemaGenerationError,
   SpecValidationError: () => SpecValidationError,
-  ZodSchemaGenerator: () => ZodSchemaGenerator,
   defineConfig: () => defineConfig
 });
 module.exports = __toCommonJS(src_exports);
@@ -91,7 +91,7 @@ var ConfigurationError = class extends GeneratorError {
   }
 };
 
-// src/generator.ts
+// src/openapi-generator.ts
 var import_node_fs = require("fs");
 var import_node_path = require("path");
 var import_yaml = require("yaml");
@@ -1279,8 +1279,8 @@ _PropertyGenerator.INCLUSION_RULES = {
 };
 var PropertyGenerator = _PropertyGenerator;
 
-// src/generator.ts
-var ZodSchemaGenerator = class {
+// src/openapi-generator.ts
+var OpenApiGenerator = class {
   constructor(options) {
     this.schemas = /* @__PURE__ */ new Map();
     this.types = /* @__PURE__ */ new Map();
@@ -1320,19 +1320,41 @@ var ZodSchemaGenerator = class {
       }
     }
     try {
-      const yamlContent = (0, import_node_fs.readFileSync)(this.options.input, "utf-8");
-      this.spec = (0, import_yaml.parse)(yamlContent);
+      const content = (0, import_node_fs.readFileSync)(this.options.input, "utf-8");
+      try {
+        this.spec = (0, import_yaml.parse)(content);
+      } catch (yamlError) {
+        try {
+          this.spec = JSON.parse(content);
+        } catch {
+          if (yamlError instanceof Error) {
+            const errorMessage = [
+              `Failed to parse OpenAPI specification from: ${this.options.input}`,
+              "",
+              `Error: ${yamlError.message}`,
+              "",
+              "Please ensure:",
+              "  - The file exists and is readable",
+              "  - The file contains valid YAML or JSON syntax",
+              "  - The file is a valid OpenAPI 3.x specification"
+            ].join("\n");
+            throw new SpecValidationError(errorMessage, {
+              filePath: this.options.input,
+              originalError: yamlError.message
+            });
+          }
+          throw yamlError;
+        }
+      }
     } catch (error) {
+      if (error instanceof SpecValidationError) {
+        throw error;
+      }
       if (error instanceof Error) {
         const errorMessage = [
-          `Failed to parse OpenAPI specification from: ${this.options.input}`,
-          "",
-          `Error: ${error.message}`,
+          `Failed to read OpenAPI specification from: ${this.options.input}`,
           "",
-          "Please ensure:",
-          "  - The file exists and is readable",
-          "  - The file contains valid YAML syntax",
-          "  - The file is a valid OpenAPI 3.x specification"
+          `Error: ${error.message}`
         ].join("\n");
         throw new SpecValidationError(errorMessage, { filePath: this.options.input, originalError: error.message });
       }
@@ -1433,7 +1455,8 @@ var ZodSchemaGenerator = class {
    * Ensure directory exists for a file path
    */
   ensureDirectoryExists(filePath) {
-    const dir = (0, import_node_path.dirname)(filePath);
+    const normalizedPath = (0, import_node_path.normalize)(filePath);
+    const dir = (0, import_node_path.dirname)(normalizedPath);
     if (!(0, import_node_fs.existsSync)(dir)) {
       (0, import_node_fs.mkdirSync)(dir, { recursive: true });
     }
@@ -1449,8 +1472,9 @@ var ZodSchemaGenerator = class {
       );
     }
     const output = this.generateString();
-    this.ensureDirectoryExists(this.options.output);
-    (0, import_node_fs.writeFileSync)(this.options.output, output);
+    const normalizedOutput = (0, import_node_path.normalize)(this.options.output);
+    this.ensureDirectoryExists(normalizedOutput);
+    (0, import_node_fs.writeFileSync)(normalizedOutput, output);
   }
   /**
    * Resolve options for a specific context (request or response)
@@ -1458,17 +1482,18 @@ var ZodSchemaGenerator = class {
    * Response schemas always use 'inferred' mode (Zod schemas)
    */
   resolveOptionsForContext(context) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
     const contextOptions = context === "request" ? this.options.request : this.options.response;
+    const nativeEnumType = context === "request" ? (_c = (_b = (_a = this.options.request) == null ? void 0 : _a.nativeEnumType) != null ? _b : this.options.nativeEnumType) != null ? _c : "union" : (_d = this.options.nativeEnumType) != null ? _d : "union";
     return {
-      mode: (_b = (_a = contextOptions == null ? void 0 : contextOptions.mode) != null ? _a : this.options.mode) != null ? _b : "normal",
-      enumType: (_d = (_c = contextOptions == null ? void 0 : contextOptions.enumType) != null ? _c : this.options.enumType) != null ? _d : "zod",
-      useDescribe: (_f = (_e = contextOptions == null ? void 0 : contextOptions.useDescribe) != null ? _e : this.options.useDescribe) != null ? _f : false,
-      includeDescriptions: (_h = (_g = contextOptions == null ? void 0 : contextOptions.includeDescriptions) != null ? _g : this.options.includeDescriptions) != null ? _h : true,
+      mode: (_f = (_e = contextOptions == null ? void 0 : contextOptions.mode) != null ? _e : this.options.mode) != null ? _f : "normal",
+      enumType: (_h = (_g = contextOptions == null ? void 0 : contextOptions.enumType) != null ? _g : this.options.enumType) != null ? _h : "zod",
+      useDescribe: (_j = (_i = contextOptions == null ? void 0 : contextOptions.useDescribe) != null ? _i : this.options.useDescribe) != null ? _j : false,
+      includeDescriptions: (_l = (_k = contextOptions == null ? void 0 : contextOptions.includeDescriptions) != null ? _k : this.options.includeDescriptions) != null ? _l : true,
       // Response schemas always use 'inferred' mode (Zod schemas are required)
       // Request schemas can optionally use 'native' mode
-      typeMode: context === "response" ? "inferred" : (_i = contextOptions == null ? void 0 : contextOptions.typeMode) != null ? _i : "inferred",
-      nativeEnumType: (_k = (_j = contextOptions == null ? void 0 : contextOptions.nativeEnumType) != null ? _j : this.options.nativeEnumType) != null ? _k : "union"
+      typeMode: context === "response" ? "inferred" : (_n = (_m = this.options.request) == null ? void 0 : _m.typeMode) != null ? _n : "inferred",
+      nativeEnumType
     };
   }
   /**
@@ -2198,9 +2223,9 @@ function defineConfig(config) {
   ConfigValidationError,
   FileOperationError,
   GeneratorError,
+  OpenApiGenerator,
   SchemaGenerationError,
   SpecValidationError,
-  ZodSchemaGenerator,
   defineConfig
 });
 //# sourceMappingURL=index.js.map