next-openapi-gen 1.2.3 → 1.4.0

package/dist/cli.js

@@ -588,121 +588,6 @@ import fse2 from "fs-extra";
 import path16 from "path";
 import fs12 from "fs";
 
-// ../openapi-core/dist/config/normalize.js
-function normalizeRouterType(routerType) {
-  return routerType ?? DEFAULT_ROUTER_TYPE;
-}
-function normalizeSchemaTypes(schemaType) {
-  const schemaBackends = Array.isArray(schemaType) ? schemaType : [schemaType ?? DEFAULT_RUNTIME_SCHEMA_TYPE];
-  return [...new Set(schemaBackends)];
-}
-function normalizeOpenApiVersion(template) {
-  if (template.openapi.startsWith("3.2")) {
-    return "3.2";
-  }
-  if (template.openapi.startsWith("3.1")) {
-    return "3.1";
-  }
-  if (template.openapi.startsWith("4.")) {
-    return "4.0";
-  }
-  return DEFAULT_OPENAPI_VERSION;
-}
-function normalizeFrameworkKind(kind) {
-  switch (kind) {
-    case FrameworkKind.Nextjs:
-    case "next":
-      return FrameworkKind.Nextjs;
-    case FrameworkKind.Tanstack:
-    case "tanstack":
-      return FrameworkKind.Tanstack;
-    case FrameworkKind.ReactRouter:
-    case "react-router":
-      return FrameworkKind.ReactRouter;
-    default:
-      return FrameworkKind.Nextjs;
-  }
-}
-function normalizeFramework(config2, routerType) {
-  if (config2.framework) {
-    const frameworkKind = normalizeFrameworkKind(config2.framework.kind);
-    switch (frameworkKind) {
-      case FrameworkKind.Nextjs:
-        return {
-          ...config2.framework,
-          kind: frameworkKind,
-          router: config2.framework.router || routerType,
-          modulePath: config2.framework.modulePath || config2.framework.adapterPath || config2.next?.adapterPath,
-          adapterPath: config2.framework.adapterPath || config2.next?.adapterPath
-        };
-      case FrameworkKind.Tanstack:
-      case FrameworkKind.ReactRouter:
-        return {
-          ...config2.framework,
-          kind: frameworkKind,
-          modulePath: config2.framework.modulePath || config2.framework.adapterPath
-        };
-    }
-  }
-  return {
-    kind: FrameworkKind.Nextjs,
-    router: routerType,
-    modulePath: config2.next?.adapterPath,
-    adapterPath: config2.next?.adapterPath
-  };
-}
-function normalizeOpenApiConfig(template) {
-  const routerType = normalizeRouterType(template.routerType);
-  const schemaBackends = normalizeSchemaTypes(template.schemaType);
-  const openapiVersion = normalizeOpenApiVersion({
-    openapi: "openapi" in template ? template.openapi || "3.0.0" : "3.0.0"
-  });
-  return {
-    apiDir: template.apiDir ?? DEFAULT_API_DIR,
-    routerType,
-    schemaDir: template.schemaDir ?? DEFAULT_SCHEMA_DIR,
-    docsUrl: template.docsUrl ?? DEFAULT_DOCS_URL,
-    ui: template.ui ?? DEFAULT_UI,
-    outputFile: template.outputFile ?? DEFAULT_GENERATED_OPENAPI_FILENAME,
-    outputDir: template.outputDir ?? DEFAULT_OUTPUT_DIR,
-    includeOpenApiRoutes: template.includeOpenApiRoutes ?? DEFAULT_INCLUDE_OPENAPI_ROUTES,
-    ignoreRoutes: template.ignoreRoutes ?? [],
-    schemaType: template.schemaType ?? DEFAULT_RUNTIME_SCHEMA_TYPE,
-    schemaBackends,
-    schemaFiles: template.schemaFiles ?? [],
-    defaultResponseSet: template.defaultResponseSet,
-    responseSets: template.responseSets,
-    errorConfig: template.errorConfig,
-    errorDefinitions: template.errorDefinitions,
-    openapiVersion,
-    framework: normalizeFramework(template, routerType),
-    next: {
-      adapterPath: template.next?.adapterPath
-    },
-    diagnostics: template.diagnostics ?? { enabled: DEFAULT_DIAGNOSTICS_ENABLED },
-    debug: template.debug ?? DEFAULT_DEBUG
-  };
-}
-
-// ../openapi-core/dist/diagnostics/collector.js
-var DiagnosticsCollector = class {
-  diagnostics = [];
-  add(diagnostic) {
-    this.diagnostics.push(diagnostic);
-  }
-  getAll() {
-    return [...this.diagnostics];
-  }
-  hasAny() {
-    return this.diagnostics.length > 0;
-  }
-};
-
-// ../openapi-core/dist/openapi/document.js
-function createDocumentFromTemplate(template) {
-  return structuredClone(template);
-}
-
 // ../openapi-core/dist/shared/utils.js
 import { parse } from "@babel/parser";
 import * as t from "@babel/types";
@@ -1038,7 +923,7 @@ function parseJSDocBlock(commentValue, filePath) {
   result.cookieType = extractTypeFromComment(normalizedComment, "@cookie");
   const authValue = extractLineValue(normalizedComment, "@auth");
   if (authValue) {
-    result.auth = performAuthPresetReplacements(authValue);
+    result.auth = authValue;
   }
   const querystring = parseQuerystringTag(normalizedComment);
   if (querystring) {
@@ -1406,6 +1291,17 @@ function mergeJSDocData(target, source) {
 function cleanComment(commentValue) {
   return commentValue.replace(/\*\s*/g, "").trim();
 }
+function extractInternalFlagFromComments(comments) {
+  if (!comments)
+    return false;
+  for (const comment of comments) {
+    const cleaned = cleanComment(comment.value);
+    if (/@internal\b/.test(cleaned) || /@schema\s+false\b/.test(cleaned)) {
+      return true;
+    }
+  }
+  return false;
+}
 function extractSchemaIdFromComments(comments) {
   if (!comments)
     return null;
@@ -1702,16 +1598,18 @@ var INTERNAL_OPENAPI_CONFIG_KEYS = [
   "framework",
   "next",
   "diagnostics",
-  "debug"
+  "debug",
+  "authPresets",
+  "excludeSchemas"
 ];
-var AUTH_PRESET_REPLACEMENTS = {
+var DEFAULT_AUTH_PRESET_REPLACEMENTS = {
   bearer: "BearerAuth",
   basic: "BasicAuth",
   apikey: "ApiKeyAuth"
 };
-function performAuthPresetReplacements(authValue) {
+function performAuthPresetReplacements(authValue, presets = DEFAULT_AUTH_PRESET_REPLACEMENTS) {
   const authParts = authValue.split(",").map((part) => part.trim());
-  const mappedParts = authParts.map((part) => AUTH_PRESET_REPLACEMENTS[part.toLowerCase()] || part);
+  const mappedParts = authParts.map((part) => presets[part.toLowerCase()] || part);
   return mappedParts.join(",");
 }
 function getOperationId(routePath, method) {
@@ -1729,6 +1627,123 @@ function parseTypeScriptFile(content, options) {
   });
 }
 
+// ../openapi-core/dist/config/normalize.js
+function normalizeRouterType(routerType) {
+  return routerType ?? DEFAULT_ROUTER_TYPE;
+}
+function normalizeSchemaTypes(schemaType) {
+  const schemaBackends = Array.isArray(schemaType) ? schemaType : [schemaType ?? DEFAULT_RUNTIME_SCHEMA_TYPE];
+  return [...new Set(schemaBackends)];
+}
+function normalizeOpenApiVersion(template) {
+  if (template.openapi.startsWith("3.2")) {
+    return "3.2";
+  }
+  if (template.openapi.startsWith("3.1")) {
+    return "3.1";
+  }
+  if (template.openapi.startsWith("4.")) {
+    return "4.0";
+  }
+  return DEFAULT_OPENAPI_VERSION;
+}
+function normalizeFrameworkKind(kind) {
+  switch (kind) {
+    case FrameworkKind.Nextjs:
+    case "next":
+      return FrameworkKind.Nextjs;
+    case FrameworkKind.Tanstack:
+    case "tanstack":
+      return FrameworkKind.Tanstack;
+    case FrameworkKind.ReactRouter:
+    case "react-router":
+      return FrameworkKind.ReactRouter;
+    default:
+      return FrameworkKind.Nextjs;
+  }
+}
+function normalizeFramework(config2, routerType) {
+  if (config2.framework) {
+    const frameworkKind = normalizeFrameworkKind(config2.framework.kind);
+    switch (frameworkKind) {
+      case FrameworkKind.Nextjs:
+        return {
+          ...config2.framework,
+          kind: frameworkKind,
+          router: config2.framework.router || routerType,
+          modulePath: config2.framework.modulePath || config2.framework.adapterPath || config2.next?.adapterPath,
+          adapterPath: config2.framework.adapterPath || config2.next?.adapterPath
+        };
+      case FrameworkKind.Tanstack:
+      case FrameworkKind.ReactRouter:
+        return {
+          ...config2.framework,
+          kind: frameworkKind,
+          modulePath: config2.framework.modulePath || config2.framework.adapterPath
+        };
+    }
+  }
+  return {
+    kind: FrameworkKind.Nextjs,
+    router: routerType,
+    modulePath: config2.next?.adapterPath,
+    adapterPath: config2.next?.adapterPath
+  };
+}
+function normalizeOpenApiConfig(template) {
+  const routerType = normalizeRouterType(template.routerType);
+  const schemaBackends = normalizeSchemaTypes(template.schemaType);
+  const openapiVersion = normalizeOpenApiVersion({
+    openapi: "openapi" in template ? template.openapi || "3.0.0" : "3.0.0"
+  });
+  return {
+    apiDir: template.apiDir ?? DEFAULT_API_DIR,
+    routerType,
+    schemaDir: template.schemaDir ?? DEFAULT_SCHEMA_DIR,
+    docsUrl: template.docsUrl ?? DEFAULT_DOCS_URL,
+    ui: template.ui ?? DEFAULT_UI,
+    outputFile: template.outputFile ?? DEFAULT_GENERATED_OPENAPI_FILENAME,
+    outputDir: template.outputDir ?? DEFAULT_OUTPUT_DIR,
+    includeOpenApiRoutes: template.includeOpenApiRoutes ?? DEFAULT_INCLUDE_OPENAPI_ROUTES,
+    ignoreRoutes: template.ignoreRoutes ?? [],
+    excludeSchemas: template.excludeSchemas ?? [],
+    schemaType: template.schemaType ?? DEFAULT_RUNTIME_SCHEMA_TYPE,
+    schemaBackends,
+    schemaFiles: template.schemaFiles ?? [],
+    defaultResponseSet: template.defaultResponseSet,
+    responseSets: template.responseSets,
+    errorConfig: template.errorConfig,
+    errorDefinitions: template.errorDefinitions,
+    openapiVersion,
+    framework: normalizeFramework(template, routerType),
+    next: {
+      adapterPath: template.next?.adapterPath
+    },
+    diagnostics: template.diagnostics ?? { enabled: DEFAULT_DIAGNOSTICS_ENABLED },
+    authPresets: { ...DEFAULT_AUTH_PRESET_REPLACEMENTS, ...template.authPresets },
+    debug: template.debug ?? DEFAULT_DEBUG
+  };
+}
+
+// ../openapi-core/dist/diagnostics/collector.js
+var DiagnosticsCollector = class {
+  diagnostics = [];
+  add(diagnostic) {
+    this.diagnostics.push(diagnostic);
+  }
+  getAll() {
+    return [...this.diagnostics];
+  }
+  hasAny() {
+    return this.diagnostics.length > 0;
+  }
+};
+
+// ../openapi-core/dist/openapi/document.js
+function createDocumentFromTemplate(template) {
+  return structuredClone(template);
+}
+
 // ../openapi-core/dist/openapi/version-processor.js
 var DefaultOpenApiVersionProcessor = class {
   id;
@@ -2187,8 +2202,10 @@ function downgradeSchemaForOpenApi30(schema, mediaTypeName) {
     const nullableBranch = nextSchema.anyOf.find((item) => item.type === "null");
     const baseBranch = nextSchema.anyOf.find((item) => item.type !== "null");
     if (nullableBranch && baseBranch) {
+      const { anyOf: _anyOf, ...outerMeta } = nextSchema;
       nextSchema = {
         ...structuredClone(baseBranch),
+        ...outerMeta,
         nullable: true
       };
     }
@@ -4103,7 +4120,7 @@ function processZodLiteral(node, context) {
     return { type: "string", enum: [arg.value] };
   }
   if (t8.isNumericLiteral(arg)) {
-    return { type: "number", enum: [arg.value] };
+    return { type: Number.isInteger(arg.value) ? "integer" : "number", enum: [arg.value] };
   }
   if (t8.isBooleanLiteral(arg)) {
     return { type: "boolean", enum: [arg.value] };
@@ -4119,7 +4136,7 @@ function processZodLiteral(node, context) {
     if (typeof value === "string")
       return { type: "string", enum: [value] };
     if (typeof value === "number")
-      return { type: "number", enum: [value] };
+      return { type: Number.isInteger(value) ? "integer" : "number", enum: [value] };
     if (typeof value === "boolean")
       return { type: "boolean", enum: [value] };
     if (value === null)
@@ -4214,7 +4231,7 @@ function processZodTuple(node, processNode, context) {
     if (t8.isIdentifier(node.arguments[0]) && context?.resolveConstArrayValues) {
       const values = context.resolveConstArrayValues(node.arguments[0].name);
       if (values && values.length > 0) {
-        const prefixItems = values.map((value) => typeof value === "number" ? { type: "number", enum: [value] } : { type: "string", enum: [value] });
+        const prefixItems = values.map((value) => typeof value === "number" ? { type: Number.isInteger(value) ? "integer" : "number", enum: [value] } : { type: "string", enum: [value] });
         return {
           type: "array",
           prefixItems,
@@ -4258,7 +4275,7 @@ function processZodUnion(node, processNode, context) {
     if (t8.isIdentifier(node.arguments[0]) && context?.resolveConstArrayValues) {
       const values = context.resolveConstArrayValues(node.arguments[0].name);
       if (values && values.length > 0) {
-        const type = typeof values[0] === "number" ? "number" : "string";
+        const type = typeof values[0] === "number" ? Number.isInteger(values[0]) ? "integer" : "number" : "string";
         return { type, enum: values };
       }
     }
@@ -11705,8 +11722,17 @@ var ZodRuntimeExporter = class {
         return node.arguments[0] ? literal(this.buildLiteralValue(node.arguments[0])) : null;
       case "enum":
         return this.buildEnum(node);
-      case "array":
-        return node.arguments[0] && isProcessableNode(node.arguments[0]) ? array(this.buildSchema(node.arguments[0]) ?? unknown()) : array(unknown());
+      case "array": {
+        const arg = node.arguments[0];
+        if (!arg || !isProcessableNode(arg)) {
+          return array(unknown());
+        }
+        const itemSchema = this.buildSchema(arg);
+        if (!itemSchema) {
+          return null;
+        }
+        return array(itemSchema);
+      }
       case "strictObject": {
         const base = this.buildObject(node);
         return base && typeof base.strict === "function" ? base.strict() : base;
@@ -11838,13 +11864,17 @@ var ZodRuntimeExporter = class {
     if (node.arguments.length === 0 || !t9.isArrayExpression(node.arguments[0])) {
       return tuple([]);
     }
-    const items = node.arguments[0].elements.flatMap((element) => {
+    const items = [];
+    for (const element of node.arguments[0].elements) {
       if (!isProcessableNode(element)) {
-        return [];
+        return null;
       }
       const schema = this.buildSchema(element);
-      return schema ? [schema] : [];
-    });
+      if (!schema) {
+        return null;
+      }
+      items.push(schema);
+    }
     return tuple(items);
   }
   buildTemplateLiteral(node) {
@@ -12145,6 +12175,8 @@ var ZodSchemaConverter = class {
   /** Schema variable names whose component name was overridden via .meta({ id }). These must
    *  NOT be copied back under the original variable name in the OpenAPI components object. */
   metaIdSchemaNames = /* @__PURE__ */ new Set();
+  /** Schema variable names marked @internal — excluded from components/schemas output. */
+  internalSchemaNames = /* @__PURE__ */ new Set();
   // Current processing context (set during file processing)
   currentFilePath;
   currentAST;
@@ -12454,7 +12486,12 @@ var ZodSchemaConverter = class {
             if (this.isZodSchema(path25.node.init)) {
               const schema = this.processZodNode(path25.node.init);
               if (schema) {
-                this.storeResolvedSchema(schemaName, schema);
+                const overrideId = this.extractMetaIdFromNode(path25.node.init);
+                if (overrideId) {
+                  this.applyMetaIdOverride(schemaName, schema, overrideId, filePath);
+                } else {
+                  this.storeResolvedSchema(schemaName, schema);
+                }
               }
               return;
             }
@@ -12797,8 +12834,15 @@ var ZodSchemaConverter = class {
         };
         switch (methodName) {
           case "optional":
+            break;
           case "nullable":
           case "nullish":
+            schema = {
+              anyOf: [
+                { $ref: `#/components/schemas/${this.getSchemaReferenceName(schemaName)}` },
+                { type: "null" }
+              ]
+            };
             break;
           case "describe":
             if (node.arguments.length > 0 && t10.isStringLiteral(node.arguments[0])) {
@@ -13316,12 +13360,16 @@ var ZodSchemaConverter = class {
       case "optional":
         break;
       case "nullable":
-        if (!schema.allOf) {
+        if (schema.allOf) {
+          schema = { anyOf: [...schema.allOf, { type: "null" }] };
+        } else {
           schema.nullable = true;
         }
         break;
       case "nullish":
-        if (!schema.allOf) {
+        if (schema.allOf) {
+          schema = { anyOf: [...schema.allOf, { type: "null" }] };
+        } else {
           schema.nullable = true;
         }
         break;
@@ -13766,7 +13814,13 @@ var ZodSchemaConverter = class {
    * Get all processed Zod schemas
    */
   getProcessedSchemas() {
-    return this.zodSchemas;
+    const result = {};
+    for (const [name, schema] of Object.entries(this.zodSchemas)) {
+      if (!this.internalSchemaNames.has(name)) {
+        result[name] = schema;
+      }
+    }
+    return result;
   }
   /**
    * Pre-scan all files to build type mappings
@@ -13818,9 +13872,21 @@ var ZodSchemaConverter = class {
               if (t10.isIdentifier(declaration.id) && declaration.init) {
                 const schemaName = declaration.id.name;
                 if (this.isZodSchema(declaration.init)) {
+                  const decl = path25.node.declaration;
+                  const allComments = [
+                    ...path25.node.leadingComments ?? [],
+                    ...decl?.leadingComments ?? [],
+                    ...declaration.leadingComments ?? []
+                  ];
+                  if (extractInternalFlagFromComments(allComments)) {
+                    this.internalSchemaNames.add(schemaName);
+                  }
                   if (!this.getStoredSchema(schemaName)) {
                     logger.debug(`Pre-processing Zod schema: ${schemaName}`);
                     this.processingSchemas.add(schemaName);
+                    this.currentFilePath = filePath;
+                    this.currentAST = ast;
+                    this.currentImports = importedModules;
                     const schema = this.processZodNode(declaration.init);
                     this.processingSchemas.delete(schemaName);
                     if (schema) {
@@ -13843,9 +13909,19 @@ var ZodSchemaConverter = class {
             if (t10.isIdentifier(declaration.id) && declaration.init) {
               const schemaName = declaration.id.name;
               if (this.isZodSchema(declaration.init)) {
+                const allComments = [
+                  ...path25.node.leadingComments ?? [],
+                  ...declaration.leadingComments ?? []
+                ];
+                if (extractInternalFlagFromComments(allComments)) {
+                  this.internalSchemaNames.add(schemaName);
+                }
                 if (!this.getStoredSchema(schemaName) && !this.processingSchemas.has(schemaName)) {
                   logger.debug(`Pre-processing Zod schema: ${schemaName}`);
                   this.processingSchemas.add(schemaName);
+                  this.currentFilePath = filePath;
+                  this.currentAST = ast;
+                  this.currentImports = importedModules;
                   const schema = this.processZodNode(declaration.init);
                   this.processingSchemas.delete(schemaName);
                   if (schema) {
@@ -14577,7 +14653,7 @@ function collectFirstMemberLeadingComments(interfaceDecl) {
   const firstMember = body.body?.[0];
   return firstMember?.leadingComments ?? [];
 }
-function collectAllExportedDefinitions(ast, typeDefinitions, currentFile, schemaIdAliases) {
+function collectAllExportedDefinitions(ast, typeDefinitions, currentFile, schemaIdAliases, internalSchemaNames) {
   function registerDefinition(name, entry, allComments) {
     if (!typeDefinitions[name]) {
       typeDefinitions[name] = entry;
@@ -14589,6 +14665,9 @@ function collectAllExportedDefinitions(ast, typeDefinitions, currentFile, schema
         typeDefinitions[overrideId] = entry;
       }
     }
+    if (internalSchemaNames && extractInternalFlagFromComments(allComments)) {
+      internalSchemaNames.add(name);
+    }
   }
   resolvedTraverse(ast, {
     TSTypeAliasDeclaration: (path25) => {
@@ -15068,6 +15147,7 @@ var SchemaProcessor = class {
   schemaTypes;
   isResolvingPickOmitBase = false;
   schemaIdAliases = {};
+  internalSchemaNames = /* @__PURE__ */ new Set();
   fileAccess;
   symbolResolver;
   // Track imports per file for resolving ReturnType<typeof func>
@@ -15108,7 +15188,7 @@ var SchemaProcessor = class {
   getDefinedSchemas() {
     const filteredSchemas = {};
     Object.entries(this.openapiDefinitions).forEach(([key, value]) => {
-      if (!this.schemaIdAliases[key] && !this.isGenericTypeParameter(key) && !this.isInvalidSchemaName(key) && !this.isBuiltInUtilityType(key) && !this.isFunctionSchema(key)) {
+      if (!this.schemaIdAliases[key] && !this.isGenericTypeParameter(key) && !this.isInvalidSchemaName(key) && !this.isBuiltInUtilityType(key) && !this.isFunctionSchema(key) && !this.internalSchemaNames.has(key)) {
         filteredSchemas[key] = value;
       }
     });
@@ -15118,6 +15198,22 @@ var SchemaProcessor = class {
       this.customSchemaProcessor.getDefinedSchemas()
     ]);
   }
+  getInternalSchemas() {
+    const result = {};
+    for (const name of this.internalSchemaNames) {
+      const def = this.openapiDefinitions[name];
+      if (def)
+        result[name] = def;
+    }
+    if (this.zodSchemaConverter) {
+      for (const name of this.zodSchemaConverter.internalSchemaNames) {
+        const schema = this.zodSchemaConverter.zodSchemas[name];
+        if (schema)
+          result[name] = schema;
+      }
+    }
+    return result;
+  }
   findSchemaDefinition(schemaName, contentType) {
     this.contentType = contentType;
     if (schemaName.includes("<") && schemaName.includes(">")) {
@@ -15268,7 +15364,7 @@ var SchemaProcessor = class {
    * Used when processing imported files to ensure all referenced types are available
    */
   collectAllExportedDefinitions(ast, filePath) {
-    collectAllExportedDefinitions(ast, this.typeDefinitions, filePath || this.currentFilePath, this.schemaIdAliases);
+    collectAllExportedDefinitions(ast, this.typeDefinitions, filePath || this.currentFilePath, this.schemaIdAliases, this.internalSchemaNames);
   }
   collectTypeDefinitions(ast, schemaName, filePath) {
     collectTypeDefinitions(ast, schemaName, this.typeDefinitions, filePath || this.currentFilePath);
@@ -16696,11 +16792,16 @@ var ResponseProcessor = class {
 var OperationProcessor = class {
   schemaProcessor;
   responseProcessor;
+  authPresets;
   performanceProfile;
-  constructor(schemaProcessor, responseProcessor, performanceProfile) {
+  constructor(schemaProcessor, responseProcessor, options = {}) {
     this.schemaProcessor = schemaProcessor;
     this.responseProcessor = responseProcessor;
-    this.performanceProfile = performanceProfile;
+    this.authPresets = {
+      ...DEFAULT_AUTH_PRESET_REPLACEMENTS,
+      ...options.authPresets
+    };
+    this.performanceProfile = options.performanceProfile;
   }
   processOperation(varName, routePath, dataTypes, pathParamNames = []) {
     const method = varName.toLowerCase();
@@ -16725,9 +16826,10 @@ var OperationProcessor = class {
       definition.deprecated = true;
     }
     if (explicitSecurity && explicitSecurity.length > 0) {
-      definition.security = explicitSecurity;
+      definition.security = explicitSecurity.map((req) => Object.fromEntries(Object.entries(req).map(([scheme, scopes]) => [this.applyPreset(scheme), scopes])));
     } else if (auth) {
-      const authItems = auth.split(",").map((item) => item.trim());
+      const mapped = performAuthPresetReplacements(auth, this.authPresets);
+      const authItems = mapped.split(",").map((item) => item.trim());
       definition.security = authItems.map((authItem) => ({
         [authItem]: []
       }));
@@ -16940,6 +17042,9 @@ ${suffix}`;
       response.links[link.name] = linkObject;
     }
   }
+  applyPreset(scheme) {
+    return this.authPresets[scheme.toLowerCase()] ?? scheme;
+  }
   createQuerystringParameter(dataTypes) {
     if (!dataTypes.querystringType) {
       return void 0;
@@ -17028,7 +17133,10 @@ var RouteProcessor = class {
       return new RegExp(`^${regexPattern}$`);
     });
     this.responseProcessor = new ResponseProcessor(this.config, this.schemaProcessor);
-    this.operationProcessor = new OperationProcessor(this.schemaProcessor, this.responseProcessor, this.performanceProfile);
+    this.operationProcessor = new OperationProcessor(this.schemaProcessor, this.responseProcessor, {
+      authPresets: this.config.authPresets,
+      performanceProfile: this.performanceProfile
+    });
   }
   processResponsesFromConfig(dataTypes, method) {
     return this.responseProcessor.processResponses(dataTypes, method);
@@ -17254,6 +17362,64 @@ function generateErrorResponsesFromConfig(document, errorConfig) {
   });
 }
 
+// ../openapi-core/dist/core/exclude-schemas.js
+function patternToRegExp(pattern) {
+  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`^${escaped.replace(/\*/g, ".*")}$`);
+}
+function matchExcludePatterns(names, patterns) {
+  if (patterns.length === 0)
+    return [];
+  const regexes = patterns.map(patternToRegExp);
+  return names.filter((name) => regexes.some((re) => re.test(name)));
+}
+function applyExcludeSchemas(document, mergedSchemas, excludedSchemas) {
+  const excludedNames = new Set(Object.keys(excludedSchemas));
+  if (excludedNames.size === 0)
+    return;
+  walkAndInline(document, excludedSchemas, excludedNames, /* @__PURE__ */ new Set());
+  for (const name of excludedNames) {
+    delete mergedSchemas[name];
+  }
+}
+function walkAndInline(obj, excluded, excludedNames, visiting) {
+  if (!obj || typeof obj !== "object")
+    return;
+  if (Array.isArray(obj)) {
+    for (const item of obj) {
+      walkAndInline(item, excluded, excludedNames, visiting);
+    }
+    return;
+  }
+  const rec = obj;
+  const ref = rec["$ref"];
+  if (typeof ref === "string") {
+    const match = ref.match(/^#\/components\/schemas\/(.+)$/);
+    const name = match?.[1];
+    if (name && excludedNames.has(name)) {
+      if (visiting.has(name)) {
+        logger.warn(`Circular reference to internal schema "${name}", keeping $ref`);
+        return;
+      }
+      const schemaDef = excluded[name];
+      if (schemaDef) {
+        const cloned = JSON.parse(JSON.stringify(schemaDef));
+        delete rec["$ref"];
+        Object.assign(rec, cloned);
+        const newVisiting = new Set(visiting);
+        newVisiting.add(name);
+        for (const key of Object.keys(rec)) {
+          walkAndInline(rec[key], excluded, excludedNames, newVisiting);
+        }
+        return;
+      }
+    }
+  }
+  for (const key of Object.keys(rec)) {
+    walkAndInline(rec[key], excluded, excludedNames, visiting);
+  }
+}
+
 // ../openapi-core/dist/core/orchestrator.js
 function runGenerationOrchestrator({ config: config2, template, hooks, runtime, createFrameworkSource }) {
   const diagnostics = new DiagnosticsCollector();
@@ -17324,11 +17490,21 @@ function runGenerationOrchestrator({ config: config2, template, hooks, runtime,
   }
   profile.defaultComponentsAndErrorsMs = performance.now() - phaseStartedAt;
   phaseStartedAt = performance.now();
-  const definedSchemas = routeProcessor.getSchemaProcessor().getDefinedSchemas();
+  const schemaProcessor = routeProcessor.getSchemaProcessor();
+  const definedSchemas = schemaProcessor.getDefinedSchemas();
   const mergedSchemas = {
     ...document.components.schemas,
     ...definedSchemas
   };
+  const internalSchemas = schemaProcessor.getInternalSchemas();
+  const patternExcludedNames = matchExcludePatterns(Object.keys(mergedSchemas), config2.excludeSchemas ?? []);
+  const allExcludedSchemas = {
+    ...internalSchemas,
+    ...Object.fromEntries(patternExcludedNames.map((name) => [name, mergedSchemas[name]]))
+  };
+  if (Object.keys(allExcludedSchemas).length > 0) {
+    applyExcludeSchemas(document, mergedSchemas, allExcludedSchemas);
+  }
   if (Object.keys(mergedSchemas).length > 0) {
     document.components.schemas = Object.fromEntries(Object.entries(mergedSchemas).sort(([a], [b]) => a.localeCompare(b, "en", { sensitivity: "base" })));
   }