opinionated-machine 10.3.0 → 10.5.0

package/dist/lib/testing/apiSseHttpHelpers.js

@@ -0,0 +1,214 @@
+import { buildRequestPath } from '@lokalise/api-contracts';
+import { describeSendFailures, openSSEDiagnosticsScope, unhandledSendFailures, } from "../sse/sseSendDiagnostics.js";
+import { assertSSEResponse, mediaTypeOf, SSE_CONTENT_TYPE } from "./apiSseEventValidation.js";
+import { SSEHttpClient } from "./sseHttpClient.js";
+/**
+ * A live SSE connection over real HTTP, read through the contract that declares it.
+ *
+ * The contract-typed counterpart of {@link SSEHttpClient}: events arrive incrementally, as
+ * they do there, but each one is JSON-parsed, validated against the contract's `sseResponse` /
+ * `sseBody` schemas and typed as a discriminated union on `event` — the same events
+ * `injectApiSSE` produces, so a suite can move an assertion between the two paths unchanged.
+ */
+export class ApiSSEHttpClient {
+    /** The underlying untyped client, for the parts of it this wrapper doesn't cover. */
+    raw;
+    contract;
+    scope;
+    /** @internal Built by {@link connectApiSSE}. */
+    constructor(raw, contract, scope) {
+        this.raw = raw;
+        this.contract = contract;
+        this.scope = scope;
+    }
+    /**
+     * The fetch `Response`, available before any event is consumed — so status and headers can
+     * be asserted while the handler is still producing events.
+     */
+    get response() {
+        return this.raw.response;
+    }
+    /**
+     * Yield the contract's events as they arrive, typed and validated per event name.
+     *
+     * Throws — before yielding anything — if the endpoint answered with something other than an
+     * event stream (an error raised before `sse.start()`, say), naming its status and body
+     * instead of reporting an empty stream.
+     *
+     * @param signal - Optional `AbortSignal` to stop the generator early
+     *
+     * @example
+     * ```typescript
+     * for await (const event of client.events()) {
+     *   if (event.event === 'issue') expect(event.data.severity).toBe('minor')
+     *   if (event.event === 'review') break
+     * }
+     * ```
+     */
+    async *events(signal) {
+        await this.assertStreamResponse('events()');
+        yield* this.raw.apiEvents(this.contract, signal);
+        if (!signal?.aborted) {
+            // The server ended the stream: anything the handler failed to send is known now, and
+            // is why an expected event never arrived.
+            this.assertNoSendFailures('events()');
+            this.releaseScopeIfClosed();
+        }
+    }
+    /**
+     * Collect events until a count is reached or a predicate matches, each one typed and
+     * validated against the contract.
+     *
+     * A collection that ends short — the stream closed early, or the wait timed out — usually
+     * means the handler failed to send an event it was supposed to; when that is what happened,
+     * the thrown error names the event and its validation issues instead of leaving the test to
+     * report a missing event with no reason.
+     *
+     * Throws straight away if the endpoint answered with something other than an event stream,
+     * rather than waiting out the timeout on a stream that was never going to arrive.
+     *
+     * @param countOrPredicate - Number of events to collect, or a predicate that ends collection
+     *   (the matching event is included). The predicate is invoked exactly once per event.
+     * @param timeout - Maximum time to wait in milliseconds (default: 5000)
+     */
+    async collectEvents(countOrPredicate, timeout) {
+        await this.assertStreamResponse('collectEvents()');
+        // Whether the caller's predicate matched is remembered as it runs, so satisfaction can be
+        // decided afterwards without invoking it a second time on the events it already saw.
+        let matched = false;
+        const target = typeof countOrPredicate === 'number'
+            ? countOrPredicate
+            : (event) => {
+                matched = countOrPredicate(event) || matched;
+                return matched;
+            };
+        let collected;
+        try {
+            collected = await this.raw.collectApiEvents(this.contract, target, timeout);
+        }
+        catch (err) {
+            // The collection failed outright: every recorded failure is context worth reporting,
+            // including the ones the route recovered from.
+            const failures = this.scope.failures();
+            this.releaseScopeIfClosed();
+            if (failures.length === 0) {
+                throw err;
+            }
+            throw new Error(`collectEvents() — ${describeSendFailures(failures)}\nRaised while collecting: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // `collectEvents` also returns short when the server closed the stream before the target
+        // was met, which is exactly what a failed send looks like from here.
+        const satisfied = typeof countOrPredicate === 'number' ? collected.length >= countOrPredicate : matched;
+        if (!satisfied) {
+            this.assertNoSendFailures('collectEvents()');
+        }
+        this.releaseScopeIfClosed();
+        return collected;
+    }
+    /**
+     * Throw what the handler failed to send and did not recover from, if anything was recorded
+     * for this connection.
+     *
+     * A failure the route caught and streamed around left the response it meant to produce, so
+     * it is reported through {@link ApiSSEHttpClient.sendFailures} instead of failing the read.
+     */
+    assertNoSendFailures(reader) {
+        const failures = unhandledSendFailures(this.scope.failures());
+        if (failures.length > 0) {
+            throw new Error(`${reader} — ${describeSendFailures(failures)}`);
+        }
+    }
+    /**
+     * Reject a response that is not an event stream, with its status and body.
+     *
+     * Without this a `401` (or any other pre-stream error response) reads as a stream that
+     * never produced an event: `collectEvents` waits out its full timeout and reports "got 0",
+     * with the actual status nowhere in the failure.
+     */
+    async assertStreamResponse(reader) {
+        const { response } = this.raw;
+        const contentType = response.headers.get('content-type') ?? undefined;
+        let body;
+        if (mediaTypeOf(contentType) !== SSE_CONTENT_TYPE) {
+            // Only read the body once the response is known not to be a stream, and never from the
+            // live response, whose body the client still needs.
+            body = await readBodySnapshot(response);
+            this.scope.dispose();
+        }
+        assertSSEResponse(response.status, contentType, reader, body);
+    }
+    /**
+     * Unregister the diagnostics scope once the stream is over, keeping what it recorded.
+     *
+     * `close()` is the usual trigger; a test that reads a stream to its end and never closes the
+     * client would otherwise leave the scope registered for the rest of the process.
+     */
+    releaseScopeIfClosed() {
+        if (this.raw.isClosed) {
+            this.scope.dispose();
+        }
+    }
+    /**
+     * The sends the handler could not make on this connection — a payload that failed the
+     * contract's schema for its event, say — recorded instead of being left in the server log.
+     *
+     * Includes the failures the route recovered from (`handled: true`), which the readers pass
+     * over precisely because the response was still the one the route meant to produce.
+     *
+     * Only routes built with this package's `buildApiRoute` report them.
+     */
+    sendFailures() {
+        return this.scope.failures();
+    }
+    /** Close the connection from the client side. */
+    close() {
+        this.scope.dispose();
+        this.raw.close();
+    }
+}
+/** The body of a non-stream response, for an error message; never worth failing over. */
+async function readBodySnapshot(response) {
+    try {
+        return await response.clone().text();
+    }
+    catch {
+        // Already consumed, or aborted mid-read: the status and content-type still say enough.
+        return undefined;
+    }
+}
+export async function connectApiSSE(baseUrl, contract, params, options) {
+    // biome-ignore lint/suspicious/noExplicitAny: params shape depends on the contract
+    const requestParams = params;
+    const path = buildRequestPath(contract.pathResolver(requestParams.pathParams), requestParams.pathPrefix);
+    // `headers` may be a factory, exactly as the contract client and `injectApiSSE` accept it.
+    const callerHeaders = typeof requestParams.headers === 'function'
+        ? await requestParams.headers()
+        : requestParams.headers;
+    // Records the sends the handler could not make, matched to this connection by a header the
+    // route builder honours only for scopes open in this process.
+    const scope = openSSEDiagnosticsScope();
+    const connectOptions = {
+        method: contract.method,
+        headers: { ...callerHeaders, ...scope.headers },
+        ...(requestParams.queryParams !== undefined && { query: requestParams.queryParams }),
+        ...(requestParams.body !== undefined && { body: requestParams.body }),
+    };
+    // A connection that never happened has no reader to dispose its scope later, and a scope
+    // left registered outlives the test that opened it.
+    try {
+        if (!options) {
+            const raw = await SSEHttpClient.connect(baseUrl, path, connectOptions);
+            return new ApiSSEHttpClient(raw, contract, scope);
+        }
+        const { client: raw, serverConnection } = await SSEHttpClient.connect(baseUrl, path, {
+            ...connectOptions,
+            awaitServerConnection: options.awaitServerConnection,
+        });
+        return { client: new ApiSSEHttpClient(raw, contract, scope), serverConnection };
+    }
+    catch (error) {
+        scope.dispose();
+        throw error;
+    }
+}
+//# sourceMappingURL=apiSseHttpHelpers.js.map

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

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

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

@@ -31,8 +31,12 @@ export declare function bindApiEvents<Contract extends ApiContract>(contract: Co
  * statuses expose no JSON body through `bodyForStatus`; read them with `events()`, or use
  * `injectByApiContract` when you want the JSON side.
  *
- * Best for SSE endpoints that complete — Fastify's `inject()` waits for the whole response.
- * For long-lived connections, use `SSEHttpClient` against a real HTTP server.
+ * The response is injected as a stream, so `head` resolves as soon as the handler starts
+ * streaming and `stream()` yields each event as it is written — a test can assert
+ * progressive delivery without a listening server. `closed` and `events()` still wait for
+ * the response to complete, so an endpoint that never closes its stream (a `keepAlive`
+ * session) can only be read through `stream()`; use `SSEHttpClient` / `connectApiSSE`
+ * against a real server for those.
  *
  * @param app - Fastify instance
  * @param contract - Contract built with `defineApiContract`
@@ -55,6 +59,17 @@ export declare function bindApiEvents<Contract extends ApiContract>(contract: Co
  *
  * @example
  * ```typescript
+ * // Progressive delivery: each event is observed while the handler is still working
+ * const { head, stream } = injectApiSSE(app, lqaTextSegmentContract, { body: { segment } })
+ * expect((await head).statusCode).toBe(200)
+ *
+ * for await (const event of stream()) {
+ *   if (event.event === 'issue') expect(handlerFinished).toBe(false)
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
  * // A documented pre-stream error response, typed by the contract's 400 schema
  * const { bodyForStatus } = injectApiSSE(app, lqaTextSegmentContract, { body: { segment: '' } })
  * const error = await bodyForStatus(400)

package/dist/lib/testing/apiSseInjectHelpers.js

@@ -1,16 +1,19 @@
-import { getSseSchemaByEventName, resolveResponseEntry, } from '@lokalise/api-contracts';
-import { injectByApiContract } from '@lokalise/fastify-api-contracts';
-import { parseSSEEvents } from "../sse/sseParser.js";
+import { buildRequestPath, resolveResponseEntry, } from '@lokalise/api-contracts';
+import { parseSSEBuffer, parseSSEEvents } from "../sse/sseParser.js";
+import { describeSendFailures, openSSEDiagnosticsScope, unhandledSendFailures, } from "../sse/sseSendDiagnostics.js";
+import { assertSSEResponse, mediaTypeOf, resolveApiSseSchemas, SSE_CONTENT_TYPE, validateApiSseEvent, } from "./apiSseEventValidation.js";
 import { truncateBody } from "./sseInjectShared.js";
-const SSE_CONTENT_TYPE = 'text/event-stream';
+/**
+ * Methods whose contracts can declare a request body.
+ *
+ * Exactly the methods of `PayloadApiContract`; `GetApiContract` and `DeleteApiContract` type
+ * `requestBodySchema` as `never`, so no contract can declare a body for any other verb.
+ */
+const METHODS_WITH_BODY = new Set(['POST', 'PUT', 'PATCH']);
 /** Read a response header that light-my-request may expose as an array. */
 function readHeader(value) {
     return Array.isArray(value) ? value[0] : value;
 }
-/** Strip `; charset=…` style parameters from a media type. */
-function mediaTypeOf(contentType) {
-    return contentType?.split(';')[0]?.trim().toLowerCase();
-}
 const STATUS_RANGE_KEYS = ['1xx', '2xx', '3xx', '4xx', '5xx'];
 /**
  * The `responsesByStatusCode` key that serves a status, following the same
@@ -93,6 +96,10 @@ export function bindApiBodyForStatus(contract, closed) {
         return parseJsonBody(schema, expected, res.body);
     });
 }
+/** Reject a response that is not an event stream, naming the reader that asked for one. */
+function assertSSEHead(head, reader, body) {
+    assertSSEResponse(head.statusCode, readHeader(head.headers['content-type']), reader, body);
+}
 /**
  * Build an `events` accessor bound to one `injectApiSSE` call: parses the SSE body and
  * validates every event against the contract's `sseBody` schemas.
@@ -103,40 +110,156 @@ export function bindApiEvents(contract, closed) {
     return async () => {
         const res = await closed;
         // Merges the SSE schemas of every declared status, not just the successful ones.
-        const schemaByEventName = getSseSchemaByEventName(contract);
-        if (!schemaByEventName) {
-            throw new Error('events() — the contract declares no SSE response');
+        const schemaByEventName = resolveApiSseSchemas(contract, 'events()');
+        assertSSEHead(res, 'events()', res.body);
+        return parseSSEEvents(res.body).map((event) => validateApiSseEvent(schemaByEventName, event, 'events()'));
+    };
+}
+/**
+ * Consumes an injected SSE response as it is written, so events can be read while the handler
+ * is still running and the completed body is still available afterwards.
+ *
+ * Fastify's `inject({ payloadAsStream: true })` resolves as soon as the response head is on
+ * the wire — for a streaming handler, at `sse.start()` — and exposes the payload as a
+ * `Readable` that receives every write. This pump drains it eagerly (so a slow or absent
+ * consumer never blocks the handler), keeping both the parsed events seen so far and the raw
+ * body text, and wakes any generator waiting on more.
+ */
+class InjectedSSEStream {
+    /** Head of the response, available before the handler finished streaming. */
+    head;
+    /** Full response, once the stream ended. */
+    closed;
+    received = [];
+    waiters = [];
+    ended = false;
+    failure;
+    constructor(injected) {
+        this.head = injected.then((res) => ({
+            statusCode: res.statusCode,
+            headers: res.headers,
+        }));
+        this.closed = this.drain(injected);
+        // The pump owns both promises from the moment the request is injected; a caller reading
+        // only one of them (or neither, for a request it expects to fail) must not turn the other
+        // into an unhandled rejection. Awaiting either still rejects as usual.
+        this.head.catch(() => { });
+        this.closed.catch(() => { });
+    }
+    async drain(injected) {
+        let res;
+        try {
+            res = await injected;
         }
-        const contentType = mediaTypeOf(readHeader(res.headers['content-type']));
-        if (contentType !== SSE_CONTENT_TYPE) {
-            throw new Error(`events() — response is not an SSE stream (status ${res.statusCode}, content-type ${contentType ?? 'absent'}); use bodyForStatus(${res.statusCode}) for declared error responses. Body: ${truncateBody(res.body)}`);
+        catch (err) {
+            this.fail(err);
+            throw err;
         }
-        return parseSSEEvents(res.body).map((event) => {
-            // An SSE event without an `event:` field is a `message` event per the spec.
-            const name = event.event ?? 'message';
-            const schema = schemaByEventName[name];
-            if (!schema) {
-                throw new Error(`events() — the contract declares no schema for event "${name}"`);
+        let body = '';
+        let buffer = '';
+        const decoder = new TextDecoder();
+        try {
+            for await (const chunk of res.stream()) {
+                const text = typeof chunk === 'string' ? chunk : decoder.decode(chunk, { stream: true });
+                body += text;
+                buffer += text;
+                const { events, remaining } = parseSSEBuffer(buffer);
+                buffer = remaining;
+                if (events.length > 0) {
+                    this.received.push(...events);
+                    this.notify();
+                }
             }
-            let parsedJson;
-            try {
-                parsedJson = JSON.parse(event.data);
+        }
+        catch (err) {
+            this.fail(err);
+            throw err;
+        }
+        // A stream that ended without a terminating blank line still carries one last event.
+        const trailing = parseSSEEvents(buffer);
+        if (trailing.length > 0) {
+            this.received.push(...trailing);
+        }
+        this.ended = true;
+        this.notify();
+        return {
+            statusCode: res.statusCode,
+            headers: res.headers,
+            body,
+        };
+    }
+    fail(err) {
+        this.failure = err;
+        this.ended = true;
+        this.notify();
+    }
+    notify() {
+        const waiters = this.waiters;
+        this.waiters = [];
+        for (const wake of waiters) {
+            wake();
+        }
+    }
+    /** Resolve once more events arrived, the stream ended, or the caller aborted. */
+    nextTick(signal) {
+        return new Promise((resolve) => {
+            let settled = false;
+            const wake = () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                signal?.removeEventListener('abort', wake);
+                resolve();
+            };
+            this.waiters.push(wake);
+            signal?.addEventListener('abort', wake, { once: true });
+        });
+    }
+    /**
+     * Yield every event of the stream, from the first one, waiting for more while the handler
+     * is still writing. Replayable: each call starts from the beginning of the stream.
+     */
+    async *events(signal) {
+        let index = 0;
+        while (true) {
+            if (signal?.aborted) {
+                return;
             }
-            catch (err) {
-                throw new Error(`events() — data of event "${name}" is not valid JSON: ${err.message}; data: ${truncateBody(event.data)}`);
+            while (index < this.received.length) {
+                // biome-ignore lint/style/noNonNullAssertion: index is bounded by the array length
+                yield this.received[index++];
+                if (signal?.aborted) {
+                    return;
+                }
             }
-            const parsed = schema.safeParse(parsedJson);
-            if (!parsed.success) {
-                throw new Error(`events() — data of event "${name}" does not match the declared schema: ${parsed.error.message}; data: ${truncateBody(event.data)}`);
+            if (this.failure) {
+                throw this.failure;
             }
-            return {
-                ...(event.id !== undefined && { id: event.id }),
-                ...(event.retry !== undefined && { retry: event.retry }),
-                event: name,
-                data: parsed.data,
-            };
-        });
-    };
+            if (this.ended) {
+                return;
+            }
+            await this.nextTick(signal);
+        }
+    }
+}
+/**
+ * Throw the sends the route could not make and did not recover from, if any were recorded for
+ * this request.
+ *
+ * A payload that fails the contract's schema for its event makes `session.send()` throw
+ * inside the handler; the event never reaches the wire and the reason only reaches the server
+ * log. Reading the stream through these helpers surfaces it here instead, so the test fails
+ * on the event that was never sent rather than on the next one it did receive.
+ */
+function assertNoSendFailures(scope, reader) {
+    // A failure the route caught and streamed around is context, not a verdict: the response
+    // the test read is the one the route meant to produce. Only the failures that truncated it
+    // explain a missing event, so only those fail the read — the rest stay on `sendFailures()`.
+    const failures = unhandledSendFailures(scope.failures());
+    if (failures.length > 0) {
+        throw new Error(`${reader} — ${describeSendFailures(failures)}`);
+    }
 }
 /**
  * Inject an SSE request using a contract built with `defineApiContract` + `sseResponse` /
@@ -153,8 +276,12 @@ export function bindApiEvents(contract, closed) {
  * statuses expose no JSON body through `bodyForStatus`; read them with `events()`, or use
  * `injectByApiContract` when you want the JSON side.
  *
- * Best for SSE endpoints that complete — Fastify's `inject()` waits for the whole response.
- * For long-lived connections, use `SSEHttpClient` against a real HTTP server.
+ * The response is injected as a stream, so `head` resolves as soon as the handler starts
+ * streaming and `stream()` yields each event as it is written — a test can assert
+ * progressive delivery without a listening server. `closed` and `events()` still wait for
+ * the response to complete, so an endpoint that never closes its stream (a `keepAlive`
+ * session) can only be read through `stream()`; use `SSEHttpClient` / `connectApiSSE`
+ * against a real server for those.
  *
  * @param app - Fastify instance
  * @param contract - Contract built with `defineApiContract`
@@ -177,6 +304,17 @@ export function bindApiEvents(contract, closed) {
  *
  * @example
  * ```typescript
+ * // Progressive delivery: each event is observed while the handler is still working
+ * const { head, stream } = injectApiSSE(app, lqaTextSegmentContract, { body: { segment } })
+ * expect((await head).statusCode).toBe(200)
+ *
+ * for await (const event of stream()) {
+ *   if (event.event === 'issue') expect(handlerFinished).toBe(false)
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
  * // A documented pre-stream error response, typed by the contract's 400 schema
  * const { bodyForStatus } = injectApiSSE(app, lqaTextSegmentContract, { body: { segment: '' } })
  * const error = await bodyForStatus(400)
@@ -186,27 +324,60 @@ export function bindApiEvents(contract, closed) {
 export function injectApiSSE(app, contract, params) {
     // biome-ignore lint/suspicious/noExplicitAny: params shape depends on the contract
     const requestParams = params;
-    const closed = injectByApiContract(app, contract, {
-        ...requestParams,
-        // `accept` first so an explicit caller header still wins; headers may be a factory,
-        // which `injectByApiContract` resolves for us — resolve the caller's here too.
-        headers: async () => ({
-            accept: SSE_CONTENT_TYPE,
-            ...(typeof requestParams.headers === 'function'
-                ? await requestParams.headers()
-                : requestParams.headers),
-        }),
-    }).then((res) => ({
-        statusCode: res.statusCode,
-        headers: res.headers,
-        body: res.body,
-    }));
+    const method = contract.method.toUpperCase();
+    const url = buildRequestPath(contract.pathResolver(requestParams.pathParams), requestParams.pathPrefix);
+    // Records the sends the handler could not make (a payload that failed its event schema),
+    // matched to this request by a header the route builder honours only for open scopes.
+    const scope = openSSEDiagnosticsScope();
+    const injected = (async () => {
+        // `headers` may be a factory, exactly as `injectByApiContract` accepts it.
+        const callerHeaders = typeof requestParams.headers === 'function'
+            ? await requestParams.headers()
+            : requestParams.headers;
+        return app.inject({
+            method,
+            url,
+            // `accept` first so an explicit caller header still wins; the diagnostics header last,
+            // since it addresses this call's scope and nothing else may claim it.
+            headers: { accept: SSE_CONTENT_TYPE, ...callerHeaders, ...scope.headers },
+            ...(requestParams.queryParams !== undefined && { query: requestParams.queryParams }),
+            ...(METHODS_WITH_BODY.has(method) && { payload: requestParams.body }),
+            payloadAsStream: true,
+        });
+    })();
+    const pump = new InjectedSSEStream(injected);
+    const { head, closed } = pump;
+    // Failures are only complete once the response is, and the scope must not outlive the
+    // request either way; disposing snapshots what was recorded, so the readers below still
+    // report it afterwards.
+    void closed.then(() => scope.dispose(), () => scope.dispose());
+    const bufferedEvents = bindApiEvents(contract, closed);
+    const events = async () => {
+        await closed;
+        assertNoSendFailures(scope, 'events()');
+        return bufferedEvents();
+    };
+    const stream = async function* (signal) {
+        const schemaByEventName = resolveApiSseSchemas(contract, 'stream()');
+        assertSSEHead(await head, 'stream()');
+        for await (const event of pump.events(signal)) {
+            yield validateApiSseEvent(schemaByEventName, event, 'stream()');
+        }
+        if (!signal?.aborted) {
+            // The stream ended: anything the handler failed to send is known now, and is the
+            // reason an expected event never arrived.
+            assertNoSendFailures(scope, 'stream()');
+        }
+    };
     return {
         closed,
+        head,
+        sendFailures: () => scope.failures(),
         bodyForStatus: bindApiBodyForStatus(contract, closed),
-        // `events` is typed `never` for contracts that declare no SSE response, which no concrete
-        // function satisfies — the binder returns the callable form and it is narrowed here.
-        events: bindApiEvents(contract, closed),
+        // `events` / `stream` are typed `never` for contracts that declare no SSE response, which
+        // no concrete function satisfies — the callable forms are narrowed here.
+        events: events,
+        stream: stream,
     };
 }
 //# sourceMappingURL=apiSseInjectHelpers.js.map

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

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