feat: isAuthenticatedPagesDiscoverable feature flag

fern/apis/fdr/definition/commons.yml

@@ -43,6 +43,8 @@ types:
 
   PropertyKey: string
 
+  AudienceId: string
+
   EndpointIdentifier:
     properties:
       path: EndpointPathLiteral

fern/apis/fdr/definition/navigation/latest/__package__.yml

@@ -334,7 +334,21 @@ types:
         type: optional<Slug>
         docs: The slug that should be used in the canonical URL rel. If not provided, the `slug` will be used.
       icon: optional<string>
-      hidden: optional<boolean>
+      hidden:
+        type: optional<boolean>
+        docs: If true, this node will not be displayed in the sidebar, and noindex will be considered true.
+      authed:
+        type: optional<boolean>
+        docs: |
+          If true, this node is only visible to authenticated users.
+          If false, this node is only visible to all users (including anonymous).
+      audience:
+        type: optional<list<commons.AudienceId>>
+        availability: in-development
+        docs: |
+          The audience(s) that this node is intended for. If not provided, the node is intended for all audiences.
+          If provided, the node is only intended for the specified audience(s). OR logic is used for multiple audiences on a single node.
+          AND logic is used when evaluating audiences up the tree.
 
   WithPage:
     properties:

packages/commons/fdr-utils/src/types.ts

@@ -13,6 +13,8 @@ export interface VersionSwitcherInfo {
     index: number;
     availability: FernNavigation.Availability | undefined;
     pointsTo: FernNavigation.Slug | undefined;
+    hidden: boolean | undefined;
+    authed: boolean | undefined;
 }
 
 interface SidebarTabGroup {
@@ -22,6 +24,8 @@ interface SidebarTabGroup {
     index: number;
     slug: FernNavigation.Slug;
     pointsTo: FernNavigation.Slug | undefined;
+    hidden: boolean | undefined;
+    authed: boolean | undefined;
 }
 
 interface SidebarTabLink {
@@ -38,6 +42,8 @@ interface SidebarTabChangelog {
     icon: string | undefined;
     index: number;
     slug: FernNavigation.Slug;
+    hidden: boolean | undefined;
+    authed: boolean | undefined;
 }
 
 export type SidebarTab = SidebarTabGroup | SidebarTabLink | SidebarTabChangelog;

packages/fdr-sdk/src/__test__/__snapshots__/hume.test.ts.snap

@@ -117,6 +117,8 @@ exports[`hume > gets navigation root for /reference/expression-measurement-api/s
 
 exports[`hume > gets navigation root for /support 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": false,
   "icon": undefined,

packages/fdr-sdk/src/__test__/__snapshots__/no-version-no-tabs.test.ts.snap

@@ -20,6 +20,8 @@ exports[`no-version-no-tabs > gets navigation root for /docs 1`] = `
 
 exports[`no-version-no-tabs > gets navigation root for /docs/api/page-6 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,
@@ -45,6 +47,8 @@ exports[`no-version-no-tabs > gets navigation root for /docs/api/section-1 1`] =
 
 exports[`no-version-no-tabs > gets navigation root for /docs/api/section-2 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,

packages/fdr-sdk/src/__test__/__snapshots__/no-version-yes-tabs.test.ts.snap

@@ -23,6 +23,8 @@ exports[`no-version-yes-tabs > gets navigation root for /docs/api 1`] = `
 
 exports[`no-version-yes-tabs > gets navigation root for /docs/api/page-2 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,
@@ -48,6 +50,8 @@ exports[`no-version-yes-tabs > gets navigation root for /docs/api/section-1 1`]
 
 exports[`no-version-yes-tabs > gets navigation root for /docs/api/tab-1 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,
@@ -66,6 +70,8 @@ exports[`no-version-yes-tabs > gets navigation root for /docs/api/tab-1 3`] = `"
 
 exports[`no-version-yes-tabs > gets navigation root for /docs/api/tab-2 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,

packages/fdr-sdk/src/__test__/__snapshots__/polytomic.test.ts.snap

@@ -861,6 +861,8 @@ exports[`polytomic > gets navigation root for /2023-04-25/not-found 1`] = `
 
 exports[`polytomic > gets navigation root for /2024-02-08/guides/introduction 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": false,
   "icon": undefined,

packages/fdr-sdk/src/__test__/__snapshots__/primer.test.ts.snap

@@ -157,6 +157,8 @@ exports[`primer > gets navigation root for /docs/api/introduction/getting-starte
 exports[`primer > gets navigation root for /docs/api/v2.1/api-reference/client-session-api/retrieve-client-side-token 1`] = `
 {
   "apiDefinitionId": "7ed504c0-fc2e-4a52-b3fd-b277869eda14",
+  "audience": undefined,
+  "authed": undefined,
   "availability": undefined,
   "canonicalSlug": "docs/api/v2.3/api-reference/client-session-api/retrieve-client-side-token",
   "endpointId": "subpackage_clientSessionApi.retrieveClientSideToken",

packages/fdr-sdk/src/__test__/__snapshots__/uploadcare.test.ts.snap

@@ -86,6 +86,8 @@ exports[`uploadcare > gets navigation root for /docs/file-management 1`] = `
 
 exports[`uploadcare > gets navigation root for /docs/file-management/overview 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,
@@ -118,6 +120,8 @@ exports[`uploadcare > gets navigation root for /docs/introduction 1`] = `
 
 exports[`uploadcare > gets navigation root for /docs/introduction/intro 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,

packages/fdr-sdk/src/__test__/__snapshots__/yes-version-no-tabs.test.ts.snap

@@ -67,6 +67,8 @@ exports[`yes-version-no-tabs > gets navigation root for /docs/api/version-1 3`]
 
 exports[`yes-version-no-tabs > gets navigation root for /docs/api/version-1/page-5 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,
@@ -92,6 +94,8 @@ exports[`yes-version-no-tabs > gets navigation root for /docs/api/version-1/sect
 
 exports[`yes-version-no-tabs > gets navigation root for /docs/api/version-1/version-1 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,
@@ -117,6 +121,8 @@ exports[`yes-version-no-tabs > gets navigation root for /docs/api/version-2 1`]
 
 exports[`yes-version-no-tabs > gets navigation root for /docs/api/version-2/version-1 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,

packages/fdr-sdk/src/__test__/__snapshots__/yes-version-yes-tabs.test.ts.snap

@@ -70,6 +70,8 @@ exports[`yes-version-yes-tabs > gets navigation root for /docs/api/version-1 1`]
 
 exports[`yes-version-yes-tabs > gets navigation root for /docs/api/version-1/section-2 1`] = `
 {
+  "audience": undefined,
+  "authed": undefined,
   "canonicalSlug": undefined,
   "hidden": undefined,
   "icon": undefined,

packages/fdr-sdk/src/navigation/index.ts

@@ -7,5 +7,6 @@ export * from "../client/generated/api/resources/commons";
 export * from "./ApiDefinitionHolder";
 export * as migrate from "./migrators";
 export * as utils from "./utils";
+export * from "./utils/pruneNavigationTree";
 export * from "./versions";
 export { ApiDefinitionHolder, ApiDefinitionPruner, ApiTypeIdVisitor, NodeCollector };