msw 2.14.7 → 3.0.0

package/lib/core/experimental/define-network.d.mts

@@ -1,75 +0,0 @@
-import { Emitter, DefaultEventMap } from 'rettime';
-import { NetworkSource, ExtractSourceEvents } from './sources/network-source.mjs';
-import { a as NetworkFrameResolutionContext, b as UnhandledFrameHandle } from '../on-unhandled-frame-gkokW4Rr.mjs';
-import { AnyHandler, HandlersController } from './handlers-controller.mjs';
-import '../HttpResponse-BTyqrRB6.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';
-
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-type MergeEventMaps<Sources extends Array<NetworkSource<any>>> = UnionToIntersection<ExtractSourceEvents<Sources[number]>> extends infer R ? R extends Record<string, any> ? R : DefaultEventMap : DefaultEventMap;
-type MaybePromise<T> = Extract<T, Promise<unknown>> extends never ? void : Promise<void>;
-interface DefineNetworkOptions<Sources extends Array<NetworkSource<any>>> {
-    /**
-     * List of the network sources.
-     * Every network source emits frames, and every frame describes how
-     * to handle the various network scenarios, like mocking a response,
-     * erroring the request, or performing it as-is.
-     */
-    sources: Sources;
-    /**
-     * List of handlers to describe the network.
-     */
-    handlers?: Array<AnyHandler> | HandlersController;
-    context?: NetworkFrameResolutionContext;
-    onUnhandledFrame?: UnhandledFrameHandle;
-}
-interface NetworkApi<Sources extends Array<NetworkSource<any>>> extends NetworkHandlersApi {
-    readyState: NetworkReadyState;
-    /**
-     * Enable the network interception and handling.
-     */
-    enable: () => MaybePromise<ReturnType<Sources[number]['enable']>>;
-    /**
-     * Disable the network interception and handling.
-     */
-    disable: () => MaybePromise<ReturnType<Sources[number]['disable']>>;
-    /**
-     * Configure the network instance with additional options.
-     * The options provided in the `.configure()` call will override the same
-     * options in the `defineNetwork()` call.
-     */
-    configure: (options: Partial<DefineNetworkOptions<Sources>>) => void;
-    events: Emitter<MergeEventMaps<Sources>>;
-}
-interface NetworkHandlersApi {
-    use: (...handlers: Array<AnyHandler>) => void;
-    resetHandlers: (...handlers: Array<AnyHandler>) => void;
-    restoreHandlers: () => void;
-    listHandlers: () => ReadonlyArray<AnyHandler>;
-}
-declare enum NetworkReadyState {
-    DISABLED = 0,
-    ENABLED = 1
-}
-/**
- * Define a network instance with the given configuration.
- * @example
- * import { InterceptorSource } from 'msw/experimental'
- * import { handlers } from './handlers'
- *
- * const network = defineNetwork({
- *   sources: [new InterceptorSource({ interceptors })],
- *   handlers,
- * })
- * await network.enable()
- */
-declare function defineNetwork<Sources extends Array<NetworkSource<any>>>(options: DefineNetworkOptions<Sources>): NetworkApi<Sources>;
-
-export { type DefineNetworkOptions, type NetworkApi, type NetworkHandlersApi, NetworkReadyState, defineNetwork };

package/lib/core/experimental/define-network.d.ts

@@ -1,75 +0,0 @@
-import { Emitter, DefaultEventMap } from 'rettime';
-import { NetworkSource, ExtractSourceEvents } from './sources/network-source.js';
-import { a as NetworkFrameResolutionContext, b as UnhandledFrameHandle } from '../on-unhandled-frame-0KmwUmeV.js';
-import { AnyHandler, HandlersController } from './handlers-controller.js';
-import '../HttpResponse-BXyXQFMJ.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';
-
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-type MergeEventMaps<Sources extends Array<NetworkSource<any>>> = UnionToIntersection<ExtractSourceEvents<Sources[number]>> extends infer R ? R extends Record<string, any> ? R : DefaultEventMap : DefaultEventMap;
-type MaybePromise<T> = Extract<T, Promise<unknown>> extends never ? void : Promise<void>;
-interface DefineNetworkOptions<Sources extends Array<NetworkSource<any>>> {
-    /**
-     * List of the network sources.
-     * Every network source emits frames, and every frame describes how
-     * to handle the various network scenarios, like mocking a response,
-     * erroring the request, or performing it as-is.
-     */
-    sources: Sources;
-    /**
-     * List of handlers to describe the network.
-     */
-    handlers?: Array<AnyHandler> | HandlersController;
-    context?: NetworkFrameResolutionContext;
-    onUnhandledFrame?: UnhandledFrameHandle;
-}
-interface NetworkApi<Sources extends Array<NetworkSource<any>>> extends NetworkHandlersApi {
-    readyState: NetworkReadyState;
-    /**
-     * Enable the network interception and handling.
-     */
-    enable: () => MaybePromise<ReturnType<Sources[number]['enable']>>;
-    /**
-     * Disable the network interception and handling.
-     */
-    disable: () => MaybePromise<ReturnType<Sources[number]['disable']>>;
-    /**
-     * Configure the network instance with additional options.
-     * The options provided in the `.configure()` call will override the same
-     * options in the `defineNetwork()` call.
-     */
-    configure: (options: Partial<DefineNetworkOptions<Sources>>) => void;
-    events: Emitter<MergeEventMaps<Sources>>;
-}
-interface NetworkHandlersApi {
-    use: (...handlers: Array<AnyHandler>) => void;
-    resetHandlers: (...handlers: Array<AnyHandler>) => void;
-    restoreHandlers: () => void;
-    listHandlers: () => ReadonlyArray<AnyHandler>;
-}
-declare enum NetworkReadyState {
-    DISABLED = 0,
-    ENABLED = 1
-}
-/**
- * Define a network instance with the given configuration.
- * @example
- * import { InterceptorSource } from 'msw/experimental'
- * import { handlers } from './handlers'
- *
- * const network = defineNetwork({
- *   sources: [new InterceptorSource({ interceptors })],
- *   handlers,
- * })
- * await network.enable()
- */
-declare function defineNetwork<Sources extends Array<NetworkSource<any>>>(options: DefineNetworkOptions<Sources>): NetworkApi<Sources>;
-
-export { type DefineNetworkOptions, type NetworkApi, type NetworkHandlersApi, NetworkReadyState, defineNetwork };

package/lib/core/experimental/define-network.js

@@ -1,134 +0,0 @@
-"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 define_network_exports = {};
-__export(define_network_exports, {
-  NetworkReadyState: () => NetworkReadyState,
-  defineNetwork: () => defineNetwork
-});
-module.exports = __toCommonJS(define_network_exports);
-var import_outvariant = require("outvariant");
-var import_rettime = require("rettime");
-var import_network_source = require("./sources/network-source");
-var import_network_frame = require("./frames/network-frame");
-var import_on_unhandled_frame = require("./on-unhandled-frame");
-var import_handlers_controller = require("./handlers-controller");
-var import_toReadonlyArray = require("../utils/internal/toReadonlyArray");
-var import_Disposable = require("../utils/internal/Disposable");
-function colorlessPromiseAll(values) {
-  const promises = [];
-  for (const value of values) {
-    if (value instanceof Promise) {
-      promises.push(value);
-    }
-  }
-  if (promises.length > 0) {
-    return Promise.all(promises).then(() => {
-    });
-  }
-}
-var NetworkReadyState = /* @__PURE__ */ ((NetworkReadyState2) => {
-  NetworkReadyState2[NetworkReadyState2["DISABLED"] = 0] = "DISABLED";
-  NetworkReadyState2[NetworkReadyState2["ENABLED"] = 1] = "ENABLED";
-  return NetworkReadyState2;
-})(NetworkReadyState || {});
-function defineNetwork(options) {
-  let readyState = 0 /* DISABLED */;
-  const events = new import_rettime.Emitter();
-  const disposable = new import_Disposable.Disposable();
-  const deriveHandlersController = (handlers) => {
-    return handlers instanceof import_handlers_controller.HandlersController ? handlers : new import_handlers_controller.InMemoryHandlersController(handlers || []);
-  };
-  let resolvedOptions = {
-    ...options
-  };
-  let handlersController = deriveHandlersController(resolvedOptions.handlers);
-  return {
-    get readyState() {
-      return readyState;
-    },
-    events,
-    configure(options2) {
-      (0, import_outvariant.invariant)(
-        readyState === 0 /* DISABLED */,
-        'Failed to call "configure()" on the network: cannot configure an already enabled network.'
-      );
-      if (options2.handlers && !Object.is(options2.handlers, resolvedOptions.handlers)) {
-        handlersController = deriveHandlersController(options2.handlers);
-      }
-      resolvedOptions = {
-        ...resolvedOptions,
-        ...options2
-      };
-    },
-    enable() {
-      (0, import_outvariant.invariant)(
-        readyState === 0 /* DISABLED */,
-        'Failed to call "enable" on the network: already enabled'
-      );
-      readyState = 1 /* ENABLED */;
-      const session = { active: true };
-      disposable["subscriptions"].push(() => {
-        session.active = false;
-      });
-      const result = resolvedOptions.sources.map((source) => {
-        import_network_source.NetworkSource.prototype.disable.call(source);
-        source.on("frame", async ({ frame }) => {
-          frame.events.on("*", (event) => {
-            if (!session.active) {
-              return;
-            }
-            events.emit(event);
-          });
-          const handlers = frame.getHandlers(handlersController);
-          await frame.resolve(
-            handlers,
-            resolvedOptions.onUnhandledFrame || "warn",
-            resolvedOptions.context
-          );
-        });
-        return source.enable();
-      });
-      return colorlessPromiseAll(result);
-    },
-    disable() {
-      (0, import_outvariant.invariant)(
-        readyState === 1 /* ENABLED */,
-        'Failed to call "disable" on the network: already disabled'
-      );
-      readyState = 0 /* DISABLED */;
-      disposable.dispose();
-      return colorlessPromiseAll(
-        resolvedOptions.sources.map((source) => source.disable())
-      );
-    },
-    use(...handlers) {
-      handlersController.use(handlers);
-    },
-    resetHandlers(...handlers) {
-      handlersController.reset(handlers);
-    },
-    restoreHandlers() {
-      handlersController.restore();
-    },
-    listHandlers() {
-      return (0, import_toReadonlyArray.toReadonlyArray)(handlersController.currentHandlers());
-    }
-  };
-}
-//# sourceMappingURL=define-network.js.map

package/lib/core/experimental/define-network.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/core/experimental/define-network.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport { Emitter, type DefaultEventMap } from 'rettime'\nimport {\n  NetworkSource,\n  type ExtractSourceEvents,\n} from './sources/network-source'\nimport { type NetworkFrameResolutionContext } from './frames/network-frame'\nimport { type UnhandledFrameHandle } from './on-unhandled-frame'\nimport {\n  HandlersController,\n  InMemoryHandlersController,\n  type AnyHandler,\n} from './handlers-controller'\nimport { toReadonlyArray } from '../utils/internal/toReadonlyArray'\nimport { Disposable } from '../utils/internal/Disposable'\n\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never\n\ntype MergeEventMaps<Sources extends Array<NetworkSource<any>>> =\n  UnionToIntersection<ExtractSourceEvents<Sources[number]>> extends infer R\n    ? R extends Record<string, any>\n      ? R\n      : DefaultEventMap\n    : DefaultEventMap\n\ntype MaybePromise<T> =\n  Extract<T, Promise<unknown>> extends never ? void : Promise<void>\n\nexport interface DefineNetworkOptions<\n  Sources extends Array<NetworkSource<any>>,\n> {\n  /**\n   * List of the network sources.\n   * Every network source emits frames, and every frame describes how\n   * to handle the various network scenarios, like mocking a response,\n   * erroring the request, or performing it as-is.\n   */\n  sources: Sources\n  /**\n   * List of handlers to describe the network.\n   */\n  handlers?: Array<AnyHandler> | HandlersController\n  context?: NetworkFrameResolutionContext\n  onUnhandledFrame?: UnhandledFrameHandle\n}\n\nexport interface NetworkApi<\n  Sources extends Array<NetworkSource<any>>,\n> extends NetworkHandlersApi {\n  readyState: NetworkReadyState\n  /**\n   * Enable the network interception and handling.\n   */\n  enable: () => MaybePromise<ReturnType<Sources[number]['enable']>>\n  /**\n   * Disable the network interception and handling.\n   */\n  disable: () => MaybePromise<ReturnType<Sources[number]['disable']>>\n  /**\n   * Configure the network instance with additional options.\n   * The options provided in the `.configure()` call will override the same\n   * options in the `defineNetwork()` call.\n   */\n  configure: (options: Partial<DefineNetworkOptions<Sources>>) => void\n  events: Emitter<MergeEventMaps<Sources>>\n}\n\nexport interface NetworkHandlersApi {\n  use: (...handlers: Array<AnyHandler>) => void\n  resetHandlers: (...handlers: Array<AnyHandler>) => void\n  restoreHandlers: () => void\n  listHandlers: () => ReadonlyArray<AnyHandler>\n}\n\nfunction colorlessPromiseAll<T>(values: Array<T>): MaybePromise<T>\nfunction colorlessPromiseAll(values: Array<unknown>): Promise<void> | void {\n  const promises: Array<Promise<void>> = []\n\n  for (const value of values) {\n    if (value instanceof Promise) {\n      promises.push(value)\n    }\n  }\n\n  if (promises.length > 0) {\n    return Promise.all(promises).then(() => {})\n  }\n}\n\nexport enum NetworkReadyState {\n  DISABLED,\n  ENABLED,\n}\n\n/**\n * Define a network instance with the given configuration.\n * @example\n * import { InterceptorSource } from 'msw/experimental'\n * import { handlers } from './handlers'\n *\n * const network = defineNetwork({\n *   sources: [new InterceptorSource({ interceptors })],\n *   handlers,\n * })\n * await network.enable()\n */\nexport function defineNetwork<Sources extends Array<NetworkSource<any>>>(\n  options: DefineNetworkOptions<Sources>,\n): NetworkApi<Sources> {\n  let readyState: NetworkReadyState = NetworkReadyState.DISABLED\n  const events = new Emitter<MergeEventMaps<Sources>>()\n  const disposable = new Disposable()\n\n  const deriveHandlersController = (\n    handlers: DefineNetworkOptions<Sources>['handlers'],\n  ) => {\n    return handlers instanceof HandlersController\n      ? handlers\n      : new InMemoryHandlersController(handlers || [])\n  }\n\n  let resolvedOptions: DefineNetworkOptions<Sources> = {\n    ...options,\n  }\n\n  /**\n   * @note Create the handlers controller immediately because\n   * certain setup APIs, like `setupServer`, don't await `.enable` (`.listen`).\n   */\n  let handlersController = deriveHandlersController(resolvedOptions.handlers)\n\n  return {\n    get readyState() {\n      return readyState\n    },\n    events,\n    configure(options) {\n      invariant(\n        readyState === NetworkReadyState.DISABLED,\n        'Failed to call \"configure()\" on the network: cannot configure an already enabled network.',\n      )\n\n      if (\n        options.handlers &&\n        !Object.is(options.handlers, resolvedOptions.handlers)\n      ) {\n        handlersController = deriveHandlersController(options.handlers)\n      }\n\n      resolvedOptions = {\n        ...resolvedOptions,\n        ...options,\n      }\n    },\n    enable() {\n      invariant(\n        readyState === NetworkReadyState.DISABLED,\n        'Failed to call \"enable\" on the network: already enabled',\n      )\n\n      readyState = NetworkReadyState.ENABLED\n\n      /**\n       * @note Use a session object scoped to the current \"enable()\"\n       * to prevent \"frame.events\" listeners from surviving across enable/disable cycles.\n       * @see The note about `AbortController` below.\n       */\n      const session = { active: true }\n      disposable['subscriptions'].push(() => {\n        session.active = false\n      })\n\n      const result = resolvedOptions.sources.map((source) => {\n        /**\n         * @note Preemptively disable the network source before enabling.\n         * This intentionally calls only the prototype method that clears the\n         * event listeners and nothing else. This prevents the \"frame\" listeners\n         * from accumulating across enable/disable in case the source is a singleton.\n         */\n        NetworkSource.prototype.disable.call(source)\n\n        source.on('frame', async ({ frame }) => {\n          frame.events.on('*', (event) => {\n            /**\n             * @note Prevent event forwarding manually and not via an AbortController\n             * because certain runtimes, like Cloudflare, throw when referencing an\n             * AbortController created in a different context. Bear in mind that the frame\n             * events run in the patched request client context while the AbortController\n             * is created outside, in the \"defineNetwork\" closure, which is a test context.\n             */\n            if (!session.active) {\n              return\n            }\n\n            events.emit(event)\n          })\n\n          const handlers = frame.getHandlers(handlersController)\n\n          await frame.resolve(\n            handlers,\n            resolvedOptions.onUnhandledFrame || 'warn',\n            resolvedOptions.context,\n          )\n        })\n\n        return source.enable()\n      })\n\n      return colorlessPromiseAll(result) as MaybePromise<\n        ReturnType<Sources[number]['enable']>\n      >\n    },\n    disable() {\n      invariant(\n        readyState === NetworkReadyState.ENABLED,\n        'Failed to call \"disable\" on the network: already disabled',\n      )\n\n      readyState = NetworkReadyState.DISABLED\n      disposable.dispose()\n\n      return colorlessPromiseAll(\n        resolvedOptions.sources.map((source) => source.disable()),\n      ) as MaybePromise<ReturnType<Sources[number]['disable']>>\n    },\n    use(...handlers) {\n      handlersController.use(handlers)\n    },\n    resetHandlers(...handlers) {\n      handlersController.reset(handlers)\n    },\n    restoreHandlers() {\n      handlersController.restore()\n    },\n    listHandlers() {\n      return toReadonlyArray(handlersController.currentHandlers())\n    },\n  }\n}\n"],"mappings":"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","names":["NetworkReadyState","options"]}

package/lib/core/experimental/define-network.mjs

@@ -1,119 +0,0 @@
-import { invariant } from "outvariant";
-import { Emitter } from "rettime";
-import {
-  NetworkSource
-} from './sources/network-source.mjs';
-import {} from './frames/network-frame.mjs';
-import {} from './on-unhandled-frame.mjs';
-import {
-  HandlersController,
-  InMemoryHandlersController
-} from './handlers-controller.mjs';
-import { toReadonlyArray } from '../utils/internal/toReadonlyArray.mjs';
-import { Disposable } from '../utils/internal/Disposable.mjs';
-function colorlessPromiseAll(values) {
-  const promises = [];
-  for (const value of values) {
-    if (value instanceof Promise) {
-      promises.push(value);
-    }
-  }
-  if (promises.length > 0) {
-    return Promise.all(promises).then(() => {
-    });
-  }
-}
-var NetworkReadyState = /* @__PURE__ */ ((NetworkReadyState2) => {
-  NetworkReadyState2[NetworkReadyState2["DISABLED"] = 0] = "DISABLED";
-  NetworkReadyState2[NetworkReadyState2["ENABLED"] = 1] = "ENABLED";
-  return NetworkReadyState2;
-})(NetworkReadyState || {});
-function defineNetwork(options) {
-  let readyState = 0 /* DISABLED */;
-  const events = new Emitter();
-  const disposable = new Disposable();
-  const deriveHandlersController = (handlers) => {
-    return handlers instanceof HandlersController ? handlers : new InMemoryHandlersController(handlers || []);
-  };
-  let resolvedOptions = {
-    ...options
-  };
-  let handlersController = deriveHandlersController(resolvedOptions.handlers);
-  return {
-    get readyState() {
-      return readyState;
-    },
-    events,
-    configure(options2) {
-      invariant(
-        readyState === 0 /* DISABLED */,
-        'Failed to call "configure()" on the network: cannot configure an already enabled network.'
-      );
-      if (options2.handlers && !Object.is(options2.handlers, resolvedOptions.handlers)) {
-        handlersController = deriveHandlersController(options2.handlers);
-      }
-      resolvedOptions = {
-        ...resolvedOptions,
-        ...options2
-      };
-    },
-    enable() {
-      invariant(
-        readyState === 0 /* DISABLED */,
-        'Failed to call "enable" on the network: already enabled'
-      );
-      readyState = 1 /* ENABLED */;
-      const session = { active: true };
-      disposable["subscriptions"].push(() => {
-        session.active = false;
-      });
-      const result = resolvedOptions.sources.map((source) => {
-        NetworkSource.prototype.disable.call(source);
-        source.on("frame", async ({ frame }) => {
-          frame.events.on("*", (event) => {
-            if (!session.active) {
-              return;
-            }
-            events.emit(event);
-          });
-          const handlers = frame.getHandlers(handlersController);
-          await frame.resolve(
-            handlers,
-            resolvedOptions.onUnhandledFrame || "warn",
-            resolvedOptions.context
-          );
-        });
-        return source.enable();
-      });
-      return colorlessPromiseAll(result);
-    },
-    disable() {
-      invariant(
-        readyState === 1 /* ENABLED */,
-        'Failed to call "disable" on the network: already disabled'
-      );
-      readyState = 0 /* DISABLED */;
-      disposable.dispose();
-      return colorlessPromiseAll(
-        resolvedOptions.sources.map((source) => source.disable())
-      );
-    },
-    use(...handlers) {
-      handlersController.use(handlers);
-    },
-    resetHandlers(...handlers) {
-      handlersController.reset(handlers);
-    },
-    restoreHandlers() {
-      handlersController.restore();
-    },
-    listHandlers() {
-      return toReadonlyArray(handlersController.currentHandlers());
-    }
-  };
-}
-export {
-  NetworkReadyState,
-  defineNetwork
-};
-//# sourceMappingURL=define-network.mjs.map

package/lib/core/experimental/define-network.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/core/experimental/define-network.ts"],"sourcesContent":["import { invariant } from 'outvariant'\nimport { Emitter, type DefaultEventMap } from 'rettime'\nimport {\n  NetworkSource,\n  type ExtractSourceEvents,\n} from './sources/network-source'\nimport { type NetworkFrameResolutionContext } from './frames/network-frame'\nimport { type UnhandledFrameHandle } from './on-unhandled-frame'\nimport {\n  HandlersController,\n  InMemoryHandlersController,\n  type AnyHandler,\n} from './handlers-controller'\nimport { toReadonlyArray } from '../utils/internal/toReadonlyArray'\nimport { Disposable } from '../utils/internal/Disposable'\n\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never\n\ntype MergeEventMaps<Sources extends Array<NetworkSource<any>>> =\n  UnionToIntersection<ExtractSourceEvents<Sources[number]>> extends infer R\n    ? R extends Record<string, any>\n      ? R\n      : DefaultEventMap\n    : DefaultEventMap\n\ntype MaybePromise<T> =\n  Extract<T, Promise<unknown>> extends never ? void : Promise<void>\n\nexport interface DefineNetworkOptions<\n  Sources extends Array<NetworkSource<any>>,\n> {\n  /**\n   * List of the network sources.\n   * Every network source emits frames, and every frame describes how\n   * to handle the various network scenarios, like mocking a response,\n   * erroring the request, or performing it as-is.\n   */\n  sources: Sources\n  /**\n   * List of handlers to describe the network.\n   */\n  handlers?: Array<AnyHandler> | HandlersController\n  context?: NetworkFrameResolutionContext\n  onUnhandledFrame?: UnhandledFrameHandle\n}\n\nexport interface NetworkApi<\n  Sources extends Array<NetworkSource<any>>,\n> extends NetworkHandlersApi {\n  readyState: NetworkReadyState\n  /**\n   * Enable the network interception and handling.\n   */\n  enable: () => MaybePromise<ReturnType<Sources[number]['enable']>>\n  /**\n   * Disable the network interception and handling.\n   */\n  disable: () => MaybePromise<ReturnType<Sources[number]['disable']>>\n  /**\n   * Configure the network instance with additional options.\n   * The options provided in the `.configure()` call will override the same\n   * options in the `defineNetwork()` call.\n   */\n  configure: (options: Partial<DefineNetworkOptions<Sources>>) => void\n  events: Emitter<MergeEventMaps<Sources>>\n}\n\nexport interface NetworkHandlersApi {\n  use: (...handlers: Array<AnyHandler>) => void\n  resetHandlers: (...handlers: Array<AnyHandler>) => void\n  restoreHandlers: () => void\n  listHandlers: () => ReadonlyArray<AnyHandler>\n}\n\nfunction colorlessPromiseAll<T>(values: Array<T>): MaybePromise<T>\nfunction colorlessPromiseAll(values: Array<unknown>): Promise<void> | void {\n  const promises: Array<Promise<void>> = []\n\n  for (const value of values) {\n    if (value instanceof Promise) {\n      promises.push(value)\n    }\n  }\n\n  if (promises.length > 0) {\n    return Promise.all(promises).then(() => {})\n  }\n}\n\nexport enum NetworkReadyState {\n  DISABLED,\n  ENABLED,\n}\n\n/**\n * Define a network instance with the given configuration.\n * @example\n * import { InterceptorSource } from 'msw/experimental'\n * import { handlers } from './handlers'\n *\n * const network = defineNetwork({\n *   sources: [new InterceptorSource({ interceptors })],\n *   handlers,\n * })\n * await network.enable()\n */\nexport function defineNetwork<Sources extends Array<NetworkSource<any>>>(\n  options: DefineNetworkOptions<Sources>,\n): NetworkApi<Sources> {\n  let readyState: NetworkReadyState = NetworkReadyState.DISABLED\n  const events = new Emitter<MergeEventMaps<Sources>>()\n  const disposable = new Disposable()\n\n  const deriveHandlersController = (\n    handlers: DefineNetworkOptions<Sources>['handlers'],\n  ) => {\n    return handlers instanceof HandlersController\n      ? handlers\n      : new InMemoryHandlersController(handlers || [])\n  }\n\n  let resolvedOptions: DefineNetworkOptions<Sources> = {\n    ...options,\n  }\n\n  /**\n   * @note Create the handlers controller immediately because\n   * certain setup APIs, like `setupServer`, don't await `.enable` (`.listen`).\n   */\n  let handlersController = deriveHandlersController(resolvedOptions.handlers)\n\n  return {\n    get readyState() {\n      return readyState\n    },\n    events,\n    configure(options) {\n      invariant(\n        readyState === NetworkReadyState.DISABLED,\n        'Failed to call \"configure()\" on the network: cannot configure an already enabled network.',\n      )\n\n      if (\n        options.handlers &&\n        !Object.is(options.handlers, resolvedOptions.handlers)\n      ) {\n        handlersController = deriveHandlersController(options.handlers)\n      }\n\n      resolvedOptions = {\n        ...resolvedOptions,\n        ...options,\n      }\n    },\n    enable() {\n      invariant(\n        readyState === NetworkReadyState.DISABLED,\n        'Failed to call \"enable\" on the network: already enabled',\n      )\n\n      readyState = NetworkReadyState.ENABLED\n\n      /**\n       * @note Use a session object scoped to the current \"enable()\"\n       * to prevent \"frame.events\" listeners from surviving across enable/disable cycles.\n       * @see The note about `AbortController` below.\n       */\n      const session = { active: true }\n      disposable['subscriptions'].push(() => {\n        session.active = false\n      })\n\n      const result = resolvedOptions.sources.map((source) => {\n        /**\n         * @note Preemptively disable the network source before enabling.\n         * This intentionally calls only the prototype method that clears the\n         * event listeners and nothing else. This prevents the \"frame\" listeners\n         * from accumulating across enable/disable in case the source is a singleton.\n         */\n        NetworkSource.prototype.disable.call(source)\n\n        source.on('frame', async ({ frame }) => {\n          frame.events.on('*', (event) => {\n            /**\n             * @note Prevent event forwarding manually and not via an AbortController\n             * because certain runtimes, like Cloudflare, throw when referencing an\n             * AbortController created in a different context. Bear in mind that the frame\n             * events run in the patched request client context while the AbortController\n             * is created outside, in the \"defineNetwork\" closure, which is a test context.\n             */\n            if (!session.active) {\n              return\n            }\n\n            events.emit(event)\n          })\n\n          const handlers = frame.getHandlers(handlersController)\n\n          await frame.resolve(\n            handlers,\n            resolvedOptions.onUnhandledFrame || 'warn',\n            resolvedOptions.context,\n          )\n        })\n\n        return source.enable()\n      })\n\n      return colorlessPromiseAll(result) as MaybePromise<\n        ReturnType<Sources[number]['enable']>\n      >\n    },\n    disable() {\n      invariant(\n        readyState === NetworkReadyState.ENABLED,\n        'Failed to call \"disable\" on the network: already disabled',\n      )\n\n      readyState = NetworkReadyState.DISABLED\n      disposable.dispose()\n\n      return colorlessPromiseAll(\n        resolvedOptions.sources.map((source) => source.disable()),\n      ) as MaybePromise<ReturnType<Sources[number]['disable']>>\n    },\n    use(...handlers) {\n      handlersController.use(handlers)\n    },\n    resetHandlers(...handlers) {\n      handlersController.reset(handlers)\n    },\n    restoreHandlers() {\n      handlersController.restore()\n    },\n    listHandlers() {\n      return toReadonlyArray(handlersController.currentHandlers())\n    },\n  }\n}\n"],"mappings":"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","names":["NetworkReadyState","options"]}

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

@@ -1,77 +0,0 @@
-import { TypedEvent } from 'rettime';
-import { N as NetworkFrame, b as UnhandledFrameHandle, a as NetworkFrameResolutionContext } from '../../on-unhandled-frame-gkokW4Rr.mjs';
-import { HandlersController, AnyHandler } from '../handlers-controller.mjs';
-import { R as RequestHandler } from '../../HttpResponse-BTyqrRB6.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

@@ -1,77 +0,0 @@
-import { TypedEvent } from 'rettime';
-import { N as NetworkFrame, b as UnhandledFrameHandle, a as NetworkFrameResolutionContext } from '../../on-unhandled-frame-0KmwUmeV.js';
-import { HandlersController, AnyHandler } from '../handlers-controller.js';
-import { R as RequestHandler } from '../../HttpResponse-BXyXQFMJ.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 };