@cerios/openapi-to-zod 1.3.0 → 1.3.2

package/dist/internal.mjs

@@ -141,7 +141,8 @@ var RequestResponseOptionsSchema = z.strictObject({
   mode: z.enum(["strict", "normal", "loose"]).optional(),
   useDescribe: z.boolean().optional(),
   includeDescriptions: z.boolean().optional(),
-  defaultNullable: z.boolean().optional()
+  defaultNullable: z.boolean().optional(),
+  emptyObjectBehavior: z.enum(["strict", "loose", "record"]).optional()
 });
 var OperationFiltersSchema = z.strictObject({
   includeTags: z.array(z.string()).optional(),
@@ -181,6 +182,45 @@ function formatConfigValidationError(error, filepath, configPath, additionalNote
   return lines.join("\n");
 }
 
+// src/utils/content-type-utils.ts
+function getResponseParseMethod(contentType, fallback = "text") {
+  if (!contentType) {
+    return { method: fallback, isUnknown: true };
+  }
+  const normalized = contentType.toLowerCase().split(";")[0].trim();
+  if (!normalized) {
+    return { method: fallback, isUnknown: true };
+  }
+  if (normalized === "application/json" || normalized === "text/json" || normalized.endsWith("+json")) {
+    return { method: "json", isUnknown: false };
+  }
+  if (normalized.startsWith("text/")) {
+    return { method: "text", isUnknown: false };
+  }
+  if (normalized === "application/xml" || normalized.endsWith("+xml")) {
+    return { method: "text", isUnknown: false };
+  }
+  if (normalized === "application/javascript" || normalized === "application/x-javascript" || normalized === "application/ecmascript") {
+    return { method: "text", isUnknown: false };
+  }
+  if (normalized.startsWith("image/")) {
+    return { method: "body", isUnknown: false };
+  }
+  if (normalized.startsWith("audio/")) {
+    return { method: "body", isUnknown: false };
+  }
+  if (normalized.startsWith("video/")) {
+    return { method: "body", isUnknown: false };
+  }
+  if (normalized.startsWith("font/")) {
+    return { method: "body", isUnknown: false };
+  }
+  if (normalized === "application/octet-stream" || normalized === "application/pdf" || normalized === "application/zip" || normalized === "application/gzip" || normalized === "application/x-tar" || normalized === "application/x-7z-compressed" || normalized === "application/x-rar-compressed" || normalized === "application/wasm" || normalized === "application/x-protobuf") {
+    return { method: "body", isUnknown: false };
+  }
+  return { method: fallback, isUnknown: true };
+}
+
 // src/utils/lru-cache.ts
 var LRUCache = class {
   constructor(maxSize) {
@@ -236,12 +276,12 @@ function toCamelCase(str, options) {
     name = words[0].charAt(0).toLowerCase() + words[0].slice(1) + words.slice(1).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
   }
   if (options == null ? void 0 : options.prefix) {
-    const prefix = options.prefix.toLowerCase();
+    const prefix = options.prefix.charAt(0).toLowerCase() + options.prefix.slice(1);
     name = prefix + name.charAt(0).toUpperCase() + name.slice(1);
   }
   if (options == null ? void 0 : options.suffix) {
-    const suffix = options.suffix;
-    name = name + suffix.charAt(0).toUpperCase() + suffix.slice(1).toLowerCase();
+    const suffix = options.suffix.charAt(0).toUpperCase() + options.suffix.slice(1);
+    name = name + suffix;
   }
   return name;
 }
@@ -649,6 +689,7 @@ export {
   formatConfigValidationError,
   formatFilterStatistics,
   getBatchExitCode,
+  getResponseParseMethod,
   mergeParameters,
   resetFormatMap,
   resolveParameterRef,

package/dist/internal.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/batch-executor.ts","../src/utils/config-schemas.ts","../src/utils/config-validation.ts","../src/utils/lru-cache.ts","../src/utils/name-utils.ts","../src/utils/operation-filters.ts","../src/utils/pattern-utils.ts","../src/utils/ref-resolver.ts","../src/utils/string-utils.ts","../src/utils/typescript-loader.ts","../src/validators/string-validator.ts"],"sourcesContent":["/**\n * Custom error classes for better error handling and debugging\n */\n\n/**\n * Base error class for all generator errors\n */\nexport class GeneratorError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly code: string,\n\t\tpublic readonly context?: Record<string, unknown>\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"GeneratorError\";\n\t\tError.captureStackTrace?.(this, this.constructor);\n\t}\n}\n\n/**\n * Error thrown when OpenAPI spec validation fails\n */\nexport class SpecValidationError extends GeneratorError {\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message, \"SPEC_VALIDATION_ERROR\", context);\n\t\tthis.name = \"SpecValidationError\";\n\t}\n}\n\n/**\n * Error thrown when file operations fail\n */\nexport class FileOperationError extends GeneratorError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly filePath: string,\n\t\tcontext?: Record<string, unknown>\n\t) {\n\t\tsuper(message, \"FILE_OPERATION_ERROR\", { ...context, filePath });\n\t\tthis.name = \"FileOperationError\";\n\t}\n}\n\n/**\n * Error thrown when config file is invalid\n */\nexport class ConfigValidationError extends GeneratorError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly configPath?: string,\n\t\tcontext?: Record<string, unknown>\n\t) {\n\t\tsuper(message, \"CONFIG_VALIDATION_ERROR\", { ...context, configPath });\n\t\tthis.name = \"ConfigValidationError\";\n\t}\n}\n\n/**\n * Error thrown when schema generation fails\n */\nexport class SchemaGenerationError extends GeneratorError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly schemaName: string,\n\t\tcontext?: Record<string, unknown>\n\t) {\n\t\tsuper(message, \"SCHEMA_GENERATION_ERROR\", { ...context, schemaName });\n\t\tthis.name = \"SchemaGenerationError\";\n\t}\n}\n\n/**\n * Error thrown when circular reference is detected in schema\n */\nexport class CircularReferenceError extends SchemaGenerationError {\n\tconstructor(\n\t\tschemaName: string,\n\t\tpublic readonly referencePath: string[]\n\t) {\n\t\tconst pathStr = referencePath.join(\" -> \");\n\t\tsuper(`Circular reference detected in schema: ${pathStr}`, schemaName, { referencePath, circularPath: pathStr });\n\t\tthis.name = \"CircularReferenceError\";\n\t}\n}\n\n/**\n * Error thrown when CLI options are invalid\n */\nexport class CliOptionsError extends GeneratorError {\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message, \"CLI_OPTIONS_ERROR\", context);\n\t\tthis.name = \"CliOptionsError\";\n\t}\n}\n\n/**\n * Error thrown when configuration is invalid or missing required values\n */\nexport class ConfigurationError extends GeneratorError {\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message, \"CONFIGURATION_ERROR\", context);\n\t\tthis.name = \"ConfigurationError\";\n\t}\n}\n","import { ConfigurationError } from \"./errors\";\nimport type { ExecutionMode } from \"./types\";\n\n/**\n * @shared Generator interface for batch execution\n * @since 1.0.0\n * Interface that both OpenApiGenerator and OpenApiPlaywrightGenerator must implement\n */\nexport interface Generator {\n\tgenerate(): void;\n}\n\n/**\n * Result of processing a single spec\n */\ninterface SpecResult<T> {\n\tspec: T;\n\tsuccess: boolean;\n\terror?: string;\n}\n\n/**\n * Summary of batch execution results\n */\ninterface BatchExecutionSummary<T> {\n\ttotal: number;\n\tsuccessful: number;\n\tfailed: number;\n\tresults: SpecResult<T>[];\n}\n\n/**\n * Process a single spec and return result with error handling\n */\nasync function processSpec<T>(\n\tspec: T,\n\tindex: number,\n\ttotal: number,\n\tcreateGenerator: (spec: T) => Generator\n): Promise<SpecResult<T>> {\n\t// Live progress to stdout\n\tconst specInput = (spec as any).input || \"spec\";\n\tconst specOutput = (spec as any).output || \"output\";\n\tconsole.log(`Processing [${index + 1}/${total}] ${specInput}...`);\n\n\ttry {\n\t\tconst generator = createGenerator(spec);\n\t\tgenerator.generate();\n\n\t\treturn {\n\t\t\tspec,\n\t\t\tsuccess: true,\n\t\t};\n\t} catch (error) {\n\t\tconst errorMessage = error instanceof Error ? error.message : String(error);\n\t\tconsole.error(`✗ Failed to generate ${specOutput}: ${errorMessage}`);\n\n\t\treturn {\n\t\t\tspec,\n\t\t\tsuccess: false,\n\t\t\terror: errorMessage,\n\t\t};\n\t}\n}\n\n/**\n * Execute specs in parallel using Promise.allSettled with configurable batch size\n * Processes specifications in batches to control memory usage and concurrency\n * Continues processing all specs even if some fail\n */\nasync function executeParallel<T>(\n\tspecs: T[],\n\tcreateGenerator: (spec: T) => Generator,\n\tbatchSize: number\n): Promise<SpecResult<T>[]> {\n\tconsole.log(`\\nExecuting ${specs.length} specification(s) in parallel (batch size: ${batchSize})...\\n`);\n\n\tconst results: SpecResult<T>[] = [];\n\n\t// Process in batches to control memory usage\n\tfor (let i = 0; i < specs.length; i += batchSize) {\n\t\tconst batch = specs.slice(i, Math.min(i + batchSize, specs.length));\n\t\tconst batchPromises = batch.map((spec, batchIndex) =>\n\t\t\tprocessSpec(spec, i + batchIndex, specs.length, createGenerator)\n\t\t);\n\n\t\tconst batchResults = await Promise.allSettled(batchPromises);\n\n\t\t// Convert settled results to SpecResult\n\t\tfor (let j = 0; j < batchResults.length; j++) {\n\t\t\tconst result = batchResults[j];\n\t\t\tif (result.status === \"fulfilled\") {\n\t\t\t\tresults.push(result.value);\n\t\t\t} else {\n\t\t\t\t// Handle unexpected promise rejection\n\t\t\t\tresults.push({\n\t\t\t\t\tspec: batch[j],\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: result.reason instanceof Error ? result.reason.message : String(result.reason),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\treturn results;\n}\n\n/**\n * Execute specs sequentially one at a time\n * Continues processing all specs even if some fail\n */\nasync function executeSequential<T>(specs: T[], createGenerator: (spec: T) => Generator): Promise<SpecResult<T>[]> {\n\tconsole.log(`\\nExecuting ${specs.length} spec(s) sequentially...\\n`);\n\n\tconst results: SpecResult<T>[] = [];\n\n\tfor (let i = 0; i < specs.length; i++) {\n\t\tconst result = await processSpec(specs[i], i, specs.length, createGenerator);\n\t\tresults.push(result);\n\t}\n\n\treturn results;\n}\n\n/**\n * Print final summary of batch execution\n */\nfunction printSummary<T>(summary: BatchExecutionSummary<T>): void {\n\tconsole.log(`\\n${\"=\".repeat(50)}`);\n\tconsole.log(\"Batch Execution Summary\");\n\tconsole.log(\"=\".repeat(50));\n\tconsole.log(`Total specs: ${summary.total}`);\n\tconsole.log(`Successful: ${summary.successful}`);\n\tconsole.log(`Failed: ${summary.failed}`);\n\n\tif (summary.failed > 0) {\n\t\tconsole.log(\"\\nFailed specs:\");\n\t\tfor (const result of summary.results) {\n\t\t\tif (!result.success) {\n\t\t\t\tconst specInput = (result.spec as any).input || \"spec\";\n\t\t\t\tconsole.error(`  ✗ ${specInput}`);\n\t\t\t\tconsole.error(`    Error: ${result.error}`);\n\t\t\t}\n\t\t}\n\t}\n\n\tconsole.log(`${\"=\".repeat(50)}\\n`);\n}\n\n/**\n * @shared Execute batch processing of multiple specs with custom generator\n * @since 1.0.0\n * Utility used by core and playwright packages\n *\n * @param specs - Array of spec configurations to process\n * @param executionMode - Execution mode: \"parallel\" (default) or \"sequential\"\n * @param createGenerator - Factory function to create generator from spec\n * @param batchSize - Number of specifications to process concurrently in parallel mode\n * @returns BatchExecutionSummary with results\n * @throws Never throws - collects all errors and reports them\n */\nexport async function executeBatch<T>(\n\tspecs: T[],\n\texecutionMode: ExecutionMode = \"parallel\",\n\tcreateGenerator: (spec: T) => Generator,\n\tbatchSize: number\n): Promise<BatchExecutionSummary<T>> {\n\tif (specs.length === 0) {\n\t\tthrow new ConfigurationError(\"No specs provided for batch execution\", { specsCount: 0, executionMode });\n\t}\n\n\tlet results: SpecResult<T>[] = [];\n\n\ttry {\n\t\t// Execute based on mode\n\t\tresults =\n\t\t\texecutionMode === \"parallel\"\n\t\t\t\t? await executeParallel(specs, createGenerator, batchSize)\n\t\t\t\t: await executeSequential(specs, createGenerator);\n\n\t\t// Calculate summary\n\t\tconst summary: BatchExecutionSummary<T> = {\n\t\t\ttotal: results.length,\n\t\t\tsuccessful: results.filter(r => r.success).length,\n\t\t\tfailed: results.filter(r => !r.success).length,\n\t\t\tresults,\n\t\t};\n\n\t\t// Print summary\n\t\tprintSummary(summary);\n\n\t\treturn summary;\n\t} finally {\n\t\t// Memory leak prevention: Clear large result objects and hint GC for large batches\n\t\tif (results.length > batchSize) {\n\t\t\t// Clear spec references to allow GC\n\t\t\tfor (const result of results) {\n\t\t\t\t// Keep only essential info, clear large objects\n\t\t\t\tif (result.spec) {\n\t\t\t\t\t(result.spec as any) = null;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Hint to V8 garbage collector for large batches (if available)\n\t\t\tif (global.gc) {\n\t\t\t\tglobal.gc();\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Determine exit code based on batch execution results\n * Returns 1 if any spec failed, 0 if all succeeded\n */\nexport function getBatchExitCode<T>(summary: BatchExecutionSummary<T>): number {\n\treturn summary.failed > 0 ? 1 : 0;\n}\n","import { z } from \"zod\";\n\n/**\n * @shared Zod schema for request/response options validation\n * @since 1.0.0\n * Utility used by core and playwright packages\n */\nexport const RequestResponseOptionsSchema = z.strictObject({\n\tmode: z.enum([\"strict\", \"normal\", \"loose\"]).optional(),\n\tuseDescribe: z.boolean().optional(),\n\tincludeDescriptions: z.boolean().optional(),\n\tdefaultNullable: z.boolean().optional(),\n});\n\n/**\n * @shared Base Zod schema for operation filters (without status codes)\n * @since 1.0.0\n * Utility used by core and playwright packages\n */\nexport const OperationFiltersSchema = z.strictObject({\n\tincludeTags: z.array(z.string()).optional(),\n\texcludeTags: z.array(z.string()).optional(),\n\tincludePaths: z.array(z.string()).optional(),\n\texcludePaths: z.array(z.string()).optional(),\n\tincludeMethods: z.array(z.string()).optional(),\n\texcludeMethods: z.array(z.string()).optional(),\n\tincludeOperationIds: z.array(z.string()).optional(),\n\texcludeOperationIds: z.array(z.string()).optional(),\n\texcludeDeprecated: z.boolean().optional(),\n});\n\n/**\n * Inferred TypeScript type for request/response options\n */\nexport type RequestResponseOptions = z.infer<typeof RequestResponseOptionsSchema>;\n\n/**\n * Inferred TypeScript type for base operation filters\n */\nexport type BaseOperationFilters = z.infer<typeof OperationFiltersSchema>;\n","import { z } from \"zod\";\n\n/**\n * @shared Format Zod validation errors into user-friendly error messages\n * @since 1.0.0\n * Utility used by core and playwright packages\n *\n * @param error - The Zod validation error\n * @param filepath - Path to the config file that was being validated\n * @param configPath - Optional explicit config path provided by user\n * @param additionalNotes - Optional array of additional notes to append to the error message\n * @returns Formatted error message string\n */\nexport function formatConfigValidationError(\n\terror: z.ZodError,\n\tfilepath: string | undefined,\n\tconfigPath: string | undefined,\n\tadditionalNotes?: string[]\n): string {\n\tconst formattedErrors =\n\t\terror.issues\n\t\t\t?.map(err => {\n\t\t\t\tconst path = err.path.length > 0 ? err.path.join(\".\") : \"root\";\n\t\t\t\treturn `  - ${path}: ${err.message}`;\n\t\t\t})\n\t\t\t.join(\"\\n\") || \"Unknown validation error\";\n\n\tconst configSource = filepath || configPath || \"config file\";\n\tconst lines = [\n\t\t`Invalid configuration file at: ${configSource}`,\n\t\t\"\",\n\t\t\"Validation errors:\",\n\t\tformattedErrors,\n\t\t\"\",\n\t\t\"Please check your configuration file and ensure:\",\n\t\t\"  - All required fields are present (specs array with input/output)\",\n\t\t\"  - Field names are spelled correctly (no typos)\",\n\t\t\"  - Values match the expected types (e.g., mode: 'strict' | 'normal' | 'loose')\",\n\t\t\"  - No unknown/extra properties are included\",\n\t];\n\n\tif (additionalNotes && additionalNotes.length > 0) {\n\t\tlines.push(...additionalNotes.map(note => `  - ${note}`));\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n","/**\n * @shared Simple LRU Cache implementation for performance optimization\n * @since 1.0.0\n * Utility used by core and playwright packages\n * Prevents memory leaks from unbounded cache growth\n */\nexport class LRUCache<K, V> {\n\tprivate cache = new Map<K, V>();\n\tprivate maxSize: number;\n\n\tconstructor(maxSize: number) {\n\t\tthis.maxSize = maxSize;\n\t}\n\n\tget capacity(): number {\n\t\treturn this.maxSize;\n\t}\n\n\tget(key: K): V | undefined {\n\t\tif (!this.cache.has(key)) return undefined;\n\t\t// Move to end (most recently used)\n\t\tconst value = this.cache.get(key);\n\t\tif (value === undefined) return undefined;\n\t\tthis.cache.delete(key);\n\t\tthis.cache.set(key, value);\n\t\treturn value;\n\t}\n\n\tset(key: K, value: V): void {\n\t\tif (this.cache.has(key)) {\n\t\t\tthis.cache.delete(key);\n\t\t} else if (this.cache.size >= this.maxSize) {\n\t\t\t// Remove least recently used (first item)\n\t\t\tconst firstKey = this.cache.keys().next().value;\n\t\t\tif (firstKey !== undefined) {\n\t\t\t\tthis.cache.delete(firstKey);\n\t\t\t}\n\t\t}\n\t\tthis.cache.set(key, value);\n\t}\n\n\thas(key: K): boolean {\n\t\treturn this.cache.has(key);\n\t}\n\n\tclear(): void {\n\t\tthis.cache.clear();\n\t}\n\n\tsize(): number {\n\t\treturn this.cache.size;\n\t}\n}\n","/**\n * Name conversion utilities\n */\n\nexport interface NamingOptions {\n\tprefix?: string;\n\tsuffix?: string;\n}\n\n/**\n * Sanitize a string by replacing invalid identifier characters with underscores\n * Preserves dots, hyphens, underscores, and spaces as word separators\n * Example: \"User@Domain\" -> \"User_Domain\"\n * Example: \"User-Data@2024\" -> \"User-Data_2024\"\n */\nfunction sanitizeIdentifier(str: string): string {\n\t// Replace all non-identifier chars (except dots, hyphens, underscores, spaces) with underscores\n\t// Valid identifier chars: letters, digits, underscore\n\t// Preserve: dots, hyphens, underscores, spaces as word separators\n\treturn str.replace(/[^a-zA-Z0-9._\\-\\s]+/g, \"_\");\n}\n\n/**\n * Convert schema name to camelCase with optional prefix/suffix\n * Handles dotted names like \"Company.Models.User\" -> \"companyModelsUser\"\n */\nexport function toCamelCase(str: string, options?: NamingOptions): string {\n\t// Sanitize invalid characters first\n\tconst sanitized = sanitizeIdentifier(str);\n\n\t// Split by dots, hyphens, underscores, and spaces to get words\n\tconst words = sanitized.split(/[.\\-_\\s]+/).filter(word => word.length > 0);\n\n\t// Convert to camelCase: first word lowercase, rest PascalCase\n\tlet name: string;\n\tif (words.length === 0) {\n\t\tname = str.charAt(0).toLowerCase() + str.slice(1);\n\t} else if (words.length === 1) {\n\t\tname = words[0].charAt(0).toLowerCase() + words[0].slice(1);\n\t} else {\n\t\tname =\n\t\t\twords[0].charAt(0).toLowerCase() +\n\t\t\twords[0].slice(1) +\n\t\t\twords\n\t\t\t\t.slice(1)\n\t\t\t\t.map(word => word.charAt(0).toUpperCase() + word.slice(1))\n\t\t\t\t.join(\"\");\n\t}\n\n\t// Add prefix\n\tif (options?.prefix) {\n\t\tconst prefix = options.prefix.toLowerCase();\n\t\tname = prefix + name.charAt(0).toUpperCase() + name.slice(1);\n\t}\n\n\t// Add suffix before \"Schema\"\n\tif (options?.suffix) {\n\t\tconst suffix = options.suffix;\n\t\tname = name + suffix.charAt(0).toUpperCase() + suffix.slice(1).toLowerCase();\n\t}\n\n\treturn name;\n}\n\n/**\n * @shared Convert enum value to PascalCase and sanitize for TypeScript enum keys\n * @since 1.0.0\n * Utility used by core and playwright packages\n * Handles dotted names like \"Company.Models.User\" -> \"CompanyModelsUser\"\n */\nexport function toPascalCase(str: string | number): string {\n\tconst stringValue = String(str);\n\n\t// Check if it's already a valid PascalCase or camelCase identifier\n\t// (only contains letters, digits, and no special characters)\n\tconst isAlreadyValidCase = /^[a-zA-Z][a-zA-Z0-9]*$/.test(stringValue);\n\n\tif (isAlreadyValidCase) {\n\t\t// Just ensure it starts with uppercase\n\t\treturn stringValue.charAt(0).toUpperCase() + stringValue.slice(1);\n\t}\n\n\t// Sanitize invalid characters first\n\tconst sanitized = sanitizeIdentifier(stringValue);\n\n\t// Split by dots, hyphens, underscores, and spaces to get words\n\tconst words = sanitized.split(/[.\\-_\\s]+/).filter(word => word.length > 0);\n\n\t// Convert all words to PascalCase\n\tlet result: string;\n\tif (words.length === 0) {\n\t\tresult = \"Value\";\n\t} else {\n\t\tresult = words.map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(\"\");\n\t}\n\n\t// Enum keys can't start with a number - prefix with 'N'\n\tif (/^\\d/.test(result)) {\n\t\tresult = `N${result}`;\n\t}\n\n\t// If result is empty or only underscores, use a default\n\tif (!result || /^_+$/.test(result)) {\n\t\treturn \"Value\";\n\t}\n\n\treturn result;\n}\n\n/**\n * Resolve $ref to schema name\n */\nexport function resolveRef(ref: string): string {\n\tconst parts = ref.split(\"/\");\n\treturn parts[parts.length - 1];\n}\n","import { minimatch } from \"minimatch\";\nimport type { OperationFilters } from \"../types\";\n\n/**\n * Filter statistics to track which operations were included/excluded\n */\nexport interface FilterStatistics {\n\ttotalOperations: number;\n\tincludedOperations: number;\n\tfilteredByTags: number;\n\tfilteredByPaths: number;\n\tfilteredByMethods: number;\n\tfilteredByOperationIds: number;\n\tfilteredByDeprecated: number;\n}\n\n/**\n * Create a new filter statistics object with all counters initialized to zero\n */\nexport function createFilterStatistics(): FilterStatistics {\n\treturn {\n\t\ttotalOperations: 0,\n\t\tincludedOperations: 0,\n\t\tfilteredByTags: 0,\n\t\tfilteredByPaths: 0,\n\t\tfilteredByMethods: 0,\n\t\tfilteredByOperationIds: 0,\n\t\tfilteredByDeprecated: 0,\n\t};\n}\n\n/**\n * Check if a value matches any of the patterns (supports glob patterns)\n * Empty patterns array = no constraint (returns true)\n */\nfunction matchesAnyPattern(value: string | undefined, patterns: string[] | undefined): boolean {\n\tif (!patterns || patterns.length === 0) {\n\t\treturn false; // No constraint means \"don't use this filter\"\n\t}\n\tif (!value) {\n\t\treturn false;\n\t}\n\treturn patterns.some(pattern => minimatch(value, pattern));\n}\n\n/**\n * Check if an array contains any of the specified values\n * Empty values array = no constraint (returns false)\n */\nfunction containsAny(arr: string[] | undefined, values: string[] | undefined): boolean {\n\tif (!values || values.length === 0) {\n\t\treturn false; // No constraint means \"don't use this filter\"\n\t}\n\tif (!arr || arr.length === 0) {\n\t\treturn false;\n\t}\n\treturn values.some(value => arr.includes(value));\n}\n\n/**\n * Determine if an operation should be included based on filter criteria\n *\n * Filter logic:\n * 1. If no filters specified, include all operations\n * 2. Empty arrays are treated as \"no constraint\" (not as \"exclude all\")\n * 3. Include filters are applied first (allowlist)\n * 4. Exclude filters are applied second (blocklist)\n * 5. Exclude rules always win over include rules\n *\n * @param operation - The OpenAPI operation object\n * @param path - The operation path (e.g., \"/users/{id}\")\n * @param method - The HTTP method (e.g., \"get\", \"post\")\n * @param filters - Optional filter configuration\n * @param stats - Optional statistics object to track filtering reasons\n * @returns true if the operation should be included, false otherwise\n */\nexport function shouldIncludeOperation(\n\toperation: any,\n\tpath: string,\n\tmethod: string,\n\tfilters?: OperationFilters,\n\tstats?: FilterStatistics\n): boolean {\n\t// If no filters specified, include all operations\n\tif (!filters) {\n\t\treturn true;\n\t}\n\n\tconst methodLower = method.toLowerCase();\n\tconst operationId = operation?.operationId;\n\tconst tags = operation?.tags || [];\n\tconst deprecated = operation?.deprecated === true;\n\n\t// Apply include filters first (allowlist)\n\t// If any include filter is specified and the operation doesn't match, exclude it\n\n\t// Check includeTags\n\tif (filters.includeTags && filters.includeTags.length > 0) {\n\t\tif (!containsAny(tags, filters.includeTags)) {\n\t\t\tif (stats) stats.filteredByTags++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check includePaths\n\tif (filters.includePaths && filters.includePaths.length > 0) {\n\t\tif (!matchesAnyPattern(path, filters.includePaths)) {\n\t\t\tif (stats) stats.filteredByPaths++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check includeMethods\n\tif (filters.includeMethods && filters.includeMethods.length > 0) {\n\t\tconst methodsLower = filters.includeMethods.map(m => m.toLowerCase());\n\t\tif (!methodsLower.includes(methodLower)) {\n\t\t\tif (stats) stats.filteredByMethods++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check includeOperationIds\n\tif (filters.includeOperationIds && filters.includeOperationIds.length > 0) {\n\t\tif (!matchesAnyPattern(operationId, filters.includeOperationIds)) {\n\t\t\tif (stats) stats.filteredByOperationIds++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Apply exclude filters second (blocklist)\n\t// If the operation matches any exclude filter, exclude it\n\n\t// Check excludeDeprecated\n\tif (filters.excludeDeprecated === true && deprecated) {\n\t\tif (stats) stats.filteredByDeprecated++;\n\t\treturn false;\n\t}\n\n\t// Check excludeTags\n\tif (filters.excludeTags && filters.excludeTags.length > 0) {\n\t\tif (containsAny(tags, filters.excludeTags)) {\n\t\t\tif (stats) stats.filteredByTags++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check excludePaths\n\tif (filters.excludePaths && filters.excludePaths.length > 0) {\n\t\tif (matchesAnyPattern(path, filters.excludePaths)) {\n\t\t\tif (stats) stats.filteredByPaths++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check excludeMethods\n\tif (filters.excludeMethods && filters.excludeMethods.length > 0) {\n\t\tconst methodsLower = filters.excludeMethods.map(m => m.toLowerCase());\n\t\tif (methodsLower.includes(methodLower)) {\n\t\t\tif (stats) stats.filteredByMethods++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check excludeOperationIds\n\tif (filters.excludeOperationIds && filters.excludeOperationIds.length > 0) {\n\t\tif (matchesAnyPattern(operationId, filters.excludeOperationIds)) {\n\t\t\tif (stats) stats.filteredByOperationIds++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Operation passed all filters\n\treturn true;\n}\n\n/**\n * Validate filter statistics and emit warnings for filters that matched nothing\n * Helps users debug filter configurations that might be too restrictive or contain typos\n *\n * @param stats - Filter statistics object\n * @param filters - The filter configuration to validate\n */\nexport function validateFilters(stats: FilterStatistics, filters?: OperationFilters): void {\n\tif (!filters || stats.totalOperations === 0) {\n\t\treturn;\n\t}\n\n\t// If all operations were filtered out, emit a warning\n\tif (stats.includedOperations === 0) {\n\t\tconsole.warn(\n\t\t\t`⚠️  Warning: All ${stats.totalOperations} operations were filtered out. Check your operationFilters configuration.`\n\t\t);\n\n\t\t// Provide specific guidance about which filters might be the issue\n\t\tconst filterBreakdown: string[] = [];\n\t\tif (stats.filteredByTags > 0) filterBreakdown.push(`${stats.filteredByTags} by tags`);\n\t\tif (stats.filteredByPaths > 0) filterBreakdown.push(`${stats.filteredByPaths} by paths`);\n\t\tif (stats.filteredByMethods > 0) filterBreakdown.push(`${stats.filteredByMethods} by methods`);\n\t\tif (stats.filteredByOperationIds > 0) filterBreakdown.push(`${stats.filteredByOperationIds} by operationIds`);\n\t\tif (stats.filteredByDeprecated > 0) filterBreakdown.push(`${stats.filteredByDeprecated} by deprecated flag`);\n\n\t\tif (filterBreakdown.length > 0) {\n\t\t\tconsole.warn(`   Filtered: ${filterBreakdown.join(\", \")}`);\n\t\t}\n\t}\n}\n\n/**\n * Format filter statistics for display in generated output\n * Returns a formatted string suitable for inclusion in comments\n *\n * @param stats - Filter statistics object\n * @returns Formatted statistics string\n */\nexport function formatFilterStatistics(stats: FilterStatistics): string {\n\tif (stats.totalOperations === 0) {\n\t\treturn \"\";\n\t}\n\n\tconst lines: string[] = [];\n\tlines.push(\"Operation Filtering:\");\n\tlines.push(`  Total operations: ${stats.totalOperations}`);\n\tlines.push(`  Included operations: ${stats.includedOperations}`);\n\n\tconst filteredCount =\n\t\tstats.filteredByTags +\n\t\tstats.filteredByPaths +\n\t\tstats.filteredByMethods +\n\t\tstats.filteredByOperationIds +\n\t\tstats.filteredByDeprecated;\n\n\tif (filteredCount > 0) {\n\t\tlines.push(`  Filtered operations: ${filteredCount}`);\n\t\tif (stats.filteredByTags > 0) lines.push(`    - By tags: ${stats.filteredByTags}`);\n\t\tif (stats.filteredByPaths > 0) lines.push(`    - By paths: ${stats.filteredByPaths}`);\n\t\tif (stats.filteredByMethods > 0) lines.push(`    - By methods: ${stats.filteredByMethods}`);\n\t\tif (stats.filteredByOperationIds > 0) lines.push(`    - By operationIds: ${stats.filteredByOperationIds}`);\n\t\tif (stats.filteredByDeprecated > 0) lines.push(`    - By deprecated: ${stats.filteredByDeprecated}`);\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n","import { minimatch } from \"minimatch\";\n\n/**\n * Pattern matching utilities for prefix stripping\n *\n * Shared utility used by core and playwright packages\n *\n * Supports both literal string matching and glob patterns for stripping\n * prefixes from strings (paths, schema names, etc.)\n */\n\n/**\n * Validates if a glob pattern is syntactically valid\n * @param pattern - The glob pattern to validate\n * @returns true if valid, false otherwise\n */\nfunction isValidGlobPattern(pattern: string): boolean {\n\ttry {\n\t\t// Try to create a minimatch instance to validate the pattern\n\t\tnew minimatch.Minimatch(pattern);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Checks if a pattern contains glob special characters\n * @param pattern - The pattern to check\n * @returns true if pattern contains glob wildcards\n */\nfunction isGlobPattern(pattern: string): boolean {\n\treturn /[*?[\\]{}!]/.test(pattern);\n}\n\n/**\n * @shared Strips a prefix from a string using either literal string matching or glob patterns\n * @since 1.1.0\n * Shared utility used by core and playwright packages\n *\n * @param input - The full string to strip from\n * @param pattern - The glob pattern to strip\n * @param ensureLeadingChar - Optional character to ensure at start (e.g., \"/\" for paths)\n * @returns The string with prefix removed, or original string if no match\n *\n * @example\n * // Literal string matching\n * stripPrefix(\"/api/v1/users\", \"/api/v1\") // => \"/users\"\n * stripPrefix(\"Company.Models.User\", \"Company.Models.\") // => \"User\"\n *\n * @example\n * // Glob pattern matching\n * stripPrefix(\"/api/v1.0/users\", \"/api/v*\") // => matches and strips\n * stripPrefix(\"Company.Models.User\", \"*.Models.\") // => \"User\"\n * stripPrefix(\"api_v2_UserSchema\", \"api_v[0-9]_\") // => \"UserSchema\"\n */\nexport function stripPrefix(input: string, pattern: string | undefined, ensureLeadingChar?: string): string {\n\tif (!pattern) {\n\t\treturn input;\n\t}\n\n\t// Validate glob pattern if it contains special characters\n\tif (isGlobPattern(pattern) && !isValidGlobPattern(pattern)) {\n\t\tconsole.warn(`⚠️  Invalid glob pattern \"${pattern}\": Pattern is malformed`);\n\t\treturn input;\n\t}\n\n\t// Check if pattern contains glob wildcards\n\tif (isGlobPattern(pattern)) {\n\t\t// Use glob matching to find the prefix\n\t\t// We need to find what part of the input matches the pattern as a prefix\n\t\t// Try matching progressively longer prefixes to find the longest match\n\t\tlet longestMatch = -1;\n\n\t\tfor (let i = 1; i <= input.length; i++) {\n\t\t\tconst testPrefix = input.substring(0, i);\n\t\t\tif (minimatch(testPrefix, pattern)) {\n\t\t\t\t// Found a match - keep looking for a longer match\n\t\t\t\tlongestMatch = i;\n\t\t\t}\n\t\t}\n\n\t\tif (longestMatch > 0) {\n\t\t\t// Strip the longest matching prefix\n\t\t\tconst stripped = input.substring(longestMatch);\n\n\t\t\t// Ensure result starts with specified character if provided\n\t\t\tif (ensureLeadingChar) {\n\t\t\t\tif (stripped === \"\") {\n\t\t\t\t\treturn ensureLeadingChar;\n\t\t\t\t}\n\t\t\t\tif (!stripped.startsWith(ensureLeadingChar)) {\n\t\t\t\t\treturn `${ensureLeadingChar}${stripped}`;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn stripped === \"\" && !ensureLeadingChar ? input : stripped;\n\t\t}\n\n\t\t// No match found\n\t\treturn input;\n\t}\n\n\t// Literal string matching\n\tif (input.startsWith(pattern)) {\n\t\tconst stripped = input.substring(pattern.length);\n\n\t\t// Ensure result starts with specified character if provided\n\t\tif (ensureLeadingChar) {\n\t\t\tif (stripped === \"\") {\n\t\t\t\treturn ensureLeadingChar;\n\t\t\t}\n\t\t\tif (!stripped.startsWith(ensureLeadingChar)) {\n\t\t\t\treturn `${ensureLeadingChar}${stripped}`;\n\t\t\t}\n\t\t}\n\n\t\treturn stripped;\n\t}\n\n\t// No match - return original input\n\treturn input;\n}\n\n/**\n * @shared Strips a prefix from a path (ensures leading slash)\n * @since 1.1.0\n * Shared utility used by playwright package for path manipulation\n *\n * @param path - The full path to strip from\n * @param pattern - The glob pattern to strip\n * @returns The path with prefix removed, or original path if no match\n *\n * @example\n * stripPathPrefix(\"/api/v1/users\", \"/api/v1\") // => \"/users\"\n * stripPathPrefix(\"/api/v2/posts\", \"/api/v*\") // => \"/posts\"\n * stripPathPrefix(\"/api/v1.0/items\", \"/api/v[0-9].*\") // => \"/items\"\n */\nexport function stripPathPrefix(path: string, pattern: string | undefined): string {\n\tif (!pattern) {\n\t\treturn path;\n\t}\n\n\t// For literal string matching with paths, normalize the pattern\n\tif (!isGlobPattern(pattern)) {\n\t\tlet normalizedPattern = pattern.trim();\n\t\tif (!normalizedPattern.startsWith(\"/\")) {\n\t\t\tnormalizedPattern = `/${normalizedPattern}`;\n\t\t}\n\t\tif (normalizedPattern.endsWith(\"/\") && normalizedPattern !== \"/\") {\n\t\t\tnormalizedPattern = normalizedPattern.slice(0, -1);\n\t\t}\n\n\t\treturn stripPrefix(path, normalizedPattern, \"/\");\n\t}\n\n\t// For glob patterns, use as-is\n\treturn stripPrefix(path, pattern, \"/\");\n}\n","/**\n * OpenAPI $ref resolution utilities\n *\n * Provides functions to resolve $ref references to component definitions\n * Supports: parameters, requestBodies, responses, schemas\n *\n * @internal Used by core and playwright packages\n */\n\nimport type { OpenAPIParameter, OpenAPIRequestBody, OpenAPIResponse, OpenAPISchema, OpenAPISpec } from \"../types\";\n\n/**\n * Type for any resolvable component\n */\ntype ResolvableComponent = OpenAPIParameter | OpenAPIRequestBody | OpenAPIResponse | OpenAPISchema | any;\n\n/**\n * Resolve a $ref to a component definition\n * Handles nested $refs by recursively resolving until no more refs found\n *\n * @param obj - Object that may contain a $ref\n * @param spec - The OpenAPI specification\n * @param maxDepth - Maximum recursion depth to prevent infinite loops (default: 10)\n * @returns The resolved component, or the original object if not a reference\n */\nexport function resolveRef<T extends ResolvableComponent>(obj: T | any, spec: OpenAPISpec, maxDepth = 10): T {\n\tif (!obj || typeof obj !== \"object\" || maxDepth <= 0) return obj;\n\tif (!obj.$ref) return obj;\n\n\tconst ref = obj.$ref as string;\n\tlet resolved: any = null;\n\n\t// Match different component types\n\tconst paramMatch = ref.match(/^#\\/components\\/parameters\\/(.+)$/);\n\tconst requestBodyMatch = ref.match(/^#\\/components\\/requestBodies\\/(.+)$/);\n\tconst responseMatch = ref.match(/^#\\/components\\/responses\\/(.+)$/);\n\tconst schemaMatch = ref.match(/^#\\/components\\/schemas\\/(.+)$/);\n\n\tif (paramMatch && spec.components?.parameters) {\n\t\tconst name = paramMatch[1];\n\t\tresolved = spec.components.parameters[name];\n\t} else if (requestBodyMatch && spec.components?.requestBodies) {\n\t\tconst name = requestBodyMatch[1];\n\t\tresolved = spec.components.requestBodies[name];\n\t} else if (responseMatch && spec.components?.responses) {\n\t\tconst name = responseMatch[1];\n\t\tresolved = spec.components.responses[name];\n\t} else if (schemaMatch && spec.components?.schemas) {\n\t\tconst name = schemaMatch[1];\n\t\tresolved = spec.components.schemas[name];\n\t}\n\n\tif (resolved) {\n\t\t// Recursively resolve nested $refs\n\t\tif (resolved.$ref) {\n\t\t\treturn resolveRef(resolved, spec, maxDepth - 1);\n\t\t}\n\t\treturn resolved;\n\t}\n\n\t// Return original if can't resolve\n\treturn obj;\n}\n\n/**\n * Resolve a parameter reference\n * Convenience wrapper for resolveRef with parameter type\n */\nexport function resolveParameterRef(param: any, spec: OpenAPISpec): OpenAPIParameter | any {\n\treturn resolveRef<OpenAPIParameter>(param, spec);\n}\n\n/**\n * Resolve a request body reference\n * Convenience wrapper for resolveRef with request body type\n */\nexport function resolveRequestBodyRef(requestBody: any, spec: OpenAPISpec): OpenAPIRequestBody | any {\n\treturn resolveRef<OpenAPIRequestBody>(requestBody, spec);\n}\n\n/**\n * Resolve a response reference\n * Convenience wrapper for resolveRef with response type\n */\nexport function resolveResponseRef(response: any, spec: OpenAPISpec): OpenAPIResponse | any {\n\treturn resolveRef<OpenAPIResponse>(response, spec);\n}\n\n/**\n * Merge path-level parameters with operation-level parameters\n * Operation parameters override path-level parameters with the same name and location\n *\n * @param pathParams - Parameters defined at the path level\n * @param operationParams - Parameters defined at the operation level\n * @param spec - The OpenAPI specification for resolving $refs\n * @returns Merged array of resolved parameters\n */\nexport function mergeParameters(\n\tpathParams: any[] | undefined,\n\toperationParams: any[] | undefined,\n\tspec: OpenAPISpec\n): any[] {\n\tconst resolvedPathParams = (pathParams || []).map(p => resolveParameterRef(p, spec));\n\tconst resolvedOperationParams = (operationParams || []).map(p => resolveParameterRef(p, spec));\n\n\t// Start with path-level params\n\tconst merged = [...resolvedPathParams];\n\n\t// Operation params override path params by name + in\n\tfor (const opParam of resolvedOperationParams) {\n\t\tif (!opParam || typeof opParam !== \"object\") continue;\n\n\t\tconst existingIndex = merged.findIndex(\n\t\t\tp => p && typeof p === \"object\" && p.name === opParam.name && p.in === opParam.in\n\t\t);\n\n\t\tif (existingIndex >= 0) {\n\t\t\t// Override existing param\n\t\t\tmerged[existingIndex] = opParam;\n\t\t} else {\n\t\t\t// Add new param\n\t\t\tmerged.push(opParam);\n\t\t}\n\t}\n\n\treturn merged;\n}\n","/**\n * String utility functions for escaping and formatting\n */\n\nimport type { OpenAPISchema } from \"../types\";\n\n/**\n * Escape string for description in .describe()\n */\nexport function escapeDescription(str: string): string {\n\treturn str.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"').replace(/\\n/g, \"\\\\n\");\n}\n\n/**\n * Escape regex pattern for use in code\n * Only escapes forward slashes which would terminate the regex literal\n */\nexport function escapePattern(str: string): string {\n\treturn str.replace(/\\//g, \"\\\\/\");\n}\n\n/**\n * @shared Escape JSDoc comment content to prevent injection\n * @since 1.0.0\n * Utility used by core and playwright packages\n */\nexport function escapeJSDoc(str: string): string {\n\treturn str.replace(/\\*\\//g, \"*\\\\/\");\n}\n\n/**\n * Wrap validation with .nullable() if needed\n */\nexport function wrapNullable(validation: string, isNullable: boolean): string {\n\treturn isNullable ? `${validation}.nullable()` : validation;\n}\n\n/**\n * Check if schema is nullable (supports both OpenAPI 3.0 and 3.1 syntax)\n * @param schema - The OpenAPI schema to check\n * @param defaultNullable - Default nullable behavior when not explicitly specified (default: false)\n */\nexport function isNullable(schema: OpenAPISchema, defaultNullable = false): boolean {\n\t// OpenAPI 3.0 style: nullable explicitly set\n\tif (schema.nullable === true) {\n\t\treturn true;\n\t}\n\tif (schema.nullable === false) {\n\t\treturn false;\n\t}\n\t// OpenAPI 3.1 style: type can be an array including \"null\"\n\tif (Array.isArray(schema.type)) {\n\t\treturn schema.type.includes(\"null\");\n\t}\n\t// No explicit nullable annotation - use default\n\treturn defaultNullable;\n}\n\n/**\n * Get the primary type from schema (handles OpenAPI 3.1 type arrays)\n */\nexport function getPrimaryType(schema: OpenAPISchema): string | undefined {\n\tif (Array.isArray(schema.type)) {\n\t\t// OpenAPI 3.1: type can be an array like [\"string\", \"null\"]\n\t\t// Return the first non-null type\n\t\tconst nonNullType = schema.type.find(t => t !== \"null\");\n\t\treturn nonNullType;\n\t}\n\treturn schema.type;\n}\n\n/**\n * Check if schema has multiple non-null types\n */\nexport function hasMultipleTypes(schema: OpenAPISchema): boolean {\n\tif (Array.isArray(schema.type)) {\n\t\tconst nonNullTypes = schema.type.filter(t => t !== \"null\");\n\t\treturn nonNullTypes.length > 1;\n\t}\n\treturn false;\n}\n\n/**\n * Add description to a schema validation string\n */\nexport function addDescription(validation: string, description: string | undefined, useDescribe: boolean): string {\n\tif (!description || !useDescribe) return validation;\n\n\tconst escapedDesc = escapeDescription(description);\n\treturn `${validation}.describe(\"${escapedDesc}\")`;\n}\n","import type { Loader } from \"cosmiconfig\";\n\n/**\n * @shared Create a TypeScript loader for cosmiconfig using esbuild\n * @since 1.0.0\n * Utility used by core and playwright packages\n *\n * Creates a loader that transpiles TypeScript config files to JavaScript\n * using esbuild, then executes them to load the configuration.\n *\n * @returns A cosmiconfig Loader function\n */\nexport function createTypeScriptLoader(): Loader {\n\treturn async (filepath: string) => {\n\t\ttry {\n\t\t\t// Use esbuild to transpile TypeScript to JavaScript\n\t\t\tconst esbuild = await import(\"esbuild\");\n\t\t\tconst fs = await import(\"node:fs\");\n\t\t\tconst path = await import(\"node:path\");\n\n\t\t\tconst tsCode = fs.readFileSync(filepath, \"utf-8\");\n\t\t\tconst result = await esbuild.build({\n\t\t\t\tstdin: {\n\t\t\t\t\tcontents: tsCode,\n\t\t\t\t\tloader: \"ts\",\n\t\t\t\t\tresolveDir: path.dirname(filepath),\n\t\t\t\t\tsourcefile: filepath,\n\t\t\t\t},\n\t\t\t\tformat: \"cjs\",\n\t\t\t\tplatform: \"node\",\n\t\t\t\ttarget: \"node18\",\n\t\t\t\tbundle: false,\n\t\t\t\twrite: false,\n\t\t\t});\n\n\t\t\tconst jsCode = result.outputFiles[0].text;\n\n\t\t\t// Create a module and execute it\n\t\t\tconst module = { exports: {} } as any;\n\t\t\tconst func = new Function(\"exports\", \"module\", \"require\", \"__filename\", \"__dirname\", jsCode);\n\t\t\tfunc(module.exports, module, require, filepath, path.dirname(filepath));\n\n\t\t\treturn module.exports.default || module.exports;\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to load TypeScript config from ${filepath}: ${error instanceof Error ? error.message : String(error)}`\n\t\t\t);\n\t\t}\n\t};\n}\n","import type { OpenAPISchema } from \"../types\";\nimport { LRUCache } from \"../utils/lru-cache\";\nimport { addDescription, escapePattern } from \"../utils/string-utils\";\n\n// Performance optimization: Cache compiled regex patterns with configurable size limit\n// Cache is shared across all generators for performance, but size can be configured per generator\nlet PATTERN_CACHE = new LRUCache<string, string>(1000);\n\n/**\n * Configure the pattern cache size\n * Should be called before generating schemas for large specifications\n */\nexport function configurePatternCache(size: number): void {\n\tif (size > 0 && size !== PATTERN_CACHE.capacity) {\n\t\tPATTERN_CACHE = new LRUCache<string, string>(size);\n\t}\n}\n\n// Default format map (without date-time, which can be customized)\nconst DEFAULT_FORMAT_MAP: Record<string, string> = {\n\tuuid: \"z.uuid()\",\n\temail: \"z.email()\",\n\turi: \"z.url()\",\n\turl: \"z.url()\",\n\t\"uri-reference\": 'z.string().refine((val) => !/\\\\s/.test(val), { message: \"Must be a valid URI reference\" })',\n\thostname:\n\t\t'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\" })',\n\tbyte: \"z.base64()\",\n\tbinary: \"z.string()\",\n\tdate: \"z.iso.date()\",\n\ttime: \"z.iso.time()\",\n\tduration:\n\t\t'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\" })',\n\tipv4: \"z.ipv4()\",\n\tipv6: \"z.ipv6()\",\n\temoji: \"z.emoji()\",\n\tbase64: \"z.base64()\",\n\tbase64url: \"z.base64url()\",\n\tnanoid: \"z.nanoid()\",\n\tcuid: \"z.cuid()\",\n\tcuid2: \"z.cuid2()\",\n\tulid: \"z.ulid()\",\n\tcidr: \"z.cidrv4()\", // Default to v4\n\tcidrv4: \"z.cidrv4()\",\n\tcidrv6: \"z.cidrv6()\",\n\t\"json-pointer\":\n\t\t'z.string().refine((val) => val === \"\" || /^(\\\\/([^~/]|~0|~1)+)+$/.test(val), { message: \"Must be a valid JSON Pointer (RFC 6901)\" })',\n\t\"relative-json-pointer\":\n\t\t'z.string().refine((val) => /^(0|[1-9]\\\\d*)(#|(\\\\/([^~/]|~0|~1)+)*)$/.test(val), { message: \"Must be a valid relative JSON Pointer\" })',\n};\n\n// Mutable format map that includes date-time and can be configured\nlet FORMAT_MAP: Record<string, string> = {\n\t...DEFAULT_FORMAT_MAP,\n\t\"date-time\": \"z.iso.datetime()\",\n};\n\n/**\n * Configure custom date-time format validation\n * Overrides the default z.iso.datetime() with a custom regex pattern\n *\n * @param pattern - Regex pattern (string or RegExp) for date-time validation\n * @throws {Error} If the provided pattern is not a valid regular expression\n * @example\n * // String pattern (required for JSON/YAML configs)\n * configureDateTimeFormat('^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}$')\n *\n * @example\n * // RegExp literal (TypeScript configs only)\n * configureDateTimeFormat(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$/)\n */\nexport function configureDateTimeFormat(pattern?: string | RegExp): void {\n\tif (!pattern) {\n\t\t// Reset to default\n\t\tFORMAT_MAP[\"date-time\"] = \"z.iso.datetime()\";\n\t\treturn;\n\t}\n\n\t// Convert RegExp to string if needed\n\tconst patternStr = pattern instanceof RegExp ? pattern.source : pattern;\n\n\t// Empty string resets to default\n\tif (patternStr === \"\") {\n\t\tFORMAT_MAP[\"date-time\"] = \"z.iso.datetime()\";\n\t\treturn;\n\t}\n\n\t// Validate the regex pattern\n\ttry {\n\t\tnew RegExp(patternStr);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Invalid regular expression pattern for customDateTimeFormatRegex: ${patternStr}. ${\n\t\t\t\terror instanceof Error ? error.message : \"Pattern is malformed\"\n\t\t\t}`\n\t\t);\n\t}\n\n\t// Escape the pattern for use in generated code\n\tconst escapedPattern = escapePattern(patternStr);\n\n\t// Update the format map with the custom regex\n\tFORMAT_MAP[\"date-time\"] = `z.string().regex(/${escapedPattern}/)`;\n}\n\n/**\n * Reset format map to defaults (useful for testing)\n */\nexport function resetFormatMap(): void {\n\tFORMAT_MAP = {\n\t\t...DEFAULT_FORMAT_MAP,\n\t\t\"date-time\": \"z.iso.datetime()\",\n\t};\n}\n\n/**\n * Generate Zod validation for string with format (Zod v4 compatible)\n */\nexport function generateStringValidation(schema: OpenAPISchema, useDescribe: boolean): string {\n\t// Handle format with Zod v4 top-level functions (performance optimized with map)\n\tlet validation = FORMAT_MAP[schema.format || \"\"] || \"z.string()\";\n\n\t// Add length constraints\n\tif (schema.minLength !== undefined) {\n\t\tvalidation += `.min(${schema.minLength})`;\n\t}\n\tif (schema.maxLength !== undefined) {\n\t\tvalidation += `.max(${schema.maxLength})`;\n\t}\n\n\t// Add pattern (with cached escaping for performance)\n\tif (schema.pattern) {\n\t\tlet escapedPattern = PATTERN_CACHE.get(schema.pattern);\n\t\tif (escapedPattern === undefined) {\n\t\t\tescapedPattern = escapePattern(schema.pattern);\n\t\t\tPATTERN_CACHE.set(schema.pattern, escapedPattern);\n\t\t}\n\t\tvalidation += `.regex(/${escapedPattern}/)`;\n\t}\n\n\t// Handle content encoding (OpenAPI 3.1)\n\tif (schema.contentEncoding && !schema.format) {\n\t\tswitch (schema.contentEncoding) {\n\t\t\tcase \"base64\":\n\t\t\t\tvalidation = \"z.base64()\";\n\t\t\t\tbreak;\n\t\t\tcase \"base64url\":\n\t\t\t\tvalidation = \"z.base64url()\";\n\t\t\t\tbreak;\n\t\t\tcase \"quoted-printable\":\n\t\t\t\t// Quoted-printable validation\n\t\t\t\tvalidation =\n\t\t\t\t\t'z.string().refine((val) => /^[\\\\x20-\\\\x7E\\\\r\\\\n=]*$/.test(val), { message: \"Must be valid quoted-printable encoding\" })';\n\t\t\t\tbreak;\n\t\t\tcase \"7bit\":\n\t\t\tcase \"8bit\":\n\t\t\tcase \"binary\":\n\t\t\t\t// Basic string validation for these encodings\n\t\t\t\tvalidation = \"z.string()\";\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Unknown encoding, use string with refinement note\n\t\t\t\tvalidation = `z.string().describe(\"Content encoding: ${schema.contentEncoding}\")`;\n\t\t}\n\n\t\t// Re-apply constraints after encoding\n\t\tif (schema.minLength !== undefined) {\n\t\t\tvalidation += `.min(${schema.minLength})`;\n\t\t}\n\t\tif (schema.maxLength !== undefined) {\n\t\t\tvalidation += `.max(${schema.maxLength})`;\n\t\t}\n\t\tif (schema.pattern) {\n\t\t\tlet escapedPattern = PATTERN_CACHE.get(schema.pattern);\n\t\t\tif (escapedPattern === undefined) {\n\t\t\t\tescapedPattern = escapePattern(schema.pattern);\n\t\t\t\tPATTERN_CACHE.set(schema.pattern, escapedPattern);\n\t\t\t}\n\t\t\tvalidation += `.regex(/${escapedPattern}/)`;\n\t\t}\n\t} else if (schema.contentMediaType) {\n\t\t// Add refinement for media type validation\n\t\tconst mediaType = schema.contentMediaType;\n\t\tif (mediaType === \"application/json\") {\n\t\t\tvalidation += `.refine((val) => { try { JSON.parse(val); return true; } catch { return false; } }, { message: \"Must be valid JSON\" })`;\n\t\t} else if (mediaType === \"application/xml\" || mediaType === \"text/xml\") {\n\t\t\t// Basic XML validation - check for well-formed XML structure\n\t\t\tvalidation += `.refine((val) => { try { if (typeof DOMParser !== \"undefined\") { const parser = new DOMParser(); const doc = parser.parseFromString(val, \"text/xml\"); return !doc.querySelector(\"parsererror\"); } return /^\\\\s*<[^>]+>/.test(val); } catch { return false; } }, { message: \"Must be valid XML\" })`;\n\t\t} else if (mediaType === \"application/yaml\" || mediaType === \"application/x-yaml\" || mediaType === \"text/yaml\") {\n\t\t\t// Basic YAML validation - check for basic YAML structure\n\t\t\tvalidation += `.refine((val) => { try { return val.trim().length > 0 && !/^[[{]/.test(val.trim()); } catch { return false; } }, { message: \"Must be valid YAML\" })`;\n\t\t} else if (mediaType === \"text/html\") {\n\t\t\t// Basic HTML validation - check for HTML tags\n\t\t\tvalidation += `.refine((val) => /<[^>]+>/.test(val), { message: \"Must contain HTML tags\" })`;\n\t\t} else if (mediaType === \"text/plain\") {\n\t\t\t// Plain text - no special validation needed, but mark it\n\t\t\tvalidation += `.refine(() => true, { message: \"Plain text content\" })`;\n\t\t}\n\t\t// Other media types default to no validation beyond string\n\t}\n\n\t// Add description if useDescribe is enabled\n\treturn addDescription(validation, schema.description, useDescribe);\n}\n"],"mappings":"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","names":["minimatch"]}
+{"version":3,"sources":["../src/errors.ts","../src/batch-executor.ts","../src/utils/config-schemas.ts","../src/utils/config-validation.ts","../src/utils/content-type-utils.ts","../src/utils/lru-cache.ts","../src/utils/name-utils.ts","../src/utils/operation-filters.ts","../src/utils/pattern-utils.ts","../src/utils/ref-resolver.ts","../src/utils/string-utils.ts","../src/utils/typescript-loader.ts","../src/validators/string-validator.ts"],"sourcesContent":["/**\n * Custom error classes for better error handling and debugging\n */\n\n/**\n * Base error class for all generator errors\n */\nexport class GeneratorError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly code: string,\n\t\tpublic readonly context?: Record<string, unknown>\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"GeneratorError\";\n\t\tError.captureStackTrace?.(this, this.constructor);\n\t}\n}\n\n/**\n * Error thrown when OpenAPI spec validation fails\n */\nexport class SpecValidationError extends GeneratorError {\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message, \"SPEC_VALIDATION_ERROR\", context);\n\t\tthis.name = \"SpecValidationError\";\n\t}\n}\n\n/**\n * Error thrown when file operations fail\n */\nexport class FileOperationError extends GeneratorError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly filePath: string,\n\t\tcontext?: Record<string, unknown>\n\t) {\n\t\tsuper(message, \"FILE_OPERATION_ERROR\", { ...context, filePath });\n\t\tthis.name = \"FileOperationError\";\n\t}\n}\n\n/**\n * Error thrown when config file is invalid\n */\nexport class ConfigValidationError extends GeneratorError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly configPath?: string,\n\t\tcontext?: Record<string, unknown>\n\t) {\n\t\tsuper(message, \"CONFIG_VALIDATION_ERROR\", { ...context, configPath });\n\t\tthis.name = \"ConfigValidationError\";\n\t}\n}\n\n/**\n * Error thrown when schema generation fails\n */\nexport class SchemaGenerationError extends GeneratorError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly schemaName: string,\n\t\tcontext?: Record<string, unknown>\n\t) {\n\t\tsuper(message, \"SCHEMA_GENERATION_ERROR\", { ...context, schemaName });\n\t\tthis.name = \"SchemaGenerationError\";\n\t}\n}\n\n/**\n * Error thrown when circular reference is detected in schema\n */\nexport class CircularReferenceError extends SchemaGenerationError {\n\tconstructor(\n\t\tschemaName: string,\n\t\tpublic readonly referencePath: string[]\n\t) {\n\t\tconst pathStr = referencePath.join(\" -> \");\n\t\tsuper(`Circular reference detected in schema: ${pathStr}`, schemaName, { referencePath, circularPath: pathStr });\n\t\tthis.name = \"CircularReferenceError\";\n\t}\n}\n\n/**\n * Error thrown when CLI options are invalid\n */\nexport class CliOptionsError extends GeneratorError {\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message, \"CLI_OPTIONS_ERROR\", context);\n\t\tthis.name = \"CliOptionsError\";\n\t}\n}\n\n/**\n * Error thrown when configuration is invalid or missing required values\n */\nexport class ConfigurationError extends GeneratorError {\n\tconstructor(message: string, context?: Record<string, unknown>) {\n\t\tsuper(message, \"CONFIGURATION_ERROR\", context);\n\t\tthis.name = \"ConfigurationError\";\n\t}\n}\n","import { ConfigurationError } from \"./errors\";\nimport type { ExecutionMode } from \"./types\";\n\n/**\n * @shared Generator interface for batch execution\n * @since 1.0.0\n * Interface that both OpenApiGenerator and OpenApiPlaywrightGenerator must implement\n */\nexport interface Generator {\n\tgenerate(): void;\n}\n\n/**\n * Result of processing a single spec\n */\ninterface SpecResult<T> {\n\tspec: T;\n\tsuccess: boolean;\n\terror?: string;\n}\n\n/**\n * Summary of batch execution results\n */\ninterface BatchExecutionSummary<T> {\n\ttotal: number;\n\tsuccessful: number;\n\tfailed: number;\n\tresults: SpecResult<T>[];\n}\n\n/**\n * Process a single spec and return result with error handling\n */\nasync function processSpec<T>(\n\tspec: T,\n\tindex: number,\n\ttotal: number,\n\tcreateGenerator: (spec: T) => Generator\n): Promise<SpecResult<T>> {\n\t// Live progress to stdout\n\tconst specInput = (spec as any).input || \"spec\";\n\tconst specOutput = (spec as any).output || \"output\";\n\tconsole.log(`Processing [${index + 1}/${total}] ${specInput}...`);\n\n\ttry {\n\t\tconst generator = createGenerator(spec);\n\t\tgenerator.generate();\n\n\t\treturn {\n\t\t\tspec,\n\t\t\tsuccess: true,\n\t\t};\n\t} catch (error) {\n\t\tconst errorMessage = error instanceof Error ? error.message : String(error);\n\t\tconsole.error(`✗ Failed to generate ${specOutput}: ${errorMessage}`);\n\n\t\treturn {\n\t\t\tspec,\n\t\t\tsuccess: false,\n\t\t\terror: errorMessage,\n\t\t};\n\t}\n}\n\n/**\n * Execute specs in parallel using Promise.allSettled with configurable batch size\n * Processes specifications in batches to control memory usage and concurrency\n * Continues processing all specs even if some fail\n */\nasync function executeParallel<T>(\n\tspecs: T[],\n\tcreateGenerator: (spec: T) => Generator,\n\tbatchSize: number\n): Promise<SpecResult<T>[]> {\n\tconsole.log(`\\nExecuting ${specs.length} specification(s) in parallel (batch size: ${batchSize})...\\n`);\n\n\tconst results: SpecResult<T>[] = [];\n\n\t// Process in batches to control memory usage\n\tfor (let i = 0; i < specs.length; i += batchSize) {\n\t\tconst batch = specs.slice(i, Math.min(i + batchSize, specs.length));\n\t\tconst batchPromises = batch.map((spec, batchIndex) =>\n\t\t\tprocessSpec(spec, i + batchIndex, specs.length, createGenerator)\n\t\t);\n\n\t\tconst batchResults = await Promise.allSettled(batchPromises);\n\n\t\t// Convert settled results to SpecResult\n\t\tfor (let j = 0; j < batchResults.length; j++) {\n\t\t\tconst result = batchResults[j];\n\t\t\tif (result.status === \"fulfilled\") {\n\t\t\t\tresults.push(result.value);\n\t\t\t} else {\n\t\t\t\t// Handle unexpected promise rejection\n\t\t\t\tresults.push({\n\t\t\t\t\tspec: batch[j],\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: result.reason instanceof Error ? result.reason.message : String(result.reason),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\treturn results;\n}\n\n/**\n * Execute specs sequentially one at a time\n * Continues processing all specs even if some fail\n */\nasync function executeSequential<T>(specs: T[], createGenerator: (spec: T) => Generator): Promise<SpecResult<T>[]> {\n\tconsole.log(`\\nExecuting ${specs.length} spec(s) sequentially...\\n`);\n\n\tconst results: SpecResult<T>[] = [];\n\n\tfor (let i = 0; i < specs.length; i++) {\n\t\tconst result = await processSpec(specs[i], i, specs.length, createGenerator);\n\t\tresults.push(result);\n\t}\n\n\treturn results;\n}\n\n/**\n * Print final summary of batch execution\n */\nfunction printSummary<T>(summary: BatchExecutionSummary<T>): void {\n\tconsole.log(`\\n${\"=\".repeat(50)}`);\n\tconsole.log(\"Batch Execution Summary\");\n\tconsole.log(\"=\".repeat(50));\n\tconsole.log(`Total specs: ${summary.total}`);\n\tconsole.log(`Successful: ${summary.successful}`);\n\tconsole.log(`Failed: ${summary.failed}`);\n\n\tif (summary.failed > 0) {\n\t\tconsole.log(\"\\nFailed specs:\");\n\t\tfor (const result of summary.results) {\n\t\t\tif (!result.success) {\n\t\t\t\tconst specInput = (result.spec as any).input || \"spec\";\n\t\t\t\tconsole.error(`  ✗ ${specInput}`);\n\t\t\t\tconsole.error(`    Error: ${result.error}`);\n\t\t\t}\n\t\t}\n\t}\n\n\tconsole.log(`${\"=\".repeat(50)}\\n`);\n}\n\n/**\n * @shared Execute batch processing of multiple specs with custom generator\n * @since 1.0.0\n * Utility used by core and playwright packages\n *\n * @param specs - Array of spec configurations to process\n * @param executionMode - Execution mode: \"parallel\" (default) or \"sequential\"\n * @param createGenerator - Factory function to create generator from spec\n * @param batchSize - Number of specifications to process concurrently in parallel mode\n * @returns BatchExecutionSummary with results\n * @throws Never throws - collects all errors and reports them\n */\nexport async function executeBatch<T>(\n\tspecs: T[],\n\texecutionMode: ExecutionMode = \"parallel\",\n\tcreateGenerator: (spec: T) => Generator,\n\tbatchSize: number\n): Promise<BatchExecutionSummary<T>> {\n\tif (specs.length === 0) {\n\t\tthrow new ConfigurationError(\"No specs provided for batch execution\", { specsCount: 0, executionMode });\n\t}\n\n\tlet results: SpecResult<T>[] = [];\n\n\ttry {\n\t\t// Execute based on mode\n\t\tresults =\n\t\t\texecutionMode === \"parallel\"\n\t\t\t\t? await executeParallel(specs, createGenerator, batchSize)\n\t\t\t\t: await executeSequential(specs, createGenerator);\n\n\t\t// Calculate summary\n\t\tconst summary: BatchExecutionSummary<T> = {\n\t\t\ttotal: results.length,\n\t\t\tsuccessful: results.filter(r => r.success).length,\n\t\t\tfailed: results.filter(r => !r.success).length,\n\t\t\tresults,\n\t\t};\n\n\t\t// Print summary\n\t\tprintSummary(summary);\n\n\t\treturn summary;\n\t} finally {\n\t\t// Memory leak prevention: Clear large result objects and hint GC for large batches\n\t\tif (results.length > batchSize) {\n\t\t\t// Clear spec references to allow GC\n\t\t\tfor (const result of results) {\n\t\t\t\t// Keep only essential info, clear large objects\n\t\t\t\tif (result.spec) {\n\t\t\t\t\t(result.spec as any) = null;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Hint to V8 garbage collector for large batches (if available)\n\t\t\tif (global.gc) {\n\t\t\t\tglobal.gc();\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Determine exit code based on batch execution results\n * Returns 1 if any spec failed, 0 if all succeeded\n */\nexport function getBatchExitCode<T>(summary: BatchExecutionSummary<T>): number {\n\treturn summary.failed > 0 ? 1 : 0;\n}\n","import { z } from \"zod\";\n\n/**\n * @shared Zod schema for request/response options validation\n * @since 1.0.0\n * Utility used by core and playwright packages\n */\nexport const RequestResponseOptionsSchema = z.strictObject({\n\tmode: z.enum([\"strict\", \"normal\", \"loose\"]).optional(),\n\tuseDescribe: z.boolean().optional(),\n\tincludeDescriptions: z.boolean().optional(),\n\tdefaultNullable: z.boolean().optional(),\n\temptyObjectBehavior: z.enum([\"strict\", \"loose\", \"record\"]).optional(),\n});\n\n/**\n * @shared Base Zod schema for operation filters (without status codes)\n * @since 1.0.0\n * Utility used by core and playwright packages\n */\nexport const OperationFiltersSchema = z.strictObject({\n\tincludeTags: z.array(z.string()).optional(),\n\texcludeTags: z.array(z.string()).optional(),\n\tincludePaths: z.array(z.string()).optional(),\n\texcludePaths: z.array(z.string()).optional(),\n\tincludeMethods: z.array(z.string()).optional(),\n\texcludeMethods: z.array(z.string()).optional(),\n\tincludeOperationIds: z.array(z.string()).optional(),\n\texcludeOperationIds: z.array(z.string()).optional(),\n\texcludeDeprecated: z.boolean().optional(),\n});\n\n/**\n * Inferred TypeScript type for request/response options\n */\nexport type RequestResponseOptions = z.infer<typeof RequestResponseOptionsSchema>;\n\n/**\n * Inferred TypeScript type for base operation filters\n */\nexport type BaseOperationFilters = z.infer<typeof OperationFiltersSchema>;\n","import { z } from \"zod\";\n\n/**\n * @shared Format Zod validation errors into user-friendly error messages\n * @since 1.0.0\n * Utility used by core and playwright packages\n *\n * @param error - The Zod validation error\n * @param filepath - Path to the config file that was being validated\n * @param configPath - Optional explicit config path provided by user\n * @param additionalNotes - Optional array of additional notes to append to the error message\n * @returns Formatted error message string\n */\nexport function formatConfigValidationError(\n\terror: z.ZodError,\n\tfilepath: string | undefined,\n\tconfigPath: string | undefined,\n\tadditionalNotes?: string[]\n): string {\n\tconst formattedErrors =\n\t\terror.issues\n\t\t\t?.map(err => {\n\t\t\t\tconst path = err.path.length > 0 ? err.path.join(\".\") : \"root\";\n\t\t\t\treturn `  - ${path}: ${err.message}`;\n\t\t\t})\n\t\t\t.join(\"\\n\") || \"Unknown validation error\";\n\n\tconst configSource = filepath || configPath || \"config file\";\n\tconst lines = [\n\t\t`Invalid configuration file at: ${configSource}`,\n\t\t\"\",\n\t\t\"Validation errors:\",\n\t\tformattedErrors,\n\t\t\"\",\n\t\t\"Please check your configuration file and ensure:\",\n\t\t\"  - All required fields are present (specs array with input/output)\",\n\t\t\"  - Field names are spelled correctly (no typos)\",\n\t\t\"  - Values match the expected types (e.g., mode: 'strict' | 'normal' | 'loose')\",\n\t\t\"  - No unknown/extra properties are included\",\n\t];\n\n\tif (additionalNotes && additionalNotes.length > 0) {\n\t\tlines.push(...additionalNotes.map(note => `  - ${note}`));\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n","/**\n * Content type utilities for determining response parsing methods\n */\n\n/**\n * Result of content type analysis\n */\nexport interface ContentTypeParseResult {\n\t/**\n\t * The recommended parsing method\n\t * - \"json\": Use response.json() for JSON content types\n\t * - \"text\": Use response.text() for text-based content types\n\t * - \"body\": Use response.body() for binary content types\n\t */\n\tmethod: \"json\" | \"text\" | \"body\";\n\n\t/**\n\t * Whether the content type was unknown and fallback was used\n\t */\n\tisUnknown: boolean;\n}\n\n/**\n * Fallback parsing method for unknown content types\n */\nexport type FallbackContentTypeParsing = \"json\" | \"text\" | \"body\";\n\n/**\n * Determines the appropriate response parsing method based on content type\n *\n * Categories:\n * - JSON: application/json, text/json, *+json suffix\n * - Text: text/* (except text/json), application/xml, *+xml suffix, application/javascript\n * - Binary: image/*, audio/*, video/*, font/*, application/octet-stream, application/pdf, etc.\n *\n * @param contentType - The content type to analyze (e.g., \"application/json; charset=utf-8\")\n * @param fallback - The method to use for unknown content types (default: \"text\" for safety)\n * @returns The recommended parsing method and whether the content type was unknown\n */\nexport function getResponseParseMethod(\n\tcontentType: string | undefined,\n\tfallback: FallbackContentTypeParsing = \"text\"\n): ContentTypeParseResult {\n\t// Handle missing content type\n\tif (!contentType) {\n\t\treturn { method: fallback, isUnknown: true };\n\t}\n\n\t// Normalize: lowercase, strip charset and parameters\n\tconst normalized = contentType.toLowerCase().split(\";\")[0].trim();\n\n\t// Empty after normalization\n\tif (!normalized) {\n\t\treturn { method: fallback, isUnknown: true };\n\t}\n\n\t// JSON family\n\tif (normalized === \"application/json\" || normalized === \"text/json\" || normalized.endsWith(\"+json\")) {\n\t\treturn { method: \"json\", isUnknown: false };\n\t}\n\n\t// Text family - text/* (except text/json already handled above)\n\tif (normalized.startsWith(\"text/\")) {\n\t\treturn { method: \"text\", isUnknown: false };\n\t}\n\n\t// XML family - both standalone and suffix\n\tif (\n\t\tnormalized === \"application/xml\" ||\n\t\tnormalized.endsWith(\"+xml\") // includes image/svg+xml\n\t) {\n\t\treturn { method: \"text\", isUnknown: false };\n\t}\n\n\t// JavaScript family (text-based)\n\tif (\n\t\tnormalized === \"application/javascript\" ||\n\t\tnormalized === \"application/x-javascript\" ||\n\t\tnormalized === \"application/ecmascript\"\n\t) {\n\t\treturn { method: \"text\", isUnknown: false };\n\t}\n\n\t// Binary - images\n\tif (normalized.startsWith(\"image/\")) {\n\t\treturn { method: \"body\", isUnknown: false };\n\t}\n\n\t// Binary - audio\n\tif (normalized.startsWith(\"audio/\")) {\n\t\treturn { method: \"body\", isUnknown: false };\n\t}\n\n\t// Binary - video\n\tif (normalized.startsWith(\"video/\")) {\n\t\treturn { method: \"body\", isUnknown: false };\n\t}\n\n\t// Binary - fonts\n\tif (normalized.startsWith(\"font/\")) {\n\t\treturn { method: \"body\", isUnknown: false };\n\t}\n\n\t// Binary - common application types\n\tif (\n\t\tnormalized === \"application/octet-stream\" ||\n\t\tnormalized === \"application/pdf\" ||\n\t\tnormalized === \"application/zip\" ||\n\t\tnormalized === \"application/gzip\" ||\n\t\tnormalized === \"application/x-tar\" ||\n\t\tnormalized === \"application/x-7z-compressed\" ||\n\t\tnormalized === \"application/x-rar-compressed\" ||\n\t\tnormalized === \"application/wasm\" ||\n\t\tnormalized === \"application/x-protobuf\"\n\t) {\n\t\treturn { method: \"body\", isUnknown: false };\n\t}\n\n\t// Unknown content type - use fallback\n\treturn { method: fallback, isUnknown: true };\n}\n","/**\n * @shared Simple LRU Cache implementation for performance optimization\n * @since 1.0.0\n * Utility used by core and playwright packages\n * Prevents memory leaks from unbounded cache growth\n */\nexport class LRUCache<K, V> {\n\tprivate cache = new Map<K, V>();\n\tprivate maxSize: number;\n\n\tconstructor(maxSize: number) {\n\t\tthis.maxSize = maxSize;\n\t}\n\n\tget capacity(): number {\n\t\treturn this.maxSize;\n\t}\n\n\tget(key: K): V | undefined {\n\t\tif (!this.cache.has(key)) return undefined;\n\t\t// Move to end (most recently used)\n\t\tconst value = this.cache.get(key);\n\t\tif (value === undefined) return undefined;\n\t\tthis.cache.delete(key);\n\t\tthis.cache.set(key, value);\n\t\treturn value;\n\t}\n\n\tset(key: K, value: V): void {\n\t\tif (this.cache.has(key)) {\n\t\t\tthis.cache.delete(key);\n\t\t} else if (this.cache.size >= this.maxSize) {\n\t\t\t// Remove least recently used (first item)\n\t\t\tconst firstKey = this.cache.keys().next().value;\n\t\t\tif (firstKey !== undefined) {\n\t\t\t\tthis.cache.delete(firstKey);\n\t\t\t}\n\t\t}\n\t\tthis.cache.set(key, value);\n\t}\n\n\thas(key: K): boolean {\n\t\treturn this.cache.has(key);\n\t}\n\n\tclear(): void {\n\t\tthis.cache.clear();\n\t}\n\n\tsize(): number {\n\t\treturn this.cache.size;\n\t}\n}\n","/**\n * Name conversion utilities\n */\n\nexport interface NamingOptions {\n\tprefix?: string;\n\tsuffix?: string;\n}\n\n/**\n * Sanitize a string by replacing invalid identifier characters with underscores\n * Preserves dots, hyphens, underscores, and spaces as word separators\n * Example: \"User@Domain\" -> \"User_Domain\"\n * Example: \"User-Data@2024\" -> \"User-Data_2024\"\n */\nfunction sanitizeIdentifier(str: string): string {\n\t// Replace all non-identifier chars (except dots, hyphens, underscores, spaces) with underscores\n\t// Valid identifier chars: letters, digits, underscore\n\t// Preserve: dots, hyphens, underscores, spaces as word separators\n\treturn str.replace(/[^a-zA-Z0-9._\\-\\s]+/g, \"_\");\n}\n\n/**\n * Convert schema name to camelCase with optional prefix/suffix\n * Handles dotted names like \"Company.Models.User\" -> \"companyModelsUser\"\n */\nexport function toCamelCase(str: string, options?: NamingOptions): string {\n\t// Sanitize invalid characters first\n\tconst sanitized = sanitizeIdentifier(str);\n\n\t// Split by dots, hyphens, underscores, and spaces to get words\n\tconst words = sanitized.split(/[.\\-_\\s]+/).filter(word => word.length > 0);\n\n\t// Convert to camelCase: first word lowercase, rest PascalCase\n\tlet name: string;\n\tif (words.length === 0) {\n\t\tname = str.charAt(0).toLowerCase() + str.slice(1);\n\t} else if (words.length === 1) {\n\t\tname = words[0].charAt(0).toLowerCase() + words[0].slice(1);\n\t} else {\n\t\tname =\n\t\t\twords[0].charAt(0).toLowerCase() +\n\t\t\twords[0].slice(1) +\n\t\t\twords\n\t\t\t\t.slice(1)\n\t\t\t\t.map(word => word.charAt(0).toUpperCase() + word.slice(1))\n\t\t\t\t.join(\"\");\n\t}\n\n\t// Add prefix (only lowercase first char for camelCase, preserve rest)\n\tif (options?.prefix) {\n\t\tconst prefix = options.prefix.charAt(0).toLowerCase() + options.prefix.slice(1);\n\t\tname = prefix + name.charAt(0).toUpperCase() + name.slice(1);\n\t}\n\n\t// Add suffix (capitalize first char for proper camelCase, preserve rest)\n\tif (options?.suffix) {\n\t\tconst suffix = options.suffix.charAt(0).toUpperCase() + options.suffix.slice(1);\n\t\tname = name + suffix;\n\t}\n\n\treturn name;\n}\n\n/**\n * @shared Convert enum value to PascalCase and sanitize for TypeScript enum keys\n * @since 1.0.0\n * Utility used by core and playwright packages\n * Handles dotted names like \"Company.Models.User\" -> \"CompanyModelsUser\"\n */\nexport function toPascalCase(str: string | number): string {\n\tconst stringValue = String(str);\n\n\t// Check if it's already a valid PascalCase or camelCase identifier\n\t// (only contains letters, digits, and no special characters)\n\tconst isAlreadyValidCase = /^[a-zA-Z][a-zA-Z0-9]*$/.test(stringValue);\n\n\tif (isAlreadyValidCase) {\n\t\t// Just ensure it starts with uppercase\n\t\treturn stringValue.charAt(0).toUpperCase() + stringValue.slice(1);\n\t}\n\n\t// Sanitize invalid characters first\n\tconst sanitized = sanitizeIdentifier(stringValue);\n\n\t// Split by dots, hyphens, underscores, and spaces to get words\n\tconst words = sanitized.split(/[.\\-_\\s]+/).filter(word => word.length > 0);\n\n\t// Convert all words to PascalCase\n\tlet result: string;\n\tif (words.length === 0) {\n\t\tresult = \"Value\";\n\t} else {\n\t\tresult = words.map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(\"\");\n\t}\n\n\t// Enum keys can't start with a number - prefix with 'N'\n\tif (/^\\d/.test(result)) {\n\t\tresult = `N${result}`;\n\t}\n\n\t// If result is empty or only underscores, use a default\n\tif (!result || /^_+$/.test(result)) {\n\t\treturn \"Value\";\n\t}\n\n\treturn result;\n}\n\n/**\n * Resolve $ref to schema name\n */\nexport function resolveRef(ref: string): string {\n\tconst parts = ref.split(\"/\");\n\treturn parts[parts.length - 1];\n}\n","import { minimatch } from \"minimatch\";\nimport type { OperationFilters } from \"../types\";\n\n/**\n * Filter statistics to track which operations were included/excluded\n */\nexport interface FilterStatistics {\n\ttotalOperations: number;\n\tincludedOperations: number;\n\tfilteredByTags: number;\n\tfilteredByPaths: number;\n\tfilteredByMethods: number;\n\tfilteredByOperationIds: number;\n\tfilteredByDeprecated: number;\n}\n\n/**\n * Create a new filter statistics object with all counters initialized to zero\n */\nexport function createFilterStatistics(): FilterStatistics {\n\treturn {\n\t\ttotalOperations: 0,\n\t\tincludedOperations: 0,\n\t\tfilteredByTags: 0,\n\t\tfilteredByPaths: 0,\n\t\tfilteredByMethods: 0,\n\t\tfilteredByOperationIds: 0,\n\t\tfilteredByDeprecated: 0,\n\t};\n}\n\n/**\n * Check if a value matches any of the patterns (supports glob patterns)\n * Empty patterns array = no constraint (returns true)\n */\nfunction matchesAnyPattern(value: string | undefined, patterns: string[] | undefined): boolean {\n\tif (!patterns || patterns.length === 0) {\n\t\treturn false; // No constraint means \"don't use this filter\"\n\t}\n\tif (!value) {\n\t\treturn false;\n\t}\n\treturn patterns.some(pattern => minimatch(value, pattern));\n}\n\n/**\n * Check if an array contains any of the specified values\n * Empty values array = no constraint (returns false)\n */\nfunction containsAny(arr: string[] | undefined, values: string[] | undefined): boolean {\n\tif (!values || values.length === 0) {\n\t\treturn false; // No constraint means \"don't use this filter\"\n\t}\n\tif (!arr || arr.length === 0) {\n\t\treturn false;\n\t}\n\treturn values.some(value => arr.includes(value));\n}\n\n/**\n * Determine if an operation should be included based on filter criteria\n *\n * Filter logic:\n * 1. If no filters specified, include all operations\n * 2. Empty arrays are treated as \"no constraint\" (not as \"exclude all\")\n * 3. Include filters are applied first (allowlist)\n * 4. Exclude filters are applied second (blocklist)\n * 5. Exclude rules always win over include rules\n *\n * @param operation - The OpenAPI operation object\n * @param path - The operation path (e.g., \"/users/{id}\")\n * @param method - The HTTP method (e.g., \"get\", \"post\")\n * @param filters - Optional filter configuration\n * @param stats - Optional statistics object to track filtering reasons\n * @returns true if the operation should be included, false otherwise\n */\nexport function shouldIncludeOperation(\n\toperation: any,\n\tpath: string,\n\tmethod: string,\n\tfilters?: OperationFilters,\n\tstats?: FilterStatistics\n): boolean {\n\t// If no filters specified, include all operations\n\tif (!filters) {\n\t\treturn true;\n\t}\n\n\tconst methodLower = method.toLowerCase();\n\tconst operationId = operation?.operationId;\n\tconst tags = operation?.tags || [];\n\tconst deprecated = operation?.deprecated === true;\n\n\t// Apply include filters first (allowlist)\n\t// If any include filter is specified and the operation doesn't match, exclude it\n\n\t// Check includeTags\n\tif (filters.includeTags && filters.includeTags.length > 0) {\n\t\tif (!containsAny(tags, filters.includeTags)) {\n\t\t\tif (stats) stats.filteredByTags++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check includePaths\n\tif (filters.includePaths && filters.includePaths.length > 0) {\n\t\tif (!matchesAnyPattern(path, filters.includePaths)) {\n\t\t\tif (stats) stats.filteredByPaths++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check includeMethods\n\tif (filters.includeMethods && filters.includeMethods.length > 0) {\n\t\tconst methodsLower = filters.includeMethods.map(m => m.toLowerCase());\n\t\tif (!methodsLower.includes(methodLower)) {\n\t\t\tif (stats) stats.filteredByMethods++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check includeOperationIds\n\tif (filters.includeOperationIds && filters.includeOperationIds.length > 0) {\n\t\tif (!matchesAnyPattern(operationId, filters.includeOperationIds)) {\n\t\t\tif (stats) stats.filteredByOperationIds++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Apply exclude filters second (blocklist)\n\t// If the operation matches any exclude filter, exclude it\n\n\t// Check excludeDeprecated\n\tif (filters.excludeDeprecated === true && deprecated) {\n\t\tif (stats) stats.filteredByDeprecated++;\n\t\treturn false;\n\t}\n\n\t// Check excludeTags\n\tif (filters.excludeTags && filters.excludeTags.length > 0) {\n\t\tif (containsAny(tags, filters.excludeTags)) {\n\t\t\tif (stats) stats.filteredByTags++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check excludePaths\n\tif (filters.excludePaths && filters.excludePaths.length > 0) {\n\t\tif (matchesAnyPattern(path, filters.excludePaths)) {\n\t\t\tif (stats) stats.filteredByPaths++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check excludeMethods\n\tif (filters.excludeMethods && filters.excludeMethods.length > 0) {\n\t\tconst methodsLower = filters.excludeMethods.map(m => m.toLowerCase());\n\t\tif (methodsLower.includes(methodLower)) {\n\t\t\tif (stats) stats.filteredByMethods++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Check excludeOperationIds\n\tif (filters.excludeOperationIds && filters.excludeOperationIds.length > 0) {\n\t\tif (matchesAnyPattern(operationId, filters.excludeOperationIds)) {\n\t\t\tif (stats) stats.filteredByOperationIds++;\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t// Operation passed all filters\n\treturn true;\n}\n\n/**\n * Validate filter statistics and emit warnings for filters that matched nothing\n * Helps users debug filter configurations that might be too restrictive or contain typos\n *\n * @param stats - Filter statistics object\n * @param filters - The filter configuration to validate\n */\nexport function validateFilters(stats: FilterStatistics, filters?: OperationFilters): void {\n\tif (!filters || stats.totalOperations === 0) {\n\t\treturn;\n\t}\n\n\t// If all operations were filtered out, emit a warning\n\tif (stats.includedOperations === 0) {\n\t\tconsole.warn(\n\t\t\t`⚠️  Warning: All ${stats.totalOperations} operations were filtered out. Check your operationFilters configuration.`\n\t\t);\n\n\t\t// Provide specific guidance about which filters might be the issue\n\t\tconst filterBreakdown: string[] = [];\n\t\tif (stats.filteredByTags > 0) filterBreakdown.push(`${stats.filteredByTags} by tags`);\n\t\tif (stats.filteredByPaths > 0) filterBreakdown.push(`${stats.filteredByPaths} by paths`);\n\t\tif (stats.filteredByMethods > 0) filterBreakdown.push(`${stats.filteredByMethods} by methods`);\n\t\tif (stats.filteredByOperationIds > 0) filterBreakdown.push(`${stats.filteredByOperationIds} by operationIds`);\n\t\tif (stats.filteredByDeprecated > 0) filterBreakdown.push(`${stats.filteredByDeprecated} by deprecated flag`);\n\n\t\tif (filterBreakdown.length > 0) {\n\t\t\tconsole.warn(`   Filtered: ${filterBreakdown.join(\", \")}`);\n\t\t}\n\t}\n}\n\n/**\n * Format filter statistics for display in generated output\n * Returns a formatted string suitable for inclusion in comments\n *\n * @param stats - Filter statistics object\n * @returns Formatted statistics string\n */\nexport function formatFilterStatistics(stats: FilterStatistics): string {\n\tif (stats.totalOperations === 0) {\n\t\treturn \"\";\n\t}\n\n\tconst lines: string[] = [];\n\tlines.push(\"Operation Filtering:\");\n\tlines.push(`  Total operations: ${stats.totalOperations}`);\n\tlines.push(`  Included operations: ${stats.includedOperations}`);\n\n\tconst filteredCount =\n\t\tstats.filteredByTags +\n\t\tstats.filteredByPaths +\n\t\tstats.filteredByMethods +\n\t\tstats.filteredByOperationIds +\n\t\tstats.filteredByDeprecated;\n\n\tif (filteredCount > 0) {\n\t\tlines.push(`  Filtered operations: ${filteredCount}`);\n\t\tif (stats.filteredByTags > 0) lines.push(`    - By tags: ${stats.filteredByTags}`);\n\t\tif (stats.filteredByPaths > 0) lines.push(`    - By paths: ${stats.filteredByPaths}`);\n\t\tif (stats.filteredByMethods > 0) lines.push(`    - By methods: ${stats.filteredByMethods}`);\n\t\tif (stats.filteredByOperationIds > 0) lines.push(`    - By operationIds: ${stats.filteredByOperationIds}`);\n\t\tif (stats.filteredByDeprecated > 0) lines.push(`    - By deprecated: ${stats.filteredByDeprecated}`);\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n","import { minimatch } from \"minimatch\";\n\n/**\n * Pattern matching utilities for prefix stripping\n *\n * Shared utility used by core and playwright packages\n *\n * Supports both literal string matching and glob patterns for stripping\n * prefixes from strings (paths, schema names, etc.)\n */\n\n/**\n * Validates if a glob pattern is syntactically valid\n * @param pattern - The glob pattern to validate\n * @returns true if valid, false otherwise\n */\nfunction isValidGlobPattern(pattern: string): boolean {\n\ttry {\n\t\t// Try to create a minimatch instance to validate the pattern\n\t\tnew minimatch.Minimatch(pattern);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Checks if a pattern contains glob special characters\n * @param pattern - The pattern to check\n * @returns true if pattern contains glob wildcards\n */\nfunction isGlobPattern(pattern: string): boolean {\n\treturn /[*?[\\]{}!]/.test(pattern);\n}\n\n/**\n * @shared Strips a prefix from a string using either literal string matching or glob patterns\n * @since 1.1.0\n * Shared utility used by core and playwright packages\n *\n * @param input - The full string to strip from\n * @param pattern - The glob pattern to strip\n * @param ensureLeadingChar - Optional character to ensure at start (e.g., \"/\" for paths)\n * @returns The string with prefix removed, or original string if no match\n *\n * @example\n * // Literal string matching\n * stripPrefix(\"/api/v1/users\", \"/api/v1\") // => \"/users\"\n * stripPrefix(\"Company.Models.User\", \"Company.Models.\") // => \"User\"\n *\n * @example\n * // Glob pattern matching\n * stripPrefix(\"/api/v1.0/users\", \"/api/v*\") // => matches and strips\n * stripPrefix(\"Company.Models.User\", \"*.Models.\") // => \"User\"\n * stripPrefix(\"api_v2_UserSchema\", \"api_v[0-9]_\") // => \"UserSchema\"\n */\nexport function stripPrefix(input: string, pattern: string | undefined, ensureLeadingChar?: string): string {\n\tif (!pattern) {\n\t\treturn input;\n\t}\n\n\t// Validate glob pattern if it contains special characters\n\tif (isGlobPattern(pattern) && !isValidGlobPattern(pattern)) {\n\t\tconsole.warn(`⚠️  Invalid glob pattern \"${pattern}\": Pattern is malformed`);\n\t\treturn input;\n\t}\n\n\t// Check if pattern contains glob wildcards\n\tif (isGlobPattern(pattern)) {\n\t\t// Use glob matching to find the prefix\n\t\t// We need to find what part of the input matches the pattern as a prefix\n\t\t// Try matching progressively longer prefixes to find the longest match\n\t\tlet longestMatch = -1;\n\n\t\tfor (let i = 1; i <= input.length; i++) {\n\t\t\tconst testPrefix = input.substring(0, i);\n\t\t\tif (minimatch(testPrefix, pattern)) {\n\t\t\t\t// Found a match - keep looking for a longer match\n\t\t\t\tlongestMatch = i;\n\t\t\t}\n\t\t}\n\n\t\tif (longestMatch > 0) {\n\t\t\t// Strip the longest matching prefix\n\t\t\tconst stripped = input.substring(longestMatch);\n\n\t\t\t// Ensure result starts with specified character if provided\n\t\t\tif (ensureLeadingChar) {\n\t\t\t\tif (stripped === \"\") {\n\t\t\t\t\treturn ensureLeadingChar;\n\t\t\t\t}\n\t\t\t\tif (!stripped.startsWith(ensureLeadingChar)) {\n\t\t\t\t\treturn `${ensureLeadingChar}${stripped}`;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn stripped === \"\" && !ensureLeadingChar ? input : stripped;\n\t\t}\n\n\t\t// No match found\n\t\treturn input;\n\t}\n\n\t// Literal string matching\n\tif (input.startsWith(pattern)) {\n\t\tconst stripped = input.substring(pattern.length);\n\n\t\t// Ensure result starts with specified character if provided\n\t\tif (ensureLeadingChar) {\n\t\t\tif (stripped === \"\") {\n\t\t\t\treturn ensureLeadingChar;\n\t\t\t}\n\t\t\tif (!stripped.startsWith(ensureLeadingChar)) {\n\t\t\t\treturn `${ensureLeadingChar}${stripped}`;\n\t\t\t}\n\t\t}\n\n\t\treturn stripped;\n\t}\n\n\t// No match - return original input\n\treturn input;\n}\n\n/**\n * @shared Strips a prefix from a path (ensures leading slash)\n * @since 1.1.0\n * Shared utility used by playwright package for path manipulation\n *\n * @param path - The full path to strip from\n * @param pattern - The glob pattern to strip\n * @returns The path with prefix removed, or original path if no match\n *\n * @example\n * stripPathPrefix(\"/api/v1/users\", \"/api/v1\") // => \"/users\"\n * stripPathPrefix(\"/api/v2/posts\", \"/api/v*\") // => \"/posts\"\n * stripPathPrefix(\"/api/v1.0/items\", \"/api/v[0-9].*\") // => \"/items\"\n */\nexport function stripPathPrefix(path: string, pattern: string | undefined): string {\n\tif (!pattern) {\n\t\treturn path;\n\t}\n\n\t// For literal string matching with paths, normalize the pattern\n\tif (!isGlobPattern(pattern)) {\n\t\tlet normalizedPattern = pattern.trim();\n\t\tif (!normalizedPattern.startsWith(\"/\")) {\n\t\t\tnormalizedPattern = `/${normalizedPattern}`;\n\t\t}\n\t\tif (normalizedPattern.endsWith(\"/\") && normalizedPattern !== \"/\") {\n\t\t\tnormalizedPattern = normalizedPattern.slice(0, -1);\n\t\t}\n\n\t\treturn stripPrefix(path, normalizedPattern, \"/\");\n\t}\n\n\t// For glob patterns, use as-is\n\treturn stripPrefix(path, pattern, \"/\");\n}\n","/**\n * OpenAPI $ref resolution utilities\n *\n * Provides functions to resolve $ref references to component definitions\n * Supports: parameters, requestBodies, responses, schemas\n *\n * @internal Used by core and playwright packages\n */\n\nimport type { OpenAPIParameter, OpenAPIRequestBody, OpenAPIResponse, OpenAPISchema, OpenAPISpec } from \"../types\";\n\n/**\n * Type for any resolvable component\n */\ntype ResolvableComponent = OpenAPIParameter | OpenAPIRequestBody | OpenAPIResponse | OpenAPISchema | any;\n\n/**\n * Resolve a $ref to a component definition\n * Handles nested $refs by recursively resolving until no more refs found\n *\n * @param obj - Object that may contain a $ref\n * @param spec - The OpenAPI specification\n * @param maxDepth - Maximum recursion depth to prevent infinite loops (default: 10)\n * @returns The resolved component, or the original object if not a reference\n */\nexport function resolveRef<T extends ResolvableComponent>(obj: T | any, spec: OpenAPISpec, maxDepth = 10): T {\n\tif (!obj || typeof obj !== \"object\" || maxDepth <= 0) return obj;\n\tif (!obj.$ref) return obj;\n\n\tconst ref = obj.$ref as string;\n\tlet resolved: any = null;\n\n\t// Match different component types\n\tconst paramMatch = ref.match(/^#\\/components\\/parameters\\/(.+)$/);\n\tconst requestBodyMatch = ref.match(/^#\\/components\\/requestBodies\\/(.+)$/);\n\tconst responseMatch = ref.match(/^#\\/components\\/responses\\/(.+)$/);\n\tconst schemaMatch = ref.match(/^#\\/components\\/schemas\\/(.+)$/);\n\n\tif (paramMatch && spec.components?.parameters) {\n\t\tconst name = paramMatch[1];\n\t\tresolved = spec.components.parameters[name];\n\t} else if (requestBodyMatch && spec.components?.requestBodies) {\n\t\tconst name = requestBodyMatch[1];\n\t\tresolved = spec.components.requestBodies[name];\n\t} else if (responseMatch && spec.components?.responses) {\n\t\tconst name = responseMatch[1];\n\t\tresolved = spec.components.responses[name];\n\t} else if (schemaMatch && spec.components?.schemas) {\n\t\tconst name = schemaMatch[1];\n\t\tresolved = spec.components.schemas[name];\n\t}\n\n\tif (resolved) {\n\t\t// Recursively resolve nested $refs\n\t\tif (resolved.$ref) {\n\t\t\treturn resolveRef(resolved, spec, maxDepth - 1);\n\t\t}\n\t\treturn resolved;\n\t}\n\n\t// Return original if can't resolve\n\treturn obj;\n}\n\n/**\n * Resolve a parameter reference\n * Convenience wrapper for resolveRef with parameter type\n */\nexport function resolveParameterRef(param: any, spec: OpenAPISpec): OpenAPIParameter | any {\n\treturn resolveRef<OpenAPIParameter>(param, spec);\n}\n\n/**\n * Resolve a request body reference\n * Convenience wrapper for resolveRef with request body type\n */\nexport function resolveRequestBodyRef(requestBody: any, spec: OpenAPISpec): OpenAPIRequestBody | any {\n\treturn resolveRef<OpenAPIRequestBody>(requestBody, spec);\n}\n\n/**\n * Resolve a response reference\n * Convenience wrapper for resolveRef with response type\n */\nexport function resolveResponseRef(response: any, spec: OpenAPISpec): OpenAPIResponse | any {\n\treturn resolveRef<OpenAPIResponse>(response, spec);\n}\n\n/**\n * Merge path-level parameters with operation-level parameters\n * Operation parameters override path-level parameters with the same name and location\n *\n * @param pathParams - Parameters defined at the path level\n * @param operationParams - Parameters defined at the operation level\n * @param spec - The OpenAPI specification for resolving $refs\n * @returns Merged array of resolved parameters\n */\nexport function mergeParameters(\n\tpathParams: any[] | undefined,\n\toperationParams: any[] | undefined,\n\tspec: OpenAPISpec\n): any[] {\n\tconst resolvedPathParams = (pathParams || []).map(p => resolveParameterRef(p, spec));\n\tconst resolvedOperationParams = (operationParams || []).map(p => resolveParameterRef(p, spec));\n\n\t// Start with path-level params\n\tconst merged = [...resolvedPathParams];\n\n\t// Operation params override path params by name + in\n\tfor (const opParam of resolvedOperationParams) {\n\t\tif (!opParam || typeof opParam !== \"object\") continue;\n\n\t\tconst existingIndex = merged.findIndex(\n\t\t\tp => p && typeof p === \"object\" && p.name === opParam.name && p.in === opParam.in\n\t\t);\n\n\t\tif (existingIndex >= 0) {\n\t\t\t// Override existing param\n\t\t\tmerged[existingIndex] = opParam;\n\t\t} else {\n\t\t\t// Add new param\n\t\t\tmerged.push(opParam);\n\t\t}\n\t}\n\n\treturn merged;\n}\n","/**\n * String utility functions for escaping and formatting\n */\n\nimport type { OpenAPISchema } from \"../types\";\n\n/**\n * Escape string for description in .describe()\n */\nexport function escapeDescription(str: string): string {\n\treturn str.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"').replace(/\\n/g, \"\\\\n\");\n}\n\n/**\n * Escape regex pattern for use in code\n * Only escapes forward slashes which would terminate the regex literal\n */\nexport function escapePattern(str: string): string {\n\treturn str.replace(/\\//g, \"\\\\/\");\n}\n\n/**\n * @shared Escape JSDoc comment content to prevent injection\n * @since 1.0.0\n * Utility used by core and playwright packages\n */\nexport function escapeJSDoc(str: string): string {\n\treturn str.replace(/\\*\\//g, \"*\\\\/\");\n}\n\n/**\n * Wrap validation with .nullable() if needed\n */\nexport function wrapNullable(validation: string, isNullable: boolean): string {\n\treturn isNullable ? `${validation}.nullable()` : validation;\n}\n\n/**\n * Check if schema is nullable (supports both OpenAPI 3.0 and 3.1 syntax)\n * @param schema - The OpenAPI schema to check\n * @param defaultNullable - Default nullable behavior when not explicitly specified (default: false)\n */\nexport function isNullable(schema: OpenAPISchema, defaultNullable = false): boolean {\n\t// OpenAPI 3.0 style: nullable explicitly set\n\tif (schema.nullable === true) {\n\t\treturn true;\n\t}\n\tif (schema.nullable === false) {\n\t\treturn false;\n\t}\n\t// OpenAPI 3.1 style: type can be an array including \"null\"\n\tif (Array.isArray(schema.type)) {\n\t\treturn schema.type.includes(\"null\");\n\t}\n\t// No explicit nullable annotation - use default\n\treturn defaultNullable;\n}\n\n/**\n * Get the primary type from schema (handles OpenAPI 3.1 type arrays)\n */\nexport function getPrimaryType(schema: OpenAPISchema): string | undefined {\n\tif (Array.isArray(schema.type)) {\n\t\t// OpenAPI 3.1: type can be an array like [\"string\", \"null\"]\n\t\t// Return the first non-null type\n\t\tconst nonNullType = schema.type.find(t => t !== \"null\");\n\t\treturn nonNullType;\n\t}\n\treturn schema.type;\n}\n\n/**\n * Check if schema has multiple non-null types\n */\nexport function hasMultipleTypes(schema: OpenAPISchema): boolean {\n\tif (Array.isArray(schema.type)) {\n\t\tconst nonNullTypes = schema.type.filter(t => t !== \"null\");\n\t\treturn nonNullTypes.length > 1;\n\t}\n\treturn false;\n}\n\n/**\n * Add description to a schema validation string\n */\nexport function addDescription(validation: string, description: string | undefined, useDescribe: boolean): string {\n\tif (!description || !useDescribe) return validation;\n\n\tconst escapedDesc = escapeDescription(description);\n\treturn `${validation}.describe(\"${escapedDesc}\")`;\n}\n","import type { Loader } from \"cosmiconfig\";\n\n/**\n * @shared Create a TypeScript loader for cosmiconfig using esbuild\n * @since 1.0.0\n * Utility used by core and playwright packages\n *\n * Creates a loader that transpiles TypeScript config files to JavaScript\n * using esbuild, then executes them to load the configuration.\n *\n * @returns A cosmiconfig Loader function\n */\nexport function createTypeScriptLoader(): Loader {\n\treturn async (filepath: string) => {\n\t\ttry {\n\t\t\t// Use esbuild to transpile TypeScript to JavaScript\n\t\t\tconst esbuild = await import(\"esbuild\");\n\t\t\tconst fs = await import(\"node:fs\");\n\t\t\tconst path = await import(\"node:path\");\n\n\t\t\tconst tsCode = fs.readFileSync(filepath, \"utf-8\");\n\t\t\tconst result = await esbuild.build({\n\t\t\t\tstdin: {\n\t\t\t\t\tcontents: tsCode,\n\t\t\t\t\tloader: \"ts\",\n\t\t\t\t\tresolveDir: path.dirname(filepath),\n\t\t\t\t\tsourcefile: filepath,\n\t\t\t\t},\n\t\t\t\tformat: \"cjs\",\n\t\t\t\tplatform: \"node\",\n\t\t\t\ttarget: \"node18\",\n\t\t\t\tbundle: false,\n\t\t\t\twrite: false,\n\t\t\t});\n\n\t\t\tconst jsCode = result.outputFiles[0].text;\n\n\t\t\t// Create a module and execute it\n\t\t\tconst module = { exports: {} } as any;\n\t\t\tconst func = new Function(\"exports\", \"module\", \"require\", \"__filename\", \"__dirname\", jsCode);\n\t\t\tfunc(module.exports, module, require, filepath, path.dirname(filepath));\n\n\t\t\treturn module.exports.default || module.exports;\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to load TypeScript config from ${filepath}: ${error instanceof Error ? error.message : String(error)}`\n\t\t\t);\n\t\t}\n\t};\n}\n","import type { OpenAPISchema } from \"../types\";\nimport { LRUCache } from \"../utils/lru-cache\";\nimport { addDescription, escapePattern } from \"../utils/string-utils\";\n\n// Performance optimization: Cache compiled regex patterns with configurable size limit\n// Cache is shared across all generators for performance, but size can be configured per generator\nlet PATTERN_CACHE = new LRUCache<string, string>(1000);\n\n/**\n * Configure the pattern cache size\n * Should be called before generating schemas for large specifications\n */\nexport function configurePatternCache(size: number): void {\n\tif (size > 0 && size !== PATTERN_CACHE.capacity) {\n\t\tPATTERN_CACHE = new LRUCache<string, string>(size);\n\t}\n}\n\n// Default format map (without date-time, which can be customized)\nconst DEFAULT_FORMAT_MAP: Record<string, string> = {\n\tuuid: \"z.uuid()\",\n\temail: \"z.email()\",\n\turi: \"z.url()\",\n\turl: \"z.url()\",\n\t\"uri-reference\": 'z.string().refine((val) => !/\\\\s/.test(val), { message: \"Must be a valid URI reference\" })',\n\thostname:\n\t\t'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\" })',\n\tbyte: \"z.base64()\",\n\tbinary: \"z.string()\",\n\tdate: \"z.iso.date()\",\n\ttime: \"z.iso.time()\",\n\tduration:\n\t\t'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\" })',\n\tipv4: \"z.ipv4()\",\n\tipv6: \"z.ipv6()\",\n\temoji: \"z.emoji()\",\n\tbase64: \"z.base64()\",\n\tbase64url: \"z.base64url()\",\n\tnanoid: \"z.nanoid()\",\n\tcuid: \"z.cuid()\",\n\tcuid2: \"z.cuid2()\",\n\tulid: \"z.ulid()\",\n\tcidr: \"z.cidrv4()\", // Default to v4\n\tcidrv4: \"z.cidrv4()\",\n\tcidrv6: \"z.cidrv6()\",\n\t\"json-pointer\":\n\t\t'z.string().refine((val) => val === \"\" || /^(\\\\/([^~/]|~0|~1)+)+$/.test(val), { message: \"Must be a valid JSON Pointer (RFC 6901)\" })',\n\t\"relative-json-pointer\":\n\t\t'z.string().refine((val) => /^(0|[1-9]\\\\d*)(#|(\\\\/([^~/]|~0|~1)+)*)$/.test(val), { message: \"Must be a valid relative JSON Pointer\" })',\n};\n\n// Mutable format map that includes date-time and can be configured\nlet FORMAT_MAP: Record<string, string> = {\n\t...DEFAULT_FORMAT_MAP,\n\t\"date-time\": \"z.iso.datetime()\",\n};\n\n/**\n * Configure custom date-time format validation\n * Overrides the default z.iso.datetime() with a custom regex pattern\n *\n * @param pattern - Regex pattern (string or RegExp) for date-time validation\n * @throws {Error} If the provided pattern is not a valid regular expression\n * @example\n * // String pattern (required for JSON/YAML configs)\n * configureDateTimeFormat('^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}$')\n *\n * @example\n * // RegExp literal (TypeScript configs only)\n * configureDateTimeFormat(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$/)\n */\nexport function configureDateTimeFormat(pattern?: string | RegExp): void {\n\tif (!pattern) {\n\t\t// Reset to default\n\t\tFORMAT_MAP[\"date-time\"] = \"z.iso.datetime()\";\n\t\treturn;\n\t}\n\n\t// Convert RegExp to string if needed\n\tconst patternStr = pattern instanceof RegExp ? pattern.source : pattern;\n\n\t// Empty string resets to default\n\tif (patternStr === \"\") {\n\t\tFORMAT_MAP[\"date-time\"] = \"z.iso.datetime()\";\n\t\treturn;\n\t}\n\n\t// Validate the regex pattern\n\ttry {\n\t\tnew RegExp(patternStr);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Invalid regular expression pattern for customDateTimeFormatRegex: ${patternStr}. ${\n\t\t\t\terror instanceof Error ? error.message : \"Pattern is malformed\"\n\t\t\t}`\n\t\t);\n\t}\n\n\t// Escape the pattern for use in generated code\n\tconst escapedPattern = escapePattern(patternStr);\n\n\t// Update the format map with the custom regex\n\tFORMAT_MAP[\"date-time\"] = `z.string().regex(/${escapedPattern}/)`;\n}\n\n/**\n * Reset format map to defaults (useful for testing)\n */\nexport function resetFormatMap(): void {\n\tFORMAT_MAP = {\n\t\t...DEFAULT_FORMAT_MAP,\n\t\t\"date-time\": \"z.iso.datetime()\",\n\t};\n}\n\n/**\n * Generate Zod validation for string with format (Zod v4 compatible)\n */\nexport function generateStringValidation(schema: OpenAPISchema, useDescribe: boolean): string {\n\t// Handle format with Zod v4 top-level functions (performance optimized with map)\n\tlet validation = FORMAT_MAP[schema.format || \"\"] || \"z.string()\";\n\n\t// Add length constraints\n\tif (schema.minLength !== undefined) {\n\t\tvalidation += `.min(${schema.minLength})`;\n\t}\n\tif (schema.maxLength !== undefined) {\n\t\tvalidation += `.max(${schema.maxLength})`;\n\t}\n\n\t// Add pattern (with cached escaping for performance)\n\tif (schema.pattern) {\n\t\tlet escapedPattern = PATTERN_CACHE.get(schema.pattern);\n\t\tif (escapedPattern === undefined) {\n\t\t\tescapedPattern = escapePattern(schema.pattern);\n\t\t\tPATTERN_CACHE.set(schema.pattern, escapedPattern);\n\t\t}\n\t\tvalidation += `.regex(/${escapedPattern}/)`;\n\t}\n\n\t// Handle content encoding (OpenAPI 3.1)\n\tif (schema.contentEncoding && !schema.format) {\n\t\tswitch (schema.contentEncoding) {\n\t\t\tcase \"base64\":\n\t\t\t\tvalidation = \"z.base64()\";\n\t\t\t\tbreak;\n\t\t\tcase \"base64url\":\n\t\t\t\tvalidation = \"z.base64url()\";\n\t\t\t\tbreak;\n\t\t\tcase \"quoted-printable\":\n\t\t\t\t// Quoted-printable validation\n\t\t\t\tvalidation =\n\t\t\t\t\t'z.string().refine((val) => /^[\\\\x20-\\\\x7E\\\\r\\\\n=]*$/.test(val), { message: \"Must be valid quoted-printable encoding\" })';\n\t\t\t\tbreak;\n\t\t\tcase \"7bit\":\n\t\t\tcase \"8bit\":\n\t\t\tcase \"binary\":\n\t\t\t\t// Basic string validation for these encodings\n\t\t\t\tvalidation = \"z.string()\";\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Unknown encoding, use string with refinement note\n\t\t\t\tvalidation = `z.string().describe(\"Content encoding: ${schema.contentEncoding}\")`;\n\t\t}\n\n\t\t// Re-apply constraints after encoding\n\t\tif (schema.minLength !== undefined) {\n\t\t\tvalidation += `.min(${schema.minLength})`;\n\t\t}\n\t\tif (schema.maxLength !== undefined) {\n\t\t\tvalidation += `.max(${schema.maxLength})`;\n\t\t}\n\t\tif (schema.pattern) {\n\t\t\tlet escapedPattern = PATTERN_CACHE.get(schema.pattern);\n\t\t\tif (escapedPattern === undefined) {\n\t\t\t\tescapedPattern = escapePattern(schema.pattern);\n\t\t\t\tPATTERN_CACHE.set(schema.pattern, escapedPattern);\n\t\t\t}\n\t\t\tvalidation += `.regex(/${escapedPattern}/)`;\n\t\t}\n\t} else if (schema.contentMediaType) {\n\t\t// Add refinement for media type validation\n\t\tconst mediaType = schema.contentMediaType;\n\t\tif (mediaType === \"application/json\") {\n\t\t\tvalidation += `.refine((val) => { try { JSON.parse(val); return true; } catch { return false; } }, { message: \"Must be valid JSON\" })`;\n\t\t} else if (mediaType === \"application/xml\" || mediaType === \"text/xml\") {\n\t\t\t// Basic XML validation - check for well-formed XML structure\n\t\t\tvalidation += `.refine((val) => { try { if (typeof DOMParser !== \"undefined\") { const parser = new DOMParser(); const doc = parser.parseFromString(val, \"text/xml\"); return !doc.querySelector(\"parsererror\"); } return /^\\\\s*<[^>]+>/.test(val); } catch { return false; } }, { message: \"Must be valid XML\" })`;\n\t\t} else if (mediaType === \"application/yaml\" || mediaType === \"application/x-yaml\" || mediaType === \"text/yaml\") {\n\t\t\t// Basic YAML validation - check for basic YAML structure\n\t\t\tvalidation += `.refine((val) => { try { return val.trim().length > 0 && !/^[[{]/.test(val.trim()); } catch { return false; } }, { message: \"Must be valid YAML\" })`;\n\t\t} else if (mediaType === \"text/html\") {\n\t\t\t// Basic HTML validation - check for HTML tags\n\t\t\tvalidation += `.refine((val) => /<[^>]+>/.test(val), { message: \"Must contain HTML tags\" })`;\n\t\t} else if (mediaType === \"text/plain\") {\n\t\t\t// Plain text - no special validation needed, but mark it\n\t\t\tvalidation += `.refine(() => true, { message: \"Plain text content\" })`;\n\t\t}\n\t\t// Other media types default to no validation beyond string\n\t}\n\n\t// Add description if useDescribe is enabled\n\treturn addDescription(validation, schema.description, useDescribe);\n}\n"],"mappings":"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","names":["minimatch"]}

package/dist/{types-B3GgqGzM.d.mts → types-DZ4Bw-D5.d.mts}

@@ -69,10 +69,8 @@ interface OpenApiGeneratorOptions {
     input: string;
     /**
      * Output TypeScript file path
-     * Optional when using string generation methods (generateString)
-     * Required when calling generate() to write to a file
      */
-    output?: string;
+    output: string;
     /**
      * Whether to include descriptions as JSDoc comments
      */
@@ -172,6 +170,19 @@ interface OpenApiGeneratorOptions {
      * @default true
      */
     showStats?: boolean;
+    /**
+     * Fallback parsing method for unknown or missing content types
+     *
+     * When a content type is not recognized, this determines how the response is parsed:
+     * - "text": Use response.text() - safest, always succeeds (default)
+     * - "json": Use response.json() - may throw if response isn't valid JSON
+     * - "body": Use response.body() - returns raw Buffer
+     *
+     * A warning will be logged during generation when an unknown content type is encountered.
+     *
+     * @default "text"
+     */
+    fallbackContentTypeParsing?: "text" | "json" | "body";
     /**
      * Request-specific options that override root-level options
      * Applied when schemas are used in request contexts

package/dist/{types-B3GgqGzM.d.ts → types-DZ4Bw-D5.d.ts}

@@ -69,10 +69,8 @@ interface OpenApiGeneratorOptions {
     input: string;
     /**
      * Output TypeScript file path
-     * Optional when using string generation methods (generateString)
-     * Required when calling generate() to write to a file
      */
-    output?: string;
+    output: string;
     /**
      * Whether to include descriptions as JSDoc comments
      */
@@ -172,6 +170,19 @@ interface OpenApiGeneratorOptions {
      * @default true
      */
     showStats?: boolean;
+    /**
+     * Fallback parsing method for unknown or missing content types
+     *
+     * When a content type is not recognized, this determines how the response is parsed:
+     * - "text": Use response.text() - safest, always succeeds (default)
+     * - "json": Use response.json() - may throw if response isn't valid JSON
+     * - "body": Use response.body() - returns raw Buffer
+     *
+     * A warning will be logged during generation when an unknown content type is encountered.
+     *
+     * @default "text"
+     */
+    fallbackContentTypeParsing?: "text" | "json" | "body";
     /**
      * Request-specific options that override root-level options
      * Applied when schemas are used in request contexts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cerios/openapi-to-zod",
-	"version": "1.3.0",
+	"version": "1.3.2",
 	"author": "Ronald Veth - Cerios",
 	"description": "Generate Zod schemas from OpenAPI specifications. A TypeScript code generator that converts OpenAPI/Swagger YAML definitions into type-safe Zod validation schemas.",
 	"license": "MIT",