@fern-api/fdr-sdk 1.2.45-932269c163 → 1.2.46-282936abd4

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

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

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

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

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

@@ -0,0 +1,227 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder";
+/**
+ * Regression test: unversioned sites with tabs + landing page.
+ *
+ * The V1 (legacy) path computes root.pointsTo via followRedirect(child), which
+ * visits unversioned.landingPage before unversioned.child (V1 followRedirect.ts:38):
+ *
+ *   unversioned: (node) => followRedirect(node.landingPage ?? node.child)
+ *
+ * The V2 (latest) followRedirect does the same via getChildren, which returns
+ * [landingPage, child] for unversioned nodes (getChildren.ts:38-39).
+ *
+ * The ledger builder (buildFullRootFromSegments) bypasses both V1 and the
+ * V1→V2 migrator: it builds V2 nodes directly. Before the fix, it seeded
+ * root.pointsTo from the first tab's metadata.pointsTo — ignoring the landing
+ * page entirely. Then mutableUpdatePointsTo preserved this incorrect value
+ * because the target slug existed in the tree.
+ *
+ * This test reproduces the exact topology of the reported site: an unversioned
+ * site with two tabs and a landing page at /welcome. It exercises:
+ *
+ *   1. The seed value from buildFullRootFromSegments
+ *   2. mutableUpdatePointsTo preserving the seed
+ *   3. findNode("") returning a redirect to the landing page
+ */
+function tabSegment(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section,
+        locale: "en",
+        sortOrder: opts.sortOrder ?? 0,
+        hidden: false,
+        metadata: { type: "section", title: opts.section || "Root" },
+        product: null,
+        version: null,
+        variant: null,
+        tab: {
+            id: `tab:${opts.tabSlug}`,
+            displayName: opts.tabSlug,
+            icon: null,
+            sortOrder: opts.sortOrder ?? 0,
+            hidden: false,
+            viewers: [],
+            orphaned: false,
+            featureFlags: [],
+            metadata: {
+                slug: opts.tabSlug,
+                tab_type: "tab",
+                ...(opts.tabPointsTo != null ? { pointsTo: opts.tabPointsTo } : {})
+            }
+        }
+    };
+}
+function markdownRoute(fullPath, title, pageId) {
+    return {
+        type: "markdown",
+        fullPath,
+        hidden: false,
+        displaySortOrder: 0,
+        metadata: { title, pageId }
+    };
+}
+/**
+ * Builds a root node mimicking the reported site: unversioned, two tabs
+ * ("docs" → /docs/start/about, "api-ref" → /api-ref/functions), plus a
+ * landing page at /welcome.
+ */
+function buildTabbedSiteWithLandingPage() {
+    return buildFullRootFromSegments({
+        basePath: "",
+        title: "Tabbed Site With Landing Page",
+        segments: [
+            {
+                segmentId: "seg-landing",
+                segmentHash: "seg-landing",
+                section: "",
+                locale: "en",
+                sortOrder: 0,
+                hidden: false,
+                metadata: { type: "tabRoot", landingPage: true },
+                product: null,
+                version: null,
+                variant: null,
+                tab: null
+            },
+            tabSegment({
+                segmentHash: "seg-tab-docs",
+                section: "start",
+                tabSlug: "docs",
+                tabPointsTo: "docs/start/about",
+                sortOrder: 1
+            }),
+            tabSegment({
+                segmentHash: "seg-tab-api",
+                section: "functions",
+                tabSlug: "api-ref",
+                tabPointsTo: "api-ref/functions",
+                sortOrder: 2
+            })
+        ],
+        navBySegment: new Map([
+            ["seg-landing", [markdownRoute("welcome", "Welcome", "welcome-page")]],
+            ["seg-tab-docs", [markdownRoute("docs/start/about", "About", "about-page")]],
+            ["seg-tab-api", [markdownRoute("api-ref/functions", "Functions", "functions-page")]]
+        ])
+    });
+}
+describe("ledger landing-page redirect regression (ledger vs. legacy parity)", () => {
+    it("seeds root.pointsTo to the landing page, not the first tab", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        expect(root.child.type).toBe("unversioned");
+        if (root.child.type !== "unversioned") {
+            throw new Error("expected unversioned");
+        }
+        expect(root.child.landingPage).toBeDefined();
+        expect(root.child.landingPage?.slug).toBe("welcome");
+        // The ledger builder should seed root.pointsTo to the landing page —
+        // matching the V1 legacy behavior (V1 followRedirect visits
+        // node.landingPage before node.child).
+        expect(root.pointsTo).toBe("welcome");
+        // Regression guard: the OLD (broken) seed was the first tab's pointsTo.
+        expect(root.pointsTo).not.toBe("docs/start/about");
+    });
+    it("mutableUpdatePointsTo preserves the landing page as root.pointsTo", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        // Before update: seed is correct.
+        expect(root.pointsTo).toBe("welcome");
+        // After update: root.pointsTo should remain "welcome" because the
+        // landing page node is present in the slug map.
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        expect(root.pointsTo).toBe("welcome");
+    });
+    it("findNode('') returns redirect to landing page, not first tab page", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        // The root URL should redirect to the landing page.
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("welcome");
+        }
+    });
+    it("findNode('welcome') resolves the landing page as a found node", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug("welcome"));
+        expect(result.type).toBe("found");
+        if (result.type === "found") {
+            expect(result.node.type).toBe("landingPage");
+            expect(result.node.slug).toBe("welcome");
+        }
+    });
+    it("findNode still resolves tab pages normally", () => {
+        const root = buildTabbedSiteWithLandingPage();
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        const docs = FernNavigation.utils.findNode(root, FernNavigation.Slug("docs/start/about"));
+        expect(docs.type).toBe("found");
+        if (docs.type === "found") {
+            expect(docs.node.slug).toBe("docs/start/about");
+        }
+        const api = FernNavigation.utils.findNode(root, FernNavigation.Slug("api-ref/functions"));
+        expect(api.type).toBe("found");
+        if (api.type === "found") {
+            expect(api.node.slug).toBe("api-ref/functions");
+        }
+    });
+    it("without a landing page, root falls back to first tab's pointsTo", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Tabbed Site Without Landing Page",
+            segments: [
+                tabSegment({
+                    segmentHash: "seg-tab-docs",
+                    section: "start",
+                    tabSlug: "docs",
+                    tabPointsTo: "docs/start/about",
+                    sortOrder: 0
+                }),
+                tabSegment({
+                    segmentHash: "seg-tab-api",
+                    section: "functions",
+                    tabSlug: "api-ref",
+                    tabPointsTo: "api-ref/functions",
+                    sortOrder: 1
+                })
+            ],
+            navBySegment: new Map([
+                ["seg-tab-docs", [markdownRoute("docs/start/about", "About", "about-page")]],
+                ["seg-tab-api", [markdownRoute("api-ref/functions", "Functions", "functions-page")]]
+            ])
+        });
+        // No landing page → falls back to first tab's metadata.pointsTo.
+        expect(root.pointsTo).toBe("docs/start/about");
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        expect(root.pointsTo).toBe("docs/start/about");
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("docs/start/about");
+        }
+    });
+    it("demonstrates the pre-fix bug: manually seeding root.pointsTo to a tab page bypasses the landing page", () => {
+        // This test proves the regression existed. If root.pointsTo is
+        // incorrectly seeded (as the old code did), the landing page is
+        // unreachable from the root URL.
+        const root = buildTabbedSiteWithLandingPage();
+        // Simulate the OLD (broken) ledger behavior: seed root.pointsTo from
+        // the first tab's metadata instead of the landing page.
+        root.pointsTo = FernNavigation.Slug("docs/start/about");
+        // mutableUpdatePointsTo preserves the broken seed because the slug
+        // exists in the tree — it never re-derives from followRedirect.
+        FernNavigation.utils.mutableUpdatePointsTo(root);
+        expect(root.pointsTo).toBe("docs/start/about");
+        // findNode("") follows the broken redirect → wrong page.
+        const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(""));
+        expect(result.type).toBe("redirect");
+        if (result.type === "redirect") {
+            expect(result.redirect).toBe("docs/start/about");
+            // This is the bug: the user expected "welcome" but got a tab page.
+            expect(result.redirect).not.toBe("welcome");
+        }
+    });
+});
+//# sourceMappingURL=ledger-root-builder.landingPageRedirect.test.js.map

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

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

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

@@ -92,7 +92,65 @@ describe("buildFullRootFromSegments — unversioned root.pointsTo", () => {
         });
         expect(root.pointsTo).toBe("visible/intro");
     });
-    it("seeds root.pointsTo from the first tab's metadata (unversioned with tabs)", () => {
+    it("seeds root.pointsTo from landing page slug when tabbed site has a landing page", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Tabbed Site With Landing",
+            segments: [
+                // Landing page segment (type: tabRoot with landingPage: true)
+                {
+                    segmentId: "seg-landing",
+                    segmentHash: "seg-landing",
+                    section: "",
+                    locale: "en",
+                    sortOrder: 0,
+                    hidden: false,
+                    metadata: { type: "tabRoot", landingPage: true },
+                    product: null,
+                    version: null,
+                    variant: null,
+                    tab: null
+                },
+                tabSegment({
+                    segmentHash: "seg-tab1",
+                    section: "start",
+                    tabSlug: "docs",
+                    tabPointsTo: "docs/start/about",
+                    sortOrder: 1
+                }),
+                tabSegment({
+                    segmentHash: "seg-tab2",
+                    section: "functions",
+                    tabSlug: "api-ref",
+                    tabPointsTo: "api-ref/functions",
+                    sortOrder: 2
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-landing",
+                    [
+                        {
+                            type: "markdown",
+                            fullPath: "welcome",
+                            hidden: false,
+                            displaySortOrder: 0,
+                            metadata: { title: "Welcome", pageId: "welcome-page" }
+                        }
+                    ]
+                ]
+            ])
+        });
+        expect(root.child.type).toBe("unversioned");
+        if (root.child.type !== "unversioned") {
+            throw new Error("expected unversioned root child");
+        }
+        expect(root.child.landingPage).toBeDefined();
+        expect(root.child.landingPage?.slug).toBe("welcome");
+        // Root should redirect to the landing page, not the first tab
+        expect(root.pointsTo).toBe("welcome");
+    });
+    it("falls back to first tab's metadata when no landing page exists (unversioned with tabs)", () => {
         const root = buildFullRootFromSegments({
             basePath: "",
             title: "Tabbed Site",

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

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

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

@@ -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;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;AAoRD;;;;;;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;AAibD;;;;;;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;AAyzBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAmF5F"}
+{"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;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;AAoRD;;;;;;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;AAwbD;;;;;;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;AA4zBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CA0F5F"}

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

@@ -623,7 +623,10 @@ function mergeChildrenByPosition(ctx, nav, sectionChildren) {
 function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav) ?? overviewRouteFromSegmentMeta(seg, nav);
-    const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : undefined;
+    // Only set overviewPageId from explicit segment metadata, matching v2
+    // where overviewPageId comes directly from the config. The isOverview
+    // flag discovered by overviewRoute() is still used for slug/noindex.
+    const overviewPageId = metaStr(seg.metadata, "overviewPageId");
     // Strip the leading scope prefix to prevent double-prefixing when the
     // section path already includes the scope (e.g. section="2026-02-09"
     // with scopePrefix="2026-02-09" would produce "2026-02-09/2026-02-09").
@@ -647,7 +650,6 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
             }
         }
     }
-    const metaPointsTo = metaStr(seg.metadata, "pointsTo");
     const defaults = withMetadataDefaults({
         id: ctx.nodeId(`section:${slug}`),
         title: metaStr(seg.metadata, "title") ?? "",
@@ -668,7 +670,10 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
         collapsible: metaBool(seg.metadata, "collapsible") ?? (metaCollapsed(seg.metadata) === true ? true : undefined),
         collapsedByDefault: metaBool(seg.metadata, "collapsedByDefault") ?? (metaCollapsed(seg.metadata) === true ? true : undefined),
         availability: metaAvailability(seg.metadata),
-        pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : undefined,
+        // Don't read pointsTo from metadata for sections; let
+        // mutableUpdatePointsTo compute it via followRedirect so that
+        // self-referencing redirects are cleared, matching v2 behavior.
+        pointsTo: undefined,
         children: mergeChildrenByPosition(ctx, nav, sectionChildren)
     };
 }
@@ -764,12 +769,13 @@ function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix)
 function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav);
-    const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : undefined;
+    // Only set overviewPageId from explicit segment metadata, matching v2
+    // where overviewPageId comes directly from the config.
+    const overviewPageId = metaStr(seg.metadata, "overviewPageId");
     const apiDefinitionId = metaStr(seg.metadata, "apiDefinitionId") ?? parentApiDefinitionId;
     // Use structuralNodeSlug so the package gets its own slug (matching V2)
     // rather than inheriting the first endpoint's path.
     const slug = structuralNodeSlug(ctx, overview?.fullPath, stripLeadingScopePrefix(seg.section, scopePrefix), scopePrefix);
-    const metaPointsTo = metaStr(seg.metadata, "pointsTo");
     const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix);
     return {
         type: "apiPackage",
@@ -788,7 +794,9 @@ function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scop
         availability: metaAvailability(seg.metadata),
         overviewPageId: overviewPageId != null ? FernNavigation.PageId(overviewPageId) : undefined,
         noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
-        pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : undefined,
+        // Don't read pointsTo from metadata; let mutableUpdatePointsTo
+        // compute it via followRedirect, matching v2 behavior.
+        pointsTo: undefined,
         children,
         playground: undefined
     };
@@ -867,7 +875,9 @@ export function mergeEndpointPairs(ctx, leafNodes, allNav) {
 function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav);
-    const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : undefined;
+    // Only set overviewPageId from explicit segment metadata, matching v2
+    // where overviewPageId comes directly from the config.
+    const overviewPageId = metaStr(seg.metadata, "overviewPageId");
     const apiDefinitionId = metaStr(seg.metadata, "apiDefinitionId") ?? "";
     // Slug: prefer the overview route, else a structural slug rooted at the
     // enclosing scope (so the subtree stays inside the default-version prune
@@ -878,7 +888,6 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
     // mutableUpdatePointsTo clears pointsTo (slug === redirect target),
     // breaking the breadcrumb link.
     const slug = structuralNodeSlug(ctx, overview?.fullPath, stripLeadingScopePrefix(seg.section, scopePrefix), scopePrefix);
-    const metaPointsTo = metaStr(seg.metadata, "pointsTo");
     const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix);
     const changelog = attachedApiChangelogNode(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix);
     return {
@@ -901,7 +910,9 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
         paginated: metaBool(seg.metadata, "paginated"),
         showErrors: metaBool(seg.metadata, "showErrors"),
         hideTitle: metaBool(seg.metadata, "hideTitle"),
-        pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : undefined,
+        // Don't read pointsTo from metadata; let mutableUpdatePointsTo
+        // compute it via followRedirect, matching v2 behavior.
+        pointsTo: undefined,
         children,
         changelog,
         playground: undefined,
@@ -1616,17 +1627,26 @@ export function buildFullRootFromSegments(options) {
     // on structure-only roots where the traversal is intentionally skipped.
     let rootPointsTo;
     if (child.type === "productgroup") {
-        const defaultProduct = child.children.find((p) => p.default) ?? child.children[0];
-        rootPointsTo = defaultProduct?.type === "product" ? defaultProduct.pointsTo : undefined;
+        if (child.landingPage != null && !child.landingPage.hidden) {
+            rootPointsTo = child.landingPage.slug;
+        }
+        else {
+            const defaultProduct = child.children.find((p) => p.default) ?? child.children[0];
+            rootPointsTo = defaultProduct?.type === "product" ? defaultProduct.pointsTo : undefined;
+        }
     }
     else if (child.type === "versioned") {
         const defaultVersion = child.children.find((v) => v.default) ?? child.children[0];
         rootPointsTo = defaultVersion?.pointsTo;
     }
     else if (child.type === "unversioned") {
-        // Unversioned sites have no product/version metadata to seed pointsTo.
-        // Derive from the first tab's or first section segment's metadata.
-        if (tabs.length > 0) {
+        // Landing pages take priority: when the unversioned child has a
+        // visible landing page the root should redirect there, not to the
+        // first tab's content page.
+        if (child.landingPage != null && !child.landingPage.hidden) {
+            rootPointsTo = child.landingPage.slug;
+        }
+        else if (tabs.length > 0) {
             const firstTab = tabs[0];
             const pt = firstTab != null ? metaStr(firstTab.metadata, "pointsTo") : undefined;
             rootPointsTo = pt != null ? pointsToSlug(pt) : undefined;