@fern-api/fdr-sdk 1.2.46-c24af8d81b → 1.2.47-644c48eaef

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

@@ -0,0 +1,408 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+function detail(opts) {
+    return {
+        id: opts.id,
+        displayName: opts.name,
+        icon: null,
+        sortOrder: 0,
+        hidden: false,
+        viewers: [],
+        orphaned: false,
+        featureFlags: [],
+        metadata: { slug: opts.slug, default: opts.isDefault ?? false, pointsTo: opts.pointsTo }
+    };
+}
+function seg(opts) {
+    return {
+        segmentId: opts.segmentHash,
+        segmentHash: opts.segmentHash,
+        section: opts.section ?? "",
+        locale: "en",
+        sortOrder: 0,
+        hidden: false,
+        metadata: opts.metadata ?? { type: "section" },
+        product: null,
+        version: opts.version ?? null,
+        variant: null,
+        tab: null
+    };
+}
+function epRoute(opts) {
+    return {
+        type: "rest",
+        fullPath: opts.fullPath,
+        stream: null,
+        hidden: false,
+        metadata: {
+            title: opts.title,
+            endpointId: opts.endpointId,
+            method: opts.method,
+            apiDefinitionId: opts.apiDefinitionId,
+            isResponseStream: false
+        }
+    };
+}
+function mdRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        metadata: { title: opts.title, pageId: opts.pageId }
+    };
+}
+function findCanonicalSlug(root, slug) {
+    const result = FernNavigation.utils.findNode(root, FernNavigation.Slug(slug));
+    if (result.type === "found") {
+        return result.node.canonicalSlug;
+    }
+    return undefined;
+}
+describe("buildFullRootFromSegments - within-version canonical slug deduplication", () => {
+    it("deduplicates same endpoint appearing under two sections (unversioned)", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({
+                    segmentHash: "seg-content",
+                    section: "content/redirects",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-store" }
+                }),
+                seg({
+                    segmentHash: "seg-mgmt",
+                    section: "management/redirects",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-store" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-content",
+                    [
+                        epRoute({
+                            fullPath: "content/redirects/delete-redirect",
+                            title: "Delete Redirect",
+                            endpointId: "delete-redirect",
+                            method: "DELETE",
+                            apiDefinitionId: "api-store"
+                        }),
+                        epRoute({
+                            fullPath: "content/redirects/create-redirect",
+                            title: "Create Redirect",
+                            endpointId: "create-redirect",
+                            method: "POST",
+                            apiDefinitionId: "api-store"
+                        })
+                    ]
+                ],
+                [
+                    "seg-mgmt",
+                    [
+                        epRoute({
+                            fullPath: "management/redirects/delete-redirect",
+                            title: "Delete Redirect",
+                            endpointId: "delete-redirect",
+                            method: "DELETE",
+                            apiDefinitionId: "api-store"
+                        }),
+                        epRoute({
+                            fullPath: "management/redirects/create-redirect",
+                            title: "Create Redirect",
+                            endpointId: "create-redirect",
+                            method: "POST",
+                            apiDefinitionId: "api-store"
+                        })
+                    ]
+                ]
+            ])
+        });
+        // First occurrence (content section): no canonicalSlug
+        expect(findCanonicalSlug(root, "content/redirects/delete-redirect")).toBeUndefined();
+        expect(findCanonicalSlug(root, "content/redirects/create-redirect")).toBeUndefined();
+        // Second occurrence (management section): canonicalSlug points to first
+        expect(findCanonicalSlug(root, "management/redirects/delete-redirect")).toBe("content/redirects/delete-redirect");
+        expect(findCanonicalSlug(root, "management/redirects/create-redirect")).toBe("content/redirects/create-redirect");
+    });
+    it("deduplicates same endpoint across three sections", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({
+                    segmentHash: "seg-a",
+                    section: "section-a",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-1" }
+                }),
+                seg({
+                    segmentHash: "seg-b",
+                    section: "section-b",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-1" }
+                }),
+                seg({
+                    segmentHash: "seg-c",
+                    section: "section-c",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-1" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-a",
+                    [
+                        epRoute({
+                            fullPath: "section-a/list-items",
+                            title: "List Items",
+                            endpointId: "list-items",
+                            method: "GET",
+                            apiDefinitionId: "api-1"
+                        })
+                    ]
+                ],
+                [
+                    "seg-b",
+                    [
+                        epRoute({
+                            fullPath: "section-b/list-items",
+                            title: "List Items",
+                            endpointId: "list-items",
+                            method: "GET",
+                            apiDefinitionId: "api-1"
+                        })
+                    ]
+                ],
+                [
+                    "seg-c",
+                    [
+                        epRoute({
+                            fullPath: "section-c/list-items",
+                            title: "List Items",
+                            endpointId: "list-items",
+                            method: "GET",
+                            apiDefinitionId: "api-1"
+                        })
+                    ]
+                ]
+            ])
+        });
+        // First: canonical
+        expect(findCanonicalSlug(root, "section-a/list-items")).toBeUndefined();
+        // Second and third: point to first
+        expect(findCanonicalSlug(root, "section-b/list-items")).toBe("section-a/list-items");
+        expect(findCanonicalSlug(root, "section-c/list-items")).toBe("section-a/list-items");
+    });
+    it("does NOT deduplicate different endpoints in same section", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({
+                    segmentHash: "seg-api",
+                    section: "api-ref",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-1" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-api",
+                    [
+                        epRoute({
+                            fullPath: "api-ref/list-items",
+                            title: "List Items",
+                            endpointId: "list-items",
+                            method: "GET",
+                            apiDefinitionId: "api-1"
+                        }),
+                        epRoute({
+                            fullPath: "api-ref/create-item",
+                            title: "Create Item",
+                            endpointId: "create-item",
+                            method: "POST",
+                            apiDefinitionId: "api-1"
+                        })
+                    ]
+                ]
+            ])
+        });
+        expect(findCanonicalSlug(root, "api-ref/list-items")).toBeUndefined();
+        expect(findCanonicalSlug(root, "api-ref/create-item")).toBeUndefined();
+    });
+    it("deduplicates markdown pages with same pageId across sections", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({ segmentHash: "seg-guides", section: "guides" }),
+                seg({ segmentHash: "seg-reference", section: "reference" })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-guides",
+                    [mdRoute({ fullPath: "guides/auth", title: "Authentication", pageId: "pg-auth" })]
+                ],
+                [
+                    "seg-reference",
+                    [mdRoute({ fullPath: "reference/auth", title: "Authentication", pageId: "pg-auth" })]
+                ]
+            ])
+        });
+        expect(findCanonicalSlug(root, "guides/auth")).toBeUndefined();
+        expect(findCanonicalSlug(root, "reference/auth")).toBe("guides/auth");
+    });
+    it("does NOT deduplicate markdown pages with different pageIds and different titles", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({ segmentHash: "seg-guides", section: "guides", metadata: { type: "section", title: "Guides" } }),
+                seg({
+                    segmentHash: "seg-reference",
+                    section: "reference",
+                    metadata: { type: "section", title: "Reference" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-guides",
+                    [mdRoute({ fullPath: "guides/auth", title: "Auth Guide", pageId: "pg-auth-1" })]
+                ],
+                [
+                    "seg-reference",
+                    [mdRoute({ fullPath: "reference/auth", title: "Auth Reference", pageId: "pg-auth-2" })]
+                ]
+            ])
+        });
+        expect(findCanonicalSlug(root, "guides/auth")).toBeUndefined();
+        expect(findCanonicalSlug(root, "reference/auth")).toBeUndefined();
+    });
+    it("deduplicates within versioned site (default version)", () => {
+        const defaultVersion = detail({
+            id: "v-default",
+            name: "v1",
+            slug: "v1",
+            isDefault: true,
+            pointsTo: "v1/section-a/list-items"
+        });
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({
+                    segmentHash: "seg-a",
+                    version: defaultVersion,
+                    section: "v1/section-a",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-1" }
+                }),
+                seg({
+                    segmentHash: "seg-b",
+                    version: defaultVersion,
+                    section: "v1/section-b",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-1" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-a",
+                    [
+                        epRoute({
+                            fullPath: "v1/section-a/list-items",
+                            title: "List Items",
+                            endpointId: "list-items",
+                            method: "GET",
+                            apiDefinitionId: "api-1"
+                        })
+                    ]
+                ],
+                [
+                    "seg-b",
+                    [
+                        epRoute({
+                            fullPath: "v1/section-b/list-items",
+                            title: "List Items",
+                            endpointId: "list-items",
+                            method: "GET",
+                            apiDefinitionId: "api-1"
+                        })
+                    ]
+                ]
+            ])
+        });
+        // For a default version, markDefaultVersionCanonicalSlugs strips
+        // the version prefix from ALL nodes' slugs, so every node gets a
+        // canonicalSlug (even the first occurrence — it becomes self-canonical
+        // at the pruned slug). Within-scope dedup then makes the second
+        // occurrence point to the first occurrence's pruned slug.
+        // After default-version slug elision, both nodes have canonicalSlug
+        // set to the first occurrence's pruned slug.
+        const slugA = findCanonicalSlug(root, "section-a/list-items");
+        const slugB = findCanonicalSlug(root, "section-b/list-items");
+        // Both point to the first occurrence's pruned slug (version prefix stripped).
+        // Node A is self-canonical (version elision), Node B is deduped to A.
+        expect(slugA).toBe("section-a/list-items");
+        expect(slugB).toBe("section-a/list-items");
+    });
+    it("leaves unique endpoints untouched when duplicates are deduped", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                seg({
+                    segmentHash: "seg-content",
+                    section: "content",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-store" }
+                }),
+                seg({
+                    segmentHash: "seg-mgmt",
+                    section: "management",
+                    metadata: { type: "apiReference", apiDefinitionId: "api-store" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-content",
+                    [
+                        epRoute({
+                            fullPath: "content/delete-redirect",
+                            title: "Delete Redirect",
+                            endpointId: "delete-redirect",
+                            method: "DELETE",
+                            apiDefinitionId: "api-store"
+                        }),
+                        epRoute({
+                            fullPath: "content/list-pages",
+                            title: "List Pages",
+                            endpointId: "list-pages",
+                            method: "GET",
+                            apiDefinitionId: "api-store"
+                        })
+                    ]
+                ],
+                [
+                    "seg-mgmt",
+                    [
+                        epRoute({
+                            fullPath: "management/delete-redirect",
+                            title: "Delete Redirect",
+                            endpointId: "delete-redirect",
+                            method: "DELETE",
+                            apiDefinitionId: "api-store"
+                        }),
+                        epRoute({
+                            fullPath: "management/list-scripts",
+                            title: "List Scripts",
+                            endpointId: "list-scripts",
+                            method: "GET",
+                            apiDefinitionId: "api-store"
+                        })
+                    ]
+                ]
+            ])
+        });
+        // Shared endpoint: second occurrence points to first
+        expect(findCanonicalSlug(root, "content/delete-redirect")).toBeUndefined();
+        expect(findCanonicalSlug(root, "management/delete-redirect")).toBe("content/delete-redirect");
+        // Unique endpoints: untouched
+        expect(findCanonicalSlug(root, "content/list-pages")).toBeUndefined();
+        expect(findCanonicalSlug(root, "management/list-scripts")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=ledger-root-builder.withinVersionDedup.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.withinVersionDedup.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.withinVersionDedup.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;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"}
+{"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;AA0bD;;;;;;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,10 +623,12 @@ function mergeChildrenByPosition(ctx, nav, sectionChildren) {
 function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav) ?? overviewRouteFromSegmentMeta(seg, nav);
-    // 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");
+    // Prefer the overview page's actual pageId (which is what V1/V2 use
+    // for content-ID dedup), falling back to the segment metadata's
+    // overviewPageId. The two can diverge when the publisher writes a
+    // section-specific overviewPageId that differs from the page content
+    // ID, breaking cross-section canonical-slug dedup.
+    const overviewPageId = metaStr(overview?.metadata, "pageId") ?? 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").
@@ -769,9 +771,9 @@ function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId, scopePrefix)
 function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav);
-    // Only set overviewPageId from explicit segment metadata, matching v2
-    // where overviewPageId comes directly from the config.
-    const overviewPageId = metaStr(seg.metadata, "overviewPageId");
+    // Prefer the overview page's actual pageId for content-ID dedup,
+    // falling back to segment metadata's overviewPageId (see sectionNode).
+    const overviewPageId = metaStr(overview?.metadata, "pageId") ?? 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.
@@ -875,9 +877,9 @@ export function mergeEndpointPairs(ctx, leafNodes, allNav) {
 function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
     const { seg, nav } = scoped;
     const overview = overviewRoute(nav);
-    // Only set overviewPageId from explicit segment metadata, matching v2
-    // where overviewPageId comes directly from the config.
-    const overviewPageId = metaStr(seg.metadata, "overviewPageId");
+    // Prefer the overview page's actual pageId for content-ID dedup,
+    // falling back to segment metadata's overviewPageId (see sectionNode).
+    const overviewPageId = metaStr(overview?.metadata, "pageId") ?? 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
@@ -1916,7 +1918,7 @@ function buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent, scopePrefix) {
 }
 function buildUnversioned(ctx, scopeSegs, scopePrefix, tabsPresent) {
     const first = scopeSegs[0];
-    return {
+    const node = {
         type: "unversioned",
         id: ctx.nodeId(`unversioned:${first?.seg.product?.id ?? "root"}`),
         collapsed: undefined,
@@ -1926,6 +1928,10 @@ function buildUnversioned(ctx, scopeSegs, scopePrefix, tabsPresent) {
         // namespace.
         child: buildTabbedOrSidebar(ctx, scopeSegs, tabsPresent, scopePrefix)
     };
+    // Within-scope dedup for unversioned sites: collapse duplicate pages
+    // that appear under multiple parent sections.
+    markWithinScopeCanonicalSlugs(node);
+    return node;
 }
 /**
  * Merge shared (tab-level) sections from sibling versions into the default
@@ -2060,6 +2066,11 @@ function buildVersioned(ctx, versions, scoped, rootSlug, productPrefix, skipShar
             // version subtree stays inside the default-version prune window.
             child: buildTabbedOrSidebar(ctx, versionSegs, tabsPresent, asSlug(slug))
         };
+        // Within-version dedup: collapse duplicate pages that appear
+        // under multiple parent sections (same endpointId, pageId, etc.).
+        // Must run BEFORE markDefaultVersionCanonicalSlugs so the canonical
+        // slug is transformed along with the rest of the version's slugs.
+        markWithinScopeCanonicalSlugs(node);
         if (node.default) {
             markDefaultVersionCanonicalSlugs(node, productPrefix != null ? asSlug(productPrefix) : rootSlug, node.slug);
         }
@@ -2193,6 +2204,50 @@ function buildLandingPage(ctx, scopeSegs) {
     const landingSegment = scopeSegs.find((s) => metaStr(s.seg.metadata, "type") === "tabRoot" && metaBool(s.seg.metadata, "landingPage") === true);
     return routeToLandingPage(ctx, landingSegment?.nav.find((route) => route.type === "markdown"));
 }
+/**
+ * Within a single version (or unversioned scope), deduplicate pages that
+ * share the same content-identity key (endpointId, pageId, etc.).
+ * The first occurrence in DFS order becomes canonical; subsequent
+ * occurrences get `canonicalSlug` pointing to the first.
+ *
+ * This mirrors V2's global `#canonicalSlugs` map in v1ToV2.ts, which
+ * deduplicates endpoints appearing under multiple parent sections within
+ * the same version (e.g. the same endpoint under both
+ * `content/store-content/redirects/` and `management/redirects/`).
+ */
+function markWithinScopeCanonicalSlugs(scopeNode) {
+    const keyToCanonical = new Map();
+    FernNavigation.traverseDF(scopeNode, (child, parents) => {
+        if (FernNavigation.hasMetadata(child) && FernNavigation.isPage(child)) {
+            const keys = crossVersionDedupKeys(child, parents);
+            let matched = false;
+            for (const key of keys) {
+                const canonical = keyToCanonical.get(key);
+                if (canonical != null && canonical !== child.slug) {
+                    // Skip dedup when the canonical slug is a proper ancestor
+                    // of the child's slug AND the child has children of its own
+                    // (it's a container like apiPackage with endpoints, not a
+                    // leaf-level landing page). Container nodes at different URL
+                    // depths are separate sitemap entries, not duplicates.
+                    if (child.slug.startsWith(canonical + "/") && FernNavigation.getChildren(child).length > 0) {
+                        continue;
+                    }
+                    child.canonicalSlug = canonical;
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                const slug = child.canonicalSlug ?? child.slug;
+                for (const key of keys) {
+                    if (!keyToCanonical.has(key)) {
+                        keyToCanonical.set(key, slug);
+                    }
+                }
+            }
+        }
+    });
+}
 /**
  * After default-version canonical slugs are marked, propagate them across
  * ALL versions using a global first-come-first-served approach (matching V2).
@@ -2220,6 +2275,12 @@ function markCrossVersionCanonicalSlugs(versionNodes) {
                 for (const key of keys) {
                     const canonical = keyToCanonical.get(key);
                     if (canonical != null && !version.default) {
+                        // Skip dedup when the canonical slug is a proper ancestor
+                        // of the child's slug AND the child has children (container
+                        // nodes at different URL depths, not duplicates).
+                        if (child.slug.startsWith(canonical + "/") && FernNavigation.getChildren(child).length > 0) {
+                            continue;
+                        }
                         child.canonicalSlug = canonical;
                         matched = true;
                         break;
@@ -2320,12 +2381,15 @@ function markCrossProductCanonicalSlugs(productNodes) {
                     return;
                 }
                 const key = `pid:${pid}`;
-                const canonical = pageIdToCanonical.get(key);
-                if (canonical != null && !product.default) {
-                    child.canonicalSlug = canonical;
+                const entry = pageIdToCanonical.get(key);
+                if (entry != null && !product.default && entry.productId !== product.productId) {
+                    child.canonicalSlug = entry.slug;
                 }
-                else if (canonical == null) {
-                    pageIdToCanonical.set(key, child.canonicalSlug ?? child.slug);
+                else if (entry == null) {
+                    pageIdToCanonical.set(key, {
+                        slug: child.canonicalSlug ?? child.slug,
+                        productId: product.productId
+                    });
                 }
             }
         });