[pull] main from fern-api:main

fern-yml.schema.json

@@ -3876,6 +3876,9 @@
                       "respectReadonlySchemas": {
                         "type": "boolean"
                       },
+                      "useReadVariantForResponses": {
+                        "type": "boolean"
+                      },
                       "respectForwardCompatibleEnums": {
                         "type": "boolean"
                       },
@@ -4221,6 +4224,9 @@
                       }
                     ]
                   },
+                  "examples": {
+                    "type": "string"
+                  },
                   "name": {
                     "type": "string"
                   }
@@ -4444,6 +4450,9 @@
                         "respectReadonlySchemas": {
                           "type": "boolean"
                         },
+                        "useReadVariantForResponses": {
+                          "type": "boolean"
+                        },
                         "respectForwardCompatibleEnums": {
                           "type": "boolean"
                         },
@@ -4789,6 +4798,9 @@
                         }
                       ]
                     },
+                    "examples": {
+                      "type": "string"
+                    },
                     "name": {
                       "type": "string"
                     }

fern/apis/generators-yml/definition/generators.yml

@@ -654,6 +654,7 @@ types:
       graphql: string
       origin: optional<string>
       overrides: optional<string>
+      examples: optional<string>
       name: optional<string>
 
   ProtobufSpecSchema:

generators-yml.schema.json

@@ -2751,6 +2751,16 @@
             }
           ]
         },
+        "examples": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "name": {
           "oneOf": [
             {

generators/python/sdk/changes/5.14.2/bump-generator-cli-0.9.35.yml

@@ -0,0 +1,7 @@
+# yaml-language-server: $schema=../../../../../fern-changes-yml.schema.json
+
+- summary: |
+    Bump @fern-api/generator-cli to 0.9.35, which disables minimatch negation
+    on `.fernignore` patterns so a stray `!pattern` no longer silently inverts
+    the match and discards generator output.
+  type: fix

generators/python/sdk/versions.yml

@@ -1,4 +1,13 @@
 # yaml-language-server: $schema=../../../fern-versions-yml.schema.json
+- version: 5.14.2
+  changelogEntry:
+    - summary: |
+        Bump @fern-api/generator-cli to 0.9.35, which disables minimatch negation
+        on `.fernignore` patterns so a stray `!pattern` no longer silently inverts
+        the match and discards generator output.
+      type: fix
+  createdAt: "2026-05-21"
+  irVersion: 67
 - version: 5.14.1
   changelogEntry:
     - summary: |

generators/typescript/sdk/changes/3.71.1/bump-generator-cli-0.9.35.yml

@@ -0,0 +1,7 @@
+# yaml-language-server: $schema=../../../../../fern-changes-yml.schema.json
+
+- summary: |
+    Bump @fern-api/generator-cli to 0.9.35, which disables minimatch negation
+    on `.fernignore` patterns so a stray `!pattern` no longer silently inverts
+    the match and discards generator output.
+  type: fix

generators/typescript/sdk/versions.yml

@@ -1,4 +1,13 @@
 # yaml-language-server: $schema=../../../fern-versions-yml.schema.json
+- version: 3.71.1
+  changelogEntry:
+    - summary: |
+        Bump @fern-api/generator-cli to 0.9.35, which disables minimatch negation
+        on `.fernignore` patterns so a stray `!pattern` no longer silently inverts
+        the match and discards generator output.
+      type: fix
+  createdAt: "2026-05-21"
+  irVersion: 67
 - version: 3.71.0
   changelogEntry:
     - summary: |

packages/cli/api-importers/graphql/src/GraphQLConverter.ts

@@ -24,22 +24,60 @@ export interface GraphQLConverterResult {
     types: Record<FdrAPI.TypeId, FdrAPI.api.v1.register.TypeDefinition>;
 }
 
+export interface GraphQlExampleInput {
+    name?: string;
+    description?: string;
+    query: string;
+    variables?: Record<string, unknown>;
+    response?: unknown;
+}
+
+export interface GraphQlOperationExamplesInput {
+    operation: string;
+    operationType?: "query" | "mutation" | "subscription";
+    examples: GraphQlExampleInput[];
+}
+
 export class GraphQLConverter {
     private schema: GraphQLSchema | undefined;
     private context: TaskContext;
     private filePath: AbsoluteFilePath;
     private namespace: string | undefined;
     private processingTypes: Set<string> = new Set();
     private types: Record<FdrAPI.TypeId, FdrAPI.api.v1.register.TypeDefinition> = {};
+    private examplesByOperation: Map<string, FdrAPI.api.v1.register.GraphQlExample[]> = new Map();
 
     constructor({
         context,
         filePath,
-        namespace
-    }: { context: TaskContext; filePath: AbsoluteFilePath; namespace?: string }) {
+        namespace,
+        examples
+    }: {
+        context: TaskContext;
+        filePath: AbsoluteFilePath;
+        namespace?: string;
+        examples?: GraphQlOperationExamplesInput[];
+    }) {
         this.context = context;
         this.filePath = filePath;
         this.namespace = namespace;
+        if (examples != null) {
+            for (const entry of examples) {
+                const mapped = entry.examples.map((ex) => ({
+                    name: ex.name ?? undefined,
+                    description: ex.description ?? undefined,
+                    query: ex.query,
+                    variables: ex.variables ?? undefined,
+                    response: ex.response ?? undefined
+                }));
+                if (entry.operationType != null) {
+                    const key = `${entry.operationType.toLowerCase()}:${entry.operation}`;
+                    this.examplesByOperation.set(key, mapped);
+                } else {
+                    this.examplesByOperation.set(entry.operation, mapped);
+                }
+            }
+        }
     }
 
     private isBuiltInScalar(typeName: string): boolean {
@@ -249,6 +287,9 @@ export class GraphQLConverter {
         operationType: FdrAPI.api.v1.register.GraphQlOperationType
     ): FdrAPI.api.v1.register.GraphQlOperation {
         const args = field.args.map((arg) => this.convertArgument(arg));
+        const examples =
+            this.examplesByOperation.get(`${operationType.toLowerCase()}:${name}`) ??
+            this.examplesByOperation.get(name);
 
         return {
             id: this.getNamespacedOperationId(`${operationType.toLowerCase()}_${name}`),
@@ -259,7 +300,7 @@ export class GraphQLConverter {
             availability: undefined,
             arguments: args.length > 0 ? args : undefined,
             returnType: this.convertOutputType(field.type),
-            examples: undefined,
+            examples: examples != null && examples.length > 0 ? examples : undefined,
             snippets: undefined
         };
     }

packages/cli/api-importers/graphql/src/index.ts

@@ -1,2 +1,2 @@
-export type { GraphQLConverterResult } from "./GraphQLConverter.js";
+export type { GraphQLConverterResult, GraphQlExampleInput, GraphQlOperationExamplesInput } from "./GraphQLConverter.js";
 export { GraphQLConverter } from "./GraphQLConverter.js";