@fern-api/fern-api-dev 5.89.6 → 5.90.0

package/cli.cjs

@@ -32839,19 +32839,57 @@ var init_mediaType = __esm({
 
 // ../../commons/core-utils/lib/mergeWithOverrides.js
 function mergeWithOverrides({ data: data2, overrides, allowNullKeys }) {
-  const merged = mergeWith_default(data2, mergeWith_default, overrides, (obj, src) => Array.isArray(obj) && Array.isArray(src) ? src.every((element4) => typeof element4 === "object") && obj.every((element4) => typeof element4 === "object") ? (
-    // nested arrays of objects are merged
-    void 0
-  ) : (
-    // nested arrays of primitives are replaced
-    [...src]
-  ) : void 0);
+  const merged = mergeWith_default(data2, mergeWith_default, overrides, overridesCustomizer);
   const filtered = omitDeepBy(merged, isNull_default, {
     ancestorKeys: allowNullKeys ?? [],
     allowOmissionCursor: false
   });
   return filtered;
 }
+function overridesCustomizer(obj, src) {
+  if (!Array.isArray(obj) || !Array.isArray(src)) {
+    return void 0;
+  }
+  if (!src.every((element4) => typeof element4 === "object") || !obj.every((element4) => typeof element4 === "object")) {
+    return [...src];
+  }
+  return mergeParametersByIdentity(obj, src) ?? void 0;
+}
+function isParameterEntry(value2) {
+  if (!isPlainObject_default(value2)) {
+    return false;
+  }
+  const { name: name2, in: location2 } = value2;
+  return typeof name2 === "string" && typeof location2 === "string";
+}
+function identityOf(entry) {
+  return `${entry.in}:${entry.name}`;
+}
+function mergeParametersByIdentity(obj, src) {
+  if (!obj.every(isParameterEntry) || !src.every(isParameterEntry)) {
+    return void 0;
+  }
+  const unmatchedIndices = /* @__PURE__ */ new Map();
+  obj.forEach((entry, index3) => {
+    const indices = unmatchedIndices.get(identityOf(entry));
+    if (indices != null) {
+      indices.push(index3);
+    } else {
+      unmatchedIndices.set(identityOf(entry), [index3]);
+    }
+  });
+  const merged = [...obj];
+  for (const override of src) {
+    const identity5 = identityOf(override);
+    const matchIndex = unmatchedIndices.get(identity5)?.shift();
+    if (matchIndex == null) {
+      merged.push(override);
+      continue;
+    }
+    merged[matchIndex] = mergeWith_default(obj[matchIndex], override, overridesCustomizer);
+  }
+  return merged;
+}
 var omitDeepBy;
 var init_mergeWithOverrides = __esm({
   "../../commons/core-utils/lib/mergeWithOverrides.js"() {
@@ -118352,7 +118390,8 @@ var init_DocsYmlSchemas = __esm({
     });
     GitLibraryInputSchema = external_exports.object({
       git: external_exports.string(),
-      subpath: external_exports.string().optional()
+      subpath: external_exports.string().optional(),
+      ref: external_exports.string().optional()
     });
     PathLibraryInputSchema = external_exports.object({
       path: external_exports.string()
@@ -123729,7 +123768,8 @@ var init_GitLibraryInputSchema2 = __esm({
     init_core5();
     GitLibraryInputSchema2 = schemas_exports6.object({
       git: schemas_exports6.string(),
-      subpath: schemas_exports6.string().optional()
+      subpath: schemas_exports6.string().optional(),
+      ref: schemas_exports6.string().optional()
     });
   }
 });
@@ -165758,7 +165798,7 @@ function convertParameters({ path: path120, httpMethod, parameters: parameters2,
     const convertedParameter = {
       name: resolvedParameter.name,
       schema,
-      description: resolvedParameter.description,
+      description: getParameterDescription(resolvedParameter),
       parameterNameOverride: getParameterName(resolvedParameter),
       availability,
       source: source2,
@@ -165787,6 +165827,15 @@ function convertParameters({ path: path120, httpMethod, parameters: parameters2,
   }
   return convertedParameters;
 }
+function getParameterDescription(parameter6) {
+  if (parameter6.description != null) {
+    return parameter6.description;
+  }
+  if (parameter6.schema == null || isReferenceObject(parameter6.schema)) {
+    return void 0;
+  }
+  return parameter6.schema.description;
+}
 function getExplodeForQueryParameter(parameter6) {
   const style2 = parameter6.style ?? "form";
   const explode = parameter6.explode;
@@ -235585,7 +235634,7 @@ function parseLibrariesConfiguration(libraries) {
   }
   const result = {};
   for (const [name2, config5] of Object.entries(libraries)) {
-    const input3 = isGitLibraryInput(config5.input) ? { type: "git", git: config5.input.git, subpath: config5.input.subpath } : { type: "path", path: config5.input.path };
+    const input3 = isGitLibraryInput(config5.input) ? { type: "git", git: config5.input.git, subpath: config5.input.subpath, ref: config5.input.ref } : { type: "path", path: config5.input.path };
     result[name2] = {
       input: input3,
       output: {
@@ -694451,7 +694500,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.89.6",
+          version: "5.90.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -694517,7 +694566,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.89.6",
+        version: "5.90.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -875647,7 +875696,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.89.6";
+  const version7 = "5.90.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -896164,13 +896213,14 @@ async function generateIrRemotely({ client: client3, name: name2, config: config
   }
   const gitInput = config5.input;
   const jobId = await wrapStep({
-    message: `Library '${name2}': starting generation from ${gitInput.git}`,
+    message: `Library '${name2}': starting generation from ${gitInput.git}${gitInput.ref != null ? ` (ref: ${gitInput.ref})` : ""}`,
     operation: () => startGeneration(client3, {
       name: name2,
       orgId,
       githubUrl: gitInput.git,
       language,
       packagePath: gitInput.subpath,
+      ref: gitInput.ref,
       doxyfileContent
     })
   });
@@ -896205,7 +896255,8 @@ async function startGeneration(client3, opts) {
       githubUrl: opts.githubUrl,
       language: opts.language,
       config: {
-        branch: void 0,
+        // FDR's library-docs API accepts any git ref (branch, tag, or SHA) via `branch`.
+        branch: opts.ref,
         packagePath: opts.packagePath,
         title: opts.name,
         slug: opts.name,
@@ -898369,6 +898420,17 @@ var definitions6 = {
           }
         ],
         description: "Optional path within the repository to the library source.\nExample: django/core"
+      },
+      ref: {
+        oneOf: [
+          {
+            type: "string"
+          },
+          {
+            type: "null"
+          }
+        ],
+        description: "Git ref (branch, tag, or commit SHA) to check out.\nDefaults to the repository's default branch when omitted.\nExample: feature/my-fix"
       }
     },
     required: [
@@ -908357,7 +908419,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.89.6",
+        cliVersion: "5.90.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -975265,7 +975327,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.89.6"
+    cli_version: "5.90.0"
   };
 }
 function isAutomationMode() {
@@ -976097,7 +976159,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.89.6";
+    return "5.90.0";
   }
   getCliName() {
     if (false) {

package/package.json

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