fern-api 0.30.8-rc3 → 0.30.8-rc4

package/bundle.cjs

@@ -22232,7 +22232,8 @@ var init_ApiNavigationItem = __esm({
       schemas_exports.record(schemas_exports.string(), schemas_exports.lazy(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).ApiNavigationItems)),
       schemas_exports.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).PageConfiguration),
       schemas_exports.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).LinkConfiguration),
-      schemas_exports.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).ApiPackageConfiguration)
+      schemas_exports.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).ApiReferenceSectionConfiguration),
+      schemas_exports.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).ApiReferencePackageConfiguration)
     ]);
   }
 });
@@ -22249,14 +22250,31 @@ var init_SubpackageOrSubpackages = __esm({
   }
 });
 
-// pnp:/home/circleci/project/packages/cli/configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiPackageConfiguration.js
-var ApiPackageConfiguration;
-var init_ApiPackageConfiguration = __esm({
-  "pnp:/home/circleci/project/packages/cli/configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiPackageConfiguration.js"() {
+// pnp:/home/circleci/project/packages/cli/configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiReferenceSectionConfiguration.js
+var ApiReferenceSectionConfiguration;
+var init_ApiReferenceSectionConfiguration = __esm({
+  "pnp:/home/circleci/project/packages/cli/configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiReferenceSectionConfiguration.js"() {
     init_core();
-    ApiPackageConfiguration = schemas_exports.object({
+    ApiReferenceSectionConfiguration = schemas_exports.object({
+      section: schemas_exports.string(),
+      package: schemas_exports.lazy(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).SubpackageOrSubpackages).optional(),
+      summary: schemas_exports.string().optional(),
+      contents: schemas_exports.lazy(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).ApiNavigationItems),
+      slug: schemas_exports.string().optional(),
+      icon: schemas_exports.string().optional(),
+      hidden: schemas_exports.boolean().optional(),
+      skipSlug: schemas_exports.property("skip-slug", schemas_exports.boolean().optional())
+    });
+  }
+});
+
+// pnp:/home/circleci/project/packages/cli/configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiReferencePackageConfiguration.js
+var ApiReferencePackageConfiguration;
+var init_ApiReferencePackageConfiguration = __esm({
+  "pnp:/home/circleci/project/packages/cli/configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/ApiReferencePackageConfiguration.js"() {
+    init_core();
+    ApiReferencePackageConfiguration = schemas_exports.object({
       package: schemas_exports.string(),
-      subpackage: schemas_exports.lazy(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).SubpackageOrSubpackages).optional(),
       summary: schemas_exports.string().optional(),
       contents: schemas_exports.lazy(async () => (await Promise.resolve().then(() => (init_serialization(), serialization_exports))).ApiNavigationItems),
       slug: schemas_exports.string().optional(),
@@ -22612,7 +22630,8 @@ var init_types = __esm({
     init_ApiSectionConfiguration();
     init_ApiNavigationItem();
     init_SubpackageOrSubpackages();
-    init_ApiPackageConfiguration();
+    init_ApiReferenceSectionConfiguration();
+    init_ApiReferencePackageConfiguration();
     init_ApiNavigationItems();
     init_LinkConfiguration();
     init_VersionedSnippetLanguageConfiguration();
@@ -22644,7 +22663,8 @@ var docs_exports3 = {};
 __export(docs_exports3, {
   ApiNavigationItem: () => ApiNavigationItem,
   ApiNavigationItems: () => ApiNavigationItems,
-  ApiPackageConfiguration: () => ApiPackageConfiguration,
+  ApiReferencePackageConfiguration: () => ApiReferencePackageConfiguration,
+  ApiReferenceSectionConfiguration: () => ApiReferenceSectionConfiguration,
   ApiSectionConfiguration: () => ApiSectionConfiguration,
   AudiencesConfig: () => AudiencesConfig,
   BackgroundImageConfiguration: () => BackgroundImageConfiguration,
@@ -22720,7 +22740,8 @@ var serialization_exports = {};
 __export(serialization_exports, {
   ApiNavigationItem: () => ApiNavigationItem,
   ApiNavigationItems: () => ApiNavigationItems,
-  ApiPackageConfiguration: () => ApiPackageConfiguration,
+  ApiReferencePackageConfiguration: () => ApiReferencePackageConfiguration,
+  ApiReferenceSectionConfiguration: () => ApiReferenceSectionConfiguration,
   ApiSectionConfiguration: () => ApiSectionConfiguration,
   AudiencesConfig: () => AudiencesConfig,
   BackgroundImageConfiguration: () => BackgroundImageConfiguration,
@@ -1050256,12 +1050277,25 @@ function parseApiNavigationItem(item, absolutePathToConfig) {
         icon: item.icon
       }
     ];
-  } else if (isRawApiPackageConfiguration(item)) {
+  } else if (isRawApiRefSectionConfiguration(item)) {
+    return [
+      {
+        type: "section",
+        section: item.section,
+        subpackages: typeof item.package === "string" ? [item.package] : item.package ?? [],
+        summaryAbsolutePath: resolveFilepath(item.summary, absolutePathToConfig),
+        contents: item.contents.flatMap((value) => parseApiNavigationItem(value, absolutePathToConfig)),
+        slug: item.slug,
+        hidden: item.hidden,
+        skipUrlSlug: item.skipSlug,
+        icon: item.icon
+      }
+    ];
+  } else if (isRawApiRefPackageConfiguration(item)) {
     return [
       {
         type: "package",
         package: item.package,
-        subpackages: typeof item.subpackage === "string" ? [item.subpackage] : item.subpackage ?? [],
         summaryAbsolutePath: resolveFilepath(item.summary, absolutePathToConfig),
         contents: item.contents.flatMap((value) => parseApiNavigationItem(value, absolutePathToConfig)),
         slug: item.slug,
@@ -1050274,7 +1050308,6 @@ function parseApiNavigationItem(item, absolutePathToConfig) {
   return Object.entries(item).map(([key2, values3]) => ({
     type: "package",
     package: key2,
-    subpackages: [],
     summaryAbsolutePath: void 0,
     contents: values3.flatMap((value) => parseApiNavigationItem(value, absolutePathToConfig)),
     hidden: false,
@@ -1050303,8 +1050336,11 @@ function isRawApiSectionConfig(item) {
 function isRawLinkConfig(item) {
   return isPlainObject(item) && typeof item.link === "string" && typeof item.href === "string";
 }
-function isRawApiPackageConfiguration(item) {
-  return isPlainObject(item) && typeof item.package === "string" && Array.isArray(item.contents);
+function isRawApiRefSectionConfiguration(item) {
+  return isPlainObject(item) && typeof item.section === "string" && Array.isArray(item.contents);
+}
+function isRawApiRefPackageConfiguration(item) {
+  return isPlainObject(item) && item.section == null && typeof item.package === "string" && Array.isArray(item.contents);
 }
 function resolveFilepath(unresolvedFilepath, absoluteFilepathToDocsConfig) {
   if (unresolvedFilepath == null) {
@@ -1054306,7 +1054342,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.30.8-rc3",
+          version: "0.30.8-rc4",
           usingAccessToken: true
         }
       });
@@ -1054368,7 +1054404,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.30.8-rc3",
+        version: "0.30.8-rc4",
         ...event,
         ...event.properties
       }
@@ -1080311,10 +1080347,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.30.8-rc3" == null) {
+    if ("0.30.8-rc4" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.30.8-rc3";
+    return "0.30.8-rc4";
   }
   getCliName() {
     if ("fern" == null) {
@@ -1087624,9 +1087660,10 @@ function stringifyEndpointPathParts22(path42) {
 var ROOT_PACKAGE_ID = "root";
 var _endpoints2, _webSockets2, _webhooks2, _endpointsInverted, _webSocketsInverted, _webhooksInverted, _subpackages, _endpointsByLocator, _webSocketsByLocator, _webhooksByLocator, _subpackagesByLocator, _constructSubpackageLocators, constructSubpackageLocators_fn;
 var _ApiDefinitionHolder2 = class {
-  constructor(api) {
+  constructor(api, context) {
     __privateAdd(this, _constructSubpackageLocators);
     __publicField(this, "api");
+    __publicField(this, "context");
     __privateAdd(this, _endpoints2, /* @__PURE__ */ new Map());
     __privateAdd(this, _webSockets2, /* @__PURE__ */ new Map());
     __privateAdd(this, _webhooks2, /* @__PURE__ */ new Map());
@@ -1087639,6 +1087676,7 @@ var _ApiDefinitionHolder2 = class {
     __privateAdd(this, _webhooksByLocator, /* @__PURE__ */ new Map());
     __privateAdd(this, _subpackagesByLocator, /* @__PURE__ */ new Map());
     this.api = api;
+    this.context = context;
     [api.rootPackage, ...Object.values(api.subpackages)].forEach((pkg2) => {
       const subpackageId = _ApiDefinitionHolder2.getSubpackageId(pkg2);
       const subpackageHolder = {
@@ -1087648,50 +1087686,69 @@ var _ApiDefinitionHolder2 = class {
       };
       __privateGet(this, _subpackages).set(subpackageId, subpackageHolder);
       pkg2.endpoints.forEach((endpoint) => {
+        var _a5;
         subpackageHolder.endpoints.set(endpoint.id, endpoint);
         const endpointId = _ApiDefinitionHolder2.createEndpointId(endpoint, subpackageId);
         __privateGet(this, _endpoints2).set(endpointId, endpoint);
-        if (endpointId.startsWith("subpackage_")) {
-          __privateGet(this, _endpointsByLocator).set(endpointId.substring("subpackage_".length), endpoint);
-        } else if (endpointId.startsWith("root.")) {
-          __privateGet(this, _endpointsByLocator).set(endpointId.substring("root.".length), endpoint);
-        }
-        __privateGet(this, _endpointsByLocator).set(`${endpoint.method} ${stringifyEndpointPathParts2(endpoint.path.parts)}`, endpoint);
-        __privateGet(this, _endpointsByLocator).set(`${endpoint.method} ${stringifyEndpointPathParts22(endpoint.path.parts)}`, endpoint);
-        endpoint.environments.forEach((environment) => {
-          __privateGet(this, _endpointsByLocator).set(`${endpoint.method} ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts2(endpoint.path.parts))}`, endpoint);
-          __privateGet(this, _endpointsByLocator).set(`${endpoint.method} ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts22(endpoint.path.parts))}`, endpoint);
-          const basePath = getBasePath(environment);
-          if (basePath != null) {
-            __privateGet(this, _endpointsByLocator).set(`${endpoint.method} ${urlJoin22(basePath, stringifyEndpointPathParts2(endpoint.path.parts))}`, endpoint);
-            __privateGet(this, _endpointsByLocator).set(`${endpoint.method} ${urlJoin22(basePath, stringifyEndpointPathParts22(endpoint.path.parts))}`, endpoint);
-          }
+        const locators = [];
+        const methods = [endpoint.method];
+        if (((_a5 = endpoint.response) == null ? void 0 : _a5.type.type) === "stream") {
+          methods.push("STREAM");
+        }
+        methods.forEach((method2) => {
+          locators.push(`${method2} ${stringifyEndpointPathParts2(endpoint.path.parts)}`);
+          locators.push(`${method2} ${stringifyEndpointPathParts22(endpoint.path.parts)}`);
+          endpoint.environments.forEach((environment) => {
+            locators.push(`${method2} ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts2(endpoint.path.parts))}`);
+            locators.push(`${method2} ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts22(endpoint.path.parts))}`);
+            const basePath = getBasePath(environment);
+            if (basePath != null) {
+              locators.push(`${method2} ${urlJoin22(basePath, stringifyEndpointPathParts2(endpoint.path.parts))}`);
+              locators.push(`${method2} ${urlJoin22(basePath, stringifyEndpointPathParts22(endpoint.path.parts))}`);
+            }
+          });
+        });
+        locators.forEach((locator) => {
+          var _a6;
+          (_a6 = this.context) == null ? void 0 : _a6.logger.debug(`Registering endpoint locator: ${locator}`);
+          __privateGet(this, _endpointsByLocator).set(locator, endpoint);
         });
       });
       pkg2.websockets.forEach((webSocket) => {
         subpackageHolder.webSockets.set(webSocket.id, webSocket);
         const webSocketId = _ApiDefinitionHolder2.createWebSocketId(webSocket, subpackageId);
         __privateGet(this, _webSockets2).set(webSocketId, webSocket);
-        if (webSocketId.startsWith("subpackage_")) {
-          __privateGet(this, _webSocketsByLocator).set(webSocketId.substring("subpackage_".length), webSocket);
-        } else if (webSocketId.startsWith("root.")) {
-          __privateGet(this, _webSocketsByLocator).set(webSocketId.substring("root.".length), webSocket);
-        }
-        __privateGet(this, _webSocketsByLocator).set(`GET ${stringifyEndpointPathParts2(webSocket.path.parts)}`, webSocket);
-        __privateGet(this, _webSocketsByLocator).set(`GET ${stringifyEndpointPathParts22(webSocket.path.parts)}`, webSocket);
-        webSocket.environments.forEach((environment) => {
-          __privateGet(this, _webSocketsByLocator).set(`GET ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts2(webSocket.path.parts))}`, webSocket);
-          __privateGet(this, _webSocketsByLocator).set(`GET ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts22(webSocket.path.parts))}`, webSocket);
-          const basePath = getBasePath(environment);
-          if (basePath != null) {
-            __privateGet(this, _webSocketsByLocator).set(`GET ${urlJoin22(basePath, stringifyEndpointPathParts2(webSocket.path.parts))}`, webSocket);
-            __privateGet(this, _webSocketsByLocator).set(`GET ${urlJoin22(basePath, stringifyEndpointPathParts22(webSocket.path.parts))}`, webSocket);
-          }
+        const locators = [];
+        const methods = ["GET", "WSS"];
+        methods.forEach((method2) => {
+          locators.push(`${method2} ${stringifyEndpointPathParts2(webSocket.path.parts)}`);
+          locators.push(`${method2} ${stringifyEndpointPathParts22(webSocket.path.parts)}`);
+          webSocket.environments.forEach((environment) => {
+            locators.push(`${method2} ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts2(webSocket.path.parts))}`);
+            locators.push(`${method2} ${urlJoin22(environment.baseUrl, stringifyEndpointPathParts22(webSocket.path.parts))}`);
+            const basePath = getBasePath(environment);
+            if (basePath != null) {
+              locators.push(`${method2} ${urlJoin22(basePath, stringifyEndpointPathParts2(webSocket.path.parts))}`);
+              locators.push(`${method2} ${urlJoin22(basePath, stringifyEndpointPathParts22(webSocket.path.parts))}`);
+            }
+          });
+        });
+        locators.forEach((locator) => {
+          var _a5;
+          (_a5 = this.context) == null ? void 0 : _a5.logger.debug(`Registering websocket locator: ${locator}`);
+          __privateGet(this, _webSocketsByLocator).set(locator, webSocket);
         });
       });
       pkg2.webhooks.forEach((webhook) => {
         subpackageHolder.webhooks.set(webhook.id, webhook);
         __privateGet(this, _webhooks2).set(_ApiDefinitionHolder2.createWebhookId(webhook, subpackageId), webhook);
+        const locators = [];
+        locators.push(`${webhook.method} ${urlJoin22("/", ...webhook.path)}`);
+        locators.forEach((locator) => {
+          var _a5;
+          (_a5 = this.context) == null ? void 0 : _a5.logger.debug(`Registering webhook locator: ${locator}`);
+          __privateGet(this, _webhooksByLocator).set(locator, webhook);
+        });
       });
     });
     __privateGet(this, _endpoints2).forEach((endpoint, endpointId) => {
@@ -1087705,8 +1087762,8 @@ var _ApiDefinitionHolder2 = class {
     });
     __privateMethod(this, _constructSubpackageLocators, constructSubpackageLocators_fn).call(this, api.rootPackage, []);
   }
-  static create(api) {
-    return new _ApiDefinitionHolder2(api);
+  static create(api, context) {
+    return new _ApiDefinitionHolder2(api, context);
   }
   static getSubpackageId(pkg2) {
     return isSubpackage2(pkg2) ? pkg2.subpackageId : ROOT_PACKAGE_ID;
@@ -1087792,15 +1087849,21 @@ constructSubpackageLocators_fn = function(pkg2, parents) {
     return __privateMethod(this, _constructSubpackageLocators, constructSubpackageLocators_fn).call(this, this.api.subpackages[pkg2.pointsTo], packageList);
   }
   pkg2.endpoints.forEach((endpoint) => {
+    var _a5;
     const locator = [...packageList, endpoint.id].join(".");
+    (_a5 = this.context) == null ? void 0 : _a5.logger.debug(`Registering endpoint locator: ${locator}`);
     __privateGet(this, _endpointsByLocator).set(locator, endpoint);
   });
   pkg2.websockets.forEach((webSocket) => {
+    var _a5;
     const locator = [...packageList, webSocket.id].join(".");
+    (_a5 = this.context) == null ? void 0 : _a5.logger.debug(`Registering websocket locator: ${locator}`);
     __privateGet(this, _webSocketsByLocator).set(locator, webSocket);
   });
   pkg2.webhooks.forEach((webhook) => {
+    var _a5;
     const locator = [...packageList, webhook.id].join(".");
+    (_a5 = this.context) == null ? void 0 : _a5.logger.debug(`Registering webhook locator: ${locator}`);
     __privateGet(this, _webhooksByLocator).set(locator, webhook);
   });
   pkg2.subpackages.forEach((subpackageId) => {
@@ -1087989,11 +1088052,12 @@ var NodeIdGenerator2 = class {
 };
 
 // pnp:/home/circleci/project/packages/cli/docs-resolver/lib/ApiReferenceNodeConverter.js
-var _holder2, _visitedEndpoints2, _visitedWebSockets2, _visitedWebhooks2, _visitedSubpackages2, _nodeIdToSubpackageId, _children, _overviewPageId, _slug, _convertApiNavigationItems, convertApiNavigationItems_fn, _convertPackage, convertPackage_fn, _convertApiDefinitionPackage, convertApiDefinitionPackage_fn, _convertUnknownIdentifier, convertUnknownIdentifier_fn;
+var _holder2, _visitedEndpoints2, _visitedWebSockets2, _visitedWebhooks2, _visitedSubpackages2, _nodeIdToSubpackageId, _children, _overviewPageId, _slug, _convertApiNavigationItems, convertApiNavigationItems_fn, _convertPackage, convertPackage_fn, _convertSection, convertSection_fn, _convertApiDefinitionPackage, convertApiDefinitionPackage_fn, _convertUnknownIdentifier, convertUnknownIdentifier_fn;
 var ApiReferenceNodeConverter = class {
   constructor(apiSection, api, parentSlug, workspace, docsWorkspace, taskContext, markdownFilesToFullSlugs) {
     __privateAdd(this, _convertApiNavigationItems);
     __privateAdd(this, _convertPackage);
+    __privateAdd(this, _convertSection);
     __privateAdd(this, _convertApiDefinitionPackage);
     __privateAdd(this, _convertUnknownIdentifier);
     __publicField(this, "apiSection");
@@ -1088017,7 +1088081,7 @@ var ApiReferenceNodeConverter = class {
     this.taskContext = taskContext;
     this.markdownFilesToFullSlugs = markdownFilesToFullSlugs;
     this.apiDefinitionId = navigation_exports2.ApiDefinitionId(api.id);
-    __privateSet(this, _holder2, ApiDefinitionHolder2.create(api));
+    __privateSet(this, _holder2, ApiDefinitionHolder2.create(api, taskContext));
     const idgen = NodeIdGenerator2.init(this.apiDefinitionId);
     __privateSet(this, _overviewPageId, this.apiSection.summaryAbsolutePath != null ? navigation_exports2.PageId(this.toRelativeFilepath(this.apiSection.summaryAbsolutePath)) : void 0);
     const maybeFullSlug = this.apiSection.summaryAbsolutePath != null ? this.markdownFilesToFullSlugs.get(this.apiSection.summaryAbsolutePath) : void 0;
@@ -1088127,6 +1088191,7 @@ convertApiNavigationItems_fn = function(navigation, apiDefinitionPackage, parent
       };
     },
     package: (pkg2) => __privateMethod(this, _convertPackage, convertPackage_fn).call(this, pkg2, parentSlug, idgen),
+    section: (section) => __privateMethod(this, _convertSection, convertSection_fn).call(this, section, parentSlug, idgen),
     item: ({ value: unknownIdentifier }) => __privateMethod(this, _convertUnknownIdentifier, convertUnknownIdentifier_fn).call(this, unknownIdentifier, apiDefinitionPackageId, parentSlug, idgen)
   })).filter(isNonNullish);
 };
@@ -1088134,50 +1088199,6 @@ _convertPackage = new WeakSet();
 convertPackage_fn = function(pkg2, parentSlug, idgen) {
   const overviewPageId = pkg2.summaryAbsolutePath != null ? navigation_exports2.PageId(this.toRelativeFilepath(pkg2.summaryAbsolutePath)) : void 0;
   const maybeFullSlug = pkg2.summaryAbsolutePath != null ? this.markdownFilesToFullSlugs.get(pkg2.summaryAbsolutePath) : void 0;
-  if (pkg2.subpackages.length > 0) {
-    let subpackage2 = void 0;
-    let i2 = 0;
-    while (subpackage2 == null && i2 < pkg2.subpackages.length) {
-      subpackage2 = __privateGet(this, _holder2).getSubpackage(pkg2.subpackages[i2]);
-      i2++;
-    }
-    if (subpackage2 != null) {
-      const subpackageId = ApiDefinitionHolder2.getSubpackageId(subpackage2);
-      const subpackageNodeId = idgen.append(subpackageId);
-      __privateGet(this, _visitedSubpackages2).add(subpackageId);
-      __privateGet(this, _nodeIdToSubpackageId).set(subpackageNodeId.get(), subpackageId);
-      const urlSlug = pkg2.slug ?? (isSubpackage2(subpackage2) ? subpackage2.urlSlug : this.apiSection.slug ?? kebabCase_default2(this.apiSection.title));
-      const slug = parentSlug.apply({
-        fullSlug: maybeFullSlug == null ? void 0 : maybeFullSlug.split("/"),
-        skipUrlSlug: pkg2.skipUrlSlug,
-        urlSlug
-      });
-      const convertedItems = [];
-      pkg2.subpackages.forEach((subpackageId2) => {
-        const subpackage3 = __privateGet(this, _holder2).getSubpackage(subpackageId2);
-        if (subpackage3 == null) {
-          this.taskContext.logger.error(`Subpackage ${subpackageId2} not found in ${this.apiDefinitionId}`);
-          return;
-        }
-        __privateGet(this, _visitedSubpackages2).add(subpackageId2);
-        __privateGet(this, _nodeIdToSubpackageId).set(subpackageNodeId.get(), subpackageId2);
-        convertedItems.push(...__privateMethod(this, _convertApiNavigationItems, convertApiNavigationItems_fn).call(this, pkg2.contents, subpackage3, slug, subpackageNodeId));
-      });
-      return {
-        id: subpackageNodeId.get(),
-        type: "apiPackage",
-        children: convertedItems,
-        title: pkg2.package,
-        slug: slug.get(),
-        icon: pkg2.icon,
-        hidden: pkg2.hidden,
-        overviewPageId,
-        availability: void 0,
-        apiDefinitionId: this.apiDefinitionId,
-        pointsTo: void 0
-      };
-    }
-  }
   const subpackage = __privateGet(this, _holder2).getSubpackage(pkg2.package);
   if (subpackage != null) {
     const subpackageId = ApiDefinitionHolder2.getSubpackageId(subpackage);
@@ -1088205,6 +1088226,7 @@ convertPackage_fn = function(pkg2, parentSlug, idgen) {
       pointsTo: void 0
     };
   } else {
+    this.taskContext.logger.error(`Subpackage ${pkg2.package} not found in ${this.apiDefinitionId}`);
     const urlSlug = pkg2.slug ?? kebabCase_default2(pkg2.package);
     const slug = parentSlug.apply({
       fullSlug: maybeFullSlug == null ? void 0 : maybeFullSlug.split("/"),
@@ -1088227,6 +1088249,41 @@ convertPackage_fn = function(pkg2, parentSlug, idgen) {
     };
   }
 };
+_convertSection = new WeakSet();
+convertSection_fn = function(section, parentSlug, idgen) {
+  const overviewPageId = section.summaryAbsolutePath != null ? navigation_exports2.PageId(this.toRelativeFilepath(section.summaryAbsolutePath)) : void 0;
+  const maybeFullSlug = section.summaryAbsolutePath != null ? this.markdownFilesToFullSlugs.get(section.summaryAbsolutePath) : void 0;
+  const nodeId = idgen.append(`section:${kebabCase_default2(section.section)}`);
+  section.subpackages.forEach((subpackageId) => {
+    const subpackage = __privateGet(this, _holder2).getSubpackage(subpackageId);
+    if (subpackage == null) {
+      this.taskContext.logger.error(`Subpackage ${subpackageId} not found in ${this.apiDefinitionId}`);
+      return;
+    }
+    __privateGet(this, _visitedSubpackages2).add(subpackageId);
+    __privateGet(this, _nodeIdToSubpackageId).set(nodeId.get(), subpackageId);
+  });
+  const urlSlug = section.slug ?? kebabCase_default2(section.section);
+  const slug = parentSlug.apply({
+    fullSlug: maybeFullSlug == null ? void 0 : maybeFullSlug.split("/"),
+    skipUrlSlug: section.skipUrlSlug,
+    urlSlug
+  });
+  const convertedItems = __privateMethod(this, _convertApiNavigationItems, convertApiNavigationItems_fn).call(this, section.contents, section.subpackages.length === 1 ? __privateGet(this, _holder2).getSubpackage(section.subpackages[0]) : void 0, slug, idgen);
+  return {
+    id: nodeId.get(),
+    type: "apiPackage",
+    children: convertedItems,
+    title: section.section,
+    slug: slug.get(),
+    icon: section.icon,
+    hidden: section.hidden,
+    overviewPageId,
+    availability: void 0,
+    apiDefinitionId: this.apiDefinitionId,
+    pointsTo: void 0
+  };
+};
 _convertApiDefinitionPackage = new WeakSet();
 convertApiDefinitionPackage_fn = function(packageId, children2, parentSlug, idgen) {
   const pkg2 = packageId != null ? __privateGet(this, _holder2).resolveSubpackage(__privateGet(this, _holder2).getSubpackage(packageId)) : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fern-api",
-  "version": "0.30.8-rc3",
+  "version": "0.30.8-rc4",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern.git",