@cerios/openapi-to-zod 1.5.1 → 1.6.1

package/dist/cli.mjs

@@ -5140,9 +5140,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")',
@@ -5163,8 +5165,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) {
@@ -5242,6 +5245,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: [] };
@@ -5250,7 +5254,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);
@@ -6222,7 +6226,8 @@ var init_property_generator = __esm({
             {
               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
           );
@@ -6245,7 +6250,8 @@ var init_property_generator = __esm({
             {
               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,
@@ -6268,7 +6274,8 @@ var init_property_generator = __esm({
             {
               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,
@@ -6420,6 +6427,8 @@ import {
   expandTransitiveReferences,
   extractSchemaRefs,
   formatFilterStatistics,
+  generateCustomFileHeader,
+  generateFileHeader,
   getOperationName,
   LRUCache as LRUCache2,
   loadOpenAPISpec,
@@ -6432,7 +6441,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";
@@ -6460,8 +6470,6 @@ var init_openapi_generator = __esm({
         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;
@@ -6469,6 +6477,11 @@ var init_openapi_generator = __esm({
           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,
@@ -6487,13 +6500,16 @@ var init_openapi_generator = __esm({
           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);
@@ -6518,7 +6534,10 @@ var init_openapi_generator = __esm({
           stripSchemaPrefix: this.options.stripSchemaPrefix,
           dateTimeValidation: this.dateTimeValidation,
           patternCache: this.patternCache,
-          separateTypesFile: this.separateSchemasMode
+          separateTypesFile: this.separateSchemasMode,
+          warn: (msg) => {
+            this.warningCollector.add(msg);
+          }
         });
       }
       /**
@@ -6527,7 +6546,7 @@ var init_openapi_generator = __esm({
        * @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 });
         }
@@ -6544,9 +6563,26 @@ var init_openapi_generator = __esm({
         }
         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("");
@@ -6573,6 +6609,7 @@ var init_openapi_generator = __esm({
             output.push("");
           }
         }
+        this.warningCollector.flush();
         return output.join("\n");
       }
       /**
@@ -6612,6 +6649,7 @@ var init_openapi_generator = __esm({
           writeFileSync(normalizedOutput, output);
           console.log(`  \u2713 Generated ${normalizedOutput}`);
         }
+        this.warningCollector.flush();
       }
       /**
        * Generate Zod schemas with explicit type annotations (for outputZodSchemas mode)
@@ -6619,7 +6657,7 @@ var init_openapi_generator = __esm({
        * @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 "";
@@ -6638,9 +6676,24 @@ var init_openapi_generator = __esm({
         }
         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("");
@@ -6678,8 +6731,8 @@ var init_openapi_generator = __esm({
        * @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,
@@ -6690,9 +6743,20 @@ var init_openapi_generator = __esm({
           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
@@ -7011,14 +7075,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$/, `
@@ -7382,8 +7448,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("//");
@@ -7556,6 +7621,7 @@ function mergeConfigWithDefaults(config) {
       showStats: defaults.showStats,
       customDateTimeFormatRegex: defaults.customDateTimeFormatRegex,
       enumFormat: defaults.enumFormat,
+      fileHeader: defaults.fileHeader,
       // Override with spec-specific values
       ...specWithoutDeprecatedOutput,
       outputTypes: resolvedOutputTypes