@lokalise/api-contracts 6.8.0 → 6.9.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './apiContracts.ts';
 export * from './contractBuilder.ts';
 export * from './HttpStatusCodes.ts';
+export * from './new/clientTypes.ts';
 export * from './new/constants.ts';
 export * from './new/contractResponse.ts';
 export * from './new/defineApiContract.ts';

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./apiContracts.js";
 // Universal contract builder
 export * from "./contractBuilder.js";
 export * from "./HttpStatusCodes.js";
+export * from "./new/clientTypes.js";
 export * from "./new/constants.js";
 export * from "./new/contractResponse.js";
 export * from "./new/defineApiContract.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,6BAA6B;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,+BAA+B,CAAA;AAC7C,+BAA+B;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,oBAAoB;AACpB,cAAc,8BAA8B,CAAA;AAC5C,gBAAgB;AAChB,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,6BAA6B;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,+BAA+B,CAAA;AAC7C,+BAA+B;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,oBAAoB;AACpB,cAAc,8BAA8B,CAAA;AAC5C,gBAAgB;AAChB,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA"}

package/dist/new/clientTypes.d.ts

@@ -0,0 +1,80 @@
+import type { z } from 'zod/v4';
+import type { InferSchemaInput, InferSchemaOutput } from '../apiContracts.ts';
+import type { HttpStatusCode, SuccessfulHttpStatusCode } from '../HttpStatusCodes.ts';
+import type { Prettify } from '../typeUtils.ts';
+import type { ContractNoBody } from './constants.ts';
+import type { ResponsesByStatusCode, SseSchemaByEventName } from './contractResponse.ts';
+import type { ApiContract } from './defineApiContract.ts';
+import type { ContractResponseMode, SseEventOf } from './inferTypes.ts';
+export type HeadersParam<T> = T | (() => T) | (() => Promise<T>);
+type ExtractRequestBody<T> = T extends {
+    requestBodySchema: z.ZodType;
+} ? T['requestBodySchema'] : undefined;
+type StreamingParam<T extends ResponsesByStatusCode, TIsStreaming extends boolean> = ContractResponseMode<T> extends 'dual' ? {
+    streaming: TIsStreaming;
+} : {
+    streaming?: never;
+};
+export type DefaultStreaming<T extends ResponsesByStatusCode> = ContractResponseMode<T> extends 'sse' ? true : false;
+type RequiredWhenDefined<T, TKey extends string, TExtra = T> = [T] extends [undefined] ? {
+    [K in TKey]?: undefined;
+} : {
+    [K in TKey]: TExtra;
+};
+export type ClientRequestParams<TApiContract extends ApiContract, TIsStreaming extends boolean> = Prettify<StreamingParam<TApiContract['responsesByStatusCode'], TIsStreaming> & RequiredWhenDefined<InferSchemaInput<TApiContract['requestPathParamsSchema']>, 'pathParams'> & RequiredWhenDefined<InferSchemaInput<ExtractRequestBody<TApiContract>>, 'body'> & RequiredWhenDefined<InferSchemaInput<TApiContract['requestQuerySchema']>, 'queryParams'> & RequiredWhenDefined<InferSchemaInput<TApiContract['requestHeaderSchema']>, 'headers', HeadersParam<InferSchemaInput<TApiContract['requestHeaderSchema']>>> & {
+    pathPrefix?: string;
+}>;
+type InferClientResponseHeaders<TApiContract extends ApiContract> = TApiContract['responseHeaderSchema'] extends z.ZodType ? Omit<Record<string, string>, keyof InferSchemaOutput<TApiContract['responseHeaderSchema']>> & InferSchemaOutput<TApiContract['responseHeaderSchema']> : Record<string, string>;
+/**
+ * Maps a single responsesByStatusCode entry value to its TypeScript body type.
+ */
+type InferClientResponseBody<T> = T extends typeof ContractNoBody ? null : T extends z.ZodType ? InferSchemaOutput<T> : T extends {
+    _tag: 'TextResponse';
+} ? string : T extends {
+    _tag: 'BlobResponse';
+} ? Blob : T extends {
+    _tag: 'SseResponse';
+    schemaByEventName: infer S extends SseSchemaByEventName;
+} ? AsyncIterable<SseEventOf<S>> : T extends {
+    _tag: 'AnyOfResponses';
+    responses: Array<infer Item>;
+} ? InferClientResponseBody<Item> : never;
+/**
+ * Like InferClientResponseBody but returns only SSE bodies — non-SSE entries resolve to never.
+ */
+type SseInferClientResponseBody<T> = Extract<InferClientResponseBody<T>, AsyncIterable<unknown>>;
+/**
+ * Like InferClientResponseBody but returns only non-SSE bodies — SSE entries resolve to never.
+ */
+type NonSseInferClientResponseBody<T> = Exclude<InferClientResponseBody<T>, AsyncIterable<unknown>>;
+/**
+ * Infers a discriminated union of `{ statusCode, headers, body }` for SSE mode:
+ * - success status codes → SSE body only (AsyncIterable)
+ * - error status codes  → body as-is (all kinds)
+ *
+ * Headers are typed via `InferClientResponseHeaders`: known headers from `responseHeaderSchema`
+ * 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]>>;
+    };
+}[keyof TApiContract['responsesByStatusCode'] & HttpStatusCode];
+/**
+ * Infers a discriminated union of `{ statusCode, headers, body }` for non-SSE mode:
+ * - success status codes → non-SSE body only (JSON / text / blob / null)
+ * - error status codes  → body as-is (all kinds)
+ *
+ * Headers are typed via `InferClientResponseHeaders`: known headers from `responseHeaderSchema`
+ * 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]>>;
+    };
+}[keyof TApiContract['responsesByStatusCode'] & HttpStatusCode];
+export {};

package/dist/new/clientTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clientTypes.js.map

package/dist/new/clientTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTypes.js","sourceRoot":"","sources":["../../src/new/clientTypes.ts"],"names":[],"mappings":""}

package/dist/new/contractResponse.d.ts

@@ -43,4 +43,25 @@ export type ResponseKind = {
     kind: 'sse';
     schemaByEventName: SseSchemaByEventName;
 };
-export declare const resolveContractResponse: (schemaEntry: ApiContractResponse, contentType: string | undefined) => ResponseKind | null;
+/**
+ * Resolves a contract's response entry for a given status code into a concrete `ResponseKind`,
+ * taking the response `content-type` into account.
+ *
+ * Returns `null` when the content-type cannot be matched to any entry in the contract,
+ * indicating the response is unexpected and should be treated as an error by the caller.
+ *
+ * @param schemaEntry - The contract entry for the matched status code (`ContractNoBody`,
+ *   a Zod schema, `textResponse`, `blobResponse`, `sseResponse`, or `anyOfResponses`).
+ * @param contentType - The `content-type` header value from the actual HTTP response,
+ *   or `undefined` when the header is absent.
+ * @param strict - When `true` (default), returns `null` if the `content-type` is absent or does
+ *   not match the contract entry. When `false`, falls back to the entry's declared kind instead of
+ *   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;
+/**
+ * Combines status-code lookup and content-type resolution into a single call.
+ * Returns `null` when the status code is not in the contract or the content-type cannot be matched.
+ */
+export declare function resolveResponseEntry(responsesByStatusCode: ResponsesByStatusCode, statusCode: number, contentType: string | undefined, strictContentType: boolean): ResponseKind | null;

package/dist/new/contractResponse.js

@@ -36,14 +36,43 @@ const matchTypedResponse = (entry, contentType) => {
     }
     return null;
 };
-export const resolveContractResponse = (schemaEntry, contentType) => {
+const resolveByKind = (entry) => {
+    if (isTextResponse(entry)) {
+        return { kind: 'text' };
+    }
+    if (isBlobResponse(entry)) {
+        return { kind: 'blob' };
+    }
+    if (isSseResponse(entry)) {
+        return { kind: 'sse', schemaByEventName: entry.schemaByEventName };
+    }
+    return { kind: 'json', schema: entry };
+};
+/**
+ * Resolves a contract's response entry for a given status code into a concrete `ResponseKind`,
+ * taking the response `content-type` into account.
+ *
+ * Returns `null` when the content-type cannot be matched to any entry in the contract,
+ * indicating the response is unexpected and should be treated as an error by the caller.
+ *
+ * @param schemaEntry - The contract entry for the matched status code (`ContractNoBody`,
+ *   a Zod schema, `textResponse`, `blobResponse`, `sseResponse`, or `anyOfResponses`).
+ * @param contentType - The `content-type` header value from the actual HTTP response,
+ *   or `undefined` when the header is absent.
+ * @param strict - When `true` (default), returns `null` if the `content-type` is absent or does
+ *   not match the contract entry. When `false`, falls back to the entry's declared kind instead of
+ *   returning `null` — only applies to single-entry responses; `anyOfResponses` always requires a
+ *   content-type to disambiguate regardless of this flag.
+ */
+export const resolveContractResponse = (schemaEntry, contentType, strict = true) => {
     if (schemaEntry === ContractNoBody) {
         return { kind: 'noContent' };
     }
-    if (!contentType) {
-        return null;
-    }
     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) {
@@ -52,6 +81,21 @@ export const resolveContractResponse = (schemaEntry, contentType) => {
         }
         return null;
     }
-    return matchTypedResponse(schemaEntry, contentType);
+    if (!contentType) {
+        return strict ? null : resolveByKind(schemaEntry);
+    }
+    const matched = matchTypedResponse(schemaEntry, contentType);
+    return matched ?? (strict ? null : resolveByKind(schemaEntry));
 };
+/**
+ * Combines status-code lookup and content-type resolution into a single call.
+ * Returns `null` when the status code is not in the contract or the content-type cannot be matched.
+ */
+export function resolveResponseEntry(responsesByStatusCode, statusCode, contentType, strictContentType) {
+    const schemaEntry = responsesByStatusCode[statusCode];
+    if (!schemaEntry) {
+        return null;
+    }
+    return resolveContractResponse(schemaEntry, contentType, strictContentType);
+}
 //# sourceMappingURL=contractResponse.js.map

package/dist/new/contractResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"contractResponse.js","sourceRoot":"","sources":["../../src/new/contractResponse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contractResponse.js","sourceRoot":"","sources":["../../src/new/contractResponse.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAO/C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAqB,EAAE,CAAC,CAAC;IACvE,IAAI,EAAE,cAAc;IACpB,WAAW;CACZ,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;AAOjG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAqB,EAAE,CAAC,CAAC;IACvE,IAAI,EAAE,cAAc;IACpB,WAAW;CACZ,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;AASjG,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,iBAAoB,EACC,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,aAAa;IACnB,iBAAiB;CAClB,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;AAehG,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,SAAc,EACK,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,gBAAgB;IACtB,SAAS;CACV,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;AAanG,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,EAAE,CAAC;QACnC,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;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,qBAA4C,EAC5C,UAAkB,EAClB,WAA+B,EAC/B,iBAA0B;IAE1B,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAA4B,CAAC,CAAA;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,uBAAuB,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAA;AAC7E,CAAC"}

package/dist/new/defineApiContract.d.ts

@@ -4,12 +4,15 @@ import type { Exactly } from '../typeUtils.ts';
 import { ContractNoBody } from './constants.ts';
 import { type ResponsesByStatusCode, type SseSchemaByEventName } from './contractResponse.ts';
 export type RequestPathParamsSchema = z.ZodObject;
+export type RequestQuerySchema = z.ZodObject;
+export type RequestHeaderSchema = z.ZodObject;
+export type ResponseHeaderSchema = z.ZodObject;
 export type CommonApiContract = {
     pathResolver: RoutePathResolver<any>;
     requestPathParamsSchema?: RequestPathParamsSchema;
-    requestQuerySchema?: z.ZodType;
-    requestHeaderSchema?: z.ZodType;
-    responseHeaderSchema?: z.ZodType;
+    requestQuerySchema?: RequestQuerySchema;
+    requestHeaderSchema?: RequestHeaderSchema;
+    responseHeaderSchema?: ResponseHeaderSchema;
     responsesByStatusCode: ResponsesByStatusCode;
     metadata?: CommonRouteDefinitionMetadata;
     summary?: string;
@@ -39,6 +42,7 @@ export declare const defineApiContract: <PathParamsSchema extends RequestPathPar
 export declare const mapApiContractToPath: (routeConfig: ApiContract) => string;
 export declare const describeApiContract: (routeConfig: ApiContract) => string;
 export declare const getSseSchemaByEventName: (routeConfig: ApiContract) => SseSchemaByEventName | null;
+export declare const hasAnySuccessSseResponse: (apiContract: ApiContract) => boolean;
 export declare const getSuccessResponseSchema: (routeConfig: ApiContract) => z.ZodType | null;
 export declare const getIsEmptyResponseExpected: (routeConfig: ApiContract) => boolean;
 export {};

package/dist/new/defineApiContract.js

@@ -32,6 +32,25 @@ export const getSseSchemaByEventName = (routeConfig) => {
     }
     return Object.keys(result).length > 0 ? result : null;
 };
+export const hasAnySuccessSseResponse = (apiContract) => {
+    for (const code of SUCCESSFUL_HTTP_STATUS_CODES) {
+        const value = apiContract.responsesByStatusCode[code];
+        if (!value) {
+            continue;
+        }
+        if (isSseResponse(value)) {
+            return true;
+        }
+        else if (isAnyOfResponses(value)) {
+            for (const response of value.responses) {
+                if (isSseResponse(response)) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+};
 // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: it is acceptable
 export const getSuccessResponseSchema = (routeConfig) => {
     const schemas = [];
@@ -61,8 +80,9 @@ export const getSuccessResponseSchema = (routeConfig) => {
     if (schemas.length > 1) {
         return z.union(schemas);
     }
-    if (schemas.length === 1) {
-        return schemas[0];
+    const firstSchema = schemas.at(0);
+    if (firstSchema) {
+        return firstSchema;
     }
     return hasDirectNonJsonEntry ? z.never() : null;
 };

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

@@ -1,6 +1,6 @@
 import type { z } from 'zod/v4';
 import type { SuccessfulHttpStatusCode } from '../HttpStatusCodes.ts';
-import type { IsUnion, ValueOf } from '../typeUtils.ts';
+import type { ValueOf } from '../typeUtils.ts';
 import type { ContractNoBody } from './constants.ts';
 import type { ResponsesByStatusCode } from './contractResponse.ts';
 type ExtractSuccessResponses<T extends ResponsesByStatusCode> = ValueOf<T, Extract<keyof T, SuccessfulHttpStatusCode>>;
@@ -15,13 +15,6 @@ type UnpackAnyOf<T> = T extends {
     responses: Array<infer Item>;
 } ? Item : T;
 type FlatSuccessResponses<T extends ResponsesByStatusCode> = UnpackAnyOf<ExtractSuccessResponses<T>>;
-/**
- * Returns true if any success status code entry is TypedSseResponse,
- * or an AnyOfResponses containing a TypedSseResponse.
- */
-export type HasAnySseSuccessResponse<T extends ResponsesByStatusCode> = Extract<FlatSuccessResponses<T>, {
-    _tag: 'SseResponse';
-}> extends never ? false : true;
 type SseSchemaOf<T> = T extends {
     _tag: 'SseResponse';
     schemaByEventName: infer S;
@@ -59,18 +52,37 @@ type NonSseBodyOf<T> = T extends {
 export type InferNonSseSuccessResponses<T extends ResponsesByStatusCode> = NonSseBodyOf<FlatSuccessResponses<T>>;
 /**
  * Discriminated union of SSE events inferred from a schemaByEventName map.
- * Each event is `{ event: EventName, data: z.output<Schema> }`.
+ * Aligns with the browser MessageEvent shape.
  */
 export type SseEventOf<S> = {
     [K in keyof S]: K extends string ? {
-        event: K;
+        type: K;
         data: S[K] extends z.ZodType ? z.output<S[K]> : never;
+        lastEventId: string;
+        retry: number | undefined;
     } : never;
 }[keyof S];
 /**
- * True when the contract has both SSE and non-SSE success responses (dual-mode).
+ * Returns true if any success status code entry is TypedSseResponse,
+ * or an AnyOfResponses containing a TypedSseResponse.
+ */
+export type HasAnySseSuccessResponse<T extends ResponsesByStatusCode> = Extract<FlatSuccessResponses<T>, {
+    _tag: 'SseResponse';
+}> extends never ? false : true;
+/**
+ * Returns true if any success status code entry has a non-SSE response
+ * (JSON, text, blob, or no-body). Mirrors HasAnySseSuccessResponse.
+ */
+export type HasAnyNonSseSuccessResponse<T extends ResponsesByStatusCode> = Exclude<FlatSuccessResponses<T>, {
+    _tag: 'SseResponse';
+}> extends never ? false : true;
+/**
+ * Classifies a contract's response mode into one of three cases:
+ * - 'dual'    — SSE + non-SSE success responses; caller chooses via streaming param
+ * - 'sse'     — SSE-only success responses; always streams
+ * - 'non-sse' — JSON / text / blob / no-body; never streams
  */
-export type IsDualModeSse<T extends ResponsesByStatusCode> = HasAnySseSuccessResponse<T> extends true ? IsUnion<AvailableResponseModes<T>> extends true ? true : false : false;
+export type ContractResponseMode<T extends ResponsesByStatusCode> = HasAnySseSuccessResponse<T> extends true ? HasAnyNonSseSuccessResponse<T> extends true ? 'dual' : 'sse' : 'non-sse';
 /**
  * Union of response mode literals available for a given responsesByStatusCode map.
  */

package/dist/typeUtils.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Flattens an intersection type into a single object type, making hover tooltips
+ * show the fully-resolved shape instead of `A & B & C`.
+ */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
 /**
  * Returns true when T is a union with more than one member.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lokalise/api-contracts",
-    "version": "6.8.0",
+    "version": "6.9.0",
     "files": [
         "dist"
     ],