@fern-api/fdr-sdk 1.2.79-88e3cf0ca5 → 1.2.80-050d6c9417

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

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

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

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

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

@@ -0,0 +1,185 @@
+import { describe, expect, it } from "vitest";
+import { buildFullRootFromSegments } from "../ledger-root-builder.js";
+/**
+ * Regression test for docs.yml `playground` settings (e.g. `playground.hidden: true`)
+ * being dropped when the navigation tree is rebuilt from ledger segments.
+ *
+ * The ledger rebuild (`ledger-root-builder.ts`) currently hardcodes `playground: undefined`
+ * on apiReference / apiPackage / endpoint / webSocket / graphql nodes, and the flatten step
+ * never writes `playground` into segment metadata. As a result, `playground.hidden` (and every
+ * other playground setting) is a no-op on any ledger-backed (published) docs site, even though
+ * it works locally under `fern docs dev` (which uses the legacy DocsV1Read path).
+ *
+ * These tests assert the DESIRED behavior: playground settings present in segment / route
+ * metadata are read back onto the rebuilt nodes. They fail before the fix (value comes back
+ * `undefined`) and pass once the builder reads `playground` from metadata.
+ */
+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 restRoute(opts) {
+    return {
+        type: "rest",
+        fullPath: opts.fullPath,
+        hidden: false,
+        metadata: {
+            title: opts.title,
+            endpointId: opts.endpointId,
+            method: opts.method,
+            apiDefinitionId: "api-def-1",
+            ...(opts.playground != null ? { playground: opts.playground } : {})
+        }
+    };
+}
+// 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("playground preservation on ledger rebuild", () => {
+    it("reads playground.hidden from apiReference segment metadata", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-api",
+                    section: "api",
+                    sortOrder: 0,
+                    metadata: {
+                        type: "apiReference",
+                        title: "API",
+                        apiDefinitionId: "api-def-1",
+                        playground: { hidden: true }
+                    }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-api",
+                    [
+                        restRoute({
+                            fullPath: "api/create",
+                            title: "Create",
+                            endpointId: "create",
+                            method: "POST"
+                        })
+                    ]
+                ]
+            ])
+        });
+        const apis = collectByType(root, "apiReference");
+        expect(apis).toHaveLength(1);
+        expect(apis[0].playground).toEqual({ hidden: true });
+    });
+    it("reads playground.hidden from endpoint route metadata", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-api",
+                    section: "api",
+                    sortOrder: 0,
+                    metadata: { type: "apiReference", title: "API", apiDefinitionId: "api-def-1" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-api",
+                    [
+                        restRoute({
+                            fullPath: "api/create",
+                            title: "Create",
+                            endpointId: "create",
+                            method: "POST",
+                            playground: { hidden: true }
+                        })
+                    ]
+                ]
+            ])
+        });
+        const endpoints = collectByType(root, "endpoint");
+        expect(endpoints).toHaveLength(1);
+        expect(endpoints[0].playground).toEqual({ hidden: true });
+    });
+    it("reads playground.send-optional-defaults from endpoint route metadata", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-api",
+                    section: "api",
+                    sortOrder: 0,
+                    metadata: { type: "apiReference", title: "API", apiDefinitionId: "api-def-1" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-api",
+                    [
+                        restRoute({
+                            fullPath: "api/create",
+                            title: "Create",
+                            endpointId: "create",
+                            method: "POST",
+                            playground: { "send-optional-defaults": true }
+                        })
+                    ]
+                ]
+            ])
+        });
+        const endpoints = collectByType(root, "endpoint");
+        expect(endpoints).toHaveLength(1);
+        expect(endpoints[0].playground).toEqual({ "send-optional-defaults": true });
+    });
+    it("leaves playground undefined when metadata carries none", () => {
+        const root = buildFullRootFromSegments({
+            basePath: "",
+            title: "Test",
+            segments: [
+                segment({
+                    segmentHash: "seg-api",
+                    section: "api",
+                    sortOrder: 0,
+                    metadata: { type: "apiReference", title: "API", apiDefinitionId: "api-def-1" }
+                })
+            ],
+            navBySegment: new Map([
+                [
+                    "seg-api",
+                    [restRoute({ fullPath: "api/list", title: "List", endpointId: "list", method: "GET" })]
+                ]
+            ])
+        });
+        const endpoints = collectByType(root, "endpoint");
+        expect(endpoints).toHaveLength(1);
+        expect(endpoints[0].playground).toBeUndefined();
+    });
+});
+//# sourceMappingURL=ledger-root-builder.playgroundPreservation.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-root-builder.playgroundPreservation.test.js","sourceRoot":"","sources":["../../../src/navigation/__test__/ledger-root-builder.playgroundPreservation.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;AA0RD;;;;;;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;AAqLD;;;;;;;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;AA2bD;;;;;;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;AA21BD;;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;AAiUD;;;;;;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;AAqLD;;;;;;;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;AA2bD;;;;;;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;AA21BD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CA0F5F"}

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

@@ -127,6 +127,42 @@ function metaCollapsed(metadata) {
     }
     return undefined;
 }
+/**
+ * Read docs.yml `playground` settings from a metadata blob. The flatten step
+ * (docsPublishTransform) writes the nav node's `playground` object verbatim into
+ * segment / api-artifact metadata; here we read it back and coerce the known
+ * fields onto a branded PlaygroundSettings. Returns undefined when absent, so the
+ * nearest-apiReference inheritance in withPrunedNavigation still applies to leaves.
+ */
+function metaPlayground(metadata) {
+    if (metadata == null || typeof metadata !== "object" || !("playground" in metadata)) {
+        return undefined;
+    }
+    const raw = metadata.playground;
+    if (raw == null || typeof raw !== "object") {
+        return undefined;
+    }
+    const pg = raw;
+    const environments = Array.isArray(pg.environments)
+        ? pg.environments.filter((x) => typeof x === "string")
+        : undefined;
+    // Preserve a button object whenever one is present (matching the schema, where
+    // `href` is optional); only its `href` is coerced to a branded Url.
+    const hasButton = pg.button != null && typeof pg.button === "object";
+    const buttonHref = hasButton ? pg.button.href : undefined;
+    const limit = pg["limit-websocket-messages-per-connection"];
+    return {
+        environments: environments != null && environments.length > 0
+            ? environments.map((e) => FernNavigation.EnvironmentId(e))
+            : undefined,
+        button: hasButton
+            ? { href: typeof buttonHref === "string" ? FernNavigation.Url(buttonHref) : undefined }
+            : undefined,
+        "limit-websocket-messages-per-connection": typeof limit === "number" ? limit : undefined,
+        hidden: typeof pg.hidden === "boolean" ? pg.hidden : undefined,
+        "send-optional-defaults": typeof pg["send-optional-defaults"] === "boolean" ? pg["send-optional-defaults"] : undefined
+    };
+}
 /** Extract a string array from a metadata blob (e.g. page-level `viewers`). */
 function metaStrArr(metadata, key) {
     if (metadata != null && typeof metadata === "object" && key in metadata) {
@@ -316,7 +352,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             apiDefinitionId,
             isResponseStream: metaBool(md, "isResponseStream"),
             availability: metaAvailability(md),
-            playground: undefined
+            playground: metaPlayground(md)
         };
     }
     if (route.type === "webhook") {
@@ -345,7 +381,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             webSocketId: FernNavigation.WebSocketId(webSocketId),
             apiDefinitionId,
             availability: metaAvailability(md),
-            playground: undefined
+            playground: metaPlayground(md)
         };
     }
     if (route.type === "grpc") {
@@ -377,7 +413,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId) {
             graphqlOperationIds: undefined,
             apiDefinitionId,
             availability: metaAvailability(md),
-            playground: undefined
+            playground: metaPlayground(md)
         };
     }
     return undefined;
@@ -812,7 +848,7 @@ function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scop
         // compute it via followRedirect, matching v2 behavior.
         pointsTo: undefined,
         children,
-        playground: undefined
+        playground: metaPlayground(seg.metadata)
     };
 }
 /**
@@ -930,7 +966,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
         pointsTo: undefined,
         children,
         changelog,
-        playground: undefined,
+        playground: metaPlayground(seg.metadata),
         postmanCollectionUrl: undefined
     };
 }