@fern-api/fern-api-dev 3.94.0 → 3.95.1

package/cli.cjs

@@ -577366,7 +577366,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.94.0",
+          version: "3.95.1",
           usingAccessToken: true
         }
       });
@@ -577475,7 +577475,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.94.0",
+        version: "3.95.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -598045,7 +598045,7 @@ var AsyncApiSpecSchema = external_exports.object({
   /** URL origin for the AsyncAPI spec (for remote specs). */
   origin: external_exports.string().optional(),
   /** Path to overrides file for the AsyncAPI spec. */
-  overrides: external_exports.string().optional(),
+  overrides: external_exports.union([external_exports.string(), external_exports.array(external_exports.string()).nonempty()]).optional(),
   /** Namespace for the API (used in multi-API configurations). */
   namespace: external_exports.string().optional(),
   /** AsyncAPI-specific settings. */
@@ -598169,7 +598169,7 @@ var OpenApiSpecSchema = external_exports.object({
   /** URL origin for the OpenAPI spec (for remote specs). */
   origin: external_exports.string().optional(),
   /** Path to overrides file for the OpenAPI spec. */
-  overrides: external_exports.string().optional(),
+  overrides: external_exports.union([external_exports.string(), external_exports.array(external_exports.string()).nonempty()]).optional(),
   /** Path to overlays file for the OpenAPI spec. */
   overlays: external_exports.string().optional(),
   /** Namespace for the API (used in multi-API configurations). */
@@ -598184,7 +598184,7 @@ var OpenRpcSettingsSchema = external_exports.object({
 });
 var OpenRpcSpecSchema = external_exports.object({
   openrpc: external_exports.string(),
-  overrides: external_exports.string().optional(),
+  overrides: external_exports.union([external_exports.string(), external_exports.array(external_exports.string()).nonempty()]).optional(),
   settings: OpenRpcSettingsSchema.optional()
 });
 
@@ -598195,7 +598195,7 @@ var ProtobufSettingsSchema = external_exports.object({
 var ProtobufDefinitionSchema = external_exports.object({
   root: external_exports.string(),
   target: external_exports.string().optional(),
-  overrides: external_exports.string().optional(),
+  overrides: external_exports.union([external_exports.string(), external_exports.array(external_exports.string()).nonempty()]).optional(),
   localGeneration: external_exports.boolean().optional(),
   fromOpenapi: external_exports.boolean().optional(),
   dependencies: external_exports.array(external_exports.string()).optional()
@@ -604507,9 +604507,9 @@ var ApiDefinitionConverter = class {
       result.origin = spec.origin;
     }
     if (spec.overrides != null && !isNullish(sourced.overrides)) {
-      result.overrides = await this.resolvePath({
+      result.overrides = await this.resolvePathOrPaths({
         absoluteFernYmlPath,
-        path: spec.overrides,
+        paths: spec.overrides,
         sourced: sourced.overrides
       });
     }
@@ -604533,9 +604533,9 @@ var ApiDefinitionConverter = class {
       asyncapi: await this.resolvePath({ absoluteFernYmlPath, path: spec.asyncapi, sourced: sourced.asyncapi })
     };
     if (spec.overrides != null && !isNullish(sourced.overrides)) {
-      result.overrides = await this.resolvePath({
+      result.overrides = await this.resolvePathOrPaths({
         absoluteFernYmlPath,
-        path: spec.overrides,
+        paths: spec.overrides,
         sourced: sourced.overrides
       });
     }
@@ -604556,9 +604556,9 @@ var ApiDefinitionConverter = class {
       });
     }
     if (spec.proto.overrides != null && !isNullish(sourced.proto.overrides)) {
-      proto3.overrides = await this.resolvePath({
+      proto3.overrides = await this.resolvePathOrPaths({
         absoluteFernYmlPath,
-        path: spec.proto.overrides,
+        paths: spec.proto.overrides,
         sourced: sourced.proto.overrides
       });
     }
@@ -604608,9 +604608,9 @@ var ApiDefinitionConverter = class {
       openrpc: await this.resolvePath({ absoluteFernYmlPath, path: spec.openrpc, sourced: sourced.openrpc })
     };
     if (spec.overrides != null && !isNullish(sourced.overrides)) {
-      result.overrides = await this.resolvePath({
+      result.overrides = await this.resolvePathOrPaths({
         absoluteFernYmlPath,
-        path: spec.overrides,
+        paths: spec.overrides,
         sourced: sourced.overrides
       });
     }
@@ -604619,6 +604619,29 @@ var ApiDefinitionConverter = class {
     }
     return result;
   }
+  /**
+   * Resolves one or more override paths from fern.yml to absolute paths.
+   * Handles both single string and array-of-strings inputs.
+   */
+  async resolvePathOrPaths({ absoluteFernYmlPath, paths, sourced }) {
+    if (!Array.isArray(paths)) {
+      return await this.resolvePath({
+        absoluteFernYmlPath,
+        path: paths,
+        sourced
+      });
+    }
+    const resolved = [];
+    const sourcedArray = sourced;
+    for (let i11 = 0; i11 < paths.length; i11++) {
+      const path91 = paths[i11];
+      const sourcedPath = sourcedArray[i11];
+      if (path91 != null && !isNullish(sourcedPath)) {
+        resolved.push(await this.resolvePath({ absoluteFernYmlPath, path: path91, sourced: sourcedPath }));
+      }
+    }
+    return resolved;
+  }
   /**
    * Resolves a relative path from fern.yml to an absolute path, and validates that the file exists.
    */
@@ -623676,7 +623699,7 @@ var FernWorkspace = class extends AbstractAPIWorkspace {
   async getDefinition() {
     return this.definition;
   }
-  async toFernWorkspace() {
+  async toFernWorkspace({ context: context2 }, settings, specsOverride, generatorOverrides) {
     return this;
   }
   getSources() {
@@ -631269,6 +631292,7 @@ __export(serialization_exports5, {
   OpenRpcSpecSchema: () => OpenRpcSpecSchema2,
   OutputMetadataAuthor: () => OutputMetadataAuthor2,
   OutputMetadataSchema: () => OutputMetadataSchema,
+  OverridesSchema: () => OverridesSchema,
   PathParameterOrder: () => PathParameterOrder2,
   PostmanOutputLocationSchema: () => PostmanOutputLocationSchema,
   ProtobufApiDefinitionSchema: () => ProtobufApiDefinitionSchema,
@@ -633221,6 +633245,7 @@ __export(generators_exports3, {
   OpenRpcSpecSchema: () => OpenRpcSpecSchema2,
   OutputMetadataAuthor: () => OutputMetadataAuthor2,
   OutputMetadataSchema: () => OutputMetadataSchema,
+  OverridesSchema: () => OverridesSchema,
   PathParameterOrder: () => PathParameterOrder2,
   ProtobufApiDefinitionSchema: () => ProtobufApiDefinitionSchema,
   ProtobufDefinitionSchema: () => ProtobufDefinitionSchema2,
@@ -633270,11 +633295,17 @@ var ApiDefinitionSettingsSchema = schemas_exports10.object({
   "path-parameter-order": PathParameterOrder2.optional()
 });
 
+// ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/OverridesSchema.js
+var OverridesSchema = schemas_exports10.undiscriminatedUnion([
+  schemas_exports10.string(),
+  schemas_exports10.list(schemas_exports10.string())
+]);
+
 // ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/ApiDefinitionWithOverridesSchema.js
 var ApiDefinitionWithOverridesSchema = schemas_exports10.object({
   path: ApiDefinitionPathSchema,
   origin: schemas_exports10.string().optional(),
-  overrides: schemas_exports10.string().optional(),
+  overrides: OverridesSchema.optional(),
   audiences: schemas_exports10.list(schemas_exports10.string()).optional(),
   settings: ApiDefinitionSettingsSchema.optional()
 });
@@ -633283,7 +633314,7 @@ var ApiDefinitionWithOverridesSchema = schemas_exports10.object({
 var ProtobufDefinitionSchema2 = schemas_exports10.object({
   target: schemas_exports10.string().optional(),
   root: schemas_exports10.string(),
-  overrides: schemas_exports10.string().optional(),
+  overrides: OverridesSchema.optional(),
   "local-generation": schemas_exports10.boolean().optional(),
   "from-openapi": schemas_exports10.boolean().optional(),
   dependencies: schemas_exports10.list(schemas_exports10.string()).optional()
@@ -633395,7 +633426,7 @@ var ConjureSchema = schemas_exports10.object({
 var AsyncApiSpecSchema2 = schemas_exports10.object({
   asyncapi: schemas_exports10.string(),
   origin: schemas_exports10.string().optional(),
-  overrides: schemas_exports10.string().optional(),
+  overrides: OverridesSchema.optional(),
   namespace: schemas_exports10.string().optional(),
   settings: AsyncApiSettingsSchema2.optional()
 });
@@ -633412,7 +633443,7 @@ var GraphQlSpecSchema = schemas_exports10.object({
 var OpenApiSpecSchema2 = schemas_exports10.object({
   openapi: schemas_exports10.string(),
   origin: schemas_exports10.string().optional(),
-  overrides: schemas_exports10.string().optional(),
+  overrides: OverridesSchema.optional(),
   overlays: schemas_exports10.string().optional(),
   namespace: schemas_exports10.string().optional(),
   settings: OpenApiSettingsSchema2.optional()
@@ -633421,7 +633452,7 @@ var OpenApiSpecSchema2 = schemas_exports10.object({
 // ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/OpenRpcSpecSchema.js
 var OpenRpcSpecSchema2 = schemas_exports10.object({
   openrpc: schemas_exports10.string(),
-  overrides: schemas_exports10.string().optional(),
+  overrides: OverridesSchema.optional(),
   namespace: schemas_exports10.string().optional()
 });
 
@@ -654913,9 +654944,15 @@ function convertWebhookExamples(payloadExamples) {
   return webhookExampleCalls;
 }
 function generateWebhookOperationId({ path: path91, method: method8, sdkMethodName }) {
-  const base4 = sdkMethodName?.methodName ?? sanitizePathExpression(path91);
+  if (sdkMethodName?.methodName != null) {
+    return sdkMethodName.methodName;
+  }
+  const sanitized = sanitizePathExpression(path91);
+  if (sanitized === path91.toLowerCase()) {
+    return path91;
+  }
   const hash5 = (0, import_crypto7.createHash)("sha256").update(path91).digest("hex").slice(0, 8);
-  return toCamelCase2(`${base4}_${method8.toLowerCase()}_${hash5}`);
+  return toCamelCase2(`${sanitized}_${method8.toLowerCase()}_${hash5}`);
 }
 function sanitizePathExpression(path91) {
   return path91.replace(/[{$}#]/g, "").replace(/[^a-zA-Z0-9]+/g, "_").replace(/^_+|_+$/g, "").replace(/_+/g, "_").toLowerCase().slice(0, 64);
@@ -659174,12 +659211,18 @@ async function convertGenerator({ absolutePathToGeneratorsConfiguration, generat
     publishMetadata: getPublishMetadata({ generatorInvocation: generator }),
     readme,
     settings: generator.api?.settings ?? void 0,
-    apiOverride: generator.api?.specs != null || generator.api?.auth != null || generator.api?.["auth-schemes"] != null ? {
+    apiOverride: getApiOverride({ generator })
+  };
+}
+function getApiOverride({ generator }) {
+  if (generator.api?.specs != null || generator.api?.auth != null || generator.api?.["auth-schemes"] != null) {
+    return {
       specs: generator.api?.specs,
       auth: generator.api?.auth,
       "auth-schemes": generator.api?.["auth-schemes"]
-    } : void 0
-  };
+    };
+  }
+  return void 0;
 }
 function getPublishMetadata({ generatorInvocation }) {
   const publishMetadata = generatorInvocation["publish-metadata"];
@@ -680164,7 +680207,7 @@ var ConjureWorkspace = class extends AbstractAPIWorkspace {
     super(superArgs);
     this.absolutePathToConjureFolder = join4(superArgs.absoluteFilePath, relativePathToConjureDirectory);
   }
-  async toFernWorkspace({ context: context2 }, settings) {
+  async toFernWorkspace({ context: context2 }, settings, specsOverride, generatorOverrides) {
     const definition3 = await this.getDefinition({ context: context2 }, settings);
     return new FernWorkspace({
       absoluteFilePath: this.absoluteFilePath,
@@ -696251,9 +696294,10 @@ var LazyFernWorkspace = class extends AbstractAPIWorkspace {
     this.loadAPIWorkspace = loadAPIWorkspace2;
   }
   async getDefinition({ context: context2 }, settings) {
-    return (await this.toFernWorkspace({ context: context2 }, settings)).definition;
+    const defaultedContext = context2 || this.context;
+    return (await this.toFernWorkspace({ context: defaultedContext }, settings)).definition;
   }
-  async toFernWorkspace({ context: context2, skipValidation }, settings) {
+  async toFernWorkspace({ context: context2, skipValidation }, settings, specsOverride, generatorOverrides) {
     const key2 = (0, import_object_hash.default)(settings ?? {});
     let workspace = this.fernWorkspaces[key2];
     if (workspace == null) {
@@ -696363,14 +696407,23 @@ async function mergeWithOverrides2({ absoluteFilePathToOverrides, data: data2, c
 async function loadAsyncAPI({ context: context2, absoluteFilePath, absoluteFilePathToOverrides }) {
   const contents = (await (0, import_promises35.readFile)(absoluteFilePath)).toString();
   const parsed = await jsYaml.load(contents);
+  let overridesFilepaths = [];
   if (absoluteFilePathToOverrides != null) {
-    return await mergeWithOverrides2({
-      absoluteFilePathToOverrides,
+    if (Array.isArray(absoluteFilePathToOverrides)) {
+      overridesFilepaths = absoluteFilePathToOverrides;
+    } else {
+      overridesFilepaths = [absoluteFilePathToOverrides];
+    }
+  }
+  let result = parsed;
+  for (const overridesFilepath of overridesFilepaths) {
+    result = await mergeWithOverrides2({
+      absoluteFilePathToOverrides: overridesFilepath,
       context: context2,
-      data: parsed
+      data: result
     });
   }
-  return parsed;
+  return result;
 }
 
 // ../workspace/lazy-fern-workspace/lib/utils/loadOpenAPI.js
@@ -696536,25 +696589,36 @@ async function loadOpenAPI({ context: context2, absolutePathToOpenAPI, absoluteP
   const parsed = await parseOpenAPI({
     absolutePathToOpenAPI
   });
-  let overridesFilepath = void 0;
+  let overridesFilepaths = [];
   if (absolutePathToOpenAPIOverrides != null) {
-    overridesFilepath = absolutePathToOpenAPIOverrides;
+    if (Array.isArray(absolutePathToOpenAPIOverrides)) {
+      overridesFilepaths = absolutePathToOpenAPIOverrides;
+    } else {
+      overridesFilepaths = [absolutePathToOpenAPIOverrides];
+    }
   } else if (typeof parsed === "object" && // biome-ignore lint/suspicious/noExplicitAny: allow explicit any
   parsed[FernOpenAPIExtension.OPENAPI_OVERIDES_FILEPATH] != null) {
-    overridesFilepath = join4(
-      dirname4(absolutePathToOpenAPI),
-      // biome-ignore lint/suspicious/noExplicitAny: allow explicit any
-      RelativeFilePath2.of(parsed[FernOpenAPIExtension.OPENAPI_OVERIDES_FILEPATH])
-    );
+    overridesFilepaths = [
+      join4(
+        dirname4(absolutePathToOpenAPI),
+        // biome-ignore lint/suspicious/noExplicitAny: allow explicit any
+        RelativeFilePath2.of(parsed[FernOpenAPIExtension.OPENAPI_OVERIDES_FILEPATH])
+      )
+    ];
   }
   let result = parsed;
-  if (overridesFilepath != null) {
+  for (const overridesFilepath of overridesFilepaths) {
     result = await mergeWithOverrides2({
       absoluteFilePathToOverrides: overridesFilepath,
       context: context2,
       data: result,
       allowNullKeys: OPENAPI_EXAMPLES_KEYS
     });
+    result = await parseOpenAPI({
+      absolutePathToOpenAPI,
+      absolutePathToOpenAPIOverrides: overridesFilepath,
+      parsed: result
+    });
   }
   if (absolutePathToOpenAPIOverlays != null) {
     result = await applyOverlays({
@@ -696601,11 +696665,12 @@ async function loadOpenAPI({ context: context2, absolutePathToOpenAPI, absoluteP
     } catch (error49) {
     }
   }
-  if (overridesFilepath != null || absolutePathToOpenAPIOverlays != null || result !== parsed) {
+  const needsFinalResolution = result !== parsed && overridesFilepaths.length === 0 || absolutePathToOpenAPIOverlays != null;
+  if (needsFinalResolution) {
     return await parseOpenAPI({
       absolutePathToOpenAPI,
-      absolutePathToOpenAPIOverrides: overridesFilepath,
       absolutePathToOpenAPIOverlays,
+      // Include overlay path for ref resolver
       parsed: result
     });
   }
@@ -706270,7 +706335,7 @@ var OpenAPIConverter = class extends AbstractSpecConverter {
     }
   }
   convertWebhooks() {
-    for (const [, webhookItem] of Object.entries(this.context.spec.webhooks ?? {})) {
+    for (const [webhookName, webhookItem] of Object.entries(this.context.spec.webhooks ?? {})) {
       if (webhookItem == null) {
         this.context.errorCollector.collect({
           message: "Skipping empty webhook",
@@ -706278,25 +706343,19 @@ var OpenAPIConverter = class extends AbstractSpecConverter {
         });
         continue;
       }
-      if (!("post" in webhookItem)) {
+      if (!("post" in webhookItem) || webhookItem.post == null) {
         this.context.errorCollector.collect({
           message: "Skipping webhook as it is not a POST method",
           path: this.breadcrumbs
         });
         continue;
       }
-      if (webhookItem.post?.operationId == null) {
-        this.context.errorCollector.collect({
-          message: "Skipping webhook as no operationId is present",
-          path: this.breadcrumbs
-        });
-        continue;
-      }
-      const operationId = webhookItem.post.operationId;
+      const operationId = webhookItem.post.operationId ?? webhookName;
+      const operation = webhookItem.post.operationId != null ? webhookItem.post : { ...webhookItem.post, operationId };
       const webHookConverter = new WebhookConverter({
         context: this.context,
         breadcrumbs: ["webhooks", operationId],
-        operation: webhookItem.post,
+        operation,
         method: import_openapi_types2.OpenAPIV3.HttpMethods.POST,
         path: operationId
       });
@@ -707041,14 +707100,23 @@ async function loadOpenRpc({ context: context2, absoluteFilePath, absoluteFilePa
   } catch (e6) {
     parsed = jsYaml.load(contents);
   }
+  let overridesFilepaths = [];
   if (absoluteFilePathToOverrides != null) {
-    return await mergeWithOverrides2({
-      absoluteFilePathToOverrides,
+    if (Array.isArray(absoluteFilePathToOverrides)) {
+      overridesFilepaths = absoluteFilePathToOverrides;
+    } else {
+      overridesFilepaths = [absoluteFilePathToOverrides];
+    }
+  }
+  let result = parsed;
+  for (const overridesFilepath of overridesFilepaths) {
+    result = await mergeWithOverrides2({
+      absoluteFilePathToOverrides: overridesFilepath,
       context: context2,
-      data: parsed
+      data: result
     });
   }
-  return parsed;
+  return result;
 }
 
 // ../workspace/lazy-fern-workspace/lib/protobuf/ProtobufIRGenerator.js
@@ -707912,7 +707980,18 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
     for (const spec of specsOverride) {
       if (generators_yml_exports.isOpenApiSpecSchema(spec)) {
         const absoluteFilepath = join4(this.absoluteFilePath, RelativeFilePath2.of(spec.openapi));
-        const absoluteFilepathToOverrides = spec.overrides ? join4(this.absoluteFilePath, RelativeFilePath2.of(spec.overrides)) : void 0;
+        let absoluteFilepathToOverrides;
+        const specOverridePaths = [];
+        if (spec.overrides != null) {
+          if (Array.isArray(spec.overrides)) {
+            specOverridePaths.push(...spec.overrides.map((override) => join4(this.absoluteFilePath, RelativeFilePath2.of(override))));
+          } else {
+            specOverridePaths.push(join4(this.absoluteFilePath, RelativeFilePath2.of(spec.overrides)));
+          }
+        }
+        if (specOverridePaths.length > 0) {
+          absoluteFilepathToOverrides = specOverridePaths.length === 1 ? specOverridePaths[0] : specOverridePaths;
+        }
         const absoluteFilepathToOverlays = spec.overlays ? join4(this.absoluteFilePath, RelativeFilePath2.of(spec.overlays)) : void 0;
         const openApiSpec = {
           type: "openapi",
@@ -707937,10 +708016,11 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
   getAbsoluteFilePaths() {
     return [
       this.absoluteFilePath,
-      ...this.allSpecs.flatMap((spec) => [
-        spec.type === "protobuf" ? spec.absoluteFilepathToProtobufTarget : spec.absoluteFilepath,
-        spec.absoluteFilepathToOverrides
-      ]).filter(isNonNullish2)
+      ...this.allSpecs.flatMap((spec) => {
+        const mainPath = spec.type === "protobuf" ? spec.absoluteFilepathToProtobufTarget : spec.absoluteFilepath;
+        const overridePaths = Array.isArray(spec.absoluteFilepathToOverrides) ? spec.absoluteFilepathToOverrides : spec.absoluteFilepathToOverrides != null ? [spec.absoluteFilepathToOverrides] : [];
+        return [mainPath, ...overridePaths];
+      }).filter(isNonNullish2)
     ];
   }
   getSources() {
@@ -708957,7 +709037,7 @@ function adjustSpecPaths(specs, apiName) {
       return {
         ...spec,
         openapi: adjustPath(spec.openapi, apiName),
-        overrides: spec.overrides != null ? adjustPath(spec.overrides, apiName) : void 0,
+        overrides: spec.overrides != null ? adjustPathOrPaths(spec.overrides, apiName) : void 0,
         overlays: spec.overlays != null ? adjustPath(spec.overlays, apiName) : void 0
       };
     }
@@ -708965,7 +709045,7 @@ function adjustSpecPaths(specs, apiName) {
       return {
         ...spec,
         asyncapi: adjustPath(spec.asyncapi, apiName),
-        overrides: spec.overrides != null ? adjustPath(spec.overrides, apiName) : void 0
+        overrides: spec.overrides != null ? adjustPathOrPaths(spec.overrides, apiName) : void 0
       };
     }
     if ("fern" in spec) {
@@ -708984,7 +709064,7 @@ function adjustSpecPaths(specs, apiName) {
       return {
         ...spec,
         openrpc: adjustPath(spec.openrpc, apiName),
-        overrides: spec.overrides != null ? adjustPath(spec.overrides, apiName) : void 0
+        overrides: spec.overrides != null ? adjustPathOrPaths(spec.overrides, apiName) : void 0
       };
     }
     if ("proto" in spec) {
@@ -708993,7 +709073,7 @@ function adjustSpecPaths(specs, apiName) {
         proto: {
           ...spec.proto,
           root: adjustPath(spec.proto.root, apiName),
-          overrides: spec.proto.overrides != null ? adjustPath(spec.proto.overrides, apiName) : void 0
+          overrides: spec.proto.overrides != null ? adjustPathOrPaths(spec.proto.overrides, apiName) : void 0
         }
       };
     }
@@ -709009,6 +709089,12 @@ function adjustPath(path91, apiName) {
   }
   return `./${FERN_DIRECTORY}/${APIS_DIRECTORY}/${apiName}/${path91}`;
 }
+function adjustPathOrPaths(paths, apiName) {
+  if (Array.isArray(paths)) {
+    return paths.map((p9) => adjustPath(p9, apiName));
+  }
+  return adjustPath(paths, apiName);
+}
 function convertApiSpecs(apiConfig) {
   const warnings = [];
   if (apiConfig == null) {
@@ -750814,6 +750900,7 @@ async function performAIEnhancement(apiDefinition, config3, context2, token, org
       try {
         let specContent = await (0, import_promises56.readFile)(sourceSpec.absoluteFilePath, "utf-8");
         if (sourceSpec.absoluteFilePathToOverrides != null) {
+          const overridesPaths = Array.isArray(sourceSpec.absoluteFilePathToOverrides) ? sourceSpec.absoluteFilePathToOverrides : [sourceSpec.absoluteFilePathToOverrides];
           try {
             let parsedSpec;
             try {
@@ -750821,15 +750908,17 @@ async function performAIEnhancement(apiDefinition, config3, context2, token, org
             } catch {
               parsedSpec = load(specContent, { json: true });
             }
-            const overridesContent = await (0, import_promises56.readFile)(sourceSpec.absoluteFilePathToOverrides, "utf-8");
-            let parsedOverrides;
-            try {
-              parsedOverrides = JSON.parse(overridesContent);
-            } catch {
-              parsedOverrides = load(overridesContent, { json: true });
+            for (const overridesPath of overridesPaths) {
+              const overridesContent = await (0, import_promises56.readFile)(overridesPath, "utf-8");
+              let parsedOverrides;
+              try {
+                parsedOverrides = JSON.parse(overridesContent);
+              } catch {
+                parsedOverrides = load(overridesContent, { json: true });
+              }
+              parsedSpec = mergeWithOverrides({ data: parsedSpec, overrides: parsedOverrides });
             }
-            const merged = mergeWithOverrides({ data: parsedSpec, overrides: parsedOverrides });
-            specContent = dump(merged);
+            specContent = dump(parsedSpec);
             context2.logger.debug("Applied overrides to OpenAPI spec for AI enhancement");
           } catch (error49) {
             context2.logger.debug(`Failed to apply overrides to spec: ${error49}. Using raw spec.`);
@@ -763255,7 +763344,7 @@ var import_path40 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.94.0";
+  const version7 = "3.95.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -1086157,7 +1086246,14 @@ async function loadAPIChangelog({ absolutePathToWorkspace }) {
 async function loadSingleNamespaceAPIWorkspace({ absolutePathToWorkspace, namespace, definitions: definitions7 }) {
   const specs = [];
   for (const definition3 of definitions7) {
-    const absoluteFilepathToOverrides = definition3.overrides != null ? join4(absolutePathToWorkspace, RelativeFilePath2.of(definition3.overrides)) : void 0;
+    let absoluteFilepathToOverrides;
+    if (definition3.overrides != null) {
+      if (Array.isArray(definition3.overrides)) {
+        absoluteFilepathToOverrides = definition3.overrides.map((override) => join4(absolutePathToWorkspace, RelativeFilePath2.of(override)));
+      } else {
+        absoluteFilepathToOverrides = join4(absolutePathToWorkspace, RelativeFilePath2.of(definition3.overrides));
+      }
+    }
     const absoluteFilepathToOverlays = definition3.overlays != null ? join4(absolutePathToWorkspace, RelativeFilePath2.of(definition3.overlays)) : void 0;
     if (definition3.schema.type === "protobuf") {
       const relativeFilepathToProtobufRoot = RelativeFilePath2.of(definition3.schema.root);
@@ -1086245,15 +1086341,23 @@ async function loadSingleNamespaceAPIWorkspace({ absolutePathToWorkspace, namesp
         }
       };
     }
-    if (definition3.overrides != null && absoluteFilepathToOverrides != null && !await doesPathExist(absoluteFilepathToOverrides)) {
-      return {
-        didSucceed: false,
-        failures: {
-          [RelativeFilePath2.of(definition3.overrides)]: {
-            type: WorkspaceLoaderFailureType.FILE_MISSING
-          }
+    if (definition3.overrides != null && absoluteFilepathToOverrides != null) {
+      const overridePaths = Array.isArray(absoluteFilepathToOverrides) ? absoluteFilepathToOverrides : [absoluteFilepathToOverrides];
+      const overrideRelativePaths = Array.isArray(definition3.overrides) ? definition3.overrides : [definition3.overrides];
+      for (let i11 = 0; i11 < overridePaths.length; i11++) {
+        const overridePath = overridePaths[i11];
+        const relativeOverridePath = overrideRelativePaths[i11];
+        if (overridePath != null && relativeOverridePath != null && !await doesPathExist(overridePath)) {
+          return {
+            didSucceed: false,
+            failures: {
+              [RelativeFilePath2.of(relativeOverridePath)]: {
+                type: WorkspaceLoaderFailureType.FILE_MISSING
+              }
+            }
+          };
         }
-      };
+      }
     }
     if (definition3.overlays != null && absoluteFilepathToOverlays != null && !await doesPathExist(absoluteFilepathToOverlays)) {
       return {
@@ -1126942,7 +1127046,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.94.0";
+    return "3.95.1";
   }
   getCliName() {
     if (false) {
@@ -1147561,6 +1147665,41 @@ async function readExistingOverrides(overridesFilepath, context2) {
   }
   return parsedOverrides;
 }
+function generateOverridesContent({
+  ir: ir14,
+  existingOverrides,
+  includeModels,
+  context: context2
+}) {
+  const hasExisting = existingOverrides != null && typeof existingOverrides === "object";
+  const paths = hasExisting && "paths" in existingOverrides ? existingOverrides.paths : {};
+  for (const endpoint3 of ir14.endpoints) {
+    const endpointLocation = getEndpointLocation(endpoint3);
+    if (!(endpoint3.path in paths)) {
+      paths[endpoint3.path] = {};
+    }
+    const pathItem = paths[endpoint3.path];
+    if (pathItem != null && pathItem[endpoint3.method] == null && pathItem[endpoint3.method.toLowerCase()] == null) {
+      const groupName = endpointLocation.file.split("/").map((part) => part.replace(".yml", "")).filter((part) => part !== "__package__");
+      const sdkMethodNameExtensions = {};
+      if (groupName.length > 0) {
+        sdkMethodNameExtensions["x-fern-sdk-group-name"] = groupName;
+      }
+      sdkMethodNameExtensions["x-fern-sdk-method-name"] = endpointLocation.endpointId;
+      pathItem[endpoint3.method.toLowerCase()] = sdkMethodNameExtensions;
+    } else if (!hasExisting) {
+      context2.logger.warn(`Endpoint ${endpoint3.path} ${endpoint3.method} is defined multiple times`);
+    }
+  }
+  const schemas = hasExisting && "components" in existingOverrides && existingOverrides.components?.schemas != null ? existingOverrides.components.schemas : {};
+  if (includeModels) {
+    writeModels(schemas, ir14.groupedSchemas.rootSchemas);
+    for (const [_15, namespacedSchemas] of Object.entries(ir14.groupedSchemas.namespacedSchemas)) {
+      writeModels(schemas, namespacedSchemas);
+    }
+  }
+  return { paths, components: { schemas } };
+}
 async function writeDefinitionForOpenAPIWorkspace({
   workspace,
   includeModels,
@@ -1147573,51 +1147712,30 @@ async function writeDefinitionForOpenAPIWorkspace({
       context: context2,
       documents: await loader2.loadDocuments({ context: context2, specs: [spec] })
     });
-    let existingOverrides = {};
-    if (spec.absoluteFilepathToOverrides !== void 0) {
-      existingOverrides = await readExistingOverrides(spec.absoluteFilepathToOverrides, context2);
-    }
-    const paths = "path" in existingOverrides ? existingOverrides.path : {};
-    for (const endpoint3 of ir14.endpoints) {
-      const endpointLocation = getEndpointLocation(endpoint3);
-      if (!(endpoint3.path in paths)) {
-        paths[endpoint3.path] = {};
-      }
-      const pathItem = paths[endpoint3.path];
-      if (pathItem != null && pathItem[endpoint3.method] == null) {
-        const groupName = endpointLocation.file.split("/").map((part) => part.replace(".yml", "")).filter((part) => part !== "__package__");
-        const sdkMethodNameExtensions = {};
-        if (groupName.length > 0) {
-          sdkMethodNameExtensions["x-fern-sdk-group-name"] = groupName;
-        }
-        sdkMethodNameExtensions["x-fern-sdk-method-name"] = endpointLocation.endpointId;
-        pathItem[endpoint3.method.toLowerCase()] = sdkMethodNameExtensions;
-      } else if (existingOverrides == null) {
-        context2.logger.warn(`Endpoint ${endpoint3.path} ${endpoint3.method} is defined multiple times`);
-      }
-    }
-    const schemas = "path" in existingOverrides ? existingOverrides.path : {};
-    if (includeModels) {
-      writeModels(schemas, ir14.groupedSchemas.rootSchemas);
-      for (const [_15, namespacedSchemas] of Object.entries(ir14.groupedSchemas.namespacedSchemas)) {
-        writeModels(schemas, namespacedSchemas);
-      }
-    }
-    const components = { schemas };
-    const specFilename = getFilename(spec.absoluteFilepath);
-    let overridesFilename = "openapi-overrides.yml";
-    if (specFilename != null) {
-      const lastDotIndex = specFilename.lastIndexOf(".");
-      if (lastDotIndex > 0) {
-        const nameWithoutExt = specFilename.substring(0, lastDotIndex);
-        const extension3 = specFilename.substring(lastDotIndex);
-        overridesFilename = `${nameWithoutExt}-overrides${extension3}`;
-      }
-    }
-    await (0, import_promises132.writeFile)(
-      join4(dirname4(spec.absoluteFilepath), RelativeFilePath2.of(overridesFilename)),
-      jsYaml.dump({ paths, components })
-    );
+    const overridesPaths = Array.isArray(spec.absoluteFilepathToOverrides) ? spec.absoluteFilepathToOverrides : spec.absoluteFilepathToOverrides != null ? [spec.absoluteFilepathToOverrides] : [];
+    if (overridesPaths.length > 0) {
+      for (const overridesPath of overridesPaths) {
+        const existingOverrides = await readExistingOverrides(overridesPath, context2);
+        const content5 = generateOverridesContent({ ir: ir14, existingOverrides, includeModels, context: context2 });
+        await (0, import_promises132.writeFile)(overridesPath, jsYaml.dump(content5));
+      }
+    } else {
+      const content5 = generateOverridesContent({ ir: ir14, existingOverrides: {}, includeModels, context: context2 });
+      const specFilename = getFilename(spec.absoluteFilepath);
+      let overridesFilename = "openapi-overrides.yml";
+      if (specFilename != null) {
+        const lastDotIndex = specFilename.lastIndexOf(".");
+        if (lastDotIndex > 0) {
+          const nameWithoutExt = specFilename.substring(0, lastDotIndex);
+          const extension3 = specFilename.substring(lastDotIndex);
+          overridesFilename = `${nameWithoutExt}-overrides${extension3}`;
+        }
+      }
+      await (0, import_promises132.writeFile)(
+        join4(dirname4(spec.absoluteFilepath), RelativeFilePath2.of(overridesFilename)),
+        jsYaml.dump(content5)
+      );
+    }
   }
 }
 function writeModels(existingSchemas, schemas) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.94.0",
+  "version": "3.95.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",