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

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

@@ -832,6 +832,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;
@@ -1066,12 +1067,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),
@@ -1219,13 +1228,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(),
@@ -1248,6 +1250,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(),
@@ -1479,6 +1482,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(),
@@ -1694,7 +1698,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(
@@ -2003,6 +2008,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,
@@ -2045,6 +2051,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(),
@@ -2460,6 +2467,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({
@@ -2570,6 +2586,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({
@@ -2677,7 +2714,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
+          }
+        ]
+      })
+    ])
   ];
 }
 
@@ -2796,6 +2869,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) {
@@ -2876,10 +2952,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));
+          }
         }
       }
     }
@@ -3181,9 +3260,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
   };
 }
@@ -4111,6 +4202,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 !== "") ?? [],
@@ -4352,7 +4444,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))
       }));
     },
     [],
@@ -4793,6 +4886,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",
@@ -5089,7 +5183,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}`;
@@ -5098,15 +5195,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;
@@ -5135,49 +5249,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) {
@@ -5395,13 +5504,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) {
@@ -6361,6 +6475,7 @@ export {
   GraphQlOperationIdSchema,
   LatestGraphQlOperationSchema as GraphQlOperationSchema,
   LatestGraphQlOperationTypeSchema as GraphQlOperationTypeSchema,
+  GraphQlTypeCategorySchema,
   GrpcId,
   GrpcIdSchema,
   GrpcMethod,