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

package/dist/js/api-definition/index.js

@@ -96,6 +96,7 @@ __export(api_definition_exports, {
   GraphQlOperationIdSchema: () => GraphQlOperationIdSchema,
   GraphQlOperationSchema: () => LatestGraphQlOperationSchema,
   GraphQlOperationTypeSchema: () => LatestGraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema: () => GraphQlTypeCategorySchema,
   GrpcId: () => GrpcId,
   GrpcIdSchema: () => GrpcIdSchema,
   GrpcMethod: () => GrpcMethod,
@@ -1049,6 +1050,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;
@@ -1283,12 +1285,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),
@@ -1436,13 +1446,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(),
@@ -1465,6 +1468,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(),
@@ -1696,6 +1700,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(),
@@ -1911,7 +1916,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(
@@ -2220,6 +2226,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,
@@ -2262,6 +2269,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(),
@@ -2677,6 +2685,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({
@@ -2787,6 +2804,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({
@@ -2894,7 +2932,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
+          }
+        ]
+      })
+    ])
   ];
 }
 
@@ -3013,6 +3087,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) {
@@ -3093,10 +3170,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));
+          }
         }
       }
     }
@@ -3398,9 +3478,21 @@ function createGraphqlContext(node, apiDefinition) {
     );
     return void 0;
   }
+  const allIds = node.graphqlOperationIds ?? [node.graphqlOperationId];
+  const operations = [];
+  for (const id of allIds) {
+    const op = api.graphqlOperations[id];
+    if (op) {
+      operations.push(op);
+    }
+  }
+  if (operations.length === 0) {
+    operations.push(operation);
+  }
   return {
     node,
     operation,
+    operations,
     types: api.types
   };
 }
@@ -4328,6 +4420,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 !== "") ?? [],
@@ -4569,7 +4662,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))
       }));
     },
     [],
@@ -5010,6 +5104,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",
@@ -5306,7 +5401,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}`;
@@ -5315,15 +5413,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;
@@ -5352,49 +5467,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";
+    return typeReferenceToGraphQlType(shape.value, types, nonNull);
   }
-  if (shape.type === "object") {
-    return "Object";
-  }
-  if (shape.type === "undiscriminatedUnion" || shape.type === "discriminatedUnion") {
-    return "Object";
-  }
-  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) {
@@ -5612,13 +5722,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) {
@@ -6579,6 +6694,7 @@ var Transformer = class _Transformer {
   GraphQlOperationIdSchema,
   GraphQlOperationSchema,
   GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema,
   GrpcId,
   GrpcIdSchema,
   GrpcMethod,