msw 2.5.2 → 2.6.0

package/lib/core/ws/webSocketInterceptor.d.ts

@@ -0,0 +1,5 @@
+import { WebSocketInterceptor } from '@mswjs/interceptors/WebSocket';
+
+declare const webSocketInterceptor: WebSocketInterceptor;
+
+export { webSocketInterceptor };

package/lib/core/ws/webSocketInterceptor.js

@@ -0,0 +1,26 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var webSocketInterceptor_exports = {};
+__export(webSocketInterceptor_exports, {
+  webSocketInterceptor: () => webSocketInterceptor
+});
+module.exports = __toCommonJS(webSocketInterceptor_exports);
+var import_WebSocket = require("@mswjs/interceptors/WebSocket");
+const webSocketInterceptor = new import_WebSocket.WebSocketInterceptor();
+//# sourceMappingURL=webSocketInterceptor.js.map

package/lib/core/ws/webSocketInterceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/ws/webSocketInterceptor.ts"],"sourcesContent":["import { WebSocketInterceptor } from '@mswjs/interceptors/WebSocket'\n\nexport const webSocketInterceptor = new WebSocketInterceptor()\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAqC;AAE9B,MAAM,uBAAuB,IAAI,sCAAqB;","names":[]}

package/lib/core/ws/webSocketInterceptor.mjs

@@ -0,0 +1,6 @@
+import { WebSocketInterceptor } from "@mswjs/interceptors/WebSocket";
+const webSocketInterceptor = new WebSocketInterceptor();
+export {
+  webSocketInterceptor
+};
+//# sourceMappingURL=webSocketInterceptor.mjs.map

package/lib/core/ws/webSocketInterceptor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/ws/webSocketInterceptor.ts"],"sourcesContent":["import { WebSocketInterceptor } from '@mswjs/interceptors/WebSocket'\n\nexport const webSocketInterceptor = new WebSocketInterceptor()\n"],"mappings":"AAAA,SAAS,4BAA4B;AAE9B,MAAM,uBAAuB,IAAI,qBAAqB;","names":[]}

package/lib/core/ws.d.mts

@@ -0,0 +1,75 @@
+import { WebSocketClientConnectionProtocol, WebSocketData } from '@mswjs/interceptors/WebSocket';
+export { WebSocketData } from '@mswjs/interceptors/WebSocket';
+import { WebSocketHandlerEventMap, WebSocketHandler } from './handlers/WebSocketHandler.mjs';
+import { Path } from './utils/matching/matchRequestUrl.mjs';
+import 'strict-event-emitter';
+
+type WebSocketEventListener<EventType extends keyof WebSocketHandlerEventMap> = (...args: WebSocketHandlerEventMap[EventType]) => void;
+type WebSocketLink = {
+    /**
+     * A set of all WebSocket clients connected
+     * to this link.
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#clients `clients` API reference}
+     */
+    clients: Set<WebSocketClientConnectionProtocol>;
+    /**
+     * Adds an event listener to this WebSocket link.
+     *
+     * @example
+     * const chat = ws.link('wss://chat.example.com')
+     * chat.addEventListener('connection', listener)
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#onevent-listener `on()` API reference}
+     */
+    addEventListener<EventType extends keyof WebSocketHandlerEventMap>(event: EventType, listener: WebSocketEventListener<EventType>): WebSocketHandler;
+    /**
+     * Broadcasts the given data to all WebSocket clients.
+     *
+     * @example
+     * const service = ws.link('wss://example.com')
+     * service.addEventListener('connection', () => {
+     *   service.broadcast('hello, everyone!')
+     * })
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#broadcastdata `broadcast()` API reference}
+     */
+    broadcast(data: WebSocketData): void;
+    /**
+     * Broadcasts the given data to all WebSocket clients
+     * except the ones provided in the `clients` argument.
+     *
+     * @example
+     * const service = ws.link('wss://example.com')
+     * service.addEventListener('connection', ({ client }) => {
+     *   service.broadcastExcept(client, 'hi, the rest of you!')
+     * })
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#broadcastexceptclients-data `broadcast()` API reference}
+     */
+    broadcastExcept(clients: WebSocketClientConnectionProtocol | Array<WebSocketClientConnectionProtocol>, data: WebSocketData): void;
+};
+/**
+ * Intercepts outgoing WebSocket connections to the given URL.
+ *
+ * @example
+ * const chat = ws.link('wss://chat.example.com')
+ * chat.addEventListener('connection', ({ client }) => {
+ *   client.send('hello from server!')
+ * })
+ */
+declare function createWebSocketLinkHandler(url: Path): WebSocketLink;
+/**
+ * A namespace to intercept and mock WebSocket connections.
+ *
+ * @example
+ * const chat = ws.link('wss://chat.example.com')
+ *
+ * @see {@link https://mswjs.io/docs/api/ws `ws` API reference}
+ * @see {@link https://mswjs.io/docs/basics/handling-websocket-events Handling WebSocket events}
+ */
+declare const ws: {
+    link: typeof createWebSocketLinkHandler;
+};
+
+export { type WebSocketEventListener, type WebSocketLink, ws };

package/lib/core/ws.d.ts

@@ -0,0 +1,75 @@
+import { WebSocketClientConnectionProtocol, WebSocketData } from '@mswjs/interceptors/WebSocket';
+export { WebSocketData } from '@mswjs/interceptors/WebSocket';
+import { WebSocketHandlerEventMap, WebSocketHandler } from './handlers/WebSocketHandler.js';
+import { Path } from './utils/matching/matchRequestUrl.js';
+import 'strict-event-emitter';
+
+type WebSocketEventListener<EventType extends keyof WebSocketHandlerEventMap> = (...args: WebSocketHandlerEventMap[EventType]) => void;
+type WebSocketLink = {
+    /**
+     * A set of all WebSocket clients connected
+     * to this link.
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#clients `clients` API reference}
+     */
+    clients: Set<WebSocketClientConnectionProtocol>;
+    /**
+     * Adds an event listener to this WebSocket link.
+     *
+     * @example
+     * const chat = ws.link('wss://chat.example.com')
+     * chat.addEventListener('connection', listener)
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#onevent-listener `on()` API reference}
+     */
+    addEventListener<EventType extends keyof WebSocketHandlerEventMap>(event: EventType, listener: WebSocketEventListener<EventType>): WebSocketHandler;
+    /**
+     * Broadcasts the given data to all WebSocket clients.
+     *
+     * @example
+     * const service = ws.link('wss://example.com')
+     * service.addEventListener('connection', () => {
+     *   service.broadcast('hello, everyone!')
+     * })
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#broadcastdata `broadcast()` API reference}
+     */
+    broadcast(data: WebSocketData): void;
+    /**
+     * Broadcasts the given data to all WebSocket clients
+     * except the ones provided in the `clients` argument.
+     *
+     * @example
+     * const service = ws.link('wss://example.com')
+     * service.addEventListener('connection', ({ client }) => {
+     *   service.broadcastExcept(client, 'hi, the rest of you!')
+     * })
+     *
+     * @see {@link https://mswjs.io/docs/api/ws#broadcastexceptclients-data `broadcast()` API reference}
+     */
+    broadcastExcept(clients: WebSocketClientConnectionProtocol | Array<WebSocketClientConnectionProtocol>, data: WebSocketData): void;
+};
+/**
+ * Intercepts outgoing WebSocket connections to the given URL.
+ *
+ * @example
+ * const chat = ws.link('wss://chat.example.com')
+ * chat.addEventListener('connection', ({ client }) => {
+ *   client.send('hello from server!')
+ * })
+ */
+declare function createWebSocketLinkHandler(url: Path): WebSocketLink;
+/**
+ * A namespace to intercept and mock WebSocket connections.
+ *
+ * @example
+ * const chat = ws.link('wss://chat.example.com')
+ *
+ * @see {@link https://mswjs.io/docs/api/ws `ws` API reference}
+ * @see {@link https://mswjs.io/docs/basics/handling-websocket-events Handling WebSocket events}
+ */
+declare const ws: {
+    link: typeof createWebSocketLinkHandler;
+};
+
+export { type WebSocketEventListener, type WebSocketLink, ws };

package/lib/core/ws.js

@@ -0,0 +1,71 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ws_exports = {};
+__export(ws_exports, {
+  ws: () => ws
+});
+module.exports = __toCommonJS(ws_exports);
+var import_outvariant = require("outvariant");
+var import_WebSocketHandler = require("./handlers/WebSocketHandler.js");
+var import_matchRequestUrl = require("./utils/matching/matchRequestUrl.js");
+var import_WebSocketClientManager = require("./ws/WebSocketClientManager.js");
+function isBroadcastChannelWithUnref(channel) {
+  return typeof Reflect.get(channel, "unref") !== "undefined";
+}
+const webSocketChannel = new BroadcastChannel("msw:websocket-client-manager");
+if (isBroadcastChannelWithUnref(webSocketChannel)) {
+  webSocketChannel.unref();
+}
+function createWebSocketLinkHandler(url) {
+  (0, import_outvariant.invariant)(url, "Expected a WebSocket server URL but got undefined");
+  (0, import_outvariant.invariant)(
+    (0, import_matchRequestUrl.isPath)(url),
+    "Expected a WebSocket server URL to be a valid path but got %s",
+    typeof url
+  );
+  const clientManager = new import_WebSocketClientManager.WebSocketClientManager(webSocketChannel);
+  return {
+    get clients() {
+      return clientManager.clients;
+    },
+    addEventListener(event, listener) {
+      const handler = new import_WebSocketHandler.WebSocketHandler(url);
+      handler[import_WebSocketHandler.kEmitter].on("connection", async ({ client }) => {
+        await clientManager.addConnection(client);
+      });
+      handler[import_WebSocketHandler.kEmitter].on(event, listener);
+      return handler;
+    },
+    broadcast(data) {
+      this.broadcastExcept([], data);
+    },
+    broadcastExcept(clients, data) {
+      const ignoreClients = Array.prototype.concat(clients).map((client) => client.id);
+      clientManager.clients.forEach((otherClient) => {
+        if (!ignoreClients.includes(otherClient.id)) {
+          otherClient.send(data);
+        }
+      });
+    }
+  };
+}
+const ws = {
+  link: createWebSocketLinkHandler
+};
+//# sourceMappingURL=ws.js.map

package/lib/core/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/ws.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport type {\n  WebSocketData,\n  WebSocketClientConnectionProtocol,\n} from '@mswjs/interceptors/WebSocket'\nimport {\n  WebSocketHandler,\n  kEmitter,\n  type WebSocketHandlerEventMap,\n} from './handlers/WebSocketHandler'\nimport { Path, isPath } from './utils/matching/matchRequestUrl'\nimport { WebSocketClientManager } from './ws/WebSocketClientManager'\n\nfunction isBroadcastChannelWithUnref(\n  channel: BroadcastChannel,\n): channel is BroadcastChannel & NodeJS.RefCounted {\n  return typeof Reflect.get(channel, 'unref') !== 'undefined'\n}\n\nconst webSocketChannel = new BroadcastChannel('msw:websocket-client-manager')\n\nif (isBroadcastChannelWithUnref(webSocketChannel)) {\n  // Allows the Node.js thread to exit if it is the only active handle in the event system.\n  // https://nodejs.org/api/worker_threads.html#broadcastchannelunref\n  webSocketChannel.unref()\n}\n\nexport type WebSocketEventListener<\n  EventType extends keyof WebSocketHandlerEventMap,\n> = (...args: WebSocketHandlerEventMap[EventType]) => void\n\nexport type WebSocketLink = {\n  /**\n   * A set of all WebSocket clients connected\n   * to this link.\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#clients `clients` API reference}\n   */\n  clients: Set<WebSocketClientConnectionProtocol>\n\n  /**\n   * Adds an event listener to this WebSocket link.\n   *\n   * @example\n   * const chat = ws.link('wss://chat.example.com')\n   * chat.addEventListener('connection', listener)\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#onevent-listener `on()` API reference}\n   */\n  addEventListener<EventType extends keyof WebSocketHandlerEventMap>(\n    event: EventType,\n    listener: WebSocketEventListener<EventType>,\n  ): WebSocketHandler\n\n  /**\n   * Broadcasts the given data to all WebSocket clients.\n   *\n   * @example\n   * const service = ws.link('wss://example.com')\n   * service.addEventListener('connection', () => {\n   *   service.broadcast('hello, everyone!')\n   * })\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#broadcastdata `broadcast()` API reference}\n   */\n  broadcast(data: WebSocketData): void\n\n  /**\n   * Broadcasts the given data to all WebSocket clients\n   * except the ones provided in the `clients` argument.\n   *\n   * @example\n   * const service = ws.link('wss://example.com')\n   * service.addEventListener('connection', ({ client }) => {\n   *   service.broadcastExcept(client, 'hi, the rest of you!')\n   * })\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#broadcastexceptclients-data `broadcast()` API reference}\n   */\n  broadcastExcept(\n    clients:\n      | WebSocketClientConnectionProtocol\n      | Array<WebSocketClientConnectionProtocol>,\n    data: WebSocketData,\n  ): void\n}\n\n/**\n * Intercepts outgoing WebSocket connections to the given URL.\n *\n * @example\n * const chat = ws.link('wss://chat.example.com')\n * chat.addEventListener('connection', ({ client }) => {\n *   client.send('hello from server!')\n * })\n */\nfunction createWebSocketLinkHandler(url: Path): WebSocketLink {\n  invariant(url, 'Expected a WebSocket server URL but got undefined')\n\n  invariant(\n    isPath(url),\n    'Expected a WebSocket server URL to be a valid path but got %s',\n    typeof url,\n  )\n\n  const clientManager = new WebSocketClientManager(webSocketChannel)\n\n  return {\n    get clients() {\n      return clientManager.clients\n    },\n    addEventListener(event, listener) {\n      const handler = new WebSocketHandler(url)\n\n      // Add the connection event listener for when the\n      // handler matches and emits a connection event.\n      // When that happens, store that connection in the\n      // set of all connections for reference.\n      handler[kEmitter].on('connection', async ({ client }) => {\n        await clientManager.addConnection(client)\n      })\n\n      // The \"handleWebSocketEvent\" function will invoke\n      // the \"run()\" method on the WebSocketHandler.\n      // If the handler matches, it will emit the \"connection\"\n      // event. Attach the user-defined listener to that event.\n      handler[kEmitter].on(event, listener)\n\n      return handler\n    },\n\n    broadcast(data) {\n      // This will invoke \"send()\" on the immediate clients\n      // in this runtime and post a message to the broadcast channel\n      // to trigger send for the clients in other runtimes.\n      this.broadcastExcept([], data)\n    },\n\n    broadcastExcept(clients, data) {\n      const ignoreClients = Array.prototype\n        .concat(clients)\n        .map((client) => client.id)\n\n      clientManager.clients.forEach((otherClient) => {\n        if (!ignoreClients.includes(otherClient.id)) {\n          otherClient.send(data)\n        }\n      })\n    },\n  }\n}\n\n/**\n * A namespace to intercept and mock WebSocket connections.\n *\n * @example\n * const chat = ws.link('wss://chat.example.com')\n *\n * @see {@link https://mswjs.io/docs/api/ws `ws` API reference}\n * @see {@link https://mswjs.io/docs/basics/handling-websocket-events Handling WebSocket events}\n */\nexport const ws = {\n  link: createWebSocketLinkHandler,\n}\n\nexport { WebSocketData }\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA0B;AAK1B,8BAIO;AACP,6BAA6B;AAC7B,oCAAuC;AAEvC,SAAS,4BACP,SACiD;AACjD,SAAO,OAAO,QAAQ,IAAI,SAAS,OAAO,MAAM;AAClD;AAEA,MAAM,mBAAmB,IAAI,iBAAiB,8BAA8B;AAE5E,IAAI,4BAA4B,gBAAgB,GAAG;AAGjD,mBAAiB,MAAM;AACzB;AAuEA,SAAS,2BAA2B,KAA0B;AAC5D,mCAAU,KAAK,mDAAmD;AAElE;AAAA,QACE,+BAAO,GAAG;AAAA,IACV;AAAA,IACA,OAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,IAAI,qDAAuB,gBAAgB;AAEjE,SAAO;AAAA,IACL,IAAI,UAAU;AACZ,aAAO,cAAc;AAAA,IACvB;AAAA,IACA,iBAAiB,OAAO,UAAU;AAChC,YAAM,UAAU,IAAI,yCAAiB,GAAG;AAMxC,cAAQ,gCAAQ,EAAE,GAAG,cAAc,OAAO,EAAE,OAAO,MAAM;AACvD,cAAM,cAAc,cAAc,MAAM;AAAA,MAC1C,CAAC;AAMD,cAAQ,gCAAQ,EAAE,GAAG,OAAO,QAAQ;AAEpC,aAAO;AAAA,IACT;AAAA,IAEA,UAAU,MAAM;AAId,WAAK,gBAAgB,CAAC,GAAG,IAAI;AAAA,IAC/B;AAAA,IAEA,gBAAgB,SAAS,MAAM;AAC7B,YAAM,gBAAgB,MAAM,UACzB,OAAO,OAAO,EACd,IAAI,CAAC,WAAW,OAAO,EAAE;AAE5B,oBAAc,QAAQ,QAAQ,CAAC,gBAAgB;AAC7C,YAAI,CAAC,cAAc,SAAS,YAAY,EAAE,GAAG;AAC3C,sBAAY,KAAK,IAAI;AAAA,QACvB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAWO,MAAM,KAAK;AAAA,EAChB,MAAM;AACR;","names":[]}

package/lib/core/ws.mjs

@@ -0,0 +1,54 @@
+import { invariant } from "outvariant";
+import {
+  WebSocketHandler,
+  kEmitter
+} from './handlers/WebSocketHandler.mjs';
+import { isPath } from './utils/matching/matchRequestUrl.mjs';
+import { WebSocketClientManager } from './ws/WebSocketClientManager.mjs';
+function isBroadcastChannelWithUnref(channel) {
+  return typeof Reflect.get(channel, "unref") !== "undefined";
+}
+const webSocketChannel = new BroadcastChannel("msw:websocket-client-manager");
+if (isBroadcastChannelWithUnref(webSocketChannel)) {
+  webSocketChannel.unref();
+}
+function createWebSocketLinkHandler(url) {
+  invariant(url, "Expected a WebSocket server URL but got undefined");
+  invariant(
+    isPath(url),
+    "Expected a WebSocket server URL to be a valid path but got %s",
+    typeof url
+  );
+  const clientManager = new WebSocketClientManager(webSocketChannel);
+  return {
+    get clients() {
+      return clientManager.clients;
+    },
+    addEventListener(event, listener) {
+      const handler = new WebSocketHandler(url);
+      handler[kEmitter].on("connection", async ({ client }) => {
+        await clientManager.addConnection(client);
+      });
+      handler[kEmitter].on(event, listener);
+      return handler;
+    },
+    broadcast(data) {
+      this.broadcastExcept([], data);
+    },
+    broadcastExcept(clients, data) {
+      const ignoreClients = Array.prototype.concat(clients).map((client) => client.id);
+      clientManager.clients.forEach((otherClient) => {
+        if (!ignoreClients.includes(otherClient.id)) {
+          otherClient.send(data);
+        }
+      });
+    }
+  };
+}
+const ws = {
+  link: createWebSocketLinkHandler
+};
+export {
+  ws
+};
+//# sourceMappingURL=ws.mjs.map

package/lib/core/ws.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/ws.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport type {\n  WebSocketData,\n  WebSocketClientConnectionProtocol,\n} from '@mswjs/interceptors/WebSocket'\nimport {\n  WebSocketHandler,\n  kEmitter,\n  type WebSocketHandlerEventMap,\n} from './handlers/WebSocketHandler'\nimport { Path, isPath } from './utils/matching/matchRequestUrl'\nimport { WebSocketClientManager } from './ws/WebSocketClientManager'\n\nfunction isBroadcastChannelWithUnref(\n  channel: BroadcastChannel,\n): channel is BroadcastChannel & NodeJS.RefCounted {\n  return typeof Reflect.get(channel, 'unref') !== 'undefined'\n}\n\nconst webSocketChannel = new BroadcastChannel('msw:websocket-client-manager')\n\nif (isBroadcastChannelWithUnref(webSocketChannel)) {\n  // Allows the Node.js thread to exit if it is the only active handle in the event system.\n  // https://nodejs.org/api/worker_threads.html#broadcastchannelunref\n  webSocketChannel.unref()\n}\n\nexport type WebSocketEventListener<\n  EventType extends keyof WebSocketHandlerEventMap,\n> = (...args: WebSocketHandlerEventMap[EventType]) => void\n\nexport type WebSocketLink = {\n  /**\n   * A set of all WebSocket clients connected\n   * to this link.\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#clients `clients` API reference}\n   */\n  clients: Set<WebSocketClientConnectionProtocol>\n\n  /**\n   * Adds an event listener to this WebSocket link.\n   *\n   * @example\n   * const chat = ws.link('wss://chat.example.com')\n   * chat.addEventListener('connection', listener)\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#onevent-listener `on()` API reference}\n   */\n  addEventListener<EventType extends keyof WebSocketHandlerEventMap>(\n    event: EventType,\n    listener: WebSocketEventListener<EventType>,\n  ): WebSocketHandler\n\n  /**\n   * Broadcasts the given data to all WebSocket clients.\n   *\n   * @example\n   * const service = ws.link('wss://example.com')\n   * service.addEventListener('connection', () => {\n   *   service.broadcast('hello, everyone!')\n   * })\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#broadcastdata `broadcast()` API reference}\n   */\n  broadcast(data: WebSocketData): void\n\n  /**\n   * Broadcasts the given data to all WebSocket clients\n   * except the ones provided in the `clients` argument.\n   *\n   * @example\n   * const service = ws.link('wss://example.com')\n   * service.addEventListener('connection', ({ client }) => {\n   *   service.broadcastExcept(client, 'hi, the rest of you!')\n   * })\n   *\n   * @see {@link https://mswjs.io/docs/api/ws#broadcastexceptclients-data `broadcast()` API reference}\n   */\n  broadcastExcept(\n    clients:\n      | WebSocketClientConnectionProtocol\n      | Array<WebSocketClientConnectionProtocol>,\n    data: WebSocketData,\n  ): void\n}\n\n/**\n * Intercepts outgoing WebSocket connections to the given URL.\n *\n * @example\n * const chat = ws.link('wss://chat.example.com')\n * chat.addEventListener('connection', ({ client }) => {\n *   client.send('hello from server!')\n * })\n */\nfunction createWebSocketLinkHandler(url: Path): WebSocketLink {\n  invariant(url, 'Expected a WebSocket server URL but got undefined')\n\n  invariant(\n    isPath(url),\n    'Expected a WebSocket server URL to be a valid path but got %s',\n    typeof url,\n  )\n\n  const clientManager = new WebSocketClientManager(webSocketChannel)\n\n  return {\n    get clients() {\n      return clientManager.clients\n    },\n    addEventListener(event, listener) {\n      const handler = new WebSocketHandler(url)\n\n      // Add the connection event listener for when the\n      // handler matches and emits a connection event.\n      // When that happens, store that connection in the\n      // set of all connections for reference.\n      handler[kEmitter].on('connection', async ({ client }) => {\n        await clientManager.addConnection(client)\n      })\n\n      // The \"handleWebSocketEvent\" function will invoke\n      // the \"run()\" method on the WebSocketHandler.\n      // If the handler matches, it will emit the \"connection\"\n      // event. Attach the user-defined listener to that event.\n      handler[kEmitter].on(event, listener)\n\n      return handler\n    },\n\n    broadcast(data) {\n      // This will invoke \"send()\" on the immediate clients\n      // in this runtime and post a message to the broadcast channel\n      // to trigger send for the clients in other runtimes.\n      this.broadcastExcept([], data)\n    },\n\n    broadcastExcept(clients, data) {\n      const ignoreClients = Array.prototype\n        .concat(clients)\n        .map((client) => client.id)\n\n      clientManager.clients.forEach((otherClient) => {\n        if (!ignoreClients.includes(otherClient.id)) {\n          otherClient.send(data)\n        }\n      })\n    },\n  }\n}\n\n/**\n * A namespace to intercept and mock WebSocket connections.\n *\n * @example\n * const chat = ws.link('wss://chat.example.com')\n *\n * @see {@link https://mswjs.io/docs/api/ws `ws` API reference}\n * @see {@link https://mswjs.io/docs/basics/handling-websocket-events Handling WebSocket events}\n */\nexport const ws = {\n  link: createWebSocketLinkHandler,\n}\n\nexport { WebSocketData }\n"],"mappings":"AAAA,SAAS,iBAAiB;AAK1B;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAe,cAAc;AAC7B,SAAS,8BAA8B;AAEvC,SAAS,4BACP,SACiD;AACjD,SAAO,OAAO,QAAQ,IAAI,SAAS,OAAO,MAAM;AAClD;AAEA,MAAM,mBAAmB,IAAI,iBAAiB,8BAA8B;AAE5E,IAAI,4BAA4B,gBAAgB,GAAG;AAGjD,mBAAiB,MAAM;AACzB;AAuEA,SAAS,2BAA2B,KAA0B;AAC5D,YAAU,KAAK,mDAAmD;AAElE;AAAA,IACE,OAAO,GAAG;AAAA,IACV;AAAA,IACA,OAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,IAAI,uBAAuB,gBAAgB;AAEjE,SAAO;AAAA,IACL,IAAI,UAAU;AACZ,aAAO,cAAc;AAAA,IACvB;AAAA,IACA,iBAAiB,OAAO,UAAU;AAChC,YAAM,UAAU,IAAI,iBAAiB,GAAG;AAMxC,cAAQ,QAAQ,EAAE,GAAG,cAAc,OAAO,EAAE,OAAO,MAAM;AACvD,cAAM,cAAc,cAAc,MAAM;AAAA,MAC1C,CAAC;AAMD,cAAQ,QAAQ,EAAE,GAAG,OAAO,QAAQ;AAEpC,aAAO;AAAA,IACT;AAAA,IAEA,UAAU,MAAM;AAId,WAAK,gBAAgB,CAAC,GAAG,IAAI;AAAA,IAC/B;AAAA,IAEA,gBAAgB,SAAS,MAAM;AAC7B,YAAM,gBAAgB,MAAM,UACzB,OAAO,OAAO,EACd,IAAI,CAAC,WAAW,OAAO,EAAE;AAE5B,oBAAc,QAAQ,QAAQ,CAAC,gBAAgB;AAC7C,YAAI,CAAC,cAAc,SAAS,YAAY,EAAE,GAAG;AAC3C,sBAAY,KAAK,IAAI;AAAA,QACvB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAWO,MAAM,KAAK;AAAA,EAChB,MAAM;AACR;","names":[]}