@zimic/interceptor 0.16.0-canary.11 → 0.16.0-canary.3

package/dist/server.d.ts

@@ -1,17 +1,3 @@
-/**
- * An error thrown when the interceptor server is running and some operation requires it to be stopped first.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐server `@zimic/interceptor/server` - API reference}
- */
-declare class RunningInterceptorServerError extends Error {
-    constructor(additionalMessage: string);
-}
-
-/** An error thrown when the interceptor server is not running. */
-declare class NotRunningInterceptorServerError extends Error {
-    constructor();
-}
-
 /**
  * The options to create an
  * {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}.
@@ -87,6 +73,48 @@ interface InterceptorServer {
     stop: () => Promise<void>;
 }
 
+/**
+ * Creates an {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}.
+ *
+ * @param options The options to create the server.
+ * @returns The created server.
+ * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server-programmatic-usage `zimic-interceptor server` programmatic usage}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/getting‐started#remote-http-interceptors Remote HTTP Interceptors} .
+ */
+declare function createInterceptorServer(options?: InterceptorServerOptions): InterceptorServer;
+
+/**
+ * A namespace of interceptor server resources for handling HTTP requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server-programmatic-usage `zimic-interceptor server` programmatic usage}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/getting‐started#remote-http-interceptors Remote HTTP Interceptors} .
+ */
+declare class InterceptorServerNamespace {
+    /**
+     * Creates an {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}.
+     *
+     * @param options The options to create the server.
+     * @returns The created server.
+     * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server-programmatic-usage `zimic-interceptor server` programmatic usage}
+     * @see {@link https://github.com/zimicjs/zimic/wiki/getting‐started#remote-http-interceptors Remote HTTP Interceptors} .
+     */
+    create: typeof createInterceptorServer;
+}
+
+/**
+ * An error thrown when the interceptor server is running and some operation requires it to be stopped first.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐server `@zimic/interceptor/server` - API reference}
+ */
+declare class RunningInterceptorServerError extends Error {
+    constructor(additionalMessage: string);
+}
+
+/** An error thrown when the interceptor server is not running. */
+declare class NotRunningInterceptorServerError extends Error {
+    constructor();
+}
+
 /** The default access control headers for the server. */
 declare const DEFAULT_ACCESS_CONTROL_HEADERS: Readonly<{
     'access-control-allow-origin': "*";
@@ -99,13 +127,11 @@ declare const DEFAULT_ACCESS_CONTROL_HEADERS: Readonly<{
 declare const DEFAULT_PREFLIGHT_STATUS_CODE = 204;
 
 /**
- * Creates an {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}.
+ * A namespace of interceptor server resources for handling HTTP requests.
  *
- * @param options The options to create the server.
- * @returns The created server.
- * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server-programmatic-usage `zimic-interceptor server` programmatic usage}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
  * @see {@link https://github.com/zimicjs/zimic/wiki/getting‐started#remote-http-interceptors Remote HTTP Interceptors} .
  */
-declare function createInterceptorServer(options?: InterceptorServerOptions): InterceptorServer;
+declare const interceptorServer: Readonly<InterceptorServerNamespace>;
 
-export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, type InterceptorServer, type InterceptorServerOptions, NotRunningInterceptorServerError, RunningInterceptorServerError, createInterceptorServer };
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, type InterceptorServer, InterceptorServerNamespace, type InterceptorServerOptions, NotRunningInterceptorServerError, RunningInterceptorServerError, interceptorServer };

package/dist/server.js

@@ -1,29 +1,29 @@
 'use strict';
 
-var chunkO6ZIPCUJ_js = require('./chunk-O6ZIPCUJ.js');
+var chunkD7CDDSQE_js = require('./chunk-D7CDDSQE.js');
 require('./chunk-WCQVDF3K.js');
 
 
 
 Object.defineProperty(exports, "DEFAULT_ACCESS_CONTROL_HEADERS", {
   enumerable: true,
-  get: function () { return chunkO6ZIPCUJ_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
+  get: function () { return chunkD7CDDSQE_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
 });
 Object.defineProperty(exports, "DEFAULT_PREFLIGHT_STATUS_CODE", {
   enumerable: true,
-  get: function () { return chunkO6ZIPCUJ_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
+  get: function () { return chunkD7CDDSQE_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
 });
 Object.defineProperty(exports, "NotRunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkO6ZIPCUJ_js.NotRunningInterceptorServerError_default; }
+  get: function () { return chunkD7CDDSQE_js.NotRunningInterceptorServerError_default; }
 });
 Object.defineProperty(exports, "RunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkO6ZIPCUJ_js.RunningInterceptorServerError_default; }
+  get: function () { return chunkD7CDDSQE_js.RunningInterceptorServerError_default; }
 });
-Object.defineProperty(exports, "createInterceptorServer", {
+Object.defineProperty(exports, "interceptorServer", {
   enumerable: true,
-  get: function () { return chunkO6ZIPCUJ_js.createInterceptorServer; }
+  get: function () { return chunkD7CDDSQE_js.interceptorServer; }
 });
 //# sourceMappingURL=server.js.map
 //# sourceMappingURL=server.js.map

package/dist/server.mjs

@@ -1,4 +1,4 @@
-export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, NotRunningInterceptorServerError_default as NotRunningInterceptorServerError, RunningInterceptorServerError_default as RunningInterceptorServerError, createInterceptorServer } from './chunk-NTRC2S4I.mjs';
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, NotRunningInterceptorServerError_default as NotRunningInterceptorServerError, RunningInterceptorServerError_default as RunningInterceptorServerError, interceptorServer } from './chunk-2RNFR6TF.mjs';
 import './chunk-CGILA3WO.mjs';
 //# sourceMappingURL=server.mjs.map
 //# sourceMappingURL=server.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zimic/interceptor",
-  "description": "Next-gen, TypeScript-first HTTP intercepting and mocking",
+  "description": "TypeScript-first HTTP intercepting and mocking",
   "keywords": [
     "zimic",
     "typescript",
@@ -14,7 +14,7 @@
     "api",
     "static"
   ],
-  "version": "0.16.0-canary.11",
+  "version": "0.16.0-canary.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/zimicjs/zimic.git",
@@ -75,10 +75,10 @@
   },
   "dependencies": {
     "@whatwg-node/server": "0.10.1",
+    "chalk": "4.1.2",
     "execa": "9.5.2",
     "isomorphic-ws": "5.0.0",
     "msw": "2.7.3",
-    "picocolors": "^1.1.1",
     "ws": "8.18.1",
     "yargs": "17.7.2"
   },
@@ -89,21 +89,21 @@
     "@types/node": "^22.13.10",
     "@types/ws": "^8.18.0",
     "@types/yargs": "^17.0.33",
-    "@vitest/browser": "^3.0.9",
-    "@vitest/coverage-istanbul": "^3.0.9",
+    "@vitest/browser": "^3.0.8",
+    "@vitest/coverage-istanbul": "^3.0.8",
     "dotenv-cli": "^8.0.0",
     "eslint": "^9.22.0",
-    "playwright": "^1.51.1",
+    "playwright": "^1.51.0",
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
-    "vitest": "^3.0.9",
-    "@zimic/eslint-config-node": "0.0.0",
-    "@zimic/tsconfig": "0.0.0",
+    "vitest": "^3.0.8",
     "@zimic/lint-staged-config": "0.0.0",
-    "@zimic/utils": "0.0.0"
+    "@zimic/tsconfig": "0.0.0",
+    "@zimic/utils": "0.0.0",
+    "@zimic/eslint-config-node": "0.0.0"
   },
   "peerDependencies": {
-    "@zimic/http": "^0.2.0 || ^0.2.0-canary.0",
+    "@zimic/http": "^0.1.0 || ^0.1.0-canary.0",
     "typescript": ">=4.8.0"
   },
   "peerDependenciesMeta": {

package/src/cli/browser/init.ts

@@ -1,6 +1,6 @@
+import chalk from 'chalk';
 import filesystem from 'fs/promises';
 import path from 'path';
-import color from 'picocolors';
 
 import { logWithPrefix } from '@/utils/console';
 
@@ -20,7 +20,7 @@ async function initializeBrowserServiceWorker({ publicDirectory }: BrowserServic
   const destinationPath = path.join(absolutePublicDirectory, SERVICE_WORKER_FILE_NAME);
   await filesystem.copyFile(MOCK_SERVICE_WORKER_PATH, destinationPath);
 
-  logWithPrefix(`Service worker script saved to ${color.green(destinationPath)}!`);
+  logWithPrefix(`Service worker script saved to ${chalk.green(destinationPath)}!`);
   logWithPrefix('You can now use browser interceptors!');
 }
 

package/src/cli/server/start.ts

@@ -1,4 +1,4 @@
-import { InterceptorServer, createInterceptorServer } from '@/server';
+import { InterceptorServer, interceptorServer } from '@/server';
 import { InterceptorServerOptions } from '@/server/types/options';
 import { logWithPrefix } from '@/utils/console';
 import {
@@ -26,7 +26,7 @@ async function startInterceptorServer({
   logUnhandledRequests,
   onReady,
 }: InterceptorServerStartOptions) {
-  const server = createInterceptorServer({
+  const server = interceptorServer.create({
     hostname,
     port,
     logUnhandledRequests,

package/src/http/index.ts

@@ -1,13 +1,10 @@
+export { default as InvalidJSONError } from './interceptorWorker/errors/InvalidJSONError';
+export { default as InvalidFormDataError } from './interceptorWorker/errors/InvalidFormDataError';
 export { default as RunningHttpInterceptorError } from './interceptor/errors/RunningHttpInterceptorError';
 export { default as NotRunningHttpInterceptorError } from './interceptor/errors/NotRunningHttpInterceptorError';
 export { default as UnknownHttpInterceptorPlatformError } from './interceptor/errors/UnknownHttpInterceptorPlatformError';
 export { default as UnknownHttpInterceptorTypeError } from './interceptor/errors/UnknownHttpInterceptorTypeError';
-export { default as RequestSavingSafeLimitExceededError } from './interceptor/errors/RequestSavingSafeLimitExceededError';
-
-export { default as InvalidFormDataError } from './interceptorWorker/errors/InvalidFormDataError';
-export { default as InvalidJSONError } from './interceptorWorker/errors/InvalidJSONError';
 export { default as UnregisteredBrowserServiceWorkerError } from './interceptorWorker/errors/UnregisteredBrowserServiceWorkerError';
-
 export { default as DisabledRequestSavingError } from './requestHandler/errors/DisabledRequestSavingError';
 export { default as TimesCheckError } from './requestHandler/errors/TimesCheckError';
 

package/src/http/interceptor/HttpInterceptorClient.ts

@@ -23,17 +23,13 @@ import RemoteHttpRequestHandler from '../requestHandler/RemoteHttpRequestHandler
 import { HttpRequestHandler, InternalHttpRequestHandler } from '../requestHandler/types/public';
 import { HttpInterceptorRequest } from '../requestHandler/types/requests';
 import NotRunningHttpInterceptorError from './errors/NotRunningHttpInterceptorError';
-import RequestSavingSafeLimitExceededError from './errors/RequestSavingSafeLimitExceededError';
 import RunningHttpInterceptorError from './errors/RunningHttpInterceptorError';
 import HttpInterceptorStore from './HttpInterceptorStore';
 import { UnhandledRequestStrategy } from './types/options';
-import { HttpInterceptorRequestSaving } from './types/public';
 import { HttpInterceptorRequestContext } from './types/requests';
 
 export const SUPPORTED_BASE_URL_PROTOCOLS = Object.freeze(['http', 'https']);
 
-export const DEFAULT_REQUEST_SAVING_SAFE_LIMIT = 1000;
-
 class HttpInterceptorClient<
   Schema extends HttpSchema,
   HandlerConstructor extends HttpRequestHandlerConstructor = HttpRequestHandlerConstructor,
@@ -42,9 +38,7 @@ class HttpInterceptorClient<
   private store: HttpInterceptorStore;
 
   private _baseURL!: URL;
-
-  requestSaving: HttpInterceptorRequestSaving;
-  private numberOfSavedRequests = 0;
+  private _saveRequests?: boolean;
 
   onUnhandledRequest?: HandlerConstructor extends typeof LocalHttpRequestHandler
     ? UnhandledRequestStrategy.Local
@@ -70,7 +64,7 @@ class HttpInterceptorClient<
     worker: HttpInterceptorWorker;
     store: HttpInterceptorStore;
     baseURL: URL;
-    requestSaving?: Partial<HttpInterceptorRequestSaving>;
+    saveRequests?: boolean;
     onUnhandledRequest?: UnhandledRequestStrategy;
     Handler: HandlerConstructor;
   }) {
@@ -78,12 +72,7 @@ class HttpInterceptorClient<
     this.store = options.store;
 
     this.baseURL = options.baseURL;
-
-    this.requestSaving = {
-      enabled: options.requestSaving?.enabled ?? this.getDefaultRequestSavingEnabled(),
-      safeLimit: options.requestSaving?.safeLimit ?? DEFAULT_REQUEST_SAVING_SAFE_LIMIT,
-    };
-
+    this._saveRequests = options.saveRequests;
     this.onUnhandledRequest = options.onUnhandledRequest satisfies
       | UnhandledRequestStrategy
       | undefined as this['onUnhandledRequest'];
@@ -91,10 +80,6 @@ class HttpInterceptorClient<
     this.Handler = options.Handler;
   }
 
-  private getDefaultRequestSavingEnabled(): boolean {
-    return isServerSide() ? process.env.NODE_ENV === 'test' : false;
-  }
-
   get baseURL() {
     return this._baseURL;
   }
@@ -118,6 +103,17 @@ class HttpInterceptorClient<
     return this.baseURL.href;
   }
 
+  get saveRequests() {
+    if (this._saveRequests === undefined) {
+      return isServerSide() ? process.env.NODE_ENV === 'test' : false;
+    }
+    return this._saveRequests;
+  }
+
+  set saveRequests(saveRequests: boolean) {
+    this._saveRequests = saveRequests;
+  }
+
   get platform() {
     return this.worker.platform;
   }
@@ -255,7 +251,7 @@ class HttpInterceptorClient<
     const responseDeclaration = await matchedHandler.applyResponseDeclaration(parsedRequest);
     const response = HttpInterceptorWorker.createResponseFromDeclaration(request, responseDeclaration);
 
-    if (this.requestSaving.enabled) {
+    if (this.saveRequests) {
       const responseClone = response.clone();
 
       const parsedResponse = await HttpInterceptorWorker.parseRawResponse<
@@ -269,17 +265,6 @@ class HttpInterceptorClient<
     return response;
   }
 
-  incrementNumberOfSavedRequests(increment: number) {
-    this.numberOfSavedRequests = Math.max(this.numberOfSavedRequests + increment, 0);
-
-    const exceedsSafeLimit = this.numberOfSavedRequests > this.requestSaving.safeLimit;
-
-    if (increment > 0 && exceedsSafeLimit) {
-      const error = new RequestSavingSafeLimitExceededError(this.numberOfSavedRequests, this.requestSaving.safeLimit);
-      console.warn(error);
-    }
-  }
-
   private async findMatchedHandler<
     Method extends HttpSchemaMethod<Schema>,
     Path extends HttpSchemaPath<Schema, Method>,

package/src/http/interceptor/LocalHttpInterceptor.ts

@@ -4,8 +4,8 @@ import LocalHttpRequestHandler from '../requestHandler/LocalHttpRequestHandler';
 import HttpInterceptorClient from './HttpInterceptorClient';
 import HttpInterceptorStore from './HttpInterceptorStore';
 import { SyncHttpInterceptorMethodHandler } from './types/handlers';
-import { LocalHttpInterceptorOptions, UnhandledRequestStrategy } from './types/options';
-import { HttpInterceptorRequestSaving, LocalHttpInterceptor as PublicLocalHttpInterceptor } from './types/public';
+import { LocalHttpInterceptorOptions } from './types/options';
+import { LocalHttpInterceptor as PublicLocalHttpInterceptor } from './types/public';
 
 class LocalHttpInterceptor<Schema extends HttpSchema> implements PublicLocalHttpInterceptor<Schema> {
   private store = new HttpInterceptorStore();
@@ -23,7 +23,7 @@ class LocalHttpInterceptor<Schema extends HttpSchema> implements PublicLocalHttp
       baseURL,
       Handler: LocalHttpRequestHandler,
       onUnhandledRequest: options.onUnhandledRequest,
-      requestSaving: options.requestSaving,
+      saveRequests: options.saveRequests,
     });
   }
 
@@ -39,19 +39,19 @@ class LocalHttpInterceptor<Schema extends HttpSchema> implements PublicLocalHttp
     this.client.baseURL = new URL(baseURL);
   }
 
-  get requestSaving() {
-    return this.client.requestSaving;
+  get saveRequests() {
+    return this.client.saveRequests;
   }
 
-  set requestSaving(requestSaving: HttpInterceptorRequestSaving) {
-    this.client.requestSaving = requestSaving;
+  set saveRequests(saveRequests: NonNullable<LocalHttpInterceptorOptions['saveRequests']>) {
+    this.client.saveRequests = saveRequests;
   }
 
   get onUnhandledRequest() {
     return this.client.onUnhandledRequest;
   }
 
-  set onUnhandledRequest(onUnhandledRequest: UnhandledRequestStrategy.Local | undefined) {
+  set onUnhandledRequest(onUnhandledRequest: LocalHttpInterceptorOptions['onUnhandledRequest']) {
     this.client.onUnhandledRequest = onUnhandledRequest;
   }
 

package/src/http/interceptor/RemoteHttpInterceptor.ts

@@ -4,8 +4,8 @@ import RemoteHttpRequestHandler from '../requestHandler/RemoteHttpRequestHandler
 import HttpInterceptorClient from './HttpInterceptorClient';
 import HttpInterceptorStore from './HttpInterceptorStore';
 import { AsyncHttpInterceptorMethodHandler } from './types/handlers';
-import { RemoteHttpInterceptorOptions, UnhandledRequestStrategy } from './types/options';
-import { HttpInterceptorRequestSaving, RemoteHttpInterceptor as PublicRemoteHttpInterceptor } from './types/public';
+import { RemoteHttpInterceptorOptions } from './types/options';
+import { RemoteHttpInterceptor as PublicRemoteHttpInterceptor } from './types/public';
 
 class RemoteHttpInterceptor<Schema extends HttpSchema> implements PublicRemoteHttpInterceptor<Schema> {
   private store = new HttpInterceptorStore();
@@ -24,7 +24,7 @@ class RemoteHttpInterceptor<Schema extends HttpSchema> implements PublicRemoteHt
       baseURL,
       Handler: RemoteHttpRequestHandler,
       onUnhandledRequest: options.onUnhandledRequest,
-      requestSaving: options.requestSaving,
+      saveRequests: options.saveRequests,
     });
   }
 
@@ -40,19 +40,19 @@ class RemoteHttpInterceptor<Schema extends HttpSchema> implements PublicRemoteHt
     this.client.baseURL = new URL(baseURL);
   }
 
-  get requestSaving() {
-    return this.client.requestSaving;
+  get saveRequests() {
+    return this.client.saveRequests;
   }
 
-  set requestSaving(requestSaving: HttpInterceptorRequestSaving) {
-    this.client.requestSaving = requestSaving;
+  set saveRequests(saveRequests: NonNullable<RemoteHttpInterceptorOptions['saveRequests']>) {
+    this.client.saveRequests = saveRequests;
   }
 
   get onUnhandledRequest() {
     return this.client.onUnhandledRequest;
   }
 
-  set onUnhandledRequest(onUnhandledRequest: UnhandledRequestStrategy.Remote | undefined) {
+  set onUnhandledRequest(onUnhandledRequest: RemoteHttpInterceptorOptions['onUnhandledRequest']) {
     this.client.onUnhandledRequest = onUnhandledRequest;
   }
 

package/src/http/interceptor/types/options.ts

@@ -1,6 +1,5 @@
 import { PossiblePromise } from '@zimic/utils/types';
 
-import { HttpInterceptorRequestSaving } from './public';
 import { UnhandledHttpInterceptorRequest } from './requests';
 
 /**
@@ -120,12 +119,20 @@ export interface SharedHttpInterceptorOptions {
   baseURL: string;
 
   /**
-   * Configures if the intercepted requests are saved and how they are handled.
+   * Whether {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler request handlers}
+   * should save their intercepted requests in memory and make them accessible through
+   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests`}.
    *
+   * **Important**: If `saveRequests` is true, make sure to regularly clear the interceptor to avoid that the requests
+   * accumulate in memory. A common practice is to call
+   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()`}
+   * after each test.
+   *
+   * @default false
    * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
    * @see {@link https://github.com/zimicjs/zimic/wiki/guides‐testing‐interceptor Testing}
    */
-  requestSaving?: Partial<HttpInterceptorRequestSaving>;
+  saveRequests?: boolean;
 }
 
 /**

package/src/http/interceptor/types/public.ts

@@ -3,45 +3,6 @@ import { HttpSchema } from '@zimic/http';
 import { SyncHttpInterceptorMethodHandler, AsyncHttpInterceptorMethodHandler } from './handlers';
 import { HttpInterceptorPlatform, UnhandledRequestStrategy } from './options';
 
-/**
- * Configures if the intercepted requests are saved and how they are handled.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
- * @see {@link https://github.com/zimicjs/zimic/wiki/guides‐testing‐interceptor Testing}
- */
-export interface HttpInterceptorRequestSaving {
-  /**
-   * Whether {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler request handlers}
-   * should save their intercepted requests in memory and make them accessible through
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests`}.
-   *
-   * If you are using
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorchecktimes `interceptor.checkTimes()`}
-   * or
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerchecktimes `handler.checkTimes()`}
-   * during tests, consider enabling this option to get more detailed information in `TimesCheckError` errors.
-   *
-   * **Important**: If `requestSaving.enabled` is `true`, make sure to regularly clear the interceptor to avoid requests
-   * accumulating in memory. A common practice is to call
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()`}
-   * after each test.
-   *
-   * @default process.env.NODE_ENV === 'test'
-   */
-  enabled: boolean;
-
-  /**
-   * The safe number of requests to save in memory before logging warnings in the console. If `requestSaving.enabled` is
-   * `true` and the interceptor is not regularly cleared with
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()`},
-   * the requests may accumulate in memory and cause performance issues. This option does not limit the number of
-   * requests saved in memory, only when to log warnings.
-   *
-   * @default 1000
-   */
-  safeLimit: number;
-}
-
 /**
  * An interceptor to handle HTTP requests and return mock responses. The methods, paths, status codes, parameters, and
  * responses are statically-typed based on the provided service schema.
@@ -59,12 +20,20 @@ export interface HttpInterceptor<_Schema extends HttpSchema> {
   baseURL: string;
 
   /**
-   * Configures if the intercepted requests are saved and how they are handled.
+   * Whether {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler request handlers}
+   * should save their intercepted requests in memory and make them accessible through
+   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests`}.
+   *
+   * **Important**: If `saveRequests` is true, make sure to regularly clear the interceptor to avoid that the requests
+   * accumulate in memory. A common practice is to call
+   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()`}
+   * after each test.
    *
+   * @default process.env.NODE_ENV === 'test'
    * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
    * @see {@link https://github.com/zimicjs/zimic/wiki/guides‐testing‐interceptor Testing}
    */
-  requestSaving: HttpInterceptorRequestSaving;
+  saveRequests: boolean;
 
   /**
    * The platform the interceptor is running on.
@@ -117,9 +86,8 @@ export interface HttpInterceptor<_Schema extends HttpSchema> {
    * of each test.
    *
    * When
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests
-   * `requestSaving.enabled`} is
-   * `true` in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
+   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#createhttpinterceptoroptions `saveRequests: true`}
+   * is enabled in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
    * expected and received data. This is useful for debugging requests that did not match a handler with
    * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction restrictions}.
    *

package/src/http/interceptorWorker/HttpInterceptorWorker.ts

@@ -13,7 +13,7 @@ import {
 } from '@zimic/http';
 import isDefined from '@zimic/utils/data/isDefined';
 import { Default, PossiblePromise } from '@zimic/utils/types';
-import color from 'picocolors';
+import chalk from 'chalk';
 
 import { removeArrayElement } from '@/utils/arrays';
 import { formatValueToLog, logWithPrefix } from '@/utils/console';
@@ -477,7 +477,7 @@ abstract class HttpInterceptorWorker {
     logWithPrefix(
       [
         `${action === 'bypass' ? 'Warning:' : 'Error:'} Request was not handled and was ` +
-          `${action === 'bypass' ? color.yellow('bypassed') : color.red('rejected')}.\n\n `,
+          `${action === 'bypass' ? chalk.yellow('bypassed') : chalk.red('rejected')}.\n\n `,
         `${request.method} ${request.url}`,
         '\n    Headers:',
         formattedHeaders,

package/src/http/requestHandler/HttpRequestHandlerClient.ts

@@ -91,8 +91,7 @@ class HttpRequestHandlerClient<
 
     newThis.numberOfMatchedRequests = 0;
     newThis.unmatchedRequestGroups.length = 0;
-
-    newThis.clearInterceptedRequests();
+    newThis._requests.length = 0;
 
     this.interceptor.registerRequestHandler(this.handler);
 
@@ -133,7 +132,7 @@ class HttpRequestHandlerClient<
         declarationPointer: this.timesDeclarationPointer,
         unmatchedRequestGroups: this.unmatchedRequestGroups,
         hasRestrictions: this.restrictions.length > 0,
-        requestSaving: this.interceptor.requestSaving,
+        hasSavedRequests: this.interceptor.saveRequests,
       });
     }
   }
@@ -149,8 +148,7 @@ class HttpRequestHandlerClient<
 
     this.numberOfMatchedRequests = 0;
     this.unmatchedRequestGroups.length = 0;
-
-    this.clearInterceptedRequests();
+    this._requests.length = 0;
 
     this.createResponseDeclaration = undefined;
 
@@ -170,9 +168,7 @@ class HttpRequestHandlerClient<
       this.numberOfMatchedRequests++;
     } else {
       const shouldSaveUnmatchedGroup =
-        this.interceptor.requestSaving.enabled &&
-        this.restrictions.length > 0 &&
-        this.timesDeclarationPointer !== undefined;
+        this.interceptor.saveRequests && this.restrictions.length > 0 && this.timesDeclarationPointer !== undefined;
 
       if (shouldSaveUnmatchedGroup) {
         this.unmatchedRequestGroups.push({ request, diff: restrictionsMatch.diff });
@@ -382,12 +378,6 @@ class HttpRequestHandlerClient<
   ) {
     const interceptedRequest = this.createInterceptedRequest(request, response);
     this._requests.push(interceptedRequest);
-    this.interceptor.incrementNumberOfSavedRequests(1);
-  }
-
-  private clearInterceptedRequests() {
-    this.interceptor.incrementNumberOfSavedRequests(-this._requests.length);
-    this._requests.length = 0;
   }
 
   private createInterceptedRequest(
@@ -411,7 +401,7 @@ class HttpRequestHandlerClient<
   }
 
   get requests(): readonly InterceptedHttpInterceptorRequest<Path, Default<Schema[Path][Method]>, StatusCode>[] {
-    if (!this.interceptor.requestSaving.enabled) {
+    if (!this.interceptor.saveRequests) {
       throw new DisabledRequestSavingError();
     }
 

package/src/http/requestHandler/errors/DisabledRequestSavingError.ts

@@ -7,7 +7,7 @@ class DisabledRequestSavingError extends TypeError {
   constructor() {
     super(
       'Intercepted requests are not being saved. ' +
-        'Did you forget to use `requestSaving.enabled: true` in your interceptor?\n\n' +
+        'Did you forget to use `saveRequests: true` when creating the interceptor?\n\n' +
         'Learn more: https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests',
     );
     this.name = 'DisabledRequestSavingError';