msw 2.11.5 → 2.12.0

package/lib/core/index.d.mts

@@ -5,6 +5,7 @@ export { HttpCustomPredicate, HttpHandler, HttpMethods, HttpRequestParsedResult,
 export { GraphQLRequestHandler, GraphQLResponseResolver, graphql } from './graphql.mjs';
 export { WebSocketEventListener, WebSocketLink, ws } from './ws.mjs';
 export { WebSocketHandler, WebSocketHandlerConnection, WebSocketHandlerEventMap } from './handlers/WebSocketHandler.mjs';
+export { ServerSentEventMessage, ServerSentEventRequestHandler, ServerSentEventResolver, ServerSentEventResolverExtras, sse } from './sse.mjs';
 export { Match, Path, PathParams, matchRequestUrl } from './utils/matching/matchRequestUrl.mjs';
 export { HandleRequestOptions, handleRequest } from './utils/handleRequest.mjs';
 export { UnhandledRequestCallback, UnhandledRequestStrategy, onUnhandledRequest } from './utils/request/onUnhandledRequest.mjs';

package/lib/core/index.d.ts

@@ -5,6 +5,7 @@ export { HttpCustomPredicate, HttpHandler, HttpMethods, HttpRequestParsedResult,
 export { GraphQLRequestHandler, GraphQLResponseResolver, graphql } from './graphql.js';
 export { WebSocketEventListener, WebSocketLink, ws } from './ws.js';
 export { WebSocketHandler, WebSocketHandlerConnection, WebSocketHandlerEventMap } from './handlers/WebSocketHandler.js';
+export { ServerSentEventMessage, ServerSentEventRequestHandler, ServerSentEventResolver, ServerSentEventResolverExtras, sse } from './sse.js';
 export { Match, Path, PathParams, matchRequestUrl } from './utils/matching/matchRequestUrl.js';
 export { HandleRequestOptions, handleRequest } from './utils/handleRequest.js';
 export { UnhandledRequestCallback, UnhandledRequestStrategy, onUnhandledRequest } from './utils/request/onUnhandledRequest.js';

package/lib/core/index.js

@@ -34,6 +34,7 @@ __export(index_exports, {
   matchRequestUrl: () => import_matchRequestUrl.matchRequestUrl,
   onUnhandledRequest: () => import_onUnhandledRequest.onUnhandledRequest,
   passthrough: () => import_passthrough.passthrough,
+  sse: () => import_sse.sse,
   ws: () => import_ws.ws
 });
 module.exports = __toCommonJS(index_exports);
@@ -46,6 +47,7 @@ var import_graphql = require("./graphql");
 var import_GraphQLHandler = require("./handlers/GraphQLHandler");
 var import_ws = require("./ws");
 var import_WebSocketHandler = require("./handlers/WebSocketHandler");
+var import_sse = require("./sse");
 var import_matchRequestUrl = require("./utils/matching/matchRequestUrl");
 __reExport(index_exports, require("./utils/handleRequest"), module.exports);
 var import_onUnhandledRequest = require("./utils/request/onUnhandledRequest");

package/lib/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["import { checkGlobals } from './utils/internal/checkGlobals'\n\nexport { SetupApi } from './SetupApi'\n\n/* HTTP handlers */\nexport { RequestHandler } from './handlers/RequestHandler'\nexport { http } from './http'\nexport { HttpHandler, HttpMethods } from './handlers/HttpHandler'\nexport { graphql } from './graphql'\nexport { GraphQLHandler } from './handlers/GraphQLHandler'\n\n/* WebSocket handler */\nexport { ws, type WebSocketLink } from './ws'\nexport {\n  WebSocketHandler,\n  type WebSocketHandlerEventMap,\n  type WebSocketHandlerConnection,\n} from './handlers/WebSocketHandler'\n\n/* Utils */\nexport { matchRequestUrl } from './utils/matching/matchRequestUrl'\nexport * from './utils/handleRequest'\nexport {\n  onUnhandledRequest,\n  type UnhandledRequestStrategy,\n  type UnhandledRequestCallback,\n} from './utils/request/onUnhandledRequest'\nexport { getResponse } from './getResponse'\nexport { cleanUrl } from './utils/url/cleanUrl'\n\n/**\n * Type definitions.\n */\n\nexport type { SharedOptions, LifeCycleEventsMap } from './sharedOptions'\n\nexport type {\n  ResponseResolver,\n  ResponseResolverReturnType,\n  AsyncResponseResolverReturnType,\n  RequestHandlerOptions,\n  DefaultBodyType,\n  DefaultRequestMultipartBody,\n  JsonBodyType,\n} from './handlers/RequestHandler'\n\nexport type {\n  RequestQuery,\n  HttpRequestParsedResult,\n  HttpCustomPredicate,\n} from './handlers/HttpHandler'\nexport type { HttpRequestHandler, HttpResponseResolver } from './http'\n\nexport type {\n  GraphQLQuery,\n  GraphQLVariables,\n  GraphQLRequestBody,\n  GraphQLResponseBody,\n  GraphQLJsonRequestBody,\n  GraphQLOperationType,\n  GraphQLCustomPredicate,\n} from './handlers/GraphQLHandler'\nexport type { GraphQLRequestHandler, GraphQLResponseResolver } from './graphql'\n\nexport type { WebSocketData, WebSocketEventListener } from './ws'\n\nexport type { Path, PathParams, Match } from './utils/matching/matchRequestUrl'\nexport type { ParsedGraphQLRequest } from './utils/internal/parseGraphQLRequest'\n\nexport * from './HttpResponse'\nexport * from './delay'\nexport { bypass } from './bypass'\nexport { passthrough } from './passthrough'\nexport { isCommonAssetRequest } from './isCommonAssetRequest'\n\n// Validate environmental globals before executing any code.\n// This ensures that the library gives user-friendly errors\n// when ran in the environments that require additional polyfills\n// from the end user.\ncheckGlobals()\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAA6B;AAE7B,sBAAyB;AAGzB,4BAA+B;AAC/B,kBAAqB;AACrB,yBAAyC;AACzC,qBAAwB;AACxB,4BAA+B;AAG/B,gBAAuC;AACvC,8BAIO;AAGP,6BAAgC;AAChC,0BAAc,kCArBd;AAsBA,gCAIO;AACP,yBAA4B;AAC5B,sBAAyB;AAyCzB,0BAAc,2BArEd;AAsEA,0BAAc,oBAtEd;AAuEA,oBAAuB;AACvB,yBAA4B;AAC5B,kCAAqC;AAAA,IAMrC,kCAAa;","names":[]}
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["import { checkGlobals } from './utils/internal/checkGlobals'\n\nexport { SetupApi } from './SetupApi'\n\n/* HTTP handlers */\nexport { RequestHandler } from './handlers/RequestHandler'\nexport { http } from './http'\nexport { HttpHandler, HttpMethods } from './handlers/HttpHandler'\nexport { graphql } from './graphql'\nexport { GraphQLHandler } from './handlers/GraphQLHandler'\n\n/* WebSocket handler */\nexport { ws, type WebSocketLink } from './ws'\nexport {\n  WebSocketHandler,\n  type WebSocketHandlerEventMap,\n  type WebSocketHandlerConnection,\n} from './handlers/WebSocketHandler'\n\n/* Server-Sent Events */\nexport {\n  sse,\n  type ServerSentEventRequestHandler,\n  type ServerSentEventResolver,\n  type ServerSentEventResolverExtras,\n  type ServerSentEventMessage,\n} from './sse'\n\n/* Utils */\nexport { matchRequestUrl } from './utils/matching/matchRequestUrl'\nexport * from './utils/handleRequest'\nexport {\n  onUnhandledRequest,\n  type UnhandledRequestStrategy,\n  type UnhandledRequestCallback,\n} from './utils/request/onUnhandledRequest'\nexport { getResponse } from './getResponse'\nexport { cleanUrl } from './utils/url/cleanUrl'\n\n/**\n * Type definitions.\n */\n\nexport type { SharedOptions, LifeCycleEventsMap } from './sharedOptions'\n\nexport type {\n  ResponseResolver,\n  ResponseResolverReturnType,\n  AsyncResponseResolverReturnType,\n  RequestHandlerOptions,\n  DefaultBodyType,\n  DefaultRequestMultipartBody,\n  JsonBodyType,\n} from './handlers/RequestHandler'\n\nexport type {\n  RequestQuery,\n  HttpRequestParsedResult,\n  HttpCustomPredicate,\n} from './handlers/HttpHandler'\nexport type { HttpRequestHandler, HttpResponseResolver } from './http'\n\nexport type {\n  GraphQLQuery,\n  GraphQLVariables,\n  GraphQLRequestBody,\n  GraphQLResponseBody,\n  GraphQLJsonRequestBody,\n  GraphQLOperationType,\n  GraphQLCustomPredicate,\n} from './handlers/GraphQLHandler'\nexport type { GraphQLRequestHandler, GraphQLResponseResolver } from './graphql'\n\nexport type { WebSocketData, WebSocketEventListener } from './ws'\n\nexport type { Path, PathParams, Match } from './utils/matching/matchRequestUrl'\nexport type { ParsedGraphQLRequest } from './utils/internal/parseGraphQLRequest'\n\nexport * from './HttpResponse'\nexport * from './delay'\nexport { bypass } from './bypass'\nexport { passthrough } from './passthrough'\nexport { isCommonAssetRequest } from './isCommonAssetRequest'\n\n// Validate environmental globals before executing any code.\n// This ensures that the library gives user-friendly errors\n// when ran in the environments that require additional polyfills\n// from the end user.\ncheckGlobals()\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAA6B;AAE7B,sBAAyB;AAGzB,4BAA+B;AAC/B,kBAAqB;AACrB,yBAAyC;AACzC,qBAAwB;AACxB,4BAA+B;AAG/B,gBAAuC;AACvC,8BAIO;AAGP,iBAMO;AAGP,6BAAgC;AAChC,0BAAc,kCA9Bd;AA+BA,gCAIO;AACP,yBAA4B;AAC5B,sBAAyB;AAyCzB,0BAAc,2BA9Ed;AA+EA,0BAAc,oBA/Ed;AAgFA,oBAAuB;AACvB,yBAA4B;AAC5B,kCAAqC;AAAA,IAMrC,kCAAa;","names":[]}

package/lib/core/index.mjs

@@ -9,6 +9,9 @@ import { ws } from './ws.mjs';
 import {
   WebSocketHandler
 } from './handlers/WebSocketHandler.mjs';
+import {
+  sse
+} from './sse.mjs';
 import { matchRequestUrl } from './utils/matching/matchRequestUrl.mjs';
 export * from './utils/handleRequest.mjs';
 import {
@@ -38,6 +41,7 @@ export {
   matchRequestUrl,
   onUnhandledRequest,
   passthrough,
+  sse,
   ws
 };
 //# sourceMappingURL=index.mjs.map

package/lib/core/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["import { checkGlobals } from './utils/internal/checkGlobals'\n\nexport { SetupApi } from './SetupApi'\n\n/* HTTP handlers */\nexport { RequestHandler } from './handlers/RequestHandler'\nexport { http } from './http'\nexport { HttpHandler, HttpMethods } from './handlers/HttpHandler'\nexport { graphql } from './graphql'\nexport { GraphQLHandler } from './handlers/GraphQLHandler'\n\n/* WebSocket handler */\nexport { ws, type WebSocketLink } from './ws'\nexport {\n  WebSocketHandler,\n  type WebSocketHandlerEventMap,\n  type WebSocketHandlerConnection,\n} from './handlers/WebSocketHandler'\n\n/* Utils */\nexport { matchRequestUrl } from './utils/matching/matchRequestUrl'\nexport * from './utils/handleRequest'\nexport {\n  onUnhandledRequest,\n  type UnhandledRequestStrategy,\n  type UnhandledRequestCallback,\n} from './utils/request/onUnhandledRequest'\nexport { getResponse } from './getResponse'\nexport { cleanUrl } from './utils/url/cleanUrl'\n\n/**\n * Type definitions.\n */\n\nexport type { SharedOptions, LifeCycleEventsMap } from './sharedOptions'\n\nexport type {\n  ResponseResolver,\n  ResponseResolverReturnType,\n  AsyncResponseResolverReturnType,\n  RequestHandlerOptions,\n  DefaultBodyType,\n  DefaultRequestMultipartBody,\n  JsonBodyType,\n} from './handlers/RequestHandler'\n\nexport type {\n  RequestQuery,\n  HttpRequestParsedResult,\n  HttpCustomPredicate,\n} from './handlers/HttpHandler'\nexport type { HttpRequestHandler, HttpResponseResolver } from './http'\n\nexport type {\n  GraphQLQuery,\n  GraphQLVariables,\n  GraphQLRequestBody,\n  GraphQLResponseBody,\n  GraphQLJsonRequestBody,\n  GraphQLOperationType,\n  GraphQLCustomPredicate,\n} from './handlers/GraphQLHandler'\nexport type { GraphQLRequestHandler, GraphQLResponseResolver } from './graphql'\n\nexport type { WebSocketData, WebSocketEventListener } from './ws'\n\nexport type { Path, PathParams, Match } from './utils/matching/matchRequestUrl'\nexport type { ParsedGraphQLRequest } from './utils/internal/parseGraphQLRequest'\n\nexport * from './HttpResponse'\nexport * from './delay'\nexport { bypass } from './bypass'\nexport { passthrough } from './passthrough'\nexport { isCommonAssetRequest } from './isCommonAssetRequest'\n\n// Validate environmental globals before executing any code.\n// This ensures that the library gives user-friendly errors\n// when ran in the environments that require additional polyfills\n// from the end user.\ncheckGlobals()\n"],"mappings":"AAAA,SAAS,oBAAoB;AAE7B,SAAS,gBAAgB;AAGzB,SAAS,sBAAsB;AAC/B,SAAS,YAAY;AACrB,SAAS,aAAa,mBAAmB;AACzC,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAG/B,SAAS,UAA8B;AACvC;AAAA,EACE;AAAA,OAGK;AAGP,SAAS,uBAAuB;AAChC,cAAc;AACd;AAAA,EACE;AAAA,OAGK;AACP,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAyCzB,cAAc;AACd,cAAc;AACd,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAC5B,SAAS,4BAA4B;AAMrC,aAAa;","names":[]}
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["import { checkGlobals } from './utils/internal/checkGlobals'\n\nexport { SetupApi } from './SetupApi'\n\n/* HTTP handlers */\nexport { RequestHandler } from './handlers/RequestHandler'\nexport { http } from './http'\nexport { HttpHandler, HttpMethods } from './handlers/HttpHandler'\nexport { graphql } from './graphql'\nexport { GraphQLHandler } from './handlers/GraphQLHandler'\n\n/* WebSocket handler */\nexport { ws, type WebSocketLink } from './ws'\nexport {\n  WebSocketHandler,\n  type WebSocketHandlerEventMap,\n  type WebSocketHandlerConnection,\n} from './handlers/WebSocketHandler'\n\n/* Server-Sent Events */\nexport {\n  sse,\n  type ServerSentEventRequestHandler,\n  type ServerSentEventResolver,\n  type ServerSentEventResolverExtras,\n  type ServerSentEventMessage,\n} from './sse'\n\n/* Utils */\nexport { matchRequestUrl } from './utils/matching/matchRequestUrl'\nexport * from './utils/handleRequest'\nexport {\n  onUnhandledRequest,\n  type UnhandledRequestStrategy,\n  type UnhandledRequestCallback,\n} from './utils/request/onUnhandledRequest'\nexport { getResponse } from './getResponse'\nexport { cleanUrl } from './utils/url/cleanUrl'\n\n/**\n * Type definitions.\n */\n\nexport type { SharedOptions, LifeCycleEventsMap } from './sharedOptions'\n\nexport type {\n  ResponseResolver,\n  ResponseResolverReturnType,\n  AsyncResponseResolverReturnType,\n  RequestHandlerOptions,\n  DefaultBodyType,\n  DefaultRequestMultipartBody,\n  JsonBodyType,\n} from './handlers/RequestHandler'\n\nexport type {\n  RequestQuery,\n  HttpRequestParsedResult,\n  HttpCustomPredicate,\n} from './handlers/HttpHandler'\nexport type { HttpRequestHandler, HttpResponseResolver } from './http'\n\nexport type {\n  GraphQLQuery,\n  GraphQLVariables,\n  GraphQLRequestBody,\n  GraphQLResponseBody,\n  GraphQLJsonRequestBody,\n  GraphQLOperationType,\n  GraphQLCustomPredicate,\n} from './handlers/GraphQLHandler'\nexport type { GraphQLRequestHandler, GraphQLResponseResolver } from './graphql'\n\nexport type { WebSocketData, WebSocketEventListener } from './ws'\n\nexport type { Path, PathParams, Match } from './utils/matching/matchRequestUrl'\nexport type { ParsedGraphQLRequest } from './utils/internal/parseGraphQLRequest'\n\nexport * from './HttpResponse'\nexport * from './delay'\nexport { bypass } from './bypass'\nexport { passthrough } from './passthrough'\nexport { isCommonAssetRequest } from './isCommonAssetRequest'\n\n// Validate environmental globals before executing any code.\n// This ensures that the library gives user-friendly errors\n// when ran in the environments that require additional polyfills\n// from the end user.\ncheckGlobals()\n"],"mappings":"AAAA,SAAS,oBAAoB;AAE7B,SAAS,gBAAgB;AAGzB,SAAS,sBAAsB;AAC/B,SAAS,YAAY;AACrB,SAAS,aAAa,mBAAmB;AACzC,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAG/B,SAAS,UAA8B;AACvC;AAAA,EACE;AAAA,OAGK;AAGP;AAAA,EACE;AAAA,OAKK;AAGP,SAAS,uBAAuB;AAChC,cAAc;AACd;AAAA,EACE;AAAA,OAGK;AACP,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAyCzB,cAAc;AACd,cAAc;AACd,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAC5B,SAAS,4BAA4B;AAMrC,aAAa;","names":[]}

package/lib/core/sse.d.mts

@@ -0,0 +1,116 @@
+import { Emitter } from 'strict-event-emitter';
+import { a as ResponseResolver } from './HttpResponse-DGUjNQHG.mjs';
+import { HttpRequestResolverExtras, HttpHandler } from './handlers/HttpHandler.mjs';
+import { PathParams, Path } from './utils/matching/matchRequestUrl.mjs';
+import '@mswjs/interceptors';
+import './utils/internal/isIterable.mjs';
+import './typeUtils.mjs';
+import 'graphql';
+
+type EventMapConstraint = {
+    message?: unknown;
+    [key: string]: unknown;
+    [key: symbol | number]: never;
+};
+type ServerSentEventResolverExtras<EventMap extends EventMapConstraint, Params extends PathParams> = HttpRequestResolverExtras<Params> & {
+    client: ServerSentEventClient<EventMap>;
+    server: ServerSentEventServer;
+};
+type ServerSentEventResolver<EventMap extends EventMapConstraint, Params extends PathParams> = ResponseResolver<ServerSentEventResolverExtras<EventMap, Params>, any, any>;
+type ServerSentEventRequestHandler = <EventMap extends EventMapConstraint = {
+    message: unknown;
+}, Params extends PathParams<keyof Params> = PathParams, RequestPath extends Path = Path>(path: RequestPath, resolver: ServerSentEventResolver<EventMap, Params>) => HttpHandler;
+type ServerSentEventMessage<EventMap extends EventMapConstraint = {
+    message: unknown;
+}> = ToEventDiscriminatedUnion<EventMap & {
+    message: unknown;
+}> | {
+    id?: never;
+    event?: never;
+    data?: never;
+    retry: number;
+};
+/**
+ * Intercept Server-Sent Events (SSE).
+ *
+ * @example
+ * sse('http://localhost:4321', ({ client }) => {
+ *   client.send({ data: 'hello world' })
+ * })
+ *
+ * @see {@link https://mswjs.io/docs/sse/ Mocking Server-Sent Events}
+ * @see {@link https://mswjs.io/docs/api/sse `sse()` API reference}
+ */
+declare const sse: ServerSentEventRequestHandler;
+type Values<T> = T[keyof T];
+type Identity<T> = {
+    [K in keyof T]: T[K];
+} & unknown;
+type ToEventDiscriminatedUnion<T> = Values<{
+    [K in keyof T]: Identity<(K extends 'message' ? {
+        id?: string;
+        event?: K;
+        data?: T[K];
+        retry?: never;
+    } : {
+        id?: string;
+        event: K;
+        data?: T[K];
+        retry?: never;
+    }) & (undefined extends T[K] ? unknown : {
+        data: unknown;
+    })>;
+}>;
+type ServerSentEventClientEventMap = {
+    message: [
+        payload: {
+            id?: string;
+            event: string;
+            data?: unknown;
+            frames: Array<string>;
+        }
+    ];
+    error: [];
+    close: [];
+};
+declare class ServerSentEventClient<EventMap extends EventMapConstraint = {
+    message: unknown;
+}> {
+    #private;
+    constructor(args: {
+        controller: ReadableStreamDefaultController;
+        emitter: Emitter<ServerSentEventClientEventMap>;
+    });
+    /**
+     * Sends the given payload to the intercepted `EventSource`.
+     */
+    send(payload: ServerSentEventMessage<EventMap>): void;
+    /**
+     * Dispatches the given event on the intercepted `EventSource`.
+     */
+    dispatchEvent(event: Event): void;
+    /**
+     * Errors the underlying `EventSource`, closing the connection with an error.
+     * This is equivalent to aborting the connection and will produce a `TypeError: Failed to fetch`
+     * error.
+     */
+    error(): void;
+    /**
+     * Closes the underlying `EventSource`, closing the connection.
+     */
+    close(): void;
+}
+declare class ServerSentEventServer {
+    #private;
+    constructor(args: {
+        request: Request;
+        client: ServerSentEventClient<any>;
+    });
+    /**
+     * Establishes the actual connection for this SSE request
+     * and returns the `EventSource` instance.
+     */
+    connect(): EventSource;
+}
+
+export { type ServerSentEventMessage, type ServerSentEventRequestHandler, type ServerSentEventResolver, type ServerSentEventResolverExtras, sse };

package/lib/core/sse.d.ts

@@ -0,0 +1,116 @@
+import { Emitter } from 'strict-event-emitter';
+import { a as ResponseResolver } from './HttpResponse-BpT5A_2L.js';
+import { HttpRequestResolverExtras, HttpHandler } from './handlers/HttpHandler.js';
+import { PathParams, Path } from './utils/matching/matchRequestUrl.js';
+import '@mswjs/interceptors';
+import './utils/internal/isIterable.js';
+import './typeUtils.js';
+import 'graphql';
+
+type EventMapConstraint = {
+    message?: unknown;
+    [key: string]: unknown;
+    [key: symbol | number]: never;
+};
+type ServerSentEventResolverExtras<EventMap extends EventMapConstraint, Params extends PathParams> = HttpRequestResolverExtras<Params> & {
+    client: ServerSentEventClient<EventMap>;
+    server: ServerSentEventServer;
+};
+type ServerSentEventResolver<EventMap extends EventMapConstraint, Params extends PathParams> = ResponseResolver<ServerSentEventResolverExtras<EventMap, Params>, any, any>;
+type ServerSentEventRequestHandler = <EventMap extends EventMapConstraint = {
+    message: unknown;
+}, Params extends PathParams<keyof Params> = PathParams, RequestPath extends Path = Path>(path: RequestPath, resolver: ServerSentEventResolver<EventMap, Params>) => HttpHandler;
+type ServerSentEventMessage<EventMap extends EventMapConstraint = {
+    message: unknown;
+}> = ToEventDiscriminatedUnion<EventMap & {
+    message: unknown;
+}> | {
+    id?: never;
+    event?: never;
+    data?: never;
+    retry: number;
+};
+/**
+ * Intercept Server-Sent Events (SSE).
+ *
+ * @example
+ * sse('http://localhost:4321', ({ client }) => {
+ *   client.send({ data: 'hello world' })
+ * })
+ *
+ * @see {@link https://mswjs.io/docs/sse/ Mocking Server-Sent Events}
+ * @see {@link https://mswjs.io/docs/api/sse `sse()` API reference}
+ */
+declare const sse: ServerSentEventRequestHandler;
+type Values<T> = T[keyof T];
+type Identity<T> = {
+    [K in keyof T]: T[K];
+} & unknown;
+type ToEventDiscriminatedUnion<T> = Values<{
+    [K in keyof T]: Identity<(K extends 'message' ? {
+        id?: string;
+        event?: K;
+        data?: T[K];
+        retry?: never;
+    } : {
+        id?: string;
+        event: K;
+        data?: T[K];
+        retry?: never;
+    }) & (undefined extends T[K] ? unknown : {
+        data: unknown;
+    })>;
+}>;
+type ServerSentEventClientEventMap = {
+    message: [
+        payload: {
+            id?: string;
+            event: string;
+            data?: unknown;
+            frames: Array<string>;
+        }
+    ];
+    error: [];
+    close: [];
+};
+declare class ServerSentEventClient<EventMap extends EventMapConstraint = {
+    message: unknown;
+}> {
+    #private;
+    constructor(args: {
+        controller: ReadableStreamDefaultController;
+        emitter: Emitter<ServerSentEventClientEventMap>;
+    });
+    /**
+     * Sends the given payload to the intercepted `EventSource`.
+     */
+    send(payload: ServerSentEventMessage<EventMap>): void;
+    /**
+     * Dispatches the given event on the intercepted `EventSource`.
+     */
+    dispatchEvent(event: Event): void;
+    /**
+     * Errors the underlying `EventSource`, closing the connection with an error.
+     * This is equivalent to aborting the connection and will produce a `TypeError: Failed to fetch`
+     * error.
+     */
+    error(): void;
+    /**
+     * Closes the underlying `EventSource`, closing the connection.
+     */
+    close(): void;
+}
+declare class ServerSentEventServer {
+    #private;
+    constructor(args: {
+        request: Request;
+        client: ServerSentEventClient<any>;
+    });
+    /**
+     * Establishes the actual connection for this SSE request
+     * and returns the `EventSource` instance.
+     */
+    connect(): EventSource;
+}
+
+export { type ServerSentEventMessage, type ServerSentEventRequestHandler, type ServerSentEventResolver, type ServerSentEventResolverExtras, sse };