@cerios/openapi-to-zod 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { O as OpenApiGeneratorOptions } from './types-B7ePTDjr.mjs';
-export { C as CommonSchemaOptions, a as ConfigFile, E as ExecutionMode, b as OpenAPISchema, c as OpenAPISpec, d as OperationFilters, R as RequestOptions, e as ResponseOptions, f as defineConfig } from './types-B7ePTDjr.mjs';
+import { O as OpenApiGeneratorOptions } from './types--r0d47sd.mjs';
+export { C as CommonSchemaOptions, a as ConfigFile, E as ExecutionMode, b as OpenAPISchema, c as OpenAPISpec, d as OperationFilters, R as RequestOptions, e as ResponseOptions, f as defineConfig } from './types--r0d47sd.mjs';
 
 /**
  * Custom error classes for better error handling and debugging
@@ -125,6 +125,17 @@ declare class OpenApiGenerator {
      * Generate query parameter schemas for each operation
      */
     private generateQueryParameterSchemas;
+    /**
+     * Generate a PascalCase method name from HTTP method and path
+     * Used as fallback when operationId is not available
+     * @internal
+     */
+    private generateMethodNameFromPath;
+    /**
+     * Capitalizes a path segment, handling special characters like dashes, underscores, and dots
+     * @internal
+     */
+    private capitalizeSegment;
     /**
      * Check if a header should be ignored based on filter patterns
      * @internal

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OpenApiGeneratorOptions } from './types-B7ePTDjr.js';
-export { C as CommonSchemaOptions, a as ConfigFile, E as ExecutionMode, b as OpenAPISchema, c as OpenAPISpec, d as OperationFilters, R as RequestOptions, e as ResponseOptions, f as defineConfig } from './types-B7ePTDjr.js';
+import { O as OpenApiGeneratorOptions } from './types--r0d47sd.js';
+export { C as CommonSchemaOptions, a as ConfigFile, E as ExecutionMode, b as OpenAPISchema, c as OpenAPISpec, d as OperationFilters, R as RequestOptions, e as ResponseOptions, f as defineConfig } from './types--r0d47sd.js';
 
 /**
  * Custom error classes for better error handling and debugging
@@ -125,6 +125,17 @@ declare class OpenApiGenerator {
      * Generate query parameter schemas for each operation
      */
     private generateQueryParameterSchemas;
+    /**
+     * Generate a PascalCase method name from HTTP method and path
+     * Used as fallback when operationId is not available
+     * @internal
+     */
+    private generateMethodNameFromPath;
+    /**
+     * Capitalizes a path segment, handling special characters like dashes, underscores, and dots
+     * @internal
+     */
+    private capitalizeSegment;
     /**
      * Check if a header should be ignored based on filter patterns
      * @internal

package/dist/index.js

@@ -94,7 +94,7 @@ var ConfigurationError = class extends GeneratorError {
 // src/openapi-generator.ts
 var import_node_fs = require("fs");
 var import_node_path = require("path");
-var import_minimatch2 = require("minimatch");
+var import_minimatch3 = require("minimatch");
 var import_yaml = require("yaml");
 
 // src/utils/name-utils.ts
@@ -153,8 +153,26 @@ function resolveRef(ref) {
 function generateEnum(name, values, options) {
   const schemaName = `${toCamelCase(name, options)}Schema`;
   const typeName = toPascalCase(name);
-  const enumValues = values.map((v) => `"${v}"`).join(", ");
-  const schemaCode = `export const ${schemaName} = z.enum([${enumValues}]);`;
+  const allBooleans = values.every((v) => typeof v === "boolean");
+  if (allBooleans) {
+    const schemaCode2 = `export const ${schemaName} = z.boolean();`;
+    const typeCode2 = `export type ${typeName} = z.infer<typeof ${schemaName}>;`;
+    return { schemaCode: schemaCode2, typeCode: typeCode2 };
+  }
+  const allStrings = values.every((v) => typeof v === "string");
+  if (allStrings) {
+    const enumValues = values.map((v) => `"${v}"`).join(", ");
+    const schemaCode2 = `export const ${schemaName} = z.enum([${enumValues}]);`;
+    const typeCode2 = `export type ${typeName} = z.infer<typeof ${schemaName}>;`;
+    return { schemaCode: schemaCode2, typeCode: typeCode2 };
+  }
+  const literalValues = values.map((v) => {
+    if (typeof v === "string") {
+      return `z.literal("${v}")`;
+    }
+    return `z.literal(${v})`;
+  }).join(", ");
+  const schemaCode = `export const ${schemaName} = z.union([${literalValues}]);`;
   const typeCode = `export type ${typeName} = z.infer<typeof ${schemaName}>;`;
   return { schemaCode, typeCode };
 }
@@ -164,7 +182,7 @@ function escapeDescription(str) {
   return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n");
 }
 function escapePattern(str) {
-  return str.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+  return str.replace(/\//g, "\\/");
 }
 function escapeJSDoc(str) {
   return str.replace(/\*\//g, "*\\/");
@@ -172,14 +190,17 @@ function escapeJSDoc(str) {
 function wrapNullable(validation, isNullable2) {
   return isNullable2 ? `${validation}.nullable()` : validation;
 }
-function isNullable(schema) {
+function isNullable(schema, defaultNullable = false) {
   if (schema.nullable === true) {
     return true;
   }
+  if (schema.nullable === false) {
+    return false;
+  }
   if (Array.isArray(schema.type)) {
     return schema.type.includes("null");
   }
-  return false;
+  return defaultNullable;
 }
 function getPrimaryType(schema) {
   if (Array.isArray(schema.type)) {
@@ -289,61 +310,36 @@ var LRUCache = class {
 };
 
 // src/utils/pattern-utils.ts
-function isRegexPattern(pattern) {
-  if (pattern.startsWith("^") || pattern.endsWith("$")) {
-    return true;
-  }
-  if (/\\[dDwWsS]/.test(pattern)) {
-    return true;
-  }
-  if (/\.\*|\.\+/.test(pattern)) {
-    return true;
-  }
-  if (/[[\]()]/.test(pattern)) {
-    return true;
-  }
-  if (/[^/][+?*]\{/.test(pattern)) {
+var import_minimatch = require("minimatch");
+function isValidGlobPattern(pattern) {
+  try {
+    new import_minimatch.minimatch.Minimatch(pattern);
     return true;
+  } catch {
+    return false;
   }
-  return false;
 }
-function patternToRegex(pattern) {
-  if (pattern instanceof RegExp) {
-    return pattern;
-  }
-  if (isRegexPattern(pattern)) {
-    try {
-      return new RegExp(pattern);
-    } catch (error) {
-      console.warn(`\u26A0\uFE0F  Invalid regex pattern "${pattern}": ${error instanceof Error ? error.message : String(error)}`);
-      return null;
-    }
-  }
-  return null;
+function isGlobPattern(pattern) {
+  return /[*?[\]{}!]/.test(pattern);
 }
 function stripPrefix(input, pattern, ensureLeadingChar) {
   if (!pattern) {
     return input;
   }
-  const regex = patternToRegex(pattern);
-  if (regex) {
-    const match = input.match(regex);
-    if (match && match.index === 0) {
-      const stripped = input.substring(match[0].length);
-      if (ensureLeadingChar) {
-        if (stripped === "") {
-          return ensureLeadingChar;
-        }
-        if (!stripped.startsWith(ensureLeadingChar)) {
-          return `${ensureLeadingChar}${stripped}`;
-        }
+  if (isGlobPattern(pattern) && !isValidGlobPattern(pattern)) {
+    console.warn(`\u26A0\uFE0F  Invalid glob pattern "${pattern}": Pattern is malformed`);
+    return input;
+  }
+  if (isGlobPattern(pattern)) {
+    let longestMatch = -1;
+    for (let i = 1; i <= input.length; i++) {
+      const testPrefix = input.substring(0, i);
+      if ((0, import_minimatch.minimatch)(testPrefix, pattern)) {
+        longestMatch = i;
       }
-      return stripped;
     }
-  } else {
-    const stringPattern = pattern;
-    if (input.startsWith(stringPattern)) {
-      const stripped = input.substring(stringPattern.length);
+    if (longestMatch > 0) {
+      const stripped = input.substring(longestMatch);
       if (ensureLeadingChar) {
         if (stripped === "") {
           return ensureLeadingChar;
@@ -352,11 +348,40 @@ function stripPrefix(input, pattern, ensureLeadingChar) {
           return `${ensureLeadingChar}${stripped}`;
         }
       }
-      return stripped;
+      return stripped === "" && !ensureLeadingChar ? input : stripped;
     }
+    return input;
+  }
+  if (input.startsWith(pattern)) {
+    const stripped = input.substring(pattern.length);
+    if (ensureLeadingChar) {
+      if (stripped === "") {
+        return ensureLeadingChar;
+      }
+      if (!stripped.startsWith(ensureLeadingChar)) {
+        return `${ensureLeadingChar}${stripped}`;
+      }
+    }
+    return stripped;
   }
   return input;
 }
+function stripPathPrefix(path, pattern) {
+  if (!pattern) {
+    return path;
+  }
+  if (!isGlobPattern(pattern)) {
+    let normalizedPattern = pattern.trim();
+    if (!normalizedPattern.startsWith("/")) {
+      normalizedPattern = `/${normalizedPattern}`;
+    }
+    if (normalizedPattern.endsWith("/") && normalizedPattern !== "/") {
+      normalizedPattern = normalizedPattern.slice(0, -1);
+    }
+    return stripPrefix(path, normalizedPattern, "/");
+  }
+  return stripPrefix(path, pattern, "/");
+}
 
 // src/validators/array-validator.ts
 function generateArrayValidation(schema, context) {
@@ -882,7 +907,7 @@ function configurePatternCache(size) {
     PATTERN_CACHE = new LRUCache(size);
   }
 }
-var FORMAT_MAP = {
+var DEFAULT_FORMAT_MAP = {
   uuid: "z.uuid()",
   email: "z.email()",
   uri: "z.url()",
@@ -892,7 +917,6 @@ var FORMAT_MAP = {
   byte: "z.base64()",
   binary: "z.string()",
   date: "z.iso.date()",
-  "date-time": "z.iso.datetime()",
   time: "z.iso.time()",
   duration: 'z.string().refine((val) => /^P(?:(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+(?:\\.\\d+)?S)?)?|\\d+W)$/.test(val) && !/^PT?$/.test(val), { message: "Must be a valid ISO 8601 duration" })',
   ipv4: "z.ipv4()",
@@ -911,6 +935,30 @@ var FORMAT_MAP = {
   "json-pointer": 'z.string().refine((val) => val === "" || /^(\\/([^~/]|~0|~1)+)+$/.test(val), { message: "Must be a valid JSON Pointer (RFC 6901)" })',
   "relative-json-pointer": 'z.string().refine((val) => /^(0|[1-9]\\d*)(#|(\\/([^~/]|~0|~1)+)*)$/.test(val), { message: "Must be a valid relative JSON Pointer" })'
 };
+var FORMAT_MAP = {
+  ...DEFAULT_FORMAT_MAP,
+  "date-time": "z.iso.datetime()"
+};
+function configureDateTimeFormat(pattern) {
+  if (!pattern) {
+    FORMAT_MAP["date-time"] = "z.iso.datetime()";
+    return;
+  }
+  const patternStr = pattern instanceof RegExp ? pattern.source : pattern;
+  if (patternStr === "") {
+    FORMAT_MAP["date-time"] = "z.iso.datetime()";
+    return;
+  }
+  try {
+    new RegExp(patternStr);
+  } catch (error) {
+    throw new Error(
+      `Invalid regular expression pattern for customDateTimeFormatRegex: ${patternStr}. ${error instanceof Error ? error.message : "Pattern is malformed"}`
+    );
+  }
+  const escapedPattern = escapePattern(patternStr);
+  FORMAT_MAP["date-time"] = `z.string().regex(/${escapedPattern}/)`;
+}
 function generateStringValidation(schema, useDescribe) {
   let validation = FORMAT_MAP[schema.format || ""] || "z.string()";
   if (schema.minLength !== void 0) {
@@ -1200,7 +1248,8 @@ var _PropertyGenerator = class _PropertyGenerator {
     if ((this.context.schemaType === "request" || this.context.schemaType === "response") && schema.properties) {
       schema = this.filterNestedProperties(schema);
     }
-    const nullable = isNullable(schema);
+    const effectiveDefaultNullable = isTopLevel ? false : this.context.defaultNullable;
+    const nullable = isNullable(schema, effectiveDefaultNullable);
     if (hasMultipleTypes(schema)) {
       const union = this.generateMultiTypeUnion(schema, currentSchema);
       return wrapNullable(union, nullable);
@@ -1228,9 +1277,25 @@ var _PropertyGenerator = class _PropertyGenerator {
       return wrapNullable(zodLiteral, nullable);
     }
     if (schema.enum) {
-      const enumValues = schema.enum.map((v) => `"${v}"`).join(", ");
-      const zodEnum = `z.enum([${enumValues}])`;
-      return wrapNullable(zodEnum, nullable);
+      const allBooleans = schema.enum.every((v) => typeof v === "boolean");
+      if (allBooleans) {
+        const zodBoolean = "z.boolean()";
+        return wrapNullable(zodBoolean, nullable);
+      }
+      const allStrings = schema.enum.every((v) => typeof v === "string");
+      if (allStrings) {
+        const enumValues = schema.enum.map((v) => `"${v}"`).join(", ");
+        const zodEnum = `z.enum([${enumValues}])`;
+        return wrapNullable(zodEnum, nullable);
+      }
+      const literalValues = schema.enum.map((v) => {
+        if (typeof v === "string") {
+          return `z.literal("${v}")`;
+        }
+        return `z.literal(${v})`;
+      }).join(", ");
+      const zodUnion = `z.union([${literalValues}])`;
+      return wrapNullable(zodUnion, nullable);
     }
     if (schema.allOf) {
       let composition = generateAllOf(
@@ -1361,7 +1426,7 @@ _PropertyGenerator.INCLUSION_RULES = {
 var PropertyGenerator = _PropertyGenerator;
 
 // src/utils/operation-filters.ts
-var import_minimatch = require("minimatch");
+var import_minimatch2 = require("minimatch");
 function createFilterStatistics() {
   return {
     totalOperations: 0,
@@ -1380,7 +1445,7 @@ function matchesAnyPattern(value, patterns) {
   if (!value) {
     return false;
   }
-  return patterns.some((pattern) => (0, import_minimatch.minimatch)(value, pattern));
+  return patterns.some((pattern) => (0, import_minimatch2.minimatch)(value, pattern));
 }
 function containsAny(arr, values) {
   if (!values || values.length === 0) {
@@ -1503,7 +1568,7 @@ var OpenApiGenerator = class {
     this.schemaUsageMap = /* @__PURE__ */ new Map();
     this.needsZodImport = true;
     this.filterStats = createFilterStatistics();
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     if (!options.input) {
       throw new ConfigurationError("Input path is required", { providedOptions: options });
     }
@@ -1513,21 +1578,27 @@ var OpenApiGenerator = class {
       output: options.output,
       includeDescriptions: (_a = options.includeDescriptions) != null ? _a : true,
       useDescribe: (_b = options.useDescribe) != null ? _b : false,
+      defaultNullable: (_c = options.defaultNullable) != null ? _c : false,
       schemaType: options.schemaType || "all",
       prefix: options.prefix,
       suffix: options.suffix,
       stripSchemaPrefix: options.stripSchemaPrefix,
-      showStats: (_c = options.showStats) != null ? _c : true,
+      stripPathPrefix: options.stripPathPrefix,
+      showStats: (_d = options.showStats) != null ? _d : true,
       request: options.request,
       response: options.response,
       operationFilters: options.operationFilters,
       ignoreHeaders: options.ignoreHeaders,
-      cacheSize: (_d = options.cacheSize) != null ? _d : 1e3,
-      batchSize: (_e = options.batchSize) != null ? _e : 10
+      cacheSize: (_e = options.cacheSize) != null ? _e : 1e3,
+      batchSize: (_f = options.batchSize) != null ? _f : 10,
+      customDateTimeFormatRegex: options.customDateTimeFormatRegex
     };
     if (this.options.cacheSize) {
       configurePatternCache(this.options.cacheSize);
     }
+    if (this.options.customDateTimeFormatRegex) {
+      configureDateTimeFormat(this.options.customDateTimeFormatRegex);
+    }
     try {
       const fs = require("fs");
       if (!fs.existsSync(this.options.input)) {
@@ -1590,6 +1661,7 @@ var OpenApiGenerator = class {
       mode: this.requestOptions.mode,
       includeDescriptions: this.requestOptions.includeDescriptions,
       useDescribe: this.requestOptions.useDescribe,
+      defaultNullable: (_g = this.options.defaultNullable) != null ? _g : false,
       namingOptions: {
         prefix: this.options.prefix,
         suffix: this.options.suffix
@@ -1607,6 +1679,9 @@ var OpenApiGenerator = class {
       throw new SpecValidationError("No schemas found in OpenAPI spec", { filePath: this.options.input });
     }
     for (const [name, schema] of Object.entries(this.spec.components.schemas)) {
+      if (this.options.operationFilters && this.schemaUsageMap.size > 0 && !this.schemaUsageMap.has(name)) {
+        continue;
+      }
       this.generateComponentSchema(name, schema);
     }
     this.generateQueryParameterSchemas();
@@ -1940,7 +2015,7 @@ var OpenApiGenerator = class {
    * Generate schema for a component
    */
   generateComponentSchema(name, schema) {
-    var _a, _b;
+    var _a, _b, _c;
     if (!this.schemaDependencies.has(name)) {
       this.schemaDependencies.set(name, /* @__PURE__ */ new Set());
     }
@@ -1972,14 +2047,14 @@ ${typeCode}`;
       mode: resolvedOptions.mode,
       includeDescriptions: resolvedOptions.includeDescriptions,
       useDescribe: resolvedOptions.useDescribe,
+      defaultNullable: (_b = this.options.defaultNullable) != null ? _b : false,
       namingOptions: {
         prefix: this.options.prefix,
         suffix: this.options.suffix
       },
       stripSchemaPrefix: this.options.stripSchemaPrefix
     });
-    const isAlias = !!(schema.$ref && !schema.properties && !schema.allOf && !schema.oneOf && !schema.anyOf);
-    const zodSchema = this.propertyGenerator.generatePropertySchema(schema, name, isAlias);
+    const zodSchema = this.propertyGenerator.generatePropertySchema(schema, name, true);
     const zodSchemaCode = `${jsdoc}export const ${schemaName} = ${zodSchema};`;
     if (zodSchema.includes("z.discriminatedUnion(")) {
       const match = zodSchema.match(/z\.discriminatedUnion\([^,]+,\s*\[([^\]]+)\]/);
@@ -1989,7 +2064,7 @@ ${typeCode}`;
           const depMatch = ref.match(/^([a-z][a-zA-Z0-9]*?)Schema$/);
           if (depMatch) {
             const depName = depMatch[1].charAt(0).toUpperCase() + depMatch[1].slice(1);
-            (_b = this.schemaDependencies.get(name)) == null ? void 0 : _b.add(depName);
+            (_c = this.schemaDependencies.get(name)) == null ? void 0 : _c.add(depName);
           }
         }
       }
@@ -2013,7 +2088,7 @@ ${typeCode}`;
         if (!shouldIncludeOperation(operation, path, method, this.options.operationFilters)) {
           continue;
         }
-        if (!operation.operationId || !operation.parameters || !Array.isArray(operation.parameters)) {
+        if (!operation.parameters || !Array.isArray(operation.parameters)) {
           continue;
         }
         const queryParams = operation.parameters.filter(
@@ -2022,7 +2097,13 @@ ${typeCode}`;
         if (queryParams.length === 0) {
           continue;
         }
-        const pascalOperationId = operation.operationId.includes("-") ? toPascalCase(operation.operationId) : operation.operationId.charAt(0).toUpperCase() + operation.operationId.slice(1);
+        let pascalOperationId;
+        if (operation.operationId) {
+          pascalOperationId = operation.operationId.includes("-") ? toPascalCase(operation.operationId) : operation.operationId.charAt(0).toUpperCase() + operation.operationId.slice(1);
+        } else {
+          const strippedPath = stripPathPrefix(path, this.options.stripPathPrefix);
+          pascalOperationId = this.generateMethodNameFromPath(method, strippedPath);
+        }
         const schemaName = `${pascalOperationId}QueryParams`;
         if (!this.schemaDependencies.has(schemaName)) {
           this.schemaDependencies.set(schemaName, /* @__PURE__ */ new Set());
@@ -2070,8 +2151,9 @@ ${propsCode}
         const prefixedName = this.options.prefix ? `${toPascalCase(this.options.prefix)}${operationName}` : operationName;
         const suffixedName = this.options.suffix ? `${prefixedName}${toPascalCase(this.options.suffix)}` : prefixedName;
         const camelCaseSchemaName = `${suffixedName.charAt(0).toLowerCase() + suffixedName.slice(1)}QueryParamsSchema`;
+        const jsdocOperationName = operation.operationId || `${method.toUpperCase()} ${path}`;
         const jsdoc = `/**
- * Query parameters for ${operation.operationId}
+ * Query parameters for ${jsdocOperationName}
  */
 `;
         const fullSchemaCode = `${jsdoc}export const ${camelCaseSchemaName} = ${schemaCode};`;
@@ -2080,6 +2162,35 @@ ${propsCode}
       }
     }
   }
+  /**
+   * Generate a PascalCase method name from HTTP method and path
+   * Used as fallback when operationId is not available
+   * @internal
+   */
+  generateMethodNameFromPath(method, path) {
+    const segments = path.split("/").filter(Boolean).map((segment) => {
+      if (segment.startsWith("{") && segment.endsWith("}")) {
+        const paramName = segment.slice(1, -1);
+        return `By${this.capitalizeSegment(paramName)}`;
+      }
+      return this.capitalizeSegment(segment);
+    }).join("");
+    const capitalizedMethod = method.charAt(0).toUpperCase() + method.slice(1).toLowerCase();
+    return `${capitalizedMethod}${segments}`;
+  }
+  /**
+   * Capitalizes a path segment, handling special characters like dashes, underscores, and dots
+   * @internal
+   */
+  capitalizeSegment(str) {
+    if (str.includes("-") || str.includes("_") || str.includes(".")) {
+      return str.split(/[-_.]/).map((part) => {
+        if (!part) return "";
+        return part.charAt(0).toUpperCase() + part.slice(1).toLowerCase();
+      }).join("");
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1);
+  }
   /**
    * Check if a header should be ignored based on filter patterns
    * @internal
@@ -2095,7 +2206,7 @@ ${propsCode}
     const headerLower = headerName.toLowerCase();
     return ignorePatterns.some((pattern) => {
       const patternLower = pattern.toLowerCase();
-      return (0, import_minimatch2.minimatch)(headerLower, patternLower);
+      return (0, import_minimatch3.minimatch)(headerLower, patternLower);
     });
   }
   /**
@@ -2116,7 +2227,7 @@ ${propsCode}
         if (!shouldIncludeOperation(operation, path, method, this.options.operationFilters)) {
           continue;
         }
-        if (!operation.operationId || !operation.parameters || !Array.isArray(operation.parameters)) {
+        if (!operation.parameters || !Array.isArray(operation.parameters)) {
           continue;
         }
         const headerParams = operation.parameters.filter(
@@ -2125,7 +2236,13 @@ ${propsCode}
         if (headerParams.length === 0) {
           continue;
         }
-        const pascalOperationId = operation.operationId.includes("-") ? toPascalCase(operation.operationId) : operation.operationId.charAt(0).toUpperCase() + operation.operationId.slice(1);
+        let pascalOperationId;
+        if (operation.operationId) {
+          pascalOperationId = operation.operationId.includes("-") ? toPascalCase(operation.operationId) : operation.operationId.charAt(0).toUpperCase() + operation.operationId.slice(1);
+        } else {
+          const strippedPath = stripPathPrefix(path, this.options.stripPathPrefix);
+          pascalOperationId = this.generateMethodNameFromPath(method, strippedPath);
+        }
         const schemaName = `${pascalOperationId}HeaderParams`;
         if (!this.schemaDependencies.has(schemaName)) {
           this.schemaDependencies.set(schemaName, /* @__PURE__ */ new Set());
@@ -2162,8 +2279,9 @@ ${propsCode}
         const prefixedName = this.options.prefix ? `${toPascalCase(this.options.prefix)}${operationName}` : operationName;
         const suffixedName = this.options.suffix ? `${prefixedName}${toPascalCase(this.options.suffix)}` : prefixedName;
         const camelCaseSchemaName = `${suffixedName.charAt(0).toLowerCase() + suffixedName.slice(1)}HeaderParamsSchema`;
+        const jsdocOperationName = operation.operationId || `${method.toUpperCase()} ${path}`;
         const jsdoc = `/**
- * Header parameters for ${operation.operationId}
+ * Header parameters for ${jsdocOperationName}
  */
 `;
         const fullSchemaCode = `${jsdoc}export const ${camelCaseSchemaName} = ${schemaCode};`;
@@ -2183,8 +2301,22 @@ ${propsCode}
       return `${schemaName}Schema`;
     }
     if (schema.enum) {
-      const enumValues = schema.enum.map((v) => typeof v === "string" ? `"${v}"` : v).join(", ");
-      return `z.enum([${enumValues}])`;
+      const allBooleans = schema.enum.every((v) => typeof v === "boolean");
+      if (allBooleans) {
+        return "z.boolean()";
+      }
+      const allStrings = schema.enum.every((v) => typeof v === "string");
+      if (allStrings) {
+        const enumValues = schema.enum.map((v) => `"${v}"`).join(", ");
+        return `z.enum([${enumValues}])`;
+      }
+      const literalValues = schema.enum.map((v) => {
+        if (typeof v === "string") {
+          return `z.literal("${v}")`;
+        }
+        return `z.literal(${v})`;
+      }).join(", ");
+      return `z.union([${literalValues}])`;
     }
     const type = schema.type;
     if (type === "string") {