@cerios/openapi-to-zod 1.5.1 → 1.6.1

package/dist/index.mjs

@@ -95,9 +95,11 @@ function isDiscriminatorRequired(schemas, discriminator, context) {
   };
 }
 function generateUnion(schemas, discriminator, isNullable2, context, options, currentSchema) {
+  var _a, _b;
   if (schemas.length === 0) {
-    console.warn(
-      "[openapi-to-zod] Warning: Empty oneOf/anyOf array encountered. This is likely a malformed OpenAPI spec. Generating z.never() as fallback."
+    (_a = context.warn) == null ? void 0 : _a.call(
+      context,
+      "Empty oneOf/anyOf array encountered. This is likely a malformed OpenAPI spec. Generating z.never() as fallback."
     );
     return wrapNullable(
       'z.never().describe("Empty oneOf/anyOf in OpenAPI spec - no valid schema defined")',
@@ -118,8 +120,9 @@ function generateUnion(schemas, discriminator, isNullable2, context, options, cu
     }
     const discriminatorCheck = isDiscriminatorRequired(resolvedSchemas, discriminator, context);
     if (!discriminatorCheck.valid) {
-      console.warn(
-        `[openapi-to-zod] Warning: Discriminator "${discriminator}" is not required in schemas: ${discriminatorCheck.invalidSchemas.join(", ")}. Falling back to z.union() instead of z.discriminatedUnion().`
+      (_b = context.warn) == null ? void 0 : _b.call(
+        context,
+        `Discriminator "${discriminator}" is not required in schemas: ${discriminatorCheck.invalidSchemas.join(", ")}. Falling back to z.union() instead of z.discriminatedUnion().`
       );
       let schemaStrings3 = resolvedSchemas.map((s) => context.generatePropertySchema(s, currentSchema, false, true));
       if (options == null ? void 0 : options.passthrough) {
@@ -197,6 +200,7 @@ function detectConflictingProperties(schemas, context) {
   return conflicts;
 }
 function generateAllOf(schemas, isNullable2, context, currentSchema) {
+  var _a;
   if (schemas.length === 1) {
     const singleSchema = context.generatePropertySchema(schemas[0], currentSchema, false, true);
     return { schema: wrapNullable(singleSchema, isNullable2), conflicts: [] };
@@ -205,7 +209,7 @@ function generateAllOf(schemas, isNullable2, context, currentSchema) {
   const uniqueConflicts = [...new Set(conflicts)];
   if (uniqueConflicts.length > 0) {
     for (const conflict of uniqueConflicts) {
-      console.warn(`[openapi-to-zod] Warning: allOf composition conflict - ${conflict}`);
+      (_a = context.warn) == null ? void 0 : _a.call(context, `allOf composition conflict - ${conflict}`);
     }
   }
   const allObjects = schemas.every((s) => s.type === "object" || s.properties || s.$ref || s.allOf);
@@ -1167,7 +1171,8 @@ var _PropertyGenerator = class _PropertyGenerator {
         {
           generatePropertySchema: this.generatePropertySchema.bind(this),
           generateInlineObjectShape: this.generateInlineObjectShape.bind(this),
-          resolveSchemaRef: this.resolveSchemaRef.bind(this)
+          resolveSchemaRef: this.resolveSchemaRef.bind(this),
+          warn: this.context.warn
         },
         currentSchema
       );
@@ -1190,7 +1195,8 @@ var _PropertyGenerator = class _PropertyGenerator {
         {
           generatePropertySchema: this.generatePropertySchema.bind(this),
           resolveDiscriminatorMapping: this.resolveDiscriminatorMapping.bind(this),
-          resolveSchemaRef: this.resolveSchemaRef.bind(this)
+          resolveSchemaRef: this.resolveSchemaRef.bind(this),
+          warn: this.context.warn
         },
         {
           passthrough: needsPassthrough,
@@ -1213,7 +1219,8 @@ var _PropertyGenerator = class _PropertyGenerator {
         {
           generatePropertySchema: this.generatePropertySchema.bind(this),
           resolveDiscriminatorMapping: this.resolveDiscriminatorMapping.bind(this),
-          resolveSchemaRef: this.resolveSchemaRef.bind(this)
+          resolveSchemaRef: this.resolveSchemaRef.bind(this),
+          warn: this.context.warn
         },
         {
           passthrough: needsPassthrough,
@@ -1363,6 +1370,8 @@ import {
   expandTransitiveReferences,
   extractSchemaRefs,
   formatFilterStatistics,
+  generateCustomFileHeader,
+  generateFileHeader,
   getOperationName,
   LRUCache as LRUCache2,
   loadOpenAPISpec,
@@ -1375,7 +1384,8 @@ import {
   stripPrefix as stripPrefix2,
   toCamelCase as toCamelCase3,
   toPascalCase as toPascalCase3,
-  validateFilters
+  validateFilters,
+  WarningCollector
 } from "@cerios/openapi-core";
 import { TypeScriptGenerator } from "@cerios/openapi-to-typescript";
 import { minimatch } from "minimatch";
@@ -1425,8 +1435,6 @@ var OpenApiGenerator = class {
     this.schemaUsageMap = /* @__PURE__ */ new Map();
     this.needsZodImport = true;
     this.filterStats = createFilterStatistics();
-    /** Track total allOf conflicts detected across all schemas */
-    this.allOfConflictCount = 0;
     /** Track schemas involved in circular dependency chains */
     this.circularDependencies = /* @__PURE__ */ new Set();
     var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
@@ -1434,6 +1442,11 @@ var OpenApiGenerator = class {
       throw new ConfigurationError("Input path is required", { providedOptions: options });
     }
     this.separateSchemasMode = Boolean(options.outputZodSchemas);
+    const showWarnings = options.showWarnings !== false;
+    this.warningCollector = new WarningCollector({
+      packageName: "@cerios/openapi-to-zod",
+      enabled: showWarnings
+    });
     this.options = {
       mode: options.mode || "normal",
       input: options.input,
@@ -1452,13 +1465,16 @@ var OpenApiGenerator = class {
       stripPathPrefix: options.stripPathPrefix,
       useOperationId: (_f = options.useOperationId) != null ? _f : true,
       showStats: (_g = options.showStats) != null ? _g : true,
+      showWarnings,
       request: options.request,
       response: options.response,
       operationFilters: options.operationFilters,
       ignoreHeaders: options.ignoreHeaders,
       cacheSize: (_h = options.cacheSize) != null ? _h : 1e3,
       batchSize: (_i = options.batchSize) != null ? _i : 10,
-      customDateTimeFormatRegex: options.customDateTimeFormatRegex
+      customDateTimeFormatRegex: options.customDateTimeFormatRegex,
+      includeHeader: options.includeHeader,
+      fileHeader: options.fileHeader
     };
     this.patternCache = new LRUCache2((_j = this.options.cacheSize) != null ? _j : 1e3);
     this.dateTimeValidation = buildDateTimeValidation(this.options.customDateTimeFormatRegex);
@@ -1483,7 +1499,10 @@ var OpenApiGenerator = class {
       stripSchemaPrefix: this.options.stripSchemaPrefix,
       dateTimeValidation: this.dateTimeValidation,
       patternCache: this.patternCache,
-      separateTypesFile: this.separateSchemasMode
+      separateTypesFile: this.separateSchemasMode,
+      warn: (msg) => {
+        this.warningCollector.add(msg);
+      }
     });
   }
   /**
@@ -1492,7 +1511,7 @@ var OpenApiGenerator = class {
    * @returns The generated TypeScript code as a string
    */
   generateString() {
-    var _a;
+    var _a, _b, _c;
     if (!((_a = this.spec.components) == null ? void 0 : _a.schemas)) {
       throw new SpecValidationError("No schemas found in OpenAPI spec", { filePath: this.options.input });
     }
@@ -1509,9 +1528,26 @@ var OpenApiGenerator = class {
     }
     this.generateQueryParameterSchemas();
     this.generateHeaderParameterSchemas();
-    validateFilters(this.filterStats, this.options.operationFilters);
+    validateFilters(this.filterStats, this.options.operationFilters, (msg) => {
+      this.warningCollector.add(msg);
+    });
     const orderedSchemaNames = this.topologicalSort();
-    const output = ["// Auto-generated by @cerios/openapi-to-zod", "// Do not edit this file manually", ""];
+    const output = [];
+    const customHeader = generateCustomFileHeader(this.options.fileHeader);
+    if (customHeader) {
+      output.push(customHeader.trimEnd());
+      output.push("");
+    }
+    if (this.options.includeHeader !== false) {
+      output.push(
+        generateFileHeader({
+          packageName: "@cerios/openapi-to-zod",
+          apiTitle: (_b = this.spec.info) == null ? void 0 : _b.title,
+          apiVersion: (_c = this.spec.info) == null ? void 0 : _c.version
+        }).trimEnd()
+      );
+      output.push("");
+    }
     if (this.options.showStats === true) {
       output.push(...this.generateStats());
       output.push("");
@@ -1538,6 +1574,7 @@ var OpenApiGenerator = class {
         output.push("");
       }
     }
+    this.warningCollector.flush();
     return output.join("\n");
   }
   /**
@@ -1577,6 +1614,7 @@ var OpenApiGenerator = class {
       writeFileSync(normalizedOutput, output);
       console.log(`  \u2713 Generated ${normalizedOutput}`);
     }
+    this.warningCollector.flush();
   }
   /**
    * Generate Zod schemas with explicit type annotations (for outputZodSchemas mode)
@@ -1584,7 +1622,7 @@ var OpenApiGenerator = class {
    * @returns The generated Zod schemas TypeScript code
    */
   generateSeparateSchemasString() {
-    var _a;
+    var _a, _b, _c;
     const schemas = (_a = this.spec.components) == null ? void 0 : _a.schemas;
     if (!schemas) {
       return "";
@@ -1603,9 +1641,24 @@ var OpenApiGenerator = class {
     }
     this.generateQueryParameterSchemas();
     this.generateHeaderParameterSchemas();
-    validateFilters(this.filterStats, this.options.operationFilters);
+    validateFilters(this.filterStats, this.options.operationFilters, (msg) => {
+      this.warningCollector.add(msg);
+    });
     const orderedSchemaNames = this.topologicalSort();
-    const output = ["// Auto-generated by @cerios/openapi-to-zod", "// Do not edit this file manually", ""];
+    const output = [];
+    const customHeader = generateCustomFileHeader(this.options.fileHeader);
+    if (customHeader) {
+      output.push(customHeader.trimEnd());
+      output.push("");
+    }
+    output.push(
+      generateFileHeader({
+        packageName: "@cerios/openapi-to-zod",
+        apiTitle: (_b = this.spec.info) == null ? void 0 : _b.title,
+        apiVersion: (_c = this.spec.info) == null ? void 0 : _c.version
+      }).trimEnd()
+    );
+    output.push("");
     if (this.options.showStats === true) {
       output.push(...this.generateStats());
       output.push("");
@@ -1643,8 +1696,8 @@ var OpenApiGenerator = class {
    * @returns The generated TypeScript types code
    */
   generateTypesString() {
-    var _a;
-    const tsGenerator = new TypeScriptGenerator({
+    var _a, _b, _c;
+    const internalOptions = {
       input: this.options.input,
       outputTypes: this.options.outputTypes,
       includeDescriptions: this.options.includeDescriptions,
@@ -1655,9 +1708,20 @@ var OpenApiGenerator = class {
       stripPathPrefix: this.options.stripPathPrefix,
       operationFilters: this.options.operationFilters,
       showStats: this.options.showStats,
-      enumFormat: (_a = this.options.enumFormat) != null ? _a : "const-object"
+      enumFormat: (_a = this.options.enumFormat) != null ? _a : "const-object",
+      includeHeader: false,
+      // We add our own header for consistent branding
+      showWarnings: false
+      // We handle warnings ourselves
+    };
+    const tsGenerator = new TypeScriptGenerator(internalOptions);
+    const customHeader = generateCustomFileHeader(this.options.fileHeader);
+    const header = generateFileHeader({
+      packageName: "@cerios/openapi-to-zod",
+      apiTitle: (_b = this.spec.info) == null ? void 0 : _b.title,
+      apiVersion: (_c = this.spec.info) == null ? void 0 : _c.version
     });
-    return tsGenerator.generateString();
+    return customHeader + header + tsGenerator.generateString();
   }
   /**
    * Add explicit type annotation to a schema declaration
@@ -1976,14 +2040,16 @@ ${typeCode}`;
       stripSchemaPrefix: this.options.stripSchemaPrefix,
       dateTimeValidation: this.dateTimeValidation,
       patternCache: this.patternCache,
-      separateTypesFile: this.separateSchemasMode
+      separateTypesFile: this.separateSchemasMode,
+      warn: (msg) => {
+        this.warningCollector.add(msg);
+      }
     });
     this.propertyGenerator.setCircularDependencies(this.circularDependencies);
     this.propertyGenerator.clearAllOfConflicts();
     const zodSchema = this.propertyGenerator.generatePropertySchema(schema, name, true);
     const allOfConflicts = this.propertyGenerator.getAllOfConflicts();
     if (allOfConflicts.length > 0) {
-      this.allOfConflictCount += allOfConflicts.length;
       const conflictWarning = this.generateConflictJSDoc(allOfConflicts);
       if (jsdoc) {
         jsdoc = jsdoc.replace(/ \*\/\n$/, `
@@ -2347,8 +2413,7 @@ ${propsCode}
       `//   Total schemas: ${stats.totalSchemas}`,
       `//   Circular references: ${stats.withCircularRefs}`,
       `//   Discriminated unions: ${stats.withDiscriminators}`,
-      `//   With constraints: ${stats.withConstraints}`,
-      `//   AllOf conflicts: ${this.allOfConflictCount}`
+      `//   With constraints: ${stats.withConstraints}`
     ];
     if (this.options.operationFilters && this.filterStats.totalOperations > 0) {
       output.push("//");