msw 2.13.6 → 2.14.0

package/lib/core/utils/HttpResponse/decorators.js

@@ -29,12 +29,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var decorators_exports = {};
 __export(decorators_exports, {
   decorateResponse: () => decorateResponse,
-  kSetCookie: () => kSetCookie,
+  getRawSetCookie: () => getRawSetCookie,
   normalizeResponseInit: () => normalizeResponseInit
 });
 module.exports = __toCommonJS(decorators_exports);
 var import_statuses = __toESM(require("../../../shims/statuses"), 1);
-var import_headers_polyfill = require("headers-polyfill");
 const { message } = import_statuses.default;
 const kSetCookie = Symbol("kSetCookie");
 function normalizeResponseInit(init = {}) {
@@ -63,15 +62,10 @@ function decorateResponse(response, init) {
       enumerable: false,
       writable: false
     });
-    if (typeof document !== "undefined") {
-      const responseCookiePairs = import_headers_polyfill.Headers.prototype.getSetCookie.call(
-        init.headers
-      );
-      for (const cookieString of responseCookiePairs) {
-        document.cookie = cookieString;
-      }
-    }
   }
   return response;
 }
+function getRawSetCookie(response) {
+  return Reflect.get(response, kSetCookie);
+}
 //# sourceMappingURL=decorators.js.map

package/lib/core/utils/HttpResponse/decorators.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/utils/HttpResponse/decorators.ts"],"sourcesContent":["import statuses from '../../../shims/statuses'\nimport { Headers as HeadersPolyfill } from 'headers-polyfill'\nimport type { HttpResponseInit } from '../../HttpResponse'\n\nconst { message } = statuses\n\nexport const kSetCookie = Symbol('kSetCookie')\n\nexport interface HttpResponseDecoratedInit extends HttpResponseInit {\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nexport function normalizeResponseInit(\n  init: HttpResponseInit = {},\n): HttpResponseDecoratedInit {\n  const status = init?.status || 200\n  const statusText = init?.statusText || message[status] || ''\n  const headers = new Headers(init?.headers)\n\n  return {\n    ...init,\n    headers,\n    status,\n    statusText,\n  }\n}\n\nexport function decorateResponse(\n  response: Response,\n  init: HttpResponseDecoratedInit,\n): Response {\n  // Allow to mock the response type.\n  if (init.type) {\n    Object.defineProperty(response, 'type', {\n      value: init.type,\n      enumerable: true,\n      writable: false,\n    })\n  }\n\n  const responseCookies = init.headers.get('set-cookie')\n\n  if (responseCookies) {\n    // Record the raw \"Set-Cookie\" response header provided\n    // in the HeadersInit. This is later used to store these cookies\n    // in cookie jar and return the right cookies in the \"cookies\"\n    // response resolver argument.\n    Object.defineProperty(response, kSetCookie, {\n      value: responseCookies,\n      enumerable: false,\n      writable: false,\n    })\n\n    // Cookie forwarding is only relevant in the browser.\n    if (typeof document !== 'undefined') {\n      // Write the mocked response cookies to the document.\n      // Use `headers-polyfill` to get the Set-Cookie header value correctly.\n      // This is an alternative until TypeScript 5.2\n      // and Node.js v20 become the minimum supported version\n      // and getSetCookie in Headers can be used directly.\n      const responseCookiePairs = HeadersPolyfill.prototype.getSetCookie.call(\n        init.headers,\n      )\n\n      for (const cookieString of responseCookiePairs) {\n        // No need to parse the cookie headers because it's defined\n        // as the valid cookie string to begin with.\n        document.cookie = cookieString\n      }\n    }\n  }\n\n  return response\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAqB;AACrB,8BAA2C;AAG3C,MAAM,EAAE,QAAQ,IAAI,gBAAAA;AAEb,MAAM,aAAa,OAAO,YAAY;AAQtC,SAAS,sBACd,OAAyB,CAAC,GACC;AAC3B,QAAM,SAAS,MAAM,UAAU;AAC/B,QAAM,aAAa,MAAM,cAAc,QAAQ,MAAM,KAAK;AAC1D,QAAM,UAAU,IAAI,QAAQ,MAAM,OAAO;AAEzC,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,iBACd,UACA,MACU;AAEV,MAAI,KAAK,MAAM;AACb,WAAO,eAAe,UAAU,QAAQ;AAAA,MACtC,OAAO,KAAK;AAAA,MACZ,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,QAAM,kBAAkB,KAAK,QAAQ,IAAI,YAAY;AAErD,MAAI,iBAAiB;AAKnB,WAAO,eAAe,UAAU,YAAY;AAAA,MAC1C,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAGD,QAAI,OAAO,aAAa,aAAa;AAMnC,YAAM,sBAAsB,wBAAAC,QAAgB,UAAU,aAAa;AAAA,QACjE,KAAK;AAAA,MACP;AAEA,iBAAW,gBAAgB,qBAAqB;AAG9C,iBAAS,SAAS;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":["statuses","HeadersPolyfill"]}
+{"version":3,"sources":["../../../../src/core/utils/HttpResponse/decorators.ts"],"sourcesContent":["import statuses from '../../../shims/statuses'\nimport type { HttpResponseInit } from '../../HttpResponse'\n\nconst { message } = statuses\n\nconst kSetCookie = Symbol('kSetCookie')\n\nexport interface HttpResponseDecoratedInit extends HttpResponseInit {\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nexport function normalizeResponseInit(\n  init: HttpResponseInit = {},\n): HttpResponseDecoratedInit {\n  const status = init?.status || 200\n  const statusText = init?.statusText || message[status] || ''\n  const headers = new Headers(init?.headers)\n\n  return {\n    ...init,\n    headers,\n    status,\n    statusText,\n  }\n}\n\nexport function decorateResponse(\n  response: Response,\n  init: HttpResponseDecoratedInit,\n): Response {\n  // Allow mocking the response type.\n  if (init.type) {\n    Object.defineProperty(response, 'type', {\n      value: init.type,\n      enumerable: true,\n      writable: false,\n    })\n  }\n\n  const responseCookies = init.headers.get('set-cookie')\n\n  if (responseCookies) {\n    // Record the raw \"Set-Cookie\" response header provided\n    // in the HeadersInit. This is later used to store these cookies\n    // in cookie jar and return the right cookies in the \"cookies\"\n    // response resolver argument.\n    Object.defineProperty(response, kSetCookie, {\n      value: responseCookies,\n      enumerable: false,\n      writable: false,\n    })\n  }\n\n  return response\n}\n\nexport function getRawSetCookie(response: Response): string | undefined {\n  return Reflect.get(response, kSetCookie)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAqB;AAGrB,MAAM,EAAE,QAAQ,IAAI,gBAAAA;AAEpB,MAAM,aAAa,OAAO,YAAY;AAQ/B,SAAS,sBACd,OAAyB,CAAC,GACC;AAC3B,QAAM,SAAS,MAAM,UAAU;AAC/B,QAAM,aAAa,MAAM,cAAc,QAAQ,MAAM,KAAK;AAC1D,QAAM,UAAU,IAAI,QAAQ,MAAM,OAAO;AAEzC,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,iBACd,UACA,MACU;AAEV,MAAI,KAAK,MAAM;AACb,WAAO,eAAe,UAAU,QAAQ;AAAA,MACtC,OAAO,KAAK;AAAA,MACZ,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,QAAM,kBAAkB,KAAK,QAAQ,IAAI,YAAY;AAErD,MAAI,iBAAiB;AAKnB,WAAO,eAAe,UAAU,YAAY;AAAA,MAC1C,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEO,SAAS,gBAAgB,UAAwC;AACtE,SAAO,QAAQ,IAAI,UAAU,UAAU;AACzC;","names":["statuses"]}

package/lib/core/utils/HttpResponse/decorators.mjs

@@ -1,5 +1,4 @@
 import statuses from '../../../shims/statuses.mjs';
-import { Headers as HeadersPolyfill } from "headers-polyfill";
 const { message } = statuses;
 const kSetCookie = Symbol("kSetCookie");
 function normalizeResponseInit(init = {}) {
@@ -28,20 +27,15 @@ function decorateResponse(response, init) {
       enumerable: false,
       writable: false
     });
-    if (typeof document !== "undefined") {
-      const responseCookiePairs = HeadersPolyfill.prototype.getSetCookie.call(
-        init.headers
-      );
-      for (const cookieString of responseCookiePairs) {
-        document.cookie = cookieString;
-      }
-    }
   }
   return response;
 }
+function getRawSetCookie(response) {
+  return Reflect.get(response, kSetCookie);
+}
 export {
   decorateResponse,
-  kSetCookie,
+  getRawSetCookie,
   normalizeResponseInit
 };
 //# sourceMappingURL=decorators.mjs.map

package/lib/core/utils/HttpResponse/decorators.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/utils/HttpResponse/decorators.ts"],"sourcesContent":["import statuses from '../../../shims/statuses'\nimport { Headers as HeadersPolyfill } from 'headers-polyfill'\nimport type { HttpResponseInit } from '../../HttpResponse'\n\nconst { message } = statuses\n\nexport const kSetCookie = Symbol('kSetCookie')\n\nexport interface HttpResponseDecoratedInit extends HttpResponseInit {\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nexport function normalizeResponseInit(\n  init: HttpResponseInit = {},\n): HttpResponseDecoratedInit {\n  const status = init?.status || 200\n  const statusText = init?.statusText || message[status] || ''\n  const headers = new Headers(init?.headers)\n\n  return {\n    ...init,\n    headers,\n    status,\n    statusText,\n  }\n}\n\nexport function decorateResponse(\n  response: Response,\n  init: HttpResponseDecoratedInit,\n): Response {\n  // Allow to mock the response type.\n  if (init.type) {\n    Object.defineProperty(response, 'type', {\n      value: init.type,\n      enumerable: true,\n      writable: false,\n    })\n  }\n\n  const responseCookies = init.headers.get('set-cookie')\n\n  if (responseCookies) {\n    // Record the raw \"Set-Cookie\" response header provided\n    // in the HeadersInit. This is later used to store these cookies\n    // in cookie jar and return the right cookies in the \"cookies\"\n    // response resolver argument.\n    Object.defineProperty(response, kSetCookie, {\n      value: responseCookies,\n      enumerable: false,\n      writable: false,\n    })\n\n    // Cookie forwarding is only relevant in the browser.\n    if (typeof document !== 'undefined') {\n      // Write the mocked response cookies to the document.\n      // Use `headers-polyfill` to get the Set-Cookie header value correctly.\n      // This is an alternative until TypeScript 5.2\n      // and Node.js v20 become the minimum supported version\n      // and getSetCookie in Headers can be used directly.\n      const responseCookiePairs = HeadersPolyfill.prototype.getSetCookie.call(\n        init.headers,\n      )\n\n      for (const cookieString of responseCookiePairs) {\n        // No need to parse the cookie headers because it's defined\n        // as the valid cookie string to begin with.\n        document.cookie = cookieString\n      }\n    }\n  }\n\n  return response\n}\n"],"mappings":"AAAA,OAAO,cAAc;AACrB,SAAS,WAAW,uBAAuB;AAG3C,MAAM,EAAE,QAAQ,IAAI;AAEb,MAAM,aAAa,OAAO,YAAY;AAQtC,SAAS,sBACd,OAAyB,CAAC,GACC;AAC3B,QAAM,SAAS,MAAM,UAAU;AAC/B,QAAM,aAAa,MAAM,cAAc,QAAQ,MAAM,KAAK;AAC1D,QAAM,UAAU,IAAI,QAAQ,MAAM,OAAO;AAEzC,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,iBACd,UACA,MACU;AAEV,MAAI,KAAK,MAAM;AACb,WAAO,eAAe,UAAU,QAAQ;AAAA,MACtC,OAAO,KAAK;AAAA,MACZ,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,QAAM,kBAAkB,KAAK,QAAQ,IAAI,YAAY;AAErD,MAAI,iBAAiB;AAKnB,WAAO,eAAe,UAAU,YAAY;AAAA,MAC1C,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAGD,QAAI,OAAO,aAAa,aAAa;AAMnC,YAAM,sBAAsB,gBAAgB,UAAU,aAAa;AAAA,QACjE,KAAK;AAAA,MACP;AAEA,iBAAW,gBAAgB,qBAAqB;AAG9C,iBAAS,SAAS;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../../src/core/utils/HttpResponse/decorators.ts"],"sourcesContent":["import statuses from '../../../shims/statuses'\nimport type { HttpResponseInit } from '../../HttpResponse'\n\nconst { message } = statuses\n\nconst kSetCookie = Symbol('kSetCookie')\n\nexport interface HttpResponseDecoratedInit extends HttpResponseInit {\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nexport function normalizeResponseInit(\n  init: HttpResponseInit = {},\n): HttpResponseDecoratedInit {\n  const status = init?.status || 200\n  const statusText = init?.statusText || message[status] || ''\n  const headers = new Headers(init?.headers)\n\n  return {\n    ...init,\n    headers,\n    status,\n    statusText,\n  }\n}\n\nexport function decorateResponse(\n  response: Response,\n  init: HttpResponseDecoratedInit,\n): Response {\n  // Allow mocking the response type.\n  if (init.type) {\n    Object.defineProperty(response, 'type', {\n      value: init.type,\n      enumerable: true,\n      writable: false,\n    })\n  }\n\n  const responseCookies = init.headers.get('set-cookie')\n\n  if (responseCookies) {\n    // Record the raw \"Set-Cookie\" response header provided\n    // in the HeadersInit. This is later used to store these cookies\n    // in cookie jar and return the right cookies in the \"cookies\"\n    // response resolver argument.\n    Object.defineProperty(response, kSetCookie, {\n      value: responseCookies,\n      enumerable: false,\n      writable: false,\n    })\n  }\n\n  return response\n}\n\nexport function getRawSetCookie(response: Response): string | undefined {\n  return Reflect.get(response, kSetCookie)\n}\n"],"mappings":"AAAA,OAAO,cAAc;AAGrB,MAAM,EAAE,QAAQ,IAAI;AAEpB,MAAM,aAAa,OAAO,YAAY;AAQ/B,SAAS,sBACd,OAAyB,CAAC,GACC;AAC3B,QAAM,SAAS,MAAM,UAAU;AAC/B,QAAM,aAAa,MAAM,cAAc,QAAQ,MAAM,KAAK;AAC1D,QAAM,UAAU,IAAI,QAAQ,MAAM,OAAO;AAEzC,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,iBACd,UACA,MACU;AAEV,MAAI,KAAK,MAAM;AACb,WAAO,eAAe,UAAU,QAAQ;AAAA,MACtC,OAAO,KAAK;AAAA,MACZ,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,QAAM,kBAAkB,KAAK,QAAQ,IAAI,YAAY;AAErD,MAAI,iBAAiB;AAKnB,WAAO,eAAe,UAAU,YAAY;AAAA,MAC1C,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEO,SAAS,gBAAgB,UAAwC;AACtE,SAAO,QAAQ,IAAI,UAAU,UAAU;AACzC;","names":[]}

package/lib/core/utils/executeHandlers.d.mts

@@ -1,4 +1,4 @@
-export { s as HandlersExecutionResult, m as ResponseResolutionContext, t as executeHandlers } from '../HttpResponse-BMMzfpjG.mjs';
+export { s as HandlersExecutionResult, m as ResponseResolutionContext, t as executeHandlers } from '../HttpResponse-CxHR1nNN.mjs';
 import '@mswjs/interceptors';
 import './internal/isIterable.mjs';
 import '../typeUtils.mjs';

package/lib/core/utils/executeHandlers.d.ts

@@ -1,4 +1,4 @@
-export { s as HandlersExecutionResult, m as ResponseResolutionContext, t as executeHandlers } from '../HttpResponse-DPDqE4Pb.js';
+export { s as HandlersExecutionResult, m as ResponseResolutionContext, t as executeHandlers } from '../HttpResponse-aGiIzO91.js';
 import '@mswjs/interceptors';
 import './internal/isIterable.js';
 import '../typeUtils.js';

package/lib/core/utils/handleRequest.d.mts

@@ -1,7 +1,7 @@
 import { Emitter } from 'strict-event-emitter';
 import { SharedOptions, LifeCycleEventsMap } from '../sharedOptions.mjs';
 import { RequiredDeep } from '../typeUtils.mjs';
-import { R as RequestHandler, m as ResponseResolutionContext, s as HandlersExecutionResult } from '../HttpResponse-BMMzfpjG.mjs';
+import { R as RequestHandler, m as ResponseResolutionContext, s as HandlersExecutionResult } from '../HttpResponse-CxHR1nNN.mjs';
 import 'rettime';
 import './request/onUnhandledRequest.mjs';
 import '@mswjs/interceptors';

package/lib/core/utils/handleRequest.d.ts

@@ -1,7 +1,7 @@
 import { Emitter } from 'strict-event-emitter';
 import { SharedOptions, LifeCycleEventsMap } from '../sharedOptions.js';
 import { RequiredDeep } from '../typeUtils.js';
-import { R as RequestHandler, m as ResponseResolutionContext, s as HandlersExecutionResult } from '../HttpResponse-DPDqE4Pb.js';
+import { R as RequestHandler, m as ResponseResolutionContext, s as HandlersExecutionResult } from '../HttpResponse-aGiIzO91.js';
 import 'rettime';
 import './request/onUnhandledRequest.js';
 import '@mswjs/interceptors';

package/lib/core/utils/internal/attachSiblingHandlers.d.mts

@@ -0,0 +1,15 @@
+import { AnyHandler } from '../../experimental/handlers-controller.mjs';
+import '../../HttpResponse-CxHR1nNN.mjs';
+import '@mswjs/interceptors';
+import './isIterable.mjs';
+import '../../typeUtils.mjs';
+import 'graphql';
+import '../matching/matchRequestUrl.mjs';
+import '../../handlers/WebSocketHandler.mjs';
+import 'strict-event-emitter';
+import '@mswjs/interceptors/WebSocket';
+
+declare function attachSiblingHandlers<T extends AnyHandler>(owner: T, siblings: Array<AnyHandler>): T;
+declare function getSiblingHandlers(owner: AnyHandler): Array<AnyHandler>;
+
+export { attachSiblingHandlers, getSiblingHandlers };

package/lib/core/utils/internal/attachSiblingHandlers.d.ts

@@ -0,0 +1,15 @@
+import { AnyHandler } from '../../experimental/handlers-controller.js';
+import '../../HttpResponse-aGiIzO91.js';
+import '@mswjs/interceptors';
+import './isIterable.js';
+import '../../typeUtils.js';
+import 'graphql';
+import '../matching/matchRequestUrl.js';
+import '../../handlers/WebSocketHandler.js';
+import 'strict-event-emitter';
+import '@mswjs/interceptors/WebSocket';
+
+declare function attachSiblingHandlers<T extends AnyHandler>(owner: T, siblings: Array<AnyHandler>): T;
+declare function getSiblingHandlers(owner: AnyHandler): Array<AnyHandler>;
+
+export { attachSiblingHandlers, getSiblingHandlers };

package/lib/core/utils/internal/attachSiblingHandlers.js

@@ -0,0 +1,44 @@
+"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 attachSiblingHandlers_exports = {};
+__export(attachSiblingHandlers_exports, {
+  attachSiblingHandlers: () => attachSiblingHandlers,
+  getSiblingHandlers: () => getSiblingHandlers
+});
+module.exports = __toCommonJS(attachSiblingHandlers_exports);
+var import_outvariant = require("outvariant");
+const kSiblingHandlers = Symbol("kSiblingHandlers");
+function attachSiblingHandlers(owner, siblings) {
+  (0, import_outvariant.invariant)(
+    getSiblingHandlers(owner).length === 0,
+    'Failed to merge handlers: the owner "%s" handler is already merged',
+    owner.kind
+  );
+  Object.defineProperty(owner, kSiblingHandlers, {
+    value: siblings,
+    enumerable: false,
+    writable: false,
+    configurable: false
+  });
+  return owner;
+}
+function getSiblingHandlers(owner) {
+  return Reflect.get(owner, kSiblingHandlers) || [];
+}
+//# sourceMappingURL=attachSiblingHandlers.js.map

package/lib/core/utils/internal/attachSiblingHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/utils/internal/attachSiblingHandlers.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport type { AnyHandler } from '../../experimental/handlers-controller'\n\nconst kSiblingHandlers = Symbol('kSiblingHandlers')\n\nexport function attachSiblingHandlers<T extends AnyHandler>(\n  owner: T,\n  siblings: Array<AnyHandler>,\n): T {\n  invariant(\n    getSiblingHandlers(owner).length === 0,\n    'Failed to merge handlers: the owner \"%s\" handler is already merged',\n    owner.kind,\n  )\n\n  Object.defineProperty(owner, kSiblingHandlers, {\n    value: siblings,\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  return owner\n}\n\nexport function getSiblingHandlers(owner: AnyHandler): Array<AnyHandler> {\n  return Reflect.get(owner, kSiblingHandlers) || []\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA0B;AAG1B,MAAM,mBAAmB,OAAO,kBAAkB;AAE3C,SAAS,sBACd,OACA,UACG;AACH;AAAA,IACE,mBAAmB,KAAK,EAAE,WAAW;AAAA,IACrC;AAAA,IACA,MAAM;AAAA,EACR;AAEA,SAAO,eAAe,OAAO,kBAAkB;AAAA,IAC7C,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC;AAED,SAAO;AACT;AAEO,SAAS,mBAAmB,OAAsC;AACvE,SAAO,QAAQ,IAAI,OAAO,gBAAgB,KAAK,CAAC;AAClD;","names":[]}

package/lib/core/utils/internal/attachSiblingHandlers.mjs

@@ -0,0 +1,24 @@
+import { invariant } from "outvariant";
+const kSiblingHandlers = Symbol("kSiblingHandlers");
+function attachSiblingHandlers(owner, siblings) {
+  invariant(
+    getSiblingHandlers(owner).length === 0,
+    'Failed to merge handlers: the owner "%s" handler is already merged',
+    owner.kind
+  );
+  Object.defineProperty(owner, kSiblingHandlers, {
+    value: siblings,
+    enumerable: false,
+    writable: false,
+    configurable: false
+  });
+  return owner;
+}
+function getSiblingHandlers(owner) {
+  return Reflect.get(owner, kSiblingHandlers) || [];
+}
+export {
+  attachSiblingHandlers,
+  getSiblingHandlers
+};
+//# sourceMappingURL=attachSiblingHandlers.mjs.map

package/lib/core/utils/internal/attachSiblingHandlers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/utils/internal/attachSiblingHandlers.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport type { AnyHandler } from '../../experimental/handlers-controller'\n\nconst kSiblingHandlers = Symbol('kSiblingHandlers')\n\nexport function attachSiblingHandlers<T extends AnyHandler>(\n  owner: T,\n  siblings: Array<AnyHandler>,\n): T {\n  invariant(\n    getSiblingHandlers(owner).length === 0,\n    'Failed to merge handlers: the owner \"%s\" handler is already merged',\n    owner.kind,\n  )\n\n  Object.defineProperty(owner, kSiblingHandlers, {\n    value: siblings,\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  return owner\n}\n\nexport function getSiblingHandlers(owner: AnyHandler): Array<AnyHandler> {\n  return Reflect.get(owner, kSiblingHandlers) || []\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAG1B,MAAM,mBAAmB,OAAO,kBAAkB;AAE3C,SAAS,sBACd,OACA,UACG;AACH;AAAA,IACE,mBAAmB,KAAK,EAAE,WAAW;AAAA,IACrC;AAAA,IACA,MAAM;AAAA,EACR;AAEA,SAAO,eAAe,OAAO,kBAAkB;AAAA,IAC7C,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC;AAED,SAAO;AACT;AAEO,SAAS,mBAAmB,OAAsC;AACvE,SAAO,QAAQ,IAAI,OAAO,gBAAgB,KAAK,CAAC;AAClD;","names":[]}

package/lib/core/utils/internal/isHandlerKind.d.mts

@@ -1,5 +1,5 @@
 import { AnyHandler } from '../../experimental/handlers-controller.mjs';
-import { R as RequestHandler } from '../../HttpResponse-BMMzfpjG.mjs';
+import { R as RequestHandler } from '../../HttpResponse-CxHR1nNN.mjs';
 import { WebSocketHandler } from '../../handlers/WebSocketHandler.mjs';
 import '@mswjs/interceptors';
 import './isIterable.mjs';

package/lib/core/utils/internal/isHandlerKind.d.ts

@@ -1,5 +1,5 @@
 import { AnyHandler } from '../../experimental/handlers-controller.js';
-import { R as RequestHandler } from '../../HttpResponse-DPDqE4Pb.js';
+import { R as RequestHandler } from '../../HttpResponse-aGiIzO91.js';
 import { WebSocketHandler } from '../../handlers/WebSocketHandler.js';
 import '@mswjs/interceptors';
 import './isIterable.js';

package/lib/core/utils/internal/parseGraphQLRequest.d.mts

@@ -1,5 +1,5 @@
 import 'graphql';
-export { x as GraphQLMultipartRequestBody, w as GraphQLParsedOperationsMap, u as ParsedGraphQLQuery, P as ParsedGraphQLRequest, v as parseDocumentNode, y as parseGraphQLRequest } from '../../HttpResponse-BMMzfpjG.mjs';
+export { x as GraphQLMultipartRequestBody, w as GraphQLParsedOperationsMap, u as ParsedGraphQLQuery, P as ParsedGraphQLRequest, v as parseDocumentNode, y as parseGraphQLRequest } from '../../HttpResponse-CxHR1nNN.mjs';
 import '@mswjs/interceptors';
 import './isIterable.mjs';
 import '../../typeUtils.mjs';

package/lib/core/utils/internal/parseGraphQLRequest.d.ts

@@ -1,5 +1,5 @@
 import 'graphql';
-export { x as GraphQLMultipartRequestBody, w as GraphQLParsedOperationsMap, u as ParsedGraphQLQuery, P as ParsedGraphQLRequest, v as parseDocumentNode, y as parseGraphQLRequest } from '../../HttpResponse-DPDqE4Pb.js';
+export { x as GraphQLMultipartRequestBody, w as GraphQLParsedOperationsMap, u as ParsedGraphQLQuery, P as ParsedGraphQLRequest, v as parseDocumentNode, y as parseGraphQLRequest } from '../../HttpResponse-aGiIzO91.js';
 import '@mswjs/interceptors';
 import './isIterable.js';
 import '../../typeUtils.js';

package/lib/core/utils/internal/parseMultipartData.d.mts

@@ -1,4 +1,4 @@
-import { d as DefaultRequestMultipartBody } from '../../HttpResponse-BMMzfpjG.mjs';
+import { d as DefaultRequestMultipartBody } from '../../HttpResponse-CxHR1nNN.mjs';
 import '@mswjs/interceptors';
 import './isIterable.mjs';
 import '../../typeUtils.mjs';

package/lib/core/utils/internal/parseMultipartData.d.ts

@@ -1,4 +1,4 @@
-import { d as DefaultRequestMultipartBody } from '../../HttpResponse-DPDqE4Pb.js';
+import { d as DefaultRequestMultipartBody } from '../../HttpResponse-aGiIzO91.js';
 import '@mswjs/interceptors';
 import './isIterable.js';
 import '../../typeUtils.js';

package/lib/core/utils/request/storeResponseCookies.js

@@ -24,7 +24,7 @@ module.exports = __toCommonJS(storeResponseCookies_exports);
 var import_cookieStore = require("../cookieStore");
 var import_decorators = require("../HttpResponse/decorators");
 async function storeResponseCookies(request, response) {
-  const responseCookies = Reflect.get(response, import_decorators.kSetCookie);
+  const responseCookies = (0, import_decorators.getRawSetCookie)(response);
   if (responseCookies) {
     await import_cookieStore.cookieStore.setCookie(responseCookies, request.url);
   }

package/lib/core/utils/request/storeResponseCookies.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/utils/request/storeResponseCookies.ts"],"sourcesContent":["import { cookieStore } from '../cookieStore'\nimport { kSetCookie } from '../HttpResponse/decorators'\n\nexport async function storeResponseCookies(\n  request: Request,\n  response: Response,\n): Promise<void> {\n  // Grab the raw \"Set-Cookie\" response header provided\n  // in the HeadersInit for this mocked response.\n  const responseCookies = Reflect.get(response, kSetCookie) as\n    | string\n    | undefined\n\n  if (responseCookies) {\n    await cookieStore.setCookie(responseCookies, request.url)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA4B;AAC5B,wBAA2B;AAE3B,eAAsB,qBACpB,SACA,UACe;AAGf,QAAM,kBAAkB,QAAQ,IAAI,UAAU,4BAAU;AAIxD,MAAI,iBAAiB;AACnB,UAAM,+BAAY,UAAU,iBAAiB,QAAQ,GAAG;AAAA,EAC1D;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/core/utils/request/storeResponseCookies.ts"],"sourcesContent":["import { cookieStore } from '../cookieStore'\nimport { getRawSetCookie } from '../HttpResponse/decorators'\n\nexport async function storeResponseCookies(\n  request: Request,\n  response: Response,\n): Promise<void> {\n  // Grab the raw \"Set-Cookie\" response header provided\n  // in the HeadersInit for this mocked response.\n  const responseCookies = getRawSetCookie(response)\n\n  if (responseCookies) {\n    await cookieStore.setCookie(responseCookies, request.url)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA4B;AAC5B,wBAAgC;AAEhC,eAAsB,qBACpB,SACA,UACe;AAGf,QAAM,sBAAkB,mCAAgB,QAAQ;AAEhD,MAAI,iBAAiB;AACnB,UAAM,+BAAY,UAAU,iBAAiB,QAAQ,GAAG;AAAA,EAC1D;AACF;","names":[]}

package/lib/core/utils/request/storeResponseCookies.mjs

@@ -1,7 +1,7 @@
 import { cookieStore } from '../cookieStore.mjs';
-import { kSetCookie } from '../HttpResponse/decorators.mjs';
+import { getRawSetCookie } from '../HttpResponse/decorators.mjs';
 async function storeResponseCookies(request, response) {
-  const responseCookies = Reflect.get(response, kSetCookie);
+  const responseCookies = getRawSetCookie(response);
   if (responseCookies) {
     await cookieStore.setCookie(responseCookies, request.url);
   }

package/lib/core/utils/request/storeResponseCookies.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/utils/request/storeResponseCookies.ts"],"sourcesContent":["import { cookieStore } from '../cookieStore'\nimport { kSetCookie } from '../HttpResponse/decorators'\n\nexport async function storeResponseCookies(\n  request: Request,\n  response: Response,\n): Promise<void> {\n  // Grab the raw \"Set-Cookie\" response header provided\n  // in the HeadersInit for this mocked response.\n  const responseCookies = Reflect.get(response, kSetCookie) as\n    | string\n    | undefined\n\n  if (responseCookies) {\n    await cookieStore.setCookie(responseCookies, request.url)\n  }\n}\n"],"mappings":"AAAA,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAE3B,eAAsB,qBACpB,SACA,UACe;AAGf,QAAM,kBAAkB,QAAQ,IAAI,UAAU,UAAU;AAIxD,MAAI,iBAAiB;AACnB,UAAM,YAAY,UAAU,iBAAiB,QAAQ,GAAG;AAAA,EAC1D;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/core/utils/request/storeResponseCookies.ts"],"sourcesContent":["import { cookieStore } from '../cookieStore'\nimport { getRawSetCookie } from '../HttpResponse/decorators'\n\nexport async function storeResponseCookies(\n  request: Request,\n  response: Response,\n): Promise<void> {\n  // Grab the raw \"Set-Cookie\" response header provided\n  // in the HeadersInit for this mocked response.\n  const responseCookies = getRawSetCookie(response)\n\n  if (responseCookies) {\n    await cookieStore.setCookie(responseCookies, request.url)\n  }\n}\n"],"mappings":"AAAA,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAEhC,eAAsB,qBACpB,SACA,UACe;AAGf,QAAM,kBAAkB,gBAAgB,QAAQ;AAEhD,MAAI,iBAAiB;AACnB,UAAM,YAAY,UAAU,iBAAiB,QAAQ,GAAG;AAAA,EAC1D;AACF;","names":[]}

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

@@ -1,5 +1,5 @@
 import { WebSocketConnectionData } from '@mswjs/interceptors/WebSocket';
-import { R as RequestHandler } from '../HttpResponse-BMMzfpjG.mjs';
+import { R as RequestHandler } from '../HttpResponse-CxHR1nNN.mjs';
 import { WebSocketHandler } from '../handlers/WebSocketHandler.mjs';
 import { UnhandledRequestStrategy } from '../utils/request/onUnhandledRequest.mjs';
 import '@mswjs/interceptors';

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

@@ -1,5 +1,5 @@
 import { WebSocketConnectionData } from '@mswjs/interceptors/WebSocket';
-import { R as RequestHandler } from '../HttpResponse-DPDqE4Pb.js';
+import { R as RequestHandler } from '../HttpResponse-aGiIzO91.js';
 import { WebSocketHandler } from '../handlers/WebSocketHandler.js';
 import { UnhandledRequestStrategy } from '../utils/request/onUnhandledRequest.js';
 import '@mswjs/interceptors';

package/lib/core/ws.d.mts

@@ -1,7 +1,7 @@
 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 { Path, PathParams } from './utils/matching/matchRequestUrl.mjs';
 import 'strict-event-emitter';
 
 type WebSocketEventListener<EventType extends keyof WebSocketHandlerEventMap> = (...args: WebSocketHandlerEventMap[EventType]) => void;
@@ -59,6 +59,21 @@ type WebSocketLink = {
  * })
  */
 declare function createWebSocketLinkHandler(url: Path): WebSocketLink;
+interface WebSocketNamespace {
+    link: typeof createWebSocketLinkHandler;
+    /**
+     * Request handler for the `upgrade` requests to the WebSocket protocol.
+     * This requires a WebSocket handler to be present to fire.
+     * @note This only affects Node.js as the `upgrade` request header is
+     * forbidden and cannot be read in the browser. Consider using the
+     * `WebSocket` API for establishing WebSocket connections in the browser.
+     */
+    onUpgrade: (info: {
+        requestId: string;
+        request: Request;
+        params: PathParams;
+    }) => Promise<Response | undefined> | Response | undefined;
+}
 /**
  * A namespace to intercept and mock WebSocket connections.
  *
@@ -68,8 +83,6 @@ declare function createWebSocketLinkHandler(url: Path): WebSocketLink;
  * @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;
-};
+declare const ws: WebSocketNamespace;
 
 export { type WebSocketEventListener, type WebSocketLink, ws };

package/lib/core/ws.d.ts

@@ -1,7 +1,7 @@
 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 { Path, PathParams } from './utils/matching/matchRequestUrl.js';
 import 'strict-event-emitter';
 
 type WebSocketEventListener<EventType extends keyof WebSocketHandlerEventMap> = (...args: WebSocketHandlerEventMap[EventType]) => void;
@@ -59,6 +59,21 @@ type WebSocketLink = {
  * })
  */
 declare function createWebSocketLinkHandler(url: Path): WebSocketLink;
+interface WebSocketNamespace {
+    link: typeof createWebSocketLinkHandler;
+    /**
+     * Request handler for the `upgrade` requests to the WebSocket protocol.
+     * This requires a WebSocket handler to be present to fire.
+     * @note This only affects Node.js as the `upgrade` request header is
+     * forbidden and cannot be read in the browser. Consider using the
+     * `WebSocket` API for establishing WebSocket connections in the browser.
+     */
+    onUpgrade: (info: {
+        requestId: string;
+        request: Request;
+        params: PathParams;
+    }) => Promise<Response | undefined> | Response | undefined;
+}
 /**
  * A namespace to intercept and mock WebSocket connections.
  *
@@ -68,8 +83,6 @@ declare function createWebSocketLinkHandler(url: Path): WebSocketLink;
  * @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;
-};
+declare const ws: WebSocketNamespace;
 
 export { type WebSocketEventListener, type WebSocketLink, ws };

package/lib/core/ws.js

@@ -22,10 +22,13 @@ __export(ws_exports, {
 });
 module.exports = __toCommonJS(ws_exports);
 var import_outvariant = require("outvariant");
+var import_interceptors = require("@mswjs/interceptors");
 var import_WebSocketHandler = require("./handlers/WebSocketHandler");
 var import_hasRefCounted = require("./utils/internal/hasRefCounted");
 var import_matchRequestUrl = require("./utils/matching/matchRequestUrl");
 var import_WebSocketClientManager = require("./ws/WebSocketClientManager");
+var import_http = require("./http");
+var import_attachSiblingHandlers = require("./utils/internal/attachSiblingHandlers");
 const webSocketChannel = new BroadcastChannel("msw:websocket-client-manager");
 if ((0, import_hasRefCounted.hasRefCounted)(webSocketChannel)) {
   webSocketChannel.unref();
@@ -38,17 +41,20 @@ function createWebSocketLinkHandler(url) {
     typeof url
   );
   const clientManager = new import_WebSocketClientManager.WebSocketClientManager(webSocketChannel);
+  const upgradeHandler = import_http.http.get(({ request }) => {
+    return request.headers.get("upgrade")?.toLowerCase() === "websocket" && (0, import_matchRequestUrl.matchRequestUrl)(new URL((0, import_interceptors.resolveWebSocketUrl)(request.url)), url).matches;
+  }, ws.onUpgrade);
   return {
     get clients() {
       return clientManager.clients;
     },
     addEventListener(event, listener) {
-      const handler = new import_WebSocketHandler.WebSocketHandler(url);
-      handler[import_WebSocketHandler.kEmitter].on("connection", async ({ client }) => {
+      const webSocketHandler = new import_WebSocketHandler.WebSocketHandler(url);
+      webSocketHandler[import_WebSocketHandler.kEmitter].on("connection", async ({ client }) => {
         await clientManager.addConnection(client);
       });
-      handler[import_WebSocketHandler.kEmitter].on(event, listener);
-      return handler;
+      webSocketHandler[import_WebSocketHandler.kEmitter].on(event, listener);
+      return (0, import_attachSiblingHandlers.attachSiblingHandlers)(webSocketHandler, [upgradeHandler]);
     },
     broadcast(data) {
       this.broadcastExcept([], data);
@@ -63,7 +69,26 @@ function createWebSocketLinkHandler(url) {
     }
   };
 }
+const WEBSOCKET_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
 const ws = {
-  link: createWebSocketLinkHandler
+  link: createWebSocketLinkHandler,
+  async onUpgrade({ request }) {
+    const key = request.headers.get("sec-websocket-key");
+    if (!key) {
+      return;
+    }
+    const keyBytes = new TextEncoder().encode(key + WEBSOCKET_GUID);
+    const digest = await crypto.subtle.digest("SHA-1", keyBytes);
+    const acceptValue = btoa(String.fromCharCode(...new Uint8Array(digest)));
+    new WebSocket((0, import_interceptors.resolveWebSocketUrl)(request.url));
+    return new import_interceptors.FetchResponse(null, {
+      status: 101,
+      headers: {
+        upgrade: "websocket",
+        connection: "upgrade",
+        "sec-websocket-accept": acceptValue
+      }
+    });
+  }
 };
 //# sourceMappingURL=ws.js.map

package/lib/core/ws.js.map

@@ -1 +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 { hasRefCounted } from './utils/internal/hasRefCounted'\nimport { type Path, isPath } from './utils/matching/matchRequestUrl'\nimport { WebSocketClientManager } from './ws/WebSocketClientManager'\n\nconst webSocketChannel = new BroadcastChannel('msw:websocket-client-manager')\n\nif (hasRefCounted(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 { type WebSocketData }\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA0B;AAK1B,8BAIO;AACP,2BAA8B;AAC9B,6BAAkC;AAClC,oCAAuC;AAEvC,MAAM,mBAAmB,IAAI,iBAAiB,8BAA8B;AAE5E,QAAI,oCAAc,gBAAgB,GAAG;AAGnC,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":[]}
+{"version":3,"sources":["../../src/core/ws.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport { FetchResponse, resolveWebSocketUrl } from '@mswjs/interceptors'\nimport type {\n  WebSocketData,\n  WebSocketClientConnectionProtocol,\n} from '@mswjs/interceptors/WebSocket'\nimport {\n  WebSocketHandler,\n  kEmitter,\n  type WebSocketHandlerEventMap,\n} from './handlers/WebSocketHandler'\nimport { hasRefCounted } from './utils/internal/hasRefCounted'\nimport {\n  type Path,\n  type PathParams,\n  isPath,\n  matchRequestUrl,\n} from './utils/matching/matchRequestUrl'\nimport { WebSocketClientManager } from './ws/WebSocketClientManager'\nimport { http } from './http'\nimport { attachSiblingHandlers } from './utils/internal/attachSiblingHandlers'\n\nconst webSocketChannel = new BroadcastChannel('msw:websocket-client-manager')\n\nif (hasRefCounted(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  // The same upgrade handler instance is attached as a sibling to every\n  // WebSocketHandler returned by this link. `groupHandlersByKind` dedupes\n  // by reference, so it lands in the `request` bucket exactly once regardless\n  // of which subset of WS handlers the user ends up registering.\n  const upgradeHandler = http.get(({ request }) => {\n    return (\n      request.headers.get('upgrade')?.toLowerCase() === 'websocket' &&\n      matchRequestUrl(new URL(resolveWebSocketUrl(request.url)), url).matches\n    )\n  }, ws.onUpgrade)\n\n  return {\n    get clients() {\n      return clientManager.clients\n    },\n    addEventListener(event, listener) {\n      const webSocketHandler = 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      webSocketHandler[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      webSocketHandler[kEmitter].on(event, listener)\n\n      return attachSiblingHandlers(webSocketHandler, [upgradeHandler])\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\nconst WEBSOCKET_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11'\n\ninterface WebSocketNamespace {\n  link: typeof createWebSocketLinkHandler\n  /**\n   * Request handler for the `upgrade` requests to the WebSocket protocol.\n   * This requires a WebSocket handler to be present to fire.\n   * @note This only affects Node.js as the `upgrade` request header is\n   * forbidden and cannot be read in the browser. Consider using the\n   * `WebSocket` API for establishing WebSocket connections in the browser.\n   */\n  onUpgrade: (info: {\n    requestId: string\n    request: Request\n    params: PathParams\n  }) => Promise<Response | undefined> | Response | undefined\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: WebSocketNamespace = {\n  link: createWebSocketLinkHandler,\n  async onUpgrade({ request }) {\n    const key = request.headers.get('sec-websocket-key')\n\n    if (!key) {\n      return\n    }\n\n    const keyBytes = new TextEncoder().encode(key + WEBSOCKET_GUID)\n    const digest = await crypto.subtle.digest('SHA-1', keyBytes)\n    const acceptValue = btoa(String.fromCharCode(...new Uint8Array(digest)))\n\n    new WebSocket(resolveWebSocketUrl(request.url))\n\n    return new FetchResponse(null, {\n      status: 101,\n      headers: {\n        upgrade: 'websocket',\n        connection: 'upgrade',\n        'sec-websocket-accept': acceptValue,\n      },\n    })\n  },\n}\n\nexport { type WebSocketData }\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA0B;AAC1B,0BAAmD;AAKnD,8BAIO;AACP,2BAA8B;AAC9B,6BAKO;AACP,oCAAuC;AACvC,kBAAqB;AACrB,mCAAsC;AAEtC,MAAM,mBAAmB,IAAI,iBAAiB,8BAA8B;AAE5E,QAAI,oCAAc,gBAAgB,GAAG;AAGnC,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;AAMjE,QAAM,iBAAiB,iBAAK,IAAI,CAAC,EAAE,QAAQ,MAAM;AAC/C,WACE,QAAQ,QAAQ,IAAI,SAAS,GAAG,YAAY,MAAM,mBAClD,wCAAgB,IAAI,QAAI,yCAAoB,QAAQ,GAAG,CAAC,GAAG,GAAG,EAAE;AAAA,EAEpE,GAAG,GAAG,SAAS;AAEf,SAAO;AAAA,IACL,IAAI,UAAU;AACZ,aAAO,cAAc;AAAA,IACvB;AAAA,IACA,iBAAiB,OAAO,UAAU;AAChC,YAAM,mBAAmB,IAAI,yCAAiB,GAAG;AAMjD,uBAAiB,gCAAQ,EAAE,GAAG,cAAc,OAAO,EAAE,OAAO,MAAM;AAChE,cAAM,cAAc,cAAc,MAAM;AAAA,MAC1C,CAAC;AAMD,uBAAiB,gCAAQ,EAAE,GAAG,OAAO,QAAQ;AAE7C,iBAAO,oDAAsB,kBAAkB,CAAC,cAAc,CAAC;AAAA,IACjE;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;AAEA,MAAM,iBAAiB;AA2BhB,MAAM,KAAyB;AAAA,EACpC,MAAM;AAAA,EACN,MAAM,UAAU,EAAE,QAAQ,GAAG;AAC3B,UAAM,MAAM,QAAQ,QAAQ,IAAI,mBAAmB;AAEnD,QAAI,CAAC,KAAK;AACR;AAAA,IACF;AAEA,UAAM,WAAW,IAAI,YAAY,EAAE,OAAO,MAAM,cAAc;AAC9D,UAAM,SAAS,MAAM,OAAO,OAAO,OAAO,SAAS,QAAQ;AAC3D,UAAM,cAAc,KAAK,OAAO,aAAa,GAAG,IAAI,WAAW,MAAM,CAAC,CAAC;AAEvE,QAAI,cAAU,yCAAoB,QAAQ,GAAG,CAAC;AAE9C,WAAO,IAAI,kCAAc,MAAM;AAAA,MAC7B,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,SAAS;AAAA,QACT,YAAY;AAAA,QACZ,wBAAwB;AAAA,MAC1B;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/lib/core/ws.mjs

@@ -1,11 +1,17 @@
 import { invariant } from "outvariant";
+import { FetchResponse, resolveWebSocketUrl } from "@mswjs/interceptors";
 import {
   WebSocketHandler,
   kEmitter
 } from './handlers/WebSocketHandler.mjs';
 import { hasRefCounted } from './utils/internal/hasRefCounted.mjs';
-import { isPath } from './utils/matching/matchRequestUrl.mjs';
+import {
+  isPath,
+  matchRequestUrl
+} from './utils/matching/matchRequestUrl.mjs';
 import { WebSocketClientManager } from './ws/WebSocketClientManager.mjs';
+import { http } from './http.mjs';
+import { attachSiblingHandlers } from './utils/internal/attachSiblingHandlers.mjs';
 const webSocketChannel = new BroadcastChannel("msw:websocket-client-manager");
 if (hasRefCounted(webSocketChannel)) {
   webSocketChannel.unref();
@@ -18,17 +24,20 @@ function createWebSocketLinkHandler(url) {
     typeof url
   );
   const clientManager = new WebSocketClientManager(webSocketChannel);
+  const upgradeHandler = http.get(({ request }) => {
+    return request.headers.get("upgrade")?.toLowerCase() === "websocket" && matchRequestUrl(new URL(resolveWebSocketUrl(request.url)), url).matches;
+  }, ws.onUpgrade);
   return {
     get clients() {
       return clientManager.clients;
     },
     addEventListener(event, listener) {
-      const handler = new WebSocketHandler(url);
-      handler[kEmitter].on("connection", async ({ client }) => {
+      const webSocketHandler = new WebSocketHandler(url);
+      webSocketHandler[kEmitter].on("connection", async ({ client }) => {
         await clientManager.addConnection(client);
       });
-      handler[kEmitter].on(event, listener);
-      return handler;
+      webSocketHandler[kEmitter].on(event, listener);
+      return attachSiblingHandlers(webSocketHandler, [upgradeHandler]);
     },
     broadcast(data) {
       this.broadcastExcept([], data);
@@ -43,8 +52,27 @@ function createWebSocketLinkHandler(url) {
     }
   };
 }
+const WEBSOCKET_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
 const ws = {
-  link: createWebSocketLinkHandler
+  link: createWebSocketLinkHandler,
+  async onUpgrade({ request }) {
+    const key = request.headers.get("sec-websocket-key");
+    if (!key) {
+      return;
+    }
+    const keyBytes = new TextEncoder().encode(key + WEBSOCKET_GUID);
+    const digest = await crypto.subtle.digest("SHA-1", keyBytes);
+    const acceptValue = btoa(String.fromCharCode(...new Uint8Array(digest)));
+    new WebSocket(resolveWebSocketUrl(request.url));
+    return new FetchResponse(null, {
+      status: 101,
+      headers: {
+        upgrade: "websocket",
+        connection: "upgrade",
+        "sec-websocket-accept": acceptValue
+      }
+    });
+  }
 };
 export {
   ws