@fern-api/fdr-sdk 1.2.42-d3871329d3 → 1.2.42-e01a8637c3

package/dist/navigation/__test__/ledger-root-builder.sidebarDepth.test.js

@@ -0,0 +1,273 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+import { createBreadcrumb } from "../utils/createBreadcrumb.js";
+/**
+ * Tests for sidebarDepth-based root section identification.
+ *
+ * V1 configs define flat root sections (e.g. "Users", "Policies",
+ * "Verification") that the decomposer marks as sidebarDepth=0. Without
+ * this marker, the builder's slug-derived hierarchy would infer that
+ * "users/verification" is a child of "users", creating extra ancestor
+ * levels in the breadcrumb.
+ */
+function pageRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        metadata: { title: opts.title, pageId: `pg-${opts.title.toLowerCase().replace(/\s+/g, "-")}` },
+        ...(opts.displaySortOrder != null ? { displaySortOrder: opts.displaySortOrder } : {})
+    };
+}
+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: null
+    };
+}
+/** Flatten sidebar-root children (unwrapping sidebarGroups) to section info. */
+function rootSections(root) {
+    const unversioned = root.child;
+    const sidebar = unversioned.child;
+    const result = [];
+    for (const child of sidebar.children) {
+        const items = child.type === "sidebarGroup"
+            ? child.children
+            : [child];
+        for (const item of items) {
+            if (item.type === "section") {
+                const childTitles = (item.children ?? []).map((c) => c.title ?? "");
+                result.push({ title: item.title ?? "", childTitles });
+            }
+        }
+    }
+    return result;
+}
+/** Count all section nodes in the tree via DFS. */
+function countSectionNodes(root) {
+    let count = 0;
+    FernNavigation.traverseDF(root, (node) => {
+        if (node.type === "section") {
+            count++;
+        }
+    });
+    return count;
+}
+/** Find a page node by slug and return its breadcrumb. */
+function breadcrumbForSlug(root, slug) {
+    const collector = FernNavigation.NodeCollector.collect(root);
+    const found = collector.getSlugMapWithParents().get(FernNavigation.Slug(slug));
+    if (found == null) {
+        throw new Error(`Slug "${slug}" not found in tree`);
+    }
+    return createBreadcrumb(found.parents);
+}
+// ── Fix #1: sidebarDepth prevents false root section nesting ─────────────────
+describe("buildFullRootFromSegments — sidebarDepth prevents false nesting", () => {
+    /**
+     * Reproduces the structure that causes extra breadcrumb links:
+     *
+     * V1 config (flat):
+     *   Introduction  (skipUrlSlug → sec="")
+     *   Users         (sec="users", sidebarDepth=0)
+     *   Policies      (sec="users/policies", sidebarDepth=0)
+     *   Verification  (sec="users/verification", sidebarDepth=0)
+     *
+     * Without sidebarDepth, the builder would nest Policies and Verification
+     * under Users (since parentSectionPath("users/policies") === "users"),
+     * creating extra breadcrumb ancestors.
+     *
+     * With sidebarDepth=0, they remain flat root peers.
+     */
+    function buildFlatRoot() {
+        return buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-root",
+                    section: "",
+                    sortOrder: 0,
+                    metadata: { type: "tabRoot" }
+                }),
+                // Root section wrapper (Introduction, skipUrlSlug → sec="")
+                segment({
+                    segmentHash: "seg-intro",
+                    section: "",
+                    sortOrder: 1,
+                    metadata: {
+                        type: "section",
+                        title: "Introduction",
+                        sidebarDepth: 0,
+                        childIndex: 0,
+                        pointsTo: "docs/guides/e-wallet"
+                    }
+                }),
+                // Users — depth 0, should be root peer
+                segment({
+                    segmentHash: "seg-users",
+                    section: "users",
+                    sortOrder: 2,
+                    metadata: {
+                        type: "section",
+                        title: "Users",
+                        sidebarDepth: 0,
+                        childIndex: 1,
+                        pointsTo: "docs/guides/users/types"
+                    }
+                }),
+                // Policies — depth 0, path is "users/policies" but should NOT
+                // be nested under Users
+                segment({
+                    segmentHash: "seg-policies",
+                    section: "users/policies",
+                    sortOrder: 3,
+                    metadata: {
+                        type: "section",
+                        title: "Policies",
+                        sidebarDepth: 0,
+                        childIndex: 2,
+                        pointsTo: "docs/guides/users/blocked-users"
+                    }
+                }),
+                // Verification — depth 0, path is "users/verification" but
+                // should NOT be nested under Users
+                segment({
+                    segmentHash: "seg-verification",
+                    section: "users/verification",
+                    sortOrder: 4,
+                    metadata: {
+                        type: "section",
+                        title: "User KYC/KYB verification",
+                        sidebarDepth: 0,
+                        childIndex: 3
+                    }
+                }),
+                // Nested child under Verification (depth 1)
+                segment({
+                    segmentHash: "seg-hosted",
+                    section: "users/verification/hosted",
+                    sortOrder: 5,
+                    metadata: {
+                        type: "section",
+                        title: "Flows per user type",
+                        sidebarDepth: 1,
+                        childIndex: 0,
+                        pointsTo: "docs/guides/users/verification/hosted/natural"
+                    }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-root",
+                    [pageRoute({ fullPath: "docs/guides/e-wallet", title: "E-wallet system", displaySortOrder: 0 })]
+                ],
+                ["seg-intro", []],
+                ["seg-users", [pageRoute({ fullPath: "docs/guides/users/types", title: "User types" })]],
+                ["seg-policies", [pageRoute({ fullPath: "docs/guides/users/blocked-users", title: "Blocked users" })]],
+                [
+                    "seg-verification",
+                    [pageRoute({ fullPath: "docs/guides/users/verification", title: "Verification overview" })]
+                ],
+                [
+                    "seg-hosted",
+                    [pageRoute({ fullPath: "docs/guides/users/verification/hosted/natural", title: "Natural persons" })]
+                ]
+            ])
+        });
+    }
+    it("preserves flat root sections instead of nesting by slug hierarchy", () => {
+        const root = buildFlatRoot();
+        const sections = rootSections(root);
+        const titles = sections.map((s) => s.title);
+        // All depth-0 sections should appear as root peers
+        expect(titles).toContain("Users");
+        expect(titles).toContain("Policies");
+        expect(titles).toContain("User KYC/KYB verification");
+    });
+    it("does not create extra breadcrumb ancestors for flat sections", () => {
+        const root = buildFlatRoot();
+        // The verification section's slug is docs/users/verification.
+        // Its page lives at docs/docs/guides/users/verification (basePath + fullPath).
+        const bc = breadcrumbForSlug(root, "docs/users/verification");
+        // With flat root sections, the verification page should have at most
+        // one section ancestor, not extra "Users" + "Policies" ancestors.
+        const linkedEntries = bc.filter((item) => item.pointsTo != null);
+        expect(linkedEntries.length).toBeLessThanOrEqual(1);
+        // Total breadcrumb entries should be 1 (just the verification section)
+        // not 3 (Introduction + Policies + Verification)
+        expect(bc.length).toBeLessThanOrEqual(1);
+    });
+    it("still nests depth>0 children under their parent section", () => {
+        const root = buildFlatRoot();
+        // "Flows per user type" (depth 1, sec="users/verification/hosted")
+        // should be nested under "User KYC/KYB verification" (depth 0,
+        // sec="users/verification")
+        const sections = rootSections(root);
+        const verification = sections.find((s) => s.title === "User KYC/KYB verification");
+        expect(verification).toBeDefined();
+        expect(verification.childTitles).toContain("Flows per user type");
+    });
+    it("does not produce duplicate section nodes", () => {
+        const root = buildFlatRoot();
+        const totalSections = countSectionNodes(root);
+        // 5 unique sections: Introduction, Users, Policies,
+        // User KYC/KYB verification, Flows per user type
+        expect(totalSections).toBe(5);
+    });
+});
+// ── Backward compatibility: segments without sidebarDepth ────────────────────
+describe("buildFullRootFromSegments — backward compatibility without sidebarDepth", () => {
+    it("falls back to path-based hierarchy when sidebarDepth is absent", () => {
+        // Old data without sidebarDepth: "users/verification" is correctly
+        // nested under "users" via slug hierarchy.
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-root",
+                    section: "",
+                    sortOrder: 0,
+                    metadata: { type: "tabRoot" }
+                }),
+                segment({
+                    segmentHash: "seg-users",
+                    section: "users",
+                    sortOrder: 1,
+                    metadata: { type: "section", title: "Users", childIndex: 0 }
+                }),
+                segment({
+                    segmentHash: "seg-verification",
+                    section: "users/verification",
+                    sortOrder: 2,
+                    metadata: { type: "section", title: "Verification", childIndex: 0 }
+                })
+            ],
+            navBySegment: new Map([
+                ["seg-root", [pageRoute({ fullPath: "docs/overview", title: "Overview", displaySortOrder: 0 })]],
+                ["seg-users", [pageRoute({ fullPath: "docs/users/types", title: "User types" })]],
+                [
+                    "seg-verification",
+                    [pageRoute({ fullPath: "docs/users/verification/guide", title: "Verification guide" })]
+                ]
+            ])
+        });
+        // Without sidebarDepth, Verification nests under Users (slug-derived)
+        const sections = rootSections(root);
+        const users = sections.find((s) => s.title === "Users");
+        expect(users).toBeDefined();
+        expect(users.childTitles).toContain("Verification");
+    });
+});
+//# sourceMappingURL=ledger-root-builder.sidebarDepth.test.js.map

package/dist/navigation/__test__/ledger-root-builder.sidebarDepth.test.js.map

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

package/dist/navigation/__test__/ledger-root-builder.skipSlugGroupOrdering.test.d.ts

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

package/dist/navigation/__test__/ledger-root-builder.skipSlugGroupOrdering.test.d.ts.map

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

package/dist/navigation/__test__/ledger-root-builder.skipSlugGroupOrdering.test.js

@@ -0,0 +1,234 @@
+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: 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: "GET",
+            isResponseStream: false
+        }
+    };
+}
+describe("buildFullRootFromSegments — skipUrlSlug group package ordering", () => {
+    it("preserves DFS order when multiple apiPackage groups share the same section path", () => {
+        // Simulates the structure where an apiReference has multiple skipUrlSlug
+        // group packages (all sharing section "api") with leaf packages underneath.
+        // DFS order: apiRef → groupA → leafA1, leafA2 → groupB → leafB1, leafB2
+        const segments = [
+            segment({
+                segmentHash: "api-ref",
+                section: "api",
+                sortOrder: 0,
+                metadata: { type: "apiReference", title: "API", apiDefinitionId: "plant-api-def" }
+            }),
+            // Group A (skipUrlSlug — same section as apiReference)
+            segment({
+                segmentHash: "group-a",
+                section: "api",
+                sortOrder: 1,
+                metadata: {
+                    type: "apiPackage",
+                    title: "Soil Management",
+                    childIndex: 0,
+                    apiDefinitionId: "plant-api-def"
+                }
+            }),
+            // Leaf A1 — child of group A
+            segment({
+                segmentHash: "leaf-a1",
+                section: "api/soil-types",
+                sortOrder: 2,
+                metadata: { type: "apiPackage", title: "Soil Types", childIndex: 0, apiDefinitionId: "plant-api-def" }
+            }),
+            // Leaf A2 — child of group A
+            segment({
+                segmentHash: "leaf-a2",
+                section: "api/soil-nutrients",
+                sortOrder: 3,
+                metadata: {
+                    type: "apiPackage",
+                    title: "Soil Nutrients",
+                    childIndex: 1,
+                    apiDefinitionId: "plant-api-def"
+                }
+            }),
+            // Group B (skipUrlSlug — same section as apiReference)
+            segment({
+                segmentHash: "group-b",
+                section: "api",
+                sortOrder: 4,
+                metadata: { type: "apiPackage", title: "Watering", childIndex: 1, apiDefinitionId: "plant-api-def" }
+            }),
+            // Leaf B1 — child of group B
+            segment({
+                segmentHash: "leaf-b1",
+                section: "api/watering-schedules",
+                sortOrder: 5,
+                metadata: {
+                    type: "apiPackage",
+                    title: "Watering Schedules",
+                    childIndex: 0,
+                    apiDefinitionId: "plant-api-def"
+                }
+            }),
+            // Leaf B2 — child of group B
+            segment({
+                segmentHash: "leaf-b2",
+                section: "api/watering-methods",
+                sortOrder: 6,
+                metadata: {
+                    type: "apiPackage",
+                    title: "Watering Methods",
+                    childIndex: 1,
+                    apiDefinitionId: "plant-api-def"
+                }
+            })
+        ];
+        const navBySegment = new Map([
+            ["api-ref", []],
+            ["group-a", []],
+            [
+                "leaf-a1",
+                [
+                    restRoute({
+                        fullPath: "api/soil-types/list",
+                        title: "List Soil Types",
+                        endpointId: "listSoilTypes",
+                        displaySortOrder: 0
+                    }),
+                    restRoute({
+                        fullPath: "api/soil-types/get",
+                        title: "Get Soil Type",
+                        endpointId: "getSoilType",
+                        displaySortOrder: 1
+                    })
+                ]
+            ],
+            [
+                "leaf-a2",
+                [
+                    restRoute({
+                        fullPath: "api/soil-nutrients/list",
+                        title: "List Nutrients",
+                        endpointId: "listNutrients",
+                        displaySortOrder: 0
+                    })
+                ]
+            ],
+            ["group-b", []],
+            [
+                "leaf-b1",
+                [
+                    restRoute({
+                        fullPath: "api/watering-schedules/list",
+                        title: "List Schedules",
+                        endpointId: "listSchedules",
+                        displaySortOrder: 0
+                    })
+                ]
+            ],
+            [
+                "leaf-b2",
+                [
+                    restRoute({
+                        fullPath: "api/watering-methods/list",
+                        title: "List Methods",
+                        endpointId: "listMethods",
+                        displaySortOrder: 0
+                    })
+                ]
+            ]
+        ]);
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Plant Docs",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const sidebar = root.child.child;
+        const apiRef = sidebar.children[0];
+        expect(apiRef.type).toBe("apiReference");
+        // The apiReference should preserve DFS order: soil-types, soil-nutrients,
+        // watering-schedules, watering-methods (not round-robin: soil-types,
+        // watering-schedules, soil-nutrients, watering-methods).
+        const childTitles = apiRef.children.map((c) => c.title);
+        expect(childTitles).toEqual(["Soil Types", "Soil Nutrients", "Watering Schedules", "Watering Methods"]);
+    });
+    it("group packages do not create duplicate root-level nodes when sharing section with apiReference", () => {
+        const segments = [
+            segment({
+                segmentHash: "api-ref",
+                section: "api",
+                sortOrder: 0,
+                metadata: { type: "apiReference", title: "API", apiDefinitionId: "plant-api-def" }
+            }),
+            segment({
+                segmentHash: "group-a",
+                section: "api",
+                sortOrder: 1,
+                metadata: {
+                    type: "apiPackage",
+                    title: "Soil Management",
+                    childIndex: 0,
+                    apiDefinitionId: "plant-api-def"
+                }
+            }),
+            segment({
+                segmentHash: "leaf-a1",
+                section: "api/soil-types",
+                sortOrder: 2,
+                metadata: { type: "apiPackage", title: "Soil Types", childIndex: 0, apiDefinitionId: "plant-api-def" }
+            })
+        ];
+        const navBySegment = new Map([
+            ["api-ref", []],
+            ["group-a", []],
+            [
+                "leaf-a1",
+                [
+                    restRoute({
+                        fullPath: "api/soil-types/list",
+                        title: "List Soil Types",
+                        endpointId: "listSoilTypes",
+                        displaySortOrder: 0
+                    })
+                ]
+            ]
+        ]);
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Plant Docs",
+            segments,
+            navBySegment
+        });
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const sidebar = root.child.child;
+        // Only one apiReference node should exist (groups should not create duplicates)
+        const apiRefNodes = sidebar.children.filter((c) => c.type === "apiReference");
+        expect(apiRefNodes).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.skipSlugGroupOrdering.test.js.map

package/dist/navigation/__test__/ledger-root-builder.skipSlugGroupOrdering.test.js.map

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

package/dist/navigation/__test__/ledger-root-builder.skipSlugSiblingSection.test.d.ts

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

package/dist/navigation/__test__/ledger-root-builder.skipSlugSiblingSection.test.d.ts.map

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