@fern-api/fdr-sdk 1.1.24-e30ed51fda → 1.1.24-e3bdb9c0a9

package/dist/navigation/migrators/v1ToV2.js

@@ -0,0 +1,839 @@
+import visitDiscriminatedUnion from "@fern-api/ui-core-utils/visitDiscriminatedUnion";
+import { UnreachableCaseError } from "ts-essentials";
+import { FernNavigation } from "../..";
+/**
+ * This migration accounts for the following changes:
+ * - add canonicalSlug to all nodes
+ * - align availability enum with the rest of FDR
+ */
+export class FernNavigationV1ToLatest {
+    static create() {
+        return new FernNavigationV1ToLatest();
+    }
+    constructor() { }
+    // store the base slug
+    #baseUrl;
+    // this will store the product slug we are currently parsing
+    // to be used when setting the canonical URL
+    #currentProductSlug;
+    // this will store the product slug we are currently parsing
+    // to be used when setting the canonical URL
+    #currentDefaultVersionSlug;
+    root = (node) => {
+        this.#baseUrl = FernNavigation.Slug(node.slug);
+        const latest = {
+            type: "root",
+            child: visitDiscriminatedUnion(node.child)._visit({
+                versioned: (value) => this.versioned(value, [node]),
+                unversioned: (value) => this.unversioned(value, [node]),
+                productgroup: (value) => this.productGroup(value, [node])
+            }),
+            version: "v2",
+            title: node.title,
+            id: FernNavigation.NodeId(node.id),
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            roles: node.roles,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    versioned = (node, parents) => {
+        if (node.children.length === 0) {
+            return {
+                type: "versioned",
+                id: FernNavigation.NodeId(node.id),
+                collapsed: node.collapsed,
+                children: []
+            };
+        }
+        let defaultVersionIdx = node.children.findIndex((child) => child.default);
+        if (defaultVersionIdx === -1) {
+            defaultVersionIdx = 0;
+        }
+        /**
+         * the default version should be the preferred canonical slug
+         */
+        const defaultVersionV1 = node.children[defaultVersionIdx];
+        if (!defaultVersionV1) {
+            throw new Error("default version is undefined");
+        }
+        this.#currentDefaultVersionSlug = FernNavigation.Slug(defaultVersionV1.slug);
+        const defaultVersion = this.version(defaultVersionV1, [...parents, node]);
+        /**
+         * visit the rest of the children, but splice the default version in its original position
+         */
+        const children = [
+            ...node.children.slice(0, defaultVersionIdx).map((child) => this.version(child, [...parents, node])),
+            defaultVersion,
+            ...node.children.slice(defaultVersionIdx + 1).map((child) => this.version(child, [...parents, node]))
+        ];
+        const latest = {
+            type: "versioned",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            children
+        };
+        return latest;
+    };
+    version = (node, parents) => {
+        const landingPage = node.landingPage ? this.landingPage(node.landingPage, [...parents, node]) : undefined;
+        const latest = {
+            type: "version",
+            default: node.default,
+            versionId: node.versionId,
+            landingPage,
+            child: visitDiscriminatedUnion(node.child)._visit({
+                tabbed: (value) => this.tabbed(value, [...parents, node]),
+                sidebarRoot: (value) => this.sidebarRoot(value, [...parents, node]),
+                varianted: (value) => this.varianted(value, [...parents, node])
+            }),
+            availability: this.#availability(node.availability),
+            title: node.title,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            id: FernNavigation.NodeId(node.id),
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags,
+            announcement: node.announcement
+        };
+        return latest;
+    };
+    landingPage = (node, parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([node.pageId, this.#createTitleDisambiguationKey(node, parents)], slug);
+        const latest = {
+            type: "landingPage",
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            id: FernNavigation.NodeId(node.id),
+            pageId: FernNavigation.PageId(node.pageId),
+            noindex: node.noindex,
+            collapsed: node.collapsed,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    tabbed = (node, parents) => {
+        const latest = {
+            type: "tabbed",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            children: node.children.map((child) => visitDiscriminatedUnion(child)._visit({
+                tab: (value) => this.tab(value, [...parents, node]),
+                link: (value) => this.link(value, [...parents, node]),
+                changelog: (value) => this.changelog(value, [...parents, node])
+            }))
+        };
+        return latest;
+    };
+    varianted = (node, parents) => {
+        const latest = {
+            type: "varianted",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            children: node.children.map((child) => this.variant(child, [...parents, node]))
+        };
+        return latest;
+    };
+    variant = (node, parents) => {
+        const children = node.children.map((child) => this.#variantChild(child, [...parents, node]));
+        // If pointsTo is not set, find the first page in the variant's children
+        let pointsTo = node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined;
+        if (pointsTo == null) {
+            pointsTo = this.#findFirstPageSlugInChildren(children);
+        }
+        const latest = {
+            type: "variant",
+            default: node.default,
+            variantId: FernNavigation.VariantId(node.variantId),
+            subtitle: node.subtitle,
+            image: node.image,
+            children,
+            title: node.title,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            id: FernNavigation.NodeId(node.id),
+            pointsTo,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    tab = (node, parents) => {
+        const latest = {
+            type: "tab",
+            child: this.sidebarRoot(node.child, [...parents, node]),
+            title: node.title,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            id: FernNavigation.NodeId(node.id),
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    link = (node, _parents) => {
+        const latest = {
+            type: "link",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            title: node.title,
+            url: node.url,
+            icon: node.icon,
+            target: node.target
+        };
+        return latest;
+    };
+    unversioned = (node, parents) => {
+        const latest = {
+            type: "unversioned",
+            collapsed: node.collapsed,
+            child: visitDiscriminatedUnion(node.child)._visit({
+                tabbed: (value) => this.tabbed(value, [...parents, node]),
+                sidebarRoot: (value) => this.sidebarRoot(value, [...parents, node]),
+                varianted: (value) => this.varianted(value, [...parents, node])
+            }),
+            landingPage: node.landingPage ? this.landingPage(node.landingPage, [...parents, node]) : undefined,
+            id: FernNavigation.NodeId(node.id)
+        };
+        return latest;
+    };
+    productGroup = (node, parents) => {
+        const landingPage = node.landingPage ? this.landingPage(node.landingPage, [...parents, node]) : undefined;
+        if (node.children.length === 0) {
+            return {
+                type: "productgroup",
+                landingPage,
+                id: FernNavigation.NodeId(node.id),
+                collapsed: node.collapsed,
+                children: []
+            };
+        }
+        let defaultProductIdx = node.children.findIndex((child) => child.default);
+        if (defaultProductIdx === -1) {
+            defaultProductIdx = 0;
+        }
+        /**
+         * the default product should be the preferred canonical slug
+         */
+        const defaultProductV1 = node.children[defaultProductIdx];
+        if (!defaultProductV1) {
+            throw new Error("default product is undefined");
+        }
+        const defaultProduct = this.product(defaultProductV1, [...parents, node]);
+        /**
+         * visit the rest of the children, but splice the default product in its original position
+         */
+        const children = [
+            ...node.children.slice(0, defaultProductIdx).map((child) => this.product(child, [...parents, node])),
+            defaultProduct,
+            ...node.children.slice(defaultProductIdx + 1).map((child) => this.product(child, [...parents, node]))
+        ];
+        const latest = {
+            type: "productgroup",
+            landingPage,
+            children,
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed
+        };
+        return latest;
+    };
+    product = (node, parents) => {
+        return visitDiscriminatedUnion(node)._visit({
+            product: (internalNode) => this.internalProduct(internalNode, parents),
+            productLink: (externalNode) => this.externalProduct(externalNode)
+        });
+    };
+    internalProduct = (node, parents) => {
+        this.#currentProductSlug = node.slug;
+        const latest = {
+            type: "product",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            image: node.image,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            default: node.default,
+            productId: FernNavigation.ProductId(node.productId),
+            child: visitDiscriminatedUnion(node.child)._visit({
+                unversioned: (value) => this.unversioned(value, [...parents, node]),
+                versioned: (value) => this.versioned(value, [...parents, node])
+            }),
+            subtitle: node.subtitle,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags,
+            announcement: node.announcement
+        };
+        return latest;
+    };
+    externalProduct = (node) => {
+        const latest = {
+            type: "productLink",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            title: node.title,
+            href: node.href,
+            target: node.target,
+            default: node.default,
+            productId: FernNavigation.ProductId(node.productId),
+            subtitle: node.subtitle,
+            icon: node.icon,
+            image: node.image,
+            hidden: node.hidden,
+            authed: node.authed,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: undefined
+        };
+        return latest;
+    };
+    sidebarRoot = (node, parents) => {
+        const latest = {
+            type: "sidebarRoot",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            children: node.children.map((child) => visitDiscriminatedUnion(child)._visit({
+                sidebarGroup: (value) => this.sidebarGroup(value, [...parents, node]),
+                apiReference: (value) => this.apiReference(value, [...parents, node]),
+                section: (value) => this.section(value, [...parents, node]),
+                varianted: (value) => this.varianted(value, [...parents, node])
+            }))
+        };
+        return latest;
+    };
+    sidebarGroup = (node, parents) => {
+        const latest = {
+            type: "sidebarGroup",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            children: node.children.map((child) => this.#navigationChild(child, [...parents, node]))
+        };
+        return latest;
+    };
+    page = (node, parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([node.pageId, this.#createTitleDisambiguationKey(node, parents)], slug);
+        const latest = {
+            type: "page",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            pageId: FernNavigation.PageId(node.pageId),
+            noindex: node.noindex,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags,
+            availability: this.#availability(node.availability)
+        };
+        return latest;
+    };
+    section = (node, parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        const overviewPageId = node.overviewPageId ? FernNavigation.PageId(node.overviewPageId) : undefined;
+        const canonicalSlug = overviewPageId != null
+            ? this.#getAndSetCanonicalSlug([overviewPageId, this.#createTitleDisambiguationKey(node, parents)], slug)
+            : undefined;
+        const latest = {
+            type: "section",
+            id: FernNavigation.NodeId(node.id),
+            children: node.children.map((child) => this.#navigationChild(child, [...parents, node])),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            collapsed: node.collapsed,
+            collapsible: node.collapsible ?? (node.collapsed === true ? true : undefined),
+            collapsedByDefault: node.collapsedByDefault ?? (node.collapsed === true ? true : undefined),
+            overviewPageId,
+            noindex: node.noindex,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags,
+            availability: this.#availability(node.availability)
+        };
+        return latest;
+    };
+    apiReference = (node, parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        const overviewPageId = node.overviewPageId ? FernNavigation.PageId(node.overviewPageId) : undefined;
+        const canonicalSlug = overviewPageId != null
+            ? this.#getAndSetCanonicalSlug([overviewPageId, this.#createTitleDisambiguationKey(node, parents)], slug)
+            : undefined;
+        const latest = {
+            type: "apiReference",
+            paginated: node.paginated,
+            showErrors: node.showErrors,
+            hideTitle: node.hideTitle,
+            children: node.children.map((child) => this.#apiPackageChild(child, [...parents, node])),
+            changelog: node.changelog ? this.changelog(node.changelog, [...parents, node]) : undefined,
+            playground: node.playground,
+            postmanCollectionUrl: node.postmanCollectionUrl,
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            id: FernNavigation.NodeId(node.id),
+            overviewPageId,
+            noindex: node.noindex,
+            apiDefinitionId: node.apiDefinitionId,
+            availability: this.#availability(node.availability),
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    changelog = (node, parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        const overviewPageId = node.overviewPageId ? FernNavigation.PageId(node.overviewPageId) : undefined;
+        const canonicalSlug = overviewPageId != null ? this.#getAndSetCanonicalSlug(overviewPageId, slug) : undefined;
+        const latest = {
+            type: "changelog",
+            id: FernNavigation.NodeId(node.id),
+            children: node.children.map((child) => this.changelogYear(child, [...parents, node])),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            overviewPageId,
+            noindex: node.noindex,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    changelogYear = (node, parents) => {
+        const latest = {
+            type: "changelogYear",
+            id: FernNavigation.NodeId(node.id),
+            children: node.children.map((child) => this.changelogMonth(child, [...parents, node])),
+            title: node.title,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            year: node.year,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    changelogMonth = (node, parents) => {
+        const latest = {
+            type: "changelogMonth",
+            id: FernNavigation.NodeId(node.id),
+            children: node.children.map((child) => this.changelogEntry(child, [...parents, node])),
+            title: node.title,
+            slug: FernNavigation.Slug(node.slug),
+            canonicalSlug: undefined,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            month: node.month,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    changelogEntry = (node, _parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        // NOTE: do NOT use title disambiguation key here, since the title may not always be unique
+        const canonicalSlug = this.#getAndSetCanonicalSlug(node.pageId, slug);
+        const latest = {
+            type: "changelogEntry",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            date: node.date,
+            pageId: FernNavigation.PageId(node.pageId),
+            noindex: node.noindex,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags,
+            tags: node.tags
+        };
+        return latest;
+    };
+    apiPackage = (node, parents) => {
+        const slug = FernNavigation.Slug(node.slug);
+        const overviewPageId = node.overviewPageId ? FernNavigation.PageId(node.overviewPageId) : undefined;
+        const canonicalSlug = overviewPageId != null
+            ? this.#getAndSetCanonicalSlug([overviewPageId, this.#createTitleDisambiguationKey(node, parents)], slug)
+            : undefined;
+        const latest = {
+            type: "apiPackage",
+            id: FernNavigation.NodeId(node.id),
+            children: node.children.map((child) => this.#apiPackageChild(child, [...parents, node])),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            pointsTo: node.pointsTo ? FernNavigation.Slug(node.pointsTo) : undefined,
+            playground: node.playground,
+            overviewPageId,
+            noindex: node.noindex,
+            apiDefinitionId: node.apiDefinitionId,
+            availability: this.#availability(node.availability),
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    endpoint = (node, parents) => {
+        const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([
+            `${apiDisambiguation}:api:endpoint:${node.method}:${node.endpointId}`,
+            this.#createTitleDisambiguationKey(node, parents)
+        ], slug);
+        const latest = {
+            type: "endpoint",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            playground: node.playground,
+            apiDefinitionId: node.apiDefinitionId,
+            availability: this.#availability(node.availability),
+            method: node.method,
+            endpointId: node.endpointId,
+            isResponseStream: node.isResponseStream,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    endpointPair = (node, parents) => {
+        const latest = {
+            type: "endpointPair",
+            id: FernNavigation.NodeId(node.id),
+            collapsed: node.collapsed,
+            nonStream: this.endpoint(node.nonStream, [...parents, node]),
+            stream: this.endpoint(node.stream, [...parents, node])
+        };
+        return latest;
+    };
+    webSocket = (node, parents) => {
+        const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([
+            `${apiDisambiguation}:api:websocket:${node.webSocketId}`,
+            this.#createTitleDisambiguationKey(node, parents)
+        ], slug);
+        const latest = {
+            type: "webSocket",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            playground: node.playground,
+            apiDefinitionId: node.apiDefinitionId,
+            availability: this.#availability(node.availability),
+            webSocketId: node.webSocketId,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    webhook = (node, parents) => {
+        const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([
+            `${apiDisambiguation}:api:webhook:${node.method}:${node.webhookId}`,
+            this.#createTitleDisambiguationKey(node, parents)
+        ], slug);
+        const latest = {
+            type: "webhook",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            apiDefinitionId: node.apiDefinitionId,
+            availability: this.#availability(node.availability),
+            method: node.method,
+            webhookId: node.webhookId,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    grpc = (node, parents) => {
+        const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([
+            `${apiDisambiguation}:api:grpc:${node.method}:${node.grpcId}`,
+            this.#createTitleDisambiguationKey(node, parents)
+        ], slug);
+        const latest = {
+            type: "grpc",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            apiDefinitionId: node.apiDefinitionId,
+            availability: this.#availability(node.availability),
+            method: node.method,
+            grpcId: node.grpcId,
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    graphql = (node, parents) => {
+        const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+        const slug = FernNavigation.Slug(node.slug);
+        const canonicalSlug = this.#getAndSetCanonicalSlug([`${apiDisambiguation}:api:graphql:${node.id}`, this.#createTitleDisambiguationKey(node, parents)], slug);
+        const latest = {
+            type: "graphql",
+            id: FernNavigation.NodeId(node.id),
+            title: node.title,
+            slug,
+            canonicalSlug,
+            icon: node.icon,
+            hidden: node.hidden,
+            authed: node.authed,
+            collapsed: node.collapsed,
+            apiDefinitionId: node.apiDefinitionId,
+            graphqlOperationId: node.graphqlOperationId,
+            operationType: node.operationType,
+            playground: node.playground,
+            availability: this.#availability(node.availability),
+            viewers: node.viewers,
+            orphaned: node.orphaned,
+            featureFlags: node.featureFlags
+        };
+        return latest;
+    };
+    #variantChild = (child, parents) => {
+        return visitDiscriminatedUnion(child)._visit({
+            apiReference: (value) => this.apiReference(value, parents),
+            section: (value) => this.section(value, parents),
+            sidebarGroup: (value) => this.sidebarGroup(value, parents),
+            link: (value) => this.link(value, parents),
+            page: (value) => this.page(value, parents),
+            changelog: (value) => this.changelog(value, parents)
+        });
+    };
+    #navigationChild = (child, parents) => {
+        return visitDiscriminatedUnion(child)._visit({
+            apiReference: (value) => this.apiReference(value, parents),
+            section: (value) => this.section(value, parents),
+            link: (value) => this.link(value, parents),
+            page: (value) => this.page(value, parents),
+            changelog: (value) => this.changelog(value, parents),
+            varianted: (value) => this.varianted(value, parents)
+        });
+    };
+    #apiPackageChild = (child, parents) => {
+        return visitDiscriminatedUnion(child)._visit({
+            page: (value) => this.page(value, parents),
+            link: (value) => this.link(value, parents),
+            apiPackage: (value) => this.apiPackage(value, parents),
+            endpoint: (value) => this.endpoint(value, parents),
+            endpointPair: (value) => this.endpointPair(value, parents),
+            webSocket: (value) => this.webSocket(value, parents),
+            webhook: (value) => this.webhook(value, parents),
+            grpc: (value) => this.grpc(value, parents),
+            graphql: (value) => this.graphql(value, parents)
+        });
+    };
+    /**
+     * Recursively searches for the first page node within a list of children
+     */
+    #findFirstPageSlugInChildren = (children) => {
+        for (const child of children) {
+            if (FernNavigation.isPage(child)) {
+                return child.slug;
+            }
+            const childChildren = FernNavigation.getChildren(child);
+            if (childChildren != null && childChildren.length > 0) {
+                const firstPage = this.#findFirstPageSlugInChildren(childChildren);
+                if (firstPage != null) {
+                    return firstPage;
+                }
+            }
+        }
+        return undefined;
+    };
+    #availability(v1) {
+        if (v1 == null) {
+            return undefined;
+        }
+        switch (v1) {
+            case "beta":
+                return FernNavigation.Availability.Beta;
+            case "deprecated":
+                return FernNavigation.Availability.Deprecated;
+            case "generally-available":
+                return FernNavigation.Availability.GenerallyAvailable;
+            case "in-development":
+                return FernNavigation.Availability.InDevelopment;
+            case "pre-release":
+                return FernNavigation.Availability.PreRelease;
+            case "stable":
+                return FernNavigation.Availability.Stable;
+            default:
+                throw new UnreachableCaseError(v1);
+        }
+    }
+    #canonicalSlugs = new Map();
+    // return a match found with any key
+    #getCanonicalSlug = (keyOrKeys) => {
+        if (typeof keyOrKeys === "string") {
+            return this.#canonicalSlugs.get(keyOrKeys);
+        }
+        for (const key of keyOrKeys) {
+            const existing = this.#canonicalSlugs.get(key);
+            // explicitly check for undefined because empty string is valid
+            if (existing !== undefined) {
+                return existing;
+            }
+        }
+        return undefined;
+    };
+    // set all keys to use the same canonical url
+    #setCanonicalSlug = (keyOrKeys, fullCanonical) => {
+        const baseSlug = this.#currentProductSlug ?? "" + this.#baseUrl;
+        // if the canonical slug includes the default version, prefer an unversioned slug
+        const normalizedCanonical = this.#currentDefaultVersionSlug
+            ? fullCanonical.replace(new RegExp(`(^|/)${this.#currentDefaultVersionSlug}(/|$)`, "g"), `$1${baseSlug}$2`)
+            : fullCanonical;
+        // canonical slug should always begin without a slash
+        const canonicalSlug = FernNavigation.Slug(normalizedCanonical.replace(/^\//, ""));
+        if (typeof keyOrKeys === "string") {
+            this.#canonicalSlugs.set(keyOrKeys, canonicalSlug);
+            return canonicalSlug;
+        }
+        // canonical slug should apply to all keys of a given page
+        for (const key of keyOrKeys) {
+            this.#canonicalSlugs.set(key, canonicalSlug);
+        }
+        return canonicalSlug;
+    };
+    // TODO: canonical url logic should account for RBAC, since we should always prefer the publicly available url over the private one (for SEO)
+    #getAndSetCanonicalSlug = (keyOrKeys, slug) => {
+        if (keyOrKeys == null) {
+            return undefined;
+        }
+        const existing = this.#getCanonicalSlug(keyOrKeys);
+        if (existing != null) {
+            return existing;
+        }
+        const canonicalSlug = this.#setCanonicalSlug(keyOrKeys, slug);
+        return canonicalSlug;
+    };
+    #createTitleDisambiguationKey = (node, parents) => {
+        const unversionedParents = this.#findUnversionedParents(parents);
+        const unversionedParentTitles = unversionedParents
+            .filter(FernNavigation.V1.hasMetadata)
+            .map((parent) => parent.title);
+        // Include product slug to prevent cross-product canonical slug contamination.
+        // Without this, pages with the same title hierarchy in different products
+        // (e.g., "Reference > Core > Overview" in both Browser SDK and Server SDK)
+        // would share the same disambiguation key, causing version switching to
+        // navigate to the wrong product.
+        const productPrefix = this.#currentProductSlug ?? "";
+        return [productPrefix, ...unversionedParentTitles, node.title].join("###");
+    };
+    #createApiDisambiguationKey = (parents) => {
+        const unversionedParents = this.#findUnversionedParents(parents);
+        const unversionedParentIds = unversionedParents
+            .filter((parent) => parent.type === "apiReference")
+            .map((parent) => parent.title.replaceAll(" ", ""));
+        const productPrefix = this.#currentProductSlug ?? "";
+        return [productPrefix, ...unversionedParentIds].join(":");
+    };
+    #findUnversionedParents = (parents) => {
+        const versionIdx = parents.findIndex((parent) => parent.type === "version");
+        const unversionedParents = versionIdx >= 0 ? parents.slice(versionIdx + 1) : parents;
+        return unversionedParents;
+    };
+}
+//# sourceMappingURL=v1ToV2.js.map