npm - @fern-api/fdr-sdk - Versions diffs - 1.2.39-1829e82a64 → 1.2.39-2a1aa9df8f - Mend

@fern-api/fdr-sdk 1.2.39-1829e82a64 → 1.2.39-2a1aa9df8f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (52) hide show

package/dist/navigation/__test__/findNode.authedRedirect.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=findNode.authedRedirect.test.d.ts.map

package/dist/navigation/__test__/findNode.authedRedirect.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"findNode.authedRedirect.test.d.ts","sourceRoot":"","sources":["../../../src/navigation/__test__/findNode.authedRedirect.test.ts"],"names":[],"mappings":""}

package/dist/navigation/__test__/findNode.authedRedirect.test.js ADDED Viewed

@@ -0,0 +1,184 @@
+import { describe, expect, it } from "vitest";
+import { FernNavigation } from "../..";
+/**
+ * Build a minimal RootNode with a multi-product structure to test that
+ * findNode surfaces the `authed` flag on redirect results. This mirrors
+ * the RBAC multi-product fixture where one product (greenhouse) is
+ * admin-only and another (garden) is public.
+ *
+ * Only fields that `findNode` reads are populated; the rest are stubs.
+ * The entire tree is built as a plain object and cast to `RootNode`.
+ */
+function buildMultiProductRoot(opts) {
+    return {
+        type: "root",
+        version: "v2",
+        id: "root",
+        slug: "",
+        title: "Test Docs",
+        icon: undefined,
+        hidden: undefined,
+        authed: undefined,
+        viewers: undefined,
+        orphaned: undefined,
+        featureFlags: undefined,
+        canonicalSlug: undefined,
+        collapsed: undefined,
+        pointsTo: "garden/garden-setup",
+        roles: undefined,
+        child: {
+            type: "productgroup",
+            id: "productgroup",
+            landingPage: undefined,
+            children: [
+                {
+                    type: "product",
+                    id: "product-garden",
+                    productId: "product-garden",
+                    slug: "garden",
+                    title: "Garden",
+                    icon: undefined,
+                    hidden: undefined,
+                    authed: opts.publicProductAuthed ? true : undefined,
+                    viewers: undefined,
+                    orphaned: undefined,
+                    featureFlags: undefined,
+                    canonicalSlug: undefined,
+                    default: true,
+                    subtitle: "",
+                    image: undefined,
+                    announcement: undefined,
+                    pointsTo: "garden/garden-setup",
+                    child: {
+                        type: "unversioned",
+                        id: "unversioned-garden",
+                        landingPage: undefined,
+                        child: {
+                            type: "sidebarRoot",
+                            id: "sidebar-garden",
+                            children: [
+                                {
+                                    type: "sidebarGroup",
+                                    id: "group-garden",
+                                    children: [
+                                        {
+                                            type: "page",
+                                            id: "page-garden-setup",
+                                            slug: "garden/garden-setup",
+                                            title: "Garden Setup",
+                                            icon: undefined,
+                                            hidden: undefined,
+                                            authed: opts.publicProductAuthed ? true : undefined,
+                                            viewers: undefined,
+                                            orphaned: undefined,
+                                            featureFlags: undefined,
+                                            canonicalSlug: undefined,
+                                            noindex: undefined,
+                                            pageId: "page-garden-setup",
+                                            availability: undefined
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    }
+                },
+                {
+                    type: "product",
+                    id: "product-greenhouse",
+                    productId: "product-greenhouse",
+                    slug: "greenhouse",
+                    title: "Greenhouse",
+                    icon: undefined,
+                    hidden: undefined,
+                    authed: opts.protectedProductAuthed ? true : undefined,
+                    viewers: undefined,
+                    orphaned: undefined,
+                    featureFlags: undefined,
+                    canonicalSlug: undefined,
+                    default: false,
+                    subtitle: "",
+                    image: undefined,
+                    announcement: undefined,
+                    pointsTo: "greenhouse/greenhouse-setup",
+                    child: {
+                        type: "unversioned",
+                        id: "unversioned-greenhouse",
+                        landingPage: undefined,
+                        child: {
+                            type: "sidebarRoot",
+                            id: "sidebar-greenhouse",
+                            children: [
+                                {
+                                    type: "sidebarGroup",
+                                    id: "group-greenhouse",
+                                    children: [
+                                        {
+                                            type: "page",
+                                            id: "page-greenhouse-setup",
+                                            slug: "greenhouse/greenhouse-setup",
+                                            title: "Greenhouse Setup",
+                                            icon: undefined,
+                                            hidden: undefined,
+                                            authed: opts.protectedProductAuthed ? true : undefined,
+                                            viewers: undefined,
+                                            orphaned: undefined,
+                                            featureFlags: undefined,
+                                            canonicalSlug: undefined,
+                                            noindex: undefined,
+                                            pageId: "page-greenhouse-setup",
+                                            availability: undefined
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    }
+                }
+            ]
+        }
+    };
+}
+describe("findNode — authed flag on redirect results", () => {
+    it("returns authed=true on redirect for a protected product structural URL", () => {
+        const root = buildMultiProductRoot({ protectedProductAuthed: true });
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug("greenhouse"));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("greenhouse/greenhouse-setup");
+            expect(result.authed).toBe(true);
+        }
+    });
+    it("returns authed=undefined on redirect for a public product structural URL", () => {
+        const root = buildMultiProductRoot({ protectedProductAuthed: false });
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug("garden"));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("garden/garden-setup");
+            expect(result.authed).toBeUndefined();
+        }
+    });
+    it("returns authed=undefined on root redirect", () => {
+        const root = buildMultiProductRoot({ protectedProductAuthed: true });
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("garden/garden-setup");
+            expect(result.authed).toBeUndefined();
+        }
+    });
+    it("returns found (not redirect) for page slugs", () => {
+        const root = buildMultiProductRoot({ protectedProductAuthed: true });
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug("greenhouse/greenhouse-setup"));
+        expect(result.type).toBe("found");
+    });
+    it("returns authed on notFound for unknown slug under protected product", () => {
+        const root = buildMultiProductRoot({ protectedProductAuthed: true });
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug("greenhouse/nonexistent"));
+        expect(result.type).toBe("notFound");
+        if (result.type === "notFound") {
+            expect(result.authed).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=findNode.authedRedirect.test.js.map

package/dist/navigation/__test__/findNode.authedRedirect.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"findNode.authedRedirect.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/findNode.authedRedirect.test.ts"],"names":[],"mappings":"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"}

package/dist/navigation/__test__/ledger-root-builder.collapsedDeterminism.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=ledger-root-builder.collapsedDeterminism.test.d.ts.map

package/dist/navigation/__test__/ledger-root-builder.collapsedDeterminism.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"ledger-root-builder.collapsedDeterminism.test.d.ts","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.collapsedDeterminism.test.ts"],"names":[],"mappings":""}

package/dist/navigation/__test__/ledger-root-builder.collapsedDeterminism.test.js ADDED Viewed

@@ -0,0 +1,85 @@
+import { describe, expect, it } from "vitest";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+/**
+ * Regression guard for the ledger `collapsed:false` flip
+ * (fern-platform#12357 follow-up).
+ *
+ * Root cause: the ledger segment read had no stable total `ORDER BY`, so two
+ * segments sharing a `sort_order` came back in arbitrary order; the builder's
+ * stable `.sort()` then preserved that arbitrary DB order, and the surviving
+ * section row is the one `sectionNode` reads `collapsed` from — flipping it
+ * across identical publishes. The DB fix adds a `seg.id` tiebreak; this test
+ * locks the complementary invariant on the builder side: its output must be
+ * independent of the order segments arrive in.
+ */
+function pageRoute(fullPath, title) {
+    return { type: "markdown", fullPath, hidden: false, metadata: { title, pageId: `pg-${title}` } };
+}
+function segment(opts) {
+    return {
+        segmentId: opts.hash,
+        segmentHash: opts.hash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder,
+        hidden: false,
+        metadata: opts.metadata,
+        product: null,
+        version: null,
+        variant: null,
+        tab: null
+    };
+}
+function findSectionByTitle(root, title) {
+    const found = [];
+    const walk = (nodes) => {
+        for (const n of nodes) {
+            found.push(n);
+            if (Array.isArray(n.children)) {
+                walk(n.children);
+            }
+        }
+    };
+    const sidebar = root.child.child;
+    walk(sidebar.children);
+    return found.find((n) => n.type === "section" && n.title === title);
+}
+// Two sibling guides sections under a tabRoot; "Advanced" carries collapsed:false.
+// The two section segments deliberately share a sort_order to mimic the DB tie
+// that previously surfaced in arbitrary order.
+function buildWith(order) {
+    const root = segment({ hash: "seg-root", section: "", sortOrder: 0, metadata: { type: "tabRoot" } });
+    const getStarted = segment({
+        hash: "seg-gs",
+        section: "get-started",
+        sortOrder: 5,
+        metadata: { type: "section", title: "Get Started", childIndex: 0 }
+    });
+    const advanced = segment({
+        hash: "seg-adv",
+        section: "advanced",
+        sortOrder: 5,
+        metadata: { type: "section", title: "Advanced", collapsed: false, childIndex: 1 }
+    });
+    const segments = order === "forward" ? [root, getStarted, advanced] : [root, advanced, getStarted];
+    return buildFullRootFromSegments({
+        basePath: "docs",
+        title: "Test",
+        segments: segments,
+        navBySegment: new Map([
+            ["seg-root", [pageRoute("overview", "Overview")]],
+            ["seg-gs", [pageRoute("get-started/intro", "Intro")]],
+            ["seg-adv", [pageRoute("advanced/config", "Config")]]
+        ])
+    });
+}
+describe("buildFullRootFromSegments — collapsed:false is order-independent", () => {
+    it("resolves collapsed:false identically regardless of segment input order", () => {
+        const forward = findSectionByTitle(buildWith("forward"), "Advanced");
+        const reversed = findSectionByTitle(buildWith("reversed"), "Advanced");
+        expect(forward?.collapsed).toBe(false);
+        expect(reversed?.collapsed).toBe(false);
+        expect(forward?.collapsed).toBe(reversed?.collapsed);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.collapsedDeterminism.test.js.map

package/dist/navigation/__test__/ledger-root-builder.collapsedDeterminism.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ledger-root-builder.collapsedDeterminism.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.collapsedDeterminism.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;;;;GAWG;AAEH,SAAS,SAAS,CAAC,QAAgB,EAAE,KAAa;IAC9C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE,EAAE,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,OAAO,CAAC,IAKhB;IACG,OAAO;QACH,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,WAAW,EAAE,IAAI,CAAC,IAAI;QACtB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,IAAI;KACZ,CAAC;AACN,CAAC;AAED,SAAS,kBAAkB,CACvB,IAAkD,EAClD,KAAa;IAEb,MAAM,KAAK,GAAuF,EAAE,CAAC;IACrG,MAAM,IAAI,GAAG,CAAC,KAAoE,EAAQ,EAAE;QACxF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,CAAU,CAAC,CAAC;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,CAAC,CAAC,QAAiB,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IACF,MAAM,OAAO,GAAI,IAAI,CAAC,KAAqD,CAAC,KAAK,CAAC;IAClF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,mFAAmF;AACnF,+EAA+E;AAC/E,+CAA+C;AAC/C,SAAS,SAAS,CAAC,KAA6B;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,OAAO,CAAC;QACvB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,aAAa;QACtB,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE;KACrE,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,OAAO,CAAC;QACrB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE;KACpF,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACnG,OAAO,yBAAyB,CAAC;QAC7B,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,QAAiB;QAC3B,YAAY,EAAE,IAAI,GAAG,CAAC;YAClB,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAU,CAAC;YAC1D,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAU,CAAC;YAC9D,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAU,CAAC;SACjE,CAAC;KACI,CAAC,CAAC;AAChB,CAAC;AAED,QAAQ,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC9E,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAC9E,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QAEvE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=ledger-root-builder.skipSlugApiReference.test.d.ts.map

package/dist/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"ledger-root-builder.skipSlugApiReference.test.d.ts","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.ts"],"names":[],"mappings":""}

package/dist/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.js ADDED Viewed

@@ -0,0 +1,210 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+function segment(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder,
+        hidden: false,
+        metadata: opts.metadata,
+        product: null,
+        version: null,
+        variant: null,
+        tab: opts.tab != null
+            ? {
+                id: opts.tab.id,
+                displayName: opts.tab.displayName,
+                icon: null,
+                sortOrder: opts.tab.sortOrder ?? 0,
+                hidden: false,
+                viewers: [],
+                orphaned: false,
+                featureFlags: [],
+                metadata: {
+                    slug: opts.tab.slug,
+                    tab_type: "tab",
+                    ...(opts.tab.pointsTo != null ? { pointsTo: opts.tab.pointsTo } : {})
+                }
+            }
+            : null
+    };
+}
+function restRoute(opts) {
+    return {
+        type: "rest",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: {
+            title: opts.title,
+            apiDefinitionId: "plant-api-def",
+            endpointId: opts.endpointId,
+            method: opts.method ?? "GET",
+            isResponseStream: false
+        }
+    };
+}
+function markdownRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: { title: opts.title, pageId: opts.pageId }
+    };
+}
+describe("buildFullRootFromSegments — skip-slug apiReference", () => {
+    const guidesTab = {
+        id: "tab:guides",
+        displayName: "Guides",
+        slug: "",
+        sortOrder: 0,
+        pointsTo: "welcome"
+    };
+    const apiTab = {
+        id: "tab:api-reference",
+        displayName: "API Reference",
+        slug: "api-reference",
+        sortOrder: 1,
+        pointsTo: "api-reference/list-plants"
+    };
+    it("skip-slug apiReference at section='' includes endpoint children in sidebar", () => {
+        const segments = [
+            // Guides tab section
+            segment({
+                segmentHash: "guides-section",
+                section: "get-started",
+                sortOrder: 0,
+                metadata: { type: "section", title: "Get Started", pointsTo: "welcome" },
+                tab: guidesTab
+            }),
+            // API Reference tab — apiReference with skip-slug (section="")
+            segment({
+                segmentHash: "api-ref",
+                section: "",
+                sortOrder: 1,
+                metadata: {
+                    type: "apiReference",
+                    title: "Plant API",
+                    apiDefinitionId: "plant-api-def",
+                    pointsTo: "api-reference/list-plants"
+                },
+                tab: apiTab
+            })
+        ];
+        const navBySegment = new Map([
+            [
+                "guides-section",
+                [
+                    markdownRoute({
+                        fullPath: "welcome",
+                        title: "Welcome",
+                        pageId: "pages/welcome.mdx",
+                        displaySortOrder: 0
+                    }),
+                    markdownRoute({
+                        fullPath: "quickstart",
+                        title: "Quickstart",
+                        pageId: "pages/quickstart.mdx",
+                        displaySortOrder: 1
+                    })
+                ]
+            ],
+            [
+                "api-ref",
+                [
+                    restRoute({
+                        fullPath: "api-reference/list-plants",
+                        title: "List plants",
+                        endpointId: "listPlants",
+                        displaySortOrder: 0
+                    }),
+                    restRoute({
+                        fullPath: "api-reference/get-plant",
+                        title: "Get plant",
+                        endpointId: "getPlant",
+                        displaySortOrder: 1
+                    })
+                ]
+            ]
+        ]);
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Plant Docs",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        // Navigate to the tabbed node
+        expect(root.child.type).toBe("unversioned");
+        const unversioned = root.child;
+        expect(unversioned.child.type).toBe("tabbed");
+        const tabbed = unversioned.child;
+        expect(tabbed.children).toHaveLength(2);
+        // Find the API Reference tab
+        const apiRefTab = tabbed.children.find((t) => t.type === "tab" && t.title === "API Reference");
+        expect(apiRefTab).toBeDefined();
+        // The sidebar root should have children (the apiReference node)
+        const sidebar = apiRefTab.child;
+        expect(sidebar.type).toBe("sidebarRoot");
+        expect(sidebar.children.length).toBeGreaterThan(0);
+        // The first child should be an apiReference node with endpoint children
+        const apiNode = sidebar.children[0];
+        expect(apiNode.type).toBe("apiReference");
+        expect(apiNode.children.length).toBe(2);
+        expect(apiNode.children.map((c) => [c.type, "title" in c ? c.title : ""])).toEqual([
+            ["endpoint", "List plants"],
+            ["endpoint", "Get plant"]
+        ]);
+    });
+    it("skip-slug apiReference endpoints are indexable (appear in sitemap)", () => {
+        const segments = [
+            segment({
+                segmentHash: "api-ref",
+                section: "",
+                sortOrder: 0,
+                metadata: {
+                    type: "apiReference",
+                    title: "Plant API",
+                    apiDefinitionId: "plant-api-def",
+                    pointsTo: "api-reference/list-plants"
+                },
+                tab: apiTab
+            })
+        ];
+        const navBySegment = new Map([
+            [
+                "api-ref",
+                [
+                    restRoute({
+                        fullPath: "api-reference/list-plants",
+                        title: "List plants",
+                        endpointId: "listPlants",
+                        displaySortOrder: 0
+                    }),
+                    restRoute({
+                        fullPath: "api-reference/get-plant",
+                        title: "Get plant",
+                        endpointId: "getPlant",
+                        displaySortOrder: 1
+                    })
+                ]
+            ]
+        ]);
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Plant Docs",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const collector = FernNavigation.NodeCollector.collect(root);
+        const indexableSlugs = collector.indexablePageSlugs;
+        expect(indexableSlugs).toContain("api-reference/list-plants");
+        expect(indexableSlugs).toContain("api-reference/get-plant");
+    });
+});
+//# sourceMappingURL=ledger-root-builder.skipSlugApiReference.test.js.map

package/dist/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ledger-root-builder.skipSlugApiReference.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.skipSlugApiReference.test.ts"],"names":[],"mappings":"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"}

package/dist/navigation/ledger-root-builder.d.ts CHANGED Viewed

@@ -101,7 +101,11 @@ export declare function apiLeafNodeFromNavRoute(route: NavRoute, basePath: strin
  * @internal Exported for the ledger loader's scoped explorer methods.
  */
 export declare function collectApiLeafNodesFromNav(routes: NavRoute[], basePath: string, segmentApiDefinitionId: string): ApiLeafNode[];
-/** Read the apiDefinitionId off a segment's metadata, or undefined. */
+/**
+ * Read the apiDefinitionId off a segment's metadata, or undefined.
+ * The matched types (apiReference, apiPackage, changelog) are the
+ * subset of {@link StructuralSegmentType} that carry an apiDefinitionId.
+ */
 export declare function segmentApiDefinitionId(metadata: Segment["metadata"]): string | undefined;
 /**
  * Merge endpoint nodes that were originally part of an `endpointPair` in the V1

package/dist/navigation/ledger-root-builder.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ledger-root-builder.d.ts","sourceRoot":"","sources":["../../src/navigation/ledger-root-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,KAAK,cAAc,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,KAAK,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;~~AAE9C~~,MAAM,WAAW,gBAAgB;IAC7B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC;AAID;;;;;;GAMG;AACH,UAAU,YAAY;IAClB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC,MAAM,CAAC;IAC/C,kFAAkF;IAClF,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC;CAC9D;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuBjE;~~AAmPD~~;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACjB,cAAc,CAAC,YAAY,GAC3B,cAAc,CAAC,WAAW,GAC1B,cAAc,CAAC,aAAa,GAC5B,cAAc,CAAC,QAAQ,GACvB,cAAc,CAAC,WAAW,CAAC;AAOjC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,GAAG,SAAS,CAGzB;AA+KD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,QAAQ,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,EAAE,CAKf;AAED~~,uEAAuE~~;~~AACvE~~,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CASxF;AAgWD;;;;;;GAMG;AACH,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,QAAQ,EAAE,GACnB,cAAc,CAAC,eAAe,EAAE,CAsElC;~~AAgiBD~~;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAmF5F"}
1	+ {"version":3,"file":"ledger-root-builder.d.ts","sourceRoot":"","sources":["../../src/navigation/ledger-root-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,KAAK,cAAc,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,KAAK,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AA6B9C,MAAM,WAAW,gBAAgB;IAC7B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC;AAID;;;;;;GAMG;AACH,UAAU,YAAY;IAClB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC,MAAM,CAAC;IAC/C,kFAAkF;IAClF,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC;CAC9D;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuBjE;AA+OD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACjB,cAAc,CAAC,YAAY,GAC3B,cAAc,CAAC,WAAW,GAC1B,cAAc,CAAC,aAAa,GAC5B,cAAc,CAAC,QAAQ,GACvB,cAAc,CAAC,WAAW,CAAC;AAOjC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,GAAG,SAAS,CAGzB;AA+KD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,QAAQ,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,WAAW,EAAE,CAKf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CASxF;AAgWD;;;;;;GAMG;AACH,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,QAAQ,EAAE,GACnB,cAAc,CAAC,eAAe,EAAE,CAsElC;AAsiBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAmF5F"}

package/dist/navigation/ledger-root-builder.js CHANGED Viewed

@@ -1,4 +1,12 @@
 import * as FernNavigation from "./index.js";
+const STRUCTURAL_SEGMENT_TYPES = new Set([
+    "section",
+    "apiReference",
+    "apiPackage",
+    "changelog"
+]);
+const API_NODE_SEGMENT_TYPES = new Set(["apiReference", "apiPackage"]);
+const INFRA_SEGMENT_TYPES = new Set(["files", "redirects"]);
 /** @internal Exported for testing only. */
 export function createBuildContext(basePath) {
     // Tracks how many times each id key has been handed out, so collisions get
@@ -109,10 +117,7 @@ function toViewers(viewers) {
  * cross-variant prev/next links to disclose restricted content.
  */
 function mergeVariantViewers(seg) {
-    const segViewers = seg.metadata.type === "section" ||
-        seg.metadata.type === "apiReference" ||
-        seg.metadata.type === "apiPackage" ||
-        seg.metadata.type === "changelog"
+    const segViewers = STRUCTURAL_SEGMENT_TYPES.has(seg.metadata.type)
         ? seg.metadata.viewers
         : undefined;
     const variantViewers = seg.variant?.viewers;
@@ -401,7 +406,11 @@ export function collectApiLeafNodesFromNav(routes, basePath, segmentApiDefinitio
         .map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId))
         .filter((node) => node != null);
 }
-/** Read the apiDefinitionId off a segment's metadata, or undefined. */
+/**
+ * Read the apiDefinitionId off a segment's metadata, or undefined.
+ * The matched types (apiReference, apiPackage, changelog) are the
+ * subset of {@link StructuralSegmentType} that carry an apiDefinitionId.
+ */
 export function segmentApiDefinitionId(metadata) {
     switch (metadata.type) {
         case "apiReference":
@@ -962,7 +971,7 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
         const type = metaStr(s.seg.metadata, "type");
         const childIndex = metaNum(s.seg.metadata, "childIndex");
         let node;
-        if (type === "apiReference" || type === "apiPackage") {
+        if (API_NODE_SEGMENT_TYPES.has(type ?? "")) {
             node = apiReferenceNode(ctx, s, scopeSegs, scopePrefix);
         }
         else if (type === "changelog") {
@@ -1051,7 +1060,7 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
     //
     //   hasRootSection = true
     //   │
-    //   ├─ (A) tabRoot / loose artifacts (sec=="", type!="section")
+    //   ├─ (A) tabRoot / loose artifacts (sec=="", !STRUCTURAL_SEGMENT_TYPES)
     //   │      → emit pages/links inline at their displaySortOrder
     //   │
     //   ├─ (B) the root section itself (sec=="", type=="section")
@@ -1080,8 +1089,10 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
         if (type === "tabRoot" && metaBool(s.seg.metadata, "landingPage") === true) {
             continue;
         }
-        // (A) Loose artifacts: tabRoot or non-section segments at section path "".
-        if (type === "tabRoot" || (sec === "" && type !== "section")) {
+        // (A) Loose artifacts: tabRoot or non-structural segments at section path "".
+        // Structural types need their own node builders in (B)/(C) even when
+        // their section path is "" (which happens with skip-slug: true).
+        if (type === "tabRoot" || (sec === "" && !STRUCTURAL_SEGMENT_TYPES.has(type ?? ""))) {
             for (const r of s.nav) {
                 const node = artifactToNode(ctx, r);
                 if (node != null) {
@@ -1101,12 +1112,16 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
         // adopted by a root section (B).
         const parent = parentSectionPath(sec);
         const isRootLevel = parent === "" || (!sectionPaths.has(parent) && nearestExistingAncestor(sec, sectionPaths) === "");
-        if (isRootLevel && hasRootSection) {
+        // Skip depth-0 sections already adopted by the root section wrapper (B),
+        // but NOT structural types with sec="" (skip-slug). buildSectionTree
+        // filters out sec="" segments (line 1249), so they wouldn't be adopted
+        // and must be emitted here directly.
+        if (isRootLevel && hasRootSection && sec !== "") {
             continue;
         }
         if (isRootLevel) {
             let node;
-            if (type === "apiReference" || type === "apiPackage") {
+            if (API_NODE_SEGMENT_TYPES.has(type ?? "")) {
                 node = apiReferenceNode(ctx, s, scopeSegs, scopePrefix);
             }
             else if (type === "changelog") {
@@ -1223,7 +1238,7 @@ export function buildFullRootFromSegments(options) {
         // but guard here too.
         .filter((seg) => {
         const t = metaStr(seg.metadata, "type");
-        return t !== "files" && t !== "redirects";
+        return !INFRA_SEGMENT_TYPES.has(t ?? "");
     })
         .map((seg) => ({ seg, nav: navBySegment.get(seg.segmentHash) ?? [] }));
     const rootSlug = asSlug(sourceRootSlug ?? basePath);