@cerios/openapi-to-zod 1.1.0 → 1.2.0

package/dist/internal.d.mts

@@ -1,4 +1,4 @@
-import { E as ExecutionMode, d as OperationFilters } from './types-B7ePTDjr.mjs';
+import { E as ExecutionMode, d as OperationFilters } from './types--r0d47sd.mjs';
 import { z } from 'zod';
 import { Loader } from 'cosmiconfig';
 
@@ -59,6 +59,7 @@ declare const RequestResponseOptionsSchema: z.ZodObject<{
     }>>;
     useDescribe: z.ZodOptional<z.ZodBoolean>;
     includeDescriptions: z.ZodOptional<z.ZodBoolean>;
+    defaultNullable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 /**
  * @shared Base Zod schema for operation filters (without status codes)
@@ -188,20 +189,12 @@ declare function validateFilters(stats: FilterStatistics, filters?: OperationFil
 declare function formatFilterStatistics(stats: FilterStatistics): string;
 
 /**
- * Pattern matching utilities for prefix stripping
- *
- * Shared utility used by core and playwright packages
- *
- * Supports both literal string matching and regex patterns for stripping
- * prefixes from strings (paths, schema names, etc.)
- */
-/**
- * @shared Strips a prefix from a string using either literal string matching or regex
+ * @shared Strips a prefix from a string using either literal string matching or glob patterns
  * @since 1.1.0
  * Shared utility used by core and playwright packages
  *
  * @param input - The full string to strip from
- * @param pattern - The pattern to strip (string or RegExp)
+ * @param pattern - The glob pattern to strip
  * @param ensureLeadingChar - Optional character to ensure at start (e.g., "/" for paths)
  * @returns The string with prefix removed, or original string if no match
  *
@@ -211,25 +204,27 @@ declare function formatFilterStatistics(stats: FilterStatistics): string;
  * stripPrefix("Company.Models.User", "Company.Models.") // => "User"
  *
  * @example
- * // Regex pattern matching
- * stripPrefix("/api/v1.0/users", "^/api/v\\d+\\.\\d+") // => "/users"
- * stripPrefix("api_v2_UserSchema", "^api_v\\d+_") // => "UserSchema"
+ * // Glob pattern matching
+ * stripPrefix("/api/v1.0/users", "/api/v*") // => matches and strips
+ * stripPrefix("Company.Models.User", "*.Models.") // => "User"
+ * stripPrefix("api_v2_UserSchema", "api_v[0-9]_") // => "UserSchema"
  */
-declare function stripPrefix(input: string, pattern: string | RegExp | undefined, ensureLeadingChar?: string): string;
+declare function stripPrefix(input: string, pattern: string | undefined, ensureLeadingChar?: string): string;
 /**
  * @shared Strips a prefix from a path (ensures leading slash)
  * @since 1.1.0
  * Shared utility used by playwright package for path manipulation
  *
  * @param path - The full path to strip from
- * @param pattern - The pattern to strip (string or RegExp)
+ * @param pattern - The glob pattern to strip
  * @returns The path with prefix removed, or original path if no match
  *
  * @example
  * stripPathPrefix("/api/v1/users", "/api/v1") // => "/users"
- * stripPathPrefix("/api/v2/posts", "^/api/v\\d+") // => "/posts"
+ * stripPathPrefix("/api/v2/posts", "/api/v*") // => "/posts"
+ * stripPathPrefix("/api/v1.0/items", "/api/v[0-9].*") // => "/items"
  */
-declare function stripPathPrefix(path: string, pattern: string | RegExp | undefined): string;
+declare function stripPathPrefix(path: string, pattern: string | undefined): string;
 
 /**
  * String utility functions for escaping and formatting
@@ -254,4 +249,24 @@ declare function escapeJSDoc(str: string): string;
  */
 declare function createTypeScriptLoader(): Loader;
 
-export { type BaseOperationFilters, type FilterStatistics, type Generator, LRUCache, OperationFiltersSchema, type RequestResponseOptions, RequestResponseOptionsSchema, createFilterStatistics, createTypeScriptLoader, escapeJSDoc, executeBatch, formatConfigValidationError, formatFilterStatistics, getBatchExitCode, shouldIncludeOperation, stripPathPrefix, stripPrefix, toCamelCase, toPascalCase, validateFilters };
+/**
+ * Configure custom date-time format validation
+ * Overrides the default z.iso.datetime() with a custom regex pattern
+ *
+ * @param pattern - Regex pattern (string or RegExp) for date-time validation
+ * @throws {Error} If the provided pattern is not a valid regular expression
+ * @example
+ * // String pattern (required for JSON/YAML configs)
+ * configureDateTimeFormat('^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$')
+ *
+ * @example
+ * // RegExp literal (TypeScript configs only)
+ * configureDateTimeFormat(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/)
+ */
+declare function configureDateTimeFormat(pattern?: string | RegExp): void;
+/**
+ * Reset format map to defaults (useful for testing)
+ */
+declare function resetFormatMap(): void;
+
+export { type BaseOperationFilters, type FilterStatistics, type Generator, LRUCache, OperationFiltersSchema, type RequestResponseOptions, RequestResponseOptionsSchema, configureDateTimeFormat, createFilterStatistics, createTypeScriptLoader, escapeJSDoc, executeBatch, formatConfigValidationError, formatFilterStatistics, getBatchExitCode, resetFormatMap, shouldIncludeOperation, stripPathPrefix, stripPrefix, toCamelCase, toPascalCase, validateFilters };

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-import { E as ExecutionMode, d as OperationFilters } from './types-B7ePTDjr.js';
+import { E as ExecutionMode, d as OperationFilters } from './types--r0d47sd.js';
 import { z } from 'zod';
 import { Loader } from 'cosmiconfig';
 
@@ -59,6 +59,7 @@ declare const RequestResponseOptionsSchema: z.ZodObject<{
     }>>;
     useDescribe: z.ZodOptional<z.ZodBoolean>;
     includeDescriptions: z.ZodOptional<z.ZodBoolean>;
+    defaultNullable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 /**
  * @shared Base Zod schema for operation filters (without status codes)
@@ -188,20 +189,12 @@ declare function validateFilters(stats: FilterStatistics, filters?: OperationFil
 declare function formatFilterStatistics(stats: FilterStatistics): string;
 
 /**
- * Pattern matching utilities for prefix stripping
- *
- * Shared utility used by core and playwright packages
- *
- * Supports both literal string matching and regex patterns for stripping
- * prefixes from strings (paths, schema names, etc.)
- */
-/**
- * @shared Strips a prefix from a string using either literal string matching or regex
+ * @shared Strips a prefix from a string using either literal string matching or glob patterns
  * @since 1.1.0
  * Shared utility used by core and playwright packages
  *
  * @param input - The full string to strip from
- * @param pattern - The pattern to strip (string or RegExp)
+ * @param pattern - The glob pattern to strip
  * @param ensureLeadingChar - Optional character to ensure at start (e.g., "/" for paths)
  * @returns The string with prefix removed, or original string if no match
  *
@@ -211,25 +204,27 @@ declare function formatFilterStatistics(stats: FilterStatistics): string;
  * stripPrefix("Company.Models.User", "Company.Models.") // => "User"
  *
  * @example
- * // Regex pattern matching
- * stripPrefix("/api/v1.0/users", "^/api/v\\d+\\.\\d+") // => "/users"
- * stripPrefix("api_v2_UserSchema", "^api_v\\d+_") // => "UserSchema"
+ * // Glob pattern matching
+ * stripPrefix("/api/v1.0/users", "/api/v*") // => matches and strips
+ * stripPrefix("Company.Models.User", "*.Models.") // => "User"
+ * stripPrefix("api_v2_UserSchema", "api_v[0-9]_") // => "UserSchema"
  */
-declare function stripPrefix(input: string, pattern: string | RegExp | undefined, ensureLeadingChar?: string): string;
+declare function stripPrefix(input: string, pattern: string | undefined, ensureLeadingChar?: string): string;
 /**
  * @shared Strips a prefix from a path (ensures leading slash)
  * @since 1.1.0
  * Shared utility used by playwright package for path manipulation
  *
  * @param path - The full path to strip from
- * @param pattern - The pattern to strip (string or RegExp)
+ * @param pattern - The glob pattern to strip
  * @returns The path with prefix removed, or original path if no match
  *
  * @example
  * stripPathPrefix("/api/v1/users", "/api/v1") // => "/users"
- * stripPathPrefix("/api/v2/posts", "^/api/v\\d+") // => "/posts"
+ * stripPathPrefix("/api/v2/posts", "/api/v*") // => "/posts"
+ * stripPathPrefix("/api/v1.0/items", "/api/v[0-9].*") // => "/items"
  */
-declare function stripPathPrefix(path: string, pattern: string | RegExp | undefined): string;
+declare function stripPathPrefix(path: string, pattern: string | undefined): string;
 
 /**
  * String utility functions for escaping and formatting
@@ -254,4 +249,24 @@ declare function escapeJSDoc(str: string): string;
  */
 declare function createTypeScriptLoader(): Loader;
 
-export { type BaseOperationFilters, type FilterStatistics, type Generator, LRUCache, OperationFiltersSchema, type RequestResponseOptions, RequestResponseOptionsSchema, createFilterStatistics, createTypeScriptLoader, escapeJSDoc, executeBatch, formatConfigValidationError, formatFilterStatistics, getBatchExitCode, shouldIncludeOperation, stripPathPrefix, stripPrefix, toCamelCase, toPascalCase, validateFilters };
+/**
+ * Configure custom date-time format validation
+ * Overrides the default z.iso.datetime() with a custom regex pattern
+ *
+ * @param pattern - Regex pattern (string or RegExp) for date-time validation
+ * @throws {Error} If the provided pattern is not a valid regular expression
+ * @example
+ * // String pattern (required for JSON/YAML configs)
+ * configureDateTimeFormat('^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$')
+ *
+ * @example
+ * // RegExp literal (TypeScript configs only)
+ * configureDateTimeFormat(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/)
+ */
+declare function configureDateTimeFormat(pattern?: string | RegExp): void;
+/**
+ * Reset format map to defaults (useful for testing)
+ */
+declare function resetFormatMap(): void;
+
+export { type BaseOperationFilters, type FilterStatistics, type Generator, LRUCache, OperationFiltersSchema, type RequestResponseOptions, RequestResponseOptionsSchema, configureDateTimeFormat, createFilterStatistics, createTypeScriptLoader, escapeJSDoc, executeBatch, formatConfigValidationError, formatFilterStatistics, getBatchExitCode, resetFormatMap, shouldIncludeOperation, stripPathPrefix, stripPrefix, toCamelCase, toPascalCase, validateFilters };

package/dist/internal.js

@@ -33,6 +33,7 @@ __export(internal_exports, {
   LRUCache: () => LRUCache,
   OperationFiltersSchema: () => OperationFiltersSchema,
   RequestResponseOptionsSchema: () => RequestResponseOptionsSchema,
+  configureDateTimeFormat: () => configureDateTimeFormat,
   createFilterStatistics: () => createFilterStatistics,
   createTypeScriptLoader: () => createTypeScriptLoader,
   escapeJSDoc: () => escapeJSDoc,
@@ -40,6 +41,7 @@ __export(internal_exports, {
   formatConfigValidationError: () => formatConfigValidationError,
   formatFilterStatistics: () => formatFilterStatistics,
   getBatchExitCode: () => getBatchExitCode,
+  resetFormatMap: () => resetFormatMap,
   shouldIncludeOperation: () => shouldIncludeOperation,
   stripPathPrefix: () => stripPathPrefix,
   stripPrefix: () => stripPrefix,
@@ -184,7 +186,8 @@ var import_zod = require("zod");
 var RequestResponseOptionsSchema = import_zod.z.strictObject({
   mode: import_zod.z.enum(["strict", "normal", "loose"]).optional(),
   useDescribe: import_zod.z.boolean().optional(),
-  includeDescriptions: import_zod.z.boolean().optional()
+  includeDescriptions: import_zod.z.boolean().optional(),
+  defaultNullable: import_zod.z.boolean().optional()
 });
 var OperationFiltersSchema = import_zod.z.strictObject({
   includeTags: import_zod.z.array(import_zod.z.string()).optional(),
@@ -446,61 +449,36 @@ function formatFilterStatistics(stats) {
 }
 
 // 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_minimatch2 = require("minimatch");
+function isValidGlobPattern(pattern) {
+  try {
+    new import_minimatch2.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_minimatch2.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;
@@ -509,8 +487,21 @@ 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;
 }
@@ -518,8 +509,7 @@ function stripPathPrefix(path, pattern) {
   if (!pattern) {
     return path;
   }
-  const regex = patternToRegex(pattern);
-  if (!regex) {
+  if (!isGlobPattern(pattern)) {
     let normalizedPattern = pattern.trim();
     if (!normalizedPattern.startsWith("/")) {
       normalizedPattern = `/${normalizedPattern}`;
@@ -529,10 +519,13 @@ function stripPathPrefix(path, pattern) {
     }
     return stripPrefix(path, normalizedPattern, "/");
   }
-  return stripPrefix(path, regex, "/");
+  return stripPrefix(path, pattern, "/");
 }
 
 // src/utils/string-utils.ts
+function escapePattern(str) {
+  return str.replace(/\//g, "\\/");
+}
 function escapeJSDoc(str) {
   return str.replace(/\*\//g, "*\\/");
 }
@@ -570,11 +563,73 @@ function createTypeScriptLoader() {
     }
   };
 }
+
+// src/validators/string-validator.ts
+var PATTERN_CACHE = new LRUCache(1e3);
+var DEFAULT_FORMAT_MAP = {
+  uuid: "z.uuid()",
+  email: "z.email()",
+  uri: "z.url()",
+  url: "z.url()",
+  "uri-reference": 'z.string().refine((val) => !/\\s/.test(val), { message: "Must be a valid URI reference" })',
+  hostname: 'z.string().refine((val) => /^(?=.{1,253}$)(?:(?!-)[A-Za-z0-9-]{1,63}(?<!-)\\.)*(?!-)[A-Za-z0-9-]{1,63}(?<!-)$/.test(val), { message: "Must be a valid hostname" })',
+  byte: "z.base64()",
+  binary: "z.string()",
+  date: "z.iso.date()",
+  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()",
+  ipv6: "z.ipv6()",
+  emoji: "z.emoji()",
+  base64: "z.base64()",
+  base64url: "z.base64url()",
+  nanoid: "z.nanoid()",
+  cuid: "z.cuid()",
+  cuid2: "z.cuid2()",
+  ulid: "z.ulid()",
+  cidr: "z.cidrv4()",
+  // Default to v4
+  cidrv4: "z.cidrv4()",
+  cidrv6: "z.cidrv6()",
+  "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 resetFormatMap() {
+  FORMAT_MAP = {
+    ...DEFAULT_FORMAT_MAP,
+    "date-time": "z.iso.datetime()"
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LRUCache,
   OperationFiltersSchema,
   RequestResponseOptionsSchema,
+  configureDateTimeFormat,
   createFilterStatistics,
   createTypeScriptLoader,
   escapeJSDoc,
@@ -582,6 +637,7 @@ function createTypeScriptLoader() {
   formatConfigValidationError,
   formatFilterStatistics,
   getBatchExitCode,
+  resetFormatMap,
   shouldIncludeOperation,
   stripPathPrefix,
   stripPrefix,