msw 2.2.13 → 2.3.0-ws.rc-2

package/lib/core/utils/matching/matchRequestUrl.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/utils/matching/matchRequestUrl.ts"],"sourcesContent":["import { match } from 'path-to-regexp'\nimport { getCleanUrl } from '@mswjs/interceptors'\nimport { normalizePath } from './normalizePath'\n\nexport type Path = string | RegExp\nexport type PathParams<KeyType extends keyof any = string> = {\n  [ParamName in KeyType]: string | ReadonlyArray<string>\n}\n\nexport interface Match {\n  matches: boolean\n  params?: PathParams\n}\n\n/**\n * Coerce a path supported by MSW into a path\n * supported by \"path-to-regexp\".\n */\nexport function coercePath(path: string): string {\n  return (\n    path\n      /**\n       * Replace wildcards (\"*\") with unnamed capturing groups\n       * because \"path-to-regexp\" doesn't support wildcards.\n       * Ignore path parameter' modifiers (i.e. \":name*\").\n       */\n      .replace(\n        /([:a-zA-Z_-]*)(\\*{1,2})+/g,\n        (_, parameterName: string | undefined, wildcard: string) => {\n          const expression = '(.*)'\n\n          if (!parameterName) {\n            return expression\n          }\n\n          return parameterName.startsWith(':')\n            ? `${parameterName}${wildcard}`\n            : `${parameterName}${expression}`\n        },\n      )\n      /**\n       * Escape the port so that \"path-to-regexp\" can match\n       * absolute URLs including port numbers.\n       */\n      .replace(/([^\\/])(:)(?=\\d+)/, '$1\\\\$2')\n      /**\n       * Escape the protocol so that \"path-to-regexp\" could match\n       * absolute URL.\n       * @see https://github.com/pillarjs/path-to-regexp/issues/259\n       */\n      .replace(/^([^\\/]+)(:)(?=\\/\\/)/, '$1\\\\$2')\n  )\n}\n\n/**\n * Returns the result of matching given request URL against a mask.\n */\nexport function matchRequestUrl(url: URL, path: Path, baseUrl?: string): Match {\n  const normalizedPath = normalizePath(path, baseUrl)\n  const cleanPath =\n    typeof normalizedPath === 'string'\n      ? coercePath(normalizedPath)\n      : normalizedPath\n\n  const cleanUrl = getCleanUrl(url)\n  const result = match(cleanPath, { decode: decodeURIComponent })(cleanUrl)\n  const params = (result && (result.params as PathParams)) || {}\n\n  return {\n    matches: result !== false,\n    params,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAAsB;AACtB,0BAA4B;AAC5B,2BAA8B;AAgBvB,SAAS,WAAW,MAAsB;AAC/C,SACE,KAMG;AAAA,IACC;AAAA,IACA,CAAC,GAAG,eAAmC,aAAqB;AAC1D,YAAM,aAAa;AAEnB,UAAI,CAAC,eAAe;AAClB,eAAO;AAAA,MACT;AAEA,aAAO,cAAc,WAAW,GAAG,IAC/B,GAAG,aAAa,GAAG,QAAQ,KAC3B,GAAG,aAAa,GAAG,UAAU;AAAA,IACnC;AAAA,EACF,EAKC,QAAQ,qBAAqB,QAAQ,EAMrC,QAAQ,wBAAwB,QAAQ;AAE/C;AAKO,SAAS,gBAAgB,KAAU,MAAY,SAAyB;AAC7E,QAAM,qBAAiB,oCAAc,MAAM,OAAO;AAClD,QAAM,YACJ,OAAO,mBAAmB,WACtB,WAAW,cAAc,IACzB;AAEN,QAAM,eAAW,iCAAY,GAAG;AAChC,QAAM,aAAS,6BAAM,WAAW,EAAE,QAAQ,mBAAmB,CAAC,EAAE,QAAQ;AACxE,QAAM,SAAU,UAAW,OAAO,UAA0B,CAAC;AAE7D,SAAO;AAAA,IACL,SAAS,WAAW;AAAA,IACpB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/core/utils/matching/matchRequestUrl.ts"],"sourcesContent":["import { match } from 'path-to-regexp'\nimport { getCleanUrl } from '@mswjs/interceptors'\nimport { normalizePath } from './normalizePath'\n\nexport type Path = string | RegExp\nexport type PathParams<KeyType extends keyof any = string> = {\n  [ParamName in KeyType]: string | ReadonlyArray<string>\n}\n\nexport interface Match {\n  matches: boolean\n  params?: PathParams\n}\n\n/**\n * Coerce a path supported by MSW into a path\n * supported by \"path-to-regexp\".\n */\nexport function coercePath(path: string): string {\n  return (\n    path\n      /**\n       * Replace wildcards (\"*\") with unnamed capturing groups\n       * because \"path-to-regexp\" doesn't support wildcards.\n       * Ignore path parameter' modifiers (i.e. \":name*\").\n       */\n      .replace(\n        /([:a-zA-Z_-]*)(\\*{1,2})+/g,\n        (_, parameterName: string | undefined, wildcard: string) => {\n          const expression = '(.*)'\n\n          if (!parameterName) {\n            return expression\n          }\n\n          return parameterName.startsWith(':')\n            ? `${parameterName}${wildcard}`\n            : `${parameterName}${expression}`\n        },\n      )\n      /**\n       * Escape the port so that \"path-to-regexp\" can match\n       * absolute URLs including port numbers.\n       */\n      .replace(/([^\\/])(:)(?=\\d+)/, '$1\\\\$2')\n      /**\n       * Escape the protocol so that \"path-to-regexp\" could match\n       * absolute URL.\n       * @see https://github.com/pillarjs/path-to-regexp/issues/259\n       */\n      .replace(/^([^\\/]+)(:)(?=\\/\\/)/, '$1\\\\$2')\n  )\n}\n\n/**\n * Returns the result of matching given request URL against a mask.\n */\nexport function matchRequestUrl(url: URL, path: Path, baseUrl?: string): Match {\n  const normalizedPath = normalizePath(path, baseUrl)\n  const cleanPath =\n    typeof normalizedPath === 'string'\n      ? coercePath(normalizedPath)\n      : normalizedPath\n\n  const cleanUrl = getCleanUrl(url)\n  const result = match(cleanPath, { decode: decodeURIComponent })(cleanUrl)\n  const params = (result && (result.params as PathParams)) || {}\n\n  return {\n    matches: result !== false,\n    params,\n  }\n}\n\nexport function isPath(value: unknown): value is Path {\n  return typeof value === 'string' || value instanceof RegExp\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAAsB;AACtB,0BAA4B;AAC5B,2BAA8B;AAgBvB,SAAS,WAAW,MAAsB;AAC/C,SACE,KAMG;AAAA,IACC;AAAA,IACA,CAAC,GAAG,eAAmC,aAAqB;AAC1D,YAAM,aAAa;AAEnB,UAAI,CAAC,eAAe;AAClB,eAAO;AAAA,MACT;AAEA,aAAO,cAAc,WAAW,GAAG,IAC/B,GAAG,aAAa,GAAG,QAAQ,KAC3B,GAAG,aAAa,GAAG,UAAU;AAAA,IACnC;AAAA,EACF,EAKC,QAAQ,qBAAqB,QAAQ,EAMrC,QAAQ,wBAAwB,QAAQ;AAE/C;AAKO,SAAS,gBAAgB,KAAU,MAAY,SAAyB;AAC7E,QAAM,qBAAiB,oCAAc,MAAM,OAAO;AAClD,QAAM,YACJ,OAAO,mBAAmB,WACtB,WAAW,cAAc,IACzB;AAEN,QAAM,eAAW,iCAAY,GAAG;AAChC,QAAM,aAAS,6BAAM,WAAW,EAAE,QAAQ,mBAAmB,CAAC,EAAE,QAAQ;AACxE,QAAM,SAAU,UAAW,OAAO,UAA0B,CAAC;AAE7D,SAAO;AAAA,IACL,SAAS,WAAW;AAAA,IACpB;AAAA,EACF;AACF;AAEO,SAAS,OAAO,OAA+B;AACpD,SAAO,OAAO,UAAU,YAAY,iBAAiB;AACvD;","names":[]}

package/lib/core/utils/matching/matchRequestUrl.mjs

@@ -24,8 +24,12 @@ function matchRequestUrl(url, path, baseUrl) {
     params
   };
 }
+function isPath(value) {
+  return typeof value === "string" || value instanceof RegExp;
+}
 export {
   coercePath,
+  isPath,
   matchRequestUrl
 };
 //# sourceMappingURL=matchRequestUrl.mjs.map

package/lib/core/utils/matching/matchRequestUrl.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/utils/matching/matchRequestUrl.ts"],"sourcesContent":["import { match } from 'path-to-regexp'\nimport { getCleanUrl } from '@mswjs/interceptors'\nimport { normalizePath } from './normalizePath'\n\nexport type Path = string | RegExp\nexport type PathParams<KeyType extends keyof any = string> = {\n  [ParamName in KeyType]: string | ReadonlyArray<string>\n}\n\nexport interface Match {\n  matches: boolean\n  params?: PathParams\n}\n\n/**\n * Coerce a path supported by MSW into a path\n * supported by \"path-to-regexp\".\n */\nexport function coercePath(path: string): string {\n  return (\n    path\n      /**\n       * Replace wildcards (\"*\") with unnamed capturing groups\n       * because \"path-to-regexp\" doesn't support wildcards.\n       * Ignore path parameter' modifiers (i.e. \":name*\").\n       */\n      .replace(\n        /([:a-zA-Z_-]*)(\\*{1,2})+/g,\n        (_, parameterName: string | undefined, wildcard: string) => {\n          const expression = '(.*)'\n\n          if (!parameterName) {\n            return expression\n          }\n\n          return parameterName.startsWith(':')\n            ? `${parameterName}${wildcard}`\n            : `${parameterName}${expression}`\n        },\n      )\n      /**\n       * Escape the port so that \"path-to-regexp\" can match\n       * absolute URLs including port numbers.\n       */\n      .replace(/([^\\/])(:)(?=\\d+)/, '$1\\\\$2')\n      /**\n       * Escape the protocol so that \"path-to-regexp\" could match\n       * absolute URL.\n       * @see https://github.com/pillarjs/path-to-regexp/issues/259\n       */\n      .replace(/^([^\\/]+)(:)(?=\\/\\/)/, '$1\\\\$2')\n  )\n}\n\n/**\n * Returns the result of matching given request URL against a mask.\n */\nexport function matchRequestUrl(url: URL, path: Path, baseUrl?: string): Match {\n  const normalizedPath = normalizePath(path, baseUrl)\n  const cleanPath =\n    typeof normalizedPath === 'string'\n      ? coercePath(normalizedPath)\n      : normalizedPath\n\n  const cleanUrl = getCleanUrl(url)\n  const result = match(cleanPath, { decode: decodeURIComponent })(cleanUrl)\n  const params = (result && (result.params as PathParams)) || {}\n\n  return {\n    matches: result !== false,\n    params,\n  }\n}\n"],"mappings":"AAAA,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAgBvB,SAAS,WAAW,MAAsB;AAC/C,SACE,KAMG;AAAA,IACC;AAAA,IACA,CAAC,GAAG,eAAmC,aAAqB;AAC1D,YAAM,aAAa;AAEnB,UAAI,CAAC,eAAe;AAClB,eAAO;AAAA,MACT;AAEA,aAAO,cAAc,WAAW,GAAG,IAC/B,GAAG,aAAa,GAAG,QAAQ,KAC3B,GAAG,aAAa,GAAG,UAAU;AAAA,IACnC;AAAA,EACF,EAKC,QAAQ,qBAAqB,QAAQ,EAMrC,QAAQ,wBAAwB,QAAQ;AAE/C;AAKO,SAAS,gBAAgB,KAAU,MAAY,SAAyB;AAC7E,QAAM,iBAAiB,cAAc,MAAM,OAAO;AAClD,QAAM,YACJ,OAAO,mBAAmB,WACtB,WAAW,cAAc,IACzB;AAEN,QAAM,WAAW,YAAY,GAAG;AAChC,QAAM,SAAS,MAAM,WAAW,EAAE,QAAQ,mBAAmB,CAAC,EAAE,QAAQ;AACxE,QAAM,SAAU,UAAW,OAAO,UAA0B,CAAC;AAE7D,SAAO;AAAA,IACL,SAAS,WAAW;AAAA,IACpB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/core/utils/matching/matchRequestUrl.ts"],"sourcesContent":["import { match } from 'path-to-regexp'\nimport { getCleanUrl } from '@mswjs/interceptors'\nimport { normalizePath } from './normalizePath'\n\nexport type Path = string | RegExp\nexport type PathParams<KeyType extends keyof any = string> = {\n  [ParamName in KeyType]: string | ReadonlyArray<string>\n}\n\nexport interface Match {\n  matches: boolean\n  params?: PathParams\n}\n\n/**\n * Coerce a path supported by MSW into a path\n * supported by \"path-to-regexp\".\n */\nexport function coercePath(path: string): string {\n  return (\n    path\n      /**\n       * Replace wildcards (\"*\") with unnamed capturing groups\n       * because \"path-to-regexp\" doesn't support wildcards.\n       * Ignore path parameter' modifiers (i.e. \":name*\").\n       */\n      .replace(\n        /([:a-zA-Z_-]*)(\\*{1,2})+/g,\n        (_, parameterName: string | undefined, wildcard: string) => {\n          const expression = '(.*)'\n\n          if (!parameterName) {\n            return expression\n          }\n\n          return parameterName.startsWith(':')\n            ? `${parameterName}${wildcard}`\n            : `${parameterName}${expression}`\n        },\n      )\n      /**\n       * Escape the port so that \"path-to-regexp\" can match\n       * absolute URLs including port numbers.\n       */\n      .replace(/([^\\/])(:)(?=\\d+)/, '$1\\\\$2')\n      /**\n       * Escape the protocol so that \"path-to-regexp\" could match\n       * absolute URL.\n       * @see https://github.com/pillarjs/path-to-regexp/issues/259\n       */\n      .replace(/^([^\\/]+)(:)(?=\\/\\/)/, '$1\\\\$2')\n  )\n}\n\n/**\n * Returns the result of matching given request URL against a mask.\n */\nexport function matchRequestUrl(url: URL, path: Path, baseUrl?: string): Match {\n  const normalizedPath = normalizePath(path, baseUrl)\n  const cleanPath =\n    typeof normalizedPath === 'string'\n      ? coercePath(normalizedPath)\n      : normalizedPath\n\n  const cleanUrl = getCleanUrl(url)\n  const result = match(cleanPath, { decode: decodeURIComponent })(cleanUrl)\n  const params = (result && (result.params as PathParams)) || {}\n\n  return {\n    matches: result !== false,\n    params,\n  }\n}\n\nexport function isPath(value: unknown): value is Path {\n  return typeof value === 'string' || value instanceof RegExp\n}\n"],"mappings":"AAAA,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAgBvB,SAAS,WAAW,MAAsB;AAC/C,SACE,KAMG;AAAA,IACC;AAAA,IACA,CAAC,GAAG,eAAmC,aAAqB;AAC1D,YAAM,aAAa;AAEnB,UAAI,CAAC,eAAe;AAClB,eAAO;AAAA,MACT;AAEA,aAAO,cAAc,WAAW,GAAG,IAC/B,GAAG,aAAa,GAAG,QAAQ,KAC3B,GAAG,aAAa,GAAG,UAAU;AAAA,IACnC;AAAA,EACF,EAKC,QAAQ,qBAAqB,QAAQ,EAMrC,QAAQ,wBAAwB,QAAQ;AAE/C;AAKO,SAAS,gBAAgB,KAAU,MAAY,SAAyB;AAC7E,QAAM,iBAAiB,cAAc,MAAM,OAAO;AAClD,QAAM,YACJ,OAAO,mBAAmB,WACtB,WAAW,cAAc,IACzB;AAEN,QAAM,WAAW,YAAY,GAAG;AAChC,QAAM,SAAS,MAAM,WAAW,EAAE,QAAQ,mBAAmB,CAAC,EAAE,QAAQ;AACxE,QAAM,SAAU,UAAW,OAAO,UAA0B,CAAC;AAE7D,SAAO;AAAA,IACL,SAAS,WAAW;AAAA,IACpB;AAAA,EACF;AACF;AAEO,SAAS,OAAO,OAA+B;AACpD,SAAO,OAAO,UAAU,YAAY,iBAAiB;AACvD;","names":[]}

package/lib/core/ws/WebSocketClientManager.d.mts

@@ -0,0 +1,64 @@
+import { WebSocketData, WebSocketClientConnectionProtocol, WebSocketClientConnection } from '@mswjs/interceptors/WebSocket';
+
+type WebSocketBroadcastChannelMessage = {
+    type: 'connection:open';
+    payload: {
+        clientId: string;
+        url: string;
+    };
+} | {
+    type: 'extraneous:send';
+    payload: {
+        clientId: string;
+        data: WebSocketData;
+    };
+} | {
+    type: 'extraneous:close';
+    payload: {
+        clientId: string;
+        code?: number;
+        reason?: string;
+    };
+};
+declare const kAddByClientId: unique symbol;
+/**
+ * A manager responsible for accumulating WebSocket client
+ * connections across different browser runtimes.
+ */
+declare class WebSocketClientManager {
+    private channel;
+    /**
+     * All active WebSocket client connections.
+     */
+    clients: Set<WebSocketClientConnectionProtocol>;
+    constructor(channel: BroadcastChannel);
+    /**
+     * Adds the given `WebSocket` client connection to the set
+     * of all connections. The given connection is always the complete
+     * connection object because `addConnection()` is called only
+     * for the opened connections in the same runtime.
+     */
+    addConnection(client: WebSocketClientConnection): void;
+    /**
+     * Adds a client connection wrapper to operate with
+     * WebSocket client connections in other runtimes.
+     */
+    private onRemoteConnection;
+}
+/**
+ * A wrapper class to operate with WebSocket client connections
+ * from other runtimes. This class maintains 1-1 public API
+ * compatibility to the `WebSocketClientConnection` but relies
+ * on the given `BroadcastChannel` to communicate instructions
+ * with the client connections from other runtimes.
+ */
+declare class WebSocketRemoteClientConnection implements WebSocketClientConnectionProtocol {
+    readonly id: string;
+    readonly url: URL;
+    private channel;
+    constructor(id: string, url: URL, channel: BroadcastChannel);
+    send(data: WebSocketData): void;
+    close(code?: number | undefined, reason?: string | undefined): void;
+}
+
+export { type WebSocketBroadcastChannelMessage, WebSocketClientManager, WebSocketRemoteClientConnection, kAddByClientId };

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

@@ -0,0 +1,64 @@
+import { WebSocketData, WebSocketClientConnectionProtocol, WebSocketClientConnection } from '@mswjs/interceptors/WebSocket';
+
+type WebSocketBroadcastChannelMessage = {
+    type: 'connection:open';
+    payload: {
+        clientId: string;
+        url: string;
+    };
+} | {
+    type: 'extraneous:send';
+    payload: {
+        clientId: string;
+        data: WebSocketData;
+    };
+} | {
+    type: 'extraneous:close';
+    payload: {
+        clientId: string;
+        code?: number;
+        reason?: string;
+    };
+};
+declare const kAddByClientId: unique symbol;
+/**
+ * A manager responsible for accumulating WebSocket client
+ * connections across different browser runtimes.
+ */
+declare class WebSocketClientManager {
+    private channel;
+    /**
+     * All active WebSocket client connections.
+     */
+    clients: Set<WebSocketClientConnectionProtocol>;
+    constructor(channel: BroadcastChannel);
+    /**
+     * Adds the given `WebSocket` client connection to the set
+     * of all connections. The given connection is always the complete
+     * connection object because `addConnection()` is called only
+     * for the opened connections in the same runtime.
+     */
+    addConnection(client: WebSocketClientConnection): void;
+    /**
+     * Adds a client connection wrapper to operate with
+     * WebSocket client connections in other runtimes.
+     */
+    private onRemoteConnection;
+}
+/**
+ * A wrapper class to operate with WebSocket client connections
+ * from other runtimes. This class maintains 1-1 public API
+ * compatibility to the `WebSocketClientConnection` but relies
+ * on the given `BroadcastChannel` to communicate instructions
+ * with the client connections from other runtimes.
+ */
+declare class WebSocketRemoteClientConnection implements WebSocketClientConnectionProtocol {
+    readonly id: string;
+    readonly url: URL;
+    private channel;
+    constructor(id: string, url: URL, channel: BroadcastChannel);
+    send(data: WebSocketData): void;
+    close(code?: number | undefined, reason?: string | undefined): void;
+}
+
+export { type WebSocketBroadcastChannelMessage, WebSocketClientManager, WebSocketRemoteClientConnection, kAddByClientId };

package/lib/core/ws/WebSocketClientManager.js

@@ -0,0 +1,123 @@
+"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 WebSocketClientManager_exports = {};
+__export(WebSocketClientManager_exports, {
+  WebSocketClientManager: () => WebSocketClientManager,
+  WebSocketRemoteClientConnection: () => WebSocketRemoteClientConnection,
+  kAddByClientId: () => kAddByClientId
+});
+module.exports = __toCommonJS(WebSocketClientManager_exports);
+const kAddByClientId = Symbol("kAddByClientId");
+class WebSocketClientManager {
+  constructor(channel) {
+    this.channel = channel;
+    this.clients = /* @__PURE__ */ new Set();
+    this.channel.addEventListener("message", (message) => {
+      const { type, payload } = message.data;
+      switch (type) {
+        case "connection:open": {
+          this.onRemoteConnection(payload.clientId, new URL(payload.url));
+          break;
+        }
+      }
+    });
+  }
+  /**
+   * All active WebSocket client connections.
+   */
+  clients;
+  /**
+   * Adds the given `WebSocket` client connection to the set
+   * of all connections. The given connection is always the complete
+   * connection object because `addConnection()` is called only
+   * for the opened connections in the same runtime.
+   */
+  addConnection(client) {
+    this.clients.add(client);
+    this.channel.postMessage({
+      type: "connection:open",
+      payload: {
+        clientId: client.id,
+        url: client.url.toString()
+      }
+    });
+    const handleExtraneousMessage = (message) => {
+      const { type, payload } = message.data;
+      if (typeof payload === "object" && "clientId" in payload && payload.clientId !== client.id) {
+        return;
+      }
+      switch (type) {
+        case "extraneous:send": {
+          client.send(payload.data);
+          break;
+        }
+        case "extraneous:close": {
+          client.close(payload.code, payload.reason);
+          break;
+        }
+      }
+    };
+    const abortController = new AbortController();
+    this.channel.addEventListener("message", handleExtraneousMessage, {
+      signal: abortController.signal
+    });
+    client.addEventListener("close", () => abortController.abort(), {
+      once: true
+    });
+  }
+  /**
+   * Adds a client connection wrapper to operate with
+   * WebSocket client connections in other runtimes.
+   */
+  onRemoteConnection(id, url) {
+    this.clients.add(
+      // Create a connection-compatible instance that can
+      // operate with this client from a different runtime
+      // using the BroadcastChannel messages.
+      new WebSocketRemoteClientConnection(id, url, this.channel)
+    );
+  }
+}
+class WebSocketRemoteClientConnection {
+  constructor(id, url, channel) {
+    this.id = id;
+    this.url = url;
+    this.channel = channel;
+  }
+  send(data) {
+    this.channel.postMessage({
+      type: "extraneous:send",
+      payload: {
+        clientId: this.id,
+        data
+      }
+    });
+  }
+  close(code, reason) {
+    this.channel.postMessage({
+      type: "extraneous:close",
+      payload: {
+        clientId: this.id,
+        code,
+        reason
+      }
+    });
+  }
+}
+//# sourceMappingURL=WebSocketClientManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/ws/WebSocketClientManager.ts"],"sourcesContent":["import type {\n  WebSocketData,\n  WebSocketClientConnection,\n  WebSocketClientConnectionProtocol,\n} from '@mswjs/interceptors/WebSocket'\n\nexport type WebSocketBroadcastChannelMessage =\n  | {\n      type: 'connection:open'\n      payload: {\n        clientId: string\n        url: string\n      }\n    }\n  | {\n      type: 'extraneous:send'\n      payload: {\n        clientId: string\n        data: WebSocketData\n      }\n    }\n  | {\n      type: 'extraneous:close'\n      payload: {\n        clientId: string\n        code?: number\n        reason?: string\n      }\n    }\n\nexport const kAddByClientId = Symbol('kAddByClientId')\n\n/**\n * A manager responsible for accumulating WebSocket client\n * connections across different browser runtimes.\n */\nexport class WebSocketClientManager {\n  /**\n   * All active WebSocket client connections.\n   */\n  public clients: Set<WebSocketClientConnectionProtocol>\n\n  constructor(private channel: BroadcastChannel) {\n    this.clients = new Set()\n\n    this.channel.addEventListener('message', (message) => {\n      const { type, payload } = message.data as WebSocketBroadcastChannelMessage\n\n      switch (type) {\n        case 'connection:open': {\n          // When another runtime notifies about a new connection,\n          // create a connection wrapper class and add it to the set.\n          this.onRemoteConnection(payload.clientId, new URL(payload.url))\n          break\n        }\n      }\n    })\n  }\n\n  /**\n   * Adds the given `WebSocket` client connection to the set\n   * of all connections. The given connection is always the complete\n   * connection object because `addConnection()` is called only\n   * for the opened connections in the same runtime.\n   */\n  public addConnection(client: WebSocketClientConnection): void {\n    this.clients.add(client)\n\n    // Signal to other runtimes about this connection.\n    this.channel.postMessage({\n      type: 'connection:open',\n      payload: {\n        clientId: client.id,\n        url: client.url.toString(),\n      },\n    } as WebSocketBroadcastChannelMessage)\n\n    // Instruct the current client how to handle events\n    // coming from other runtimes (e.g. when calling `.broadcast()`).\n    const handleExtraneousMessage = (\n      message: MessageEvent<WebSocketBroadcastChannelMessage>,\n    ) => {\n      const { type, payload } = message.data\n\n      // Ignore broadcasted messages for other clients.\n      if (\n        typeof payload === 'object' &&\n        'clientId' in payload &&\n        payload.clientId !== client.id\n      ) {\n        return\n      }\n\n      switch (type) {\n        case 'extraneous:send': {\n          client.send(payload.data)\n          break\n        }\n\n        case 'extraneous:close': {\n          client.close(payload.code, payload.reason)\n          break\n        }\n      }\n    }\n\n    const abortController = new AbortController()\n\n    this.channel.addEventListener('message', handleExtraneousMessage, {\n      signal: abortController.signal,\n    })\n\n    // Once closed, this connection cannot be operated on.\n    // This must include the extraneous runtimes as well.\n    client.addEventListener('close', () => abortController.abort(), {\n      once: true,\n    })\n  }\n\n  /**\n   * Adds a client connection wrapper to operate with\n   * WebSocket client connections in other runtimes.\n   */\n  private onRemoteConnection(id: string, url: URL): void {\n    this.clients.add(\n      // Create a connection-compatible instance that can\n      // operate with this client from a different runtime\n      // using the BroadcastChannel messages.\n      new WebSocketRemoteClientConnection(id, url, this.channel),\n    )\n  }\n}\n\n/**\n * A wrapper class to operate with WebSocket client connections\n * from other runtimes. This class maintains 1-1 public API\n * compatibility to the `WebSocketClientConnection` but relies\n * on the given `BroadcastChannel` to communicate instructions\n * with the client connections from other runtimes.\n */\nexport class WebSocketRemoteClientConnection\n  implements WebSocketClientConnectionProtocol\n{\n  constructor(\n    public readonly id: string,\n    public readonly url: URL,\n    private channel: BroadcastChannel,\n  ) {}\n\n  send(data: WebSocketData): void {\n    this.channel.postMessage({\n      type: 'extraneous:send',\n      payload: {\n        clientId: this.id,\n        data,\n      },\n    } as WebSocketBroadcastChannelMessage)\n  }\n\n  close(code?: number | undefined, reason?: string | undefined): void {\n    this.channel.postMessage({\n      type: 'extraneous:close',\n      payload: {\n        clientId: this.id,\n        code,\n        reason,\n      },\n    } as WebSocketBroadcastChannelMessage)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BO,MAAM,iBAAiB,OAAO,gBAAgB;AAM9C,MAAM,uBAAuB;AAAA,EAMlC,YAAoB,SAA2B;AAA3B;AAClB,SAAK,UAAU,oBAAI,IAAI;AAEvB,SAAK,QAAQ,iBAAiB,WAAW,CAAC,YAAY;AACpD,YAAM,EAAE,MAAM,QAAQ,IAAI,QAAQ;AAElC,cAAQ,MAAM;AAAA,QACZ,KAAK,mBAAmB;AAGtB,eAAK,mBAAmB,QAAQ,UAAU,IAAI,IAAI,QAAQ,GAAG,CAAC;AAC9D;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAjBO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,cAAc,QAAyC;AAC5D,SAAK,QAAQ,IAAI,MAAM;AAGvB,SAAK,QAAQ,YAAY;AAAA,MACvB,MAAM;AAAA,MACN,SAAS;AAAA,QACP,UAAU,OAAO;AAAA,QACjB,KAAK,OAAO,IAAI,SAAS;AAAA,MAC3B;AAAA,IACF,CAAqC;AAIrC,UAAM,0BAA0B,CAC9B,YACG;AACH,YAAM,EAAE,MAAM,QAAQ,IAAI,QAAQ;AAGlC,UACE,OAAO,YAAY,YACnB,cAAc,WACd,QAAQ,aAAa,OAAO,IAC5B;AACA;AAAA,MACF;AAEA,cAAQ,MAAM;AAAA,QACZ,KAAK,mBAAmB;AACtB,iBAAO,KAAK,QAAQ,IAAI;AACxB;AAAA,QACF;AAAA,QAEA,KAAK,oBAAoB;AACvB,iBAAO,MAAM,QAAQ,MAAM,QAAQ,MAAM;AACzC;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,kBAAkB,IAAI,gBAAgB;AAE5C,SAAK,QAAQ,iBAAiB,WAAW,yBAAyB;AAAA,MAChE,QAAQ,gBAAgB;AAAA,IAC1B,CAAC;AAID,WAAO,iBAAiB,SAAS,MAAM,gBAAgB,MAAM,GAAG;AAAA,MAC9D,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,mBAAmB,IAAY,KAAgB;AACrD,SAAK,QAAQ;AAAA;AAAA;AAAA;AAAA,MAIX,IAAI,gCAAgC,IAAI,KAAK,KAAK,OAAO;AAAA,IAC3D;AAAA,EACF;AACF;AASO,MAAM,gCAEb;AAAA,EACE,YACkB,IACA,KACR,SACR;AAHgB;AACA;AACR;AAAA,EACP;AAAA,EAEH,KAAK,MAA2B;AAC9B,SAAK,QAAQ,YAAY;AAAA,MACvB,MAAM;AAAA,MACN,SAAS;AAAA,QACP,UAAU,KAAK;AAAA,QACf;AAAA,MACF;AAAA,IACF,CAAqC;AAAA,EACvC;AAAA,EAEA,MAAM,MAA2B,QAAmC;AAClE,SAAK,QAAQ,YAAY;AAAA,MACvB,MAAM;AAAA,MACN,SAAS;AAAA,QACP,UAAU,KAAK;AAAA,QACf;AAAA,QACA;AAAA,MACF;AAAA,IACF,CAAqC;AAAA,EACvC;AACF;","names":[]}

package/lib/core/ws/WebSocketClientManager.mjs

@@ -0,0 +1,103 @@
+const kAddByClientId = Symbol("kAddByClientId");
+class WebSocketClientManager {
+  constructor(channel) {
+    this.channel = channel;
+    this.clients = /* @__PURE__ */ new Set();
+    this.channel.addEventListener("message", (message) => {
+      const { type, payload } = message.data;
+      switch (type) {
+        case "connection:open": {
+          this.onRemoteConnection(payload.clientId, new URL(payload.url));
+          break;
+        }
+      }
+    });
+  }
+  /**
+   * All active WebSocket client connections.
+   */
+  clients;
+  /**
+   * Adds the given `WebSocket` client connection to the set
+   * of all connections. The given connection is always the complete
+   * connection object because `addConnection()` is called only
+   * for the opened connections in the same runtime.
+   */
+  addConnection(client) {
+    this.clients.add(client);
+    this.channel.postMessage({
+      type: "connection:open",
+      payload: {
+        clientId: client.id,
+        url: client.url.toString()
+      }
+    });
+    const handleExtraneousMessage = (message) => {
+      const { type, payload } = message.data;
+      if (typeof payload === "object" && "clientId" in payload && payload.clientId !== client.id) {
+        return;
+      }
+      switch (type) {
+        case "extraneous:send": {
+          client.send(payload.data);
+          break;
+        }
+        case "extraneous:close": {
+          client.close(payload.code, payload.reason);
+          break;
+        }
+      }
+    };
+    const abortController = new AbortController();
+    this.channel.addEventListener("message", handleExtraneousMessage, {
+      signal: abortController.signal
+    });
+    client.addEventListener("close", () => abortController.abort(), {
+      once: true
+    });
+  }
+  /**
+   * Adds a client connection wrapper to operate with
+   * WebSocket client connections in other runtimes.
+   */
+  onRemoteConnection(id, url) {
+    this.clients.add(
+      // Create a connection-compatible instance that can
+      // operate with this client from a different runtime
+      // using the BroadcastChannel messages.
+      new WebSocketRemoteClientConnection(id, url, this.channel)
+    );
+  }
+}
+class WebSocketRemoteClientConnection {
+  constructor(id, url, channel) {
+    this.id = id;
+    this.url = url;
+    this.channel = channel;
+  }
+  send(data) {
+    this.channel.postMessage({
+      type: "extraneous:send",
+      payload: {
+        clientId: this.id,
+        data
+      }
+    });
+  }
+  close(code, reason) {
+    this.channel.postMessage({
+      type: "extraneous:close",
+      payload: {
+        clientId: this.id,
+        code,
+        reason
+      }
+    });
+  }
+}
+export {
+  WebSocketClientManager,
+  WebSocketRemoteClientConnection,
+  kAddByClientId
+};
+//# sourceMappingURL=WebSocketClientManager.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/ws/WebSocketClientManager.ts"],"sourcesContent":["import type {\n  WebSocketData,\n  WebSocketClientConnection,\n  WebSocketClientConnectionProtocol,\n} from '@mswjs/interceptors/WebSocket'\n\nexport type WebSocketBroadcastChannelMessage =\n  | {\n      type: 'connection:open'\n      payload: {\n        clientId: string\n        url: string\n      }\n    }\n  | {\n      type: 'extraneous:send'\n      payload: {\n        clientId: string\n        data: WebSocketData\n      }\n    }\n  | {\n      type: 'extraneous:close'\n      payload: {\n        clientId: string\n        code?: number\n        reason?: string\n      }\n    }\n\nexport const kAddByClientId = Symbol('kAddByClientId')\n\n/**\n * A manager responsible for accumulating WebSocket client\n * connections across different browser runtimes.\n */\nexport class WebSocketClientManager {\n  /**\n   * All active WebSocket client connections.\n   */\n  public clients: Set<WebSocketClientConnectionProtocol>\n\n  constructor(private channel: BroadcastChannel) {\n    this.clients = new Set()\n\n    this.channel.addEventListener('message', (message) => {\n      const { type, payload } = message.data as WebSocketBroadcastChannelMessage\n\n      switch (type) {\n        case 'connection:open': {\n          // When another runtime notifies about a new connection,\n          // create a connection wrapper class and add it to the set.\n          this.onRemoteConnection(payload.clientId, new URL(payload.url))\n          break\n        }\n      }\n    })\n  }\n\n  /**\n   * Adds the given `WebSocket` client connection to the set\n   * of all connections. The given connection is always the complete\n   * connection object because `addConnection()` is called only\n   * for the opened connections in the same runtime.\n   */\n  public addConnection(client: WebSocketClientConnection): void {\n    this.clients.add(client)\n\n    // Signal to other runtimes about this connection.\n    this.channel.postMessage({\n      type: 'connection:open',\n      payload: {\n        clientId: client.id,\n        url: client.url.toString(),\n      },\n    } as WebSocketBroadcastChannelMessage)\n\n    // Instruct the current client how to handle events\n    // coming from other runtimes (e.g. when calling `.broadcast()`).\n    const handleExtraneousMessage = (\n      message: MessageEvent<WebSocketBroadcastChannelMessage>,\n    ) => {\n      const { type, payload } = message.data\n\n      // Ignore broadcasted messages for other clients.\n      if (\n        typeof payload === 'object' &&\n        'clientId' in payload &&\n        payload.clientId !== client.id\n      ) {\n        return\n      }\n\n      switch (type) {\n        case 'extraneous:send': {\n          client.send(payload.data)\n          break\n        }\n\n        case 'extraneous:close': {\n          client.close(payload.code, payload.reason)\n          break\n        }\n      }\n    }\n\n    const abortController = new AbortController()\n\n    this.channel.addEventListener('message', handleExtraneousMessage, {\n      signal: abortController.signal,\n    })\n\n    // Once closed, this connection cannot be operated on.\n    // This must include the extraneous runtimes as well.\n    client.addEventListener('close', () => abortController.abort(), {\n      once: true,\n    })\n  }\n\n  /**\n   * Adds a client connection wrapper to operate with\n   * WebSocket client connections in other runtimes.\n   */\n  private onRemoteConnection(id: string, url: URL): void {\n    this.clients.add(\n      // Create a connection-compatible instance that can\n      // operate with this client from a different runtime\n      // using the BroadcastChannel messages.\n      new WebSocketRemoteClientConnection(id, url, this.channel),\n    )\n  }\n}\n\n/**\n * A wrapper class to operate with WebSocket client connections\n * from other runtimes. This class maintains 1-1 public API\n * compatibility to the `WebSocketClientConnection` but relies\n * on the given `BroadcastChannel` to communicate instructions\n * with the client connections from other runtimes.\n */\nexport class WebSocketRemoteClientConnection\n  implements WebSocketClientConnectionProtocol\n{\n  constructor(\n    public readonly id: string,\n    public readonly url: URL,\n    private channel: BroadcastChannel,\n  ) {}\n\n  send(data: WebSocketData): void {\n    this.channel.postMessage({\n      type: 'extraneous:send',\n      payload: {\n        clientId: this.id,\n        data,\n      },\n    } as WebSocketBroadcastChannelMessage)\n  }\n\n  close(code?: number | undefined, reason?: string | undefined): void {\n    this.channel.postMessage({\n      type: 'extraneous:close',\n      payload: {\n        clientId: this.id,\n        code,\n        reason,\n      },\n    } as WebSocketBroadcastChannelMessage)\n  }\n}\n"],"mappings":"AA8BO,MAAM,iBAAiB,OAAO,gBAAgB;AAM9C,MAAM,uBAAuB;AAAA,EAMlC,YAAoB,SAA2B;AAA3B;AAClB,SAAK,UAAU,oBAAI,IAAI;AAEvB,SAAK,QAAQ,iBAAiB,WAAW,CAAC,YAAY;AACpD,YAAM,EAAE,MAAM,QAAQ,IAAI,QAAQ;AAElC,cAAQ,MAAM;AAAA,QACZ,KAAK,mBAAmB;AAGtB,eAAK,mBAAmB,QAAQ,UAAU,IAAI,IAAI,QAAQ,GAAG,CAAC;AAC9D;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAjBO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,cAAc,QAAyC;AAC5D,SAAK,QAAQ,IAAI,MAAM;AAGvB,SAAK,QAAQ,YAAY;AAAA,MACvB,MAAM;AAAA,MACN,SAAS;AAAA,QACP,UAAU,OAAO;AAAA,QACjB,KAAK,OAAO,IAAI,SAAS;AAAA,MAC3B;AAAA,IACF,CAAqC;AAIrC,UAAM,0BAA0B,CAC9B,YACG;AACH,YAAM,EAAE,MAAM,QAAQ,IAAI,QAAQ;AAGlC,UACE,OAAO,YAAY,YACnB,cAAc,WACd,QAAQ,aAAa,OAAO,IAC5B;AACA;AAAA,MACF;AAEA,cAAQ,MAAM;AAAA,QACZ,KAAK,mBAAmB;AACtB,iBAAO,KAAK,QAAQ,IAAI;AACxB;AAAA,QACF;AAAA,QAEA,KAAK,oBAAoB;AACvB,iBAAO,MAAM,QAAQ,MAAM,QAAQ,MAAM;AACzC;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,kBAAkB,IAAI,gBAAgB;AAE5C,SAAK,QAAQ,iBAAiB,WAAW,yBAAyB;AAAA,MAChE,QAAQ,gBAAgB;AAAA,IAC1B,CAAC;AAID,WAAO,iBAAiB,SAAS,MAAM,gBAAgB,MAAM,GAAG;AAAA,MAC9D,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,mBAAmB,IAAY,KAAgB;AACrD,SAAK,QAAQ;AAAA;AAAA;AAAA;AAAA,MAIX,IAAI,gCAAgC,IAAI,KAAK,KAAK,OAAO;AAAA,IAC3D;AAAA,EACF;AACF;AASO,MAAM,gCAEb;AAAA,EACE,YACkB,IACA,KACR,SACR;AAHgB;AACA;AACR;AAAA,EACP;AAAA,EAEH,KAAK,MAA2B;AAC9B,SAAK,QAAQ,YAAY;AAAA,MACvB,MAAM;AAAA,MACN,SAAS;AAAA,QACP,UAAU,KAAK;AAAA,QACf;AAAA,MACF;AAAA,IACF,CAAqC;AAAA,EACvC;AAAA,EAEA,MAAM,MAA2B,QAAmC;AAClE,SAAK,QAAQ,YAAY;AAAA,MACvB,MAAM;AAAA,MACN,SAAS;AAAA,QACP,UAAU,KAAK;AAAA,QACf;AAAA,QACA;AAAA,MACF;AAAA,IACF,CAAqC;AAAA,EACvC;AACF;","names":[]}

package/lib/core/ws/utils/attachWebSocketLogger.d.mts

@@ -0,0 +1,34 @@
+import { WebSocketConnectionData, WebSocketClientConnection, WebSocketData } from '@mswjs/interceptors/WebSocket';
+
+declare function attachWebSocketLogger(connection: WebSocketConnectionData): void;
+/**
+ * Prints the WebSocket connection.
+ * This is meant to be logged by every WebSocket handler
+ * that intercepted this connection. This helps you see
+ * what handlers observe this connection.
+ */
+declare function logConnectionOpen(client: WebSocketClientConnection): void;
+/**
+ * Prints the outgoing client message.
+ */
+declare function logOutgoingClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+/**
+ * Prints the outgoing client message initiated
+ * by `server.send()` in the event handler.
+ */
+declare function logOutgoingMockedClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+/**
+ * Prings the message received by the WebSocket client.
+ * This is fired when the "message" event is dispatched
+ * on the actual WebSocket client instance, and translates to
+ * the client receiving a message from the server.
+ */
+declare function logIncomingClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+/**
+ * Prints the outgoing client message initiated
+ * by `client.send()` in the event handler.
+ */
+declare function logIncomingMockedClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+declare function logIncomingServerMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+
+export { attachWebSocketLogger, logConnectionOpen, logIncomingClientMessage, logIncomingMockedClientMessage, logIncomingServerMessage, logOutgoingClientMessage, logOutgoingMockedClientMessage };

package/lib/core/ws/utils/attachWebSocketLogger.d.ts

@@ -0,0 +1,34 @@
+import { WebSocketConnectionData, WebSocketClientConnection, WebSocketData } from '@mswjs/interceptors/WebSocket';
+
+declare function attachWebSocketLogger(connection: WebSocketConnectionData): void;
+/**
+ * Prints the WebSocket connection.
+ * This is meant to be logged by every WebSocket handler
+ * that intercepted this connection. This helps you see
+ * what handlers observe this connection.
+ */
+declare function logConnectionOpen(client: WebSocketClientConnection): void;
+/**
+ * Prints the outgoing client message.
+ */
+declare function logOutgoingClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+/**
+ * Prints the outgoing client message initiated
+ * by `server.send()` in the event handler.
+ */
+declare function logOutgoingMockedClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+/**
+ * Prings the message received by the WebSocket client.
+ * This is fired when the "message" event is dispatched
+ * on the actual WebSocket client instance, and translates to
+ * the client receiving a message from the server.
+ */
+declare function logIncomingClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+/**
+ * Prints the outgoing client message initiated
+ * by `client.send()` in the event handler.
+ */
+declare function logIncomingMockedClientMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+declare function logIncomingServerMessage(event: MessageEvent<WebSocketData>): Promise<void>;
+
+export { attachWebSocketLogger, logConnectionOpen, logIncomingClientMessage, logIncomingMockedClientMessage, logIncomingServerMessage, logOutgoingClientMessage, logOutgoingMockedClientMessage };