msw 2.12.13 → 2.13.0

package/lib/core/experimental/frames/http-frame.d.mts

@@ -0,0 +1,77 @@
+import { TypedEvent } from 'rettime';
+import { N as NetworkFrame, b as UnhandledFrameHandle, a as NetworkFrameResolutionContext } from '../../network-frame-B7A0ggXE.mjs';
+import { HandlersController, AnyHandler } from '../handlers-controller.mjs';
+import { R as RequestHandler } from '../../HttpResponse-DlRR1D-f.mjs';
+import '../../handlers/WebSocketHandler.mjs';
+import 'strict-event-emitter';
+import '@mswjs/interceptors/WebSocket';
+import '../../utils/matching/matchRequestUrl.mjs';
+import '@mswjs/interceptors';
+import '../../utils/internal/isIterable.mjs';
+import '../../typeUtils.mjs';
+import 'graphql';
+
+interface HttpNetworkFrameOptions {
+    id?: string;
+    request: Request;
+}
+declare class RequestEvent<DataType extends {
+    requestId: string;
+    request: Request;
+} = {
+    requestId: string;
+    request: Request;
+}, ReturnType = void, EventType extends string = string> extends TypedEvent<DataType, ReturnType, EventType> {
+    readonly requestId: string;
+    readonly request: Request;
+    constructor(type: EventType, data: DataType);
+}
+declare class ResponseEvent<DataType extends {
+    requestId: string;
+    request: Request;
+    response: Response;
+} = {
+    requestId: string;
+    request: Request;
+    response: Response;
+}, ReturnType = void, EventType extends string = string> extends TypedEvent<DataType, ReturnType, EventType> {
+    readonly requestId: string;
+    readonly request: Request;
+    readonly response: Response;
+    constructor(type: EventType, data: DataType);
+}
+declare class UnhandledExceptionEvent<DataType extends {
+    error: Error;
+    requestId: string;
+    request: Request;
+} = {
+    error: Error;
+    requestId: string;
+    request: Request;
+}, ReturnType = void, EventType extends string = string> extends TypedEvent<DataType, ReturnType, EventType> {
+    readonly error: Error;
+    readonly requestId: string;
+    readonly request: Request;
+    constructor(type: EventType, data: DataType);
+}
+type HttpNetworkFrameEventMap = {
+    'request:start': RequestEvent;
+    'request:match': RequestEvent;
+    'request:unhandled': RequestEvent;
+    'request:end': RequestEvent;
+    'response:mocked': ResponseEvent;
+    'response:bypass': ResponseEvent;
+    unhandledException: UnhandledExceptionEvent;
+};
+declare abstract class HttpNetworkFrame extends NetworkFrame<'http', {
+    id: string;
+    request: Request;
+}, HttpNetworkFrameEventMap> {
+    constructor(options: HttpNetworkFrameOptions);
+    getHandlers(controller: HandlersController): Array<AnyHandler>;
+    abstract respondWith(response?: Response): void;
+    getUnhandledMessage(): Promise<string>;
+    resolve(handlers: Array<RequestHandler>, onUnhandledFrame: UnhandledFrameHandle, resolutionContext?: NetworkFrameResolutionContext): Promise<boolean | null>;
+}
+
+export { HttpNetworkFrame, type HttpNetworkFrameEventMap, RequestEvent, ResponseEvent, UnhandledExceptionEvent };

package/lib/core/experimental/frames/http-frame.d.ts

@@ -0,0 +1,77 @@
+import { TypedEvent } from 'rettime';
+import { N as NetworkFrame, b as UnhandledFrameHandle, a as NetworkFrameResolutionContext } from '../../network-frame-usYiHS0K.js';
+import { HandlersController, AnyHandler } from '../handlers-controller.js';
+import { R as RequestHandler } from '../../HttpResponse-CksOMVAa.js';
+import '../../handlers/WebSocketHandler.js';
+import 'strict-event-emitter';
+import '@mswjs/interceptors/WebSocket';
+import '../../utils/matching/matchRequestUrl.js';
+import '@mswjs/interceptors';
+import '../../utils/internal/isIterable.js';
+import '../../typeUtils.js';
+import 'graphql';
+
+interface HttpNetworkFrameOptions {
+    id?: string;
+    request: Request;
+}
+declare class RequestEvent<DataType extends {
+    requestId: string;
+    request: Request;
+} = {
+    requestId: string;
+    request: Request;
+}, ReturnType = void, EventType extends string = string> extends TypedEvent<DataType, ReturnType, EventType> {
+    readonly requestId: string;
+    readonly request: Request;
+    constructor(type: EventType, data: DataType);
+}
+declare class ResponseEvent<DataType extends {
+    requestId: string;
+    request: Request;
+    response: Response;
+} = {
+    requestId: string;
+    request: Request;
+    response: Response;
+}, ReturnType = void, EventType extends string = string> extends TypedEvent<DataType, ReturnType, EventType> {
+    readonly requestId: string;
+    readonly request: Request;
+    readonly response: Response;
+    constructor(type: EventType, data: DataType);
+}
+declare class UnhandledExceptionEvent<DataType extends {
+    error: Error;
+    requestId: string;
+    request: Request;
+} = {
+    error: Error;
+    requestId: string;
+    request: Request;
+}, ReturnType = void, EventType extends string = string> extends TypedEvent<DataType, ReturnType, EventType> {
+    readonly error: Error;
+    readonly requestId: string;
+    readonly request: Request;
+    constructor(type: EventType, data: DataType);
+}
+type HttpNetworkFrameEventMap = {
+    'request:start': RequestEvent;
+    'request:match': RequestEvent;
+    'request:unhandled': RequestEvent;
+    'request:end': RequestEvent;
+    'response:mocked': ResponseEvent;
+    'response:bypass': ResponseEvent;
+    unhandledException: UnhandledExceptionEvent;
+};
+declare abstract class HttpNetworkFrame extends NetworkFrame<'http', {
+    id: string;
+    request: Request;
+}, HttpNetworkFrameEventMap> {
+    constructor(options: HttpNetworkFrameOptions);
+    getHandlers(controller: HandlersController): Array<AnyHandler>;
+    abstract respondWith(response?: Response): void;
+    getUnhandledMessage(): Promise<string>;
+    resolve(handlers: Array<RequestHandler>, onUnhandledFrame: UnhandledFrameHandle, resolutionContext?: NetworkFrameResolutionContext): Promise<boolean | null>;
+}
+
+export { HttpNetworkFrame, type HttpNetworkFrameEventMap, RequestEvent, ResponseEvent, UnhandledExceptionEvent };

package/lib/core/experimental/frames/http-frame.js

@@ -0,0 +1,194 @@
+"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 http_frame_exports = {};
+__export(http_frame_exports, {
+  HttpNetworkFrame: () => HttpNetworkFrame,
+  RequestEvent: () => RequestEvent,
+  ResponseEvent: () => ResponseEvent,
+  UnhandledExceptionEvent: () => UnhandledExceptionEvent
+});
+module.exports = __toCommonJS(http_frame_exports);
+var import_rettime = require("rettime");
+var import_until_async = require("until-async");
+var import_interceptors = require("@mswjs/interceptors");
+var import_network_frame = require("./network-frame");
+var import_toPublicUrl = require("../../utils/request/toPublicUrl");
+var import_executeHandlers = require("../../utils/executeHandlers");
+var import_storeResponseCookies = require("../../utils/request/storeResponseCookies");
+var import_request_utils = require("../request-utils");
+var import_devUtils = require("../../utils/internal/devUtils");
+var import_on_unhandled_frame = require("../on-unhandled-frame");
+class RequestEvent extends import_rettime.TypedEvent {
+  requestId;
+  request;
+  constructor(type, data) {
+    super(...[type, {}]);
+    this.requestId = data.requestId;
+    this.request = data.request;
+  }
+}
+class ResponseEvent extends import_rettime.TypedEvent {
+  requestId;
+  request;
+  response;
+  constructor(type, data) {
+    super(...[type, {}]);
+    this.requestId = data.requestId;
+    this.request = data.request;
+    this.response = data.response;
+  }
+}
+class UnhandledExceptionEvent extends import_rettime.TypedEvent {
+  error;
+  requestId;
+  request;
+  constructor(type, data) {
+    super(...[type, {}]);
+    this.error = data.error;
+    this.requestId = data.requestId;
+    this.request = data.request;
+  }
+}
+class HttpNetworkFrame extends import_network_frame.NetworkFrame {
+  constructor(options) {
+    const id = options.id || (0, import_interceptors.createRequestId)();
+    super("http", { id, request: options.request });
+  }
+  getHandlers(controller) {
+    return controller.getHandlersByKind("request");
+  }
+  async getUnhandledMessage() {
+    const { request } = this.data;
+    const url = new URL(request.url);
+    const publicUrl = (0, import_toPublicUrl.toPublicUrl)(url) + url.search;
+    const requestBody = request.body == null ? null : await request.clone().text();
+    const details = `
+
+  \u2022 ${request.method} ${publicUrl}
+
+${requestBody ? `  \u2022 Request body: ${requestBody}
+
+` : ""}`;
+    const message = `intercepted a request without a matching request handler:${details}If you still wish to intercept this unhandled request, please create a request handler for it.
+Read more: https://mswjs.io/docs/http/intercepting-requests`;
+    return message;
+  }
+  async resolve(handlers, onUnhandledFrame, resolutionContext) {
+    const { id: requestId, request } = this.data;
+    const requestCloneForLogs = resolutionContext?.quiet ? null : request.clone();
+    this.events.emit(new RequestEvent("request:start", { requestId, request }));
+    if ((0, import_request_utils.shouldBypassRequest)(request)) {
+      this.events.emit(new RequestEvent("request:end", { requestId, request }));
+      this.passthrough();
+      return null;
+    }
+    const [lookupError, lookupResult] = await (0, import_until_async.until)(() => {
+      return (0, import_executeHandlers.executeHandlers)({
+        requestId,
+        request,
+        handlers,
+        resolutionContext: {
+          baseUrl: resolutionContext?.baseUrl?.toString(),
+          quiet: resolutionContext?.quiet
+        }
+      });
+    });
+    if (lookupError != null) {
+      if (!this.events.emit(
+        new UnhandledExceptionEvent("unhandledException", {
+          error: lookupError,
+          requestId,
+          request
+        })
+      )) {
+        console.error(lookupError);
+        import_devUtils.devUtils.error(
+          'Encountered an unhandled exception during the handler lookup for "%s %s". Please see the original error above.',
+          request.method,
+          request.url
+        );
+      }
+      this.errorWith(lookupError);
+      return null;
+    }
+    if (lookupResult == null) {
+      this.events.emit(
+        new RequestEvent("request:unhandled", {
+          requestId,
+          request
+        })
+      );
+      await (0, import_on_unhandled_frame.executeUnhandledFrameHandle)(this, onUnhandledFrame).then(
+        () => this.passthrough(),
+        (error) => this.errorWith(error)
+      );
+      this.events.emit(
+        new RequestEvent("request:end", {
+          requestId,
+          request
+        })
+      );
+      return false;
+    }
+    const { response, handler, parsedResult } = lookupResult;
+    this.events.emit(
+      new RequestEvent("request:match", {
+        requestId,
+        request
+      })
+    );
+    if (response == null) {
+      this.events.emit(
+        new RequestEvent("request:end", {
+          requestId,
+          request
+        })
+      );
+      this.passthrough();
+      return null;
+    }
+    if ((0, import_request_utils.isPassthroughResponse)(response)) {
+      this.events.emit(
+        new RequestEvent("request:end", {
+          requestId,
+          request
+        })
+      );
+      this.passthrough();
+      return null;
+    }
+    await (0, import_storeResponseCookies.storeResponseCookies)(request, response);
+    this.respondWith(response.clone());
+    this.events.emit(
+      new RequestEvent("request:end", {
+        requestId,
+        request
+      })
+    );
+    if (!resolutionContext?.quiet) {
+      handler.log({
+        request: requestCloneForLogs,
+        response,
+        parsedResult
+      });
+    }
+    return true;
+  }
+}
+//# sourceMappingURL=http-frame.js.map

package/lib/core/experimental/frames/http-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/experimental/frames/http-frame.ts"],"sourcesContent":["import { TypedEvent } from 'rettime'\nimport { until } from 'until-async'\nimport { createRequestId } from '@mswjs/interceptors'\nimport { NetworkFrame, NetworkFrameResolutionContext } from './network-frame'\nimport { toPublicUrl } from '../../utils/request/toPublicUrl'\nimport { executeHandlers } from '../../utils/executeHandlers'\nimport { storeResponseCookies } from '../../utils/request/storeResponseCookies'\nimport { isPassthroughResponse, shouldBypassRequest } from '../request-utils'\nimport { devUtils } from '../../utils/internal/devUtils'\nimport {\n  executeUnhandledFrameHandle,\n  type UnhandledFrameHandle,\n} from '../on-unhandled-frame'\nimport { HandlersController, AnyHandler } from '../handlers-controller'\nimport { type RequestHandler } from '../../handlers/RequestHandler'\n\ninterface HttpNetworkFrameOptions {\n  id?: string\n  request: Request\n}\n\nexport class RequestEvent<\n  DataType extends { requestId: string; request: Request } = {\n    requestId: string\n    request: Request\n  },\n  ReturnType = void,\n  EventType extends string = string,\n> extends TypedEvent<DataType, ReturnType, EventType> {\n  public readonly requestId: string\n  public readonly request: Request\n\n  constructor(type: EventType, data: DataType) {\n    super(...([type, {}] as any))\n    this.requestId = data.requestId\n    this.request = data.request\n  }\n}\n\nexport class ResponseEvent<\n  DataType extends {\n    requestId: string\n    request: Request\n    response: Response\n  } = {\n    requestId: string\n    request: Request\n    response: Response\n  },\n  ReturnType = void,\n  EventType extends string = string,\n> extends TypedEvent<DataType, ReturnType, EventType> {\n  public readonly requestId: string\n  public readonly request: Request\n  public readonly response: Response\n\n  constructor(type: EventType, data: DataType) {\n    super(...([type, {}] as any))\n    this.requestId = data.requestId\n    this.request = data.request\n    this.response = data.response\n  }\n}\n\nexport class UnhandledExceptionEvent<\n  DataType extends {\n    error: Error\n    requestId: string\n    request: Request\n  } = {\n    error: Error\n    requestId: string\n    request: Request\n  },\n  ReturnType = void,\n  EventType extends string = string,\n> extends TypedEvent<DataType, ReturnType, EventType> {\n  public readonly error: Error\n  public readonly requestId: string\n  public readonly request: Request\n\n  constructor(type: EventType, data: DataType) {\n    super(...([type, {}] as any))\n    this.error = data.error\n    this.requestId = data.requestId\n    this.request = data.request\n  }\n}\n\nexport type HttpNetworkFrameEventMap = {\n  'request:start': RequestEvent\n  'request:match': RequestEvent\n  'request:unhandled': RequestEvent\n  'request:end': RequestEvent\n  'response:mocked': ResponseEvent\n  'response:bypass': ResponseEvent\n  unhandledException: UnhandledExceptionEvent\n}\n\nexport abstract class HttpNetworkFrame extends NetworkFrame<\n  'http',\n  {\n    id: string\n    request: Request\n  },\n  HttpNetworkFrameEventMap\n> {\n  constructor(options: HttpNetworkFrameOptions) {\n    const id = options.id || createRequestId()\n    super('http', { id, request: options.request })\n  }\n\n  public getHandlers(controller: HandlersController): Array<AnyHandler> {\n    return controller.getHandlersByKind('request')\n  }\n\n  public abstract respondWith(response?: Response): void\n\n  public async getUnhandledMessage(): Promise<string> {\n    const { request } = this.data\n\n    const url = new URL(request.url)\n    const publicUrl = toPublicUrl(url) + url.search\n    const requestBody =\n      request.body == null ? null : await request.clone().text()\n\n    const details = `\\n\\n  \\u2022 ${request.method} ${publicUrl}\\n\\n${requestBody ? `  \\u2022 Request body: ${requestBody}\\n\\n` : ''}`\n    const message = `intercepted a request without a matching request handler:${details}If you still wish to intercept this unhandled request, please create a request handler for it.\\nRead more: https://mswjs.io/docs/http/intercepting-requests`\n\n    return message\n  }\n\n  public async resolve(\n    handlers: Array<RequestHandler>,\n    onUnhandledFrame: UnhandledFrameHandle,\n    resolutionContext?: NetworkFrameResolutionContext,\n  ): Promise<boolean | null> {\n    const { id: requestId, request } = this.data\n    const requestCloneForLogs = resolutionContext?.quiet\n      ? null\n      : request.clone()\n\n    this.events.emit(new RequestEvent('request:start', { requestId, request }))\n\n    // Requests wrapped in explicit \"bypass(request)\".\n    if (shouldBypassRequest(request)) {\n      this.events.emit(new RequestEvent('request:end', { requestId, request }))\n      this.passthrough()\n      return null\n    }\n\n    const [lookupError, lookupResult] = await until(() => {\n      return executeHandlers({\n        requestId,\n        request,\n        handlers,\n        resolutionContext: {\n          baseUrl: resolutionContext?.baseUrl?.toString(),\n          quiet: resolutionContext?.quiet,\n        },\n      })\n    })\n\n    if (lookupError != null) {\n      if (\n        !this.events.emit(\n          new UnhandledExceptionEvent('unhandledException', {\n            error: lookupError,\n            requestId,\n            request,\n          }),\n        )\n      ) {\n        // Surface the error to the developer since they haven't handled it.\n        console.error(lookupError)\n        devUtils.error(\n          'Encountered an unhandled exception during the handler lookup for \"%s %s\". Please see the original error above.',\n          request.method,\n          request.url,\n        )\n      }\n\n      this.errorWith(lookupError)\n      return null\n    }\n\n    // No matching handlers.\n    if (lookupResult == null) {\n      this.events.emit(\n        new RequestEvent('request:unhandled', {\n          requestId,\n          request,\n        }),\n      )\n\n      /**\n       * @note The unhandled frame handle must be executed during the request resolution\n       * since it can influence it (e.g. error the request if the \"error\" startegy was used).\n       */\n      await executeUnhandledFrameHandle(this, onUnhandledFrame).then(\n        () => this.passthrough(),\n        (error) => this.errorWith(error),\n      )\n\n      this.events.emit(\n        new RequestEvent('request:end', {\n          requestId,\n          request,\n        }),\n      )\n\n      return false\n    }\n\n    const { response, handler, parsedResult } = lookupResult\n\n    this.events.emit(\n      new RequestEvent('request:match', {\n        requestId,\n        request,\n      }),\n    )\n\n    // Handlers that returned no mocked response.\n    if (response == null) {\n      this.events.emit(\n        new RequestEvent('request:end', {\n          requestId,\n          request,\n        }),\n      )\n\n      this.passthrough()\n      return null\n    }\n\n    // Handlers that returned explicit `passthrough()`.\n    if (isPassthroughResponse(response)) {\n      this.events.emit(\n        new RequestEvent('request:end', {\n          requestId,\n          request,\n        }),\n      )\n\n      this.passthrough()\n      return null\n    }\n\n    await storeResponseCookies(request, response)\n\n    this.respondWith(response.clone())\n\n    this.events.emit(\n      new RequestEvent('request:end', {\n        requestId,\n        request,\n      }),\n    )\n\n    if (!resolutionContext?.quiet) {\n      handler.log({\n        request: requestCloneForLogs!,\n        response,\n        parsedResult,\n      })\n    }\n\n    return true\n  }\n}\n"],"mappings":"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","names":[]}

package/lib/core/experimental/frames/http-frame.mjs

@@ -0,0 +1,176 @@
+import { TypedEvent } from "rettime";
+import { until } from "until-async";
+import { createRequestId } from "@mswjs/interceptors";
+import { NetworkFrame } from './network-frame.mjs';
+import { toPublicUrl } from '../../utils/request/toPublicUrl.mjs';
+import { executeHandlers } from '../../utils/executeHandlers.mjs';
+import { storeResponseCookies } from '../../utils/request/storeResponseCookies.mjs';
+import { isPassthroughResponse, shouldBypassRequest } from '../request-utils.mjs';
+import { devUtils } from '../../utils/internal/devUtils.mjs';
+import {
+  executeUnhandledFrameHandle
+} from '../on-unhandled-frame.mjs';
+class RequestEvent extends TypedEvent {
+  requestId;
+  request;
+  constructor(type, data) {
+    super(...[type, {}]);
+    this.requestId = data.requestId;
+    this.request = data.request;
+  }
+}
+class ResponseEvent extends TypedEvent {
+  requestId;
+  request;
+  response;
+  constructor(type, data) {
+    super(...[type, {}]);
+    this.requestId = data.requestId;
+    this.request = data.request;
+    this.response = data.response;
+  }
+}
+class UnhandledExceptionEvent extends TypedEvent {
+  error;
+  requestId;
+  request;
+  constructor(type, data) {
+    super(...[type, {}]);
+    this.error = data.error;
+    this.requestId = data.requestId;
+    this.request = data.request;
+  }
+}
+class HttpNetworkFrame extends NetworkFrame {
+  constructor(options) {
+    const id = options.id || createRequestId();
+    super("http", { id, request: options.request });
+  }
+  getHandlers(controller) {
+    return controller.getHandlersByKind("request");
+  }
+  async getUnhandledMessage() {
+    const { request } = this.data;
+    const url = new URL(request.url);
+    const publicUrl = toPublicUrl(url) + url.search;
+    const requestBody = request.body == null ? null : await request.clone().text();
+    const details = `
+
+  \u2022 ${request.method} ${publicUrl}
+
+${requestBody ? `  \u2022 Request body: ${requestBody}
+
+` : ""}`;
+    const message = `intercepted a request without a matching request handler:${details}If you still wish to intercept this unhandled request, please create a request handler for it.
+Read more: https://mswjs.io/docs/http/intercepting-requests`;
+    return message;
+  }
+  async resolve(handlers, onUnhandledFrame, resolutionContext) {
+    const { id: requestId, request } = this.data;
+    const requestCloneForLogs = resolutionContext?.quiet ? null : request.clone();
+    this.events.emit(new RequestEvent("request:start", { requestId, request }));
+    if (shouldBypassRequest(request)) {
+      this.events.emit(new RequestEvent("request:end", { requestId, request }));
+      this.passthrough();
+      return null;
+    }
+    const [lookupError, lookupResult] = await until(() => {
+      return executeHandlers({
+        requestId,
+        request,
+        handlers,
+        resolutionContext: {
+          baseUrl: resolutionContext?.baseUrl?.toString(),
+          quiet: resolutionContext?.quiet
+        }
+      });
+    });
+    if (lookupError != null) {
+      if (!this.events.emit(
+        new UnhandledExceptionEvent("unhandledException", {
+          error: lookupError,
+          requestId,
+          request
+        })
+      )) {
+        console.error(lookupError);
+        devUtils.error(
+          'Encountered an unhandled exception during the handler lookup for "%s %s". Please see the original error above.',
+          request.method,
+          request.url
+        );
+      }
+      this.errorWith(lookupError);
+      return null;
+    }
+    if (lookupResult == null) {
+      this.events.emit(
+        new RequestEvent("request:unhandled", {
+          requestId,
+          request
+        })
+      );
+      await executeUnhandledFrameHandle(this, onUnhandledFrame).then(
+        () => this.passthrough(),
+        (error) => this.errorWith(error)
+      );
+      this.events.emit(
+        new RequestEvent("request:end", {
+          requestId,
+          request
+        })
+      );
+      return false;
+    }
+    const { response, handler, parsedResult } = lookupResult;
+    this.events.emit(
+      new RequestEvent("request:match", {
+        requestId,
+        request
+      })
+    );
+    if (response == null) {
+      this.events.emit(
+        new RequestEvent("request:end", {
+          requestId,
+          request
+        })
+      );
+      this.passthrough();
+      return null;
+    }
+    if (isPassthroughResponse(response)) {
+      this.events.emit(
+        new RequestEvent("request:end", {
+          requestId,
+          request
+        })
+      );
+      this.passthrough();
+      return null;
+    }
+    await storeResponseCookies(request, response);
+    this.respondWith(response.clone());
+    this.events.emit(
+      new RequestEvent("request:end", {
+        requestId,
+        request
+      })
+    );
+    if (!resolutionContext?.quiet) {
+      handler.log({
+        request: requestCloneForLogs,
+        response,
+        parsedResult
+      });
+    }
+    return true;
+  }
+}
+export {
+  HttpNetworkFrame,
+  RequestEvent,
+  ResponseEvent,
+  UnhandledExceptionEvent
+};
+//# sourceMappingURL=http-frame.mjs.map

package/lib/core/experimental/frames/http-frame.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/experimental/frames/http-frame.ts"],"sourcesContent":["import { TypedEvent } from 'rettime'\nimport { until } from 'until-async'\nimport { createRequestId } from '@mswjs/interceptors'\nimport { NetworkFrame, NetworkFrameResolutionContext } from './network-frame'\nimport { toPublicUrl } from '../../utils/request/toPublicUrl'\nimport { executeHandlers } from '../../utils/executeHandlers'\nimport { storeResponseCookies } from '../../utils/request/storeResponseCookies'\nimport { isPassthroughResponse, shouldBypassRequest } from '../request-utils'\nimport { devUtils } from '../../utils/internal/devUtils'\nimport {\n  executeUnhandledFrameHandle,\n  type UnhandledFrameHandle,\n} from '../on-unhandled-frame'\nimport { HandlersController, AnyHandler } from '../handlers-controller'\nimport { type RequestHandler } from '../../handlers/RequestHandler'\n\ninterface HttpNetworkFrameOptions {\n  id?: string\n  request: Request\n}\n\nexport class RequestEvent<\n  DataType extends { requestId: string; request: Request } = {\n    requestId: string\n    request: Request\n  },\n  ReturnType = void,\n  EventType extends string = string,\n> extends TypedEvent<DataType, ReturnType, EventType> {\n  public readonly requestId: string\n  public readonly request: Request\n\n  constructor(type: EventType, data: DataType) {\n    super(...([type, {}] as any))\n    this.requestId = data.requestId\n    this.request = data.request\n  }\n}\n\nexport class ResponseEvent<\n  DataType extends {\n    requestId: string\n    request: Request\n    response: Response\n  } = {\n    requestId: string\n    request: Request\n    response: Response\n  },\n  ReturnType = void,\n  EventType extends string = string,\n> extends TypedEvent<DataType, ReturnType, EventType> {\n  public readonly requestId: string\n  public readonly request: Request\n  public readonly response: Response\n\n  constructor(type: EventType, data: DataType) {\n    super(...([type, {}] as any))\n    this.requestId = data.requestId\n    this.request = data.request\n    this.response = data.response\n  }\n}\n\nexport class UnhandledExceptionEvent<\n  DataType extends {\n    error: Error\n    requestId: string\n    request: Request\n  } = {\n    error: Error\n    requestId: string\n    request: Request\n  },\n  ReturnType = void,\n  EventType extends string = string,\n> extends TypedEvent<DataType, ReturnType, EventType> {\n  public readonly error: Error\n  public readonly requestId: string\n  public readonly request: Request\n\n  constructor(type: EventType, data: DataType) {\n    super(...([type, {}] as any))\n    this.error = data.error\n    this.requestId = data.requestId\n    this.request = data.request\n  }\n}\n\nexport type HttpNetworkFrameEventMap = {\n  'request:start': RequestEvent\n  'request:match': RequestEvent\n  'request:unhandled': RequestEvent\n  'request:end': RequestEvent\n  'response:mocked': ResponseEvent\n  'response:bypass': ResponseEvent\n  unhandledException: UnhandledExceptionEvent\n}\n\nexport abstract class HttpNetworkFrame extends NetworkFrame<\n  'http',\n  {\n    id: string\n    request: Request\n  },\n  HttpNetworkFrameEventMap\n> {\n  constructor(options: HttpNetworkFrameOptions) {\n    const id = options.id || createRequestId()\n    super('http', { id, request: options.request })\n  }\n\n  public getHandlers(controller: HandlersController): Array<AnyHandler> {\n    return controller.getHandlersByKind('request')\n  }\n\n  public abstract respondWith(response?: Response): void\n\n  public async getUnhandledMessage(): Promise<string> {\n    const { request } = this.data\n\n    const url = new URL(request.url)\n    const publicUrl = toPublicUrl(url) + url.search\n    const requestBody =\n      request.body == null ? null : await request.clone().text()\n\n    const details = `\\n\\n  \\u2022 ${request.method} ${publicUrl}\\n\\n${requestBody ? `  \\u2022 Request body: ${requestBody}\\n\\n` : ''}`\n    const message = `intercepted a request without a matching request handler:${details}If you still wish to intercept this unhandled request, please create a request handler for it.\\nRead more: https://mswjs.io/docs/http/intercepting-requests`\n\n    return message\n  }\n\n  public async resolve(\n    handlers: Array<RequestHandler>,\n    onUnhandledFrame: UnhandledFrameHandle,\n    resolutionContext?: NetworkFrameResolutionContext,\n  ): Promise<boolean | null> {\n    const { id: requestId, request } = this.data\n    const requestCloneForLogs = resolutionContext?.quiet\n      ? null\n      : request.clone()\n\n    this.events.emit(new RequestEvent('request:start', { requestId, request }))\n\n    // Requests wrapped in explicit \"bypass(request)\".\n    if (shouldBypassRequest(request)) {\n      this.events.emit(new RequestEvent('request:end', { requestId, request }))\n      this.passthrough()\n      return null\n    }\n\n    const [lookupError, lookupResult] = await until(() => {\n      return executeHandlers({\n        requestId,\n        request,\n        handlers,\n        resolutionContext: {\n          baseUrl: resolutionContext?.baseUrl?.toString(),\n          quiet: resolutionContext?.quiet,\n        },\n      })\n    })\n\n    if (lookupError != null) {\n      if (\n        !this.events.emit(\n          new UnhandledExceptionEvent('unhandledException', {\n            error: lookupError,\n            requestId,\n            request,\n          }),\n        )\n      ) {\n        // Surface the error to the developer since they haven't handled it.\n        console.error(lookupError)\n        devUtils.error(\n          'Encountered an unhandled exception during the handler lookup for \"%s %s\". Please see the original error above.',\n          request.method,\n          request.url,\n        )\n      }\n\n      this.errorWith(lookupError)\n      return null\n    }\n\n    // No matching handlers.\n    if (lookupResult == null) {\n      this.events.emit(\n        new RequestEvent('request:unhandled', {\n          requestId,\n          request,\n        }),\n      )\n\n      /**\n       * @note The unhandled frame handle must be executed during the request resolution\n       * since it can influence it (e.g. error the request if the \"error\" startegy was used).\n       */\n      await executeUnhandledFrameHandle(this, onUnhandledFrame).then(\n        () => this.passthrough(),\n        (error) => this.errorWith(error),\n      )\n\n      this.events.emit(\n        new RequestEvent('request:end', {\n          requestId,\n          request,\n        }),\n      )\n\n      return false\n    }\n\n    const { response, handler, parsedResult } = lookupResult\n\n    this.events.emit(\n      new RequestEvent('request:match', {\n        requestId,\n        request,\n      }),\n    )\n\n    // Handlers that returned no mocked response.\n    if (response == null) {\n      this.events.emit(\n        new RequestEvent('request:end', {\n          requestId,\n          request,\n        }),\n      )\n\n      this.passthrough()\n      return null\n    }\n\n    // Handlers that returned explicit `passthrough()`.\n    if (isPassthroughResponse(response)) {\n      this.events.emit(\n        new RequestEvent('request:end', {\n          requestId,\n          request,\n        }),\n      )\n\n      this.passthrough()\n      return null\n    }\n\n    await storeResponseCookies(request, response)\n\n    this.respondWith(response.clone())\n\n    this.events.emit(\n      new RequestEvent('request:end', {\n        requestId,\n        request,\n      }),\n    )\n\n    if (!resolutionContext?.quiet) {\n      handler.log({\n        request: requestCloneForLogs!,\n        response,\n        parsedResult,\n      })\n    }\n\n    return true\n  }\n}\n"],"mappings":"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","names":[]}

package/lib/core/experimental/frames/network-frame.d.mts

@@ -0,0 +1,12 @@
+import 'rettime';
+import '../handlers-controller.mjs';
+export { A as AnyNetworkFrame, E as ExtractFrameEvents, N as NetworkFrame, a as NetworkFrameResolutionContext } from '../../network-frame-B7A0ggXE.mjs';
+import '../../HttpResponse-DlRR1D-f.mjs';
+import '@mswjs/interceptors';
+import '../../utils/internal/isIterable.mjs';
+import '../../typeUtils.mjs';
+import 'graphql';
+import '../../utils/matching/matchRequestUrl.mjs';
+import '../../handlers/WebSocketHandler.mjs';
+import 'strict-event-emitter';
+import '@mswjs/interceptors/WebSocket';

package/lib/core/experimental/frames/network-frame.d.ts

@@ -0,0 +1,12 @@
+import 'rettime';
+import '../handlers-controller.js';
+export { A as AnyNetworkFrame, E as ExtractFrameEvents, N as NetworkFrame, a as NetworkFrameResolutionContext } from '../../network-frame-usYiHS0K.js';
+import '../../HttpResponse-CksOMVAa.js';
+import '@mswjs/interceptors';
+import '../../utils/internal/isIterable.js';
+import '../../typeUtils.js';
+import 'graphql';
+import '../../utils/matching/matchRequestUrl.js';
+import '../../handlers/WebSocketHandler.js';
+import 'strict-event-emitter';
+import '@mswjs/interceptors/WebSocket';

package/lib/core/{handlers/common.js → experimental/frames/network-frame.js}

@@ -3,6 +3,10 @@ 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))
@@ -12,6 +16,18 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var common_exports = {};
-module.exports = __toCommonJS(common_exports);
-//# sourceMappingURL=common.js.map
+var network_frame_exports = {};
+__export(network_frame_exports, {
+  NetworkFrame: () => NetworkFrame
+});
+module.exports = __toCommonJS(network_frame_exports);
+var import_rettime = require("rettime");
+class NetworkFrame {
+  constructor(protocol, data) {
+    this.protocol = protocol;
+    this.data = data;
+    this.events = new import_rettime.Emitter();
+  }
+  events;
+}
+//# sourceMappingURL=network-frame.js.map

package/lib/core/experimental/frames/network-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/experimental/frames/network-frame.ts"],"sourcesContent":["import { Emitter, type DefaultEventMap } from 'rettime'\nimport type { AnyHandler, HandlersController } from '../handlers-controller'\nimport type { UnhandledFrameHandle } from '../on-unhandled-frame'\n\nexport type AnyNetworkFrame = NetworkFrame<string, unknown, any>\n\nexport type ExtractFrameEvents<Frame> =\n  Frame extends NetworkFrame<any, any, infer Events> ? Events : never\n\nexport interface NetworkFrameResolutionContext {\n  baseUrl?: string | URL\n  quiet?: boolean\n}\n\n/**\n * The base for the network frames. Extend this abstract class\n * to implement custom network frames.\n */\nexport abstract class NetworkFrame<\n  Protocol extends string,\n  Data,\n  Events extends DefaultEventMap,\n> {\n  public events: Emitter<Events>\n\n  constructor(\n    public readonly protocol: Protocol,\n    public readonly data: Data,\n  ) {\n    this.events = new Emitter()\n  }\n\n  public abstract getHandlers(controller: HandlersController): Array<AnyHandler>\n\n  /**\n   * Resolve the current frame against the given list of handlers.\n   * Optionally, use a custom resolution context to control behaviors\n   * like `baseUrl`.\n   *\n   * Returns `true` if the frame was handled, `false` if it wasn't, and `null`\n   * if its handling was skipped (e.g. the frame was bypassed).\n   */\n  public abstract resolve(\n    handlers: Array<AnyHandler>,\n    onUnhandledFrame: UnhandledFrameHandle,\n    resolutionContext?: NetworkFrameResolutionContext,\n  ): Promise<boolean | null>\n\n  /**\n   * Perform this network frame as-is.\n   */\n  public abstract passthrough(): void\n\n  /**\n   * Error the underling network frame.\n   * @param reason The reason for the error.\n   */\n  public abstract errorWith(reason?: unknown): void\n\n  /**\n   * Get a message to be used when this frame is unhandled.\n   */\n  public abstract getUnhandledMessage(): Promise<string>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA8C;AAkBvC,MAAe,aAIpB;AAAA,EAGA,YACkB,UACA,MAChB;AAFgB;AACA;AAEhB,SAAK,SAAS,IAAI,uBAAQ;AAAA,EAC5B;AAAA,EAPO;AAwCT;","names":[]}

package/lib/core/experimental/frames/network-frame.mjs

@@ -0,0 +1,13 @@
+import { Emitter } from "rettime";
+class NetworkFrame {
+  constructor(protocol, data) {
+    this.protocol = protocol;
+    this.data = data;
+    this.events = new Emitter();
+  }
+  events;
+}
+export {
+  NetworkFrame
+};
+//# sourceMappingURL=network-frame.mjs.map

package/lib/core/experimental/frames/network-frame.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/experimental/frames/network-frame.ts"],"sourcesContent":["import { Emitter, type DefaultEventMap } from 'rettime'\nimport type { AnyHandler, HandlersController } from '../handlers-controller'\nimport type { UnhandledFrameHandle } from '../on-unhandled-frame'\n\nexport type AnyNetworkFrame = NetworkFrame<string, unknown, any>\n\nexport type ExtractFrameEvents<Frame> =\n  Frame extends NetworkFrame<any, any, infer Events> ? Events : never\n\nexport interface NetworkFrameResolutionContext {\n  baseUrl?: string | URL\n  quiet?: boolean\n}\n\n/**\n * The base for the network frames. Extend this abstract class\n * to implement custom network frames.\n */\nexport abstract class NetworkFrame<\n  Protocol extends string,\n  Data,\n  Events extends DefaultEventMap,\n> {\n  public events: Emitter<Events>\n\n  constructor(\n    public readonly protocol: Protocol,\n    public readonly data: Data,\n  ) {\n    this.events = new Emitter()\n  }\n\n  public abstract getHandlers(controller: HandlersController): Array<AnyHandler>\n\n  /**\n   * Resolve the current frame against the given list of handlers.\n   * Optionally, use a custom resolution context to control behaviors\n   * like `baseUrl`.\n   *\n   * Returns `true` if the frame was handled, `false` if it wasn't, and `null`\n   * if its handling was skipped (e.g. the frame was bypassed).\n   */\n  public abstract resolve(\n    handlers: Array<AnyHandler>,\n    onUnhandledFrame: UnhandledFrameHandle,\n    resolutionContext?: NetworkFrameResolutionContext,\n  ): Promise<boolean | null>\n\n  /**\n   * Perform this network frame as-is.\n   */\n  public abstract passthrough(): void\n\n  /**\n   * Error the underling network frame.\n   * @param reason The reason for the error.\n   */\n  public abstract errorWith(reason?: unknown): void\n\n  /**\n   * Get a message to be used when this frame is unhandled.\n   */\n  public abstract getUnhandledMessage(): Promise<string>\n}\n"],"mappings":"AAAA,SAAS,eAAqC;AAkBvC,MAAe,aAIpB;AAAA,EAGA,YACkB,UACA,MAChB;AAFgB;AACA;AAEhB,SAAK,SAAS,IAAI,QAAQ;AAAA,EAC5B;AAAA,EAPO;AAwCT;","names":[]}