@fern-api/fdr-sdk 1.2.39-4ae10c3282 → 1.2.39-4e8e68c5b4

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

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

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

@@ -0,0 +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

@@ -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

@@ -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.apiReferenceChildren.test.d.ts

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

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

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

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

@@ -0,0 +1,85 @@
+import { describe, expect, it } from "vitest";
+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 markdownRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: { title: opts.title, pageId: opts.pageId }
+    };
+}
+function restRoute(opts) {
+    return {
+        type: "rest",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: {
+            title: opts.title,
+            apiDefinitionId: "api-def",
+            endpointId: opts.endpointId,
+            method: "GET",
+            availability: "beta",
+            isResponseStream: false
+        }
+    };
+}
+describe("buildFullRootFromSegments — API reference docs pages", () => {
+    it("preserves markdown docs pages alongside endpoint children", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "API docs",
+            segments: [
+                segment({
+                    segmentHash: "seg-api",
+                    section: "api",
+                    sortOrder: 0,
+                    metadata: { type: "apiReference", title: "API Reference", apiDefinitionId: "api-def" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-api",
+                    [
+                        markdownRoute({
+                            fullPath: "api/links",
+                            title: "Links guide",
+                            pageId: "api-links",
+                            displaySortOrder: 0
+                        }),
+                        restRoute({
+                            fullPath: "api/get-generated",
+                            title: "Get generated",
+                            endpointId: "get-generated",
+                            displaySortOrder: 1
+                        })
+                    ]
+                ]
+            ])
+        });
+        const sidebar = root.child.child;
+        const apiReference = sidebar.children[0];
+        expect(apiReference.type).toBe("apiReference");
+        expect(apiReference.children.map((child) => [child.type, child.title])).toEqual([
+            ["page", "Links guide"],
+            ["endpoint", "Get generated"]
+        ]);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.apiReferenceChildren.test.js.map

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

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

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

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

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

@@ -0,0 +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

@@ -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

@@ -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":"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"}

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

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

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

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

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

@@ -0,0 +1,82 @@
+import { describe, expect, it } from "vitest";
+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 markdownRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        displaySortOrder: opts.displaySortOrder,
+        metadata: { title: opts.title, pageId: opts.pageId }
+    };
+}
+describe("buildFullRootFromSegments — landing pages", () => {
+    it("uses only explicit landing-page tabRoot segments as root landing pages", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Docs",
+            segments: [
+                segment({
+                    segmentHash: "seg-landing",
+                    section: "",
+                    sortOrder: 0,
+                    metadata: { type: "tabRoot", landingPage: true }
+                }),
+                segment({
+                    segmentHash: "seg-loose",
+                    section: "",
+                    sortOrder: 1,
+                    metadata: { type: "tabRoot" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-landing",
+                    [
+                        markdownRoute({
+                            fullPath: "landing",
+                            title: "Landing",
+                            pageId: "landing-page",
+                            displaySortOrder: 0
+                        })
+                    ]
+                ],
+                [
+                    "seg-loose",
+                    [
+                        markdownRoute({
+                            fullPath: "loose",
+                            title: "Loose",
+                            pageId: "loose-page",
+                            displaySortOrder: 1
+                        })
+                    ]
+                ]
+            ])
+        });
+        expect(root.child.type).toBe("unversioned");
+        if (root.child.type !== "unversioned") {
+            throw new Error("expected unversioned root child");
+        }
+        expect(root.child.landingPage?.pageId).toBe("landing-page");
+        const sidebarRoot = root.child.child;
+        expect(sidebarRoot.type).toBe("sidebarRoot");
+        const sidebarLeaves = sidebarRoot.children.flatMap((child) => child.children ?? [child]);
+        expect(sidebarLeaves.map((child) => [child.type, child.title])).toEqual([["page", "Loose"]]);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.landingPage.test.js.map

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

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

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

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

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

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