@fern-api/fern-api-dev 5.57.0 → 5.58.0

package/cli.cjs

@@ -454802,20 +454802,129 @@ var init_lib65 = __esm({
   }
 });
 
-// ../register/lib/ai-example-enhancer/faiClient.js
-var DEFAULT_AI_ENHANCEMENT_MAX_RETRIES, DEFAULT_AI_ENHANCEMENT_TIMEOUT_MS, FaiExampleEnhancer;
-var init_faiClient = __esm({
-  "../register/lib/ai-example-enhancer/faiClient.js"() {
+// ../register/lib/ai-example-enhancer/filterHelpers.js
+function isFdrTypedValueWrapper(value2) {
+  if (value2 === null || value2 === void 0 || typeof value2 !== "object" || Array.isArray(value2)) {
+    return false;
+  }
+  const obj = value2;
+  const keys25 = Object.keys(obj);
+  if (keys25.length === 0 || keys25.length > 2) {
+    return false;
+  }
+  const hasType = "type" in obj && typeof obj.type === "string";
+  const hasValue = "value" in obj;
+  return hasType && keys25.length === 1 || hasType && hasValue && keys25.length === 2 || hasValue && keys25.length === 1;
+}
+function unwrapExampleValue(value2) {
+  if (value2 === null || value2 === void 0) {
+    return value2;
+  }
+  if (Array.isArray(value2)) {
+    return value2.map(unwrapExampleValue);
+  }
+  if (typeof value2 !== "object") {
+    return value2;
+  }
+  const obj = value2;
+  if (isFdrTypedValueWrapper(obj)) {
+    if ("value" in obj) {
+      return unwrapExampleValue(obj.value);
+    }
+    return void 0;
+  }
+  const result = {};
+  for (const [key2, val] of Object.entries(obj)) {
+    const unwrapped = unwrapExampleValue(val);
+    if (unwrapped !== void 0) {
+      result[key2] = unwrapped;
+    }
+  }
+  return result;
+}
+function isEmptyObject3(value2) {
+  if (value2 === null || value2 === void 0) {
+    return true;
+  }
+  if (typeof value2 !== "object") {
+    return false;
+  }
+  if (Array.isArray(value2)) {
+    return value2.length === 0;
+  }
+  return Object.keys(value2).length === 0;
+}
+function filterRequestBody(requestBody, pathParameters, queryParameters, headers2) {
+  const extractedPathParams = {};
+  const extractedQueryParams = {};
+  const extractedHeaders = {};
+  if (requestBody === null || requestBody === void 0 || typeof requestBody !== "object" || Array.isArray(requestBody)) {
+    return { filteredBody: requestBody, extractedPathParams, extractedQueryParams, extractedHeaders };
+  }
+  const bodyRecord = requestBody;
+  const filteredBody = {};
+  const pathParamKeys = new Set(Object.keys(pathParameters ?? {}));
+  const queryParamKeys = new Set(Object.keys(queryParameters ?? {}));
+  const headerKeys = new Set(Object.keys(headers2 ?? {}));
+  for (const [key2, value2] of Object.entries(bodyRecord)) {
+    const normalizedKey = key2.toLowerCase().replace(/[-_]/g, "");
+    let isPathParam = false;
+    let isQueryParam = false;
+    let isHeader = false;
+    for (const pathKey of pathParamKeys) {
+      const normalizedPathKey = pathKey.toLowerCase().replace(/[-_]/g, "");
+      if (normalizedKey === normalizedPathKey) {
+        isPathParam = true;
+        extractedPathParams[pathKey] = value2;
+        break;
+      }
+    }
+    if (!isPathParam) {
+      for (const queryKey of queryParamKeys) {
+        const normalizedQueryKey = queryKey.toLowerCase().replace(/[-_]/g, "");
+        if (normalizedKey === normalizedQueryKey) {
+          isQueryParam = true;
+          extractedQueryParams[queryKey] = value2;
+          break;
+        }
+      }
+    }
+    if (!isPathParam && !isQueryParam) {
+      for (const headerKey of headerKeys) {
+        const normalizedHeaderKey = headerKey.toLowerCase().replace(/[-_]/g, "");
+        if (normalizedKey === normalizedHeaderKey) {
+          isHeader = true;
+          extractedHeaders[headerKey] = value2;
+          break;
+        }
+      }
+    }
+    if (!isPathParam && !isQueryParam && !isHeader) {
+      filteredBody[key2] = value2;
+    }
+  }
+  return { filteredBody, extractedPathParams, extractedQueryParams, extractedHeaders };
+}
+var init_filterHelpers = __esm({
+  "../register/lib/ai-example-enhancer/filterHelpers.js"() {
+    "use strict";
+  }
+});
+
+// ../register/lib/ai-example-enhancer/lambdaClient.js
+var DEFAULT_AI_ENHANCEMENT_MAX_RETRIES, DEFAULT_AI_ENHANCEMENT_TIMEOUT_MS, LambdaExampleEnhancer;
+var init_lambdaClient = __esm({
+  "../register/lib/ai-example-enhancer/lambdaClient.js"() {
     "use strict";
     init_lib4();
     init_lib35();
     init_lib6();
     DEFAULT_AI_ENHANCEMENT_MAX_RETRIES = 0;
     DEFAULT_AI_ENHANCEMENT_TIMEOUT_MS = 15e3;
-    FaiExampleEnhancer = class {
+    LambdaExampleEnhancer = class {
       config;
       context;
-      faiOrigin;
+      lambdaOrigin;
       venusOrigin;
       token;
       jwtPromise;
@@ -454831,14 +454940,14 @@ var init_faiClient = __esm({
           styleInstructions: config5.styleInstructions
         };
         this.context = context3;
-        const faiOrigin = "https://fai-dev2.buildwithfern.com";
-        if (!faiOrigin) {
+        const lambdaOrigin = "https://ykq45y6fvnszd35iv5yuuatkze0rpwuz.lambda-url.us-east-1.on.aws";
+        if (!lambdaOrigin) {
           throw new CliError({
-            message: "DEFAULT_FAI_ORIGIN environment variable is not set. AI example enhancement requires this to be configured.",
+            message: "DEFAULT_FDR_LAMBDA_DOCS_ORIGIN environment variable is not set. AI example enhancement requires this to be configured.",
             code: CliError.Code.EnvironmentError
           });
         }
-        this.faiOrigin = faiOrigin;
+        this.lambdaOrigin = lambdaOrigin;
         this.venusOrigin = "https://venus-dev2.buildwithfern.com";
         this.token = token;
         this.organizationId = organizationId;
@@ -454943,7 +455052,7 @@ var init_faiClient = __esm({
         const maxAttempts = this.config.maxRetries + 1;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
           try {
-            this.context.logger.debug(`Enhancing example for ${request7.method} ${request7.endpointPath} via FAI (attempt ${attempt}/${maxAttempts})`);
+            this.context.logger.debug(`Enhancing example for ${request7.method} ${request7.endpointPath} via lambda (attempt ${attempt}/${maxAttempts})`);
             const requestBody = {
               method: request7.method,
               endpointPath: request7.endpointPath,
@@ -454959,7 +455068,7 @@ var init_faiClient = __esm({
               ...requestBody,
               openApiSpec: request7.openApiSpec ? `[OpenAPI spec present: ${request7.openApiSpec.length} chars]` : "[No OpenAPI spec]"
             }, null, 2)}`);
-            const response = await fetch(`${this.faiOrigin}/examples/enhance`, {
+            const response = await fetch(`${this.lambdaOrigin}/v2/registry/ai/enhance-example`, {
               method: "POST",
               headers: {
                 "Content-Type": "application/json",
@@ -454971,7 +455080,7 @@ var init_faiClient = __esm({
             if (!response.ok) {
               const errorText = await response.text();
               throw new CliError({
-                message: `FAI returned ${response.status}: ${errorText || response.statusText}`,
+                message: `Lambda returned ${response.status}: ${errorText || response.statusText}`,
                 code: CliError.Code.NetworkError
               });
             }
@@ -454999,115 +455108,6 @@ var init_faiClient = __esm({
   }
 });
 
-// ../register/lib/ai-example-enhancer/filterHelpers.js
-function isFdrTypedValueWrapper(value2) {
-  if (value2 === null || value2 === void 0 || typeof value2 !== "object" || Array.isArray(value2)) {
-    return false;
-  }
-  const obj = value2;
-  const keys25 = Object.keys(obj);
-  if (keys25.length === 0 || keys25.length > 2) {
-    return false;
-  }
-  const hasType = "type" in obj && typeof obj.type === "string";
-  const hasValue = "value" in obj;
-  return hasType && keys25.length === 1 || hasType && hasValue && keys25.length === 2 || hasValue && keys25.length === 1;
-}
-function unwrapExampleValue(value2) {
-  if (value2 === null || value2 === void 0) {
-    return value2;
-  }
-  if (Array.isArray(value2)) {
-    return value2.map(unwrapExampleValue);
-  }
-  if (typeof value2 !== "object") {
-    return value2;
-  }
-  const obj = value2;
-  if (isFdrTypedValueWrapper(obj)) {
-    if ("value" in obj) {
-      return unwrapExampleValue(obj.value);
-    }
-    return void 0;
-  }
-  const result = {};
-  for (const [key2, val] of Object.entries(obj)) {
-    const unwrapped = unwrapExampleValue(val);
-    if (unwrapped !== void 0) {
-      result[key2] = unwrapped;
-    }
-  }
-  return result;
-}
-function isEmptyObject3(value2) {
-  if (value2 === null || value2 === void 0) {
-    return true;
-  }
-  if (typeof value2 !== "object") {
-    return false;
-  }
-  if (Array.isArray(value2)) {
-    return value2.length === 0;
-  }
-  return Object.keys(value2).length === 0;
-}
-function filterRequestBody(requestBody, pathParameters, queryParameters, headers2) {
-  const extractedPathParams = {};
-  const extractedQueryParams = {};
-  const extractedHeaders = {};
-  if (requestBody === null || requestBody === void 0 || typeof requestBody !== "object" || Array.isArray(requestBody)) {
-    return { filteredBody: requestBody, extractedPathParams, extractedQueryParams, extractedHeaders };
-  }
-  const bodyRecord = requestBody;
-  const filteredBody = {};
-  const pathParamKeys = new Set(Object.keys(pathParameters ?? {}));
-  const queryParamKeys = new Set(Object.keys(queryParameters ?? {}));
-  const headerKeys = new Set(Object.keys(headers2 ?? {}));
-  for (const [key2, value2] of Object.entries(bodyRecord)) {
-    const normalizedKey = key2.toLowerCase().replace(/[-_]/g, "");
-    let isPathParam = false;
-    let isQueryParam = false;
-    let isHeader = false;
-    for (const pathKey of pathParamKeys) {
-      const normalizedPathKey = pathKey.toLowerCase().replace(/[-_]/g, "");
-      if (normalizedKey === normalizedPathKey) {
-        isPathParam = true;
-        extractedPathParams[pathKey] = value2;
-        break;
-      }
-    }
-    if (!isPathParam) {
-      for (const queryKey of queryParamKeys) {
-        const normalizedQueryKey = queryKey.toLowerCase().replace(/[-_]/g, "");
-        if (normalizedKey === normalizedQueryKey) {
-          isQueryParam = true;
-          extractedQueryParams[queryKey] = value2;
-          break;
-        }
-      }
-    }
-    if (!isPathParam && !isQueryParam) {
-      for (const headerKey of headerKeys) {
-        const normalizedHeaderKey = headerKey.toLowerCase().replace(/[-_]/g, "");
-        if (normalizedKey === normalizedHeaderKey) {
-          isHeader = true;
-          extractedHeaders[headerKey] = value2;
-          break;
-        }
-      }
-    }
-    if (!isPathParam && !isQueryParam && !isHeader) {
-      filteredBody[key2] = value2;
-    }
-  }
-  return { filteredBody, extractedPathParams, extractedQueryParams, extractedHeaders };
-}
-var init_filterHelpers = __esm({
-  "../register/lib/ai-example-enhancer/filterHelpers.js"() {
-    "use strict";
-  }
-});
-
 // ../register/lib/ai-example-enhancer/spinnerStatusCoordinator.js
 var SpinnerStatusCoordinator;
 var init_spinnerStatusCoordinator = __esm({
@@ -455713,7 +455713,7 @@ async function enhanceExamplesWithAI(apiDefinition, config5, context3, token, or
   }
 }
 async function performAIEnhancement(apiDefinition, config5, context3, token, organizationId, sourceSpecs, apiName) {
-  const enhancer = new FaiExampleEnhancer(config5, context3, token, organizationId);
+  const enhancer = new LambdaExampleEnhancer(config5, context3, token, organizationId);
   const circuitBreaker = new CircuitBreaker();
   let openApiSpec;
   let endpointsNeedingRegeneration = /* @__PURE__ */ new Set();
@@ -455926,7 +455926,7 @@ function collectWorkItems(pkg2, coveredEndpoints, endpointsNeedingRegeneration,
 }
 async function processEndpointsConcurrently(allWorkItems, enhancer, context3, organizationId, stats, enhancedExampleRecords, openApiSpec, sourceFilePath, statusId, apiStats, circuitBreaker) {
   const maxConcurrentRequests = parseInt(process.env.FERN_AI_MAX_CONCURRENT || "25", 10);
-  context3.logger.debug(`Processing ${allWorkItems.length} endpoints with max ${maxConcurrentRequests} concurrent FAI calls using rolling window queue`);
+  context3.logger.debug(`Processing ${allWorkItems.length} endpoints with max ${maxConcurrentRequests} concurrent Lambda calls using rolling window queue`);
   if (circuitBreaker?.shouldSkip()) {
     context3.logger.debug(`Circuit breaker is open after ${circuitBreaker.getFailureCount()} failures (threshold: ${circuitBreaker.getThreshold()}). Skipping AI enhancement for remaining endpoints.`);
     return /* @__PURE__ */ new Map();
@@ -456043,7 +456043,7 @@ async function processEndpoint(workItem, enhancer, context3, organizationId, sta
     const result = await enhancer.enhanceExample(request7);
     circuitBreaker?.recordSuccess();
     if (result.enhancedRequestExample != null && request7.originalRequestExample != null) {
-      const unwrapped = unwrapBodyEnvelope(result.enhancedRequestExample);
+      const unwrapped = unwrapLambdaBodyEnvelope(result.enhancedRequestExample);
       const originalHasBody = isObjectWithKey(request7.originalRequestExample, "body");
       if (unwrapped.wasWrapped && !originalHasBody) {
         result.enhancedRequestExample = backfillMissingFields(unwrapped.inner, request7.originalRequestExample);
@@ -456327,7 +456327,7 @@ function extractExampleValue(bodyV3) {
 function isObjectWithKey(value2, key2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2) && key2 in value2;
 }
-function unwrapBodyEnvelope(value2) {
+function unwrapLambdaBodyEnvelope(value2) {
   if (typeof value2 === "object" && value2 !== null && !Array.isArray(value2) && "body" in value2) {
     return { wasWrapped: true, inner: value2.body };
   }
@@ -456365,8 +456365,8 @@ var init_enhanceExamplesWithAI = __esm({
     init_lib65();
     import_promises72 = require("fs/promises");
     init_js_yaml();
-    init_faiClient();
     init_filterHelpers();
+    init_lambdaClient();
     init_spinnerStatusCoordinator();
     init_validateAiExamples();
     init_writeAiExamplesOverride();
@@ -459852,7 +459852,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
             navigationConfig: tabbed,
             parentSlug: slug
           }),
-          versioned: (versioned) => this.toVersionedNode(versioned, slug),
+          versioned: (versioned) => this.toVersionedNode(versioned, slug, this.parsedDocsConfig.landingPage),
           productgroup: (productGroup) => this.toProductGroupNode({
             landingPageConfig: this.parsedDocsConfig.landingPage,
             productGroup,
@@ -459888,7 +459888,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
         const child = navigationConfig.type === "tabbed" ? await this.convertTabbedNavigation(id, navigationConfig.items, parentSlug) : await this.toSidebarRootNode(id, navigationConfig.items, parentSlug);
         return { type: "unversioned", id, collapsed: void 0, landingPage, child };
       }
-      async toVersionedNode(versioned, parentSlug) {
+      async toVersionedNode(versioned, parentSlug, landingPage) {
         const id = this.#idgen.get("versioned");
         const defaultVersion = versioned.versions[0];
         if (defaultVersion?.hidden === true) {
@@ -459901,7 +459901,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
         const children2 = [];
         for (let i5 = 0; i5 < versioned.versions.length; i5 += BATCH_SIZE2) {
           const batch = versioned.versions.slice(i5, i5 + BATCH_SIZE2);
-          const batchResults = await Promise.all(batch.map((item, batchIdx) => this.toVersionNode(item, parentSlug, i5 + batchIdx === 0)));
+          const batchResults = await Promise.all(batch.map((item, batchIdx) => this.toVersionNode(item, parentSlug, i5 + batchIdx === 0, landingPage)));
           children2.push(...batchResults);
         }
         return {
@@ -459932,7 +459932,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
                 type: "unversioned",
                 id: this.#idgen.get(product.product),
                 collapsed: void 0,
-                landingPage: void 0,
+                landingPage: product.landingPage != null ? this.toLandingPageNode(product.landingPage, slug) : void 0,
                 child: await this.convertTabbedNavigation(this.#idgen.get(product.product), product.navigation.items, slug)
               };
               break;
@@ -459941,12 +459941,12 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
                 type: "unversioned",
                 id: this.#idgen.get(product.product),
                 collapsed: void 0,
-                landingPage: void 0,
+                landingPage: product.landingPage != null ? this.toLandingPageNode(product.landingPage, slug) : void 0,
                 child: await this.toSidebarRootNode(this.#idgen.get(product.product), product.navigation.items, slug)
               };
               break;
             case "versioned":
-              child = await this.toVersionedNode(product.navigation, slug);
+              child = await this.toVersionedNode(product.navigation, slug, product.landingPage ?? this.parsedDocsConfig.landingPage);
               break;
             default:
               assertNever(product.navigation);
@@ -459991,10 +459991,11 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
           };
         }
       }
-      async toVersionNode(version7, parentSlug, isDefault) {
+      async toVersionNode(version7, parentSlug, isDefault, landingPage) {
         const id = this.#idgen.get(version7.version);
         const slug = parentSlug.setVersionSlug(version7.slug ?? kebabCase_default(version7.version));
         const child = version7.navigation.type === "tabbed" ? await this.convertTabbedNavigation(id, version7.navigation.items, slug) : await this.toSidebarRootNode(id, version7.navigation.items, slug);
+        const resolvedLandingPage = version7.landingPage ?? landingPage;
         return {
           type: "version",
           id,
@@ -460006,7 +460007,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
           // TODO: the `default` property should be deprecated, and moved to the parent `versioned` node
           default: isDefault,
           availability: version7.availability != null ? convertAvailability5(version7.availability) : void 0,
-          landingPage: version7.landingPage ? this.toLandingPageNode(version7.landingPage, slug) : void 0,
+          landingPage: resolvedLandingPage != null ? this.toLandingPageNode(resolvedLandingPage, slug) : void 0,
           hidden: version7.hidden,
           authed: void 0,
           viewers: version7.viewers,
@@ -686971,7 +686972,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.57.0",
+          version: "5.58.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -687037,7 +687038,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.57.0",
+        version: "5.58.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -868132,7 +868133,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.57.0";
+  const version7 = "5.58.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -900613,7 +900614,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.57.0",
+        cliVersion: "5.58.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -966882,7 +966883,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.57.0"
+    cli_version: "5.58.0"
   };
 }
 function isAutomationMode() {
@@ -967714,7 +967715,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.57.0";
+    return "5.58.0";
   }
   getCliName() {
     if (false) {

package/package.json

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