@fern-api/fern-api-dev 5.1.0 → 5.2.0

package/cli.cjs

@@ -511106,7 +511106,8 @@ var DocsInstance = external_exports.object({
   url: external_exports.string(),
   "custom-domain": CustomDomain.optional(),
   "edit-this-page": EditThisPageConfig.optional(),
-  audiences: Audience.optional()
+  audiences: Audience.optional(),
+  "multi-source": external_exports.boolean().optional()
 });
 var LogoConfiguration = external_exports.object({
   dark: external_exports.string().optional(),
@@ -514301,7 +514302,8 @@ var DocsInstance2 = schemas_exports6.object({
   url: schemas_exports6.string(),
   customDomain: schemas_exports6.property("custom-domain", CustomDomain2.optional()),
   editThisPage: schemas_exports6.property("edit-this-page", EditThisPageConfig2.optional()),
-  audiences: Audience2.optional()
+  audiences: Audience2.optional(),
+  multiSource: schemas_exports6.property("multi-source", schemas_exports6.boolean().optional())
 });
 
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/HttpSnippetLanguage.js
@@ -621990,7 +621992,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.1.0",
+          version: "5.2.0",
           usingAccessToken: true
         }
       });
@@ -622044,7 +622046,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.1.0",
+        version: "5.2.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -833919,7 +833921,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.1.0";
+  const version7 = "5.2.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -838237,6 +838239,16 @@ var definitions6 = {
             type: "null"
           }
         ]
+      },
+      "multi-source": {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ]
       }
     },
     required: [
@@ -845248,7 +845260,7 @@ async function calculateFileHash(absoluteFilePath) {
 function sanitizeRelativePathForS3(relativeFilePath) {
   return relativeFilePath.replace(/\.\.\//g, "_dot_dot_/");
 }
-async function publishDocs({ token, organization, docsWorkspace, domain: domain3, customDomains, apiWorkspaces, ossWorkspaces, context: context3, preview, previewId, editThisPage, disableTemplates = false, skipUpload = false, withAiExamples = true, excludeApis = false, targetAudiences, docsUrl, cliVersion, ciSource, deployerAuthor, loginCommand = "fern login" }) {
+async function publishDocs({ token, organization, docsWorkspace, domain: domain3, customDomains, apiWorkspaces, ossWorkspaces, context: context3, preview, previewId, editThisPage, disableTemplates = false, skipUpload = false, withAiExamples = true, excludeApis = false, targetAudiences, docsUrl, cliVersion, ciSource, deployerAuthor, loginCommand = "fern login", multiSource = false }) {
   const fdrOrigin = "https://registry-dev2.buildwithfern.com";
   const isAirGapped = await detectAirGappedMode(`${fdrOrigin}/health`, context3.logger);
   if (isAirGapped) {
@@ -845280,9 +845292,12 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain3
   let urlToOutput = customDomains[0] ?? domain3;
   const basePath = parseBasePath(domain3);
   const disableDynamicSnippets = docsWorkspace.config.experimental && docsWorkspace.config.experimental.dynamicSnippets === false;
-  const isBasepathAware = docsWorkspace.config.experimental?.basepathAware === true;
+  if (docsWorkspace.config.experimental?.basepathAware === true) {
+    context3.logger.warn("experimental.basepath-aware is deprecated. Use 'multi-source: true' on the instance instead.");
+  }
+  const isBasepathAware = multiSource || docsWorkspace.config.experimental?.basepathAware === true;
   if (isBasepathAware) {
-    context3.logger.debug("Experimental flag 'basepath-aware' is enabled - using basepath-aware S3 key format");
+    context3.logger.debug("Basepath-aware mode is enabled - using basepath-aware S3 key format");
   }
   let deployLocked = false;
   const doUnlock = () => {
@@ -846252,6 +846267,9 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
       customDomains.push(...maybeInstance.customDomain);
     }
   }
+  if (maybeInstance.multiSource === true) {
+    validateMultiSourceBasepaths(maybeInstance.url, customDomains, context3);
+  }
   context3.logger.info(`Starting docs publishing for ${preview ? "preview" : "production"}: ${maybeInstance.url}`);
   context3.logger.debug(`Organization: ${organization}, Preview: ${preview}, APIs: ${apiWorkspaces.length}, OSS: ${ossWorkspaces.length}`);
   let publishedUrl;
@@ -846278,7 +846296,8 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
       cliVersion,
       ciSource,
       deployerAuthor,
-      loginCommand
+      loginCommand,
+      multiSource: maybeInstance.multiSource ?? false
     });
     for (let attempt = 0; ; attempt++) {
       try {
@@ -846302,6 +846321,23 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
   });
   return publishedUrl;
 }
+function getBasepath(domain3) {
+  try {
+    const url3 = domain3.startsWith("https://") || domain3.startsWith("http://") ? domain3 : `https://${domain3}`;
+    return new URL(url3).pathname;
+  } catch {
+    return "/";
+  }
+}
+function validateMultiSourceBasepaths(instanceUrl, customDomains, context3) {
+  const urlBasepath = getBasepath(instanceUrl);
+  for (const customDomain of customDomains) {
+    const customDomainBasepath = getBasepath(customDomain);
+    if (customDomainBasepath !== "/" && urlBasepath !== customDomainBasepath) {
+      context3.failAndThrow(`When multi-source is enabled, the url and custom-domain must share the same basepath. Instance url '${instanceUrl}' has basepath '${urlBasepath}' but custom-domain '${customDomain}' has basepath '${customDomainBasepath}'.`, void 0, { code: CliError.Code.ConfigError });
+    }
+  }
+}
 
 // ../cli-v2/lib/docs/publisher/LegacyDocsPublisher.js
 var LegacyDocsPublisher = class {
@@ -846337,7 +846373,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.1.0",
+        cliVersion: "5.2.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -865752,6 +865788,8 @@ var Generation = class {
     explicitNamespaces: () => this.customConfig["explicit-namespaces"] === true,
     /** Override the default max retries for the SDK client. Default: 2. */
     maxRetries: () => this.customConfig.maxRetries,
+    /** Controls which HTTP status codes trigger automatic retries. Default: "legacy". */
+    retryStatusCodes: () => this.customConfig.retryStatusCodes ?? "legacy",
     /**
      * Output path configuration for generated files.
      * Returns normalized paths for library, test, solution, and other files.
@@ -920664,7 +920702,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.1.0";
+    return "5.2.0";
   }
   getCliName() {
     if (false) {

package/package.json

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