@fern-api/fdr-sdk 1.2.101-d2c863c843 → 1.2.102-07ddc01b9b

package/dist/js/converters/index.js

@@ -7475,6 +7475,7 @@ __export(api_definition_exports, {
   buildSdkSnippetRequest: () => buildSdkSnippetRequest,
   cleanLanguage: () => cleanLanguage,
   collectReferencedTypeIds: () => collectReferencedTypeIds,
+  collectReferencingTypeIdsByTypeId: () => collectReferencingTypeIdsByTypeId,
   collectTypeDefinitionTree: () => collectTypeDefinitionTree,
   collectTypeDefinitionTreeForObjectProperty: () => collectTypeDefinitionTreeForObjectProperty,
   convertToCurl: () => convertToCurl,
@@ -8377,6 +8378,7 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
     };
     const namespaces = /* @__PURE__ */ new Set();
     const authSchemes = /* @__PURE__ */ new Set();
+    const seedTypeIds = /* @__PURE__ */ new Set();
     for (const node of nodes) {
       if (node.type === "endpoint") {
         const found = this.api.endpoints[node.endpointId];
@@ -8413,9 +8415,14 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
             found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
           }
         }
+      } else if (node.type === "graphqlType") {
+        const found = this.api.types[node.typeId];
+        if (found) {
+          seedTypeIds.add(node.typeId);
+        }
       }
     }
-    toRet.types = this.pruneTypes(toRet);
+    toRet.types = this.pruneTypes(toRet, seedTypeIds);
     namespaces.forEach((subpackageId) => {
       const subpackage = this.api.subpackages[subpackageId];
       if (subpackage) {
@@ -8430,8 +8437,8 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
     });
     return toRet;
   }
-  pruneTypes(partiallyPrunedApi) {
-    let typeIds = /* @__PURE__ */ new Set();
+  pruneTypes(partiallyPrunedApi, seedTypeIds = /* @__PURE__ */ new Set()) {
+    let typeIds = new Set(seedTypeIds);
     partiallyPrunedApi.globalHeaders?.forEach((header) => {
       ApiTypeIdVisitor.visitTypeShape(header.valueShape, (typeId) => typeIds.add(typeId));
     });
@@ -11946,6 +11953,28 @@ var Transformer = class _Transformer {
   };
 };
 
+// src/api-definition/type-back-references.ts
+function collectReferencingTypeIdsByTypeId(api2) {
+  const byTypeId = /* @__PURE__ */ new Map();
+  for (const [rawId, definition] of Object.entries(api2.types)) {
+    const from = rawId;
+    const seen = /* @__PURE__ */ new Set();
+    ApiTypeIdVisitor.visitTypeDefinition(definition, (to) => {
+      if (to === from || seen.has(to) || api2.types[to] == null) {
+        return;
+      }
+      seen.add(to);
+      const existing = byTypeId.get(to);
+      if (existing == null) {
+        byTypeId.set(to, [from]);
+      } else {
+        existing.push(from);
+      }
+    });
+  }
+  return byTypeId;
+}
+
 // src/navigation/index.ts
 var navigation_exports = {};
 __export(navigation_exports, {
@@ -14427,6 +14456,7 @@ function followRedirect(nodeToFollow) {
     webhook: (node) => node.slug,
     grpc: (node) => node.slug,
     graphql: (node) => node.slug,
+    graphqlType: (node) => node.slug,
     landingPage: (node) => node.slug,
     // nodes with overview
     apiPackage: (node) => node.overviewPageId != null ? node.slug : followRedirects(node.children),
@@ -14481,6 +14511,7 @@ function getPageId2(node) {
     webhook: RETURN_UNDEFINED2,
     grpc: RETURN_UNDEFINED2,
     graphql: RETURN_UNDEFINED2,
+    graphqlType: RETURN_UNDEFINED2,
     changelogYear: RETURN_UNDEFINED2,
     changelogMonth: RETURN_UNDEFINED2
   });
@@ -14488,7 +14519,7 @@ function getPageId2(node) {
 
 // src/navigation/versions/v1/NavigationNodeApiLeaf.ts
 function isApiLeaf2(node) {
-  return node.type === "endpoint" || node.type === "webSocket" || node.type === "webhook" || node.type === "grpc" || node.type === "graphql";
+  return node.type === "endpoint" || node.type === "webSocket" || node.type === "webhook" || node.type === "grpc" || node.type === "graphql" || node.type === "graphqlType";
 }
 
 // src/navigation/versions/v1/NavigationNodePageLeaf.ts
@@ -14607,6 +14638,18 @@ function withCanonicalLookup(map) {
   map.has = (key) => originalHas(key) || originalHas(canonicalSlugKey(key));
   return map;
 }
+function graphQlTypeKey(apiDefinitionId, typeId, versionId) {
+  return `${apiDefinitionId}:${versionId ?? ""}:${typeId}`;
+}
+function versionIdOf(parents) {
+  for (let i = parents.length - 1; i >= 0; i--) {
+    const parent = parents[i];
+    if (parent?.type === "version") {
+      return parent.versionId;
+    }
+  }
+  return void 0;
+}
 var NodeCollectorInstances = /* @__PURE__ */ new WeakMap();
 var NodeCollector = class _NodeCollector {
   static EMPTY = new _NodeCollector(void 0);
@@ -14614,6 +14657,8 @@ var NodeCollector = class _NodeCollector {
   idToNode = /* @__PURE__ */ new Map();
   idToNodeParents = /* @__PURE__ */ new Map();
   slugToNode = /* @__PURE__ */ new Map();
+  /** Keyed by {@link graphQlTypeKey} -- `typeId` alone is only unique within one API definition. */
+  typeIdToGraphQlTypeNode = /* @__PURE__ */ new Map();
   orphanedNodes = [];
   static collect(rootNode) {
     if (rootNode == null) {
@@ -14683,6 +14728,13 @@ var NodeCollector = class _NodeCollector {
       this.idToNodeParents.set(node.id, parents);
       this.nodesInOrder.push(node);
     }
+    if (node.type === "graphqlType") {
+      const key = graphQlTypeKey(node.apiDefinitionId, node.typeId, versionIdOf(parents));
+      const existingTypeNode = this.typeIdToGraphQlTypeNode.get(key);
+      if (existingTypeNode == null || existingTypeNode.hidden === true && node.hidden !== true) {
+        this.typeIdToGraphQlTypeNode.set(key, node);
+      }
+    }
     if (node.type === "sidebarRoot") {
       this.#last = void 0;
       this.#lastNeighboringNode = void 0;
@@ -14713,6 +14765,38 @@ var NodeCollector = class _NodeCollector {
   get slugMap() {
     return this.getSlugMap();
   }
+  /**
+   * GraphQL schema types that have their own page, keyed by
+   * {@link graphQlTypeKey} -- `apiDefinitionId` *and* `typeId`.
+   *
+   * Exists so that a field whose value is `Product` can be rendered as a link
+   * to `Product`'s page without every consumer re-walking the tree and picking
+   * its own winner when a type appears under multiple versions or products.
+   *
+   * The key includes the API definition because `typeId` is only unique within
+   * one definition: a docs site with several GraphQL APIs can legitimately have
+   * a `Product` in each, and keying on `typeId` alone would link an operation in
+   * one API to a type page in another.
+   */
+  getGraphQlTypeNodes = (0, import_function.once)(() => {
+    return this.typeIdToGraphQlTypeNode;
+  });
+  /**
+   * The type node documenting `typeId` within `apiDefinitionId` and `versionId`,
+   * if one exists. Pass the version the caller is rendering in; undefined on an
+   * unversioned site.
+   *
+   * There is deliberately no cross-version fallback: sending a reader in one
+   * version to another version's type page is worse than not linking at all,
+   * since the type may differ between versions.
+   */
+  getGraphQlTypeNode = (apiDefinitionId, typeId, versionId) => {
+    return this.typeIdToGraphQlTypeNode.get(graphQlTypeKey(apiDefinitionId, typeId, versionId));
+  };
+  /** Slug of the page documenting `typeId`, if one exists. See {@link getGraphQlTypeNode}. */
+  getGraphQlTypeSlug = (apiDefinitionId, typeId, versionId) => {
+    return this.getGraphQlTypeNode(apiDefinitionId, typeId, versionId)?.slug;
+  };
   get defaultVersionNode() {
     return this.defaultVersion;
   }
@@ -15662,6 +15746,36 @@ var FernNavigationV1ToLatest = class _FernNavigationV1ToLatest {
     };
     return latest;
   };
+  graphqlType = (node, parents) => {
+    const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+    const slug = navigation_exports.Slug(node.slug);
+    const canonicalSlug = this.#getAndSetCanonicalSlug(
+      [
+        `${apiDisambiguation}:api:graphqlType:${node.typeCategory}:${node.typeId}`,
+        this.#createTitleDisambiguationKey(node, parents)
+      ],
+      slug
+    );
+    const latest = {
+      type: "graphqlType",
+      id: navigation_exports.NodeId(node.id),
+      title: node.title,
+      slug,
+      canonicalSlug,
+      icon: node.icon,
+      hidden: node.hidden,
+      authed: node.authed,
+      collapsed: node.collapsed,
+      apiDefinitionId: node.apiDefinitionId,
+      typeId: node.typeId,
+      typeCategory: node.typeCategory,
+      availability: this.#availability(node.availability),
+      viewers: node.viewers,
+      orphaned: node.orphaned,
+      featureFlags: node.featureFlags
+    };
+    return latest;
+  };
   #variantChild = (child, parents) => {
     return visitDiscriminatedUnion_default(child)._visit({
       apiReference: (value) => this.apiReference(value, parents),
@@ -15692,7 +15806,8 @@ var FernNavigationV1ToLatest = class _FernNavigationV1ToLatest {
       webSocket: (value) => this.webSocket(value, parents),
       webhook: (value) => this.webhook(value, parents),
       grpc: (value) => this.grpc(value, parents),
-      graphql: (value) => this.graphql(value, parents)
+      graphql: (value) => this.graphql(value, parents),
+      graphqlType: (value) => this.graphqlType(value, parents)
     });
   };
   /**