opinionated-machine 10.0.0 → 10.2.0

package/dist/lib/testing/apiSseTestTypes.d.ts

@@ -0,0 +1,202 @@
+import type { ApiContract, ClientErrorHttpStatusCode, ExpandStatusRangeKey, HttpStatusCode, HttpStatusCodeRange, InformationalHttpStatusCode, RedirectionHttpStatusCode, ServerErrorHttpStatusCode, SuccessfulHttpStatusCode } from '@lokalise/api-contracts';
+import type { InjectByApiContractParams } from '@lokalise/fastify-api-contracts';
+import type { z } from 'zod';
+import type { SSEResponse } from './sseTestTypes.ts';
+/**
+ * Request params for {@link injectApiSSE}, derived from a `defineApiContract` contract.
+ *
+ * Identical to the params of `injectByApiContract` from
+ * `@lokalise/fastify-api-contracts` — `pathParams`, `body`, `queryParams` and
+ * `headers` are each required only when the contract declares the matching
+ * request schema, `headers` also accepts a (sync or async) factory, and
+ * `pathPrefix` is always optional.
+ */
+export type InjectApiSSEParams<Contract extends ApiContract> = InjectByApiContractParams<Contract>;
+/** The `responsesByStatusCode` map of a contract. */
+type Responses<Contract extends ApiContract> = Contract['responsesByStatusCode'];
+/** The concrete status codes a contract declares exactly (non-wildcard keys). */
+type ExactStatusCodes<Contract extends ApiContract> = keyof Responses<Contract> & HttpStatusCode;
+/** Status codes covered by any range key (e.g. `'2xx'`, `'4xx'`) the contract declares. */
+type RangeStatusCodes<Contract extends ApiContract> = {
+    [Key in keyof Responses<Contract> & HttpStatusCodeRange]: ExpandStatusRangeKey<Key>;
+}[keyof Responses<Contract> & HttpStatusCodeRange];
+/**
+ * Maps a `responsesByStatusCode` key to the statuses it covers, mirroring the runtime
+ * lookup precedence (exact → range → `'default'`): a concrete key stays as-is; a range key
+ * expands to its status class minus the exactly-declared codes; `'default'` expands to every
+ * status not covered by an exact or range key.
+ */
+type StatusesForKey<Contract extends ApiContract, Key> = Key extends 'default' ? Exclude<HttpStatusCode, ExactStatusCodes<Contract> | RangeStatusCodes<Contract>> : Key extends HttpStatusCodeRange ? Exclude<ExpandStatusRangeKey<Key>, ExactStatusCodes<Contract>> : Key;
+/** The range key a concrete status code falls into. */
+type RangeKeyOf<Status extends HttpStatusCode> = Status extends InformationalHttpStatusCode ? '1xx' : Status extends SuccessfulHttpStatusCode ? '2xx' : Status extends RedirectionHttpStatusCode ? '3xx' : Status extends ClientErrorHttpStatusCode ? '4xx' : Status extends ServerErrorHttpStatusCode ? '5xx' : never;
+/** The media type `injectApiSSE` always asks for — see {@link StreamSchemasOfEntry}. */
+type SSEMediaType = 'text/event-stream';
+/**
+ * The `event name -> schema` map of an SSE body descriptor, or `never` for any other
+ * descriptor (a bare Zod schema is JSON, `blobBody()` is opaque bytes).
+ */
+type SseSchemasOfDescriptor<Descriptor> = Descriptor extends {
+    _tag: 'SseBody';
+    schemaByEventName: infer Schemas;
+} ? Schemas : never;
+/**
+ * Every SSE schema map a response entry declares, across all of its media types — the
+ * type-level counterpart of the maps `getSseSchemaByEventName` collects at runtime.
+ */
+type SseSchemasOfEntry<Entry> = Entry extends {
+    content: infer Content;
+} ? SseSchemasOfDescriptor<Content[keyof Content]> : never;
+/**
+ * The SSE schema map an entry declares under `text/event-stream` specifically.
+ *
+ * `injectApiSSE` always sends `accept: text/event-stream`, so this is the descriptor a
+ * status resolves to whenever it declares one — even on a dual-mode content map that also
+ * carries a JSON schema.
+ */
+type StreamSchemasOfEntry<Entry> = Entry extends {
+    content: infer Content;
+} ? SseSchemasOfDescriptor<Content[SSEMediaType & keyof Content]> : never;
+/**
+ * The JSON Zod schema of a single response entry, or `never` when this helper can't reach a
+ * JSON body there. A bare schema is JSON; a content-map entry contributes the schemas of its
+ * non-blob, non-SSE descriptors.
+ *
+ * An entry that declares a `text/event-stream` body has no reachable JSON side: the request
+ * asks for the stream, so a dual-mode status answers with SSE and `bodyForStatus` would throw.
+ * Read those with `events()` instead.
+ */
+type JsonSchemaOfEntry<Entry> = [StreamSchemasOfEntry<Entry>] extends [never] ? Entry extends z.ZodType ? Entry : Entry extends {
+    content: infer Content;
+} ? Extract<Content[keyof Content], z.ZodType> : never : never;
+/** Indexes a responses map with a key that may not exist on it (yielding `never` if it doesn't). */
+type EntryAt<Contract extends ApiContract, Key> = NonNullable<Responses<Contract>[Key & keyof Responses<Contract>]>;
+/** The response entry that serves a concrete status, following exact → range → `'default'`. */
+type EntryForStatus<Contract extends ApiContract, Status extends HttpStatusCode> = [
+    EntryAt<Contract, Status>
+] extends [never] ? [EntryAt<Contract, RangeKeyOf<Status>>] extends [never] ? EntryAt<Contract, 'default'> : EntryAt<Contract, RangeKeyOf<Status>> : EntryAt<Contract, Status>;
+/**
+ * Status codes for which the contract declares a JSON response body.
+ *
+ * Resolves to `never` for contracts that declare none, so `bodyForStatus` is uncallable there.
+ * Range and `'default'` keys expand to the concrete statuses they serve, so a contract
+ * declaring only `4xx` still allows `bodyForStatus(404)`.
+ */
+export type ApiDeclaredResponseStatus<Contract extends ApiContract> = {
+    [Key in keyof Responses<Contract>]: [JsonSchemaOfEntry<EntryAt<Contract, Key>>] extends [never] ? never : StatusesForKey<Contract, Key>;
+}[keyof Responses<Contract>] & HttpStatusCode;
+/** Infers a schema's output type, or `never` when there is no schema. */
+type InferJsonBody<Schema> = Schema extends z.ZodType ? z.output<Schema> : never;
+/** The parsed JSON response body a contract declares for a concrete status. */
+export type ApiDeclaredResponseBody<Contract extends ApiContract, Status extends HttpStatusCode> = InferJsonBody<JsonSchemaOfEntry<EntryForStatus<Contract, Status>>>;
+/**
+ * Union of the SSE schema maps a contract declares, over *every* status key.
+ *
+ * Deliberately not `InferSseSuccessResponses`, which only looks at success / `'2xx'` /
+ * `'default'` keys: the runtime `getSseSchemaByEventName` merges the maps of every entry in
+ * `responsesByStatusCode`, so a stream declared under e.g. `'4xx'` produces validated events
+ * too and has to be visible here.
+ */
+type ApiSSEEventSchemas<Contract extends ApiContract> = SseSchemasOfEntry<NonNullable<Responses<Contract>[keyof Responses<Contract>]>>;
+/**
+ * The event names of a union of schema maps.
+ *
+ * `keyof` a union yields only the keys shared by every member, which collapses to `never` as
+ * soon as two statuses declare different events — so distribute first and union the keys,
+ * mirroring the runtime merge.
+ */
+type SseEventNamesOf<Schemas> = Schemas extends unknown ? keyof Schemas & string : never;
+/**
+ * The schema(s) a union of maps declares for one event name. Maps that don't declare it drop
+ * out; two maps declaring it with different schemas yield a union, since the runtime merge
+ * keeps only one of them and the reader can't tell which.
+ */
+type SseSchemaForEventName<Schemas, Name extends string> = Schemas extends Record<Name, infer Schema> ? Schema : never;
+/** Builds the event union for an already-resolved set of schema maps. */
+type ApiSSEEventOf<Schemas> = {
+    [Name in SseEventNamesOf<Schemas>]: {
+        /** Event ID, when the server sent an `id:` field. */
+        id?: string;
+        /** Event name, as sent in the `event:` field (defaults to `message`). */
+        event: Name;
+        /** Reconnection hint in milliseconds, when the server sent a `retry:` field. */
+        retry?: number;
+        /** `data:` payload, JSON-parsed and validated against the contract's schema. */
+        data: InferJsonBody<SseSchemaForEventName<Schemas, Name>>;
+    };
+}[SseEventNamesOf<Schemas>];
+/**
+ * Discriminated union of the SSE events a contract declares, with `data` parsed and typed
+ * per event name. `never` for a contract that declares no SSE response at all.
+ */
+export type ApiSSEEvent<Contract extends ApiContract> = ApiSSEEventOf<ApiSSEEventSchemas<Contract>>;
+/** Whether a contract declares an SSE response on any status. */
+type HasApiSSEResponse<Contract extends ApiContract> = [ApiSSEEventSchemas<Contract>] extends [
+    never
+] ? false : true;
+/**
+ * The callable form of {@link InjectApiSSEResult.events}.
+ *
+ * Always a function, so the internal binder has a type to return regardless of what the
+ * contract declares; the result type below hides it behind {@link HasApiSSEResponse}.
+ */
+export type ApiSSEEventReader<Contract extends ApiContract> = () => Promise<ApiSSEEvent<Contract>[]>;
+/**
+ * Result of an {@link injectApiSSE} call.
+ *
+ * The `defineApiContract` counterpart of `InjectSSEResult`: same `closed` promise and
+ * `bodyForStatus` accessor, plus `events()` for reading the stream typed against the
+ * contract's `sseResponse` / `sseBody` schemas.
+ */
+export type InjectApiSSEResult<Contract extends ApiContract> = {
+    /**
+     * Resolves when the response completes with the full SSE body.
+     * Parse the body with `parseSSEEvents()` — or use `events()` for typed events.
+     */
+    closed: Promise<SSEResponse>;
+    /**
+     * Awaits the response, asserts the status code matches, parses the body against the
+     * contract's JSON schema for that status, and returns the parsed object. Useful for
+     * asserting on the documented error responses a handler emits before streaming starts.
+     *
+     * Throws (with the offending status and a truncated body snippet) if:
+     * - the actual status code doesn't match the expected one;
+     * - the contract declares no JSON body for that status;
+     * - the body isn't valid JSON;
+     * - the body doesn't match the declared Zod schema.
+     *
+     * At the type level, `statusCode` is constrained to the statuses the contract declares a
+     * JSON body for. Contracts without any can't call this method (`statusCode: never`).
+     *
+     * @example
+     * ```typescript
+     * const { bodyForStatus } = injectApiSSE(app, contract, { body })
+     * const error = await bodyForStatus(400)  // typed as z.output<400-schema>
+     * expect(error.message).toBe('Bad request')
+     * ```
+     */
+    bodyForStatus<Status extends ApiDeclaredResponseStatus<Contract>>(statusCode: Status): Promise<ApiDeclaredResponseBody<Contract, Status>>;
+    /**
+     * Awaits the response, parses the SSE body, and validates every event against the
+     * contract's SSE schemas, returning them as a discriminated union on `event`.
+     *
+     * Events are typed from the SSE schemas of *every* status the contract declares, merged
+     * exactly as the runtime merges them — a contract streaming different events on two
+     * statuses yields the union of both.
+     *
+     * Throws if the response isn't an SSE stream (use `bodyForStatus` for the documented
+     * error statuses), if an event name isn't declared by the contract, or if an event payload
+     * doesn't match its schema.
+     *
+     * A contract that declares no SSE response at all types this as `never`, so calling it is
+     * a compile error rather than a guaranteed throw — reach for `injectByApiContract` there.
+     *
+     * @example
+     * ```typescript
+     * const events = await injectApiSSE(app, contract, { body }).events()
+     * const review = events.find((event) => event.event === 'review')
+     * expect(review?.data.score).toBe(42)  // `data` typed by the `review` schema
+     * ```
+     */
+    events: HasApiSSEResponse<Contract> extends true ? ApiSSEEventReader<Contract> : never;
+};
+export {};

package/dist/lib/testing/apiSseTestTypes.js

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

package/dist/lib/testing/apiSseTestTypes.js.map

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

package/dist/lib/testing/index.d.ts

@@ -1,5 +1,8 @@
-export { type HasSessionSpy, SSEHttpClient, type SSEHttpConnectOptions, type SSEHttpConnectResult, type SSEHttpConnectWithSpyOptions, } from './sseHttpClient.js';
+export { injectApiSSE } from './apiSseInjectHelpers.js';
+export type { ApiDeclaredResponseBody, ApiDeclaredResponseStatus, ApiSSEEvent, ApiSSEEventReader, InjectApiSSEParams, InjectApiSSEResult, } from './apiSseTestTypes.js';
+export { type HasSessionSpy, SSEHttpClient, type SSEHttpConnectOptions, type SSEHttpConnectResult, type SSEHttpConnectWithSessionSpyOptions, type SSEHttpConnectWithSpyOptions, } from './sseHttpClient.js';
 export { SSEInjectClient, SSEInjectConnection } from './sseInjectClient.js';
 export { injectPayloadSSE, injectSSE } from './sseInjectHelpers.js';
+export { type CreateSSESessionSpyResult, createSSESessionSpy, type SSESessionSpyHooks, type SSESessionSpyRouteOptions, } from './sseSessionSpyFactory.js';
 export { SSETestServer } from './sseTestServer.js';
 export type { InjectPayloadSSEOptions, InjectSSEOptions, InjectSSEResult, SSEConnectOptions, SSEResponse, SSETestConnection, } from './sseTestTypes.js';

package/dist/lib/testing/index.js

@@ -1,5 +1,7 @@
+export { injectApiSSE } from './apiSseInjectHelpers.js';
 export { SSEHttpClient, } from './sseHttpClient.js';
 export { SSEInjectClient, SSEInjectConnection } from './sseInjectClient.js';
 export { injectPayloadSSE, injectSSE } from './sseInjectHelpers.js';
+export { createSSESessionSpy, } from './sseSessionSpyFactory.js';
 export { SSETestServer } from './sseTestServer.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,GAId,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AASvD,OAAO,EAEL,aAAa,GAKd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAEL,mBAAmB,GAGpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/lib/testing/sseHttpClient.d.ts

@@ -1,5 +1,5 @@
 import type { SSESession } from '../routes/fastifyRouteTypes.ts';
-import type { SSESessionSpy } from '../sse/SSESessionSpy.ts';
+import type { SpiedSSESession, SSESessionSpy } from '../sse/SSESessionSpy.ts';
 import { type ParsedSSEEvent } from '../sse/sseParser.ts';
 /**
  * Interface for objects that have a sessionSpy (e.g., SSE controllers in test mode).
@@ -17,7 +17,8 @@ export type SSEHttpConnectOptions = {
     headers?: Record<string, string>;
 };
 /**
- * Options for connecting with automatic server-side connection waiting.
+ * Options for connecting with automatic server-side connection waiting,
+ * driven by a controller's built-in `connectionSpy`.
  */
 export type SSEHttpConnectWithSpyOptions = SSEHttpConnectOptions & {
     /**
@@ -32,12 +33,32 @@ export type SSEHttpConnectWithSpyOptions = SSEHttpConnectOptions & {
         timeout?: number;
     };
 };
+/**
+ * Options for connecting with automatic server-side connection waiting,
+ * driven by a standalone spy from `createSSESessionSpy()`.
+ *
+ * Use this for routes built with `buildApiRoute`, which have no controller to
+ * read a `connectionSpy` off of.
+ */
+export type SSEHttpConnectWithSessionSpyOptions<TSession extends SpiedSSESession> = SSEHttpConnectOptions & {
+    /**
+     * Wait for server-side connection registration after HTTP headers are received.
+     * This eliminates the race condition between `connect()` returning and the
+     * server-side handler completing connection registration.
+     */
+    awaitServerConnection: {
+        /** A standalone spy, wired to the route via `createSSESessionSpy()`'s `routeOptions` */
+        spy: SSESessionSpy<TSession>;
+        /** Timeout in milliseconds (default: 5000) */
+        timeout?: number;
+    };
+};
 /**
  * Result when connecting with awaitServerConnection option.
  */
-export type SSEHttpConnectResult = {
+export type SSEHttpConnectResult<TSession extends SpiedSSESession = SSESession> = {
     client: SSEHttpClient;
-    serverConnection: SSESession;
+    serverConnection: TSession;
 };
 /**
  * SSE client for testing long-lived connections using real HTTP.
@@ -129,9 +150,20 @@ export declare class SSEHttpClient {
      * )
      * // serverConnection is ready to use immediately
      * await controller.sendEvent(serverConnection.id, { event: 'test', data: {} })
+     *
+     * // Same, for a `buildApiRoute` route with no controller: wire a standalone
+     * // spy into the route's hooks with createSSESessionSpy()
+     * const { spy, routeOptions } = createSSESessionSpy()
+     * const { client, serverConnection } = await SSEHttpClient.connect(
+     *   'http://localhost:3000',
+     *   '/api/stream',
+     *   { awaitServerConnection: { spy } }
+     * )
+     * await serverConnection.send('test', {})
      * ```
      */
     static connect(baseUrl: string, path: string, options: SSEHttpConnectWithSpyOptions): Promise<SSEHttpConnectResult>;
+    static connect<TSession extends SpiedSSESession>(baseUrl: string, path: string, options: SSEHttpConnectWithSessionSpyOptions<TSession>): Promise<SSEHttpConnectResult<TSession>>;
     static connect(baseUrl: string, path: string, options?: SSEHttpConnectOptions): Promise<SSEHttpClient>;
     /**
      * Async generator that yields parsed SSE events as they arrive.

package/dist/lib/testing/sseHttpClient.js

@@ -86,15 +86,38 @@ export class SSEHttpClient {
             },
             signal: abortController.signal,
         });
-        const client = new SSEHttpClient(response, abortController);
+        let client;
+        try {
+            client = new SSEHttpClient(response, abortController);
+        }
+        catch (error) {
+            // Nothing owns the response yet, so abort it here rather than leaking it.
+            abortController.abort();
+            throw error;
+        }
         // If awaitServerConnection is specified, wait for server-side registration
         if (options && 'awaitServerConnection' in options && options.awaitServerConnection) {
-            const { controller, timeout } = options.awaitServerConnection;
-            const serverConnection = await controller.connectionSpy.waitForConnection({
-                timeout: timeout ?? 5000,
+            const awaitOptions = options.awaitServerConnection;
+            const waitOptions = {
+                timeout: awaitOptions.timeout ?? 5000,
                 predicate: (conn) => conn.request.url === pathWithQuery,
-            });
-            return { client, serverConnection };
+            };
+            try {
+                // Both branches call the same method; the spy is invariant in its session
+                // type, so they cannot be collapsed into one reference.
+                const serverConnection = 'spy' in awaitOptions
+                    ? await awaitOptions.spy.waitForConnection(waitOptions)
+                    : await awaitOptions.controller.connectionSpy.waitForConnection(waitOptions);
+                return { client, serverConnection };
+            }
+            catch (error) {
+                // The HTTP connection is already established and the caller never gets a
+                // handle to it, so close it here. Left open, a keep-alive route keeps the
+                // socket streaming and the test's `app.close()` hangs, hiding this error
+                // behind a suite-level timeout.
+                client.close();
+                throw error;
+            }
         }
         return client;
     }

package/dist/lib/testing/sseHttpClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"sseHttpClient.js","sourceRoot":"","sources":["../../../lib/testing/sseHttpClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sseHttpClient.js","sourceRoot":"","sources":["../../../lib/testing/sseHttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAG5C,OAAO,EAAuB,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAiEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,OAAO,aAAa;IACxB,gFAAgF;IACvE,QAAQ,CAAU;IACV,eAAe,CAAiB;IAChC,MAAM,CAAyC;IAC/C,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACpC,MAAM,GAAG,EAAE,CAAA;IACX,MAAM,GAAG,KAAK,CAAA;IAEtB,YAAoB,QAAkB,EAAE,eAAgC;QACtE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACzC,CAAC;IA0DD,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,OAAe,EACf,IAAY,EACZ,OAGwD;QAExD,+BAA+B;QAC/B,IAAI,aAAa,GAAG,IAAI,CAAA;QACxB,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAC5C,IAAI,WAAW,EAAE,CAAC;gBAChB,aAAa,GAAG,GAAG,IAAI,IAAI,WAAW,EAAE,CAAA;YAC1C,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,aAAa,EAAE,EAAE;YACzD,OAAO,EAAE;gBACP,MAAM,EAAE,mBAAmB;gBAC3B,GAAG,OAAO,EAAE,OAAO;aACpB;YACD,MAAM,EAAE,eAAe,CAAC,MAAM;SAC/B,CAAC,CAAA;QAEF,IAAI,MAAqB,CAAA;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,MAAM,KAAK,CAAA;QACb,CAAC;QAED,2EAA2E;QAC3E,IAAI,OAAO,IAAI,uBAAuB,IAAI,OAAO,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;YACnF,MAAM,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAA;YAClD,MAAM,WAAW,GAAG;gBAClB,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,IAAI;gBACrC,SAAS,EAAE,CAAC,IAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,aAAa;aACzE,CAAA;YACD,IAAI,CAAC;gBACH,0EAA0E;gBAC1E,wDAAwD;gBACxD,MAAM,gBAAgB,GACpB,KAAK,IAAI,YAAY;oBACnB,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,WAAW,CAAC;oBACvD,CAAC,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAA;gBAChF,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yEAAyE;gBACzE,0EAA0E;gBAC1E,yEAAyE;gBACzE,gCAAgC;gBAChC,MAAM,CAAC,KAAK,EAAE,CAAA;gBACd,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,MAAoB;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,OAAM;YACR,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;YACnD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAM;YACR,CAAC;YAED,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;gBAClB,MAAK;YACP,CAAC;YAED,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YACtE,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC/C,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,SAAS,CAAA;YAEnC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACvC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,OAAM;gBACR,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa,CAAC,MAAoB;QAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,IAAI,WAAW,GAAG,KAAK,CAAA;QAEvB,MAAM,YAAY,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACtD,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO,CAAC,SAAS,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC,CAAA;YACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAA;YACX,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;QAC9D,WAAW,GAAG,IAAI,CAAA;QAElB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,qDAAqD;YACrD,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC7B,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,aAAa,CACjB,gBAA+D,EAC/D,OAAO,GAAG,IAAI;QAEd,MAAM,SAAS,GAAqB,EAAE,CAAA;QACtC,MAAM,OAAO,GAAG,OAAO,gBAAgB,KAAK,QAAQ,CAAA;QACpD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;QACpD,IAAI,QAAQ,GAAG,KAAK,CAAA;QAEpB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,QAAQ,GAAG,IAAI,CAAA;YACf,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,kCAAkC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACzF,CAAC,EAAE,OAAO,CAAC,CAAA;QAEX,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBACnC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAErB,IAAI,OAAO,IAAI,SAAS,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;oBACpD,MAAK;gBACP,CAAC;gBACD,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxC,MAAK;gBACP,CAAC;YACH,CAAC;YAED,2EAA2E;YAC3E,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,eAAe,CAAC,MAAM,CAAC,MAAM,CAAA;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iDAAiD;YACjD,IAAI,QAAQ,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/C,MAAM,eAAe,CAAC,MAAM,CAAC,MAAM,CAAA;YACrC,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAA;YACvB,eAAe,CAAC,KAAK,EAAE,CAAA,CAAC,0CAA0C;QACpE,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,6EAA6E;QAC7E,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAC9B,6CAA6C;QAC/C,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF"}

package/dist/lib/testing/sseInjectHelpers.js

@@ -1,15 +1,4 @@
-/** Truncate a long body string for error messages. */
-const BODY_TRUNCATE_LIMIT = 500;
-const truncateBody = (body) => {
-    if (body.length <= BODY_TRUNCATE_LIMIT) {
-        return body;
-    }
-    // Step back one unit if the cut would split a surrogate pair, so the
-    // snippet never ends in a lone (invalid) surrogate.
-    const lastCode = body.charCodeAt(BODY_TRUNCATE_LIMIT - 1);
-    const end = lastCode >= 0xd800 && lastCode <= 0xdbff ? BODY_TRUNCATE_LIMIT - 1 : BODY_TRUNCATE_LIMIT;
-    return `${body.slice(0, end)}…`;
-};
+import { truncateBody } from "./sseInjectShared.js";
 /**
  * Build a `bodyForStatus` accessor bound to one inject call. The closure
  * captures the contract's schemas map so the resulting helper knows which

package/dist/lib/testing/sseInjectHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"sseInjectHelpers.js","sourceRoot":"","sources":["../../../lib/testing/sseInjectHelpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sseInjectHelpers.js","sourceRoot":"","sources":["../../../lib/testing/sseInjectHelpers.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAUnD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAG/B,QAAuD,EACvD,MAA4B;IAE5B,qEAAqE;IACrE,iEAAiE;IACjE,kEAAkE;IAClE,OAAO,CAAC,KAAK,EACX,UAAkB,EAC8B,EAAE;QAClD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAA;QACxB,MAAM,QAAQ,GAAW,UAAU,CAAA;QACnC,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,iBAAiB,QAAQ,qBAAqB,GAAG,CAAC,UAAU,WAAW,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAChG,CAAA;QACH,CAAC;QACD,yEAAyE;QACzE,MAAM,OAAO,GACX,QAAQ,CAAC,+BAA+B,CAAA;QAC1C,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC,QAA0B,CAAC,CAAA;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,iBAAiB,QAAQ,mDAAmD,QAAQ,8CAA8C,CACnI,CAAA;QACH,CAAC;QACD,IAAI,UAAmB,CAAA;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,iBAAiB,QAAQ,+BAAgC,GAAa,CAAC,OAAO,WAAW,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAClH,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,iBAAiB,QAAQ,gDAAgD,MAAM,CAAC,KAAK,CAAC,OAAO,WAAW,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACjI,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAA6C,CAAA;IAC7D,CAAC,CAA8C,CAAA;AACjD,CAAC;AAUD;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAA8B;IACtD,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CACf,QAAkB,EAClB,MAA+B,EAC/B,KAA+B;IAE/B,IAAI,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IAE7C,iCAAiC;IACjC,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,WAAW,EAAE,CAAC;YAChB,GAAG,GAAG,GAAG,GAAG,IAAI,WAAW,EAAE,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAgBvB,GAAuB,EACvB,QAAkB,EAClB,OAAoC;IAEpC,MAAM,GAAG,GAAG,QAAQ,CAClB,QAAQ,EACR,OAAO,EAAE,MAA4C,EACrD,OAAO,EAAE,KAA4C,CACtD,CAAA;IAED,mEAAmE;IACnE,MAAM,MAAM,GAAG,GAAG;SACf,MAAM,CAAC;QACN,MAAM,EAAE,KAAK;QACb,GAAG;QACH,OAAO,EAAE;YACP,MAAM,EAAE,mBAAmB;YAC3B,GAAI,OAAO,EAAE,OAA8C;SAC5D;KACF,CAAC;SACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAwD;QACrE,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC,CAAC,CAAA;IAEL,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAA;AACvE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB,CAa9B,GAAuB,EACvB,QAAkB,EAClB,OAA0C;IAE1C,MAAM,GAAG,GAAG,QAAQ,CAClB,QAAQ,EACR,OAAO,CAAC,MAA4C,EACpD,OAAO,CAAC,KAA4C,CACrD,CAAA;IAED,MAAM,MAAM,GAAG,GAAG;SACf,MAAM,CAAC;QACN,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG;QACH,OAAO,EAAE;YACP,MAAM,EAAE,mBAAmB;YAC3B,cAAc,EAAE,kBAAkB;YAClC,GAAI,OAAO,CAAC,OAA8C;SAC3D;QACD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;KACtC,CAAC;SACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAwD;QACrE,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC,CAAC,CAAA;IAEL,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAA;AACvE,CAAC"}

package/dist/lib/testing/sseInjectShared.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Helpers shared by the contract-aware SSE inject helpers (legacy
+ * `SSEContractDefinition` and `defineApiContract` flavours alike).
+ *
+ * @internal
+ */
+export declare const truncateBody: (body: string) => string;

package/dist/lib/testing/sseInjectShared.js

@@ -0,0 +1,19 @@
+/**
+ * Helpers shared by the contract-aware SSE inject helpers (legacy
+ * `SSEContractDefinition` and `defineApiContract` flavours alike).
+ *
+ * @internal
+ */
+/** Truncate a long body string for error messages. */
+const BODY_TRUNCATE_LIMIT = 500;
+export const truncateBody = (body) => {
+    if (body.length <= BODY_TRUNCATE_LIMIT) {
+        return body;
+    }
+    // Step back one unit if the cut would split a surrogate pair, so the
+    // snippet never ends in a lone (invalid) surrogate.
+    const lastCode = body.charCodeAt(BODY_TRUNCATE_LIMIT - 1);
+    const end = lastCode >= 0xd800 && lastCode <= 0xdbff ? BODY_TRUNCATE_LIMIT - 1 : BODY_TRUNCATE_LIMIT;
+    return `${body.slice(0, end)}…`;
+};
+//# sourceMappingURL=sseInjectShared.js.map

package/dist/lib/testing/sseInjectShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseInjectShared.js","sourceRoot":"","sources":["../../../lib/testing/sseInjectShared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sDAAsD;AACtD,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE;IACnD,IAAI,IAAI,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,qEAAqE;IACrE,oDAAoD;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAA;IACzD,MAAM,GAAG,GACP,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAA;IAC1F,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAA;AACjC,CAAC,CAAA"}

package/dist/lib/testing/sseSessionSpyFactory.d.ts

@@ -0,0 +1,109 @@
+import type { SSESession as ApiSSESession, SSECloseInitiator } from '@lokalise/fastify-api-contracts';
+import { type SpiedSSESession, SSESessionSpy } from '../sse/SSESessionSpy.ts';
+/**
+ * The SSE lifecycle hooks a route may declare, as far as a spy is concerned.
+ *
+ * Structurally a subset of the SSE route options of both `buildApiRoute` /
+ * `buildFastifyApiRoute` and this package's own `buildFastifyRoute`, so any of
+ * their option objects can be handed to {@link CreateSSESessionSpyResult.withSpy}.
+ */
+export type SSESessionSpyHooks<TSession extends SpiedSSESession = ApiSSESession> = {
+    onConnect?: (connection: TSession) => void | Promise<void>;
+    onClose?: (connection: TSession, initiator: SSECloseInitiator) => void | Promise<void>;
+};
+/**
+ * The SSE lifecycle hooks that feed a standalone {@link SSESessionSpy}.
+ *
+ * Shaped to be spread straight into route options that accept SSE lifecycle
+ * hooks — `buildApiRoute` / `buildFastifyApiRoute` options, or this package's
+ * own `buildFastifyRoute` options.
+ *
+ * Spreading these over options that declare `onConnect` / `onClose` of their own
+ * would silently drop one side or the other; use
+ * {@link CreateSSESessionSpyResult.withSpy} for such routes, which chains both.
+ */
+export type SSESessionSpyRouteOptions<TSession extends SpiedSSESession = ApiSSESession> = {
+    onConnect: (connection: TSession) => void | Promise<void>;
+    onClose: (connection: TSession, initiator: SSECloseInitiator) => void | Promise<void>;
+};
+/**
+ * Result of {@link createSSESessionSpy}.
+ */
+export type CreateSSESessionSpyResult<TSession extends SpiedSSESession = ApiSSESession> = {
+    /** The spy, ready to hand to `SSEHttpClient.connect`'s `awaitServerConnection`. */
+    spy: SSESessionSpy<TSession>;
+    /**
+     * `{ onConnect, onClose }` to spread into the options of a route that declares
+     * no SSE lifecycle hooks of its own. Equivalent to `withSpy()`.
+     */
+    routeOptions: SSESessionSpyRouteOptions<TSession>;
+    /**
+     * Merge the spy's hooks into a route's own options.
+     *
+     * Any `onConnect` / `onClose` the route already declares is kept and runs
+     * first; the spy is notified once that hook settles. Every other option is
+     * passed through untouched. Use this instead of spreading
+     * {@link CreateSSESessionSpyResult.routeOptions}, which would replace the
+     * route's hooks rather than compose with them.
+     *
+     * @example
+     * ```typescript
+     * app.route(
+     *   buildApiRoute(contract, handler, withSpy({
+     *     heartbeat: false,
+     *     onConnect: (connection) => subscriptions.add(connection.id),
+     *   })),
+     * )
+     * ```
+     */
+    withSpy: <TOptions extends object>(options?: TOptions & SSESessionSpyHooks<TSession>) => Omit<TOptions, 'onConnect' | 'onClose'> & SSESessionSpyRouteOptions<TSession>;
+};
+/**
+ * Create a standalone connection spy plus the route hooks that drive it.
+ *
+ * `AbstractSSEController` exposes a spy of its own via `connectionSpy` (gated on
+ * `{ enableConnectionSpy: true }`). Routes built with `buildApiRoute` have no
+ * such controller, so this factory drives a spy from the route's `onConnect` /
+ * `onClose` hooks instead. That removes the race between `connect()` returning
+ * (HTTP headers received) and the server-side handler finishing its connection
+ * registration.
+ *
+ * **The hooks have to be passed to the `buildApiRoute()` call that builds the
+ * route.** The route builder captures them when it constructs the handler, so
+ * attaching them to an already-built `RouteOptions` object has no effect. A
+ * route owned by production code therefore has to accept SSE route options (or
+ * the hooks themselves) as a parameter for a test to be able to spy on it.
+ *
+ * **Only useful for sessions that outlive the handler** — `keepAlive` sessions.
+ * An `autoClose` route closes its session as the handler returns, before the
+ * test can claim it, so `awaitServerConnection` on such a route races and
+ * usually times out. Omit `awaitServerConnection` there and assert on the
+ * events the client received instead.
+ *
+ * The spy observes `@lokalise/fastify-api-contracts` sessions by default, which
+ * is what `buildApiRoute` hands to its hooks. Pass this package's `SSESession`
+ * as the type argument when wiring it to `buildFastifyRoute` instead.
+ *
+ * @example
+ * ```typescript
+ * const { spy, routeOptions } = createSSESessionSpy()
+ *
+ * // in the app-under-test's route registration
+ * app.route(buildApiRoute(contract, handler, { ...routeOptions }))
+ *
+ * // in the test
+ * const { client, serverConnection } = await SSEHttpClient.connect(baseUrl, path, {
+ *   awaitServerConnection: { spy },
+ * })
+ * // serverConnection is registered server-side and ready to use
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Route with lifecycle hooks of its own: compose instead of replacing them
+ * const { spy, withSpy } = createSSESessionSpy()
+ *
+ * app.route(buildApiRoute(contract, handler, withSpy(productionRouteOptions)))
+ * ```
+ */
+export declare function createSSESessionSpy<TSession extends SpiedSSESession = ApiSSESession>(): CreateSSESessionSpyResult<TSession>;