msw 2.12.13 → 2.13.0

package/lib/native/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/native/index.ts","../../src/node/SetupServerCommonApi.ts"],"sourcesContent":["import { FetchInterceptor } from '@mswjs/interceptors/fetch'\nimport { XMLHttpRequestInterceptor } from '@mswjs/interceptors/XMLHttpRequest'\nimport type { RequestHandler } from '~/core/handlers/RequestHandler'\nimport { SetupServerCommonApi } from '../node/SetupServerCommonApi'\n\n/**\n * Sets up a requests interception in React Native with the given request handlers.\n * @param {RequestHandler[]} handlers List of request handlers.\n *\n * @see {@link https://mswjs.io/docs/api/setup-server `setupServer()` API reference}\n */\nexport function setupServer(\n  ...handlers: Array<RequestHandler>\n): SetupServerCommonApi {\n  // Provision request interception via patching the `XMLHttpRequest` class only\n  // in React Native. There is no `http`/`https` modules in that environment.\n  return new SetupServerCommonApi(\n    [new FetchInterceptor(), new XMLHttpRequestInterceptor()],\n    handlers,\n  )\n}\n","/**\n * @note This API is extended by both \"msw/node\" and \"msw/native\"\n * so be minding about the things you import!\n */\nimport type { RequiredDeep } from 'type-fest'\nimport { invariant } from 'outvariant'\nimport {\n  BatchInterceptor,\n  InterceptorReadyState,\n  type HttpRequestEventMap,\n  type Interceptor,\n} from '@mswjs/interceptors'\nimport type { LifeCycleEventsMap, SharedOptions } from '~/core/sharedOptions'\nimport { SetupApi } from '~/core/SetupApi'\nimport { handleRequest } from '~/core/utils/handleRequest'\nimport type { RequestHandler } from '~/core/handlers/RequestHandler'\nimport type { WebSocketHandler } from '~/core/handlers/WebSocketHandler'\nimport { mergeRight } from '~/core/utils/internal/mergeRight'\nimport { InternalError, devUtils } from '~/core/utils/internal/devUtils'\nimport type { SetupServerCommon } from './glossary'\nimport { handleWebSocketEvent } from '~/core/ws/handleWebSocketEvent'\nimport { webSocketInterceptor } from '~/core/ws/webSocketInterceptor'\nimport { isHandlerKind } from '~/core/utils/internal/isHandlerKind'\n\nconst DEFAULT_LISTEN_OPTIONS: RequiredDeep<SharedOptions> = {\n  onUnhandledRequest: 'warn',\n}\n\nexport class SetupServerCommonApi\n  extends SetupApi<LifeCycleEventsMap>\n  implements SetupServerCommon\n{\n  protected readonly interceptor: BatchInterceptor<\n    Array<Interceptor<HttpRequestEventMap>>,\n    HttpRequestEventMap\n  >\n  private resolvedOptions: RequiredDeep<SharedOptions>\n\n  constructor(\n    interceptors: Array<Interceptor<HttpRequestEventMap>>,\n    handlers: Array<RequestHandler | WebSocketHandler>,\n  ) {\n    super(...handlers)\n\n    this.interceptor = new BatchInterceptor({\n      name: 'setup-server',\n      interceptors,\n    })\n\n    this.resolvedOptions = {} as RequiredDeep<SharedOptions>\n  }\n\n  /**\n   * Subscribe to all requests that are using the interceptor object\n   */\n  private init(): void {\n    this.interceptor.on(\n      'request',\n      async ({ request, requestId, controller }) => {\n        const response = await handleRequest(\n          request,\n          requestId,\n          this.handlersController\n            .currentHandlers()\n            .filter(isHandlerKind('RequestHandler')),\n          this.resolvedOptions,\n          this.emitter,\n          {\n            onPassthroughResponse(request) {\n              const acceptHeader = request.headers.get('accept')\n\n              /**\n               * @note Remove the internal bypass request header.\n               * In the browser, this is done by the worker script.\n               * In Node.js, it has to be done here.\n               */\n              if (acceptHeader) {\n                const nextAcceptHeader = acceptHeader.replace(\n                  /(,\\s+)?msw\\/passthrough/,\n                  '',\n                )\n\n                if (nextAcceptHeader) {\n                  request.headers.set('accept', nextAcceptHeader)\n                } else {\n                  request.headers.delete('accept')\n                }\n              }\n            },\n          },\n        )\n\n        if (response) {\n          controller.respondWith(response)\n        }\n\n        return\n      },\n    )\n\n    this.interceptor.on('unhandledException', ({ error }) => {\n      if (error instanceof InternalError) {\n        throw error\n      }\n    })\n\n    this.interceptor.on(\n      'response',\n      ({ response, isMockedResponse, request, requestId }) => {\n        this.emitter.emit(\n          isMockedResponse ? 'response:mocked' : 'response:bypass',\n          {\n            response,\n            request,\n            requestId,\n          },\n        )\n      },\n    )\n\n    // Preconfigure the WebSocket interception but don't enable it just yet.\n    // It will be enabled when the server starts.\n    handleWebSocketEvent({\n      getUnhandledRequestStrategy: () => {\n        return this.resolvedOptions.onUnhandledRequest\n      },\n      getHandlers: () => {\n        return this.handlersController.currentHandlers()\n      },\n      onMockedConnection: () => {},\n      onPassthroughConnection: () => {},\n    })\n  }\n\n  public listen(options: Partial<SharedOptions> = {}): void {\n    this.resolvedOptions = mergeRight(\n      DEFAULT_LISTEN_OPTIONS,\n      options,\n    ) as RequiredDeep<SharedOptions>\n\n    // Apply the interceptor when starting the server.\n    // Attach the event listeners to the interceptor here\n    // so they get re-attached whenever `.listen()` is called.\n    this.interceptor.apply()\n    this.init()\n    this.subscriptions.push(() => this.interceptor.dispose())\n\n    // Apply the WebSocket interception.\n    webSocketInterceptor.apply()\n    this.subscriptions.push(() => webSocketInterceptor.dispose())\n\n    // Assert that the interceptor has been applied successfully.\n    // Also guards us from forgetting to call \"interceptor.apply()\"\n    // as a part of the \"listen\" method.\n    invariant(\n      [InterceptorReadyState.APPLYING, InterceptorReadyState.APPLIED].includes(\n        this.interceptor.readyState,\n      ),\n      devUtils.formatMessage(\n        'Failed to start \"setupServer\": the interceptor failed to apply. This is likely an issue with the library and you should report it at \"%s\".',\n      ),\n      'https://github.com/mswjs/msw/issues/new/choose',\n    )\n  }\n\n  public close(): void {\n    this.dispose()\n  }\n}\n"],"mappings":"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","names":["request"]}
+{"version":3,"sources":["../../src/native/index.ts","../../src/node/setup-server-common.ts"],"sourcesContent":["import type { Interceptor } from '@mswjs/interceptors'\nimport { FetchInterceptor } from '@mswjs/interceptors/fetch'\nimport { XMLHttpRequestInterceptor } from '@mswjs/interceptors/XMLHttpRequest'\nimport { type AnyHandler } from '#core/experimental/handlers-controller'\nimport {\n  defineNetwork,\n  DefineNetworkOptions,\n} from '#core/experimental/define-network'\nimport { InterceptorSource } from '#core/experimental/sources/interceptor-source'\nimport { type SetupServerCommon } from '../node/glossary'\nimport { defineSetupServerApi } from '../node/setup-server-common'\n\nconst defaultInterceptors: Array<Interceptor<any>> = [\n  new FetchInterceptor(),\n  new XMLHttpRequestInterceptor(),\n]\n\nexport const defaultNetworkOptions: DefineNetworkOptions<[InterceptorSource]> =\n  {\n    sources: [\n      new InterceptorSource({\n        interceptors: defaultInterceptors,\n      }),\n    ],\n    onUnhandledFrame: 'warn',\n    context: {\n      quiet: true,\n    },\n  }\n\n/**\n * Sets up a requests interception in React Native with the given request handlers.\n * @param {Array<AnyHandler>} handlers List of request handlers.\n *\n * @see {@link https://mswjs.io/docs/api/setup-server `setupServer()` API reference}\n */\nexport function setupServer(...handlers: Array<AnyHandler>): SetupServerCommon {\n  const network = defineNetwork({\n    ...defaultNetworkOptions,\n    handlers,\n  })\n\n  return defineSetupServerApi(network)\n}\n","import type { PartialDeep } from 'type-fest'\nimport { Interceptor } from '@mswjs/interceptors'\nimport {\n  type NetworkApi,\n  NetworkReadyState,\n  defineNetwork,\n} from '#core/experimental/define-network'\nimport { type AnyHandler } from '#core/experimental/handlers-controller'\nimport { type HandlersController } from '#core/experimental/handlers-controller'\nimport { InterceptorSource } from '#core/experimental/sources/interceptor-source'\nimport { fromLegacyOnUnhandledRequest } from '#core/experimental/compat'\nimport type { ListenOptions, SetupServerCommon } from './glossary'\n\n/**\n * Define the common `setupServer` API around the given network.\n * This is used by both `msw/node` and `msw/native` to implement the same\n * baseline setup methods, like `.use()`, `.resetHandlers()`, `.close()`, etc.\n */\nexport function defineSetupServerApi(\n  network: NetworkApi<any>,\n): SetupServerCommon {\n  return {\n    events: network.events,\n    listen(options) {\n      network.configure({\n        onUnhandledFrame: fromLegacyOnUnhandledRequest(() => {\n          return options?.onUnhandledRequest || 'warn'\n        }),\n      })\n\n      network.enable()\n    },\n    use: network.use.bind(network),\n    resetHandlers: network.resetHandlers.bind(network),\n    restoreHandlers: network.restoreHandlers.bind(network),\n    listHandlers: network.listHandlers.bind(network),\n    close() {\n      /**\n       * @note Ignore closing after closed for backwards compatibility.\n       */\n      if (network.readyState === NetworkReadyState.DISABLED) {\n        return\n      }\n\n      network.disable()\n    },\n  }\n}\n\n/**\n * @deprecated\n * Please use the `defineNetwork` API instead.\n */\nexport class SetupServerCommonApi implements SetupServerCommon {\n  protected network: NetworkApi<[InterceptorSource]>\n\n  constructor(\n    interceptors: Array<Interceptor<any>>,\n    handlers: Array<AnyHandler> | HandlersController,\n  ) {\n    this.network = defineNetwork({\n      sources: [new InterceptorSource({ interceptors })],\n      handlers,\n    })\n  }\n\n  get events() {\n    return this.network.events\n  }\n\n  public listen(options?: PartialDeep<ListenOptions>): void {\n    this.network.configure({\n      onUnhandledFrame: fromLegacyOnUnhandledRequest(() => {\n        return options?.onUnhandledRequest || 'warn'\n      }),\n    })\n\n    this.network.enable()\n  }\n\n  public use(...handlers: Array<AnyHandler>): void {\n    this.network.use(...handlers)\n  }\n\n  public resetHandlers(...nextHandlers: Array<AnyHandler>): void {\n    return this.network.resetHandlers(...nextHandlers)\n  }\n\n  public restoreHandlers(): void {\n    return this.network.restoreHandlers()\n  }\n\n  public listHandlers(): ReadonlyArray<AnyHandler> {\n    return this.network.listHandlers()\n  }\n\n  public close(): void {\n    this.network.disable()\n  }\n}\n"],"mappings":";AACA,SAAS,wBAAwB;AACjC,SAAS,iCAAiC;AAE1C;AAAA,EACE,iBAAAA;AAAA,OAEK;AACP,SAAS,qBAAAC,0BAAyB;;;ACNlC;AAAA,EAEE;AAAA,EACA;AAAA,OACK;AAGP,SAAS,yBAAyB;AAClC,SAAS,oCAAoC;AAQtC,SAAS,qBACd,SACmB;AACnB,SAAO;AAAA,IACL,QAAQ,QAAQ;AAAA,IAChB,OAAO,SAAS;AACd,cAAQ,UAAU;AAAA,QAChB,kBAAkB,6BAA6B,MAAM;AACnD,iBAAO,SAAS,sBAAsB;AAAA,QACxC,CAAC;AAAA,MACH,CAAC;AAED,cAAQ,OAAO;AAAA,IACjB;AAAA,IACA,KAAK,QAAQ,IAAI,KAAK,OAAO;AAAA,IAC7B,eAAe,QAAQ,cAAc,KAAK,OAAO;AAAA,IACjD,iBAAiB,QAAQ,gBAAgB,KAAK,OAAO;AAAA,IACrD,cAAc,QAAQ,aAAa,KAAK,OAAO;AAAA,IAC/C,QAAQ;AAIN,UAAI,QAAQ,eAAe,kBAAkB,UAAU;AACrD;AAAA,MACF;AAEA,cAAQ,QAAQ;AAAA,IAClB;AAAA,EACF;AACF;;;ADnCA,IAAM,sBAA+C;AAAA,EACnD,IAAI,iBAAiB;AAAA,EACrB,IAAI,0BAA0B;AAChC;AAEO,IAAM,wBACX;AAAA,EACE,SAAS;AAAA,IACP,IAAIC,mBAAkB;AAAA,MACpB,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAAA,EACA,kBAAkB;AAAA,EAClB,SAAS;AAAA,IACP,OAAO;AAAA,EACT;AACF;AAQK,SAAS,eAAe,UAAgD;AAC7E,QAAM,UAAUC,eAAc;AAAA,IAC5B,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO,qBAAqB,OAAO;AACrC;","names":["defineNetwork","InterceptorSource","InterceptorSource","defineNetwork"]}

package/lib/node/index.d.mts

@@ -1,54 +1,59 @@
 import { PartialDeep } from 'type-fest';
-import { RequestHandler } from "../core/handlers/RequestHandler.mjs";
-import { WebSocketHandler } from "../core/handlers/WebSocketHandler.mjs";
-import { SharedOptions, LifeCycleEventEmitter, LifeCycleEventsMap } from "../core/sharedOptions.mjs";
-import { BatchInterceptor, Interceptor, HttpRequestEventMap } from '@mswjs/interceptors';
-import { SetupApi } from "../core/SetupApi.mjs";
+import { HttpNetworkFrameEventMap } from "../core/experimental/frames/http-frame.mjs";
+import { WebSocketNetworkFrameEventMap } from "../core/experimental/frames/websocket-frame.mjs";
+import { AnyHandler, HandlersController, HandlersControllerState } from "../core/experimental/handlers-controller.mjs";
+import { SharedOptions, LifeCycleEventEmitter } from "../core/sharedOptions.mjs";
+import { Interceptor } from '@mswjs/interceptors';
+import { NetworkApi, DefineNetworkOptions } from "../core/experimental/define-network.mjs";
+import { InterceptorSource } from "../core/experimental/sources/interceptor-source.mjs";
+import * as rettime from 'rettime';
 
+interface ListenOptions extends SharedOptions {
+}
 interface SetupServerCommon {
     /**
-     * Starts requests interception based on the previously provided request handlers.
+     * Starts the request interception based on the previously provided request handlers.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/listen `server.listen()` API reference}
      */
-    listen(options?: PartialDeep<SharedOptions>): void;
+    listen: (options?: PartialDeep<ListenOptions>) => void;
     /**
-     * Stops requests interception by restoring all augmented modules.
+     * Stops the request interception by restoring all augmented modules.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/close `server.close()` API reference}
      */
-    close(): void;
+    close: () => void;
     /**
      * Prepends given request handlers to the list of existing handlers.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/use `server.use()` API reference}
      */
-    use(...handlers: Array<RequestHandler | WebSocketHandler>): void;
+    use: (...handlers: Array<AnyHandler>) => void;
     /**
      * Marks all request handlers that respond using `res.once()` as unused.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/restore-handlers `server.restore-handlers()` API reference}
      */
-    restoreHandlers(): void;
+    restoreHandlers: () => void;
     /**
      * Resets request handlers to the initial list given to the `setupServer` call, or to the explicit next request handlers list, if given.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/reset-handlers `server.reset-handlers()` API reference}
      */
-    resetHandlers(...nextHandlers: Array<RequestHandler | WebSocketHandler>): void;
+    resetHandlers: (...nextHandlers: Array<AnyHandler>) => void;
     /**
      * Returns a readonly list of currently active request handlers.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/list-handlers `server.listHandlers()` API reference}
      */
-    listHandlers(): ReadonlyArray<RequestHandler | WebSocketHandler>;
+    listHandlers: () => ReadonlyArray<AnyHandler>;
     /**
      * Life-cycle events.
      * Life-cycle events allow you to subscribe to the internal library events occurring during the request/response handling.
      *
      * @see {@link https://mswjs.io/docs/api/life-cycle-events Life-cycle Events API reference}
      */
-    events: LifeCycleEventEmitter<LifeCycleEventsMap>;
+    events: LifeCycleEventEmitter<HttpNetworkFrameEventMap | WebSocketNetworkFrameEventMap>;
 }
 interface SetupServer extends SetupServerCommon {
     /**
@@ -59,33 +64,50 @@ interface SetupServer extends SetupServerCommon {
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/boundary `server.boundary()` API reference}
      */
-    boundary<Args extends Array<any>, R>(callback: (...args: Args) => R): (...args: Args) => R;
+    boundary: <Args extends Array<any>, R>(callback: (...args: Args) => R) => (...args: Args) => R;
 }
 
-declare class SetupServerCommonApi extends SetupApi<LifeCycleEventsMap> implements SetupServerCommon {
-    protected readonly interceptor: BatchInterceptor<Array<Interceptor<HttpRequestEventMap>>, HttpRequestEventMap>;
-    private resolvedOptions;
-    constructor(interceptors: Array<Interceptor<HttpRequestEventMap>>, handlers: Array<RequestHandler | WebSocketHandler>);
-    /**
-     * Subscribe to all requests that are using the interceptor object
-     */
-    private init;
-    listen(options?: Partial<SharedOptions>): void;
-    close(): void;
+declare class AsyncHandlersController extends HandlersController {
+    #private;
+    constructor(initialHandlers: Array<AnyHandler>);
+    protected getState(): {
+        initialHandlers: Partial<Record<"request" | "websocket", AnyHandler[]>>;
+        handlers: Partial<Record<"request" | "websocket", AnyHandler[]>>;
+    };
+    protected setState(nextState: HandlersControllerState): void;
+    boundary<Args extends Array<any>, R>(callback: (...args: Args) => R): (...args: Args) => R;
 }
 
-declare class SetupServerApi extends SetupServerCommonApi implements SetupServer {
-    constructor(handlers: Array<RequestHandler | WebSocketHandler>, interceptors?: Array<Interceptor<HttpRequestEventMap>>);
-    boundary<Args extends Array<any>, R>(callback: (...args: Args) => R): (...args: Args) => R;
+/**
+ * @deprecated
+ * Please use the `defineNetwork` API instead.
+ */
+declare class SetupServerCommonApi implements SetupServerCommon {
+    protected network: NetworkApi<[InterceptorSource]>;
+    constructor(interceptors: Array<Interceptor<any>>, handlers: Array<AnyHandler> | HandlersController);
+    get events(): rettime.Emitter<any>;
+    listen(options?: PartialDeep<ListenOptions>): void;
+    use(...handlers: Array<AnyHandler>): void;
+    resetHandlers(...nextHandlers: Array<AnyHandler>): void;
+    restoreHandlers(): void;
+    listHandlers(): ReadonlyArray<AnyHandler>;
     close(): void;
 }
 
+declare const defaultNetworkOptions: DefineNetworkOptions<[InterceptorSource]>;
 /**
- * Sets up a requests interception in Node.js with the given request handlers.
- * @param {RequestHandler[]} handlers List of request handlers.
- *
+ * Enables request interception in Node.js with the given request handlers.
  * @see {@link https://mswjs.io/docs/api/setup-server `setupServer()` API reference}
  */
-declare const setupServer: (...handlers: Array<RequestHandler | WebSocketHandler>) => SetupServerApi;
+declare function setupServer(...handlers: Array<AnyHandler>): SetupServer;
+/**
+ * @deprecated
+ * Please use the `defineNetwork` API instead.
+ */
+declare class SetupServerApi extends SetupServerCommonApi implements SetupServer {
+    #private;
+    boundary: AsyncHandlersController['boundary'];
+    constructor(handlers: Array<AnyHandler>, interceptors: Array<Interceptor<any>>);
+}
 
-export { type SetupServer, SetupServerApi, setupServer };
+export { type SetupServer, SetupServerApi, SetupServerCommonApi, defaultNetworkOptions, setupServer };

package/lib/node/index.d.ts

@@ -1,54 +1,59 @@
 import { PartialDeep } from 'type-fest';
-import { RequestHandler } from "../core/handlers/RequestHandler";
-import { WebSocketHandler } from "../core/handlers/WebSocketHandler";
-import { SharedOptions, LifeCycleEventEmitter, LifeCycleEventsMap } from "../core/sharedOptions";
-import { BatchInterceptor, Interceptor, HttpRequestEventMap } from '@mswjs/interceptors';
-import { SetupApi } from "../core/SetupApi";
+import { HttpNetworkFrameEventMap } from "../core/experimental/frames/http-frame";
+import { WebSocketNetworkFrameEventMap } from "../core/experimental/frames/websocket-frame";
+import { AnyHandler, HandlersController, HandlersControllerState } from "../core/experimental/handlers-controller";
+import { SharedOptions, LifeCycleEventEmitter } from "../core/sharedOptions";
+import { Interceptor } from '@mswjs/interceptors';
+import { NetworkApi, DefineNetworkOptions } from "../core/experimental/define-network";
+import { InterceptorSource } from "../core/experimental/sources/interceptor-source";
+import * as rettime from 'rettime';
 
+interface ListenOptions extends SharedOptions {
+}
 interface SetupServerCommon {
     /**
-     * Starts requests interception based on the previously provided request handlers.
+     * Starts the request interception based on the previously provided request handlers.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/listen `server.listen()` API reference}
      */
-    listen(options?: PartialDeep<SharedOptions>): void;
+    listen: (options?: PartialDeep<ListenOptions>) => void;
     /**
-     * Stops requests interception by restoring all augmented modules.
+     * Stops the request interception by restoring all augmented modules.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/close `server.close()` API reference}
      */
-    close(): void;
+    close: () => void;
     /**
      * Prepends given request handlers to the list of existing handlers.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/use `server.use()` API reference}
      */
-    use(...handlers: Array<RequestHandler | WebSocketHandler>): void;
+    use: (...handlers: Array<AnyHandler>) => void;
     /**
      * Marks all request handlers that respond using `res.once()` as unused.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/restore-handlers `server.restore-handlers()` API reference}
      */
-    restoreHandlers(): void;
+    restoreHandlers: () => void;
     /**
      * Resets request handlers to the initial list given to the `setupServer` call, or to the explicit next request handlers list, if given.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/reset-handlers `server.reset-handlers()` API reference}
      */
-    resetHandlers(...nextHandlers: Array<RequestHandler | WebSocketHandler>): void;
+    resetHandlers: (...nextHandlers: Array<AnyHandler>) => void;
     /**
      * Returns a readonly list of currently active request handlers.
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/list-handlers `server.listHandlers()` API reference}
      */
-    listHandlers(): ReadonlyArray<RequestHandler | WebSocketHandler>;
+    listHandlers: () => ReadonlyArray<AnyHandler>;
     /**
      * Life-cycle events.
      * Life-cycle events allow you to subscribe to the internal library events occurring during the request/response handling.
      *
      * @see {@link https://mswjs.io/docs/api/life-cycle-events Life-cycle Events API reference}
      */
-    events: LifeCycleEventEmitter<LifeCycleEventsMap>;
+    events: LifeCycleEventEmitter<HttpNetworkFrameEventMap | WebSocketNetworkFrameEventMap>;
 }
 interface SetupServer extends SetupServerCommon {
     /**
@@ -59,33 +64,50 @@ interface SetupServer extends SetupServerCommon {
      *
      * @see {@link https://mswjs.io/docs/api/setup-server/boundary `server.boundary()` API reference}
      */
-    boundary<Args extends Array<any>, R>(callback: (...args: Args) => R): (...args: Args) => R;
+    boundary: <Args extends Array<any>, R>(callback: (...args: Args) => R) => (...args: Args) => R;
 }
 
-declare class SetupServerCommonApi extends SetupApi<LifeCycleEventsMap> implements SetupServerCommon {
-    protected readonly interceptor: BatchInterceptor<Array<Interceptor<HttpRequestEventMap>>, HttpRequestEventMap>;
-    private resolvedOptions;
-    constructor(interceptors: Array<Interceptor<HttpRequestEventMap>>, handlers: Array<RequestHandler | WebSocketHandler>);
-    /**
-     * Subscribe to all requests that are using the interceptor object
-     */
-    private init;
-    listen(options?: Partial<SharedOptions>): void;
-    close(): void;
+declare class AsyncHandlersController extends HandlersController {
+    #private;
+    constructor(initialHandlers: Array<AnyHandler>);
+    protected getState(): {
+        initialHandlers: Partial<Record<"request" | "websocket", AnyHandler[]>>;
+        handlers: Partial<Record<"request" | "websocket", AnyHandler[]>>;
+    };
+    protected setState(nextState: HandlersControllerState): void;
+    boundary<Args extends Array<any>, R>(callback: (...args: Args) => R): (...args: Args) => R;
 }
 
-declare class SetupServerApi extends SetupServerCommonApi implements SetupServer {
-    constructor(handlers: Array<RequestHandler | WebSocketHandler>, interceptors?: Array<Interceptor<HttpRequestEventMap>>);
-    boundary<Args extends Array<any>, R>(callback: (...args: Args) => R): (...args: Args) => R;
+/**
+ * @deprecated
+ * Please use the `defineNetwork` API instead.
+ */
+declare class SetupServerCommonApi implements SetupServerCommon {
+    protected network: NetworkApi<[InterceptorSource]>;
+    constructor(interceptors: Array<Interceptor<any>>, handlers: Array<AnyHandler> | HandlersController);
+    get events(): rettime.Emitter<any>;
+    listen(options?: PartialDeep<ListenOptions>): void;
+    use(...handlers: Array<AnyHandler>): void;
+    resetHandlers(...nextHandlers: Array<AnyHandler>): void;
+    restoreHandlers(): void;
+    listHandlers(): ReadonlyArray<AnyHandler>;
     close(): void;
 }
 
+declare const defaultNetworkOptions: DefineNetworkOptions<[InterceptorSource]>;
 /**
- * Sets up a requests interception in Node.js with the given request handlers.
- * @param {RequestHandler[]} handlers List of request handlers.
- *
+ * Enables request interception in Node.js with the given request handlers.
  * @see {@link https://mswjs.io/docs/api/setup-server `setupServer()` API reference}
  */
-declare const setupServer: (...handlers: Array<RequestHandler | WebSocketHandler>) => SetupServerApi;
+declare function setupServer(...handlers: Array<AnyHandler>): SetupServer;
+/**
+ * @deprecated
+ * Please use the `defineNetwork` API instead.
+ */
+declare class SetupServerApi extends SetupServerCommonApi implements SetupServer {
+    #private;
+    boundary: AsyncHandlersController['boundary'];
+    constructor(handlers: Array<AnyHandler>, interceptors: Array<Interceptor<any>>);
+}
 
-export { type SetupServer, SetupServerApi, setupServer };
+export { type SetupServer, SetupServerApi, SetupServerCommonApi, defaultNetworkOptions, setupServer };