@fern-api/fdr-sdk 1.2.33-9d7e001fd0 → 1.2.33-e73a4c8a93

package/dist/js/converters/index.mjs

@@ -776,6 +776,7 @@ var GraphQlOperationIdSchema = z2.string();
 function GraphQlOperationId(value) {
   return value;
 }
+var GraphQlTypeCategorySchema = z2.enum(["object", "input", "enum", "scalar", "interface", "union"]);
 var EnvironmentIdSchema = z2.string();
 function EnvironmentId(value) {
   return value;
@@ -1010,12 +1011,20 @@ var TypeReferenceSchema = z2.lazy(
     })
   ])
 );
+var GraphQlArgumentSchema = z2.object({
+  description: z2.string().nullish(),
+  availability: AvailabilitySchema.nullish(),
+  name: z2.string(),
+  type: TypeReferenceSchema,
+  defaultValue: z2.unknown().nullish()
+});
 var ObjectPropertySchema = z2.object({
   description: z2.string().nullish(),
   availability: AvailabilitySchema.nullish(),
   key: PropertyKeySchema,
   valueType: TypeReferenceSchema,
-  propertyAccess: ObjectPropertyAccessSchema.nullish()
+  propertyAccess: ObjectPropertyAccessSchema.nullish(),
+  arguments: z2.array(GraphQlArgumentSchema).nullish()
 });
 var ObjectTypeSchema = z2.object({
   extends: z2.array(TypeIdSchema),
@@ -1163,13 +1172,6 @@ var ErrorExampleSchema = z2.object({
   responseBody: ExampleErrorResponseSchema
 });
 var GraphQlOperationTypeSchema = z2.enum(["QUERY", "MUTATION", "SUBSCRIPTION"]);
-var GraphQlArgumentSchema = z2.object({
-  description: z2.string().nullish(),
-  availability: AvailabilitySchema.nullish(),
-  name: z2.string(),
-  type: TypeReferenceSchema,
-  defaultValue: z2.unknown().nullish()
-});
 var GraphQlExampleSchema = z2.object({
   description: z2.string().nullish(),
   name: z2.string().nullish(),
@@ -1192,6 +1194,7 @@ var GraphQlOperationSchema = z2.object({
   operationType: GraphQlOperationTypeSchema,
   name: z2.string(),
   displayName: z2.string().nullish(),
+  fieldPath: z2.array(z2.string()).nullish(),
   arguments: z2.array(GraphQlArgumentSchema).nullish(),
   returnType: TypeReferenceSchema,
   examples: z2.array(GraphQlExampleSchema).nullish(),
@@ -1423,6 +1426,7 @@ var RegisterErrorDeclarationV2Schema = z3.object({
 });
 var RegisterEndpointDefinitionSchema = z3.object({
   description: z3.string().nullish(),
+  subtitle: z3.string().nullish(),
   availability: AvailabilitySchema.nullish(),
   slug: z3.string().nullish(),
   auth: z3.boolean().nullish(),
@@ -1641,7 +1645,8 @@ var LatestObjectPropertySchema = z4.lazy(
     availability: AvailabilitySchema.nullish(),
     key: PropertyKeySchema,
     valueShape: LatestTypeShapeSchema,
-    propertyAccess: LatestObjectPropertyAccessSchema.nullish()
+    propertyAccess: LatestObjectPropertyAccessSchema.nullish(),
+    arguments: z4.array(LatestGraphQlArgumentSchema).nullish()
   })
 );
 var LatestParameterPropertySchema = z4.lazy(
@@ -1950,6 +1955,7 @@ var LatestExampleEndpointCallSchema = z4.object({
 });
 var LatestEndpointDefinitionSchema = z4.object({
   description: z4.string().nullish(),
+  subtitle: z4.string().nullish(),
   availability: AvailabilitySchema.nullish(),
   namespace: z4.array(z4.string()).nullish(),
   id: EndpointIdSchema,
@@ -1992,6 +1998,7 @@ var LatestGraphQlOperationSchema = z4.object({
   description: z4.string().nullish(),
   availability: AvailabilitySchema.nullish(),
   namespace: z4.array(z4.string()).nullish(),
+  fieldPath: z4.array(z4.string()).nullish(),
   id: GraphQlOperationIdSchema,
   operationType: LatestGraphQlOperationTypeSchema,
   name: z4.string(),
@@ -2263,6 +2270,7 @@ var ReadErrorDeclarationV2Schema = z5.object({
 });
 var ReadEndpointDefinitionSchema = z5.object({
   description: z5.string().nullish(),
+  subtitle: z5.string().nullish(),
   availability: AvailabilitySchema.nullish(),
   authed: z5.boolean(),
   authV2: z5.array(AuthSchemeIdSchema).nullish(),
@@ -3867,6 +3875,7 @@ __export(APIV1Db_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => GraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcMethodSchema: () => GrpcMethodSchema,
   GrpcProtocolSchema: () => GrpcProtocolSchema,
   HeaderAuthSchema: () => HeaderAuthSchema,
@@ -3977,6 +3986,7 @@ var DbHttpRequestsV2Schema = z15.object({
 });
 var DbEndpointDefinitionSchema = z15.object({
   description: z15.string().nullish(),
+  subtitle: z15.string().nullish(),
   availability: AvailabilitySchema.nullish(),
   authed: z15.boolean().nullish(),
   authV2: z15.array(AuthSchemeIdSchema).nullish(),
@@ -4120,6 +4130,7 @@ __export(APIV1Read_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => GraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcMethod: () => GrpcMethod,
   GrpcMethodSchema: () => GrpcMethodSchema,
   GrpcProtocolSchema: () => GrpcProtocolSchema,
@@ -4347,6 +4358,7 @@ __export(APIV1Write_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => GraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcMethodSchema: () => GrpcMethodSchema,
   GrpcProtocolSchema: () => GrpcProtocolSchema,
   HeaderAuthSchema: () => HeaderAuthSchema,
@@ -5254,6 +5266,7 @@ __export(FdrAPI_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => GraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcId: () => GrpcId,
   GrpcIdSchema: () => GrpcIdSchema,
   GrpcMethod: () => GrpcMethod,
@@ -6789,6 +6802,7 @@ function transformEndpoint({
       snippets
     }),
     description: writeShape.description,
+    subtitle: writeShape.subtitle,
     // htmlDescription,
     authed: writeShape.auth,
     authV2: writeShape.authV2,
@@ -7128,7 +7142,8 @@ function transformProperty({ writeShape }) {
     // htmlDescription,
     key: writeShape.key,
     valueType: writeShape.valueType,
-    propertyAccess: writeShape.propertyAccess
+    propertyAccess: writeShape.propertyAccess,
+    ...writeShape.arguments != null ? { arguments: writeShape.arguments } : {}
     // descriptionContainsMarkdown: true,
   };
 }
@@ -7277,6 +7292,7 @@ __export(api_definition_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => LatestGraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => LatestGraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcId: () => GrpcId,
   GrpcIdSchema: () => GrpcIdSchema,
   GrpcMethod: () => GrpcMethod,
@@ -7808,6 +7824,15 @@ function collectReferencedTypeIds(type, types, { maxDepth = 10 } = {}) {
           visitedTypeIds,
           depth: depth + 1
         });
+        if (property.arguments) {
+          for (const arg of property.arguments) {
+            stack.push({
+              shape: arg.type,
+              visitedTypeIds,
+              depth: depth + 1
+            });
+          }
+        }
       }
       if (obj.extraProperties) {
         stack.push({
@@ -7918,6 +7943,27 @@ function collectTypeDefinitionTree(type, types, { availability: rootAvailability
           visitedTypeIds,
           availability
         });
+        property.arguments?.forEach((arg) => {
+          stack.push({
+            type: arg.type,
+            path: [
+              ...parentpath,
+              {
+                type: "objectProperty",
+                key: property.key,
+                optional: unwrapReference(property.valueShape, types).isOptional
+              },
+              {
+                type: "graphqlArgument",
+                name: arg.name,
+                optional: unwrapReference(arg.type, types).isOptional
+              }
+            ],
+            descriptions: arg.description ? [arg.description] : [],
+            visitedTypeIds,
+            availability: coalesceAvailability([availability, property.availability, arg.availability])
+          });
+        });
       });
       if (obj.extraProperties) {
         stack.push({
@@ -8025,7 +8071,43 @@ function collectTypeDefinitionTreeForObjectProperty(property, types, rootPath =
           optional: unwrapReference(property.valueShape, types).isOptional
         }
       ]
-    })
+    }),
+    ...(property.arguments ?? []).flatMap((arg) => [
+      {
+        path: [
+          ...rootPath,
+          {
+            type: "objectProperty",
+            key: property.key,
+            optional: unwrapReference(property.valueShape, types).isOptional
+          },
+          {
+            type: "graphqlArgument",
+            name: arg.name,
+            optional: unwrapReference(arg.type, types).isOptional
+          }
+        ],
+        descriptions: arg.description ? [arg.description] : [],
+        availability: coalesceAvailability([property.availability, arg.availability])
+      },
+      ...collectTypeDefinitionTree(arg.type, types, {
+        maxDepth: maxDepth - 1,
+        availability: coalesceAvailability([property.availability, arg.availability]),
+        path: [
+          ...rootPath,
+          {
+            type: "objectProperty",
+            key: property.key,
+            optional: unwrapReference(property.valueShape, types).isOptional
+          },
+          {
+            type: "graphqlArgument",
+            name: arg.name,
+            optional: unwrapReference(arg.type, types).isOptional
+          }
+        ]
+      })
+    ])
   ];
 }
 
@@ -8144,6 +8226,9 @@ var ApiTypeIdVisitor = class _ApiTypeIdVisitor {
     typeShape.extends.forEach(visit);
     typeShape.properties.forEach((property) => {
       _ApiTypeIdVisitor.visitTypeShape(property.valueShape, visit);
+      property.arguments?.forEach((arg) => {
+        _ApiTypeIdVisitor.visitTypeShape(arg.type, visit);
+      });
     });
   }
   static visitTypeReference(typeReference, visit) {
@@ -8224,10 +8309,13 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
           found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
         }
       } else if (node.type === "graphql") {
-        const found = this.api.graphqlOperations[node.graphqlOperationId];
-        if (found) {
-          toRet.graphqlOperations[node.graphqlOperationId] = found;
-          found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+        const idsToInclude = node.graphqlOperationIds ?? [node.graphqlOperationId];
+        for (const opId of idsToInclude) {
+          const found = this.api.graphqlOperations[opId];
+          if (found) {
+            toRet.graphqlOperations[opId] = found;
+            found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+          }
         }
       }
     }
@@ -8529,9 +8617,21 @@ function createGraphqlContext(node, apiDefinition) {
     );
     return void 0;
   }
+  const allIds = node.graphqlOperationIds ?? [node.graphqlOperationId];
+  const operations = [];
+  for (const id of allIds) {
+    const op = api2.graphqlOperations[id];
+    if (op) {
+      operations.push(op);
+    }
+  }
+  if (operations.length === 0) {
+    operations.push(operation);
+  }
   return {
     node,
     operation,
+    operations,
     types: api2.types
   };
 }
@@ -9459,6 +9559,7 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
       displayName: v1?.name,
       operationId: v1?.urlSlug?.split("/")?.pop(),
       description: v1?.description,
+      subtitle: v1?.subtitle,
       availability: v1?.availability,
       method: v1?.method,
       path: v1?.path?.parts?.filter((part) => part?.value !== "") ?? [],
@@ -9700,7 +9801,8 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
         },
         propertyAccess: value?.propertyAccess ?? void 0,
         description: value?.description ?? void 0,
-        availability: value?.availability ?? void 0
+        availability: value?.availability ?? void 0,
+        arguments: value?.arguments?.map((arg) => this.migrateGraphQlArgument(arg))
       }));
     },
     [],
@@ -10141,6 +10243,7 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
       description: v1?.description,
       availability: v1?.availability,
       namespace,
+      fieldPath: v1?.fieldPath,
       arguments: v1?.arguments?.map((arg) => this.migrateGraphQlArgument(arg)),
       returnType: {
         type: "alias",
@@ -10437,7 +10540,10 @@ function generateGraphQlSnippet(context) {
     return `$${arg.name}: ${graphqlType}`;
   });
   const argumentUsage = args.map((arg) => `${arg.name}: $${arg.name}`);
-  const selectionSet = generateSelectionSet(operation.returnType, types, 2);
+  const fieldPath = operation.fieldPath;
+  const hasFieldPath = fieldPath != null && fieldPath.length > 0;
+  const selectionSetIndent = hasFieldPath ? 2 + fieldPath.length : 2;
+  const selectionSet = generateSelectionSet(operation.returnType, types, 2, /* @__PURE__ */ new Set(), selectionSetIndent);
   let query = operationKeyword;
   if (operationName || variableDefinitions.length > 0) {
     query += ` ${operationName}`;
@@ -10446,15 +10552,32 @@ function generateGraphQlSnippet(context) {
     }
   }
   query += " {\n";
-  query += `  ${operation.name}`;
+  const baseIndent = 2;
+  if (hasFieldPath) {
+    for (let i = 0; i < fieldPath.length; i++) {
+      const indent = " ".repeat(baseIndent + i * 2);
+      query += `${indent}${fieldPath[i]} {
+`;
+    }
+  }
+  const operationIndent = hasFieldPath ? " ".repeat(baseIndent + fieldPath.length * 2) : "  ";
+  query += `${operationIndent}${operation.name}`;
   if (argumentUsage.length > 0) {
     query += `(${argumentUsage.join(", ")})`;
   }
   if (selectionSet) {
     query += ` ${selectionSet}`;
   }
-  query += "\n}";
-  const response = generateResponseExample(operation.name, operation.returnType, types);
+  query += "\n";
+  if (hasFieldPath) {
+    for (let i = fieldPath.length - 1; i >= 0; i--) {
+      const indent = " ".repeat(baseIndent + i * 2);
+      query += `${indent}}
+`;
+    }
+  }
+  query += "}";
+  const response = generateResponseExample(operation.name, operation.returnType, types, fieldPath);
   const result = { query, variables, response };
   snippetCache.set(operation, result);
   return result;
@@ -10483,49 +10606,44 @@ function getExampleOperationName(operationType) {
       return "ExampleQuery";
   }
 }
-function typeShapeToGraphQlType(shape, types) {
+function typeShapeToGraphQlType(shape, types, nonNull = true) {
   if (shape.type === "alias") {
-    return typeReferenceToGraphQlType(shape.value, types);
-  }
-  if (shape.type === "enum") {
-    return "String";
-  }
-  if (shape.type === "object") {
-    return "Object";
-  }
-  if (shape.type === "undiscriminatedUnion" || shape.type === "discriminatedUnion") {
-    return "Object";
+    return typeReferenceToGraphQlType(shape.value, types, nonNull);
   }
-  return "String";
+  const base = shape.type === "enum" ? "String" : shape.type === "object" || shape.type === "undiscriminatedUnion" || shape.type === "discriminatedUnion" ? "Object" : "String";
+  return nonNull ? `${base}!` : base;
 }
-function typeReferenceToGraphQlType(ref, types) {
+function typeReferenceToGraphQlType(ref, types, nonNull = true) {
   switch (ref.type) {
-    case "primitive":
-      return primitiveToGraphQlType(ref.value);
+    case "primitive": {
+      const base = primitiveToGraphQlType(ref.value);
+      return nonNull ? `${base}!` : base;
+    }
     case "id": {
       const typeDef = types[ref.id];
-      if (typeDef) {
-        return typeDef.displayName ?? unnamespacedName(typeDef.name) ?? "Object";
-      }
-      return "Object";
+      const base = typeDef ? typeDef.displayName ?? unnamespacedName(typeDef.name) ?? "Object" : "Object";
+      return nonNull ? `${base}!` : base;
     }
     case "optional":
-      return typeShapeToGraphQlType(ref.shape, types);
+      return typeShapeToGraphQlType(ref.shape, types, false);
     case "nullable":
-      return typeShapeToGraphQlType(ref.shape, types);
-    case "list":
-      return `[${typeShapeToGraphQlType(ref.itemShape, types)}]`;
-    case "set":
-      return `[${typeShapeToGraphQlType(ref.itemShape, types)}]`;
+      return typeShapeToGraphQlType(ref.shape, types, false);
+    case "list": {
+      const inner = typeShapeToGraphQlType(ref.itemShape, types);
+      return nonNull ? `[${inner}]!` : `[${inner}]`;
+    }
+    case "set": {
+      const inner = typeShapeToGraphQlType(ref.itemShape, types);
+      return nonNull ? `[${inner}]!` : `[${inner}]`;
+    }
     case "map":
-      return "Object";
-    // Maps don't have direct GraphQL equivalent
+      return nonNull ? "Object!" : "Object";
     case "literal":
-      return "String";
+      return nonNull ? "String!" : "String";
     case "unknown":
-      return "Object";
+      return nonNull ? "Object!" : "Object";
     default:
-      return "String";
+      return nonNull ? "String!" : "String";
   }
 }
 function unnamespacedName(name) {
@@ -10743,13 +10861,18 @@ function generateSelectionSetFromReference(ref, types, depth, visited, indentLev
       return "";
   }
 }
-function generateResponseExample(operationName, returnType, types) {
+function generateResponseExample(operationName, returnType, types, fieldPath) {
   const data = generateResponseData(returnType, types, 3, /* @__PURE__ */ new Set());
-  return {
-    data: {
-      [operationName]: data
+  let responseData = { [operationName]: data };
+  if (fieldPath != null && fieldPath.length > 0) {
+    for (let i = fieldPath.length - 1; i >= 0; i--) {
+      const key = fieldPath[i];
+      if (key != null) {
+        responseData = { [key]: responseData };
+      }
     }
-  };
+  }
+  return { data: responseData };
 }
 function generateResponseData(shape, types, depth, visited) {
   if (depth <= 0) {
@@ -11713,6 +11836,7 @@ __export(navigation_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => GraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcId: () => GrpcId,
   GrpcIdSchema: () => GrpcIdSchema,
   GrpcMethod: () => GrpcMethod,
@@ -11836,7 +11960,7 @@ import { UnreachableCaseError as UnreachableCaseError2 } from "ts-essentials";
 
 // src/navigation/versions/latest/NavigationNodeApiLeaf.ts
 function isApiLeaf(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/latest/NavigationNodePageLeaf.ts
@@ -11906,7 +12030,8 @@ function getPageId(node) {
     webSocket: RETURN_UNDEFINED,
     webhook: RETURN_UNDEFINED,
     grpc: RETURN_UNDEFINED,
-    graphql: RETURN_UNDEFINED
+    graphql: RETURN_UNDEFINED,
+    graphqlType: RETURN_UNDEFINED
     // changelogYear: RETURN_UNDEFINED,
     // changelogMonth: RETURN_UNDEFINED,
   });
@@ -12268,6 +12393,9 @@ var ApiTypeIdVisitor2 = class _ApiTypeIdVisitor {
     typeShape.extends.forEach(visit);
     typeShape.properties.forEach((property) => {
       _ApiTypeIdVisitor.visitTypeReference(property.valueType, visit);
+      property.arguments?.forEach((arg) => {
+        _ApiTypeIdVisitor.visitTypeReference(arg.type, visit);
+      });
     });
   }
   static visitTypeReference(typeReference, visit) {
@@ -12424,11 +12552,8 @@ var ApiDefinitionPruner2 = class {
     if (node.type !== "graphql" || graphqlOperations == null) {
       return [];
     }
-    const graphqlOperationId = node.graphqlOperationId;
-    const found = graphqlOperations.find(
-      (graphqlOperation) => ApiDefinitionHolder.createGraphQlOperationId(graphqlOperation) === graphqlOperationId
-    );
-    return found ? [found] : [];
+    const idsToInclude = new Set(node.graphqlOperationIds ?? [node.graphqlOperationId]);
+    return graphqlOperations.filter((op) => idsToInclude.has(ApiDefinitionHolder.createGraphQlOperationId(op)));
   }
 };
 
@@ -12534,6 +12659,7 @@ __export(v1_exports2, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => GraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcId: () => GrpcId,
   GrpcIdSchema: () => GrpcIdSchema,
   GrpcMethod: () => GrpcMethod,
@@ -13152,12 +13278,15 @@ var ApiReferenceNavigationConverter = class _ApiReferenceNavigationConverter {
     }));
   }
   convertGraphQlNode(graphqlOperationId, graphqlOperation, parentSlug) {
+    const fieldPath = graphqlOperation.fieldPath;
+    const urlSlug = fieldPath != null && fieldPath.length > 0 ? [...fieldPath, graphqlOperation.name].join("-") : graphqlOperation.name;
     return this.#idgen.with(graphqlOperationId, (id) => ({
       id,
       type: "graphql",
       title: graphqlOperation.displayName ?? graphqlOperation.name,
       graphqlOperationId,
-      slug: parentSlug.apply({ urlSlug: graphqlOperation.name }).get(),
+      graphqlOperationIds: void 0,
+      slug: parentSlug.apply({ urlSlug }).get(),
       icon: void 0,
       hidden: void 0,
       operationType: graphqlOperation.operationType,
@@ -13171,6 +13300,86 @@ var ApiReferenceNavigationConverter = class _ApiReferenceNavigationConverter {
       featureFlags: void 0
     }));
   }
+  convertGraphQlOperationsToChildren(graphqlOperations, parentSlug) {
+    const groupedByParent = /* @__PURE__ */ new Map();
+    const insertionOrder = [];
+    for (const op of graphqlOperations) {
+      const graphqlOperationId = ApiDefinitionHolder.createGraphQlOperationId(op);
+      if (this.#visitedGraphqlOperations.has(graphqlOperationId)) {
+        continue;
+      }
+      this.#visitedGraphqlOperations.add(graphqlOperationId);
+      const parentField = op.fieldPath?.[0];
+      if (parentField != null && op.operationType === "QUERY") {
+        const group = groupedByParent.get(parentField);
+        if (group != null) {
+          group.push(op);
+        } else {
+          groupedByParent.set(parentField, [op]);
+          insertionOrder.push({ type: "group", parentField });
+        }
+      } else {
+        insertionOrder.push({ type: "flat", op });
+      }
+    }
+    const children = [];
+    const allSlugs = /* @__PURE__ */ new Set();
+    for (const entry of insertionOrder) {
+      if (entry.type === "flat") {
+        const fp = entry.op.fieldPath;
+        allSlugs.add(fp != null && fp.length > 0 ? [...fp, entry.op.name].join("-") : entry.op.name);
+      } else {
+        allSlugs.add(entry.parentField);
+      }
+    }
+    for (const entry of insertionOrder) {
+      if (entry.type === "flat") {
+        const opId = ApiDefinitionHolder.createGraphQlOperationId(entry.op);
+        children.push(this.convertGraphQlNode(opId, entry.op, parentSlug));
+      } else {
+        const operations = groupedByParent.get(entry.parentField);
+        if (operations == null) {
+          continue;
+        }
+        const firstOp = operations[0];
+        const opId = ApiDefinitionHolder.createGraphQlOperationId(firstOp);
+        const allOpIds = operations.map((op) => ApiDefinitionHolder.createGraphQlOperationId(op));
+        let slugSegment = entry.parentField;
+        const flatHasSameSlug = insertionOrder.some(
+          (e) => e.type === "flat" && (() => {
+            const fp = e.op.fieldPath;
+            const s = fp != null && fp.length > 0 ? [...fp, e.op.name].join("-") : e.op.name;
+            return s === slugSegment;
+          })()
+        );
+        if (flatHasSameSlug) {
+          slugSegment = `${entry.parentField}-fields`;
+        }
+        children.push(
+          this.#idgen.with(opId, (id) => ({
+            id,
+            type: "graphql",
+            title: entry.parentField,
+            graphqlOperationId: opId,
+            graphqlOperationIds: allOpIds.length > 1 ? allOpIds : void 0,
+            slug: parentSlug.apply({ urlSlug: slugSegment }).get(),
+            icon: void 0,
+            hidden: void 0,
+            operationType: firstOp.operationType,
+            apiDefinitionId: this.apiDefinitionId,
+            availability: navigation_exports.V1.convertAvailability(firstOp.availability),
+            playground: void 0,
+            authed: void 0,
+            collapsed: void 0,
+            viewers: void 0,
+            orphaned: void 0,
+            featureFlags: void 0
+          }))
+        );
+      }
+    }
+    return children;
+  }
   convertPackageToChildren(package_, parentSlug) {
     const children = [];
     let subpackageId = isSubpackage2(package_) ? package_.subpackageId : "__package__";
@@ -13218,14 +13427,7 @@ var ApiReferenceNavigationConverter = class _ApiReferenceNavigationConverter {
       children.push(this.convertWebhookNode(webhookId, webhook, parentSlug));
       this.#visitedWebhooks.add(webhookId);
     });
-    (package_.graphqlOperations ?? []).forEach((graphqlOperation) => {
-      const graphqlOperationId = ApiDefinitionHolder.createGraphQlOperationId(graphqlOperation);
-      if (this.#visitedGraphqlOperations.has(graphqlOperationId)) {
-        return;
-      }
-      children.push(this.convertGraphQlNode(graphqlOperationId, graphqlOperation, parentSlug));
-      this.#visitedGraphqlOperations.add(graphqlOperationId);
-    });
+    children.push(...this.convertGraphQlOperationsToChildren(package_.graphqlOperations ?? [], parentSlug));
     (package_.subpackages ?? []).forEach((subpackageId2) => {
       const subpackage = this.api.subpackages[subpackageId2];
       if (subpackage == null) {
@@ -15168,6 +15370,7 @@ var FernNavigationV1ToLatest = class _FernNavigationV1ToLatest {
       collapsed: node.collapsed,
       apiDefinitionId: node.apiDefinitionId,
       graphqlOperationId: node.graphqlOperationId,
+      graphqlOperationIds: node.graphqlOperationIds,
       operationType: node.operationType,
       playground: node.playground,
       availability: this.#availability(node.availability),
@@ -15673,6 +15876,7 @@ function getApiReferenceId(node) {
     webhook: RETURN_API_DEFINITION_ID,
     grpc: RETURN_API_DEFINITION_ID,
     graphql: RETURN_API_DEFINITION_ID,
+    graphqlType: RETURN_API_DEFINITION_ID,
     apiPackage: RETURN_API_DEFINITION_ID,
     unversioned: RETURN_UNDEFINED3,
     landingPage: RETURN_UNDEFINED3
@@ -16816,6 +17020,7 @@ function transformEndpoint2({
       (example) => convertExampleEndpointCall({ dbShape: example })
     ),
     description: dbShape.description,
+    subtitle: dbShape.subtitle,
     // htmlDescription: dbShape.htmlDescription,
     authed: dbShape.authed ?? false,
     authV2: dbShape.authV2,