fern-api 0.21.0 → 0.22.0-rc1

package/bundle.cjs

@@ -827393,7 +827393,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.21.0",
+          version: "0.22.0-rc1",
           usingAccessToken: true
         }
       });
@@ -827455,7 +827455,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.21.0",
+        version: "0.22.0-rc1",
         ...event,
         ...event.properties
       }
@@ -842382,17 +842382,18 @@ var ExampleTypeFactory = class {
   constructor(schemas) {
     this.schemas = schemas;
   }
-  buildExample({ schema: schema2, example, options: options2 }) {
+  buildExample({ schema: schema2, exampleId, example, options: options2 }) {
     return this.buildExampleHelper({
       schema: schema2,
       visitedSchemaIds: /* @__PURE__ */ new Set(),
+      exampleId,
       example,
       options: { ...options2, maxCheckerDepth: options2.maxCheckerDepth ?? 5 },
       depth: 0
     });
   }
-  buildExampleHelper({ example, schema: schema2, depth, visitedSchemaIds, options: options2 }) {
-    var _a4, _b3;
+  buildExampleHelper({ exampleId, example, schema: schema2, depth, visitedSchemaIds, options: options2 }) {
+    var _a4, _b3, _c3, _d;
     switch (schema2.type) {
       case "enum":
         if (typeof example === "string" && enumContainsValue({ schema: schema2, value: example })) {
@@ -842408,6 +842409,7 @@ var ExampleTypeFactory = class {
         const result2 = this.buildExampleHelper({
           schema: schema2.value,
           visitedSchemaIds,
+          exampleId,
           example,
           depth,
           options: options2
@@ -842430,6 +842432,7 @@ var ExampleTypeFactory = class {
         const result2 = this.buildExampleHelper({
           schema: schema2.value,
           visitedSchemaIds,
+          exampleId,
           example,
           depth,
           options: options2
@@ -842456,6 +842459,7 @@ var ExampleTypeFactory = class {
           const referencedExample = this.buildExampleHelper({
             example,
             schema: referencedSchemaWithExample,
+            exampleId,
             visitedSchemaIds,
             depth,
             options: options2
@@ -842474,15 +842478,15 @@ var ExampleTypeFactory = class {
             const fullExample = getFullExampleAsObject(example);
             const exampleDiscriminant = fullExample == null ? void 0 : fullExample[schema2.value.discriminantProperty];
             const exampleUnionVariantSchema = schema2.value.schemas[exampleDiscriminant];
-            const firstUnionVariant = Object.entries(schema2.value.schemas)[0];
+            const unionVariant = this.getDiscriminatedUnionVariantSchema(schema2.value, fullExample);
             if (exampleDiscriminant != null && exampleUnionVariantSchema != null && exampleUnionVariantSchema.type === "object") {
               allProperties = this.getAllProperties(exampleUnionVariantSchema);
               requiredProperties = this.getAllRequiredProperties(exampleUnionVariantSchema);
               result2[schema2.value.discriminantProperty] = FullExample.primitive(PrimitiveExample.string(exampleDiscriminant));
-            } else if (firstUnionVariant != null && firstUnionVariant[1].type === "object") {
-              allProperties = this.getAllProperties(firstUnionVariant[1]);
-              requiredProperties = this.getAllRequiredProperties(firstUnionVariant[1]);
-              result2[schema2.value.discriminantProperty] = FullExample.primitive(PrimitiveExample.string(firstUnionVariant[0]));
+            } else if (unionVariant != null && unionVariant[1].type === "object") {
+              allProperties = this.getAllProperties(unionVariant[1]);
+              requiredProperties = this.getAllRequiredProperties(unionVariant[1]);
+              result2[schema2.value.discriminantProperty] = FullExample.primitive(PrimitiveExample.string(unionVariant[0]));
             } else {
               return void 0;
             }
@@ -842498,6 +842502,7 @@ var ExampleTypeFactory = class {
               if (required && (fullExample == null ? void 0 : fullExample[property5]) != null) {
                 const propertyExample = this.buildExampleHelper({
                   schema: schema3,
+                  exampleId,
                   example: fullExample[property5],
                   visitedSchemaIds,
                   depth: depth + 1,
@@ -842510,6 +842515,7 @@ var ExampleTypeFactory = class {
                 }
               } else {
                 const propertyExample = this.buildExampleHelper({
+                  exampleId,
                   schema: schema3,
                   example: fullExample == null ? void 0 : fullExample[property5],
                   visitedSchemaIds,
@@ -842526,10 +842532,12 @@ var ExampleTypeFactory = class {
             return FullExample.oneOf(FullOneOfExample.discriminated(result2));
           }
           case "undisciminated": {
-            if (schema2.value.schemas[0] != null) {
+            const unionVariantSchema = this.getUnDiscriminatedUnionVariantSchema(schema2.value, example);
+            if (unionVariantSchema != null) {
               return this.buildExampleHelper({
+                exampleId,
                 example,
-                schema: schema2.value.schemas[0],
+                schema: unionVariantSchema,
                 visitedSchemaIds,
                 depth,
                 options: options2
@@ -842564,6 +842572,7 @@ var ExampleTypeFactory = class {
         if (fullExample != null && fullExample.length > 0) {
           for (const item of fullExample) {
             const itemExample = this.buildExampleHelper({
+              exampleId,
               example: item,
               schema: schema2.value,
               depth: depth + 1,
@@ -842576,6 +842585,7 @@ var ExampleTypeFactory = class {
           }
         } else {
           const itemExample = this.buildExampleHelper({
+            exampleId,
             example: void 0,
             schema: schema2.value,
             depth: depth + 1,
@@ -842599,6 +842609,7 @@ var ExampleTypeFactory = class {
               options: options2
             });
             const valueExample2 = this.buildExampleHelper({
+              exampleId,
               example: value,
               schema: schema2.value,
               visitedSchemaIds,
@@ -842620,6 +842631,7 @@ var ExampleTypeFactory = class {
           options: options2
         });
         const valueExample = this.buildExampleHelper({
+          exampleId,
           example: void 0,
           schema: schema2.value,
           visitedSchemaIds,
@@ -842638,13 +842650,16 @@ var ExampleTypeFactory = class {
       }
       case "object": {
         const result2 = {};
-        const fullExample = getFullExampleAsObject(example) ?? (((_b3 = schema2.fullExamples) == null ? void 0 : _b3[0]) != null ? getFullExampleAsObject(schema2.fullExamples[0].value) : {}) ?? {};
+        const foundObjectExample = ((_b3 = schema2.fullExamples) == null ? void 0 : _b3.find((example2) => example2.name === exampleId)) ?? ((_c3 = schema2.fullExamples) == null ? void 0 : _c3.find((example2) => example2.name == null)) ?? ((_d = schema2.fullExamples) == null ? void 0 : _d[0]);
+        const fullExample = getFullExampleAsObject(example) ?? (foundObjectExample != null ? getFullExampleAsObject(foundObjectExample.value) : {}) ?? {};
         const allProperties = this.getAllProperties(schema2);
         const requiredProperties = this.getAllRequiredProperties(schema2);
         for (const [property5, schema3] of Object.entries(allProperties)) {
           const required = property5 in requiredProperties;
+          const inExample = Object.keys(fullExample).includes(property5);
           const propertyExample = this.buildExampleHelper({
             schema: schema3,
+            exampleId,
             example: fullExample[property5],
             visitedSchemaIds,
             depth: depth + 1,
@@ -842653,23 +842668,14 @@ var ExampleTypeFactory = class {
               name: property5
             }
           });
-          if (propertyExample != null) {
+          if (required && propertyExample != null) {
             result2[property5] = propertyExample;
           } else if (required) {
-            const generatedExample = this.buildExampleHelper({
-              schema: schema3,
-              example: fullExample[property5],
-              visitedSchemaIds,
-              depth: depth + 1,
-              options: {
-                ...options2,
-                name: property5
-              }
-            });
-            if (generatedExample == null) {
-              return void 0;
-            }
-            result2[property5] = generatedExample;
+            return void 0;
+          } else if (inExample && propertyExample != null) {
+            result2[property5] = propertyExample;
+          } else if (!options2.ignoreOptionals && propertyExample != null) {
+            result2[property5] = propertyExample;
           }
         }
         return FullExample.object({
@@ -842680,6 +842686,110 @@ var ExampleTypeFactory = class {
         assertNever(schema2);
     }
   }
+  getDiscriminatedUnionVariantSchema(schema2, fullExample) {
+    const discriminantValue = fullExample == null ? void 0 : fullExample[schema2.discriminantProperty];
+    if (discriminantValue == null || typeof discriminantValue !== "string") {
+      return Object.entries(schema2.schemas)[0];
+    }
+    const unionVariantSchema = schema2.schemas[discriminantValue];
+    if (unionVariantSchema == null) {
+      return Object.entries(schema2.schemas)[0];
+    }
+    return [discriminantValue, unionVariantSchema];
+  }
+  getUnDiscriminatedUnionVariantSchema(schema2, fullExample) {
+    var _a4;
+    if (fullExample == null) {
+      return schema2.schemas[0];
+    }
+    const matches2 = schema2.schemas.map((schema3) => ({
+      schema: schema3,
+      heuristic: this.calcExampleHeuristic(schema3, fullExample)
+    }));
+    const sortedMatches = matches2.sort((a2, b2) => b2.heuristic - a2.heuristic);
+    return (_a4 = sortedMatches[0]) == null ? void 0 : _a4.schema;
+  }
+  calcExampleHeuristic(schema2, fullExample) {
+    switch (schema2.type) {
+      case "literal": {
+        return schema2.value.value === fullExample ? 5 : 0;
+      }
+      case "enum": {
+        return enumContainsValue({ schema: schema2, value: fullExample }) ? 5 : 0;
+      }
+      case "object": {
+        if (!isPlainObject(fullExample)) {
+          return 0;
+        }
+        const allProperties = this.getAllProperties(schema2);
+        let heuristic = 0;
+        for (const [property5, schema3] of Object.entries(allProperties)) {
+          if (fullExample[property5] != null) {
+            heuristic++;
+            heuristic += this.calcExampleHeuristic(schema3, fullExample[property5]);
+          } else {
+            heuristic--;
+          }
+        }
+        return heuristic;
+      }
+      case "array": {
+        if (!Array.isArray(fullExample)) {
+          return 0;
+        }
+        let heuristic = 0;
+        for (const item of fullExample) {
+          heuristic += this.calcExampleHeuristic(schema2.value, item);
+        }
+        return heuristic;
+      }
+      case "map": {
+        if (!isPlainObject(fullExample)) {
+          return 0;
+        }
+        let heuristic = 0;
+        for (const [, value] of Object.entries(fullExample)) {
+          heuristic += this.calcExampleHeuristic(schema2.value, value);
+        }
+        return heuristic;
+      }
+      case "nullable":
+      case "optional": {
+        return this.calcExampleHeuristic(schema2.value, fullExample);
+      }
+      case "reference": {
+        const resolvedSchema = this.getResolvedSchema(schema2);
+        if (resolvedSchema == null) {
+          return 0;
+        }
+        return this.calcExampleHeuristic(resolvedSchema, fullExample);
+      }
+      case "oneOf": {
+        const matches2 = Object.values(schema2.value.schemas).map((schema3) => this.calcExampleHeuristic(schema3, fullExample));
+        return matches2.sort((a2, b2) => b2 - a2)[0] ?? 0;
+      }
+      case "primitive": {
+        if (fullExample == null) {
+          return 0;
+        }
+        const matches2 = schema2.schema._visit({
+          int: () => typeof fullExample === "number",
+          int64: () => typeof fullExample === "number",
+          float: () => typeof fullExample === "number",
+          double: () => typeof fullExample === "number",
+          string: () => typeof fullExample === "string",
+          datetime: () => typeof fullExample === "string",
+          date: () => typeof fullExample === "string",
+          base64: () => typeof fullExample === "string",
+          boolean: () => typeof fullExample === "boolean",
+          _other: () => true
+        });
+        return matches2 ? 1 : -1;
+      }
+      default:
+        return 0;
+    }
+  }
   hasExample(schema2, depth, visitedSchemaIds = /* @__PURE__ */ new Set(), options2) {
     if (this.exceedsMaxCheckerDepth(depth, options2)) {
       return false;
@@ -843082,39 +843192,86 @@ var ExampleEndpointFactory = class {
     this.logger = logger;
   }
   buildEndpointExample(endpoint) {
-    var _a4, _b3, _c3;
     this.logger.debug(`Building endpoint example for ${endpoint.method.toUpperCase()} ${endpoint.path}`);
     const requestSchemaIdResponse = getRequestSchema(endpoint.request);
     const responseSchemaIdResponse = getResponseSchema(endpoint.response);
-    let requestExample = void 0;
+    if ((requestSchemaIdResponse == null ? void 0 : requestSchemaIdResponse.type) === "unsupported" || (responseSchemaIdResponse == null ? void 0 : responseSchemaIdResponse.type) === "unsupported") {
+      return [];
+    }
+    const requestExamples = [];
     if (requestSchemaIdResponse != null && requestSchemaIdResponse.type === "present") {
       const required = this.isSchemaRequired(requestSchemaIdResponse.schema);
-      requestExample = this.exampleTypeFactory.buildExample({
-        schema: requestSchemaIdResponse.schema,
-        example: ((_a4 = requestSchemaIdResponse.example) == null ? void 0 : _a4.value) ?? requestSchemaIdResponse.example,
-        options: {
-          isParameter: false,
-          ignoreOptionals: true
+      if (requestSchemaIdResponse.examples.length === 0) {
+        const example = this.exampleTypeFactory.buildExample({
+          schema: requestSchemaIdResponse.schema,
+          exampleId: void 0,
+          example: void 0,
+          options: {
+            isParameter: false,
+            ignoreOptionals: true
+          }
+        });
+        if (example != null) {
+          requestExamples.push([void 0, example]);
+        }
+      } else {
+        for (const { name: exampleId, value: rawExample } of requestSchemaIdResponse.examples) {
+          const example = this.exampleTypeFactory.buildExample({
+            schema: requestSchemaIdResponse.schema,
+            exampleId,
+            example: rawExample,
+            options: {
+              isParameter: false,
+              ignoreOptionals: true
+            }
+          });
+          if (example != null) {
+            requestExamples.push([exampleId, example]);
+          }
         }
-      });
-      if (required && requestExample == null) {
-        return void 0;
+      }
+      if (required && requestExamples.length === 0) {
+        this.logger.warn(`Failed to generate required request example for ${endpoint.method.toUpperCase()} ${endpoint.path}`);
+        return [];
       }
     }
-    let responseExample = void 0;
+    const responseExamples = [];
     if (responseSchemaIdResponse != null && responseSchemaIdResponse.type === "present") {
       const required = this.isSchemaRequired(responseSchemaIdResponse.schema);
-      responseExample = this.exampleTypeFactory.buildExample({
-        schema: responseSchemaIdResponse.schema,
-        example: ((_b3 = responseSchemaIdResponse.example) == null ? void 0 : _b3.value) ?? responseSchemaIdResponse.example,
-        options: {
-          isParameter: false,
-          ignoreOptionals: false,
-          maxDepth: 3
+      if (responseSchemaIdResponse.examples.length === 0) {
+        const example = this.exampleTypeFactory.buildExample({
+          schema: responseSchemaIdResponse.schema,
+          exampleId: void 0,
+          example: void 0,
+          options: {
+            maxDepth: 3,
+            isParameter: false,
+            ignoreOptionals: false
+          }
+        });
+        if (example != null) {
+          responseExamples.push([void 0, example]);
+        }
+      } else {
+        for (const { name: exampleId, value: rawExample } of responseSchemaIdResponse.examples) {
+          const example = this.exampleTypeFactory.buildExample({
+            schema: responseSchemaIdResponse.schema,
+            exampleId,
+            example: rawExample,
+            options: {
+              maxDepth: 3,
+              isParameter: false,
+              ignoreOptionals: false
+            }
+          });
+          if (example != null) {
+            responseExamples.push([exampleId, example]);
+          }
         }
-      });
-      if (required && responseExample == null) {
-        return void 0;
+      }
+      if (required && responseExamples.length === 0) {
+        this.logger.warn(`Failed to generate required response example for ${endpoint.method.toUpperCase()} ${endpoint.path}`);
+        return [];
       }
     }
     const pathParameters = [];
@@ -843122,6 +843279,7 @@ var ExampleEndpointFactory = class {
       const required = this.isSchemaRequired(pathParameter.schema);
       let example = this.exampleTypeFactory.buildExample({
         schema: pathParameter.schema,
+        exampleId: void 0,
         example: void 0,
         options: {
           name: pathParameter.name,
@@ -843130,10 +843288,11 @@ var ExampleEndpointFactory = class {
         }
       });
       if (example != null && !isExamplePrimitive(example)) {
+        this.logger.warn(`Expected a primitive example but got ${example.type} for path parameter ${pathParameter.name} for ${endpoint.method.toUpperCase()} ${endpoint.path}`);
         example = void 0;
       }
       if (required && example == null) {
-        return void 0;
+        return [];
       } else if (example != null) {
         pathParameters.push({
           name: pathParameter.name,
@@ -843146,6 +843305,7 @@ var ExampleEndpointFactory = class {
       const required = this.isSchemaRequired(queryParameter.schema);
       let example = this.exampleTypeFactory.buildExample({
         schema: queryParameter.schema,
+        exampleId: void 0,
         example: void 0,
         options: {
           name: queryParameter.name,
@@ -843154,10 +843314,11 @@ var ExampleEndpointFactory = class {
         }
       });
       if (example != null && !isExamplePrimitive(example)) {
+        this.logger.warn(`Expected a primitive example but got ${example.type} for query parameter ${queryParameter.name} for ${endpoint.method.toUpperCase()} ${endpoint.path}`);
         example = void 0;
       }
       if (required && example == null) {
-        return void 0;
+        return [];
       } else if (example != null) {
         queryParameters.push({
           name: queryParameter.name,
@@ -843170,6 +843331,7 @@ var ExampleEndpointFactory = class {
       const required = this.isSchemaRequired(header.schema);
       let example = this.exampleTypeFactory.buildExample({
         schema: header.schema,
+        exampleId: void 0,
         example: void 0,
         options: {
           name: header.name,
@@ -843178,10 +843340,11 @@ var ExampleEndpointFactory = class {
         }
       });
       if (example != null && !isExamplePrimitive(example)) {
+        this.logger.warn(`Expected a primitive example but got ${example.type} for header ${header.name} for ${endpoint.method.toUpperCase()} ${endpoint.path}`);
         example = void 0;
       }
       if (required && example == null) {
-        return void 0;
+        return [];
       } else if (example != null) {
         headers.push({
           name: header.name,
@@ -843189,13 +843352,7 @@ var ExampleEndpointFactory = class {
         });
       }
     }
-    let exampleName = void 0;
-    if ((requestSchemaIdResponse == null ? void 0 : requestSchemaIdResponse.type) === "present") {
-      exampleName = (_c3 = requestSchemaIdResponse == null ? void 0 : requestSchemaIdResponse.example) == null ? void 0 : _c3.name;
-      if (exampleName == null && (requestSchemaIdResponse == null ? void 0 : requestSchemaIdResponse.schema) != null) {
-        exampleName = getNameFromSchemaWithExample(requestSchemaIdResponse.schema);
-      }
-    }
+    const requestResponsePairs = consolidateRequestResponseExamples(requestExamples, responseExamples);
     const codeSamples = endpoint.examples.filter((ex) => hasIncompleteExample(ex)).flatMap((ex) => {
       if (ex.type === "unknown") {
         if (ex.value != null) {
@@ -843209,15 +843366,31 @@ var ExampleEndpointFactory = class {
         return ex.codeSamples;
       }
     }).filter((ex) => isNonNullish(ex));
-    return EndpointExample.full({
-      name: exampleName,
-      description: void 0,
-      pathParameters,
-      queryParameters,
-      headers,
-      request: requestExample,
-      response: responseExample,
-      codeSamples
+    if (requestResponsePairs.length === 0) {
+      return [
+        EndpointExample.full({
+          name: void 0,
+          description: void 0,
+          pathParameters,
+          queryParameters,
+          headers,
+          request: void 0,
+          response: void 0,
+          codeSamples
+        })
+      ];
+    }
+    return requestResponsePairs.map(({ id: exampleName, request: requestExample, response: responseExample }) => {
+      return EndpointExample.full({
+        name: exampleName,
+        description: void 0,
+        pathParameters,
+        queryParameters,
+        headers,
+        request: requestExample,
+        response: responseExample,
+        codeSamples
+      });
     });
   }
   convertCodeSamples(codeSamples) {
@@ -843244,18 +843417,109 @@ var ExampleEndpointFactory = class {
     return isSchemaRequired4(this.getResolvedSchema(schema2));
   }
   getResolvedSchema(schema2) {
-    while (schema2.type === "reference") {
-      const resolvedSchema = this.schemas[schema2.schema];
-      if (resolvedSchema == null) {
-        throw new Error(`Unexpected error: Failed to resolve schema reference: ${schema2.schema}`);
-      }
-      schema2 = resolvedSchema;
-    }
     return schema2;
   }
 };
+function consolidateRequestResponseExamples(requestExamples, responseExamples) {
+  var _a4, _b3, _c3, _d;
+  const pairs2 = [];
+  if (requestExamples.length <= 1) {
+    const [requestId, requestExample] = requestExamples[0] ?? [];
+    if (responseExamples.length === 0) {
+      pairs2.push({
+        id: requestId,
+        request: requestExample,
+        response: void 0
+      });
+      return pairs2;
+    } else {
+      for (const [responseId, responseExample] of responseExamples) {
+        pairs2.push({
+          id: responseId ?? requestId,
+          request: requestExample,
+          response: responseExample
+        });
+      }
+    }
+    return pairs2;
+  }
+  if (responseExamples.length <= 1) {
+    const [responseId, responseExample] = responseExamples[0] ?? [];
+    if (responseExamples.length === 0) {
+      pairs2.push({
+        id: responseId,
+        request: void 0,
+        response: responseExample
+      });
+      return pairs2;
+    } else {
+      for (const [requestId, requestExample] of requestExamples) {
+        pairs2.push({
+          id: requestId ?? responseId,
+          request: requestExample,
+          response: responseExample
+        });
+      }
+    }
+    return pairs2;
+  }
+  const visitedResponseIdx = /* @__PURE__ */ new Set();
+  for (const [requestId, requestExample] of requestExamples) {
+    const fallbackResponseExample = ((_a4 = responseExamples.find(([responseId]) => responseId == null)) == null ? void 0 : _a4[1]) ?? ((_b3 = responseExamples[0]) == null ? void 0 : _b3[1]);
+    if (requestId == null) {
+      if (fallbackResponseExample == null) {
+        continue;
+      }
+      pairs2.push({
+        id: void 0,
+        request: requestExample,
+        response: fallbackResponseExample
+      });
+      continue;
+    }
+    let paired = false;
+    for (let idx = 0; idx < responseExamples.length; idx++) {
+      const [responseId, responseExample] = responseExamples[idx];
+      if (responseId != null || visitedResponseIdx.has(idx)) {
+        continue;
+      }
+      if (requestId === responseId) {
+        pairs2.push({
+          id: requestId,
+          request: requestExample,
+          response: responseExample
+        });
+        if (responseId != null) {
+          visitedResponseIdx.add(idx);
+        }
+        paired = true;
+      }
+    }
+    if (!paired && fallbackResponseExample != null) {
+      pairs2.push({
+        id: requestId,
+        request: requestExample,
+        response: fallbackResponseExample
+      });
+    }
+  }
+  for (let idx = 0; idx < responseExamples.length; idx++) {
+    if (visitedResponseIdx.has(idx)) {
+      continue;
+    }
+    const [responseId, responseExample] = responseExamples[idx];
+    const requestExample = ((_c3 = requestExamples.find(([requestId]) => requestId == null)) == null ? void 0 : _c3[1]) ?? ((_d = requestExamples[0]) == null ? void 0 : _d[1]);
+    if (requestExample != null) {
+      pairs2.push({
+        id: responseId,
+        request: requestExample,
+        response: responseExample
+      });
+    }
+  }
+  return pairs2;
+}
 function getRequestSchema(request) {
-  var _a4;
   if (request == null) {
     return void 0;
   }
@@ -843263,23 +843527,22 @@ function getRequestSchema(request) {
     return {
       type: "present",
       schema: convertMultipartRequestToSchema(request),
-      example: void 0
+      examples: []
     };
   }
   if (request.type === "json") {
-    return { type: "present", schema: request.schema, example: ((_a4 = request.fullExamples) == null ? void 0 : _a4[0]) ?? void 0 };
+    return { type: "present", schema: request.schema, examples: request.fullExamples ?? [] };
   }
   return { type: "unsupported" };
 }
 function getResponseSchema(response) {
-  var _a4;
   if (response == null) {
     return void 0;
   }
   if (response.type !== "json") {
     return { type: "unsupported" };
   }
-  return { type: "present", schema: response.schema, example: ((_a4 = response.fullExamples) == null ? void 0 : _a4[0]) ?? void 0 };
+  return { type: "present", schema: response.schema, examples: response.fullExamples ?? [] };
 }
 function isExamplePrimitive(example) {
   switch (example.type) {
@@ -843306,34 +843569,6 @@ function isExamplePrimitive(example) {
       assertNever(example);
   }
 }
-function getNameFromSchemaWithExample(schema2) {
-  var _a4, _b3;
-  switch (schema2.type) {
-    case "primitive":
-    case "enum":
-    case "literal":
-    case "unknown":
-    case "array":
-    case "map":
-    case "optional":
-    case "nullable":
-    case "reference":
-      return void 0;
-    case "object":
-      return ((_b3 = (_a4 = schema2.fullExamples) == null ? void 0 : _a4[0]) == null ? void 0 : _b3.name) ?? void 0;
-    case "oneOf":
-      switch (schema2.value.type) {
-        case "discriminated":
-          return void 0;
-        case "undisciminated":
-          return void 0;
-        default:
-          return void 0;
-      }
-    default:
-      assertNever(schema2);
-  }
-}
 function convertMultipartRequestToSchema(request) {
   return SchemaWithExample.object({
     properties: request.properties.map((property5) => {
@@ -843375,6 +843610,7 @@ var ExampleWebsocketSessionFactory = class {
         const required = this.isSchemaRequired(queryParameter.schema);
         let example = this.exampleTypeFactory.buildExample({
           schema: queryParameter.schema,
+          exampleId: void 0,
           example: (_a4 = extensionExample.queryParameters) == null ? void 0 : _a4[queryParameter.name],
           options: {
             name: queryParameter.name,
@@ -843399,6 +843635,7 @@ var ExampleWebsocketSessionFactory = class {
         const required = this.isSchemaRequired(header.schema);
         let example = this.exampleTypeFactory.buildExample({
           schema: header.schema,
+          exampleId: void 0,
           example: (_b3 = extensionExample.headers) == null ? void 0 : _b3[header.name],
           options: {
             name: header.name,
@@ -843426,6 +843663,7 @@ var ExampleWebsocketSessionFactory = class {
         const resolvedSchema = isReferenceObject(messageSchema.payload) ? context.resolveSchemaReference(messageSchema.payload) : messageSchema.payload;
         const example = this.exampleTypeFactory.buildExample({
           schema: convertSchema(resolvedSchema, false, context, [messageExample.messageId]),
+          exampleId: void 0,
           example: messageExample.value,
           options: {
             isParameter: false,
@@ -843463,6 +843701,7 @@ var ExampleWebsocketSessionFactory = class {
       const required = this.isSchemaRequired(queryParameter.schema);
       let example2 = this.exampleTypeFactory.buildExample({
         schema: queryParameter.schema,
+        exampleId: void 0,
         example: void 0,
         options: {
           name: queryParameter.name,
@@ -843487,6 +843726,7 @@ var ExampleWebsocketSessionFactory = class {
       const required = this.isSchemaRequired(header.schema);
       let example2 = this.exampleTypeFactory.buildExample({
         schema: header.schema,
+        exampleId: void 0,
         example: void 0,
         options: {
           name: header.name,
@@ -843509,6 +843749,7 @@ var ExampleWebsocketSessionFactory = class {
     if (publish2 != null) {
       const publishMessageExample = this.exampleTypeFactory.buildExample({
         schema: publish2,
+        exampleId: void 0,
         example: void 0,
         options: {
           isParameter: false,
@@ -843526,6 +843767,7 @@ var ExampleWebsocketSessionFactory = class {
     if (subscribe != null) {
       const publishMessageExample = this.exampleTypeFactory.buildExample({
         schema: subscribe,
+        exampleId: void 0,
         example: void 0,
         options: {
           isParameter: false,
@@ -843843,7 +844085,7 @@ function maybeTrimRequestPrefix(streamCondition) {
 }
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/endpoint/getApplicationJsonSchema.js
-function getApplicationJsonSchemaMediaObject(media) {
+function getApplicationJsonSchemaMediaObject(media, context) {
   for (const contentType of Object.keys(media)) {
     if (contentType.includes("json")) {
       const mediaObject = media[contentType];
@@ -843862,11 +844104,9 @@ function getApplicationJsonSchemaMediaObject(media) {
         }));
       }
       if (mediaObject.examples != null && Object.keys(mediaObject.examples).length > 0) {
-        fullExamples.push(...Object.entries(mediaObject.examples).map(([name2, value]) => {
-          if (isReferenceObject(value)) {
-            return { name: void 0, value: void 0 };
-          }
-          return { name: value.summary ?? name2, value: value.value };
+        fullExamples.push(...Object.entries(mediaObject.examples).map(([name2, example]) => {
+          const resolvedExample = isReferenceObject(example) ? context.resolveExampleReference(example) : example;
+          return { name: resolvedExample.summary ?? name2, value: resolvedExample.value };
         }));
       }
       if (schema2 != null) {
@@ -843903,7 +844143,7 @@ function multipartRequestHasFile(multipartSchema, document4) {
 function convertRequest({ requestBody, document: document4, context, requestBreadcrumbs }) {
   const resolvedRequestBody = isReferenceObject(requestBody) ? context.resolveRequestBodyReference(requestBody) : requestBody;
   const multipartSchema = getMultipartFormDataRequest(resolvedRequestBody);
-  const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedRequestBody.content);
+  const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedRequestBody.content, context);
   if (isOctetStreamRequest(resolvedRequestBody)) {
     return RequestWithExample.octetStream({
       description: void 0
@@ -844054,6 +844294,7 @@ function removeApplicationJsonAndMultipartConflictsFromRequestBody(requestBody)
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/AbstractOpenAPIV3ParserContext.js
 var PARAMETER_REFERENCE_PREFIX = "#/components/parameters/";
 var RESPONSE_REFERENCE_PREFIX = "#/components/responses/";
+var EXAMPLES_REFERENCE_PREFIX = "#/components/examples/";
 var REQUEST_BODY_REFERENCE_PREFIX = "#/components/requestBodies/";
 var AbstractOpenAPIV3ParserContext = class {
   logger;
@@ -844132,6 +844373,20 @@ var AbstractOpenAPIV3ParserContext = class {
     }
     return resolvedResponse;
   }
+  resolveExampleReference(example) {
+    if (this.document.components == null || this.document.components.examples == null || !example.$ref.startsWith(EXAMPLES_REFERENCE_PREFIX)) {
+      throw new Error(`Failed to resolve ${example.$ref}`);
+    }
+    const parameterKey = example.$ref.substring(EXAMPLES_REFERENCE_PREFIX.length);
+    const resolvedExample = this.document.components.examples[parameterKey];
+    if (resolvedExample == null) {
+      throw new Error(`${example.$ref} is undefined`);
+    }
+    if (isReferenceObject(resolvedExample)) {
+      return this.resolveExampleReference(resolvedExample);
+    }
+    return resolvedExample;
+  }
 };
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/DummyOpenAPIV3ParserContext.js
@@ -844416,7 +844671,7 @@ function convertResolvedResponse({ operationContext, isStreaming, response, cont
       return ResponseWithExample.file({ description: resolvedResponse.description });
     }
   }
-  const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedResponse.content ?? {});
+  const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedResponse.content ?? {}, context);
   if (jsonMediaObject != null) {
     if (isStreaming) {
       return ResponseWithExample.streamingJson({
@@ -844466,7 +844721,7 @@ function markErrorSchemas({ responses, context }) {
     }
     errorStatusCodes.push(parsedStatusCode);
     const resolvedResponse = isReferenceObject(response) ? context.resolveResponseReference(response) : response;
-    const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedResponse.content ?? {});
+    const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedResponse.content ?? {}, context);
     context.markSchemaForStatusCode(parsedStatusCode, (jsonMediaObject == null ? void 0 : jsonMediaObject.schema) ?? {});
   }
   return errorStatusCodes;
@@ -844703,7 +844958,7 @@ function getRequestBody2({ context, operation, streamingExtension, isStreaming }
     return void 0;
   }
   const resolvedRequestBody = isReferenceObject(operation.requestBody) ? context.resolveRequestBodyReference(operation.requestBody) : operation.requestBody;
-  const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedRequestBody.content);
+  const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedRequestBody.content, context);
   if (jsonMediaObject == null) {
     return void 0;
   }
@@ -845408,9 +845663,9 @@ function generateIr({ openApi, taskContext, disableExamples }) {
     let examples = extensionExamples;
     if (!disableExamples && (extensionExamples.length === 0 || extensionExamples.every(hasIncompleteExample))) {
       const endpointExample = exampleEndpointFactory.buildEndpointExample(endpointWithExample);
-      if (endpointExample != null) {
+      if (endpointExample.length > 0) {
         examples = [
-          endpointExample,
+          ...endpointExample,
           ...extensionExamples.filter((example) => !hasIncompleteExample(example))
         ];
       }
@@ -851457,10 +851712,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.21.0" == null) {
+    if ("0.22.0-rc1" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.21.0";
+    return "0.22.0-rc1";
   }
   getCliName() {
     if ("fern" == null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fern-api",
-  "version": "0.21.0",
+  "version": "0.22.0-rc1",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern.git",