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

package/cli.cjs

@@ -76219,6 +76219,7 @@ var init_V2HttpEndpointExample2 = __esm({
     init_V2HttpEndpointResponse2();
     V2HttpEndpointExample = schemas_exports3.objectWithoutOptionalProperties({
       displayName: schemas_exports3.string().optional(),
+      contentType: schemas_exports3.string().optional(),
       request: V2HttpEndpointRequest.optional(),
       response: V2HttpEndpointResponse.optional(),
       codeSamples: schemas_exports3.list(V2HttpEndpointCodeSample).optional()
@@ -263778,6 +263779,7 @@ function maybeCreateAndStoreExample({ key: key2, displayName, request: request7,
   if (!exampleStore.has(key2)) {
     const example = {
       displayName,
+      contentType: void 0,
       request: request7,
       response,
       codeSamples: void 0
@@ -350712,6 +350714,19 @@ var init_OperationConverter = __esm({
             }
           }
         }
+        if (Object.keys(fernExamples.examples).length === 0 && Object.keys(fernExamples.streamExamples).length === 0 && convertedRequestBodies != null && convertedRequestBodies.length > 1) {
+          const perContentTypeExamples = this.synthesizeEndpointExamplesFromPerContentTypeRequestBodies({
+            convertedRequestBodies,
+            httpPath: path119,
+            httpMethod,
+            baseUrl
+          });
+          if (perContentTypeExamples != null) {
+            for (const [name2, example] of Object.entries(perContentTypeExamples)) {
+              fernExamples.examples[name2] = example;
+            }
+          }
+        }
         const endpointLevelSecuritySchemes = new Set(this.operation.security?.flatMap((securityRequirement) => Object.keys(securityRequirement)) ?? []);
         const securityHeaders = this.authSchemeToHeaders(Array.from(endpointLevelSecuritySchemes));
         if (securityHeaders.length > 0) {
@@ -351235,6 +351250,7 @@ var init_OperationConverter = __esm({
             if (resolvedValue != null) {
               result[name2] = {
                 displayName: void 0,
+                contentType: void 0,
                 request: {
                   docs: void 0,
                   endpoint: {
@@ -351298,6 +351314,104 @@ var init_OperationConverter = __esm({
         }
         return void 0;
       }
+      /**
+       * Synthesizes endpoint-level v2Examples from per-content-type request body
+       * examples that have already been extracted by the RequestBodyConverter.
+       *
+       * This handles the case where multiple content types (e.g. application/json
+       * and application/ld+json) reference the same schema but have distinct
+       * per-content-type examples. The RequestBodyConverter correctly extracts
+       * these into each body's v2Examples, but they need to be elevated to
+       * endpoint-level examples (tagged with contentType) for docs rendering.
+       */
+      synthesizeEndpointExamplesFromPerContentTypeRequestBodies({ convertedRequestBodies, httpPath, httpMethod, baseUrl }) {
+        const result = {};
+        const responseExamplesByContentType = this.extractNativeResponseExamplesByContentType();
+        for (const convertedBody of convertedRequestBodies) {
+          const body = convertedBody.requestBody;
+          const bodyContentType = body.contentType;
+          const bodyV2Examples = body.v2Examples;
+          if (bodyV2Examples == null) {
+            continue;
+          }
+          const userExamples = bodyV2Examples.userSpecifiedExamples;
+          if (Object.keys(userExamples).length === 0) {
+            continue;
+          }
+          const matchedResponse = bodyContentType != null ? responseExamplesByContentType.get(bodyContentType) : void 0;
+          for (const [exampleName, exampleValue] of Object.entries(userExamples)) {
+            const key2 = convertedRequestBodies.length > 1 && bodyContentType != null ? `${exampleName} (${bodyContentType})` : exampleName;
+            result[key2] = {
+              displayName: convertedRequestBodies.length > 1 ? key2 : void 0,
+              contentType: bodyContentType ?? void 0,
+              request: {
+                docs: void 0,
+                endpoint: {
+                  method: httpMethod,
+                  path: this.buildExamplePath(httpPath, {})
+                },
+                baseUrl: void 0,
+                environment: baseUrl,
+                auth: void 0,
+                pathParameters: {},
+                queryParameters: {},
+                headers: {},
+                requestBody: exampleValue
+              },
+              response: matchedResponse ?? this.extractNativeResponseExample() ?? void 0,
+              codeSamples: void 0
+            };
+          }
+        }
+        return Object.keys(result).length > 0 ? result : void 0;
+      }
+      /**
+       * Extracts native response examples grouped by content type from the
+       * operation's successful (2xx) responses. Used by
+       * synthesizeEndpointExamplesFromPerContentTypeRequestBodies to match
+       * response examples to their corresponding request content types.
+       */
+      extractNativeResponseExamplesByContentType() {
+        const responsesByContentType = /* @__PURE__ */ new Map();
+        if (this.operation.responses == null) {
+          return responsesByContentType;
+        }
+        for (const [statusCode, response] of Object.entries(this.operation.responses)) {
+          const statusCodeNum = parseInt(statusCode);
+          if (isNaN(statusCodeNum) || statusCodeNum < 200 || statusCodeNum >= 300) {
+            continue;
+          }
+          const resolvedResponse = this.context.resolveMaybeReference({
+            schemaOrReference: response,
+            breadcrumbs: [...this.breadcrumbs, "responses", statusCode]
+          });
+          if (resolvedResponse?.content == null) {
+            continue;
+          }
+          for (const [responseContentType, responseMediaType] of Object.entries(resolvedResponse.content)) {
+            if (responsesByContentType.has(responseContentType)) {
+              continue;
+            }
+            const namedExamples = this.context.getNamedExamplesFromMediaTypeObject({
+              mediaTypeObject: responseMediaType,
+              breadcrumbs: [...this.breadcrumbs, "responses", statusCode],
+              defaultExampleName: "Example"
+            });
+            for (const [, example] of namedExamples) {
+              const resolvedValue = this.context.resolveExampleWithValue(example);
+              if (resolvedValue != null) {
+                responsesByContentType.set(responseContentType, {
+                  docs: void 0,
+                  statusCode: statusCodeNum,
+                  body: api_exports.V2HttpEndpointResponseBody.json(resolvedValue)
+                });
+                break;
+              }
+            }
+          }
+        }
+        return responsesByContentType;
+      }
       convertStreamConditionExamples({ httpPath, httpMethod, baseUrl, fernExamples }) {
         const filteredJsonExamples = fernExamples.filter((example) => !(example.response != null && "stream" in example.response));
         const filteredStreamExamples = fernExamples.filter((example) => example.response != null && "stream" in example.response);
@@ -351321,6 +351435,7 @@ var init_OperationConverter = __esm({
             this.getExampleName({ example, exampleIndex }),
             {
               displayName: void 0,
+              contentType: void 0,
               request: example.request != null || example["path-parameters"] != null || example["query-parameters"] != null || example.headers != null ? {
                 docs: void 0,
                 endpoint: {
@@ -352776,6 +352891,7 @@ var init_MethodConverter = __esm({
             }
             examples[exampleName] = {
               displayName: void 0,
+              contentType: void 0,
               request: {
                 docs: void 0,
                 endpoint: {
@@ -454802,20 +454918,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 +455056,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 +455168,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 +455184,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 +455196,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 +455224,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 +455829,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 +456042,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 +456159,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 +456443,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 +456481,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 +459968,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 +460004,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 +460017,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 +460048,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 +460057,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 +460107,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 +460123,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 +687088,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.57.0",
+          version: "5.59.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -687037,7 +687154,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.57.0",
+        version: "5.59.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -868132,7 +868249,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.59.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -900613,7 +900730,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.57.0",
+        cliVersion: "5.59.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -964454,6 +964571,7 @@ init_lib9();
 function initializeEmptyServiceExample() {
   return {
     displayName: void 0,
+    contentType: void 0,
     request: {
       endpoint: {
         method: V2EndpointLocationHttpMethod.Post,
@@ -966882,7 +967000,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.59.0"
   };
 }
 function isAutomationMode() {
@@ -967714,7 +967832,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.57.0";
+    return "5.59.0";
   }
   getCliName() {
     if (false) {

package/package.json

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