@cerios/openapi-to-zod 1.6.0 → 1.7.0

package/dist/index.d.mts

@@ -5,6 +5,14 @@ export { CircularReferenceError, CliOptionsError, ConfigValidationError, Executi
  * Re-export core types from @cerios/openapi-core
  */
 
+/**
+ * UUID/GUID format option for controlling how `format: "uuid"` and `format: "guid"` are translated to Zod validators
+ *
+ * - `"uuid"`: Uses `z.uuid()` (default)
+ * - `"guid"`: Uses `z.guid()`
+ * - `"uuidv1"` through `"uuidv8"`: Uses `z.uuid({ version: "v1" })` through `z.uuid({ version: "v8" })`
+ */
+type UuidFormat = "uuid" | "guid" | "uuidv1" | "uuidv2" | "uuidv3" | "uuidv4" | "uuidv5" | "uuidv6" | "uuidv7" | "uuidv8";
 /**
  * Common options shared by both request and response contexts
  */
@@ -162,6 +170,17 @@ interface OpenApiGeneratorOptions extends BaseGeneratorOptions {
      * @default "z.iso.datetime()" (requires Z suffix per ISO 8601)
      */
     customDateTimeFormatRegex?: string | RegExp;
+    /**
+     * UUID/GUID format for Zod validation
+     * Controls how OpenAPI `format: "uuid"` and `format: "guid"` are translated to Zod validators
+     *
+     * - `"uuid"`: Uses `z.uuid()` (default)
+     * - `"guid"`: Uses `z.guid()`
+     * - `"uuidv1"` through `"uuidv8"`: Uses `z.uuid({ version: "v1" })` through `z.uuid({ version: "v8" })`
+     *
+     * @default "uuid"
+     */
+    uuidFormat?: UuidFormat;
     /**
      * Output path for Zod schemas when using separate type/schema files.
      *
@@ -323,6 +342,11 @@ interface PropertyGeneratorContext {
      * @default "z.iso.datetime()"
      */
     dateTimeValidation: string;
+    /**
+     * Zod validation string for uuid/guid format fields
+     * @default "z.uuid()"
+     */
+    uuidValidation: string;
     /**
      * Instance-level cache for escaped regex patterns (parallel-safe)
      */
@@ -446,6 +470,8 @@ declare class OpenApiGenerator {
     private patternCache;
     /** Instance-level date-time validation string for parallel-safe execution */
     private dateTimeValidation;
+    /** Instance-level uuid validation string for parallel-safe execution */
+    private uuidValidation;
     /** Track schemas involved in circular dependency chains */
     private circularDependencies;
     /** Separate schemas mode - when outputZodSchemas is specified */
@@ -589,6 +615,19 @@ declare class OpenApiGenerator {
  * // RegExp literal (TypeScript configs)
  * buildDateTimeValidation(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/)
  */
+/**
+ * Build the Zod validation string for uuid/guid format
+ * Pure function that returns the validation string without side effects
+ *
+ * @param format - UUID format option
+ * @returns Zod validation string
+ *
+ * @example
+ * buildUuidValidation() // Returns "z.uuid()"
+ * buildUuidValidation("guid") // Returns "z.guid()"
+ * buildUuidValidation("uuidv4") // Returns 'z.uuid({ version: "v4" })'
+ */
+declare function buildUuidValidation(format?: UuidFormat): string;
 declare function buildDateTimeValidation(pattern?: string | RegExp): string;
 
-export { type CommonSchemaOptions, type ConfigFile, type InternalOpenApiGeneratorOptions, OpenApiGenerator, type OpenApiGeneratorOptions, PropertyGenerator, type PropertyGeneratorContext, type RequestOptions, type ResponseOptions, buildDateTimeValidation, defineConfig };
+export { type CommonSchemaOptions, type ConfigFile, type InternalOpenApiGeneratorOptions, OpenApiGenerator, type OpenApiGeneratorOptions, PropertyGenerator, type PropertyGeneratorContext, type RequestOptions, type ResponseOptions, type UuidFormat, buildDateTimeValidation, buildUuidValidation, defineConfig };

package/dist/index.d.ts

@@ -5,6 +5,14 @@ export { CircularReferenceError, CliOptionsError, ConfigValidationError, Executi
  * Re-export core types from @cerios/openapi-core
  */
 
+/**
+ * UUID/GUID format option for controlling how `format: "uuid"` and `format: "guid"` are translated to Zod validators
+ *
+ * - `"uuid"`: Uses `z.uuid()` (default)
+ * - `"guid"`: Uses `z.guid()`
+ * - `"uuidv1"` through `"uuidv8"`: Uses `z.uuid({ version: "v1" })` through `z.uuid({ version: "v8" })`
+ */
+type UuidFormat = "uuid" | "guid" | "uuidv1" | "uuidv2" | "uuidv3" | "uuidv4" | "uuidv5" | "uuidv6" | "uuidv7" | "uuidv8";
 /**
  * Common options shared by both request and response contexts
  */
@@ -162,6 +170,17 @@ interface OpenApiGeneratorOptions extends BaseGeneratorOptions {
      * @default "z.iso.datetime()" (requires Z suffix per ISO 8601)
      */
     customDateTimeFormatRegex?: string | RegExp;
+    /**
+     * UUID/GUID format for Zod validation
+     * Controls how OpenAPI `format: "uuid"` and `format: "guid"` are translated to Zod validators
+     *
+     * - `"uuid"`: Uses `z.uuid()` (default)
+     * - `"guid"`: Uses `z.guid()`
+     * - `"uuidv1"` through `"uuidv8"`: Uses `z.uuid({ version: "v1" })` through `z.uuid({ version: "v8" })`
+     *
+     * @default "uuid"
+     */
+    uuidFormat?: UuidFormat;
     /**
      * Output path for Zod schemas when using separate type/schema files.
      *
@@ -323,6 +342,11 @@ interface PropertyGeneratorContext {
      * @default "z.iso.datetime()"
      */
     dateTimeValidation: string;
+    /**
+     * Zod validation string for uuid/guid format fields
+     * @default "z.uuid()"
+     */
+    uuidValidation: string;
     /**
      * Instance-level cache for escaped regex patterns (parallel-safe)
      */
@@ -446,6 +470,8 @@ declare class OpenApiGenerator {
     private patternCache;
     /** Instance-level date-time validation string for parallel-safe execution */
     private dateTimeValidation;
+    /** Instance-level uuid validation string for parallel-safe execution */
+    private uuidValidation;
     /** Track schemas involved in circular dependency chains */
     private circularDependencies;
     /** Separate schemas mode - when outputZodSchemas is specified */
@@ -589,6 +615,19 @@ declare class OpenApiGenerator {
  * // RegExp literal (TypeScript configs)
  * buildDateTimeValidation(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/)
  */
+/**
+ * Build the Zod validation string for uuid/guid format
+ * Pure function that returns the validation string without side effects
+ *
+ * @param format - UUID format option
+ * @returns Zod validation string
+ *
+ * @example
+ * buildUuidValidation() // Returns "z.uuid()"
+ * buildUuidValidation("guid") // Returns "z.guid()"
+ * buildUuidValidation("uuidv4") // Returns 'z.uuid({ version: "v4" })'
+ */
+declare function buildUuidValidation(format?: UuidFormat): string;
 declare function buildDateTimeValidation(pattern?: string | RegExp): string;
 
-export { type CommonSchemaOptions, type ConfigFile, type InternalOpenApiGeneratorOptions, OpenApiGenerator, type OpenApiGeneratorOptions, PropertyGenerator, type PropertyGeneratorContext, type RequestOptions, type ResponseOptions, buildDateTimeValidation, defineConfig };
+export { type CommonSchemaOptions, type ConfigFile, type InternalOpenApiGeneratorOptions, OpenApiGenerator, type OpenApiGeneratorOptions, PropertyGenerator, type PropertyGeneratorContext, type RequestOptions, type ResponseOptions, type UuidFormat, buildDateTimeValidation, buildUuidValidation, defineConfig };

package/dist/index.js

@@ -30,6 +30,7 @@ __export(src_exports, {
   SchemaGenerationError: () => import_openapi_core7.SchemaGenerationError,
   SpecValidationError: () => import_openapi_core7.SpecValidationError,
   buildDateTimeValidation: () => buildDateTimeValidation,
+  buildUuidValidation: () => buildUuidValidation,
   defineConfig: () => defineConfig
 });
 module.exports = __toCommonJS(src_exports);
@@ -739,7 +740,6 @@ ${properties.join(",\n")}
 // src/validators/string-validator.ts
 var import_openapi_core3 = require("@cerios/openapi-core");
 var DEFAULT_FORMAT_MAP = {
-  uuid: "z.uuid()",
   email: "z.email()",
   uri: "z.url()",
   url: "z.url()",
@@ -766,6 +766,16 @@ var DEFAULT_FORMAT_MAP = {
   "json-pointer": 'z.string().refine((val) => val === "" || /^(\\/([^~/]|~0|~1)+)+$/.test(val), { message: "Must be a valid JSON Pointer (RFC 6901)" })',
   "relative-json-pointer": 'z.string().refine((val) => /^(0|[1-9]\\d*)(#|(\\/([^~/]|~0|~1)+)*)$/.test(val), { message: "Must be a valid relative JSON Pointer" })'
 };
+function buildUuidValidation(format) {
+  if (!format || format === "uuid") {
+    return "z.uuid()";
+  }
+  if (format === "guid") {
+    return "z.guid()";
+  }
+  const version = format.replace("uuid", "");
+  return `z.uuid({ version: "${version}" })`;
+}
 function buildDateTimeValidation(pattern) {
   if (!pattern) {
     return "z.iso.datetime()";
@@ -789,6 +799,8 @@ function generateStringValidation(schema, useDescribe, context) {
   const format = schema.format || "";
   if (format === "date-time") {
     validation = context.dateTimeValidation;
+  } else if (format === "uuid" || format === "guid") {
+    validation = context.uuidValidation;
   } else {
     validation = DEFAULT_FORMAT_MAP[format] || "z.string()";
   }
@@ -1268,6 +1280,7 @@ var _PropertyGenerator = class _PropertyGenerator {
       case "string":
         validation = generateStringValidation(schema, this.context.useDescribe, {
           dateTimeValidation: this.context.dateTimeValidation,
+          uuidValidation: this.context.uuidValidation,
           patternCache: this.context.patternCache
         });
         break;
@@ -1466,11 +1479,13 @@ var OpenApiGenerator = class {
       cacheSize: (_h = options.cacheSize) != null ? _h : 1e3,
       batchSize: (_i = options.batchSize) != null ? _i : 10,
       customDateTimeFormatRegex: options.customDateTimeFormatRegex,
+      uuidFormat: options.uuidFormat,
       includeHeader: options.includeHeader,
       fileHeader: options.fileHeader
     };
     this.patternCache = new import_openapi_core6.LRUCache((_j = this.options.cacheSize) != null ? _j : 1e3);
     this.dateTimeValidation = buildDateTimeValidation(this.options.customDateTimeFormatRegex);
+    this.uuidValidation = buildUuidValidation(this.options.uuidFormat);
     this.spec = (0, import_openapi_core6.loadOpenAPISpec)(this.options.input);
     this.validateSpec();
     this.requestOptions = this.resolveOptionsForContext("request");
@@ -1491,6 +1506,7 @@ var OpenApiGenerator = class {
       },
       stripSchemaPrefix: this.options.stripSchemaPrefix,
       dateTimeValidation: this.dateTimeValidation,
+      uuidValidation: this.uuidValidation,
       patternCache: this.patternCache,
       separateTypesFile: this.separateSchemasMode,
       warn: (msg) => {
@@ -2032,6 +2048,7 @@ ${typeCode}`;
       },
       stripSchemaPrefix: this.options.stripSchemaPrefix,
       dateTimeValidation: this.dateTimeValidation,
+      uuidValidation: this.uuidValidation,
       patternCache: this.patternCache,
       separateTypesFile: this.separateSchemasMode,
       warn: (msg) => {
@@ -2284,7 +2301,8 @@ ${propsCode}
         email: "z.email()",
         uri: "z.url()",
         url: "z.url()",
-        uuid: "z.uuid()"
+        uuid: this.uuidValidation,
+        guid: this.uuidValidation
       };
       if (schema.format && formatMap[schema.format]) {
         let zodType2 = formatMap[schema.format];
@@ -2536,6 +2554,7 @@ function defineConfig(config) {
   SchemaGenerationError,
   SpecValidationError,
   buildDateTimeValidation,
+  buildUuidValidation,
   defineConfig
 });
 //# sourceMappingURL=index.js.map