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

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"() {
@@ -68308,6 +68346,13 @@ var init_NugetPublishTarget = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/api/resources/publish/types/PackagistPublishTarget.js
+var init_PackagistPublishTarget = __esm({
+  "../../ir-sdk/lib/sdk/api/resources/publish/types/PackagistPublishTarget.js"() {
+    "use strict";
+  }
+});
+
 // ../../ir-sdk/lib/sdk/api/resources/publish/types/PostmanPublishTarget.js
 var init_PostmanPublishTarget = __esm({
   "../../ir-sdk/lib/sdk/api/resources/publish/types/PostmanPublishTarget.js"() {
@@ -68444,6 +68489,15 @@ var init_PublishTarget = __esm({
           }
         };
       },
+      packagist: (value2) => {
+        return {
+          ...value2,
+          type: "packagist",
+          _visit: function(visitor) {
+            return PublishTarget._visit(this, visitor);
+          }
+        };
+      },
       _visit: (value2, visitor) => {
         switch (value2.type) {
           case "postman":
@@ -68462,6 +68516,8 @@ var init_PublishTarget = __esm({
             return visitor.nuget(value2);
           case "rubygems":
             return visitor.rubygems(value2);
+          case "packagist":
+            return visitor.packagist(value2);
           default:
             return visitor._other(value2);
         }
@@ -68496,6 +68552,7 @@ var init_types65 = __esm({
     init_MavenPublishTarget();
     init_NpmPublishTarget();
     init_NugetPublishTarget();
+    init_PackagistPublishTarget();
     init_PostmanPublishTarget();
     init_PublishingConfig();
     init_PublishTarget();
@@ -80247,6 +80304,19 @@ var init_NugetPublishTarget2 = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/serialization/resources/publish/types/PackagistPublishTarget.js
+var PackagistPublishTarget;
+var init_PackagistPublishTarget2 = __esm({
+  "../../ir-sdk/lib/sdk/serialization/resources/publish/types/PackagistPublishTarget.js"() {
+    "use strict";
+    init_core2();
+    PackagistPublishTarget = schemas_exports3.objectWithoutOptionalProperties({
+      version: schemas_exports3.string().optional(),
+      packageName: schemas_exports3.string().optional()
+    });
+  }
+});
+
 // ../../ir-sdk/lib/sdk/serialization/resources/publish/types/PostmanPublishTarget.js
 var PostmanPublishTarget;
 var init_PostmanPublishTarget2 = __esm({
@@ -80299,6 +80369,7 @@ var init_PublishTarget2 = __esm({
     init_MavenPublishTarget2();
     init_NpmPublishTarget2();
     init_NugetPublishTarget2();
+    init_PackagistPublishTarget2();
     init_PostmanPublishTarget2();
     init_PypiPublishTarget2();
     init_RubyGemsPublishTarget2();
@@ -80310,7 +80381,8 @@ var init_PublishTarget2 = __esm({
       crates: CratesPublishTarget,
       go: GoPublishTarget,
       nuget: NugetPublishTarget,
-      rubygems: RubyGemsPublishTarget
+      rubygems: RubyGemsPublishTarget,
+      packagist: PackagistPublishTarget
     }).transform({
       transform: (value2) => {
         switch (value2.type) {
@@ -80330,6 +80402,8 @@ var init_PublishTarget2 = __esm({
             return PublishTarget.nuget(value2);
           case "rubygems":
             return PublishTarget.rubygems(value2);
+          case "packagist":
+            return PublishTarget.packagist(value2);
           default:
             return value2;
         }
@@ -82374,6 +82448,7 @@ var init_types94 = __esm({
     init_MavenPublishTarget2();
     init_NpmPublishTarget2();
     init_NugetPublishTarget2();
+    init_PackagistPublishTarget2();
     init_PostmanPublishTarget2();
     init_PublishingConfig2();
     init_PublishTarget2();
@@ -82393,6 +82468,7 @@ __export(publish_exports2, {
   MavenPublishTarget: () => MavenPublishTarget,
   NpmPublishTarget: () => NpmPublishTarget,
   NugetPublishTarget: () => NugetPublishTarget,
+  PackagistPublishTarget: () => PackagistPublishTarget,
   PostmanPublishTarget: () => PostmanPublishTarget,
   PublishTarget: () => PublishTarget2,
   PublishingConfig: () => PublishingConfig2,
@@ -83680,6 +83756,7 @@ __export(serialization_exports2, {
   OffsetPagination: () => OffsetPagination,
   Package: () => Package,
   PackageNavigationConfig: () => PackageNavigationConfig,
+  PackagistPublishTarget: () => PackagistPublishTarget,
   Pagination: () => Pagination3,
   PathPagination: () => PathPagination,
   PathParameter: () => PathParameter,
@@ -103237,6 +103314,21 @@ function getFilesystemPublishTarget({ generatorInvocation, version: version7, us
     });
     context3.logger.debug(`Created RubyGemsPublishTarget: version ${version7} package name: ${packageName}`);
     return publishTarget;
+  } else if (generatorInvocation.language === "php") {
+    const phpPackageName = packageName ?? (() => {
+      const config5 = generatorInvocation.raw?.config;
+      if (typeof config5 !== "object" || config5 === null) {
+        return void 0;
+      }
+      const configPackageName = config5.packageName;
+      return typeof configPackageName === "string" ? configPackageName : void 0;
+    })();
+    const publishTarget = PublishTarget.packagist({
+      version: version7,
+      packageName: phpPackageName
+    });
+    context3.logger.debug(`Created PackagistPublishTarget: version ${version7} package name: ${phpPackageName}`);
+    return publishTarget;
   } else if (generatorInvocation.language === "csharp") {
     if (userProvidedVersion != null) {
       const csharpPackageName = packageName ?? (typeof generatorInvocation.raw?.config === "object" && generatorInvocation.raw?.config !== null ? generatorInvocation.raw.config["package-id"] : void 0);
@@ -118352,7 +118444,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 +123822,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 +165852,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 +165881,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 +235688,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 +694554,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.89.6",
+          version: "5.90.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -694517,7 +694620,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.89.6",
+        version: "5.90.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -875647,7 +875750,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.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -896164,13 +896267,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 +896309,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 +898474,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 +908473,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.89.6",
+        cliVersion: "5.90.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -975265,7 +975381,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.1"
   };
 }
 function isAutomationMode() {
@@ -976097,7 +976213,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.89.6";
+    return "5.90.1";
   }
   getCliName() {
     if (false) {

package/package.json

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