@lokalise/api-contracts 6.5.2 → 6.6.0

package/README.md

@@ -12,8 +12,8 @@ type-safe way).
 
 Use `buildContract` as a single entry point for creating any type of API contract. It automatically delegates to the appropriate specialized builder based on the configuration:
 
-| `sseEvents` | Contract Type |
-|-------------|---------------|
+| `serverSentEventSchemas` | Contract Type |
+|--------------------------|---------------|
 | ❌ | REST contract (GET, POST, PUT, PATCH, DELETE) |
 | ✅ | SSE or Dual-mode contract |
 
@@ -44,11 +44,9 @@ const deleteUser = buildContract({
 
 // SSE-only streaming endpoint
 const notifications = buildContract({
+    method: 'get',
     pathResolver: () => '/api/notifications/stream',
-    params: z.object({}),
-    query: z.object({}),
-    requestHeaders: z.object({}),
-    sseEvents: {
+    serverSentEventSchemas: {
         notification: z.object({ id: z.string(), message: z.string() }),
     },
 })
@@ -57,12 +55,9 @@ const notifications = buildContract({
 const chatCompletion = buildContract({
     method: 'post',
     pathResolver: () => '/api/chat/completions',
-    params: z.object({}),
-    query: z.object({}),
-    requestHeaders: z.object({}),
-    requestBody: z.object({ message: z.string() }),
-    syncResponseBody: z.object({ reply: z.string() }),
-    sseEvents: {
+    requestBodySchema: z.object({ message: z.string() }),
+    successResponseBodySchema: z.object({ reply: z.string() }),
+    serverSentEventSchemas: {
         chunk: z.object({ delta: z.string() }),
         done: z.object({ usage: z.object({ tokens: z.number() }) }),
     },
@@ -302,12 +297,12 @@ import { buildSseContract } from '@lokalise/api-contracts'
 import { z } from 'zod'
 
 // GET SSE endpoint for live notifications
+// requestPathParamsSchema, requestQuerySchema, requestHeaderSchema are optional
 const notificationsStream = buildSseContract({
+    method: 'get',
     pathResolver: () => '/api/notifications/stream',
-    params: z.object({}),
-    query: z.object({ userId: z.string().optional() }),
-    requestHeaders: z.object({}),
-    sseEvents: {
+    requestQuerySchema: z.object({ userId: z.string().optional() }),
+    serverSentEventSchemas: {
         notification: z.object({ id: z.string(), message: z.string() }),
     },
 })
@@ -317,11 +312,8 @@ const notificationsStream = buildSseContract({
 const processStream = buildSseContract({
     method: 'post',
     pathResolver: () => '/api/process/stream',
-    params: z.object({}),
-    query: z.object({}),
-    requestHeaders: z.object({}),
-    requestBody: z.object({ fileId: z.string() }),
-    sseEvents: {
+    requestBodySchema: z.object({ fileId: z.string() }),
+    serverSentEventSchemas: {
         progress: z.object({ percent: z.number() }),
         done: z.object({ result: z.string() }),
     },
@@ -330,15 +322,15 @@ const processStream = buildSseContract({
 
 // SSE endpoint with error schemas (for errors before streaming starts)
 const channelStream = buildSseContract({
+    method: 'get',
     pathResolver: (params) => `/api/channels/${params.channelId}/stream`,
-    params: z.object({ channelId: z.string() }),
-    query: z.object({}),
-    requestHeaders: z.object({ authorization: z.string() }),
-    sseEvents: {
+    requestPathParamsSchema: z.object({ channelId: z.string() }),
+    requestHeaderSchema: z.object({ authorization: z.string() }),
+    serverSentEventSchemas: {
         message: z.object({ text: z.string() }),
     },
     // Errors returned before streaming begins
-    responseSchemasByStatusCode: {
+    responseBodySchemasByStatusCode: {
         401: z.object({ error: z.literal('Unauthorized') }),
         404: z.object({ error: z.literal('Channel not found') }),
     },
@@ -363,16 +355,13 @@ import { z } from 'zod'
 const chatCompletion = buildSseContract({
     method: 'post',
     pathResolver: () => '/api/chat/completions',
-    params: z.object({}),
-    query: z.object({}),
-    requestHeaders: z.object({}),
-    requestBody: z.object({ message: z.string() }),
-    // Adding syncResponseBody makes it dual-mode
-    syncResponseBody: z.object({
+    requestBodySchema: z.object({ message: z.string() }),
+    // Adding successResponseBodySchema makes it dual-mode
+    successResponseBodySchema: z.object({
         reply: z.string(),
         usage: z.object({ tokens: z.number() }),
     }),
-    sseEvents: {
+    serverSentEventSchemas: {
         chunk: z.object({ delta: z.string() }),
         done: z.object({ usage: z.object({ totalTokens: z.number() }) }),
     },
@@ -381,15 +370,15 @@ const chatCompletion = buildSseContract({
 
 // GET dual-mode endpoint for job status (poll or stream)
 const jobStatus = buildSseContract({
+    method: 'get',
     pathResolver: (params) => `/api/jobs/${params.jobId}/status`,
-    params: z.object({ jobId: z.string().uuid() }),
-    query: z.object({ verbose: z.string().optional() }),
-    requestHeaders: z.object({}),
-    syncResponseBody: z.object({
+    requestPathParamsSchema: z.object({ jobId: z.string().uuid() }),
+    requestQuerySchema: z.object({ verbose: z.string().optional() }),
+    successResponseBodySchema: z.object({
         status: z.enum(['pending', 'running', 'completed', 'failed']),
         progress: z.number(),
     }),
-    sseEvents: {
+    serverSentEventSchemas: {
         progress: z.object({ percent: z.number() }),
         done: z.object({ result: z.string() }),
     },
@@ -399,21 +388,19 @@ const jobStatus = buildSseContract({
 
 ### Response Schemas by Status Code
 
-Both SSE-only and dual-mode contracts support `responseSchemasByStatusCode` for defining different response shapes for errors that occur **before streaming starts** (e.g., authentication failures, validation errors, resource not found):
+Both SSE-only and dual-mode contracts support `responseBodySchemasByStatusCode` for defining different response shapes for errors that occur **before streaming starts** (e.g., authentication failures, validation errors, resource not found):
 
 ```ts
 const chatCompletion = buildSseContract({
     method: 'post',
     pathResolver: () => '/api/chat/completions',
-    params: z.object({}),
-    query: z.object({}),
-    requestHeaders: z.object({ authorization: z.string() }),
-    requestBody: z.object({ message: z.string() }),
-    syncResponseBody: z.object({ reply: z.string() }),
-    sseEvents: {
+    requestHeaderSchema: z.object({ authorization: z.string() }),
+    requestBodySchema: z.object({ message: z.string() }),
+    successResponseBodySchema: z.object({ reply: z.string() }),
+    serverSentEventSchemas: {
         chunk: z.object({ delta: z.string() }),
     },
-    responseSchemasByStatusCode: {
+    responseBodySchemasByStatusCode: {
         400: z.object({ error: z.string(), details: z.array(z.string()) }),
         401: z.object({ error: z.literal('Unauthorized') }),
         429: z.object({ error: z.string(), retryAfter: z.number() }),
@@ -423,10 +410,10 @@ const chatCompletion = buildSseContract({
 
 ### Contract Type Detection
 
-`buildSseContract` automatically determines the contract type based on the presence of `syncResponseBody`:
+`buildSseContract` automatically determines the contract type based on the presence of `successResponseBodySchema`:
 
-| `syncResponseBody` | `requestBody` | Result |
-|-------------------|---------------|--------|
+| `successResponseBodySchema` | `requestBodySchema` | Result |
+|----------------------------|---------------------|--------|
 | ❌ | ❌ | SSE-only GET |
 | ❌ | ✅ | SSE-only POST/PUT/PATCH |
 | ✅ | ❌ | Dual-mode GET |

package/dist/sse/dualModeContracts.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod/v4';
-import type { RoutePathResolver } from '../apiContracts.ts';
+import type { CommonRouteDefinitionMetadata, RoutePathResolver } from '../apiContracts.ts';
 import type { HttpStatusCode } from '../HttpStatusCodes.ts';
 import type { SSEMethod } from './sseContracts.ts';
 import type { SSEEventSchemas } from './sseTypes.ts';
@@ -20,9 +20,9 @@ import type { SSEEventSchemas } from './sseTypes.ts';
 export type DualModeContractDefinition<Method extends SSEMethod = SSEMethod, Params extends z.ZodTypeAny = z.ZodTypeAny, Query extends z.ZodTypeAny = z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny = z.ZodTypeAny, Body extends z.ZodTypeAny | undefined = undefined, SyncResponse extends z.ZodTypeAny = z.ZodTypeAny, Events extends SSEEventSchemas = SSEEventSchemas, ResponseHeaders extends z.ZodTypeAny | undefined = undefined, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined> = {
     method: Method;
     pathResolver: RoutePathResolver<z.infer<Params>>;
-    requestPathParamsSchema: Params;
-    requestQuerySchema: Query;
-    requestHeaderSchema: RequestHeaders;
+    requestPathParamsSchema?: Params;
+    requestQuerySchema?: Query;
+    requestHeaderSchema?: RequestHeaders;
     requestBodySchema: Body;
     /** Sync response schema - use with `sync` handler */
     successResponseBodySchema: SyncResponse;
@@ -42,6 +42,10 @@ export type DualModeContractDefinition<Method extends SSEMethod = SSEMethod, Par
     responseBodySchemasByStatusCode?: ResponseSchemasByStatusCode;
     serverSentEventSchemas: Events;
     isDualMode: true;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };
 /**
  * Type representing any dual-mode route definition (for use in generic constraints).
@@ -50,9 +54,9 @@ export type DualModeContractDefinition<Method extends SSEMethod = SSEMethod, Par
 export type AnyDualModeContractDefinition = {
     method: SSEMethod;
     pathResolver: RoutePathResolver<any>;
-    requestPathParamsSchema: z.ZodTypeAny;
-    requestQuerySchema: z.ZodTypeAny;
-    requestHeaderSchema: z.ZodTypeAny;
+    requestPathParamsSchema?: z.ZodTypeAny;
+    requestQuerySchema?: z.ZodTypeAny;
+    requestHeaderSchema?: z.ZodTypeAny;
     requestBodySchema: z.ZodTypeAny | undefined;
     /** Sync response schema - use with `sync` handler */
     successResponseBodySchema: z.ZodTypeAny;
@@ -60,4 +64,8 @@ export type AnyDualModeContractDefinition = {
     responseBodySchemasByStatusCode?: Partial<Record<HttpStatusCode, z.ZodTypeAny>>;
     serverSentEventSchemas: SSEEventSchemas;
     isDualMode: true;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };

package/dist/sse/sseContractBuilders.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod/v4';
-import type { RoutePathResolver } from '../apiContracts.ts';
+import type { CommonRouteDefinitionMetadata, RoutePathResolver } from '../apiContracts.ts';
 import type { HttpStatusCode } from '../HttpStatusCodes.ts';
 import type { DualModeContractDefinition } from './dualModeContracts.ts';
 import type { SSEContractDefinition } from './sseContracts.ts';
@@ -11,9 +11,9 @@ import type { SSEEventSchemas } from './sseTypes.ts';
 export type SSEGetContractConfig<Params extends z.ZodTypeAny, Query extends z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny, Events extends SSEEventSchemas, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined> = {
     method: 'get';
     pathResolver: RoutePathResolver<z.infer<Params>>;
-    requestPathParamsSchema: Params;
-    requestQuerySchema: Query;
-    requestHeaderSchema: RequestHeaders;
+    requestPathParamsSchema?: Params;
+    requestQuerySchema?: Query;
+    requestHeaderSchema?: RequestHeaders;
     serverSentEventSchemas: Events;
     /**
      * Error response schemas by HTTP status code.
@@ -31,6 +31,10 @@ export type SSEGetContractConfig<Params extends z.ZodTypeAny, Query extends z.Zo
     responseBodySchemasByStatusCode?: ResponseSchemasByStatusCode;
     requestBodySchema?: never;
     successResponseBodySchema?: never;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };
 /**
  * Configuration for building a POST/PUT/PATCH SSE route with request body.
@@ -39,9 +43,9 @@ export type SSEGetContractConfig<Params extends z.ZodTypeAny, Query extends z.Zo
 export type SSEPayloadContractConfig<Params extends z.ZodTypeAny, Query extends z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny, Body extends z.ZodTypeAny, Events extends SSEEventSchemas, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined> = {
     method: 'post' | 'put' | 'patch';
     pathResolver: RoutePathResolver<z.infer<Params>>;
-    requestPathParamsSchema: Params;
-    requestQuerySchema: Query;
-    requestHeaderSchema: RequestHeaders;
+    requestPathParamsSchema?: Params;
+    requestQuerySchema?: Query;
+    requestHeaderSchema?: RequestHeaders;
     requestBodySchema: Body;
     serverSentEventSchemas: Events;
     /**
@@ -59,6 +63,10 @@ export type SSEPayloadContractConfig<Params extends z.ZodTypeAny, Query extends
      */
     responseBodySchemasByStatusCode?: ResponseSchemasByStatusCode;
     successResponseBodySchema?: never;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };
 /**
  * Configuration for building a GET dual-mode route.
@@ -67,9 +75,9 @@ export type SSEPayloadContractConfig<Params extends z.ZodTypeAny, Query extends
 export type DualModeGetContractConfig<Params extends z.ZodTypeAny, Query extends z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny, JsonResponse extends z.ZodTypeAny, Events extends SSEEventSchemas, ResponseHeaders extends z.ZodTypeAny | undefined = undefined, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined> = {
     method: 'get';
     pathResolver: RoutePathResolver<z.infer<Params>>;
-    requestPathParamsSchema: Params;
-    requestQuerySchema: Query;
-    requestHeaderSchema: RequestHeaders;
+    requestPathParamsSchema?: Params;
+    requestQuerySchema?: Query;
+    requestHeaderSchema?: RequestHeaders;
     /** Single sync response schema */
     successResponseBodySchema: JsonResponse;
     /**
@@ -100,6 +108,10 @@ export type DualModeGetContractConfig<Params extends z.ZodTypeAny, Query extends
     responseBodySchemasByStatusCode?: ResponseSchemasByStatusCode;
     serverSentEventSchemas: Events;
     requestBodySchema?: never;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };
 /**
  * Configuration for building a POST/PUT/PATCH dual-mode route with request body.
@@ -108,9 +120,9 @@ export type DualModeGetContractConfig<Params extends z.ZodTypeAny, Query extends
 export type DualModePayloadContractConfig<Params extends z.ZodTypeAny, Query extends z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny, Body extends z.ZodTypeAny, JsonResponse extends z.ZodTypeAny, Events extends SSEEventSchemas, ResponseHeaders extends z.ZodTypeAny | undefined = undefined, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined> = {
     method: 'post' | 'put' | 'patch';
     pathResolver: RoutePathResolver<z.infer<Params>>;
-    requestPathParamsSchema: Params;
-    requestQuerySchema: Query;
-    requestHeaderSchema: RequestHeaders;
+    requestPathParamsSchema?: Params;
+    requestQuerySchema?: Query;
+    requestHeaderSchema?: RequestHeaders;
     requestBodySchema: Body;
     /** Single sync response schema */
     successResponseBodySchema: JsonResponse;
@@ -141,6 +153,10 @@ export type DualModePayloadContractConfig<Params extends z.ZodTypeAny, Query ext
      */
     responseBodySchemasByStatusCode?: ResponseSchemasByStatusCode;
     serverSentEventSchemas: Events;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };
 export declare function buildSseContract<Params extends z.ZodTypeAny, Query extends z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny, JsonResponse extends z.ZodTypeAny, Events extends SSEEventSchemas, ResponseHeaders extends z.ZodTypeAny | undefined = undefined, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined>(config: DualModeGetContractConfig<Params, Query, RequestHeaders, JsonResponse, Events, ResponseHeaders, ResponseSchemasByStatusCode>): DualModeContractDefinition<'get', Params, Query, RequestHeaders, undefined, JsonResponse, Events, ResponseHeaders, ResponseSchemasByStatusCode>;
 export declare function buildSseContract<Params extends z.ZodTypeAny, Query extends z.ZodTypeAny, RequestHeaders extends z.ZodTypeAny, Events extends SSEEventSchemas, ResponseSchemasByStatusCode extends Partial<Record<HttpStatusCode, z.ZodTypeAny>> | undefined = undefined>(config: SSEGetContractConfig<Params, Query, RequestHeaders, Events, ResponseSchemasByStatusCode>): SSEContractDefinition<'get', Params, Query, RequestHeaders, undefined, Events, ResponseSchemasByStatusCode>;

package/dist/sse/sseContractBuilders.js

@@ -62,6 +62,10 @@ function buildBaseFields(config, hasBody) {
         requestHeaderSchema: config.requestHeaderSchema,
         requestBodySchema: hasBody ? config.requestBodySchema : undefined,
         serverSentEventSchemas: config.serverSentEventSchemas,
+        metadata: config.metadata,
+        description: config.description,
+        summary: config.summary,
+        tags: config.tags,
     };
 }
 // Helper to determine method

package/dist/sse/sseContractBuilders.js.map

@@ -1 +1 @@
-{"version":3,"file":"sseContractBuilders.js","sourceRoot":"","sources":["../../src/sse/sseContractBuilders.ts"],"names":[],"mappings":"AA2LA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,uCAAuC;AACvC,gEAAgE;AAChE,SAAS,eAAe,CAAC,MAAW,EAAE,OAAgB;IACpD,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;QACvD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;QACjE,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;KACtD,CAAA;AACH,CAAC;AAED,6BAA6B;AAC7B,SAAS,eAAe,CAAC,MAA0B;IACjD,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAwHD,iBAAiB;AACjB,MAAM,UAAU,gBAAgB,CAC9B,MAOiD;IAGjD,MAAM,mBAAmB,GACvB,2BAA2B,IAAI,MAAM,IAAI,MAAM,CAAC,yBAAyB,KAAK,SAAS,CAAA;IACzF,MAAM,OAAO,GAAG,mBAAmB,IAAI,MAAM,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,CAAA;IACvF,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE7C,IAAI,mBAAmB,EAAE,CAAC;QACxB,qBAAqB;QACrB,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,eAAe,CAAC,MAA4B,CAAC;YACrD,yBAAyB,EAAG,MAAiD;iBAC1E,yBAAyB;YAC5B,oBAAoB,EAAG,MAA6C,CAAC,oBAAoB;YACzF,+BAA+B,EAAG,MAAwD;iBACvF,+BAA+B;YAClC,UAAU,EAAE,IAAI;SACjB,CAAA;IACH,CAAC;IAED,oBAAoB;IACpB,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,eAAe,CAAC,MAA4B,CAAC;QACrD,+BAA+B,EAAG,MAAwD;aACvF,+BAA+B;QAClC,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC"}
+{"version":3,"file":"sseContractBuilders.js","sourceRoot":"","sources":["../../src/sse/sseContractBuilders.ts"],"names":[],"mappings":"AA2MA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,uCAAuC;AACvC,gEAAgE;AAChE,SAAS,eAAe,CAAC,MAAW,EAAE,OAAgB;IACpD,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;QACvD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;QACjE,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;QACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC;AAED,6BAA6B;AAC7B,SAAS,eAAe,CAAC,MAA0B;IACjD,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAwHD,iBAAiB;AACjB,MAAM,UAAU,gBAAgB,CAC9B,MAOiD;IAGjD,MAAM,mBAAmB,GACvB,2BAA2B,IAAI,MAAM,IAAI,MAAM,CAAC,yBAAyB,KAAK,SAAS,CAAA;IACzF,MAAM,OAAO,GAAG,mBAAmB,IAAI,MAAM,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,CAAA;IACvF,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE7C,IAAI,mBAAmB,EAAE,CAAC;QACxB,qBAAqB;QACrB,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,eAAe,CAAC,MAA4B,CAAC;YACrD,yBAAyB,EAAG,MAAiD;iBAC1E,yBAAyB;YAC5B,oBAAoB,EAAG,MAA6C,CAAC,oBAAoB;YACzF,+BAA+B,EAAG,MAAwD;iBACvF,+BAA+B;YAClC,UAAU,EAAE,IAAI;SACjB,CAAA;IACH,CAAC;IAED,oBAAoB;IACpB,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,eAAe,CAAC,MAA4B,CAAC;QACrD,+BAA+B,EAAG,MAAwD;aACvF,+BAA+B;QAClC,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC"}

package/dist/sse/sseContracts.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod/v4';
-import type { RoutePathResolver } from '../apiContracts.ts';
+import type { CommonRouteDefinitionMetadata, RoutePathResolver } from '../apiContracts.ts';
 import type { HttpStatusCode } from '../HttpStatusCodes.ts';
 import type { SSEEventSchemas } from './sseTypes.ts';
 /**
@@ -26,9 +26,9 @@ export type SSEContractDefinition<Method extends SSEMethod = SSEMethod, Params e
      * Receives typed params and returns the URL path string.
      */
     pathResolver: RoutePathResolver<z.infer<Params>>;
-    requestPathParamsSchema: Params;
-    requestQuerySchema: Query;
-    requestHeaderSchema: RequestHeaders;
+    requestPathParamsSchema?: Params;
+    requestQuerySchema?: Query;
+    requestHeaderSchema?: RequestHeaders;
     requestBodySchema: Body;
     serverSentEventSchemas: Events;
     /**
@@ -46,6 +46,10 @@ export type SSEContractDefinition<Method extends SSEMethod = SSEMethod, Params e
      */
     responseBodySchemasByStatusCode?: ResponseSchemasByStatusCode;
     isSSE: true;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };
 /**
  * Type representing any SSE route definition (for use in generic constraints).
@@ -54,11 +58,15 @@ export type SSEContractDefinition<Method extends SSEMethod = SSEMethod, Params e
 export type AnySSEContractDefinition = {
     method: SSEMethod;
     pathResolver: RoutePathResolver<any>;
-    requestPathParamsSchema: z.ZodTypeAny;
-    requestQuerySchema: z.ZodTypeAny;
-    requestHeaderSchema: z.ZodTypeAny;
+    requestPathParamsSchema?: z.ZodTypeAny;
+    requestQuerySchema?: z.ZodTypeAny;
+    requestHeaderSchema?: z.ZodTypeAny;
     requestBodySchema: z.ZodTypeAny | undefined;
     serverSentEventSchemas: SSEEventSchemas;
     responseBodySchemasByStatusCode?: Partial<Record<HttpStatusCode, z.ZodTypeAny>>;
     isSSE: true;
+    metadata?: CommonRouteDefinitionMetadata;
+    description?: string;
+    summary?: string;
+    tags?: readonly string[];
 };

package/package.json

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