@fern-api/fdr-sdk 1.2.39-7803ef9da9 → 1.2.39-95d268d05b

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

@@ -0,0 +1,267 @@
+import { describe, expect, it } from "vitest";
+import * as FernNavigation from "../index.js";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+/**
+ * Minimal `SegmentDetail`-shaped helper (pointer wire shape). Only the fields
+ * the builder reads are populated. `metadata.slug` is basepath-RELATIVE (the
+ * bare segment, e.g. `astro/cli`, `v-1-42`); `metadata.pointsTo` is
+ * basepath-ABSOLUTE. This mirrors the real ledger pointer.
+ */
+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 }
+    };
+}
+/**
+ * Build a single-page versioned product scope and collect the reconstructed
+ * nav slugMap. `fullPath` is basepath-RELATIVE (the nav wire shape — the
+ * builder re-prepends the basepath via `contentSlug`).
+ */
+function slugMapFor(opts) {
+    const segHash = "seg-1";
+    const seg = {
+        segmentId: segHash,
+        segmentHash: segHash,
+        section: "",
+        locale: "en",
+        sortOrder: 0,
+        hidden: false,
+        metadata: { type: "section" },
+        product: detail({
+            id: `p-${opts.productSlug}`,
+            name: opts.productSlug,
+            slug: opts.productSlug,
+            isDefault: opts.productDefault,
+            pointsTo: opts.pageFullPath
+        }),
+        version: detail({
+            id: `v-${opts.versionSlug}`,
+            name: opts.versionSlug,
+            slug: opts.versionSlug,
+            isDefault: opts.versionDefault,
+            pointsTo: opts.pageFullPath
+        }),
+        variant: null,
+        tab: null
+    };
+    const nav = {
+        type: "markdown",
+        fullPath: opts.pageFullPath,
+        hidden: false,
+        metadata: { title: "Overview", pageId: "pg-overview" }
+    };
+    const root = buildFullRootFromSegments({
+        basePath: opts.basePath,
+        title: "Astronomer",
+        segments: [seg],
+        navBySegment: new Map([[segHash, [nav]]])
+    });
+    const collector = FernNavigation.NodeCollector.collect(root);
+    return new Set(collector.slugMap.keys());
+}
+describe("buildFullRootFromSegments — default-version elision in the reconstructed slugMap (ADR-0014 #6)", () => {
+    // The READ half of #6: `findNode` gates on the reconstructed nav slugMap.
+    // `NodeCollector` produces the default-version-elided alias by passing the
+    // version node's `slug` to `toDefaultSlug`, which strips the version
+    // segment from each page slug. That only works if the default version node
+    // carries its FULL versioned slug (`{basepath}/{product}/{version}`). If it
+    // were collapsed to the product prefix, the elided clean URL would never
+    // enter the slugMap and would 404 with `page-not-in-nav`.
+    it("emits the default-version-elided clean slug on a basepath site", () => {
+        // astro/cli product (NOT default), default version v-1-42.
+        const slugs = slugMapFor({
+            basePath: "docs",
+            productSlug: "astro/cli",
+            versionSlug: "v-1-42",
+            versionDefault: true,
+            pageFullPath: "astro/cli/v-1-42/overview"
+        });
+        // The canonical versioned slug resolves.
+        expect(slugs.has("docs/astro/cli/v-1-42/overview")).toBe(true);
+        // The default-version-elided clean slug ALSO resolves (the #6 fix).
+        expect(slugs.has("docs/astro/cli/overview")).toBe(true);
+        // It is single-prefixed — never `docs/docs/...`.
+        expect([...slugs].some((s) => s.startsWith("docs/docs/"))).toBe(false);
+        // The version node itself is reachable both fully-qualified and elided.
+        expect(slugs.has("docs/astro/cli/v-1-42")).toBe(true);
+        expect(slugs.has("docs/astro/cli")).toBe(true);
+    });
+    it("treats the default-version-elided clean slug as canonical", () => {
+        const segHash = "seg-1";
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Astronomer",
+            segments: [
+                {
+                    segmentId: segHash,
+                    segmentHash: segHash,
+                    section: "",
+                    locale: "en",
+                    sortOrder: 0,
+                    hidden: false,
+                    metadata: { type: "tabRoot" },
+                    product: detail({
+                        id: "p-cli",
+                        name: "Astro CLI",
+                        slug: "astro/cli",
+                        pointsTo: "docs/astro/cli/v-1-42/overview"
+                    }),
+                    version: detail({
+                        id: "v-1-42",
+                        name: "1.42",
+                        slug: "v-1-42",
+                        isDefault: true,
+                        pointsTo: "docs/astro/cli/v-1-42/overview"
+                    }),
+                    variant: null,
+                    tab: null
+                }
+            ],
+            navBySegment: new Map([
+                [
+                    segHash,
+                    [
+                        {
+                            type: "markdown",
+                            fullPath: "astro/cli/v-1-42/overview",
+                            hidden: false,
+                            metadata: { title: "Overview", pageId: "pg-overview" }
+                        }
+                    ]
+                ]
+            ])
+        });
+        const found = FernNavigation.utils.findNode(root, FernNavigation.Slug("docs/astro/cli/overview"));
+        expect(found.type).toBe("found");
+        if (found.type === "found") {
+            expect(found.node.slug).toBe("docs/astro/cli/overview");
+            // With the legacy pruneVersionNode, canonicalSlug may be redundantly
+            // set to the same value as slug (harmless for indexablePageSlugs).
+            expect(found.node.canonicalSlug).toBe("docs/astro/cli/overview");
+        }
+        const explicit = FernNavigation.utils.findNode(root, FernNavigation.Slug("docs/astro/cli/v-1-42/overview"));
+        expect(explicit.type).toBe("found");
+        if (explicit.type === "found") {
+            expect(explicit.node.slug).toBe("docs/astro/cli/v-1-42/overview");
+            expect(explicit.node.canonicalSlug).toBe("docs/astro/cli/overview");
+        }
+    });
+    it("does NOT elide when the version is not default (basepath site)", () => {
+        const slugs = slugMapFor({
+            basePath: "docs",
+            productSlug: "astro/cli",
+            versionSlug: "v-1-41",
+            versionDefault: false,
+            pageFullPath: "astro/cli/v-1-41/overview"
+        });
+        expect(slugs.has("docs/astro/cli/v-1-41/overview")).toBe(true);
+        // No clean alias for a non-default version.
+        expect(slugs.has("docs/astro/cli/overview")).toBe(false);
+        // The version node carries its full versioned slug (regression: it must
+        // include the product prefix, not just `{basepath}/{version}`).
+        expect(slugs.has("docs/astro/cli/v-1-41")).toBe(true);
+        expect(slugs.has("docs/v-1-41")).toBe(false);
+    });
+    it("emits the elided slug on a root site (empty basepath)", () => {
+        const slugs = slugMapFor({
+            basePath: "",
+            productSlug: "astro/cli",
+            versionSlug: "v-1-42",
+            versionDefault: true,
+            pageFullPath: "astro/cli/v-1-42/overview"
+        });
+        expect(slugs.has("astro/cli/v-1-42/overview")).toBe(true);
+        expect(slugs.has("astro/cli/overview")).toBe(true);
+    });
+    // The deeper half of #6: a page nested under a STRUCTURAL section that has
+    // NO overview page of its own. The section node's slug must be rooted at the
+    // scope (`{basepath}/{product}/{version}/{section}`); if it were
+    // `{basepath}/{section}` (the old `contentSlug(seg.section)` fallback), it
+    // would not start with the version slug, so `pruneVersionNode` would SKIP
+    // the section and all its descendants — and the page's clean
+    // default-version alias would never enter the slugMap (404 page-not-in-nav).
+    it("elides pages nested under an overview-less structural section (basepath site)", () => {
+        // Two segments in the same default-version scope:
+        //   - the version's top-level page (`overview`, section "")
+        //   - a structural section `release-information` (no overview) holding a
+        //     `release-notes` page.
+        const productD = detail({
+            id: "p-cli",
+            name: "Astro CLI",
+            slug: "astro/cli",
+            pointsTo: "astro/cli/v-1-42/overview"
+        });
+        const versionD = detail({
+            id: "v-1-42",
+            name: "1.42",
+            slug: "v-1-42",
+            isDefault: true,
+            pointsTo: "astro/cli/v-1-42/overview"
+        });
+        const baseSeg = (segmentHash, section, type) => ({
+            segmentId: segmentHash,
+            segmentHash,
+            section,
+            locale: "en",
+            sortOrder: 0,
+            hidden: false,
+            metadata: { type },
+            product: productD,
+            version: versionD,
+            variant: null,
+            tab: null
+        });
+        const topSeg = baseSeg("seg-top", "", "tabRoot");
+        const sectionSeg = { ...baseSeg("seg-rel", "release-information", "section"), sortOrder: 1 };
+        const root = buildFullRootFromSegments({
+            basePath: "docs",
+            title: "Astronomer",
+            segments: [topSeg, sectionSeg],
+            navBySegment: new Map([
+                [
+                    "seg-top",
+                    [
+                        {
+                            type: "markdown",
+                            fullPath: "astro/cli/v-1-42/overview",
+                            hidden: false,
+                            metadata: { title: "Overview", pageId: "pg-overview" }
+                        }
+                    ]
+                ],
+                [
+                    "seg-rel",
+                    // NOTE: no `isOverview` route — this section is a pure
+                    // structural grouping with no own page.
+                    [
+                        {
+                            type: "markdown",
+                            fullPath: "astro/cli/v-1-42/release-notes",
+                            hidden: false,
+                            metadata: { title: "Release notes", pageId: "pg-release-notes" }
+                        }
+                    ]
+                ]
+            ])
+        });
+        const slugs = new Set(FernNavigation.NodeCollector.collect(root).slugMap.keys());
+        // Canonical versioned page resolves.
+        expect(slugs.has("docs/astro/cli/v-1-42/release-notes")).toBe(true);
+        // The nested page's default-version-elided clean slug ALSO resolves — the
+        // structural-section-slug half of the #6 fix.
+        expect(slugs.has("docs/astro/cli/release-notes")).toBe(true);
+        // And the top-level page still elides.
+        expect(slugs.has("docs/astro/cli/overview")).toBe(true);
+        // Single-prefixed throughout.
+        expect([...slugs].some((s) => s.startsWith("docs/docs/"))).toBe(false);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.defaultVersionElision.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,164 @@
+import { describe, expect, it } from "vitest";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+/**
+ * Reproduction for missing external links in variant sections.
+ *
+ * The smoke-test YAML defines two sections per variant:
+ *   - "Resources (Collapsed by default)" → 2 links, collapsed: true
+ *   - "Get Started (Open by default)" → 4 links (first 2 share URLs with Resources), collapsed: false
+ *
+ * V2 renders all 4 links from "Get Started". Ledger only renders the first 2.
+ * Additionally, the collapsed states are inverted on ledger.
+ */
+function linkRoute(opts) {
+    return {
+        type: "link",
+        fullPath: null,
+        hidden: false,
+        metadata: { title: opts.title, url: opts.url, icon: "fa-duotone fa-newspaper" },
+        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
+    };
+}
+function pageRoute(opts) {
+    return {
+        type: "markdown",
+        fullPath: opts.fullPath,
+        hidden: false,
+        metadata: { title: opts.title, pageId: `pg-${opts.title}` },
+        ...(opts.displaySortOrder != null ? { displaySortOrder: opts.displaySortOrder } : {})
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function collectByType(node, targetType) {
+    const results = [];
+    if (node == null || typeof node !== "object") {
+        return results;
+    }
+    if (node.type === targetType) {
+        results.push(node);
+    }
+    for (const child of node.children ?? []) {
+        results.push(...collectByType(child, targetType));
+    }
+    if (node.child != null) {
+        results.push(...collectByType(node.child, targetType));
+    }
+    return results;
+}
+describe("missing external links in variant sections", () => {
+    it("preserves all 4 links from Get Started section even when first 2 overlap Resources", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-variant-root",
+                    section: "",
+                    sortOrder: 0,
+                    metadata: { type: "tabRoot" }
+                }),
+                segment({
+                    segmentHash: "seg-resources",
+                    section: "resources-collapsed-by-default",
+                    sortOrder: 1,
+                    metadata: {
+                        type: "section",
+                        title: "Resources (Collapsed by default)",
+                        childIndex: 1,
+                        collapsed: true,
+                        collapsedByDefault: true
+                    }
+                }),
+                segment({
+                    segmentHash: "seg-get-started",
+                    section: "get-started-open-by-default",
+                    sortOrder: 2,
+                    metadata: {
+                        type: "section",
+                        title: "Get Started (Open by default)",
+                        childIndex: 2,
+                        collapsed: false,
+                        collapsedByDefault: false
+                    }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-variant-root",
+                    [pageRoute({ fullPath: "introduction", title: "Introduction", displaySortOrder: 0 })]
+                ],
+                [
+                    "seg-resources",
+                    [
+                        linkRoute({
+                            title: "Fern Overview",
+                            url: "https://buildwithfern.com/learn/docs/getting-started/overview",
+                            displaySortOrder: 0
+                        }),
+                        linkRoute({
+                            title: "Fern How it works",
+                            url: "https://buildwithfern.com/learn/docs/getting-started/how-it-works",
+                            displaySortOrder: 1
+                        })
+                    ]
+                ],
+                [
+                    "seg-get-started",
+                    [
+                        linkRoute({
+                            title: "Fern Overview",
+                            url: "https://buildwithfern.com/learn/docs/getting-started/overview",
+                            displaySortOrder: 0
+                        }),
+                        linkRoute({
+                            title: "Fern How it works",
+                            url: "https://buildwithfern.com/learn/docs/getting-started/how-it-works",
+                            displaySortOrder: 1
+                        }),
+                        linkRoute({
+                            title: "Fern Quickstart",
+                            url: "https://buildwithfern.com/learn/docs/getting-started/overview",
+                            displaySortOrder: 2
+                        }),
+                        linkRoute({
+                            title: "Fern Project Structure",
+                            url: "https://buildwithfern.com/learn/docs/getting-started/project-structure",
+                            displaySortOrder: 3
+                        })
+                    ]
+                ]
+            ])
+        });
+        const sections = collectByType(root, "section");
+        // Check Resources section
+        const resources = sections.find((s) => s.title === "Resources (Collapsed by default)");
+        expect(resources).toBeDefined();
+        const resourcesLinks = resources.children.filter((c) => c.type === "link");
+        expect(resourcesLinks).toHaveLength(2);
+        // Check Get Started section
+        const getStarted = sections.find((s) => s.title === "Get Started (Open by default)");
+        expect(getStarted).toBeDefined();
+        const linkChildren = getStarted.children.filter((c) => c.type === "link");
+        const linkTitles = linkChildren.map((l) => l.title);
+        // All 4 links must be present
+        expect(linkTitles).toEqual(["Fern Overview", "Fern How it works", "Fern Quickstart", "Fern Project Structure"]);
+        // Collapsed state must match YAML: Get Started should NOT be collapsed
+        expect(getStarted.collapsedByDefault).not.toBe(true);
+    });
+});
+//# sourceMappingURL=ledger-root-builder.linkRepro.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,72 @@
+import { describe, expect, it } from "vitest";
+import { FernNavigation } from "../../index.js";
+import { createBuildContext, mergeEndpointPairs } from "../ledger-root-builder.js";
+function makeEndpointNode(opts) {
+    return {
+        type: "endpoint",
+        id: FernNavigation.NodeId(`endpoint:${opts.endpointId}`),
+        title: "Search Plants Stream",
+        slug: FernNavigation.Slug(opts.slug),
+        canonicalSlug: undefined,
+        icon: undefined,
+        hidden: undefined,
+        authed: undefined,
+        collapsed: undefined,
+        playground: undefined,
+        apiDefinitionId: FernNavigation.ApiDefinitionId("api-def-1"),
+        availability: undefined,
+        method: "POST",
+        endpointId: FernNavigation.EndpointId(opts.endpointId),
+        isResponseStream: opts.isResponseStream ?? undefined,
+        viewers: undefined,
+        orphaned: undefined,
+        featureFlags: undefined
+    };
+}
+function makeNavRoute(opts) {
+    return {
+        type: "rest",
+        fullPath: `plant/search-plants-stream${opts.isResponseStream ? "-stream" : ""}`,
+        metadata: {
+            endpointId: opts.endpointId,
+            method: "POST",
+            isResponseStream: opts.isResponseStream,
+            endpointPairKey: opts.endpointPairKey
+        }
+    };
+}
+describe("mergeEndpointPairs — canonicalSlug", () => {
+    it("sets stream.canonicalSlug to nonStream.slug when pair key is present", () => {
+        const ctx = createBuildContext("");
+        const nonStream = makeEndpointNode({ endpointId: "ep-search", slug: "plant/search-plants-stream" });
+        const stream = makeEndpointNode({
+            endpointId: "ep-search-stream",
+            slug: "plant/search-plants-stream-stream",
+            isResponseStream: true
+        });
+        const navRoutes = [
+            makeNavRoute({ endpointId: "ep-search", endpointPairKey: "ep-search", isResponseStream: false }),
+            makeNavRoute({ endpointId: "ep-search-stream", endpointPairKey: "ep-search", isResponseStream: true })
+        ];
+        const result = mergeEndpointPairs(ctx, [nonStream, stream], navRoutes);
+        expect(result).toHaveLength(1);
+        expect(result[0].type).toBe("endpointPair");
+        const pair = result[0];
+        expect(pair.stream.canonicalSlug).toBe(pair.nonStream.slug);
+        expect(pair.nonStream.canonicalSlug).toBeUndefined();
+    });
+    it("preserves separate nodes when no endpointPairKey exists", () => {
+        const ctx = createBuildContext("");
+        const ep1 = makeEndpointNode({ endpointId: "ep-1", slug: "endpoint-1" });
+        const ep2 = makeEndpointNode({ endpointId: "ep-2", slug: "endpoint-2" });
+        const navRoutes = [
+            { type: "rest", fullPath: "endpoint-1", metadata: { endpointId: "ep-1", method: "GET" } },
+            { type: "rest", fullPath: "endpoint-2", metadata: { endpointId: "ep-2", method: "POST" } }
+        ];
+        const result = mergeEndpointPairs(ctx, [ep1, ep2], navRoutes);
+        expect(result).toHaveLength(2);
+        expect(result[0].type).toBe("endpoint");
+        expect(result[1].type).toBe("endpoint");
+    });
+});
+//# sourceMappingURL=ledger-root-builder.mergeEndpointPairs.test.js.map

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

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