@cerios/openapi-to-zod 1.1.1 → 1.2.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { O as OpenApiGeneratorOptions } from './types-CI48CjiU.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-CI48CjiU.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-CI48CjiU.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-CI48CjiU.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

@@ -190,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)) {
@@ -363,6 +366,22 @@ function stripPrefix(input, pattern, ensureLeadingChar) {
   }
   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) {
@@ -888,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()",
@@ -898,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()",
@@ -917,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) {
@@ -1206,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);
@@ -1525,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 });
     }
@@ -1535,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)) {
@@ -1612,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
@@ -1965,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());
     }
@@ -1997,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*\[([^\]]+)\]/);
@@ -2014,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);
           }
         }
       }
@@ -2038,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(
@@ -2047,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());
@@ -2095,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};`;
@@ -2105,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
@@ -2141,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(
@@ -2150,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());
@@ -2187,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};`;