Add SuccessResponseJSON, ErrorResponseJSON helpers (#1456)

.changeset/twelve-gifts-sort.md

@@ -0,0 +1,5 @@
+---
+"openapi-typescript-helpers": patch
+---
+
+Add SuccessResponseJSON, ErrorResponseJSON helpers

packages/openapi-typescript-helpers/index.d.ts

@@ -67,11 +67,16 @@ export type OperationRequestBodyContent<T> = FilterKeys<
       | undefined
   : FilterKeys<OperationRequestBodyMediaContent<T>, MediaType>;
 /** Return first 2XX response from a Response Object Map */
-export type SuccessResponse<T> = FilterKeys<FilterKeys<T, OkStatus>, "content">;
+export type SuccessResponse<T> = ResponseContent<FilterKeys<T, OkStatus>>;
 /** Return first 5XX or 4XX response (in that order) from a Response Object Map */
-export type ErrorResponse<T> = FilterKeys<
-  FilterKeys<T, ErrorStatus>,
-  "content"
+export type ErrorResponse<T> = ResponseContent<FilterKeys<T, ErrorStatus>>;
+/** Return first JSON-like 2XX response from a path + HTTP method */
+export type SuccessResponseJSON<PathMethod> = JSONLike<
+  SuccessResponse<ResponseObjectMap<PathMethod>>
+>;
+/** Return first JSON-like 5XX or 4XX response from a path + HTTP method */
+export type ErrorResponseJSON<PathMethod> = JSONLike<
+  ErrorResponse<ResponseObjectMap<PathMethod>>
 >;
 
 // Generic TS utils
@@ -82,6 +87,8 @@ export type FilterKeys<Obj, Matchers> = {
 }[keyof Obj];
 /** Return any `[string]/[string]` media type (important because openapi-fetch allows any content response, not just JSON-like) */
 export type MediaType = `${string}/${string}`;
+/** Return any media type containing "json" (works for "application/json", "application/vnd.api+json", "application/vnd.oai.openapi+json") */
+export type JSONLike<T> = FilterKeys<T, `${string}/json`>;
 /** Filter objects that have required keys */
 export type FindRequiredKeys<T, K extends keyof T> = K extends unknown
   ? undefined extends T[K]