fern-api 0.23.0-rc5 → 0.23.0-rc7

package/bundle.cjs

@@ -341328,6 +341328,12 @@ var init_HeaderExample = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/ErrorExample.js
+var init_ErrorExample = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/ErrorExample.js"() {
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/EndpointSdkName.js
 var init_EndpointSdkName = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/finalIr/types/EndpointSdkName.js"() {
@@ -342062,6 +342068,7 @@ var init_types28 = __esm({
     init_PathParameterExample();
     init_QueryParameterExample();
     init_HeaderExample();
+    init_ErrorExample();
     init_EndpointSdkName();
     init_HttpMethod3();
     init_PathParameter3();
@@ -342128,6 +342135,12 @@ var init_EndpointWithExample = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/parseIr/types/HttpErrorWithExample.js
+var init_HttpErrorWithExample = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/parseIr/types/HttpErrorWithExample.js"() {
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/api/resources/parseIr/types/RequestWithExample.js
 var RequestWithExample;
 var init_RequestWithExample = __esm({
@@ -342711,6 +342724,7 @@ var init_types29 = __esm({
     init_NamedFullExample();
     init_WebsocketHandshakeWithExample();
     init_EndpointWithExample();
+    init_HttpErrorWithExample();
     init_RequestWithExample();
     init_JsonRequestWithExample();
     init_ResponseWithExample();
@@ -344773,7 +344787,6 @@ var init_OpenApiIntermediateRepresentation2 = __esm({
       webhooks: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Webhook)),
       channel: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WebsocketChannel)),
       schemas: schemas_exports5.record(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SchemaId), schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Schema)),
-      errors: schemas_exports5.record(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode), schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).HttpError)),
       variables: schemas_exports5.record(schemas_exports5.string(), schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).PrimitiveSchema)),
       nonRequestReferencedSchemas: schemas_exports5.set(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SchemaId)),
       securitySchemes: schemas_exports5.record(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SecuritySchemeId), schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SecurityScheme)),
@@ -344827,7 +344840,8 @@ var init_HttpError2 = __esm({
   "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/HttpError.js"() {
     init_core3();
     HttpError = schemas_exports5.objectWithoutOptionalProperties({
-      schema: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Schema).optional()
+      schema: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Schema).optional(),
+      examples: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).ErrorExample)).optional()
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription)).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithName));
   }
 });
@@ -344946,7 +344960,7 @@ var init_Endpoint2 = __esm({
       requestNameOverride: schemas_exports5.string().optional(),
       request: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Request).optional(),
       response: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Response).optional(),
-      errorStatusCode: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode)),
+      errors: schemas_exports5.record(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode), schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).HttpError)),
       server: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Server)),
       examples: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).EndpointExample))
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
@@ -345119,6 +345133,19 @@ var init_HeaderExample2 = __esm({
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/ErrorExample.js
+var ErrorExample;
+var init_ErrorExample2 = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/ErrorExample.js"() {
+    init_core3();
+    ErrorExample = schemas_exports5.objectWithoutOptionalProperties({
+      name: schemas_exports5.string().optional(),
+      description: schemas_exports5.string().optional(),
+      example: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).FullExample)
+    });
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/EndpointSdkName.js
 var EndpointSdkName;
 var init_EndpointSdkName2 = __esm({
@@ -345756,6 +345783,7 @@ var init_types32 = __esm({
     init_PathParameterExample2();
     init_QueryParameterExample2();
     init_HeaderExample2();
+    init_ErrorExample2();
     init_EndpointSdkName2();
     init_HttpMethod4();
     init_PathParameter4();
@@ -345814,6 +345842,7 @@ __export(finalIr_exports2, {
   EndpointSdkName: () => EndpointSdkName,
   EnumSchema: () => EnumSchema2,
   EnumValue: () => EnumValue2,
+  ErrorExample: () => ErrorExample,
   FernExample: () => FernExample,
   FileResponse: () => FileResponse,
   FileSchema: () => FileSchema,
@@ -345876,7 +345905,7 @@ var init_NamedFullExample2 = __esm({
     NamedFullExample = schemas_exports5.objectWithoutOptionalProperties({
       name: schemas_exports5.string().optional(),
       value: schemas_exports5.unknown()
-    });
+    }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
   }
 });
 
@@ -345915,13 +345944,26 @@ var init_EndpointWithExample2 = __esm({
       requestNameOverride: schemas_exports5.string().optional(),
       request: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).RequestWithExample).optional(),
       response: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).ResponseWithExample).optional(),
-      errorStatusCode: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode)),
+      errors: schemas_exports5.record(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode), schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).HttpErrorWithExample)),
       server: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).Server)),
       examples: schemas_exports5.list(schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).EndpointExample))
     }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription));
   }
 });
 
+// pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/parseIr/types/HttpErrorWithExample.js
+var HttpErrorWithExample;
+var init_HttpErrorWithExample2 = __esm({
+  "pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/parseIr/types/HttpErrorWithExample.js"() {
+    init_core3();
+    HttpErrorWithExample = schemas_exports5.objectWithoutOptionalProperties({
+      statusCode: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).StatusCode),
+      schema: schemas_exports5.lazy(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).SchemaWithExample),
+      fullExamples: schemas_exports5.list(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).NamedFullExample)).optional()
+    }).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithDescription)).extend(schemas_exports5.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization3(), serialization_exports3))).WithName));
+  }
+});
+
 // pnp:/home/circleci/project/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/parseIr/types/RequestWithExample.js
 var RequestWithExample2;
 var init_RequestWithExample2 = __esm({
@@ -346430,6 +346472,7 @@ var init_types33 = __esm({
     init_NamedFullExample2();
     init_WebsocketHandshakeWithExample2();
     init_EndpointWithExample2();
+    init_HttpErrorWithExample2();
     init_RequestWithExample2();
     init_JsonRequestWithExample2();
     init_ResponseWithExample2();
@@ -346479,6 +346522,7 @@ __export(parseIr_exports2, {
   EnumSchemaWithExample: () => EnumSchemaWithExample,
   FloatWithExample: () => FloatWithExample,
   HeaderWithExample: () => HeaderWithExample,
+  HttpErrorWithExample: () => HttpErrorWithExample,
   Int64WithExample: () => Int64WithExample,
   IntWithExample: () => IntWithExample,
   JsonRequestWithExample: () => JsonRequestWithExample,
@@ -346551,6 +346595,7 @@ __export(serialization_exports3, {
   EnumSchema: () => EnumSchema2,
   EnumSchemaWithExample: () => EnumSchemaWithExample,
   EnumValue: () => EnumValue2,
+  ErrorExample: () => ErrorExample,
   FernExample: () => FernExample,
   FileResponse: () => FileResponse,
   FileSchema: () => FileSchema,
@@ -346565,6 +346610,7 @@ __export(serialization_exports3, {
   HeaderSecurityScheme: () => HeaderSecurityScheme,
   HeaderWithExample: () => HeaderWithExample,
   HttpError: () => HttpError,
+  HttpErrorWithExample: () => HttpErrorWithExample,
   HttpMethod: () => HttpMethod6,
   Int64WithExample: () => Int64WithExample,
   IntWithExample: () => IntWithExample,
@@ -852804,7 +852850,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.23.0-rc5",
+          version: "0.23.0-rc7",
           usingAccessToken: true
         }
       });
@@ -852866,7 +852912,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.23.0-rc5",
+        version: "0.23.0-rc7",
         ...event,
         ...event.properties
       }
@@ -867110,11 +867156,11 @@ function convertSchemaObject(schema2, wrapAsNullable, context, breadcrumbs, prop
   const examples = getExtension(schema2, OpenAPIExtension.EXAMPLES);
   const fullExamples = [];
   if (schema2.example != null) {
-    fullExamples.push({ name: void 0, value: schema2.example });
+    fullExamples.push({ name: void 0, value: schema2.example, description: void 0 });
   }
   if (examples != null && Object.keys(examples).length > 0) {
     fullExamples.push(...Object.entries(examples).map(([name2, value]) => {
-      return { name: value.summary ?? name2, value: value.value };
+      return { name: value.summary ?? name2, value: value.value, description: value.description };
     }));
   }
   const fernSchema = getFernTypeExtension({ schema: schema2, description, nameOverride, generatedName });
@@ -869568,32 +869614,51 @@ function getApplicationJsonSchemaMediaObject(media, context) {
         continue;
       }
       const schema2 = mediaObject.schema;
-      const fullExamples = [];
-      if (mediaObject.example != null) {
-        fullExamples.push({ name: void 0, value: mediaObject.example });
-      }
-      const examples = getExtension(mediaObject, OpenAPIExtension.EXAMPLES);
-      if (examples != null && Object.keys(examples).length > 0) {
-        fullExamples.push(...Object.entries(examples).map(([name2, value]) => {
-          return { name: value.summary ?? name2, value: value.value };
-        }));
-      }
-      if (mediaObject.examples != null && Object.keys(mediaObject.examples).length > 0) {
-        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) {
-        return {
-          schema: schema2,
-          examples: fullExamples
-        };
-      }
+      return {
+        schema: schema2 ?? {},
+        examples: getExamples(mediaObject, context)
+      };
     }
   }
   return void 0;
 }
+function getSchemaMediaObject(media, context) {
+  for (const contentType of Object.keys(media)) {
+    const mediaObject = media[contentType];
+    if (mediaObject == null) {
+      continue;
+    }
+    const schema2 = mediaObject.schema;
+    return {
+      schema: schema2 ?? {},
+      examples: getExamples(mediaObject, context)
+    };
+  }
+  return void 0;
+}
+function getExamples(mediaObject, context) {
+  const fullExamples = [];
+  if (mediaObject.example != null) {
+    fullExamples.push({ name: void 0, value: mediaObject.example, description: void 0 });
+  }
+  const examples = getExtension(mediaObject, OpenAPIExtension.EXAMPLES);
+  if (examples != null && Object.keys(examples).length > 0) {
+    fullExamples.push(...Object.entries(examples).map(([name2, value]) => {
+      return { name: value.summary ?? name2, value: value.value, description: value.description };
+    }));
+  }
+  if (mediaObject.examples != null && Object.keys(mediaObject.examples).length > 0) {
+    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,
+        description: resolvedExample.description
+      };
+    }));
+  }
+  return fullExamples;
+}
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/endpoint/convertRequest.js
 var APPLICATION_JSON_CONTENT = "application/json";
@@ -869881,18 +869946,12 @@ var DummyOpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   getReferencedSchemas() {
     return /* @__PURE__ */ new Set();
   }
-  markSchemaForStatusCode(_statusCode, _schema) {
-    return;
-  }
   markReferencedByDiscriminatedUnion(_schema, _discrminant, _times) {
     return;
   }
   getReferencesFromDiscriminatedUnion(_schema) {
     return void 0;
   }
-  getErrors() {
-    return {};
-  }
   excludeSchema(_schemaId) {
   }
   isSchemaExcluded(_schemaId) {
@@ -870079,6 +870138,59 @@ var HEADERS_TO_SKIP = /* @__PURE__ */ new Set([
   "X-Ping-Custom-Domain"
 ]);
 
+// pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/convertToHttpError.js
+var ERROR_NAMES_BY_STATUS_CODE = {
+  400: "BadRequestError",
+  401: "UnauthorizedError",
+  402: "PaymentRequiredError",
+  403: "ForbiddenError",
+  404: "NotFoundError",
+  405: "MethodNotAllowedError",
+  406: "NotAcceptableError",
+  407: "ProxyAuthenticationRequiredError",
+  408: "RequestTimeoutError",
+  409: "ConflictError",
+  410: "GoneError",
+  411: "LengthRequiredError",
+  412: "PreconditionFailedError",
+  413: "ContentTooLargeError",
+  414: "URITooLongError",
+  415: "UnsupportedMediaTypeError",
+  416: "RangeNotSatisfiableError",
+  417: "ExpectationFailedError",
+  418: "ImATeapotError",
+  419: "AuthenticationTimeoutError",
+  420: "MethodFailureError",
+  421: "MisdirectedRequestError",
+  422: "UnprocessableEntityError",
+  423: "LockedError",
+  424: "FailedDependencyError",
+  425: "TooEarlyError",
+  426: "UpgradeRequiredError",
+  428: "PreconditionError",
+  429: "TooManyRequestsError",
+  430: "RequestHeaderFieldsTooLargeError",
+  431: "RequestHeaderFieldsTooLargeError",
+  444: "NoResponseError",
+  449: "RetryWithError",
+  450: "BlockedByWindowsParentalControlsError",
+  451: "UnavailableForLegalReasonsError",
+  499: "ClientClosedRequestError",
+  500: "InternalServerError",
+  501: "NotImplementedError",
+  502: "BadGatewayError",
+  503: "ServiceUnavailableError",
+  504: "GatewayTimeoutError",
+  505: "HTTPVersionNotSupportedError",
+  506: "VariantAlsoNegotiatesError",
+  507: "InsufficientStorageError",
+  508: "LoopDetectedError",
+  509: "BandwidthLimitExceededError",
+  510: "NotExtendedError",
+  511: "NetworkAuthenticationRequiredError"
+};
+var ERROR_NAMES = new Set(Object.values(ERROR_NAMES_BY_STATUS_CODE));
+
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/endpoint/convertResponse.js
 var APPLICATION_OCTET_STREAM_CONTENT = "application/octet-stream";
 var APPLICATION_PDF = "application/pdf";
@@ -870087,9 +870199,9 @@ var TEXT_PLAIN_CONTENT = "text/plain";
 var SUCCESSFUL_STATUS_CODES = ["200", "201", "204"];
 function convertResponse({ operationContext, responses, context, responseBreadcrumbs, responseStatusCode, streamFormat }) {
   if (responses == null) {
-    return { value: void 0, errorStatusCodes: [] };
+    return { value: void 0, errors: {} };
   }
-  const errorStatusCodes = markErrorSchemas({ responses, context });
+  const errors = markErrorSchemas({ responses, context });
   for (const statusCode of responseStatusCode != null ? [responseStatusCode] : SUCCESSFUL_STATUS_CODES) {
     const response = responses[statusCode];
     if (response == null) {
@@ -870107,20 +870219,20 @@ function convertResponse({ operationContext, responses, context, responseBreadcr
         case "json":
           return {
             value: convertedResponse,
-            errorStatusCodes
+            errors
           };
         case "streamingJson":
         case "streamingSse":
           return {
             value: convertedResponse,
-            errorStatusCodes
+            errors
           };
         case "file":
         case "text":
         case "streamingText":
           return {
             value: convertedResponse,
-            errorStatusCodes: []
+            errors
           };
         default:
           assertNever(convertedResponse);
@@ -870129,11 +870241,11 @@ function convertResponse({ operationContext, responses, context, responseBreadcr
   }
   return {
     value: void 0,
-    errorStatusCodes
+    errors
   };
 }
 function convertResolvedResponse({ operationContext, streamFormat, response, context, responseBreadcrumbs }) {
-  var _a5, _b4, _c4, _d2, _e, _f, _g, _h;
+  var _a5, _b4, _c4, _d2, _e;
   const resolvedResponse = isReferenceObject(response) ? context.resolveResponseReference(response) : response;
   if (resolvedResponse.content != null) {
     const isdownloadFile = Object.entries(resolvedResponse.content).find(([_4, mediaObject]) => {
@@ -870172,30 +870284,30 @@ function convertResolvedResponse({ operationContext, streamFormat, response, con
       fullExamples: jsonMediaObject.examples
     });
   }
-  if (((_b4 = (_a5 = resolvedResponse.content) == null ? void 0 : _a5[APPLICATION_OCTET_STREAM_CONTENT]) == null ? void 0 : _b4.schema) != null) {
+  if (((_a5 = resolvedResponse.content) == null ? void 0 : _a5[APPLICATION_OCTET_STREAM_CONTENT]) != null) {
     return ResponseWithExample.file({ description: resolvedResponse.description });
   }
-  if (((_d2 = (_c4 = resolvedResponse.content) == null ? void 0 : _c4[APPLICATION_PDF]) == null ? void 0 : _d2.schema) != null) {
+  if (((_b4 = resolvedResponse.content) == null ? void 0 : _b4[APPLICATION_PDF]) != null) {
     return ResponseWithExample.file({ description: resolvedResponse.description });
   }
-  if (((_f = (_e = resolvedResponse.content) == null ? void 0 : _e[TEXT_PLAIN_CONTENT]) == null ? void 0 : _f.schema) != null) {
-    const textPlainSchema = (_g = resolvedResponse.content[TEXT_PLAIN_CONTENT]) == null ? void 0 : _g.schema;
+  if (((_c4 = resolvedResponse.content) == null ? void 0 : _c4[TEXT_PLAIN_CONTENT]) != null) {
+    const textPlainSchema = (_d2 = resolvedResponse.content[TEXT_PLAIN_CONTENT]) == null ? void 0 : _d2.schema;
     if (textPlainSchema == null) {
       return ResponseWithExample.text({ description: resolvedResponse.description });
     }
     const resolvedTextPlainSchema = isReferenceObject(textPlainSchema) ? context.resolveSchemaReference(textPlainSchema) : textPlainSchema;
     if (resolvedTextPlainSchema.type === "string" && resolvedTextPlainSchema.format === "byte") {
-      return;
+      return ResponseWithExample.file({ description: resolvedResponse.description });
     }
     return ResponseWithExample.text({ description: resolvedResponse.description });
   }
-  if (((_h = resolvedResponse.content) == null ? void 0 : _h[AUDIO_MPEG]) != null) {
+  if (((_e = resolvedResponse.content) == null ? void 0 : _e[AUDIO_MPEG]) != null) {
     return ResponseWithExample.file({ description: resolvedResponse.description });
   }
   return void 0;
 }
 function markErrorSchemas({ responses, context }) {
-  const errorStatusCodes = [];
+  const errors = {};
   for (const [statusCode, response] of Object.entries(responses)) {
     if (statusCode === "default") {
       continue;
@@ -870204,12 +870316,23 @@ function markErrorSchemas({ responses, context }) {
     if (parsedStatusCode < 400 || parsedStatusCode > 600) {
       continue;
     }
-    errorStatusCodes.push(parsedStatusCode);
     const resolvedResponse = isReferenceObject(response) ? context.resolveResponseReference(response) : response;
-    const jsonMediaObject = getApplicationJsonSchemaMediaObject(resolvedResponse.content ?? {}, context);
-    context.markSchemaForStatusCode(parsedStatusCode, (jsonMediaObject == null ? void 0 : jsonMediaObject.schema) ?? {});
+    const mediaObject = getSchemaMediaObject(resolvedResponse.content ?? {}, context);
+    const errorName = ERROR_NAMES_BY_STATUS_CODE[parsedStatusCode];
+    if (errorName == null) {
+      context.logger.warn(`No error name found for status code ${statusCode}`);
+      continue;
+    }
+    errors[parsedStatusCode] = {
+      statusCode: parsedStatusCode,
+      nameOverride: void 0,
+      generatedName: errorName,
+      description: resolvedResponse.description,
+      schema: convertSchema((mediaObject == null ? void 0 : mediaObject.schema) ?? {}, false, context, [errorName, "Body"]),
+      fullExamples: mediaObject == null ? void 0 : mediaObject.examples
+    };
   }
-  return errorStatusCodes;
+  return errors;
 }
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/operation/convertHttpOperation.js
@@ -870276,7 +870399,7 @@ function convertHttpOperation({ operationContext, context, responseStatusCode, s
     generatedRequestName: getGeneratedTypeName(requestBreadcrumbs),
     request: convertedRequest,
     response: convertedResponse.value,
-    errorStatusCode: convertedResponse.errorStatusCodes,
+    errors: convertedResponse.errors,
     server: (operation.servers ?? []).map((server) => convertServer(server)),
     description: operation.description,
     authed: isEndpointAuthed(operation, document4),
@@ -870784,46 +870907,6 @@ function getScopes(oauthSecurityScheme) {
   return void 0;
 }
 
-// pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/converters/convertToHttpError.js
-var ERROR_NAMES_BY_STATUS_CODE = {
-  400: "BadRequestError",
-  401: "UnauthorizedError",
-  403: "ForbiddenError",
-  404: "NotFoundError",
-  408: "RequestTimeoutError",
-  409: "ConflictError",
-  413: "ContentTooLargeError",
-  422: "UnprocessableEntityError",
-  428: "PreconditionError",
-  429: "TooManyRequestsError",
-  500: "InternalServerError",
-  501: "NotImplementedError",
-  503: "ServiceUnavailableError"
-};
-var ERROR_NAMES = new Set(Object.values(ERROR_NAMES_BY_STATUS_CODE));
-function convertToError({ statusCode, errorBodyCollector, context }) {
-  const errorName = ERROR_NAMES_BY_STATUS_CODE[statusCode];
-  if (errorName == null) {
-    return void 0;
-  }
-  const schemas = errorBodyCollector.getSchemas();
-  if (schemas.length === 1 && schemas[0] != null) {
-    const schema2 = convertSchema(schemas[0], false, context, [errorName, "Body"]);
-    return {
-      generatedName: errorName,
-      nameOverride: void 0,
-      schema: schema2,
-      description: void 0
-    };
-  }
-  return {
-    generatedName: errorName,
-    nameOverride: void 0,
-    schema: Schema2.unknown({ nameOverride: void 0, generatedName: errorName }),
-    description: void 0
-  };
-}
-
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernGroups.js
 var XFernGroupsSchema = z.record(z.string(), z.object({
   summary: z.string().optional(),
@@ -870879,49 +870962,12 @@ function getVariableDefinitions(document4) {
   }));
 }
 
-// pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/ErrorBodyCollector.js
-var ErrorBodyCollector = class {
-  references = /* @__PURE__ */ new Set();
-  schemas = [];
-  convertedSchemas = [];
-  context;
-  constructor(context) {
-    this.context = context;
-  }
-  collect(schema2) {
-    if (isReferenceObject(schema2)) {
-      if (this.references.has(schema2.$ref)) {
-      } else {
-        this.schemas.push(schema2);
-        this.references.add(schema2.$ref);
-      }
-    } else {
-      const convertedCurrentSchema = convertSchema(schema2, false, this.context, []);
-      let isDupe = false;
-      for (const convertedSchema of this.convertedSchemas) {
-        isDupe = isSchemaEqual(convertedSchema, convertedCurrentSchema);
-        if (isDupe) {
-          break;
-        }
-      }
-      if (!isDupe) {
-        this.schemas.push(schema2);
-        this.convertedSchemas.push(convertedCurrentSchema);
-      }
-    }
-  }
-  getSchemas() {
-    return this.schemas;
-  }
-};
-
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/OpenAPIV3ParserContext.js
 var OpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   nonRequestReferencedSchemas = /* @__PURE__ */ new Set();
   twoOrMoreRequestsReferencedSchemas = /* @__PURE__ */ new Set();
   singleRequestReferencedSchemas = /* @__PURE__ */ new Set();
   discrminatedUnionReferences = {};
-  errorBodies = {};
   schemasToExclude = /* @__PURE__ */ new Set();
   constructor({ document: document4, taskContext, authHeaders }) {
     super({ document: document4, taskContext, authHeaders });
@@ -870942,16 +870988,6 @@ var OpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   getReferencedSchemas() {
     return /* @__PURE__ */ new Set([...this.nonRequestReferencedSchemas, ...this.twoOrMoreRequestsReferencedSchemas]);
   }
-  markSchemaForStatusCode(statusCode, schema2) {
-    var _a5;
-    if (this.errorBodies[statusCode] != null) {
-      (_a5 = this.errorBodies[statusCode]) == null ? void 0 : _a5.collect(schema2);
-    } else {
-      const collector = new ErrorBodyCollector(this);
-      collector.collect(schema2);
-      this.errorBodies[statusCode] = collector;
-    }
-  }
   markReferencedByDiscriminatedUnion(schema2, discrminant, times2) {
     const existingReference = this.discrminatedUnionReferences[schema2.$ref];
     if (existingReference != null) {
@@ -870967,21 +871003,6 @@ var OpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   getReferencesFromDiscriminatedUnion(schema2) {
     return this.discrminatedUnionReferences[schema2.$ref];
   }
-  getErrors() {
-    const errors = {};
-    Object.entries(this.errorBodies).forEach(([statusCode, errorBodyCollector]) => {
-      const parsedStatusCode = parseInt(statusCode);
-      const convertedError = convertToError({
-        statusCode: parsedStatusCode,
-        errorBodyCollector,
-        context: this
-      });
-      if (convertedError != null) {
-        errors[parsedStatusCode] = convertedError;
-      }
-    });
-    return errors;
-  }
   excludeSchema(schemaId) {
     this.schemasToExclude.add(schemaId);
   }
@@ -871205,7 +871226,27 @@ function generateIr({ openApi, taskContext, disableExamples }) {
           env: header.env
         };
       }),
-      examples
+      examples,
+      errors: mapValues_default(endpointWithExample.errors, (error) => {
+        var _a6;
+        return {
+          generatedName: error.generatedName,
+          nameOverride: error.nameOverride,
+          schema: convertSchemaWithExampleToSchema(error.schema),
+          description: error.description,
+          examples: (_a6 = error.fullExamples) == null ? void 0 : _a6.map((example) => {
+            const fullExample = convertToFullExample(example.value);
+            if (fullExample == null) {
+              return void 0;
+            }
+            return {
+              name: example.name,
+              description: example.description,
+              example: fullExample
+            };
+          }).filter(isNonNullish)
+        };
+      })
     };
   });
   const groupInfo = getFernGroups({ document: openApi, context });
@@ -871228,7 +871269,6 @@ function generateIr({ openApi, taskContext, disableExamples }) {
     schemas,
     securitySchemes,
     hasEndpointsMarkedInternal: endpoints.some((endpoint) => endpoint.internal),
-    errors: context.getErrors(),
     nonRequestReferencedSchemas: context.getReferencedSchemas(),
     variables,
     globalHeaders
@@ -871318,7 +871358,6 @@ async function parse3({ workspace, taskContext }) {
     webhooks: [],
     channel: [],
     schemas: {},
-    errors: {},
     variables: {},
     nonRequestReferencedSchemas: /* @__PURE__ */ new Set(),
     securitySchemes: {},
@@ -871390,10 +871429,6 @@ function merge3(ir1, ir2) {
       ...ir1.schemas,
       ...ir2.schemas
     },
-    errors: {
-      ...ir1.errors,
-      ...ir2.errors
-    },
     variables: {
       ...ir1.variables,
       ...ir2.variables
@@ -872211,7 +872246,7 @@ function convertToHttpMethod(httpMethod) {
 
 // pnp:/home/circleci/project/packages/cli/openapi-ir-to-fern/lib/buildEndpoint.js
 function buildEndpoint({ endpoint, declarationFile, context }) {
-  const { errors, nonRequestReferencedSchemas } = context.ir;
+  const { nonRequestReferencedSchemas } = context.ir;
   let schemaIdsToExclude = [];
   const names2 = /* @__PURE__ */ new Set();
   const pathParameters = {};
@@ -872368,18 +872403,54 @@ function buildEndpoint({ endpoint, declarationFile, context }) {
   } else if (endpoint.availability === EndpointAvailability.Deprecated) {
     convertedEndpoint.availability = "deprecated";
   }
-  endpoint.errorStatusCode.forEach((statusCode) => {
+  Object.entries(endpoint.errors).forEach(([statusCode, httpError]) => {
     var _a5;
-    const errorName = (_a5 = errors[statusCode]) == null ? void 0 : _a5.generatedName;
-    if (errorName != null) {
-      if (convertedEndpoint.errors == null) {
-        convertedEndpoint.errors = [];
+    let errorName = httpError.generatedName;
+    const fileContainingReference = RelativeFilePath.of(FERN_PACKAGE_MARKER_FILENAME);
+    if (context.builder.enableUniqueErrorsPerEndpoint) {
+      errorName = `${endpoint.generatedRequestName}${httpError.generatedName}`;
+      if (httpError.schema != null) {
+        if (httpError.schema.type !== "reference" && httpError.schema.type !== "oneOf") {
+          httpError.schema.generatedName = `${endpoint.generatedRequestName}${httpError.schema.generatedName}`;
+        } else if (httpError.schema.type === "oneOf") {
+          httpError.schema.value.generatedName = `${endpoint.generatedRequestName}${httpError.schema.value.generatedName}`;
+        }
       }
-      const prefix = context.builder.addImport({
-        file: declarationFile,
-        fileToImport: ERROR_DECLARATIONS_FILENAME
+    }
+    const errorDeclaration = {
+      "status-code": parseInt(statusCode)
+    };
+    if (httpError.schema != null) {
+      const typeReference = buildTypeReference({
+        schema: httpError.schema,
+        context,
+        fileContainingReference
+      });
+      errorDeclaration.type = getTypeFromTypeReference(typeReference);
+      errorDeclaration.docs = httpError.description;
+    }
+    context.builder.addError(ERROR_DECLARATIONS_FILENAME, {
+      name: errorName,
+      schema: errorDeclaration
+    });
+    if (convertedEndpoint.errors == null) {
+      convertedEndpoint.errors = [];
+    }
+    const prefix = context.builder.addImport({
+      file: declarationFile,
+      fileToImport: ERROR_DECLARATIONS_FILENAME
+    });
+    convertedEndpoint.errors.push(prefix != null ? `${prefix}.${errorName}` : errorName);
+    const errorTypeReference = errorDeclaration.type;
+    if (errorTypeReference != null) {
+      (_a5 = httpError.examples) == null ? void 0 : _a5.forEach((example) => {
+        const convertedExample = {
+          value: convertFullExample2(example.example),
+          name: example.name,
+          docs: example.description
+        };
+        context.builder.addTypeExample(fileContainingReference, errorTypeReference, convertedExample);
       });
-      convertedEndpoint.errors.push(prefix != null ? `${prefix}.${errorName}` : errorName);
     }
   });
   if (endpoint.examples.length > 0) {
@@ -872848,23 +872919,6 @@ function buildFernDefinition(context) {
       schema: typeDeclaration.schema
     });
   }
-  for (const [statusCode, httpError] of Object.entries(context.ir.errors)) {
-    const errorDeclaration = {
-      "status-code": parseInt(statusCode)
-    };
-    if (httpError.schema != null) {
-      const typeReference = buildTypeReference({
-        schema: httpError.schema,
-        context,
-        fileContainingReference: RelativeFilePath.of(FERN_PACKAGE_MARKER_FILENAME)
-      });
-      errorDeclaration.type = getTypeFromTypeReference(typeReference);
-    }
-    context.builder.addError(ERROR_DECLARATIONS_FILENAME, {
-      name: httpError.generatedName,
-      schema: errorDeclaration
-    });
-  }
   if (context.ir.tags.orderedTagIds != null && context.ir.tags.orderedTagIds.length > 0) {
     const containsValidTagIds = context.ir.tags.orderedTagIds.every((tagId) => {
       return sdkGroups.has(tagId);
@@ -872882,11 +872936,13 @@ function buildFernDefinition(context) {
 var import_path16 = require("path");
 var FernDefinitionBuilderImpl = class {
   modifyBasePaths;
+  enableUniqueErrorsPerEndpoint;
   rootApiFile;
   packageMarkerFile = {};
   definitionFiles = {};
-  constructor(ir, modifyBasePaths) {
+  constructor(ir, modifyBasePaths, enableUniqueErrorsPerEndpoint) {
     this.modifyBasePaths = modifyBasePaths;
+    this.enableUniqueErrorsPerEndpoint = enableUniqueErrorsPerEndpoint;
     this.rootApiFile = {
       name: "api",
       "error-discrimination": {
@@ -872991,12 +873047,40 @@ var FernDefinitionBuilderImpl = class {
     }
     fernFile.types[name2] = schema2;
   }
+  addTypeExample(file, name2, convertedExample) {
+    const fernFile = this.getOrCreateFile(file);
+    if (fernFile.types == null) {
+      fernFile.types = {};
+    }
+    const type2 = fernFile.types[name2];
+    if (type2 != null) {
+      if (typeof type2 === "string") {
+        fernFile.types[name2] = {
+          type: type2,
+          examples: [convertedExample]
+        };
+      } else {
+        if (type2.examples == null) {
+          type2.examples = [];
+        }
+        type2.examples.push(convertedExample);
+      }
+    }
+  }
   addError(file, { name: name2, schema: schema2 }) {
+    var _a5;
     const fernFile = this.getOrCreateFile(file);
     if (fernFile.errors == null) {
       fernFile.errors = {};
     }
-    fernFile.errors[name2] = schema2;
+    if (fernFile.errors[name2] == null) {
+      fernFile.errors[name2] = schema2;
+    } else if (((_a5 = fernFile.errors[name2]) == null ? void 0 : _a5.type) !== schema2.type) {
+      fernFile.errors[name2] = {
+        "status-code": schema2["status-code"],
+        type: "unknown"
+      };
+    }
   }
   addEndpoint(file, { name: name2, schema: schema2 }) {
     const fernFile = this.getOrCreateFile(file);
@@ -873175,11 +873259,11 @@ var OpenApiIrConverterContext = class {
   ir;
   builder;
   defaultServerName = void 0;
-  constructor({ taskContext, ir }) {
+  constructor({ taskContext, ir, enableUniqueErrorsPerEndpoint }) {
     this.logger = taskContext.logger;
     this.taskContext = taskContext;
     this.ir = ir;
-    this.builder = new FernDefinitionBuilderImpl(ir, false);
+    this.builder = new FernDefinitionBuilderImpl(ir, false, enableUniqueErrorsPerEndpoint);
   }
   getSchema(id) {
     const schema2 = this.ir.schemas[id];
@@ -873200,20 +873284,21 @@ var OpenApiIrConverterContext = class {
 };
 
 // pnp:/home/circleci/project/packages/cli/openapi-ir-to-fern/lib/convert.js
-function convert2({ openApiIr, taskContext }) {
-  const context = new OpenApiIrConverterContext({ taskContext, ir: openApiIr });
+function convert2(opts) {
+  const context = new OpenApiIrConverterContext(opts);
   return buildFernDefinition(context);
 }
 
 // pnp:/home/circleci/project/packages/cli/workspace-loader/lib/utils/convertOpenApiWorkspaceToFernWorkspace.js
-async function convertToFernWorkspace(openapiWorkspace, context) {
+async function convertToFernWorkspace(openapiWorkspace, context, enableUniqueErrorsPerEndpoint = false) {
   const openApiIr = await parse3({
     workspace: openapiWorkspace,
     taskContext: context
   });
   const definition2 = convert2({
     taskContext: context,
-    openApiIr
+    ir: openApiIr,
+    enableUniqueErrorsPerEndpoint
   });
   return {
     type: "fern",
@@ -877214,10 +877299,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.23.0-rc5" == null) {
+    if ("0.23.0-rc7" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.23.0-rc5";
+    return "0.23.0-rc7";
   }
   getCliName() {
     if ("fern" == null) {
@@ -922797,7 +922882,7 @@ async function generateDocsWorkspace({
     await validateDocsWorkspaceAndLogIssues({ workspace: docsWorkspace, context, logWarnings: false });
     const fernWorkspaces = await Promise.all(
       project.apiWorkspaces.map(async (workspace) => {
-        return workspace.type === "fern" ? workspace : await convertToFernWorkspace(workspace, context);
+        return workspace.type === "fern" ? workspace : await convertToFernWorkspace(workspace, context, true);
       })
     );
     await runRemoteGenerationForDocsWorkspace({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fern-api",
-  "version": "0.23.0-rc5",
+  "version": "0.23.0-rc7",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern.git",