@lokalise/api-contracts 6.13.1 → 6.15.0

package/README.md

@@ -48,49 +48,75 @@ const deleteUser = defineApiContract({
 
 ### Non-JSON responses
 
-Use `textResponse` for text-based responses (plain text, CSV, HTML, XML, YAML, etc.):
+Use `blobResponse` for any non-JSON response — text-based (plain text, CSV, HTML, XML, YAML, etc.) or binary (images, PDFs, etc.). It records the response `content-type` in the contract and hands the consumer a `Blob`, leaving the decode choice to the call site via `.text()`, `.arrayBuffer()`, or `.stream()`:
 
 ```ts
-import { defineApiContract, textResponse } from '@lokalise/api-contracts'
+import { defineApiContract, blobResponse } from '@lokalise/api-contracts'
 
 const exportCsv = defineApiContract({
   method: 'get',
   pathResolver: () => '/export.csv',
-  responsesByStatusCode: { 200: textResponse('text/csv') },
+  responsesByStatusCode: { 200: blobResponse('text/csv') },
 })
 
-const getPage = defineApiContract({
-  method: 'get',
-  pathResolver: () => '/page',
-  responsesByStatusCode: { 200: textResponse('text/html') },
-})
-
-const getDocument = defineApiContract({
+const downloadPhoto = defineApiContract({
   method: 'get',
-  pathResolver: () => '/document',
-  responsesByStatusCode: { 200: textResponse('application/xml') },
+  pathResolver: () => '/photo.png',
+  responsesByStatusCode: { 200: blobResponse('image/png') },
 })
 ```
 
-Use `blobResponse` for binary responses (images, PDFs, etc.):
+> **Deprecated:** `textResponse` is deprecated in favour of `blobResponse`. Both declare the same protocol fact (the response `content-type`); they differ only in whether the client materializes the body as `string` or `Blob` — a consumer concern, not part of the contract. Where a string is needed, call `.text()` on the returned `Blob`. `textResponse` will be removed in a future major release.
+
+### Multiple content types
+
+When a single status code can return more than one media type, map it to a `content` object keyed
+by media type. Each value is a *body descriptor*: a bare Zod schema (JSON), `blobBody()` (opaque
+binary or text), or `sseBody()` (Server-Sent Events). Add `allowNoBody: true` to also accept an
+empty body.
 
 ```ts
-import { defineApiContract, blobResponse } from '@lokalise/api-contracts'
+import { defineApiContract, blobBody, sseBody } from '@lokalise/api-contracts'
+import { z } from 'zod/v4'
 
-const downloadPhoto = defineApiContract({
+const downloadReport = defineApiContract({
   method: 'get',
-  pathResolver: () => '/photo.png',
-  responsesByStatusCode: { 200: blobResponse('image/png') },
+  pathResolver: () => '/report',
+  responsesByStatusCode: {
+    200: {
+      description: 'Report in the requested format',
+      content: {
+        'application/json':         z.object({ rows: z.array(z.string()) }),
+        'application/vnd.api+json': z.object({ data: z.object({ rows: z.array(z.string()) }) }),
+        'text/csv':                 blobBody(),
+        'application/pdf':          blobBody(),
+        'text/event-stream':        sseBody({ row: z.object({ value: z.string() }) }),
+      },
+      allowNoBody: true,
+    },
+  },
 })
 ```
 
+Media types are matched **exactly** — parameters stripped, case-insensitive — so distinct keys such
+as `application/json` and `application/vnd.api+json` never collide, and a single status code may
+expose any number of media types (including several JSON variants). The shape maps 1:1 to the
+OpenAPI Response Object. The matched media type is **not** surfaced on the client response; read it
+from `headers['content-type']` if you need to discriminate.
+
+> **Deprecated:** `anyOfResponses` is deprecated in favour of content maps. A flat list can't
+> declare multiple JSON media types, matches content-types by substring (false positives), and is
+> order-dependent — content maps fix all three. `anyOfResponses` still works and will be removed in
+> a future major release.
+
 ### SSE and dual-mode routes
 
-Use `sseResponse()` inside `responsesByStatusCode` to define SSE event schemas.
-For endpoints that can respond with either JSON or an SSE stream depending on the `Accept` header, use `anyOfResponses()` to declare both options on the same status code.
+Use `sseResponse()` inside `responsesByStatusCode` for an SSE-only response. For a route that
+returns either JSON or an SSE stream depending on the `Accept` header, use a content map (above)
+with both an `application/json` and a `text/event-stream` entry.
 
 ```ts
-import { defineApiContract, sseResponse, anyOfResponses } from '@lokalise/api-contracts'
+import { defineApiContract, sseResponse, sseBody } from '@lokalise/api-contracts'
 import { z } from 'zod/v4'
 
 // SSE-only
@@ -110,13 +136,15 @@ const chatCompletion = defineApiContract({
   pathResolver: () => '/chat/completions',
   requestBodySchema: z.object({ message: z.string() }),
   responsesByStatusCode: {
-    200: anyOfResponses([
-      sseResponse({
-        chunk: z.object({ delta: z.string() }),
-        done: z.object({ finish_reason: z.string() }),
-      }),
-      z.object({ text: z.string() }),
-    ]),
+    200: {
+      content: {
+        'application/json': z.object({ text: z.string() }),
+        'text/event-stream': sseBody({
+          chunk: z.object({ delta: z.string() }),
+          done: z.object({ finish_reason: z.string() }),
+        }),
+      },
+    },
   },
 })
 ```
@@ -172,14 +200,7 @@ The `'2xx'` range key participates in SSE detection and success/error type narro
 All response factories accept an optional `ResponseOptions` object as their last argument.
 
 ```ts
-import {
-  defineApiContract,
-  noBodyResponse,
-  textResponse,
-  blobResponse,
-  sseResponse,
-  anyOfResponses,
-} from '@lokalise/api-contracts'
+import { defineApiContract, noBodyResponse, blobBody, sseBody } from '@lokalise/api-contracts'
 import { z } from 'zod/v4'
 
 const contract = defineApiContract({
@@ -189,19 +210,22 @@ const contract = defineApiContract({
   responsesByStatusCode: {
     201: z.object({ id: z.string() }).describe('Created resource'),
     204: noBodyResponse({ description: 'Deleted — no content returned' }),
-    200: anyOfResponses(
-      [
-        z.object({ id: z.string() }).describe('JSON representation'),
-        textResponse('text/csv', { description: 'CSV export' }),
-        blobResponse('application/pdf', { description: 'PDF report' }),
-        sseResponse({ update: z.object({ id: z.string() }) }, { description: 'Live update stream' }),
-      ],
-      { description: 'Multiple response formats available' },
-    ),
+    200: {
+      description: 'Multiple response formats available',
+      content: {
+        'application/json': z.object({ id: z.string() }).describe('JSON representation'),
+        'text/csv': blobBody(),
+        'application/pdf': blobBody(),
+        'text/event-stream': sseBody({ update: z.object({ id: z.string() }) }),
+      },
+    },
   },
 })
 ```
 
+A content-map entry carries a single `description` for the whole response; per-media descriptions
+aren't supported (a JSON descriptor can still carry its own via `.describe()`).
+
 `getSseSchemaByEventName(contract)` extracts SSE event schemas from a contract:
 
 ```ts
@@ -271,7 +295,7 @@ const contract = defineApiContract({
 
 ### Type utilities
 
-**`InferNonSseSuccessResponses<T>`** — TypeScript output type of all non-SSE 2xx responses. JSON schemas → `z.output<T>`, `textResponse` → `string`, `blobResponse` → `Blob`, `ContractNoBody`/`NoBodyResponse` → `undefined`, `sseResponse` → `never` (excluded). `anyOfResponses` entries are unpacked before mapping.
+**`InferNonSseSuccessResponses<T>`** — TypeScript output type of all non-SSE 2xx responses. JSON schemas → `z.output<T>`, `textResponse` → `string`, `blobResponse` → `Blob`, `ContractNoBody`/`NoBodyResponse` → `undefined`, `sseResponse` → `never` (excluded). `anyOfResponses` and content-map entries are unpacked before mapping.
 
 ```ts
 import type { InferNonSseSuccessResponses } from '@lokalise/api-contracts'
@@ -280,7 +304,7 @@ type UserResponse = InferNonSseSuccessResponses<typeof getUser['responsesByStatu
 // { id: string; name: string }
 
 type CsvResponse = InferNonSseSuccessResponses<typeof exportCsv['responsesByStatusCode']>
-// string
+// Blob
 ```
 
 **`InferJsonSuccessResponses<T>`** — union of Zod schema types for all JSON 2xx entries. Text, Blob, SSE, and `ContractNoBody` entries are excluded.
@@ -375,7 +399,7 @@ getIsEmptyResponseExpected(deleteUser) // true
 getIsEmptyResponseExpected(getUser)    // false
 ```
 
-**`hasAnySuccessSseResponse`** — `true` when any 2xx entry (exact code or `'2xx'` range key) is an SSE response (including inside `anyOfResponses`).
+**`hasAnySuccessSseResponse`** — `true` when any 2xx entry (exact code or `'2xx'` range key) is an SSE response (including inside `anyOfResponses` or a content map).
 
 ```ts
 import { hasAnySuccessSseResponse } from '@lokalise/api-contracts'

package/dist/new/clientTypes.d.ts

@@ -50,40 +50,61 @@ type SseInferClientResponseBody<T> = Extract<InferClientResponseBody<T>, AsyncIt
  * Like InferClientResponseBody but returns only non-SSE bodies — SSE entries resolve to never.
  */
 type NonSseInferClientResponseBody<T> = Exclude<InferClientResponseBody<T>, AsyncIterable<unknown>>;
-type WildcardSseBody<V, K extends WildcardStatusCodeKey> = K extends '2xx' ? SseInferClientResponseBody<V> : InferClientResponseBody<V>;
-type WildcardNonSseBody<V, K extends WildcardStatusCodeKey> = K extends '2xx' ? NonSseInferClientResponseBody<V> : InferClientResponseBody<V>;
+type InferContentDescriptorBody<TDescriptor> = TDescriptor extends {
+    _tag: 'BlobBody';
+} ? Blob : TDescriptor extends {
+    _tag: 'SseBody';
+    schemaByEventName: infer S extends SseSchemaByEventName;
+} ? AsyncIterable<SseEventOf<S>> : TDescriptor extends z.ZodType ? InferSchemaOutput<TDescriptor> : never;
+type ContentEntryVariants<TEntry> = (TEntry extends {
+    content: infer C;
+} ? {
+    [CT in keyof C & string]: {
+        body: InferContentDescriptorBody<C[CT]>;
+    };
+}[keyof C & string] : never) | (TEntry extends {
+    allowNoBody: true;
+} ? {
+    body: null;
+} : never);
+type IsContentEntry<V> = V extends {
+    content: object;
+} ? true : V extends {
+    allowNoBody: true;
+} ? true : false;
+type SseContentVariants<TEntry> = Extract<ContentEntryVariants<TEntry>, {
+    body: AsyncIterable<unknown>;
+}>;
+type NonSseContentVariants<TEntry> = Exclude<ContentEntryVariants<TEntry>, {
+    body: AsyncIterable<unknown>;
+}>;
+/** Response mode for a given status class: success codes filter by SSE/non-SSE; others pass all. */
+type ResponseBodyMode = 'sse' | 'non-sse' | 'all';
+type ContentVariantsForMode<TEntry, TMode extends ResponseBodyMode> = TMode extends 'sse' ? SseContentVariants<TEntry> : TMode extends 'non-sse' ? NonSseContentVariants<TEntry> : ContentEntryVariants<TEntry>;
+type LegacyBodyForMode<V, TMode extends ResponseBodyMode> = TMode extends 'sse' ? SseInferClientResponseBody<V> : TMode extends 'non-sse' ? NonSseInferClientResponseBody<V> : InferClientResponseBody<V>;
+/** Attaches `statusCode` + `headers` to each `{ body }` variant. */
+type WithMeta<TStatusCode, THeaders, TVariant> = TVariant extends unknown ? Prettify<{
+    statusCode: TStatusCode;
+    headers: THeaders;
+} & TVariant> : never;
+/**
+ * Builds the response union member(s) for a status code `K` holding value `V`.
+ * Content-map entries expand to one body variant per media type; legacy entries keep the original
+ * `{ statusCode, headers, body }` shape (so existing contracts are byte-for-byte unchanged).
+ */
+type ResponseMember<TStatusCode, THeaders, V, TMode extends ResponseBodyMode> = IsContentEntry<V> extends true ? WithMeta<TStatusCode, THeaders, ContentVariantsForMode<V, TMode>> : {
+    statusCode: TStatusCode;
+    headers: THeaders;
+    body: LegacyBodyForMode<V, TMode>;
+};
 type ExactStatusCodes<TApiContract extends ApiContract> = keyof TApiContract['responsesByStatusCode'] & HttpStatusCode;
 type RangeStatusCodes<TApiContract extends ApiContract> = {
     [K in keyof TApiContract['responsesByStatusCode'] & HttpStatusCodeRange]: ExpandStatusRangeKey<K>;
 }[keyof TApiContract['responsesByStatusCode'] & HttpStatusCodeRange];
 type DefaultSuccessStatusCodes<TApiContract extends ApiContract> = Exclude<SuccessfulHttpStatusCode, ExactStatusCodes<TApiContract> | RangeStatusCodes<TApiContract>>;
 type DefaultNonSuccessStatusCodes<TApiContract extends ApiContract> = Exclude<Exclude<HttpStatusCode, SuccessfulHttpStatusCode>, ExactStatusCodes<TApiContract> | RangeStatusCodes<TApiContract>>;
-type WildcardSseEntry<TApiContract extends ApiContract, K extends WildcardStatusCodeKey> = K extends 'default' ? {
-    statusCode: DefaultSuccessStatusCodes<TApiContract>;
-    headers: InferClientResponseHeaders<TApiContract>;
-    body: SseInferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>>;
-} | {
-    statusCode: DefaultNonSuccessStatusCodes<TApiContract>;
-    headers: InferClientResponseHeaders<TApiContract>;
-    body: InferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>>;
-} : {
-    statusCode: Exclude<ExpandStatusRangeKey<K>, ExactStatusCodes<TApiContract>>;
-    headers: InferClientResponseHeaders<TApiContract>;
-    body: WildcardSseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>, K>;
-};
-type WildcardNonSseEntry<TApiContract extends ApiContract, K extends WildcardStatusCodeKey> = K extends 'default' ? {
-    statusCode: DefaultSuccessStatusCodes<TApiContract>;
-    headers: InferClientResponseHeaders<TApiContract>;
-    body: NonSseInferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>>;
-} | {
-    statusCode: DefaultNonSuccessStatusCodes<TApiContract>;
-    headers: InferClientResponseHeaders<TApiContract>;
-    body: InferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>>;
-} : {
-    statusCode: Exclude<ExpandStatusRangeKey<K>, ExactStatusCodes<TApiContract>>;
-    headers: InferClientResponseHeaders<TApiContract>;
-    body: WildcardNonSseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>, K>;
-};
+type WildcardSseEntry<TApiContract extends ApiContract, K extends WildcardStatusCodeKey> = K extends 'default' ? ResponseMember<DefaultSuccessStatusCodes<TApiContract>, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, 'sse'> | ResponseMember<DefaultNonSuccessStatusCodes<TApiContract>, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, 'all'> : ResponseMember<Exclude<ExpandStatusRangeKey<K>, ExactStatusCodes<TApiContract>>, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, K extends '2xx' ? 'sse' : 'all'>;
+type WildcardNonSseEntry<TApiContract extends ApiContract, K extends WildcardStatusCodeKey> = K extends 'default' ? ResponseMember<DefaultSuccessStatusCodes<TApiContract>, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, 'non-sse'> | ResponseMember<DefaultNonSuccessStatusCodes<TApiContract>, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, 'all'> : ResponseMember<Exclude<ExpandStatusRangeKey<K>, ExactStatusCodes<TApiContract>>, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, K extends '2xx' ? 'non-sse' : 'all'>;
 /**
  * Infers a discriminated union of `{ statusCode, headers, body }` for SSE mode:
  * - exact success status codes and `'2xx'` range → SSE body only (AsyncIterable)
@@ -96,11 +117,7 @@ type WildcardNonSseEntry<TApiContract extends ApiContract, K extends WildcardSta
  * are strongly typed; all other headers remain accessible as `string | undefined`.
  */
 export type InferSseClientResponse<TApiContract extends ApiContract> = {
-    [K in keyof TApiContract['responsesByStatusCode'] & HttpStatusCode]: {
-        statusCode: K;
-        headers: InferClientResponseHeaders<TApiContract>;
-        body: K extends SuccessfulHttpStatusCode ? SseInferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>> : InferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>>;
-    };
+    [K in keyof TApiContract['responsesByStatusCode'] & HttpStatusCode]: ResponseMember<K, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, K extends SuccessfulHttpStatusCode ? 'sse' : 'all'>;
 }[keyof TApiContract['responsesByStatusCode'] & HttpStatusCode] | {
     [K in keyof TApiContract['responsesByStatusCode'] & WildcardStatusCodeKey]: WildcardSseEntry<TApiContract, K>;
 }[keyof TApiContract['responsesByStatusCode'] & WildcardStatusCodeKey];
@@ -116,11 +133,7 @@ export type InferSseClientResponse<TApiContract extends ApiContract> = {
  * are strongly typed; all other headers remain accessible as `string | undefined`.
  */
 export type InferNonSseClientResponse<TApiContract extends ApiContract> = {
-    [K in keyof TApiContract['responsesByStatusCode'] & HttpStatusCode]: {
-        statusCode: K;
-        headers: InferClientResponseHeaders<TApiContract>;
-        body: K extends SuccessfulHttpStatusCode ? NonSseInferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>> : InferClientResponseBody<NonNullable<TApiContract['responsesByStatusCode'][K]>>;
-    };
+    [K in keyof TApiContract['responsesByStatusCode'] & HttpStatusCode]: ResponseMember<K, InferClientResponseHeaders<TApiContract>, NonNullable<TApiContract['responsesByStatusCode'][K]>, K extends SuccessfulHttpStatusCode ? 'non-sse' : 'all'>;
 }[keyof TApiContract['responsesByStatusCode'] & HttpStatusCode] | {
     [K in keyof TApiContract['responsesByStatusCode'] & WildcardStatusCodeKey]: WildcardNonSseEntry<TApiContract, K>;
 }[keyof TApiContract['responsesByStatusCode'] & WildcardStatusCodeKey];

package/dist/new/contractResponse.d.ts

@@ -9,6 +9,13 @@ export type TypedTextResponse = {
     readonly contentType: string;
     readonly description?: string;
 };
+/**
+ * @deprecated Use {@link blobResponse} instead. `textResponse` and `blobResponse` carry the
+ * identical protocol fact (the response `content-type`); they differ only in the JS type the
+ * client materializes the body into (`string` vs `Blob`). That decode choice belongs to the
+ * consumer, not the shared contract — `blobResponse` defers it to the call site via
+ * `.text()` / `.arrayBuffer()` / `.stream()`. Will be removed in a future major release.
+ */
 export declare const textResponse: (contentType: string, options?: ResponseOptions) => TypedTextResponse;
 export declare const isTextResponse: (value: ApiContractResponse) => value is TypedTextResponse;
 export type TypedBlobResponse = {
@@ -34,6 +41,13 @@ export type AnyOfResponses<T extends TypedApiContractResponse = TypedApiContract
     readonly responses: T[];
     readonly description?: string;
 };
+/**
+ * @deprecated Use a content-map response entry instead — `{ content: { <mediaType>: descriptor } }`
+ * (see {@link blobBody} / {@link sseBody}). A flat `anyOfResponses` list can't declare multiple JSON
+ * media types, matches content-types by substring (false positives), and is order-dependent;
+ * content maps match media types exactly and map 1:1 to the OpenAPI Response Object. Will be removed
+ * in a future major release.
+ */
 export declare const anyOfResponses: <T extends TypedApiContractResponse>(responses: T[], options?: ResponseOptions) => AnyOfResponses<T>;
 export declare const isAnyOfResponses: (value: ApiContractResponse) => value is AnyOfResponses;
 export type NoBodyResponse = {
@@ -43,7 +57,47 @@ export type NoBodyResponse = {
 export declare const noBodyResponse: (options?: ResponseOptions) => NoBodyResponse;
 export declare const isNoBodyResponse: (value: ApiContractResponse) => value is NoBodyResponse;
 export type ApiContractResponse = typeof ContractNoBody | NoBodyResponse | TypedApiContractResponse | AnyOfResponses;
-export type ResponsesByStatusCode = Partial<Record<HttpStatusCode | WildcardStatusCodeKey, ApiContractResponse>>;
+/** Opaque binary body; the media type is supplied by the content-map key. */
+export type BlobBody = {
+    readonly _tag: 'BlobBody';
+};
+export declare const blobBody: () => BlobBody;
+export declare const isBlobBody: (value: BodyDescriptor) => value is BlobBody;
+/** Server-Sent Events body; the media type is supplied by the content-map key. */
+export type SseBody<T extends SseSchemaByEventName = SseSchemaByEventName> = {
+    readonly _tag: 'SseBody';
+    readonly schemaByEventName: T;
+};
+export declare const sseBody: <T extends SseSchemaByEventName>(schemaByEventName: T) => SseBody<T>;
+export declare const isSseBody: (value: BodyDescriptor) => value is SseBody;
+export declare const isJsonBody: (value: BodyDescriptor) => value is z.ZodType;
+/**
+ * A value in a {@link ResponseContentMap}; the media type is the map key, so a
+ * descriptor never carries a content type itself. A bare Zod schema is JSON.
+ */
+export type BodyDescriptor = z.ZodType | BlobBody | SseBody;
+/** Maps a response media type (e.g. `application/json`) to the body it carries. */
+export type ResponseContentMap = Record<string, BodyDescriptor>;
+/** A content-map response carrying a body for one or more media types. */
+export type BodyContentResponseEntry = {
+    readonly description?: string;
+    readonly content: ResponseContentMap;
+    readonly allowNoBody?: boolean;
+};
+/** A content-map response that never carries a body. */
+export type NoBodyContentResponseEntry = {
+    readonly description?: string;
+    readonly content?: never;
+    readonly allowNoBody: true;
+};
+/**
+ * A content-map response entry. Either a body response (`content` required,
+ * optionally `allowNoBody`) or a no-body response (`allowNoBody: true`, no
+ * `content`). The union forces at least one of `content` / `allowNoBody`.
+ */
+export type ResponseEntry = BodyContentResponseEntry | NoBodyContentResponseEntry;
+export declare const isContentResponseEntry: (value: ApiContractResponse | ResponseEntry) => value is ResponseEntry;
+export type ResponsesByStatusCode = Partial<Record<HttpStatusCode | WildcardStatusCodeKey, ApiContractResponse | ResponseEntry>>;
 export type ResponseKind = {
     kind: 'noContent';
 } | {
@@ -73,7 +127,7 @@ export type ResponseKind = {
  *   returning `null` — only applies to single-entry responses; `anyOfResponses` always requires a
  *   content-type to disambiguate regardless of this flag.
  */
-export declare const resolveContractResponse: (schemaEntry: ApiContractResponse, contentType: string | undefined, strict?: boolean) => ResponseKind | null;
+export declare const resolveContractResponse: (schemaEntry: ApiContractResponse | ResponseEntry, contentType: string | undefined, strict?: boolean) => ResponseKind | null;
 /**
  * Combines status-code lookup and content-type resolution into a single call.
  * Lookup precedence: exact code → range key (e.g. `'4xx'`) → `'default'`.

package/dist/new/contractResponse.js

@@ -1,4 +1,11 @@
 import { ContractNoBody } from "./constants.js";
+/**
+ * @deprecated Use {@link blobResponse} instead. `textResponse` and `blobResponse` carry the
+ * identical protocol fact (the response `content-type`); they differ only in the JS type the
+ * client materializes the body into (`string` vs `Blob`). That decode choice belongs to the
+ * consumer, not the shared contract — `blobResponse` defers it to the call site via
+ * `.text()` / `.arrayBuffer()` / `.stream()`. Will be removed in a future major release.
+ */
 export const textResponse = (contentType, options) => ({
     _tag: 'TextResponse',
     contentType,
@@ -18,6 +25,13 @@ export const sseResponse = (schemaByEventName, options) => ({
 });
 export const isSseResponse = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'SseResponse';
 export const isJsonResponse = (value) => typeof value === 'object' && value !== null && !('_tag' in value);
+/**
+ * @deprecated Use a content-map response entry instead — `{ content: { <mediaType>: descriptor } }`
+ * (see {@link blobBody} / {@link sseBody}). A flat `anyOfResponses` list can't declare multiple JSON
+ * media types, matches content-types by substring (false positives), and is order-dependent;
+ * content maps match media types exactly and map 1:1 to the OpenAPI Response Object. Will be removed
+ * in a future major release.
+ */
 export const anyOfResponses = (responses, options) => ({
     _tag: 'AnyOfResponses',
     responses,
@@ -29,6 +43,18 @@ export const noBodyResponse = (options) => ({
     ...(options?.description !== undefined && { description: options.description }),
 });
 export const isNoBodyResponse = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'NoBodyResponse';
+export const blobBody = () => ({ _tag: 'BlobBody' });
+export const isBlobBody = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'BlobBody';
+export const sseBody = (schemaByEventName) => ({
+    _tag: 'SseBody',
+    schemaByEventName,
+});
+export const isSseBody = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'SseBody';
+export const isJsonBody = (value) => typeof value === 'object' && value !== null && !('_tag' in value);
+export const isContentResponseEntry = (value) => typeof value === 'object' &&
+    value !== null &&
+    !('_tag' in value) &&
+    ('content' in value || 'allowNoBody' in value);
 const matchTypedResponse = (entry, contentType) => {
     if (isTextResponse(entry)) {
         return contentType.includes(entry.contentType) ? { kind: 'text' } : null;
@@ -58,6 +84,60 @@ const resolveByKind = (entry) => {
     }
     return { kind: 'json', schema: entry };
 };
+const normalizeMediaType = (contentType) => (contentType.split(';')[0] ?? contentType).trim().toLowerCase();
+const descriptorToKind = (descriptor) => {
+    if (isBlobBody(descriptor)) {
+        return { kind: 'blob' };
+    }
+    if (isSseBody(descriptor)) {
+        return { kind: 'sse', schemaByEventName: descriptor.schemaByEventName };
+    }
+    return { kind: 'json', schema: descriptor };
+};
+/**
+ * Resolves a content-map {@link ResponseEntry}. Body media types are matched by exact
+ * (parameter-stripped, case-insensitive) content-type equality, so e.g. `application/json`
+ * and `application/json+01` are kept distinct.
+ */
+const resolveContentEntry = (entry, contentType, strict) => {
+    if (!entry.content) {
+        return { kind: 'noContent' };
+    }
+    const entries = Object.entries(entry.content);
+    if (!contentType) {
+        if (entry.allowNoBody) {
+            return { kind: 'noContent' };
+        }
+    }
+    else {
+        const target = normalizeMediaType(contentType);
+        for (const [mediaType, descriptor] of entries) {
+            if (normalizeMediaType(mediaType) === target) {
+                return descriptorToKind(descriptor);
+            }
+        }
+    }
+    // No content-type (without allowNoBody), or no media type matched: in non-strict mode fall
+    // back to the sole descriptor when the entry declares exactly one.
+    const onlyDescriptor = entries.length === 1 ? entries[0]?.[1] : undefined;
+    return !strict && onlyDescriptor ? descriptorToKind(onlyDescriptor) : null;
+};
+/**
+ * Resolves a legacy `anyOfResponses` entry. It always requires a content-type to disambiguate,
+ * so `strict` has no effect here.
+ */
+const resolveAnyOf = (schemaEntry, contentType) => {
+    if (!contentType) {
+        return null;
+    }
+    for (const item of schemaEntry.responses) {
+        const resolved = matchTypedResponse(item, contentType);
+        if (resolved) {
+            return resolved;
+        }
+    }
+    return null;
+};
 /**
  * Resolves a contract's response entry for a given status code into a concrete `ResponseKind`,
  * taking the response `content-type` into account.
@@ -75,21 +155,14 @@ const resolveByKind = (entry) => {
  *   content-type to disambiguate regardless of this flag.
  */
 export const resolveContractResponse = (schemaEntry, contentType, strict = true) => {
+    if (isContentResponseEntry(schemaEntry)) {
+        return resolveContentEntry(schemaEntry, contentType, strict);
+    }
     if (schemaEntry === ContractNoBody || isNoBodyResponse(schemaEntry)) {
         return { kind: 'noContent' };
     }
     if (isAnyOfResponses(schemaEntry)) {
-        // AnyOfResponses always requires content-type to disambiguate — strict mode has no effect here
-        if (!contentType) {
-            return null;
-        }
-        for (const item of schemaEntry.responses) {
-            const resolved = matchTypedResponse(item, contentType);
-            if (resolved) {
-                return resolved;
-            }
-        }
-        return null;
+        return resolveAnyOf(schemaEntry, contentType);
     }
     if (!contentType) {
         return strict ? null : resolveByKind(schemaEntry);

package/dist/new/contractResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"contractResponse.js","sourceRoot":"","sources":["../../src/new/contractResponse.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAY/C,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,WAAmB,EACnB,OAAyB,EACN,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,cAAc;IACpB,WAAW;IACX,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;CAChF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA0B,EAA8B,EAAE,CACvF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAA;AAQjG,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,WAAmB,EACnB,OAAyB,EACN,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,cAAc;IACpB,WAAW;IACX,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;CAChF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA0B,EAA8B,EAAE,CACvF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAA;AAUjG,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,iBAAoB,EACpB,OAAyB,EACJ,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,aAAa;IACnB,iBAAiB;IACjB,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;CAChF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAA0B,EAA6B,EAAE,CACrF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAA;AAIhG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA0B,EAA8B,EAAE,CACvF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAA;AAcnE,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,SAAc,EACd,OAAyB,EACN,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,gBAAgB;IACtB,SAAS;IACT,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;CAChF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA0B,EAA2B,EAAE,CACtF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAA;AAOnG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAyB,EAAkB,EAAE,CAAC,CAAC;IAC5E,IAAI,EAAE,gBAAgB;IACtB,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;CAChF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA0B,EAA2B,EAAE,CACtF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAA;AAmBnG,MAAM,kBAAkB,GAAG,CACzB,KAA+B,EAC/B,WAAmB,EACE,EAAE;IACvB,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1E,CAAC;IAED,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1E,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE;YAC7D,CAAC,CAAC,IAAI,CAAA;IACV,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IACxC,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAA+B,EAAgB,EAAE;IACtE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACzB,CAAC;IACD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACzB,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACpE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AACxC,CAAC,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,WAAgC,EAChC,WAA+B,EAC/B,MAAM,GAAG,IAAI,EACQ,EAAE;IACvB,IAAI,WAAW,KAAK,cAAc,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IAC9B,CAAC;IAED,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,+FAA+F;QAC/F,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAA;YACjB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;IACnD,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAE5D,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;AAChE,CAAC,CAAA;AAED,SAAS,WAAW,CAAC,UAAkB;IACrC,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,KAAK,CAAA;IACvD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,qBAA4C,EAC5C,UAAkB,EAClB,WAA+B,EAC/B,iBAA0B;IAE1B,MAAM,UAAU,GAAG,qBAAqB,CAAC,UAA4B,CAAC,CAAA;IACtE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,uBAAuB,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;QAClD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,uBAAuB,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,qBAAqB,CAAC,OAAO,CAAA;IAClD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,uBAAuB,CAAC,YAAY,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAA;IAC9E,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}
+{"version":3,"file":"contractResponse.js","sourceRoot":"","sources":["../../src/new/contractResponse.ts"],"names":[],"mappings":"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"}

package/dist/new/defineApiContract.js

@@ -1,7 +1,7 @@
 import { z } from 'zod/v4';
 import { SUCCESSFUL_HTTP_STATUS_CODES } from "../HttpStatusCodes.js";
 import { ContractNoBody } from "./constants.js";
-import { isAnyOfResponses, isBlobResponse, isNoBodyResponse, isSseResponse, isTextResponse, } from "./contractResponse.js";
+import { isAnyOfResponses, isBlobResponse, isContentResponseEntry, isJsonBody, isNoBodyResponse, isSseBody, isSseResponse, isTextResponse, } from "./contractResponse.js";
 export const defineApiContract = (contract) => contract;
 export const mapApiContractToPath = (routeConfig) => {
     if (!routeConfig.requestPathParamsSchema) {
@@ -16,17 +16,31 @@ export const mapApiContractToPath = (routeConfig) => {
 export const describeApiContract = (routeConfig) => {
     return `${routeConfig.method.toUpperCase()} ${mapApiContractToPath(routeConfig)}`;
 };
+/** Collects every SSE event-schema map declared by a single response entry (legacy or content-map). */
+const collectSseSchemaMaps = (value) => {
+    if (isContentResponseEntry(value)) {
+        const maps = [];
+        for (const descriptor of Object.values(value.content ?? {})) {
+            if (isSseBody(descriptor)) {
+                maps.push(descriptor.schemaByEventName);
+            }
+        }
+        return maps;
+    }
+    if (isSseResponse(value)) {
+        return [value.schemaByEventName];
+    }
+    if (isAnyOfResponses(value)) {
+        return value.responses.filter(isSseResponse).map((response) => response.schemaByEventName);
+    }
+    return [];
+};
 export const getSseSchemaByEventName = (routeConfig) => {
     const result = {};
     for (const value of Object.values(routeConfig.responsesByStatusCode)) {
-        if (isSseResponse(value)) {
-            Object.assign(result, value.schemaByEventName);
-        }
-        else if (isAnyOfResponses(value)) {
-            for (const response of value.responses) {
-                if (isSseResponse(response)) {
-                    Object.assign(result, response.schemaByEventName);
-                }
+        if (value) {
+            for (const map of collectSseSchemaMaps(value)) {
+                Object.assign(result, map);
             }
         }
     }
@@ -35,19 +49,9 @@ export const getSseSchemaByEventName = (routeConfig) => {
 export const hasAnySuccessSseResponse = (apiContract) => {
     for (const code of [...SUCCESSFUL_HTTP_STATUS_CODES, '2xx', 'default']) {
         const value = apiContract.responsesByStatusCode[code];
-        if (!value) {
-            continue;
-        }
-        if (isSseResponse(value)) {
+        if (value && collectSseSchemaMaps(value).length > 0) {
             return true;
         }
-        else if (isAnyOfResponses(value)) {
-            for (const response of value.responses) {
-                if (isSseResponse(response)) {
-                    return true;
-                }
-            }
-        }
     }
     return false;
 };
@@ -61,6 +65,21 @@ export const getSuccessResponseSchema = (routeConfig) => {
         if (!value) {
             continue;
         }
+        if (isContentResponseEntry(value)) {
+            if (!value.content) {
+                hasDirectNonJsonEntry = true;
+                continue;
+            }
+            for (const descriptor of Object.values(value.content)) {
+                if (isJsonBody(descriptor)) {
+                    schemas.push(descriptor);
+                }
+                else {
+                    hasDirectNonJsonEntry = true;
+                }
+            }
+            continue;
+        }
         if (isAnyOfResponses(value)) {
             for (const response of value.responses) {
                 if (!isSseResponse(response) && !isTextResponse(response) && !isBlobResponse(response)) {
@@ -93,7 +112,17 @@ export const getIsEmptyResponseExpected = (routeConfig) => {
     let isEmptyResponseExpected = true;
     for (const code of SUCCESSFUL_HTTP_STATUS_CODES) {
         const value = routeConfig.responsesByStatusCode[code];
-        if (value && value !== ContractNoBody && !isNoBodyResponse(value)) {
+        if (!value) {
+            continue;
+        }
+        if (isContentResponseEntry(value)) {
+            if (value.content) {
+                isEmptyResponseExpected = false;
+                break;
+            }
+            continue;
+        }
+        if (value !== ContractNoBody && !isNoBodyResponse(value)) {
             isEmptyResponseExpected = false;
             break;
         }

package/dist/new/defineApiContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineApiContract.js","sourceRoot":"","sources":["../../src/new/defineApiContract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"defineApiContract.js","sourceRoot":"","sources":["../../src/new/defineApiContract.ts"],"names":[],"mappings":"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"}

package/dist/new/inferTypes.d.ts

@@ -2,22 +2,39 @@ import type { z } from 'zod/v4';
 import type { SuccessfulHttpStatusCode } from '../HttpStatusCodes.ts';
 import type { ValueOf } from '../typeUtils.ts';
 import type { ContractNoBody } from './constants.ts';
-import type { NoBodyResponse, ResponsesByStatusCode } from './contractResponse.ts';
+import type { NoBodyResponse, ResponseEntry, ResponsesByStatusCode } from './contractResponse.ts';
 type ExtractSuccessResponses<T extends ResponsesByStatusCode> = ValueOf<T, Extract<keyof T, SuccessfulHttpStatusCode | '2xx' | 'default'>>;
+type UnpackAnyOf<T> = T extends {
+    _tag: 'AnyOfResponses';
+    responses: Array<infer Item>;
+} ? Item : T;
+type ContentDescriptorsOf<TEntry> = TEntry extends {
+    content: infer TContent;
+} ? TContent[keyof TContent] : never;
+type NormalizeContentDescriptor<TDescriptor> = TDescriptor extends {
+    _tag: 'SseBody';
+    schemaByEventName: infer S;
+} ? {
+    _tag: 'SseResponse';
+    schemaByEventName: S;
+} : TDescriptor extends {
+    _tag: 'BlobBody';
+} ? {
+    _tag: 'BlobResponse';
+} : TDescriptor;
+type FlatContentSuccessResponses<TEntry> = NormalizeContentDescriptor<ContentDescriptorsOf<TEntry>> | (TEntry extends {
+    allowNoBody: true;
+} ? typeof ContractNoBody : never);
+type FlatSuccessResponses<T extends ResponsesByStatusCode> = UnpackAnyOf<Exclude<ExtractSuccessResponses<T>, ResponseEntry>> | FlatContentSuccessResponses<Extract<ExtractSuccessResponses<T>, ResponseEntry>>;
 /**
- * Returns true if all success responses have no body
- * (ContractNoBody, noBodyResponse(), or no success status codes defined).
+ * Returns true if all success responses have no body (ContractNoBody, noBodyResponse(),
+ * a no-body content entry, or no success status codes defined).
  *
  * @deprecated No known consumers — will be removed in a future release.
  */
 export type IsNoBodySuccessResponse<T extends ResponsesByStatusCode> = [
-    ExtractSuccessResponses<T>
+    FlatSuccessResponses<T>
 ] extends [typeof ContractNoBody | NoBodyResponse | undefined] ? true : false;
-type UnpackAnyOf<T> = T extends {
-    _tag: 'AnyOfResponses';
-    responses: Array<infer Item>;
-} ? Item : T;
-type FlatSuccessResponses<T extends ResponsesByStatusCode> = UnpackAnyOf<ExtractSuccessResponses<T>>;
 type SseSchemaOf<T> = T extends {
     _tag: 'SseResponse';
     schemaByEventName: infer S;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokalise/api-contracts",
-  "version": "6.13.1",
+  "version": "6.15.0",
   "files": [
     "dist"
   ],
@@ -37,14 +37,14 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.0",
-    "@lokalise/biome-config": "^3.1.0",
-    "@lokalise/tsconfig": "^4.0.0",
     "@types/node": "^25.9.3",
     "@vitest/coverage-v8": "^4.1.9",
     "rimraf": "^6.1.2",
     "typescript": "6.0.3",
     "vitest": "^4.1.9",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "@lokalise/biome-config": "^3.1.1",
+    "@lokalise/tsconfig": "^5.0.0"
   },
   "scripts": {
     "build": "rimraf dist && tsc --project tsconfig.build.json",