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

package/dist/server.d.ts

@@ -1,3 +1,17 @@
+/**
+ * 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}.
@@ -73,48 +87,6 @@ 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': "*";
@@ -127,11 +99,13 @@ declare const DEFAULT_ACCESS_CONTROL_HEADERS: Readonly<{
 declare const DEFAULT_PREFLIGHT_STATUS_CODE = 204;
 
 /**
- * A namespace of interceptor server resources for handling HTTP requests.
+ * Creates an {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}.
  *
- * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
+ * @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 const interceptorServer: Readonly<InterceptorServerNamespace>;
+declare function createInterceptorServer(options?: InterceptorServerOptions): InterceptorServer;
 
-export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, type InterceptorServer, InterceptorServerNamespace, type InterceptorServerOptions, NotRunningInterceptorServerError, RunningInterceptorServerError, interceptorServer };
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, type InterceptorServer, type InterceptorServerOptions, NotRunningInterceptorServerError, RunningInterceptorServerError, createInterceptorServer };

package/dist/server.js

@@ -1,29 +1,29 @@
 'use strict';
 
-var chunkR2ROSKU4_js = require('./chunk-R2ROSKU4.js');
+var chunkO6ZIPCUJ_js = require('./chunk-O6ZIPCUJ.js');
 require('./chunk-WCQVDF3K.js');
 
 
 
 Object.defineProperty(exports, "DEFAULT_ACCESS_CONTROL_HEADERS", {
   enumerable: true,
-  get: function () { return chunkR2ROSKU4_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
+  get: function () { return chunkO6ZIPCUJ_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
 });
 Object.defineProperty(exports, "DEFAULT_PREFLIGHT_STATUS_CODE", {
   enumerable: true,
-  get: function () { return chunkR2ROSKU4_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
+  get: function () { return chunkO6ZIPCUJ_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
 });
 Object.defineProperty(exports, "NotRunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkR2ROSKU4_js.NotRunningInterceptorServerError_default; }
+  get: function () { return chunkO6ZIPCUJ_js.NotRunningInterceptorServerError_default; }
 });
 Object.defineProperty(exports, "RunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkR2ROSKU4_js.RunningInterceptorServerError_default; }
+  get: function () { return chunkO6ZIPCUJ_js.RunningInterceptorServerError_default; }
 });
-Object.defineProperty(exports, "interceptorServer", {
+Object.defineProperty(exports, "createInterceptorServer", {
   enumerable: true,
-  get: function () { return chunkR2ROSKU4_js.interceptorServer; }
+  get: function () { return chunkO6ZIPCUJ_js.createInterceptorServer; }
 });
 //# 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, interceptorServer } from './chunk-6TSSHQW5.mjs';
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, NotRunningInterceptorServerError_default as NotRunningInterceptorServerError, RunningInterceptorServerError_default as RunningInterceptorServerError, createInterceptorServer } from './chunk-NTRC2S4I.mjs';
 import './chunk-CGILA3WO.mjs';
 //# sourceMappingURL=server.mjs.map
 //# sourceMappingURL=server.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zimic/interceptor",
-  "description": "TypeScript-first HTTP intercepting and mocking",
+  "description": "Next-gen, TypeScript-first HTTP intercepting and mocking",
   "keywords": [
     "zimic",
     "typescript",
@@ -14,7 +14,7 @@
     "api",
     "static"
   ],
-  "version": "0.16.0-canary.1",
+  "version": "0.16.0-canary.11",
   "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.8",
-    "@vitest/coverage-istanbul": "^3.0.8",
+    "@vitest/browser": "^3.0.9",
+    "@vitest/coverage-istanbul": "^3.0.9",
     "dotenv-cli": "^8.0.0",
     "eslint": "^9.22.0",
-    "playwright": "^1.51.0",
+    "playwright": "^1.51.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
-    "vitest": "^3.0.8",
+    "vitest": "^3.0.9",
     "@zimic/eslint-config-node": "0.0.0",
     "@zimic/tsconfig": "0.0.0",
     "@zimic/lint-staged-config": "0.0.0",
     "@zimic/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@zimic/http": "^0.1.0 || ^0.1.0-canary.0",
+    "@zimic/http": "^0.2.0 || ^0.2.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 ${chalk.green(destinationPath)}!`);
+  logWithPrefix(`Service worker script saved to ${color.green(destinationPath)}!`);
   logWithPrefix('You can now use browser interceptors!');
 }
 

package/src/cli/server/start.ts

@@ -1,4 +1,4 @@
-import { InterceptorServer, interceptorServer } from '@/server';
+import { InterceptorServer, createInterceptorServer } 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 = interceptorServer.create({
+  const server = createInterceptorServer({
     hostname,
     port,
     logUnhandledRequests,

package/src/http/index.ts

@@ -1,12 +1,13 @@
-import HttpInterceptorNamespace from './namespace/HttpInterceptorNamespace';
-
-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';
 
@@ -49,12 +50,4 @@ export type { InferHttpInterceptorSchema } from './interceptor/types/schema';
 
 export type { LocalHttpInterceptor, RemoteHttpInterceptor, HttpInterceptor } from './interceptor/types/public';
 
-/**
- * A namespace of interceptor resources for mocking HTTP requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptor `HttpInterceptor` API reference}
- */
-export const httpInterceptor = Object.freeze(new HttpInterceptorNamespace());
-
-export type { default as HttpInterceptorNamespace } from './namespace/HttpInterceptorNamespace';
-export type { HttpInterceptorNamespaceDefault } from './namespace/HttpInterceptorNamespace';
+export { createHttpInterceptor } from './interceptor/factory';

package/src/http/interceptor/HttpInterceptorClient.ts

@@ -23,13 +23,17 @@ 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,
@@ -38,7 +42,9 @@ class HttpInterceptorClient<
   private store: HttpInterceptorStore;
 
   private _baseURL!: URL;
-  private _saveRequests?: boolean;
+
+  requestSaving: HttpInterceptorRequestSaving;
+  private numberOfSavedRequests = 0;
 
   onUnhandledRequest?: HandlerConstructor extends typeof LocalHttpRequestHandler
     ? UnhandledRequestStrategy.Local
@@ -64,7 +70,7 @@ class HttpInterceptorClient<
     worker: HttpInterceptorWorker;
     store: HttpInterceptorStore;
     baseURL: URL;
-    saveRequests?: boolean;
+    requestSaving?: Partial<HttpInterceptorRequestSaving>;
     onUnhandledRequest?: UnhandledRequestStrategy;
     Handler: HandlerConstructor;
   }) {
@@ -72,7 +78,12 @@ class HttpInterceptorClient<
     this.store = options.store;
 
     this.baseURL = options.baseURL;
-    this._saveRequests = options.saveRequests;
+
+    this.requestSaving = {
+      enabled: options.requestSaving?.enabled ?? this.getDefaultRequestSavingEnabled(),
+      safeLimit: options.requestSaving?.safeLimit ?? DEFAULT_REQUEST_SAVING_SAFE_LIMIT,
+    };
+
     this.onUnhandledRequest = options.onUnhandledRequest satisfies
       | UnhandledRequestStrategy
       | undefined as this['onUnhandledRequest'];
@@ -80,6 +91,10 @@ class HttpInterceptorClient<
     this.Handler = options.Handler;
   }
 
+  private getDefaultRequestSavingEnabled(): boolean {
+    return isServerSide() ? process.env.NODE_ENV === 'test' : false;
+  }
+
   get baseURL() {
     return this._baseURL;
   }
@@ -103,17 +118,6 @@ 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;
   }
@@ -251,7 +255,7 @@ class HttpInterceptorClient<
     const responseDeclaration = await matchedHandler.applyResponseDeclaration(parsedRequest);
     const response = HttpInterceptorWorker.createResponseFromDeclaration(request, responseDeclaration);
 
-    if (this.saveRequests) {
+    if (this.requestSaving.enabled) {
       const responseClone = response.clone();
 
       const parsedResponse = await HttpInterceptorWorker.parseRawResponse<
@@ -265,6 +269,17 @@ 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 } from './types/options';
-import { LocalHttpInterceptor as PublicLocalHttpInterceptor } from './types/public';
+import { LocalHttpInterceptorOptions, UnhandledRequestStrategy } from './types/options';
+import { HttpInterceptorRequestSaving, 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,
-      saveRequests: options.saveRequests,
+      requestSaving: options.requestSaving,
     });
   }
 
@@ -39,19 +39,19 @@ class LocalHttpInterceptor<Schema extends HttpSchema> implements PublicLocalHttp
     this.client.baseURL = new URL(baseURL);
   }
 
-  get saveRequests() {
-    return this.client.saveRequests;
+  get requestSaving() {
+    return this.client.requestSaving;
   }
 
-  set saveRequests(saveRequests: NonNullable<LocalHttpInterceptorOptions['saveRequests']>) {
-    this.client.saveRequests = saveRequests;
+  set requestSaving(requestSaving: HttpInterceptorRequestSaving) {
+    this.client.requestSaving = requestSaving;
   }
 
   get onUnhandledRequest() {
     return this.client.onUnhandledRequest;
   }
 
-  set onUnhandledRequest(onUnhandledRequest: LocalHttpInterceptorOptions['onUnhandledRequest']) {
+  set onUnhandledRequest(onUnhandledRequest: UnhandledRequestStrategy.Local | undefined) {
     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 } from './types/options';
-import { RemoteHttpInterceptor as PublicRemoteHttpInterceptor } from './types/public';
+import { RemoteHttpInterceptorOptions, UnhandledRequestStrategy } from './types/options';
+import { HttpInterceptorRequestSaving, 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,
-      saveRequests: options.saveRequests,
+      requestSaving: options.requestSaving,
     });
   }
 
@@ -40,19 +40,19 @@ class RemoteHttpInterceptor<Schema extends HttpSchema> implements PublicRemoteHt
     this.client.baseURL = new URL(baseURL);
   }
 
-  get saveRequests() {
-    return this.client.saveRequests;
+  get requestSaving() {
+    return this.client.requestSaving;
   }
 
-  set saveRequests(saveRequests: NonNullable<RemoteHttpInterceptorOptions['saveRequests']>) {
-    this.client.saveRequests = saveRequests;
+  set requestSaving(requestSaving: HttpInterceptorRequestSaving) {
+    this.client.requestSaving = requestSaving;
   }
 
   get onUnhandledRequest() {
     return this.client.onUnhandledRequest;
   }
 
-  set onUnhandledRequest(onUnhandledRequest: RemoteHttpInterceptorOptions['onUnhandledRequest']) {
+  set onUnhandledRequest(onUnhandledRequest: UnhandledRequestStrategy.Remote | undefined) {
     this.client.onUnhandledRequest = onUnhandledRequest;
   }
 

package/src/http/interceptor/errors/RequestSavingSafeLimitExceededError.ts

@@ -0,0 +1,22 @@
+/**
+ * Error thrown when the safe limit of saved intercepted requests is exceeded.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
+ */
+class RequestSavingSafeLimitExceededError extends TypeError {
+  constructor(numberOfSavedRequests: number, safeLimit: number) {
+    super(
+      `The number of intercepted requests saved in memory (${numberOfSavedRequests}) exceeded the safe limit of ` +
+        `${safeLimit}. Did you forget to call \`interceptor.clear()\`?\n\n` +
+        'If you need to save requests, make sure to regularly call `interceptor.clear()`. Alternatively, you can ' +
+        'hide this warning by increasing `requestSaving.safeLimit` in your interceptor. Note that saving too many ' +
+        'requests in memory can lead to performance issues.\n\n' +
+        'If you do not need to save requests, consider setting `requestSaving.enabled: false` in your ' +
+        'interceptor.\n\n' +
+        'Learn more: https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests',
+    );
+    this.name = 'RequestSavingSafeLimitExceededError';
+  }
+}
+
+export default RequestSavingSafeLimitExceededError;

package/src/http/interceptor/factory.ts

@@ -24,7 +24,7 @@ function isRemoteHttpInterceptorOptions(options: HttpInterceptorOptions) {
  * @returns The created HTTP interceptor.
  * @throws {InvalidURLError} If the base URL is invalid.
  * @throws {UnsupportedURLProtocolError} If the base URL protocol is not either `http` or `https`.
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptorcreateoptions `httpInterceptor.create(options)` API reference}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#createhttpinterceptoroptions `createHttpInterceptor(options)` API reference}
  */
 export function createHttpInterceptor<Schema extends HttpSchema>(
   options: LocalHttpInterceptorOptions,

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

@@ -1,5 +1,6 @@
 import { PossiblePromise } from '@zimic/utils/types';
 
+import { HttpInterceptorRequestSaving } from './public';
 import { UnhandledHttpInterceptorRequest } from './requests';
 
 /**
@@ -119,20 +120,12 @@ export interface SharedHttpInterceptorOptions {
   baseURL: string;
 
   /**
-   * 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`}.
+   * Configures if the intercepted requests are saved and how they are handled.
    *
-   * **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}
    */
-  saveRequests?: boolean;
+  requestSaving?: Partial<HttpInterceptorRequestSaving>;
 }
 
 /**
@@ -177,6 +170,6 @@ export interface RemoteHttpInterceptorOptions extends SharedHttpInterceptorOptio
  * The options to create an
  * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptor HTTP interceptor}.
  *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptorcreateoptions `httpInterceptor.create(options)` API reference}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#createhttpinterceptoroptions `createHttpInterceptor(options)` API reference}
  */
 export type HttpInterceptorOptions = LocalHttpInterceptorOptions | RemoteHttpInterceptorOptions;

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

@@ -3,6 +3,45 @@ 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.
@@ -20,20 +59,12 @@ export interface HttpInterceptor<_Schema extends HttpSchema> {
   baseURL: string;
 
   /**
-   * 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.
+   * Configures if the intercepted requests are saved and how they are handled.
    *
-   * @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}
    */
-  saveRequests: boolean;
+  requestSaving: HttpInterceptorRequestSaving;
 
   /**
    * The platform the interceptor is running on.
@@ -86,8 +117,9 @@ export interface HttpInterceptor<_Schema extends HttpSchema> {
    * of each test.
    *
    * When
-   * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptorcreateoptions `saveRequests: true`}
-   * is enabled 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#saving-requests
+   * `requestSaving.enabled`} is
+   * `true` 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/interceptor/types/schema.ts

@@ -5,9 +5,9 @@ import { LocalHttpInterceptor, RemoteHttpInterceptor } from './public';
  * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptor `HttpInterceptor`}.
  *
  * @example
- *   import { httpInterceptor, type InferHttpInterceptorSchema } from '@zimic/http';
+ *   import { type InferHttpInterceptorSchema } from '@zimic/http';
  *
- *   const interceptor = httpInterceptor.create<{
+ *   const interceptor = createHttpInterceptor<{
  *     '/users': {
  *       GET: {
  *         response: { 200: { body: User[] } };