@cerios/openapi-to-zod 0.4.0 → 0.5.1

package/dist/cli.js

@@ -6222,6 +6222,141 @@ _PropertyGenerator.INCLUSION_RULES = {
 };
 var PropertyGenerator = _PropertyGenerator;
 
+// src/utils/operation-filters.ts
+init_cjs_shims();
+var import_minimatch = require("minimatch");
+function createFilterStatistics() {
+  return {
+    totalOperations: 0,
+    includedOperations: 0,
+    filteredByTags: 0,
+    filteredByPaths: 0,
+    filteredByMethods: 0,
+    filteredByOperationIds: 0,
+    filteredByDeprecated: 0
+  };
+}
+function matchesAnyPattern(value, patterns) {
+  if (!patterns || patterns.length === 0) {
+    return false;
+  }
+  if (!value) {
+    return false;
+  }
+  return patterns.some((pattern) => (0, import_minimatch.minimatch)(value, pattern));
+}
+function containsAny(arr, values) {
+  if (!values || values.length === 0) {
+    return false;
+  }
+  if (!arr || arr.length === 0) {
+    return false;
+  }
+  return values.some((value) => arr.includes(value));
+}
+function shouldIncludeOperation(operation, path, method, filters, stats) {
+  if (!filters) {
+    return true;
+  }
+  const methodLower = method.toLowerCase();
+  const operationId = operation == null ? void 0 : operation.operationId;
+  const tags = (operation == null ? void 0 : operation.tags) || [];
+  const deprecated = (operation == null ? void 0 : operation.deprecated) === true;
+  if (filters.includeTags && filters.includeTags.length > 0) {
+    if (!containsAny(tags, filters.includeTags)) {
+      if (stats) stats.filteredByTags++;
+      return false;
+    }
+  }
+  if (filters.includePaths && filters.includePaths.length > 0) {
+    if (!matchesAnyPattern(path, filters.includePaths)) {
+      if (stats) stats.filteredByPaths++;
+      return false;
+    }
+  }
+  if (filters.includeMethods && filters.includeMethods.length > 0) {
+    const methodsLower = filters.includeMethods.map((m) => m.toLowerCase());
+    if (!methodsLower.includes(methodLower)) {
+      if (stats) stats.filteredByMethods++;
+      return false;
+    }
+  }
+  if (filters.includeOperationIds && filters.includeOperationIds.length > 0) {
+    if (!matchesAnyPattern(operationId, filters.includeOperationIds)) {
+      if (stats) stats.filteredByOperationIds++;
+      return false;
+    }
+  }
+  if (filters.excludeDeprecated === true && deprecated) {
+    if (stats) stats.filteredByDeprecated++;
+    return false;
+  }
+  if (filters.excludeTags && filters.excludeTags.length > 0) {
+    if (containsAny(tags, filters.excludeTags)) {
+      if (stats) stats.filteredByTags++;
+      return false;
+    }
+  }
+  if (filters.excludePaths && filters.excludePaths.length > 0) {
+    if (matchesAnyPattern(path, filters.excludePaths)) {
+      if (stats) stats.filteredByPaths++;
+      return false;
+    }
+  }
+  if (filters.excludeMethods && filters.excludeMethods.length > 0) {
+    const methodsLower = filters.excludeMethods.map((m) => m.toLowerCase());
+    if (methodsLower.includes(methodLower)) {
+      if (stats) stats.filteredByMethods++;
+      return false;
+    }
+  }
+  if (filters.excludeOperationIds && filters.excludeOperationIds.length > 0) {
+    if (matchesAnyPattern(operationId, filters.excludeOperationIds)) {
+      if (stats) stats.filteredByOperationIds++;
+      return false;
+    }
+  }
+  return true;
+}
+function validateFilters(stats, filters) {
+  if (!filters || stats.totalOperations === 0) {
+    return;
+  }
+  if (stats.includedOperations === 0) {
+    console.warn(
+      `\u26A0\uFE0F  Warning: All ${stats.totalOperations} operations were filtered out. Check your operationFilters configuration.`
+    );
+    const filterBreakdown = [];
+    if (stats.filteredByTags > 0) filterBreakdown.push(`${stats.filteredByTags} by tags`);
+    if (stats.filteredByPaths > 0) filterBreakdown.push(`${stats.filteredByPaths} by paths`);
+    if (stats.filteredByMethods > 0) filterBreakdown.push(`${stats.filteredByMethods} by methods`);
+    if (stats.filteredByOperationIds > 0) filterBreakdown.push(`${stats.filteredByOperationIds} by operationIds`);
+    if (stats.filteredByDeprecated > 0) filterBreakdown.push(`${stats.filteredByDeprecated} by deprecated flag`);
+    if (filterBreakdown.length > 0) {
+      console.warn(`   Filtered: ${filterBreakdown.join(", ")}`);
+    }
+  }
+}
+function formatFilterStatistics(stats) {
+  if (stats.totalOperations === 0) {
+    return "";
+  }
+  const lines = [];
+  lines.push("Operation Filtering:");
+  lines.push(`  Total operations: ${stats.totalOperations}`);
+  lines.push(`  Included operations: ${stats.includedOperations}`);
+  const filteredCount = stats.filteredByTags + stats.filteredByPaths + stats.filteredByMethods + stats.filteredByOperationIds + stats.filteredByDeprecated;
+  if (filteredCount > 0) {
+    lines.push(`  Filtered operations: ${filteredCount}`);
+    if (stats.filteredByTags > 0) lines.push(`    - By tags: ${stats.filteredByTags}`);
+    if (stats.filteredByPaths > 0) lines.push(`    - By paths: ${stats.filteredByPaths}`);
+    if (stats.filteredByMethods > 0) lines.push(`    - By methods: ${stats.filteredByMethods}`);
+    if (stats.filteredByOperationIds > 0) lines.push(`    - By operationIds: ${stats.filteredByOperationIds}`);
+    if (stats.filteredByDeprecated > 0) lines.push(`    - By deprecated: ${stats.filteredByDeprecated}`);
+  }
+  return lines.join("\n");
+}
+
 // src/openapi-generator.ts
 var OpenApiGenerator = class {
   constructor(options) {
@@ -6233,6 +6368,7 @@ var OpenApiGenerator = class {
     this.schemaUsageMap = /* @__PURE__ */ new Map();
     this.schemaTypeModeMap = /* @__PURE__ */ new Map();
     this.needsZodImport = false;
+    this.filterStats = createFilterStatistics();
     var _a, _b, _c;
     if (!options.input) {
       throw new ConfigurationError("Input path is required", { providedOptions: options });
@@ -6250,7 +6386,8 @@ var OpenApiGenerator = class {
       showStats: (_c = options.showStats) != null ? _c : true,
       nativeEnumType: options.nativeEnumType || "union",
       request: options.request,
-      response: options.response
+      response: options.response,
+      operationFilters: options.operationFilters
     };
     try {
       const fs = require("fs");
@@ -6355,6 +6492,8 @@ var OpenApiGenerator = class {
       this.generateComponentSchema(name, schema);
     }
     this.generateQueryParameterSchemas();
+    this.generateHeaderParameterSchemas();
+    validateFilters(this.filterStats, this.options.operationFilters);
     const orderedSchemaNames = this.topologicalSort();
     const output = ["// Auto-generated by @cerios/openapi-to-zod", "// Do not edit this file manually", ""];
     if (this.options.showStats === true) {
@@ -6448,9 +6587,16 @@ var OpenApiGenerator = class {
     const requestSchemas = /* @__PURE__ */ new Set();
     const responseSchemas = /* @__PURE__ */ new Set();
     if (this.spec.paths) {
-      for (const [, pathItem] of Object.entries(this.spec.paths)) {
-        for (const [, operation] of Object.entries(pathItem)) {
+      for (const [path, pathItem] of Object.entries(this.spec.paths)) {
+        const methods = ["get", "post", "put", "patch", "delete", "head", "options"];
+        for (const method of methods) {
+          const operation = pathItem[method];
           if (typeof operation !== "object" || !operation) continue;
+          this.filterStats.totalOperations++;
+          if (!shouldIncludeOperation(operation, path, method, this.options.operationFilters, this.filterStats)) {
+            continue;
+          }
+          this.filterStats.includedOperations++;
           if ("requestBody" in operation && operation.requestBody && typeof operation.requestBody === "object" && "content" in operation.requestBody && operation.requestBody.content) {
             for (const mediaType of Object.values(operation.requestBody.content)) {
               if (mediaType && typeof mediaType === "object" && "schema" in mediaType && mediaType.schema) {
@@ -6800,12 +6946,15 @@ ${typeCode}`;
     if (!this.spec.paths) {
       return;
     }
-    for (const [_path, pathItem] of Object.entries(this.spec.paths)) {
+    for (const [path, pathItem] of Object.entries(this.spec.paths)) {
       if (!pathItem || typeof pathItem !== "object") continue;
       const methods = ["get", "post", "put", "patch", "delete", "head", "options"];
       for (const method of methods) {
         const operation = pathItem[method];
         if (!operation) continue;
+        if (!shouldIncludeOperation(operation, path, method, this.options.operationFilters)) {
+          continue;
+        }
         if (!operation.operationId || !operation.parameters || !Array.isArray(operation.parameters)) {
           continue;
         }
@@ -6866,6 +7015,80 @@ ${propsCode}
         const jsdoc = `/**
  * Query parameters for ${operation.operationId}
  */
+`;
+        const fullSchemaCode = `${jsdoc}export const ${camelCaseSchemaName} = ${schemaCode};`;
+        this.schemas.set(schemaName, fullSchemaCode);
+        this.needsZodImport = true;
+      }
+    }
+  }
+  /**
+   * Generate header parameter schemas for each operation
+   * Header parameters are always string type (HTTP header semantics)
+   */
+  generateHeaderParameterSchemas() {
+    var _a;
+    if (!this.spec.paths) {
+      return;
+    }
+    for (const [path, pathItem] of Object.entries(this.spec.paths)) {
+      if (!pathItem || typeof pathItem !== "object") continue;
+      const methods = ["get", "post", "put", "patch", "delete", "head", "options"];
+      for (const method of methods) {
+        const operation = pathItem[method];
+        if (!operation) continue;
+        if (!shouldIncludeOperation(operation, path, method, this.options.operationFilters)) {
+          continue;
+        }
+        if (!operation.operationId || !operation.parameters || !Array.isArray(operation.parameters)) {
+          continue;
+        }
+        const headerParams = operation.parameters.filter(
+          (param) => param && typeof param === "object" && param.in === "header"
+        );
+        if (headerParams.length === 0) {
+          continue;
+        }
+        const pascalOperationId = operation.operationId.includes("-") ? toPascalCase(operation.operationId) : operation.operationId.charAt(0).toUpperCase() + operation.operationId.slice(1);
+        const schemaName = `${pascalOperationId}HeaderParams`;
+        if (!this.schemaDependencies.has(schemaName)) {
+          this.schemaDependencies.set(schemaName, /* @__PURE__ */ new Set());
+        }
+        const properties = {};
+        for (const param of headerParams) {
+          const paramName = param.name;
+          const paramSchema = param.schema;
+          if (!paramSchema) continue;
+          let zodType = "z.string()";
+          if (param.description && this.requestOptions.includeDescriptions) {
+            if (this.requestOptions.useDescribe) {
+              zodType = `${zodType}.describe(${JSON.stringify(param.description)})`;
+            }
+          }
+          zodType = `${zodType}.optional()`;
+          properties[paramName] = zodType;
+          if (paramSchema.$ref) {
+            const refName = resolveRef(paramSchema.$ref);
+            (_a = this.schemaDependencies.get(schemaName)) == null ? void 0 : _a.add(refName);
+          }
+        }
+        const objectMode = this.requestOptions.mode;
+        const zodMethod = objectMode === "strict" ? "strictObject" : objectMode === "loose" ? "looseObject" : "object";
+        const propsCode = Object.entries(properties).map(([key, value]) => {
+          const needsQuotes = !/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key);
+          const quotedKey = needsQuotes ? `"${key}"` : key;
+          return `  ${quotedKey}: ${value}`;
+        }).join(",\n");
+        const schemaCode = `z.${zodMethod}({
+${propsCode}
+})`;
+        const operationName = pascalOperationId;
+        const prefixedName = this.options.prefix ? `${toPascalCase(this.options.prefix)}${operationName}` : operationName;
+        const suffixedName = this.options.suffix ? `${prefixedName}${toPascalCase(this.options.suffix)}` : prefixedName;
+        const camelCaseSchemaName = `${suffixedName.charAt(0).toLowerCase() + suffixedName.slice(1)}HeaderParamsSchema`;
+        const jsdoc = `/**
+ * Header parameters for ${operation.operationId}
+ */
 `;
         const fullSchemaCode = `${jsdoc}export const ${camelCaseSchemaName} = ${schemaCode};`;
         this.schemas.set(schemaName, fullSchemaCode);
@@ -7143,15 +7366,23 @@ ${props.join("\n")}
         stats.withConstraints++;
       }
     }
-    return [
+    const output = [
       "// Generation Statistics:",
       `//   Total schemas: ${stats.totalSchemas}`,
       `//   Enums: ${stats.enums}`,
       `//   Circular references: ${stats.withCircularRefs}`,
       `//   Discriminated unions: ${stats.withDiscriminators}`,
-      `//   With constraints: ${stats.withConstraints}`,
-      `//   Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`
+      `//   With constraints: ${stats.withConstraints}`
     ];
+    if (this.options.operationFilters && this.filterStats.totalOperations > 0) {
+      output.push("//");
+      const filterStatsStr = formatFilterStatistics(this.filterStats);
+      for (const line of filterStatsStr.split("\n")) {
+        output.push(`//   ${line}`);
+      }
+    }
+    output.push(`//   Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
+    return output;
   }
 };
 
@@ -7270,6 +7501,17 @@ var RequestResponseOptionsSchema = import_zod.z.strictObject({
   typeMode: TypeModeSchema.optional(),
   nativeEnumType: NativeEnumTypeSchema.optional()
 });
+var OperationFiltersSchema = import_zod.z.strictObject({
+  includeTags: import_zod.z.array(import_zod.z.string()).optional(),
+  excludeTags: import_zod.z.array(import_zod.z.string()).optional(),
+  includePaths: import_zod.z.array(import_zod.z.string()).optional(),
+  excludePaths: import_zod.z.array(import_zod.z.string()).optional(),
+  includeMethods: import_zod.z.array(import_zod.z.string()).optional(),
+  excludeMethods: import_zod.z.array(import_zod.z.string()).optional(),
+  includeOperationIds: import_zod.z.array(import_zod.z.string()).optional(),
+  excludeOperationIds: import_zod.z.array(import_zod.z.string()).optional(),
+  excludeDeprecated: import_zod.z.boolean().optional()
+});
 var OpenApiGeneratorOptionsSchema = import_zod.z.strictObject({
   mode: import_zod.z.enum(["strict", "normal", "loose"]).optional(),
   input: import_zod.z.string(),
@@ -7284,7 +7526,8 @@ var OpenApiGeneratorOptionsSchema = import_zod.z.strictObject({
   nativeEnumType: NativeEnumTypeSchema.optional(),
   request: RequestResponseOptionsSchema.optional(),
   response: RequestResponseOptionsSchema.optional(),
-  name: import_zod.z.string().optional()
+  name: import_zod.z.string().optional(),
+  operationFilters: OperationFiltersSchema.optional()
 });
 var ConfigFileSchema = import_zod.z.strictObject({
   defaults: import_zod.z.strictObject({
@@ -7298,7 +7541,8 @@ var ConfigFileSchema = import_zod.z.strictObject({
     showStats: import_zod.z.boolean().optional(),
     nativeEnumType: NativeEnumTypeSchema.optional(),
     request: RequestResponseOptionsSchema.optional(),
-    response: RequestResponseOptionsSchema.optional()
+    response: RequestResponseOptionsSchema.optional(),
+    operationFilters: OperationFiltersSchema.optional()
   }).optional(),
   specs: import_zod.z.array(OpenApiGeneratorOptionsSchema).min(1, "At least one spec is required"),
   executionMode: import_zod.z.enum(["parallel", "sequential"]).optional()
@@ -7660,6 +7904,20 @@ export default defineConfig({
   console.log("\nNext steps:");
   console.log("  1. Review and customize your config file if needed");
   console.log("  2. Run 'openapi-to-zod' to generate schemas\n");
-  console.log("Things just got Cerios...\n");
+  const ceriosMessages = [
+    "Things just got Cerios!",
+    "Getting Cerios about schemas!",
+    "Cerios business ahead!",
+    "Don't take it too Cerios-ly!",
+    "Time to get Cerios!",
+    "We're dead Cerios about types!",
+    "This is Cerios-ly awesome!",
+    "Cerios-ly, you're all set!",
+    "You are Cerios right now!",
+    "Cerios vibes only!"
+  ];
+  const randomMessage = ceriosMessages[Math.floor(Math.random() * ceriosMessages.length)];
+  console.log(`${randomMessage}
+`);
 }
 //# sourceMappingURL=cli.js.map