@lokalise/api-contracts 6.7.0 → 6.8.0

package/dist/HttpStatusCodes.d.ts

@@ -1 +1,3 @@
 export type HttpStatusCode = 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+export declare const SUCCESSFUL_HTTP_STATUS_CODES: readonly [200, 201, 202, 203, 204, 205, 206, 207, 208, 226];
+export type SuccessfulHttpStatusCode = (typeof SUCCESSFUL_HTTP_STATUS_CODES)[number];

package/dist/HttpStatusCodes.js

@@ -1,2 +1,4 @@
-export {};
+export const SUCCESSFUL_HTTP_STATUS_CODES = [
+    200, 201, 202, 203, 204, 205, 206, 207, 208, 226,
+];
 //# sourceMappingURL=HttpStatusCodes.js.map

package/dist/HttpStatusCodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpStatusCodes.js","sourceRoot":"","sources":["../src/HttpStatusCodes.ts"],"names":[],"mappings":""}
+{"version":3,"file":"HttpStatusCodes.js","sourceRoot":"","sources":["../src/HttpStatusCodes.ts"],"names":[],"mappings":"AAiEA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CACxC,CAAA"}

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 export * from './apiContracts.ts';
 export * from './contractBuilder.ts';
 export * from './HttpStatusCodes.ts';
+export * from './new/constants.ts';
+export * from './new/contractResponse.ts';
+export * from './new/defineApiContract.ts';
+export * from './new/inferTypes.ts';
 export * from './pathUtils.ts';
 export * from './rest/restContractBuilder.ts';
 export * from './sse/dualModeContracts.ts';

package/dist/index.js

@@ -2,6 +2,10 @@ export * from "./apiContracts.js";
 // Universal contract builder
 export * from "./contractBuilder.js";
 export * from "./HttpStatusCodes.js";
+export * from "./new/constants.js";
+export * from "./new/contractResponse.js";
+export * from "./new/defineApiContract.js";
+export * from "./new/inferTypes.js";
 export * from "./pathUtils.js";
 export * from "./rest/restContractBuilder.js";
 // Dual-mode (hybrid) contracts

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,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,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/constants.d.ts

@@ -0,0 +1 @@
+export declare const ContractNoBody: unique symbol;

package/dist/new/constants.js

@@ -0,0 +1,2 @@
+export const ContractNoBody = Symbol.for('ContractNoBody');
+//# sourceMappingURL=constants.js.map

package/dist/new/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/new/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA"}

package/dist/new/contractResponse.d.ts

@@ -0,0 +1,46 @@
+import type { z } from 'zod/v4';
+import type { HttpStatusCode } from '../HttpStatusCodes.ts';
+import { ContractNoBody } from './constants.ts';
+export type TypedTextResponse = {
+    readonly _tag: 'TextResponse';
+    readonly contentType: string;
+};
+export declare const textResponse: (contentType: string) => TypedTextResponse;
+export declare const isTextResponse: (value: ApiContractResponse) => value is TypedTextResponse;
+export type TypedBlobResponse = {
+    readonly _tag: 'BlobResponse';
+    readonly contentType: string;
+};
+export declare const blobResponse: (contentType: string) => TypedBlobResponse;
+export declare const isBlobResponse: (value: ApiContractResponse) => value is TypedBlobResponse;
+export type SseSchemaByEventName = Record<string, z.ZodType>;
+export type TypedSseResponse<T extends SseSchemaByEventName = SseSchemaByEventName> = {
+    readonly _tag: 'SseResponse';
+    readonly schemaByEventName: T;
+};
+export declare const sseResponse: <T extends SseSchemaByEventName>(schemaByEventName: T) => TypedSseResponse<T>;
+export declare const isSseResponse: (value: ApiContractResponse) => value is TypedSseResponse;
+export type TypedJsonResponse = z.ZodType;
+export type TypedApiContractResponse = TypedJsonResponse | TypedTextResponse | TypedBlobResponse | TypedSseResponse;
+export type AnyOfResponses<T extends TypedApiContractResponse = TypedApiContractResponse> = {
+    readonly _tag: 'AnyOfResponses';
+    readonly responses: T[];
+};
+export declare const anyOfResponses: <T extends TypedApiContractResponse>(responses: T[]) => AnyOfResponses<T>;
+export declare const isAnyOfResponses: (value: ApiContractResponse) => value is AnyOfResponses;
+export type ApiContractResponse = typeof ContractNoBody | TypedApiContractResponse | AnyOfResponses;
+export type ResponsesByStatusCode = Partial<Record<HttpStatusCode, ApiContractResponse>>;
+export type ResponseKind = {
+    kind: 'noContent';
+} | {
+    kind: 'text';
+} | {
+    kind: 'blob';
+} | {
+    kind: 'json';
+    schema: z.ZodType;
+} | {
+    kind: 'sse';
+    schemaByEventName: SseSchemaByEventName;
+};
+export declare const resolveContractResponse: (schemaEntry: ApiContractResponse, contentType: string | undefined) => ResponseKind | null;

package/dist/new/contractResponse.js

@@ -0,0 +1,57 @@
+import { ContractNoBody } from "./constants.js";
+export const textResponse = (contentType) => ({
+    _tag: 'TextResponse',
+    contentType,
+});
+export const isTextResponse = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'TextResponse';
+export const blobResponse = (contentType) => ({
+    _tag: 'BlobResponse',
+    contentType,
+});
+export const isBlobResponse = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'BlobResponse';
+export const sseResponse = (schemaByEventName) => ({
+    _tag: 'SseResponse',
+    schemaByEventName,
+});
+export const isSseResponse = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'SseResponse';
+export const anyOfResponses = (responses) => ({
+    _tag: 'AnyOfResponses',
+    responses,
+});
+export const isAnyOfResponses = (value) => typeof value === 'object' && value !== null && '_tag' in value && value._tag === 'AnyOfResponses';
+const matchTypedResponse = (entry, contentType) => {
+    if (isTextResponse(entry)) {
+        return contentType.includes(entry.contentType) ? { kind: 'text' } : null;
+    }
+    if (isBlobResponse(entry)) {
+        return contentType.includes(entry.contentType) ? { kind: 'blob' } : null;
+    }
+    if (isSseResponse(entry)) {
+        return contentType.includes('text/event-stream')
+            ? { kind: 'sse', schemaByEventName: entry.schemaByEventName }
+            : null;
+    }
+    if (contentType.includes('application/json')) {
+        return { kind: 'json', schema: entry };
+    }
+    return null;
+};
+export const resolveContractResponse = (schemaEntry, contentType) => {
+    if (schemaEntry === ContractNoBody) {
+        return { kind: 'noContent' };
+    }
+    if (!contentType) {
+        return null;
+    }
+    if (isAnyOfResponses(schemaEntry)) {
+        for (const item of schemaEntry.responses) {
+            const resolved = matchTypedResponse(item, contentType);
+            if (resolved) {
+                return resolved;
+            }
+        }
+        return null;
+    }
+    return matchTypedResponse(schemaEntry, contentType);
+};
+//# sourceMappingURL=contractResponse.js.map

package/dist/new/contractResponse.js.map

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

package/dist/new/defineApiContract.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod/v4';
+import type { CommonRouteDefinitionMetadata, InferSchemaOutput, RoutePathResolver } from '../apiContracts.ts';
+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 CommonApiContract = {
+    pathResolver: RoutePathResolver<any>;
+    requestPathParamsSchema?: RequestPathParamsSchema;
+    requestQuerySchema?: z.ZodType;
+    requestHeaderSchema?: z.ZodType;
+    responseHeaderSchema?: z.ZodType;
+    responsesByStatusCode: ResponsesByStatusCode;
+    metadata?: CommonRouteDefinitionMetadata;
+    summary?: string;
+    description?: string;
+    tags?: readonly string[];
+};
+export type GetApiContract = CommonApiContract & {
+    method: 'get';
+    requestBodySchema?: never;
+};
+export type DeleteApiContract = CommonApiContract & {
+    method: 'delete';
+    requestBodySchema?: never;
+};
+export type PayloadApiContract = CommonApiContract & {
+    method: 'post' | 'put' | 'patch';
+    requestBodySchema: typeof ContractNoBody | z.ZodType;
+};
+export type ApiContract = GetApiContract | DeleteApiContract | PayloadApiContract;
+type TypedPathApiContract<T extends RequestPathParamsSchema> = Omit<ApiContract, 'pathResolver' | 'requestPathParamsSchema'> & {
+    pathResolver: RoutePathResolver<InferSchemaOutput<T>>;
+    requestPathParamsSchema?: T;
+};
+export declare const defineApiContract: <PathParamsSchema extends RequestPathParamsSchema, const Contract extends TypedPathApiContract<PathParamsSchema>>(contract: Exactly<Contract, TypedPathApiContract<PathParamsSchema>> & {
+    requestPathParamsSchema?: PathParamsSchema;
+}) => Contract;
+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 getSuccessResponseSchema: (routeConfig: ApiContract) => z.ZodType | null;
+export declare const getIsEmptyResponseExpected: (routeConfig: ApiContract) => boolean;
+export {};

package/dist/new/defineApiContract.js

@@ -0,0 +1,80 @@
+import { z } from 'zod/v4';
+import { SUCCESSFUL_HTTP_STATUS_CODES } from "../HttpStatusCodes.js";
+import { ContractNoBody } from "./constants.js";
+import { isAnyOfResponses, isBlobResponse, isSseResponse, isTextResponse, } from "./contractResponse.js";
+export const defineApiContract = (contract) => contract;
+export const mapApiContractToPath = (routeConfig) => {
+    if (!routeConfig.requestPathParamsSchema) {
+        return routeConfig.pathResolver(undefined);
+    }
+    const resolverParams = Object.keys(routeConfig.requestPathParamsSchema.shape).reduce((acc, key) => {
+        acc[key] = `:${key}`;
+        return acc;
+    }, {});
+    return routeConfig.pathResolver(resolverParams);
+};
+export const describeApiContract = (routeConfig) => {
+    return `${routeConfig.method.toUpperCase()} ${mapApiContractToPath(routeConfig)}`;
+};
+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);
+                }
+            }
+        }
+    }
+    return Object.keys(result).length > 0 ? result : null;
+};
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: it is acceptable
+export const getSuccessResponseSchema = (routeConfig) => {
+    const schemas = [];
+    let hasDirectNonJsonEntry = false;
+    for (const code of SUCCESSFUL_HTTP_STATUS_CODES) {
+        const value = routeConfig.responsesByStatusCode[code];
+        if (!value) {
+            continue;
+        }
+        if (isAnyOfResponses(value)) {
+            for (const response of value.responses) {
+                if (!isSseResponse(response) && !isTextResponse(response) && !isBlobResponse(response)) {
+                    schemas.push(response);
+                }
+            }
+        }
+        else if (value === ContractNoBody ||
+            isSseResponse(value) ||
+            isTextResponse(value) ||
+            isBlobResponse(value)) {
+            hasDirectNonJsonEntry = true;
+        }
+        else {
+            schemas.push(value);
+        }
+    }
+    if (schemas.length > 1) {
+        return z.union(schemas);
+    }
+    if (schemas.length === 1) {
+        return schemas[0];
+    }
+    return hasDirectNonJsonEntry ? z.never() : null;
+};
+export const getIsEmptyResponseExpected = (routeConfig) => {
+    let isEmptyResponseExpected = true;
+    for (const code of SUCCESSFUL_HTTP_STATUS_CODES) {
+        const value = routeConfig.responsesByStatusCode[code];
+        if (value && value !== ContractNoBody) {
+            isEmptyResponseExpected = false;
+            break;
+        }
+    }
+    return isEmptyResponseExpected;
+};
+//# sourceMappingURL=defineApiContract.js.map

package/dist/new/defineApiContract.js.map

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

package/dist/new/inferTypes.d.ts

@@ -0,0 +1,82 @@
+import type { z } from 'zod/v4';
+import type { SuccessfulHttpStatusCode } from '../HttpStatusCodes.ts';
+import type { IsUnion, 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>>;
+/**
+ * Returns true if all success responses have no body (ContractNoBody or no success status codes defined).
+ */
+export type IsNoBodySuccessResponse<T extends ResponsesByStatusCode> = [
+    ExtractSuccessResponses<T>
+] extends [typeof ContractNoBody | undefined] ? true : false;
+type UnpackAnyOf<T> = T extends {
+    _tag: 'AnyOfResponses';
+    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;
+} ? S : never;
+/**
+ * Extracts the merged SSE event schema map from a responsesByStatusCode map.
+ * Returns the union of all `schemaByEventName` objects from TypedSseResponse entries,
+ * including those nested inside AnyOfResponses.
+ */
+export type InferSseSuccessResponses<T extends ResponsesByStatusCode> = SseSchemaOf<FlatSuccessResponses<T>>;
+/**
+ * Returns true if any success status code entry is a JSON Zod schema,
+ * or an AnyOfResponses containing one.
+ */
+export type HasAnyJsonSuccessResponse<T extends ResponsesByStatusCode> = Extract<FlatSuccessResponses<T>, z.ZodType> extends never ? false : true;
+type JsonSchemaOf<T> = T extends z.ZodType ? T : never;
+/**
+ * Extracts the union of JSON Zod schemas from all success responses,
+ * including those nested inside AnyOfResponses. Text, Blob, and SSE responses are excluded.
+ */
+export type InferJsonSuccessResponses<T extends ResponsesByStatusCode> = JsonSchemaOf<FlatSuccessResponses<T>>;
+type NonSseBodyOf<T> = T extends {
+    _tag: 'SseResponse';
+} ? never : T extends {
+    _tag: 'BlobResponse';
+} ? Blob : T extends {
+    _tag: 'TextResponse';
+} ? string : T extends z.ZodType ? z.output<T> : undefined;
+/**
+ * Infers the TypeScript output type of all non-SSE success responses.
+ * JSON schemas → z.output<T>. TextResponse → string. BlobResponse → Blob.
+ * ContractNoBody → undefined. SseResponse → never (excluded).
+ * AnyOfResponses are unpacked before mapping.
+ */
+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> }`.
+ */
+export type SseEventOf<S> = {
+    [K in keyof S]: K extends string ? {
+        event: K;
+        data: S[K] extends z.ZodType ? z.output<S[K]> : never;
+    } : never;
+}[keyof S];
+/**
+ * True when the contract has both SSE and non-SSE success responses (dual-mode).
+ */
+export type IsDualModeSse<T extends ResponsesByStatusCode> = HasAnySseSuccessResponse<T> extends true ? IsUnion<AvailableResponseModes<T>> extends true ? true : false : false;
+/**
+ * Union of response mode literals available for a given responsesByStatusCode map.
+ */
+export type AvailableResponseModes<T extends ResponsesByStatusCode> = (HasAnyJsonSuccessResponse<T> extends true ? 'json' : never) | (HasAnySseSuccessResponse<T> extends true ? 'sse' : never) | (Extract<FlatSuccessResponses<T>, {
+    _tag: 'BlobResponse';
+}> extends never ? never : 'blob') | (Extract<FlatSuccessResponses<T>, {
+    _tag: 'TextResponse';
+}> extends never ? never : 'text') | (Extract<FlatSuccessResponses<T>, typeof ContractNoBody> extends never ? never : 'noContent');
+export {};

package/dist/new/inferTypes.js

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

package/dist/new/inferTypes.js.map

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

package/dist/typeUtils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns true when T is a union with more than one member.
+ */
+export type IsUnion<T, U = T> = (T extends unknown ? ([U] extends [T] ? 0 : 1) : never) extends 0 ? false : true;
+/**
+ * Helper to prevent extra keys. If T has keys not in U, it forces an error.
+ */
+export type Exactly<T, U> = T & {
+    [K in keyof T]: K extends keyof U ? T[K] : never;
+};
+/**
+ * Extracts a union of value types from an object type.
+ * Optionally constrained to a subset of keys via ValueType.
+ */
+export type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];

package/dist/typeUtils.js

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

package/dist/typeUtils.js.map

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

package/package.json

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