@fern-api/fern-api-dev 3.48.2 → 3.48.3

package/cli.cjs

@@ -1302568,90 +1302568,6 @@ function addAuthCommand(cli) {
   commandGroup(cli, "auth <command>", "Authenticate fern", [addLoginCommand, addLogoutCommand, addTokenCommand]);
 }
 
-// ../cli-v2/lib/config/FernYmlConverter.js
-var FernYmlConverter = class {
-  /**
-   * Converts a sourced fern.yml schema to a FernYml configuration, performing
-   * validation beyond what zod can provide (e.g. does the SDK version actually
-   * exist, etc).
-   *
-   * Extracts plain values from the sourced schema while preserving
-   * access to the original sourced data for error reporting.
-   */
-  convert(sourced) {
-    return {
-      source: sourced,
-      edition: sourced.edition.value,
-      org: sourced.org.value,
-      cli: this.ifPresent(sourced.cli, (cli) => this.convertCli(cli)),
-      sdks: this.ifPresent(sourced.sdks, (sdks) => this.convertSdks(sdks))
-    };
-  }
-  convertCli(cli) {
-    return {
-      version: cli.version?.value
-    };
-  }
-  convertSdks(sourced) {
-    return {
-      autorelease: sourced.autorelease?.value,
-      defaultGroup: sourced.defaultGroup?.value,
-      readme: this.ifPresent(sourced.readme, (readme) => this.convertReadme(readme)),
-      targets: this.ifPresent(sourced.targets, (targets2) => this.convertTargets(targets2))
-    };
-  }
-  convertReadme(readme) {
-    return {
-      defaultEndpoint: readme.defaultEndpoint?.value
-    };
-  }
-  convertTargets(sourced) {
-    return Object.fromEntries(Object.entries(sourced).map(([name3, target]) => [name3, this.convertTarget(target)]));
-  }
-  convertTarget(sourced) {
-    return {
-      lang: sourced.lang?.value,
-      version: sourced.version?.value,
-      config: sourced.config?.value,
-      publish: this.ifPresent(sourced.publish, (publish2) => this.convertPublish(publish2)),
-      output: this.ifPresent(sourced.output, (output2) => this.convertOutput(output2))
-    };
-  }
-  convertPublish(publish2) {
-    return {
-      npm: this.ifPresent(publish2.npm, (npm) => this.convertNpm(npm))
-    };
-  }
-  convertNpm(npm) {
-    return {
-      packageName: npm.packageName.value
-    };
-  }
-  convertOutput(output2) {
-    return {
-      path: output2.path?.value,
-      git: this.ifPresent(output2.git, (git) => this.convertGit(git))
-    };
-  }
-  convertGit(git) {
-    return {
-      repository: git.repository.value
-    };
-  }
-  /**
-   * Helper to handle optional sourced objects. The Sourced<T | undefined> type
-   * creates a union of SourcedObject<T> | SourcedNullish<undefined>. At runtime,
-   * missing properties return actual undefined (not SourcedNullish) due to proxy
-   * behavior, but TypeScript can't know this. This helper narrows the type safely.
-   */
-  ifPresent(value, convert6) {
-    if (value == null || "value" in value) {
-      return void 0;
-    }
-    return convert6(value);
-  }
-};
-
 // ../config/lib/FernYml.js
 var FernYml;
 (function(FernYml2) {
@@ -1316457,13 +1316373,26 @@ var PublishSchema = external_exports.object({
   npm: NpmPublishSchema.optional()
 });
 
+// ../config/lib/schemas/SdkTargetLanguageSchema.js
+var SdkTargetLanguageSchema = external_exports.enum([
+  "csharp",
+  "go",
+  "java",
+  "php",
+  "python",
+  "ruby",
+  "rust",
+  "swift",
+  "typescript"
+]);
+
 // ../config/lib/schemas/SdkTargetSchema.js
 var SdkTargetSchema = external_exports.object({
-  lang: external_exports.string().optional(),
+  lang: SdkTargetLanguageSchema.optional(),
   version: external_exports.string().optional(),
   config: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   publish: PublishSchema.optional(),
-  output: OutputSchema.optional(),
+  output: OutputSchema,
   group: external_exports.array(external_exports.string()).optional()
 });
 
@@ -1324019,6 +1323948,11 @@ function createSourcedObject({ value, wrapChild, location: location2 }) {
   });
 }
 
+// ../source/lib/isNullish.js
+function isNullish(value) {
+  return value == null || typeof value === "object" && "value" in value;
+}
+
 // ../source/lib/Sourced.js
 var SourcedString = class {
   _value;
@@ -1325014,7 +1324948,7 @@ var FileFinder = class {
   }
 };
 
-// ../cli-v2/lib/config/FernYmlSchemaLoader.js
+// ../cli-v2/lib/config/fern-yml/FernYmlSchemaLoader.js
 var FernYmlSchemaLoader = class {
   finder;
   loader;
@@ -1325040,15 +1324974,14 @@ var FernYmlSchemaLoader = class {
   }
 };
 
-// ../cli-v2/lib/config/loadFernYml.js
+// ../cli-v2/lib/config/fern-yml/loadFernYml.js
 async function loadFernYml({ cwd: cwd2 }) {
   const schemaLoader = new FernYmlSchemaLoader({ cwd: cwd2 });
   const result = await schemaLoader.load();
   if (!result.success) {
     throw new ValidationError(result.issues);
   }
-  const converter = new FernYmlConverter();
-  return converter.convert(result.sourced);
+  return result;
 }
 
 // ../cli-v2/lib/commands/check.js
@@ -1325059,12 +1324992,174 @@ async function handleCheck(context2, _args) {
   await loadFernYml({ cwd: context2.cwd });
 }
 
+// ../cli-v2/lib/sdk/config/getDockerImageReference.js
+var SDK_DOCKER_IMAGES = {
+  csharp: "fernapi/fern-csharp-sdk",
+  go: "fernapi/fern-go-sdk",
+  java: "fernapi/fern-java-sdk",
+  php: "fernapi/fern-php-sdk",
+  python: "fernapi/fern-python-sdk",
+  ruby: "fernapi/fern-ruby-sdk",
+  rust: "fernapi/fern-rust-sdk",
+  swift: "fernapi/fern-swift-sdk",
+  typescript: "fernapi/fern-typescript-node-sdk"
+};
+function getDockerImageReference({ lang, version: version7 }) {
+  const image3 = SDK_DOCKER_IMAGES[lang];
+  const tag = version7 ?? "latest";
+  return {
+    image: image3,
+    tag
+  };
+}
+
+// ../cli-v2/lib/sdk/config/Language.js
+var LANGUAGES = ["csharp", "go", "java", "php", "python", "ruby", "rust", "swift", "typescript"];
+
+// ../cli-v2/lib/sdk/config/SdkConfigConverter.js
+var SdkConfigConverter = class {
+  logger;
+  issues = [];
+  constructor({ logger }) {
+    this.logger = logger;
+  }
+  /**
+   * Converts a sourced fern.yml schema to SDK generation configuration.
+   *
+   * @param sourced - The sourced fern.yml schema with source location tracking.
+   * @returns Result with either the converted config or validation issues.
+   */
+  convert({ fernYml }) {
+    if (!fernYml.success) {
+      return {
+        success: false,
+        issues: fernYml.issues
+      };
+    }
+    const sdks = fernYml.data.sdks;
+    const sourced = fernYml.sourced.sdks;
+    if (sdks == null || isNullish(sourced)) {
+      return {
+        success: false,
+        issues: []
+      };
+    }
+    const config3 = {
+      org: fernYml.data.org,
+      defaultGroup: sdks.defaultGroup,
+      targets: this.convertTargets({
+        targetsConfig: sdks.targets,
+        sourced: sourced.targets
+      })
+    };
+    if (this.issues.length > 0) {
+      return {
+        success: false,
+        issues: this.issues
+      };
+    }
+    return {
+      success: true,
+      config: config3
+    };
+  }
+  convertTargets({ targetsConfig, sourced }) {
+    const targets2 = [];
+    for (const [name3, target] of Object.entries(targetsConfig)) {
+      const sourcedTarget = sourced[name3];
+      if (sourcedTarget == null) {
+        continue;
+      }
+      const converted = this.convertTarget({
+        name: name3,
+        target,
+        sourced: sourcedTarget
+      });
+      if (converted != null) {
+        targets2.push(converted);
+      }
+    }
+    return targets2;
+  }
+  convertTarget({ name: name3, target, sourced }) {
+    const lang = this.resolveLanguage({ name: name3, target, sourced });
+    if (lang == null) {
+      return void 0;
+    }
+    const resolvedDockerImage = this.resolveDockerImage({ name: name3, lang, version: target.version });
+    return {
+      name: name3,
+      lang,
+      image: resolvedDockerImage.image,
+      version: target.version ?? resolvedDockerImage.tag,
+      config: target.config != null ? this.convertConfig(target.config) : void 0,
+      output: this.convertOutput({ output: target.output, sourced: sourced.output }),
+      publish: target.publish != null && !isNullish(sourced.publish) ? this.convertPublish({ publish: target.publish, sourced: sourced.publish }) : void 0,
+      groups: target.group ?? []
+    };
+  }
+  resolveDockerImage({ name: name3, lang, version: version7 }) {
+    const dockerImage = getDockerImageReference({ lang, version: version7 });
+    if (version7 == null) {
+      this.logger.debug(`Target "${name3}" has no version specified, using ${dockerImage}`);
+    }
+    return dockerImage;
+  }
+  convertConfig(config3) {
+    return config3;
+  }
+  convertOutput({ output: output2, sourced }) {
+    return {
+      path: output2.path,
+      git: output2.git != null && !isNullish(sourced.git) ? this.convertGit({ git: output2.git, sourced: sourced.git }) : void 0
+    };
+  }
+  convertGit({ git, sourced: _sourced }) {
+    return {
+      repository: git.repository
+    };
+  }
+  convertPublish({ publish: publish2, sourced }) {
+    return {
+      npm: publish2.npm != null && !isNullish(sourced.npm) ? this.convertNpm({ npm: publish2.npm, sourced: sourced.npm }) : void 0
+    };
+  }
+  convertNpm({ npm, sourced: _sourced }) {
+    return {
+      packageName: npm.packageName
+    };
+  }
+  resolveLanguage({ name: name3, target, sourced }) {
+    if (target.lang != null) {
+      return target.lang;
+    }
+    const lang = name3;
+    if (LANGUAGES.includes(lang)) {
+      return lang;
+    }
+    this.issues.push(new ValidationIssue({
+      message: `target "${name3}" is not a recognized language; please specify the "lang" property`,
+      location: sourced.$loc
+    }));
+    return void 0;
+  }
+};
+
 // ../cli-v2/lib/commands/sdk/generate.js
 function addGenerateCommand(cli) {
   command2(cli, "generate", "Generate SDKs configured in fern.yml", handleGenerate);
 }
 async function handleGenerate(context2, _args) {
-  context2.stdout.info("Generating SDKs...");
+  const fernYml = await loadFernYml({ cwd: context2.cwd });
+  const converter = new SdkConfigConverter({ logger: context2.stderr });
+  const result = converter.convert({ fernYml });
+  if (!result.success) {
+    throw new ValidationError(result.issues);
+  }
+  context2.stdout.info(`Generating SDKs for org: ${result.config.org}`);
+  for (const target of result.config.targets) {
+    context2.stdout.info(`  ${target.name}: ${target.image}:${target.version}`);
+  }
 }
 
 // ../cli-v2/lib/commands/sdk.js
@@ -1338591,7 +1338686,7 @@ function sortBy(arr, criteria) {
   return orderBy(arr, criteria, ["asc"]);
 }
 
-// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.143.9-f12426eb4_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
+// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.144.6-a76e5b58c_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
 var import_ts_essentials = __toESM(require_dist2(), 1);
 
 // ../../../node_modules/.pnpm/es-toolkit@1.43.0/node_modules/es-toolkit/dist/object/mapValues.mjs
@@ -1338612,7 +1338707,7 @@ function words2(str3) {
   return Array.from(str3.match(CASE_SPLIT_PATTERN) ?? []);
 }
 
-// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.143.9-f12426eb4_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
+// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.144.6-a76e5b58c_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
 var import_qs = __toESM(require_lib2(), 1);
 var import_ts_essentials2 = __toESM(require_dist2(), 1);
 var import_ts_essentials3 = __toESM(require_dist2(), 1);
@@ -1344353,7 +1344448,7 @@ function kebabCase2(str3) {
   return words$1.map((word) => word.toLowerCase()).join("-");
 }
 
-// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.143.9-f12426eb4_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
+// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.144.6-a76e5b58c_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
 var import_fast_deep_equal = __toESM(require_fast_deep_equal(), 1);
 var import_ts_essentials4 = __toESM(require_dist2(), 1);
 var import_url_join2 = __toESM(require_url_join(), 1);
@@ -1344372,7 +1344467,7 @@ function once(func) {
   };
 }
 
-// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.143.9-f12426eb4_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
+// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.144.6-a76e5b58c_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
 var import_ts_essentials6 = __toESM(require_dist2(), 1);
 var import_ts_essentials7 = __toESM(require_dist2(), 1);
 var import_url_join3 = __toESM(require_url_join(), 1);
@@ -1344602,7 +1344697,7 @@ var esm_default2 = typeof structuredClone === "function" ? (
   (any9, options2) => options2 && ("json" in options2 || "lossy" in options2) ? deserialize(serialize(any9, options2)) : structuredClone(any9)
 ) : (any9, options2) => deserialize(serialize(any9, options2));
 
-// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.143.9-f12426eb4_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
+// ../../../node_modules/.pnpm/@fern-api+fdr-sdk@0.144.6-a76e5b58c_typescript@5.9.3/node_modules/@fern-api/fdr-sdk/dist/js/index.mjs
 var import_ts_essentials12 = __toESM(require_dist2(), 1);
 var __create2 = Object.create;
 var __defProp2 = Object.defineProperty;
@@ -1344850,6 +1344945,8 @@ __export2(api_definition_exports, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
+  GraphQlOperationType: () => GraphQlOperationType,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HTTP_SNIPPET_CLIENTS: () => HTTP_SNIPPET_CLIENTS,
@@ -1344887,6 +1344984,7 @@ __export2(api_definition_exports, {
   commons: () => commons_exports3,
   convertToCurl: () => convertToCurl,
   createEndpointContext: () => createEndpointContext,
+  createGraphqlContext: () => createGraphqlContext,
   createGrpcContext: () => createGrpcContext,
   createSnippetGenerators: () => createSnippetGenerators,
   createWebSocketContext: () => createWebSocketContext,
@@ -1344894,6 +1344992,7 @@ __export2(api_definition_exports, {
   endpoint: () => endpoint_exports,
   filterReferencedTypes: () => filterReferencedTypes,
   generateCurlSnippet: () => generateCurlSnippet,
+  generateGraphQlSnippet: () => generateGraphQlSnippet,
   generateHttpSnippets: () => generateHttpSnippets,
   generateSdkSnippetForLanguage: () => generateSdkSnippetForLanguage,
   generateSdkSnippets: () => generateSdkSnippets,
@@ -1344901,6 +1345000,7 @@ __export2(api_definition_exports, {
   getApiLatest: () => getApiLatest_exports,
   getHarRequest: () => getHarRequest,
   getMessageForStatus: () => getMessageForStatus,
+  graphql: () => graphql_exports,
   joiner: () => joiner,
   preprocessQueryParameters: () => preprocessQueryParameters,
   prune: () => prune,
@@ -1345401,12 +1345501,14 @@ function visitDiscriminatedUnion2(item, discriminant8 = "type") {
 var visitDiscriminatedUnion_default = visitDiscriminatedUnion2;
 var latest_exports = {};
 __export2(latest_exports, {
+  GraphQlOperationType: () => GraphQlOperationType,
   ObjectPropertyAccess: () => ObjectPropertyAccess,
   WebhookHttpMethod: () => WebhookHttpMethod,
   auth: () => auth_exports3,
   commons: () => commons_exports3,
   endpoint: () => endpoint_exports,
   getApiLatest: () => getApiLatest_exports,
+  graphql: () => graphql_exports,
   type_: () => type_exports,
   webhook: () => webhook_exports,
   websocket: () => websocket_exports
@@ -1345447,6 +1345549,15 @@ var Error2 = {
 var auth_exports3 = {};
 var commons_exports3 = {};
 var endpoint_exports = {};
+var graphql_exports = {};
+__export2(graphql_exports, {
+  GraphQlOperationType: () => GraphQlOperationType
+});
+var GraphQlOperationType = {
+  Query: "QUERY",
+  Mutation: "MUTATION",
+  Subscription: "SUBSCRIPTION"
+};
 var type_exports = {};
 __export2(type_exports, {
   ObjectPropertyAccess: () => ObjectPropertyAccess
@@ -1345496,6 +1345607,7 @@ __export2(commons_exports32, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1345544,6 +1345656,9 @@ function EnvironmentId(value) {
 function FileId(value) {
   return value;
 }
+function GraphQlOperationId(value) {
+  return value;
+}
 function GrpcId(value) {
   return value;
 }
@@ -1345860,7 +1345975,8 @@ function primitiveToDefault(shape) {
     uuid: (uuid3) => uuid3.default,
     base64: (base643) => base643.default,
     date: (value) => value.default,
-    bigInteger: (value) => value.default
+    bigInteger: (value) => value.default,
+    scalar: (value) => value.default
   });
 }
 function collectReferencedTypeIds(type8, types4, { maxDepth = 10 } = {}) {
@@ -1346177,6 +1346293,12 @@ var ApiTypeIdVisitor = class _ApiTypeIdVisitor {
       }
     });
   }
+  static visitGraphQlOperation(operation, visit3) {
+    operation.arguments?.forEach((arg) => {
+      _ApiTypeIdVisitor.visitTypeShape(arg.type, visit3);
+    });
+    _ApiTypeIdVisitor.visitTypeShape(operation.returnType, visit3);
+  }
   static visitWebhookPayloadShape(payloadShape, visit3) {
     return visitDiscriminatedUnion_default(payloadShape)._visit({
       object: (value) => _ApiTypeIdVisitor.visitObjectType(value, visit3),
@@ -1346269,6 +1346391,7 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
       endpoints: {},
       websockets: {},
       webhooks: {},
+      graphqlOperations: {},
       types: {},
       subpackages: {},
       auths: {}
@@ -1346303,6 +1346426,12 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
           toRet.endpoints[grpcIdAsEndpointId] = found;
           found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
         }
+      } else if (node3.type === "graphql") {
+        const found = this.api.graphqlOperations[node3.graphqlOperationId];
+        if (found) {
+          toRet.graphqlOperations[node3.graphqlOperationId] = found;
+          found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+        }
       }
     }
     toRet.types = this.pruneTypes(toRet);
@@ -1346334,6 +1346463,9 @@ var ApiDefinitionPruner = class _ApiDefinitionPruner {
     for (const webhook of Object.values(partiallyPrunedApi.webhooks)) {
       ApiTypeIdVisitor.visitWebhookDefinition(webhook, (typeId) => typeIds.add(typeId));
     }
+    for (const graphqlOperation of Object.values(partiallyPrunedApi.graphqlOperations)) {
+      ApiTypeIdVisitor.visitGraphQlOperation(graphqlOperation, (typeId) => typeIds.add(typeId));
+    }
     typeIds = this.expandTypeIds(typeIds);
     const types4 = {};
     typeIds.forEach((typeId) => {
@@ -1346536,6 +1346668,21 @@ function createGrpcContext(node3, apiDefinition) {
     types: api.types
   };
 }
+function createGraphqlContext(node3, apiDefinition) {
+  if (!node3) {
+    return void 0;
+  }
+  const api = apiDefinition != null ? prune(apiDefinition, node3) : void 0;
+  const operation = api?.graphqlOperations[node3.graphqlOperationId];
+  if (!operation) {
+    return void 0;
+  }
+  return {
+    node: node3,
+    operation,
+    types: api.types
+  };
+}
 var APIV1Read_exports = {};
 __export2(APIV1Read_exports, {
   ApiDefinitionId: () => ApiDefinitionId,
@@ -1346547,6 +1346694,8 @@ __export2(APIV1Read_exports, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
+  GraphQlOperationType: () => GraphQlOperationType2,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1346572,18 +1346721,21 @@ __export2(APIV1Read_exports, {
   getApi: () => getApi_exports,
   getEndpointById: () => getEndpointById_exports,
   getEndpointByLocator: () => getEndpointByLocator_exports,
+  graphql: () => graphql_exports2,
   type_: () => type_exports2,
   webhook: () => webhook_exports2,
   websocket: () => websocket_exports2
 });
 var read_exports = {};
 __export2(read_exports, {
+  GraphQlOperationType: () => GraphQlOperationType2,
   ObjectPropertyAccess: () => ObjectPropertyAccess2,
   SupportedLanguage: () => SupportedLanguage,
   endpoint: () => endpoint_exports2,
   getApi: () => getApi_exports,
   getEndpointById: () => getEndpointById_exports,
   getEndpointByLocator: () => getEndpointByLocator_exports,
+  graphql: () => graphql_exports2,
   type_: () => type_exports2,
   webhook: () => webhook_exports2,
   websocket: () => websocket_exports2
@@ -1346720,6 +1346872,15 @@ var SupportedLanguage = {
   Swift: "swift",
   Rust: "rust"
 };
+var graphql_exports2 = {};
+__export2(graphql_exports2, {
+  GraphQlOperationType: () => GraphQlOperationType2
+});
+var GraphQlOperationType2 = {
+  Query: "QUERY",
+  Mutation: "MUTATION",
+  Subscription: "SUBSCRIPTION"
+};
 var type_exports2 = {};
 __export2(type_exports2, {
   ObjectPropertyAccess: () => ObjectPropertyAccess2
@@ -1346748,6 +1346909,7 @@ function joiner(force = false) {
       endpoints: { ...first3.endpoints },
       websockets: { ...first3.websockets },
       webhooks: { ...first3.webhooks },
+      graphqlOperations: { ...first3.graphqlOperations },
       types: { ...first3.types },
       subpackages: { ...first3.subpackages },
       auths: { ...first3.auths },
@@ -1347447,6 +1347609,7 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
   endpoints = {};
   websockets = {};
   webhooks = {};
+  graphqlOperations = {};
   subpackages = {};
   types = {};
   migrate = () => {
@@ -1347473,6 +1347636,10 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
         const id2 = _ApiDefinitionV1ToLatest.createWebhookId(webhook, subpackageId);
         this.webhooks[id2] = this.migrateWebhook(id2, webhook, namespace);
       });
+      pkg2.graphqlOperations?.forEach((graphqlOp) => {
+        const id2 = graphqlOp.id;
+        this.graphqlOperations[id2] = this.migrateGraphQlOperation(graphqlOp, namespace);
+      });
     });
     Object.values(this.v1.subpackages).forEach((subpackage) => {
       this.subpackages[subpackage.subpackageId] = this.migrateSubpackage(subpackage);
@@ -1347483,6 +1347650,7 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
       endpoints: this.endpoints,
       websockets: this.websockets,
       webhooks: this.webhooks,
+      graphqlOperations: this.graphqlOperations,
       types: this.types,
       subpackages: this.subpackages,
       auths: this.v1.authSchemes ? this.v1.authSchemes : this.v1.auth ? { [AUTH_SCHEME_ID]: this.v1.auth } : {},
@@ -1348082,6 +1348250,36 @@ var ApiDefinitionV1ToLatest = class _ApiDefinitionV1ToLatest {
     }
     return toRet;
   }
+  migrateGraphQlOperation = (v1, namespace) => {
+    return {
+      id: v1.id,
+      operationType: v1.operationType,
+      name: v1.name,
+      displayName: v1.displayName,
+      description: v1.description,
+      availability: v1.availability,
+      namespace,
+      arguments: v1.arguments?.map((arg) => this.migrateGraphQlArgument(arg)),
+      returnType: {
+        type: "alias",
+        value: this.migrateTypeReference(v1.returnType)
+      },
+      examples: v1.examples,
+      snippets: v1.snippets
+    };
+  };
+  migrateGraphQlArgument = (v1) => {
+    return {
+      name: v1.name,
+      description: v1.description,
+      availability: v1.availability,
+      type: {
+        type: "alias",
+        value: this.migrateTypeReference(v1.type)
+      },
+      defaultValue: v1.defaultValue
+    };
+  };
 };
 var nP = Object.create;
 var bn = Object.defineProperty;
@@ -1395759,6 +1395957,361 @@ async function generateSnippetsForExample(apiDefinition, endpoint3, example, dyn
   }
   return snippets;
 }
+var snippetCache = /* @__PURE__ */ new WeakMap();
+function generateGraphQlSnippet(context2) {
+  const cached2 = snippetCache.get(context2.operation);
+  if (cached2) {
+    return cached2;
+  }
+  const { operation, types: types4 } = context2;
+  const operationKeyword = getOperationKeyword(operation.operationType);
+  const operationName = capitalizeFirst(operation.name);
+  const args = operation.arguments ?? [];
+  const variables = {};
+  const variableDefinitions = args.map((arg) => {
+    const graphqlType = typeShapeToGraphQlType(arg.type, types4);
+    const exampleValue = generateExampleValue(arg.type, types4, arg.defaultValue);
+    variables[arg.name] = exampleValue;
+    return `$${arg.name}: ${graphqlType}`;
+  });
+  const argumentUsage = args.map((arg) => `${arg.name}: $${arg.name}`);
+  const selectionSet = generateSelectionSet(operation.returnType, types4, 2);
+  let query = operationKeyword;
+  if (operationName || variableDefinitions.length > 0) {
+    query += ` ${operationName}`;
+    if (variableDefinitions.length > 0) {
+      query += `(${variableDefinitions.join(", ")})`;
+    }
+  }
+  query += " {\n";
+  query += `  ${operation.name}`;
+  if (argumentUsage.length > 0) {
+    query += `(${argumentUsage.join(", ")})`;
+  }
+  if (selectionSet) {
+    query += ` ${selectionSet}`;
+  }
+  query += "\n}";
+  const response = generateResponseExample(operation.name, operation.returnType, types4);
+  const result = { query, variables, response };
+  snippetCache.set(operation, result);
+  return result;
+}
+function getOperationKeyword(operationType) {
+  switch (operationType) {
+    case "QUERY":
+      return "query";
+    case "MUTATION":
+      return "mutation";
+    case "SUBSCRIPTION":
+      return "subscription";
+    default:
+      return "query";
+  }
+}
+function capitalizeFirst(str3) {
+  if (!str3) {
+    return str3;
+  }
+  return str3.charAt(0).toUpperCase() + str3.slice(1);
+}
+function typeShapeToGraphQlType(shape, types4) {
+  if (shape.type === "alias") {
+    return typeReferenceToGraphQlType(shape.value, types4);
+  }
+  if (shape.type === "enum") {
+    return "String";
+  }
+  if (shape.type === "object") {
+    return "Object";
+  }
+  if (shape.type === "undiscriminatedUnion" || shape.type === "discriminatedUnion") {
+    return "Object";
+  }
+  return "String";
+}
+function typeReferenceToGraphQlType(ref2, types4) {
+  switch (ref2.type) {
+    case "primitive":
+      return primitiveToGraphQlType(ref2.value);
+    case "id": {
+      const typeDef = types4[ref2.id];
+      if (typeDef) {
+        return typeDef.name ?? "Object";
+      }
+      return "Object";
+    }
+    case "optional":
+      return typeShapeToGraphQlType(ref2.shape, types4);
+    case "nullable":
+      return typeShapeToGraphQlType(ref2.shape, types4);
+    case "list":
+      return `[${typeShapeToGraphQlType(ref2.itemShape, types4)}]`;
+    case "set":
+      return `[${typeShapeToGraphQlType(ref2.itemShape, types4)}]`;
+    case "map":
+      return "Object";
+    // Maps don't have direct GraphQL equivalent
+    case "literal":
+      return "String";
+    case "unknown":
+      return "Object";
+    default:
+      return "String";
+  }
+}
+function primitiveToGraphQlType(primitive) {
+  switch (primitive.type) {
+    case "scalar":
+      return primitive.name;
+    case "integer":
+    case "long":
+    case "uint":
+    case "uint64":
+    case "bigInteger":
+      return "Int";
+    case "double":
+      return "Float";
+    case "boolean":
+      return "Boolean";
+    case "string":
+    case "uuid":
+    case "base64":
+    case "datetime":
+    case "date":
+    default:
+      return "String";
+  }
+}
+function generateExampleValue(shape, types4, defaultValue) {
+  if (defaultValue !== void 0) {
+    return defaultValue;
+  }
+  if (shape.type === "alias") {
+    return generateExampleValueFromReference(shape.value, types4);
+  }
+  if (shape.type === "enum") {
+    const firstValue = shape.values?.[0];
+    return firstValue?.value ?? "EXAMPLE_VALUE";
+  }
+  if (shape.type === "object") {
+    return {};
+  }
+  if (shape.type === "undiscriminatedUnion" || shape.type === "discriminatedUnion") {
+    return {};
+  }
+  return "example";
+}
+function generateExampleValueFromReference(ref2, types4) {
+  switch (ref2.type) {
+    case "primitive":
+      return generateExamplePrimitiveValue(ref2.value);
+    case "id": {
+      const typeDef = types4[ref2.id];
+      if (typeDef?.shape) {
+        return generateExampleValue(typeDef.shape, types4);
+      }
+      return {};
+    }
+    case "optional":
+    case "nullable":
+      return generateExampleValue(ref2.shape, types4);
+    case "list":
+    case "set":
+      return [generateExampleValue(ref2.itemShape, types4)];
+    case "map":
+      return {};
+    case "literal":
+      return ref2.value.value;
+    case "unknown":
+      return {};
+    default:
+      return "example";
+  }
+}
+function generateExamplePrimitiveValue(primitive) {
+  switch (primitive.type) {
+    case "integer":
+    case "long":
+    case "uint":
+    case "uint64":
+    case "bigInteger":
+      return 0;
+    case "double":
+      return 0;
+    case "boolean":
+      return true;
+    case "string":
+      return "example";
+    case "uuid":
+      return "00000000-0000-0000-0000-000000000000";
+    case "datetime":
+      return (/* @__PURE__ */ new Date()).toISOString();
+    case "date":
+      return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    case "base64":
+      return "ZXhhbXBsZQ==";
+    case "scalar":
+      return primitive.default ?? primitive.name;
+    default:
+      return "example";
+  }
+}
+function generateSelectionSet(shape, types4, depth, visited = /* @__PURE__ */ new Set(), indentLevel = 2) {
+  if (depth <= 0) {
+    return "";
+  }
+  if (shape.type === "alias") {
+    return generateSelectionSetFromReference(shape.value, types4, depth, visited, indentLevel);
+  }
+  if (shape.type === "object") {
+    const properties7 = shape.properties ?? [];
+    if (properties7.length === 0) {
+      return "";
+    }
+    const indent3 = "  ".repeat(indentLevel);
+    const closingIndent = "  ".repeat(indentLevel - 1);
+    const fields = properties7.slice(0, 10).map((prop) => {
+      const nestedSelection = generateSelectionSet(
+        prop.valueShape,
+        types4,
+        depth - 1,
+        visited,
+        indentLevel + 1
+      );
+      if (nestedSelection) {
+        return `${indent3}${prop.key} ${nestedSelection}`;
+      }
+      return `${indent3}${prop.key}`;
+    });
+    return `{
+${fields.join("\n")}
+${closingIndent}}`;
+  }
+  if (shape.type === "enum") {
+    return "";
+  }
+  if (shape.type === "undiscriminatedUnion" || shape.type === "discriminatedUnion") {
+    return "";
+  }
+  return "";
+}
+function generateSelectionSetFromReference(ref2, types4, depth, visited, indentLevel) {
+  switch (ref2.type) {
+    case "id": {
+      if (visited.has(ref2.id)) {
+        return "";
+      }
+      const typeDef = types4[ref2.id];
+      if (typeDef?.shape) {
+        visited.add(ref2.id);
+        const result = generateSelectionSet(typeDef.shape, types4, depth, visited, indentLevel);
+        visited.delete(ref2.id);
+        return result;
+      }
+      return "";
+    }
+    case "optional":
+    case "nullable":
+      return generateSelectionSet(ref2.shape, types4, depth, visited, indentLevel);
+    case "list":
+    case "set":
+      return generateSelectionSet(ref2.itemShape, types4, depth, visited, indentLevel);
+    case "primitive":
+    case "literal":
+    case "unknown":
+    case "map":
+    default:
+      return "";
+  }
+}
+function generateResponseExample(operationName, returnType, types4) {
+  const data2 = generateResponseData(returnType, types4, 3, /* @__PURE__ */ new Set());
+  return {
+    data: {
+      [operationName]: data2
+    }
+  };
+}
+function generateResponseData(shape, types4, depth, visited) {
+  if (depth <= 0) {
+    return null;
+  }
+  if (shape.type === "alias") {
+    return generateResponseDataFromReference(shape.value, types4, depth, visited);
+  }
+  if (shape.type === "object") {
+    const properties7 = shape.properties ?? [];
+    if (properties7.length === 0) {
+      return {};
+    }
+    const result = {};
+    for (const prop of properties7.slice(0, 10)) {
+      result[prop.key] = generateResponseData(prop.valueShape, types4, depth - 1, visited);
+    }
+    return result;
+  }
+  if (shape.type === "enum") {
+    const firstValue = shape.values?.[0];
+    return firstValue?.value ?? "EXAMPLE_VALUE";
+  }
+  if (shape.type === "undiscriminatedUnion") {
+    const firstVariant = shape.variants?.[0];
+    if (firstVariant?.shape) {
+      return generateResponseData(firstVariant.shape, types4, depth, visited);
+    }
+    return {};
+  }
+  if (shape.type === "discriminatedUnion") {
+    const firstVariant = shape.variants?.[0];
+    if (firstVariant) {
+      const result = {
+        [shape.discriminant]: firstVariant.discriminantValue
+      };
+      if (firstVariant.properties) {
+        for (const prop of firstVariant.properties.slice(0, 10)) {
+          result[prop.key] = generateResponseData(prop.valueShape, types4, depth - 1, visited);
+        }
+      }
+      return result;
+    }
+    return {};
+  }
+  return null;
+}
+function generateResponseDataFromReference(ref2, types4, depth, visited) {
+  switch (ref2.type) {
+    case "primitive":
+      return generateExamplePrimitiveValue(ref2.value);
+    case "id": {
+      if (visited.has(ref2.id)) {
+        return null;
+      }
+      const typeDef = types4[ref2.id];
+      if (typeDef?.shape) {
+        visited.add(ref2.id);
+        const result = generateResponseData(typeDef.shape, types4, depth, visited);
+        visited.delete(ref2.id);
+        return result;
+      }
+      return {};
+    }
+    case "optional":
+    case "nullable":
+      return generateResponseData(ref2.shape, types4, depth, visited);
+    case "list":
+    case "set":
+      return [generateResponseData(ref2.itemShape, types4, depth, visited)];
+    case "map":
+      return {};
+    case "literal":
+      return ref2.value.value;
+    case "unknown":
+      return {};
+    default:
+      return null;
+  }
+}
 var SDK_SNIPPET_LANGUAGES = [
   "typescript",
   "python",
@@ -1395901,6 +1396454,7 @@ var Transformer = class _Transformer {
       endpoints: Object.fromEntries(endpoints),
       websockets: Object.fromEntries(websockets),
       webhooks: Object.fromEntries(webhooks2),
+      graphqlOperations: api.graphqlOperations,
       types: Object.fromEntries(types4),
       globalHeaders,
       auths: api.auths,
@@ -1396195,11 +1396749,13 @@ __export2(db_exports, {
 var endpoint_exports3 = {};
 var register_exports = {};
 __export2(register_exports, {
+  GraphQlOperationType: () => GraphQlOperationType3,
   ObjectPropertyAccess: () => ObjectPropertyAccess3,
   SourceId: () => SourceId,
   checkSdkDynamicIrExists: () => checkSdkDynamicIrExists_exports,
   endpoint: () => endpoint_exports4,
   getSdkDynamicIrUploadUrls: () => getSdkDynamicIrUploadUrls_exports,
+  graphql: () => graphql_exports3,
   registerApiDefinition: () => registerApiDefinition_exports,
   type_: () => type_exports3,
   webhook: () => webhook_exports3,
@@ -1396308,6 +1396864,15 @@ var Error8 = {
   }
 };
 var endpoint_exports4 = {};
+var graphql_exports3 = {};
+__export2(graphql_exports3, {
+  GraphQlOperationType: () => GraphQlOperationType3
+});
+var GraphQlOperationType3 = {
+  Query: "QUERY",
+  Mutation: "MUTATION",
+  Subscription: "SUBSCRIPTION"
+};
 var type_exports3 = {};
 __export2(type_exports3, {
   ObjectPropertyAccess: () => ObjectPropertyAccess3
@@ -1398189,12 +1398754,18 @@ __export2(navigation_exports, {
 });
 var latest_exports4 = {};
 __export2(latest_exports4, {
+  GraphQlOperationType: () => GraphQlOperationType4,
   NodeId: () => NodeId,
   ProductId: () => ProductId,
   Slug: () => Slug,
   TabId: () => TabId2,
   VariantId: () => VariantId
 });
+var GraphQlOperationType4 = {
+  Query: "QUERY",
+  Mutation: "MUTATION",
+  Subscription: "SUBSCRIPTION"
+};
 function NodeId(value) {
   return value;
 }
@@ -1398212,6 +1398783,7 @@ function VariantId(value) {
 }
 var v1_exports3 = {};
 __export2(v1_exports3, {
+  GraphQlOperationType: () => GraphQlOperationType5,
   NavigationV1Availability: () => NavigationV1Availability,
   NodeId: () => NodeId2,
   ProductId: () => ProductId2,
@@ -1398219,6 +1398791,11 @@ __export2(v1_exports3, {
   TabId: () => TabId22,
   VariantId: () => VariantId2
 });
+var GraphQlOperationType5 = {
+  Query: "QUERY",
+  Mutation: "MUTATION",
+  Subscription: "SUBSCRIPTION"
+};
 var NavigationV1Availability = {
   Stable: "stable",
   GenerallyAvailable: "generally-available",
@@ -1404888,6 +1405465,7 @@ __export2(APIV1Db_exports, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1404920,6 +1405498,8 @@ __export2(APIV1Write_exports, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
+  GraphQlOperationType: () => GraphQlOperationType3,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1404944,6 +1405524,7 @@ __export2(APIV1Write_exports, {
   checkSdkDynamicIrExists: () => checkSdkDynamicIrExists_exports,
   endpoint: () => endpoint_exports4,
   getSdkDynamicIrUploadUrls: () => getSdkDynamicIrUploadUrls_exports,
+  graphql: () => graphql_exports3,
   registerApiDefinition: () => registerApiDefinition_exports,
   type_: () => type_exports3,
   webhook: () => webhook_exports3,
@@ -1404971,6 +1405552,7 @@ __export2(DocsV1Db_exports, {
   FontDisplay: () => FontDisplay3,
   FontStyle: () => FontStyle3,
   FooterNavConfig: () => FooterNavConfig,
+  GraphQlOperationId: () => GraphQlOperationId,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HeaderPosition: () => HeaderPosition3,
@@ -1405021,6 +1405603,7 @@ __export2(DocsV1Read_exports, {
   FontDisplay: () => FontDisplay3,
   FontStyle: () => FontStyle3,
   FooterNavConfig: () => FooterNavConfig,
+  GraphQlOperationId: () => GraphQlOperationId,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HeaderPosition: () => HeaderPosition3,
@@ -1405075,6 +1405658,7 @@ __export2(DocsV1Write_exports, {
   FontDisplay: () => FontDisplay3,
   FontStyle: () => FontStyle3,
   FooterNavConfig: () => FooterNavConfig,
+  GraphQlOperationId: () => GraphQlOperationId,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HeaderPosition: () => HeaderPosition3,
@@ -1405116,6 +1405700,7 @@ __export2(FdrAPI_exports, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1405559,6 +1406144,8 @@ function generateExamplePrimitive(reference) {
       return "2023-01-01";
     case "bigInteger":
       return "123456789123456789";
+    case "scalar":
+      return reference.name;
   }
 }
 function getAllObjectProperties(object9, resolveTypeById) {
@@ -1405830,6 +1406417,7 @@ function convertAPIDefinitionToDb(writeShape, id2, snippets) {
         })
       ) ?? [],
       websockets: writeShape.rootPackage.websockets?.map((websocket) => transformWebsocket({ writeShape: websocket })) ?? [],
+      graphqlOperations: writeShape.rootPackage.graphqlOperations ?? [],
       subpackages: writeShape.rootPackage.subpackages,
       types: writeShape.rootPackage.types,
       pointsTo: void 0
@@ -1405877,12 +1406465,14 @@ function transformSubpackage({
   );
   const webhooks2 = writeShape.webhooks?.map((webhook) => transformWebhook({ writeShape: webhook, apiDefinition }));
   const websockets = writeShape.websockets?.map((websocket) => transformWebsocket({ writeShape: websocket }));
+  const graphqlOperations = writeShape.graphqlOperations;
   return {
     subpackageId: id2,
     parent,
     name: writeShape.name,
     endpoints,
     websockets: websockets ?? [],
+    graphqlOperations: graphqlOperations ?? [],
     types: writeShape.types,
     subpackages: writeShape.subpackages,
     pointsTo: writeShape.pointsTo,
@@ -1407058,6 +1407648,7 @@ function convertDbAPIDefinitionToRead(dbShape) {
       types: dbShape.rootPackage.types,
       webhooks: dbShape.rootPackage.webhooks ?? [],
       websockets: dbShape.rootPackage.websockets ?? [],
+      graphqlOperations: dbShape.rootPackage.graphqlOperations ?? [],
       pointsTo: dbShape.rootPackage.pointsTo
     },
     types: dbShape.types,
@@ -1407090,6 +1407681,7 @@ function transformSubpackage2({
     // htmlDescription: dbShape.htmlDescription,
     webhooks: dbShape.webhooks ?? [],
     websockets: dbShape.websockets ?? [],
+    graphqlOperations: dbShape.graphqlOperations ?? [],
     displayName: dbShape.displayName
     // descriptionContainsMarkdown: dbShape.descriptionContainsMarkdown,
   };
@@ -1407612,6 +1408204,8 @@ __export2(navigation_exports2, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
+  GraphQlOperationType: () => GraphQlOperationType4,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1407670,7 +1408264,7 @@ function isSubpackage2(package_) {
   return typeof package_.subpackageId === "string";
 }
 function isApiLeaf(node3) {
-  return node3.type === "endpoint" || node3.type === "webSocket" || node3.type === "webhook" || node3.type === "grpc";
+  return node3.type === "endpoint" || node3.type === "webSocket" || node3.type === "webhook" || node3.type === "grpc" || node3.type === "graphql";
 }
 function isMarkdownLeaf(node3) {
   return node3.type === "page" || node3.type === "landingPage" || node3.type === "changelogEntry";
@@ -1407731,7 +1408325,8 @@ function getPageId(node3) {
     endpoint: RETURN_UNDEFINED,
     webSocket: RETURN_UNDEFINED,
     webhook: RETURN_UNDEFINED,
-    grpc: RETURN_UNDEFINED
+    grpc: RETURN_UNDEFINED,
+    graphql: RETURN_UNDEFINED
     // changelogYear: RETURN_UNDEFINED,
     // changelogMonth: RETURN_UNDEFINED,
   });
@@ -1407876,6 +1408471,12 @@ var ApiDefinitionHolder = class _ApiDefinitionHolder {
       package_.webhooks.forEach((webhook) => {
         this.#webhooks.set(_ApiDefinitionHolder.createWebhookId(webhook, subpackageId), webhook);
       });
+      package_.graphqlOperations?.forEach((graphqlOperation) => {
+        this.#graphqlOperations.set(
+          _ApiDefinitionHolder.createGraphQlOperationId(graphqlOperation),
+          graphqlOperation
+        );
+      });
     });
   }
   static create(api) {
@@ -1407884,6 +1408485,7 @@ var ApiDefinitionHolder = class _ApiDefinitionHolder {
   #endpoints = /* @__PURE__ */ new Map();
   #webSockets = /* @__PURE__ */ new Map();
   #webhooks = /* @__PURE__ */ new Map();
+  #graphqlOperations = /* @__PURE__ */ new Map();
   get endpoints() {
     return this.#endpoints;
   }
@@ -1407893,6 +1408495,9 @@ var ApiDefinitionHolder = class _ApiDefinitionHolder {
   get webhooks() {
     return this.#webhooks;
   }
+  get graphqlOperations() {
+    return this.#graphqlOperations;
+  }
   static createEndpointId(endpoint3, subpackageId = ROOT_PACKAGE_ID) {
     return EndpointId(endpoint3.originalEndpointId ?? `${subpackageId}.${endpoint3.id}`);
   }
@@ -1407905,6 +1408510,9 @@ var ApiDefinitionHolder = class _ApiDefinitionHolder {
   static createGrpcId(grpcEndpoint, subpackageId = ROOT_PACKAGE_ID) {
     return GrpcId(`${subpackageId}.${grpcEndpoint.id}`);
   }
+  static createGraphQlOperationId(graphqlOperation) {
+    return graphqlOperation.id;
+  }
 };
 var ApiTypeIdVisitor2 = class _ApiTypeIdVisitor2 {
   static visitEndpointDefinition(endpoint3, visit3) {
@@ -1407951,6 +1408559,12 @@ var ApiTypeIdVisitor2 = class _ApiTypeIdVisitor2 {
     });
     _ApiTypeIdVisitor2.visitWebhookPayloadShape(webhook.payload.type, visit3);
   }
+  static visitGraphQlOperation(graphqlOperation, visit3) {
+    graphqlOperation.arguments?.forEach((arg) => {
+      _ApiTypeIdVisitor2.visitTypeReference(arg.type, visit3);
+    });
+    _ApiTypeIdVisitor2.visitTypeReference(graphqlOperation.returnType, visit3);
+  }
   static visitWebhookPayloadShape(payloadShape, visit3) {
     return visitDiscriminatedUnion_default(payloadShape)._visit({
       object: (value) => _ApiTypeIdVisitor2.visitObjectType(value, visit3),
@@ -1408102,6 +1408716,7 @@ var ApiDefinitionPruner2 = class {
     const endpoints = this.pruneEndpoints(node3, pkg2.endpoints, subpackageId);
     const websockets = this.pruneWebSockets(node3, pkg2.websockets, subpackageId);
     const webhooks2 = this.pruneWebhooks(node3, pkg2.webhooks, subpackageId);
+    const graphqlOperations = this.pruneGraphqlOperations(node3, pkg2.graphqlOperations);
     const typeIds = /* @__PURE__ */ new Set();
     endpoints.forEach((endpoint3) => {
       ApiTypeIdVisitor2.visitEndpointDefinition(endpoint3, (typeId) => typeIds.add(typeId));
@@ -1408112,12 +1408727,16 @@ var ApiDefinitionPruner2 = class {
     webhooks2.forEach((webhook) => {
       ApiTypeIdVisitor2.visitWebhookDefinition(webhook, (typeId) => typeIds.add(typeId));
     });
+    graphqlOperations.forEach((graphqlOperation) => {
+      ApiTypeIdVisitor2.visitGraphQlOperation(graphqlOperation, (typeId) => typeIds.add(typeId));
+    });
     const expandedTypeIds = this.expandTypeIds(typeIds);
     return {
       ...pkg2,
       endpoints,
       websockets,
       webhooks: webhooks2,
+      graphqlOperations,
       types: Array.from(expandedTypeIds)
     };
   }
@@ -1408157,6 +1408776,16 @@ var ApiDefinitionPruner2 = class {
     );
     return found ? [found] : [];
   }
+  pruneGraphqlOperations(node3, graphqlOperations) {
+    if (node3.type !== "graphql" || graphqlOperations == null) {
+      return [];
+    }
+    const graphqlOperationId = node3.graphqlOperationId;
+    const found = graphqlOperations.find(
+      (graphqlOperation) => ApiDefinitionHolder.createGraphQlOperationId(graphqlOperation) === graphqlOperationId
+    );
+    return found ? [found] : [];
+  }
 };
 function pruneVersionNode(node3, rootSlug, versionSlug) {
   if (node3 == null) {
@@ -1408190,6 +1408819,8 @@ __export2(v1_exports4, {
   EndpointPathLiteral: () => EndpointPathLiteral,
   EnvironmentId: () => EnvironmentId,
   FileId: () => FileId,
+  GraphQlOperationId: () => GraphQlOperationId,
+  GraphQlOperationType: () => GraphQlOperationType5,
   GrpcId: () => GrpcId,
   GrpcMethod: () => GrpcMethod,
   HttpMethod: () => HttpMethod,
@@ -1408578,6 +1409209,7 @@ var ApiReferenceNavigationConverter = class _ApiReferenceNavigationConverter {
   #visitedWebSockets = /* @__PURE__ */ new Set();
   #visitedWebhooks = /* @__PURE__ */ new Set();
   #visitedGrpcs = /* @__PURE__ */ new Set();
+  #visitedGraphqlOperations = /* @__PURE__ */ new Set();
   #visitedSubpackages = /* @__PURE__ */ new Set();
   #idgen;
   convert() {
@@ -1408714,6 +1409346,25 @@ var ApiReferenceNavigationConverter = class _ApiReferenceNavigationConverter {
       featureFlags: void 0
     }));
   }
+  convertGraphQlNode(graphqlOperationId, graphqlOperation, parentSlug) {
+    return this.#idgen.with(graphqlOperationId, (id2) => ({
+      id: id2,
+      type: "graphql",
+      title: graphqlOperation.displayName ?? graphqlOperation.name,
+      graphqlOperationId,
+      slug: parentSlug.apply({ urlSlug: graphqlOperation.name }).get(),
+      icon: void 0,
+      hidden: void 0,
+      operationType: graphqlOperation.operationType,
+      apiDefinitionId: this.apiDefinitionId,
+      availability: navigation_exports2.V1.convertAvailability(graphqlOperation.availability),
+      playground: void 0,
+      authed: void 0,
+      viewers: void 0,
+      orphaned: void 0,
+      featureFlags: void 0
+    }));
+  }
   convertPackageToChildren(package_, parentSlug) {
     const children2 = [];
     let subpackageId = isSubpackage2(package_) ? package_.subpackageId : "__package__";
@@ -1408761,6 +1409412,14 @@ var ApiReferenceNavigationConverter = class _ApiReferenceNavigationConverter {
       children2.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;
+      }
+      children2.push(this.convertGraphQlNode(graphqlOperationId, graphqlOperation, parentSlug));
+      this.#visitedGraphqlOperations.add(graphqlOperationId);
+    });
     package_.subpackages.forEach((subpackageId2) => {
       const subpackage = this.api.subpackages[subpackageId2];
       if (subpackage == null) {
@@ -1409425,6 +1410084,7 @@ function followRedirect(nodeToFollow) {
     webSocket: (node3) => node3.slug,
     webhook: (node3) => node3.slug,
     grpc: (node3) => node3.slug,
+    graphql: (node3) => node3.slug,
     landingPage: (node3) => node3.slug,
     // nodes with overview
     apiPackage: (node3) => node3.overviewPageId != null ? node3.slug : followRedirects(node3.children),
@@ -1409476,12 +1410136,13 @@ function getPageId2(node3) {
     webSocket: RETURN_UNDEFINED2,
     webhook: RETURN_UNDEFINED2,
     grpc: RETURN_UNDEFINED2,
+    graphql: RETURN_UNDEFINED2,
     changelogYear: RETURN_UNDEFINED2,
     changelogMonth: RETURN_UNDEFINED2
   });
 }
 function isApiLeaf2(node3) {
-  return node3.type === "endpoint" || node3.type === "webSocket" || node3.type === "webhook" || node3.type === "grpc";
+  return node3.type === "endpoint" || node3.type === "webSocket" || node3.type === "webhook" || node3.type === "grpc" || node3.type === "graphql";
 }
 function isMarkdownLeaf2(node3) {
   return node3.type === "page" || node3.type === "landingPage" || node3.type === "changelogEntry";
@@ -1410396,6 +1411057,33 @@ var FernNavigationV1ToLatest = class _FernNavigationV1ToLatest {
     };
     return latest2;
   };
+  graphql = (node3, parents) => {
+    const apiDisambiguation = this.#createApiDisambiguationKey(parents);
+    const slug = navigation_exports2.Slug(node3.slug);
+    const canonicalSlug = this.#getAndSetCanonicalSlug(
+      [`${apiDisambiguation}:api:graphql:${node3.id}`, this.#createTitleDisambiguationKey(node3, parents)],
+      slug
+    );
+    const latest2 = {
+      type: "graphql",
+      id: navigation_exports2.NodeId(node3.id),
+      title: node3.title,
+      slug,
+      canonicalSlug,
+      icon: node3.icon,
+      hidden: node3.hidden,
+      authed: node3.authed,
+      apiDefinitionId: node3.apiDefinitionId,
+      graphqlOperationId: node3.graphqlOperationId,
+      operationType: node3.operationType,
+      playground: node3.playground,
+      availability: this.#availability(node3.availability),
+      viewers: node3.viewers,
+      orphaned: node3.orphaned,
+      featureFlags: node3.featureFlags
+    };
+    return latest2;
+  };
   #variantChild = (child, parents) => {
     return visitDiscriminatedUnion_default(child)._visit({
       apiReference: (value) => this.apiReference(value, parents),
@@ -1410425,7 +1411113,8 @@ var FernNavigationV1ToLatest = class _FernNavigationV1ToLatest {
       endpointPair: (value) => this.endpointPair(value, parents),
       webSocket: (value) => this.webSocket(value, parents),
       webhook: (value) => this.webhook(value, parents),
-      grpc: (value) => this.grpc(value, parents)
+      grpc: (value) => this.grpc(value, parents),
+      graphql: (value) => this.graphql(value, parents)
     });
   };
   /**
@@ -1410795,6 +1411484,7 @@ function getApiReferenceId(node3) {
     webSocket: RETURN_API_DEFINITION_ID,
     webhook: RETURN_API_DEFINITION_ID,
     grpc: RETURN_API_DEFINITION_ID,
+    graphql: RETURN_API_DEFINITION_ID,
     apiPackage: RETURN_API_DEFINITION_ID,
     unversioned: RETURN_UNDEFINED3,
     landingPage: RETURN_UNDEFINED3
@@ -1429451,7 +1430141,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.48.2",
+          version: "3.48.3",
           usingAccessToken: true
         }
       });
@@ -1429550,7 +1430240,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.48.2",
+        version: "3.48.3",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1502915,6 +1503605,9 @@ var AbstractMediaTypeObjectConverter = class extends AbstractConverter {
   /**
    * Determines the unique identifier for an example, handling duplicate summary collisions.
    * Uses the summary if available, disambiguating with key if there's a collision.
+   *
+   * This is used for OpenAPI request/response body examples which use the standard
+   * 'summary' field where collisions are more likely.
    */
   getIdForExample({ key, example, usedExampleNames }) {
     if (this.context.isExampleWithSummary(example)) {
@@ -1508976,7 +1509669,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.48.2";
+    return "3.48.3";
   }
   getCliName() {
     if (false) {
@@ -1557312,6 +1558005,13 @@ var OperationConverter = class _OperationConverter extends AbstractOperationConv
       ];
     }));
   }
+  /**
+   * Gets the example name from x-fern-examples extension.
+   *
+   * Note: This uses the 'name' field directly without collision
+   * disambiguation. This is intentional because x-fern-examples is a
+   * Fern-specific extension where users explicitly provide unique names.
+   */
   getExampleName({ example, exampleIndex }) {
     return example.name ?? example["code-samples"]?.[0]?.name ?? `Example_${exampleIndex}`;
   }
@@ -1598037,7 +1598737,8 @@ function convertAuthScheme({ scheme, playgroundConfig, context: context2 }) {
         type: "basicAuth",
         passwordName: scheme.password.originalName,
         usernameName: scheme.username.originalName,
-        description: scheme.docs
+        description: scheme.docs,
+        passwordAlwaysEmpty: void 0
       };
     case "bearer":
       return {
@@ -1598481,26 +1599182,29 @@ function convertPackage(irPackage, ir14) {
     websockets: websocket != null ? [convertWebSocketChannel(websocket, ir14)] : [],
     types: irPackage.types.map((typeId) => FdrAPI_exports.TypeId(typeId)),
     subpackages: irPackage.subpackages.map((subpackageId) => FdrAPI_exports.api.v1.SubpackageId(subpackageId)),
-    pointsTo: irPackage.navigationConfig != null ? FdrAPI_exports.api.v1.SubpackageId(irPackage.navigationConfig.pointsTo) : void 0
+    pointsTo: irPackage.navigationConfig != null ? FdrAPI_exports.api.v1.SubpackageId(irPackage.navigationConfig.pointsTo) : void 0,
+    graphqlOperations: void 0
   };
 }
 function convertWebhookGroup2(webhookGroup) {
   return webhookGroup.map((webhook) => {
     const webhookExamples = [];
     if (webhook.v2Examples != null) {
-      for (const [_exampleName, example] of Object.entries(webhook.v2Examples.userSpecifiedExamples)) {
+      for (const [exampleName, example] of Object.entries(webhook.v2Examples.userSpecifiedExamples)) {
         webhookExamples.push({
+          name: example.name ?? exampleName,
           payload: example.payload
         });
       }
-      for (const [_exampleName, example] of Object.entries(webhook.v2Examples.autogeneratedExamples)) {
+      for (const [exampleName, example] of Object.entries(webhook.v2Examples.autogeneratedExamples)) {
         webhookExamples.push({
+          name: example.name ?? exampleName,
           payload: example.payload
         });
       }
     } else {
       webhookExamples.push(...webhook.examples?.map((example) => {
-        return { payload: example.payload.jsonExample };
+        return { name: example.name?.originalName, payload: example.payload.jsonExample };
       }) ?? []);
     }
     return {
@@ -1610166,7 +1610870,7 @@ var import_path40 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.48.2";
+  const version7 = "3.48.3";
   return `cli@${version7}`;
 }
 var DebugLogger = class {