@zimic/interceptor 0.16.0-canary.5 → 0.16.0-canary.7

package/dist/http.mjs

@@ -8,30 +8,6 @@ import ClientSocket from 'isomorphic-ws';
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/http/interceptorWorker/errors/InvalidJSONError.ts
-var InvalidJSONError = class extends SyntaxError {
-  static {
-    __name(this, "InvalidJSONError");
-  }
-  constructor(value) {
-    super(`Failed to parse value as JSON: ${value}`);
-    this.name = "InvalidJSONError";
-  }
-};
-var InvalidJSONError_default = InvalidJSONError;
-
-// src/http/interceptorWorker/errors/InvalidFormDataError.ts
-var InvalidFormDataError = class extends SyntaxError {
-  static {
-    __name(this, "InvalidFormDataError");
-  }
-  constructor(value) {
-    super(`Failed to parse value as form data: ${value}`);
-    this.name = "InvalidFormDataError";
-  }
-};
-var InvalidFormDataError_default = InvalidFormDataError;
-
 // src/http/interceptor/errors/RunningHttpInterceptorError.ts
 var RunningHttpInterceptorError = class extends Error {
   static {
@@ -84,6 +60,50 @@ var UnknownHttpInterceptorTypeError = class extends TypeError {
 };
 var UnknownHttpInterceptorTypeError_default = UnknownHttpInterceptorTypeError;
 
+// src/http/interceptor/errors/RequestSavingSafeLimitExceededError.ts
+var RequestSavingSafeLimitExceededError = class extends TypeError {
+  static {
+    __name(this, "RequestSavingSafeLimitExceededError");
+  }
+  constructor(numberOfSavedRequests, safeLimit) {
+    super(
+      `The number of intercepted requests saved in memory (${numberOfSavedRequests}) exceeded the safe limit of ${safeLimit}. Did you forget to call \`interceptor.clear()\`?
+
+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.
+
+If you do not need to save requests, consider setting \`requestSaving.enabled: false\` in your interceptor.
+
+Learn more: https://github.com/zimicjs/zimic/wiki/api\u2010zimic\u2010interceptor\u2010http#saving-requests`
+    );
+    this.name = "RequestSavingSafeLimitExceededError";
+  }
+};
+var RequestSavingSafeLimitExceededError_default = RequestSavingSafeLimitExceededError;
+
+// src/http/interceptorWorker/errors/InvalidFormDataError.ts
+var InvalidFormDataError = class extends SyntaxError {
+  static {
+    __name(this, "InvalidFormDataError");
+  }
+  constructor(value) {
+    super(`Failed to parse value as form data: ${value}`);
+    this.name = "InvalidFormDataError";
+  }
+};
+var InvalidFormDataError_default = InvalidFormDataError;
+
+// src/http/interceptorWorker/errors/InvalidJSONError.ts
+var InvalidJSONError = class extends SyntaxError {
+  static {
+    __name(this, "InvalidJSONError");
+  }
+  constructor(value) {
+    super(`Failed to parse value as JSON: ${value}`);
+    this.name = "InvalidJSONError";
+  }
+};
+var InvalidJSONError_default = InvalidJSONError;
+
 // src/cli/browser/shared/constants.ts
 var SERVICE_WORKER_FILE_NAME = "mockServiceWorker.js";
 
@@ -115,7 +135,7 @@ var DisabledRequestSavingError = class extends TypeError {
   }
   constructor() {
     super(
-      "Intercepted requests are not being saved. Did you forget to use `saveRequests: true` when creating the interceptor?\n\nLearn more: https://github.com/zimicjs/zimic/wiki/api\u2010zimic\u2010interceptor\u2010http#saving-requests"
+      "Intercepted requests are not being saved. Did you forget to use `requestSaving.enabled: true` in your interceptor?\n\nLearn more: https://github.com/zimicjs/zimic/wiki/api\u2010zimic\u2010interceptor\u2010http#saving-requests"
     );
     this.name = "DisabledRequestSavingError";
   }
@@ -259,9 +279,9 @@ Requests evaluated by this handler:
   ].filter((part) => part !== false).join("");
 }
 __name(createMessageHeader, "createMessageHeader");
-function createMessageDiffs({ hasSavedRequests, unmatchedRequestGroups }) {
-  if (!hasSavedRequests) {
-    return "Tip: enable `saveRequests: true` in your interceptor for more details about the unmatched requests.";
+function createMessageDiffs({ requestSaving, unmatchedRequestGroups }) {
+  if (!requestSaving.enabled) {
+    return "Tip: use `requestSaving.enabled: true` in your interceptor for more details about the unmatched requests.";
   }
   return unmatchedRequestGroups.map(({ request, diff }, index) => {
     const requestNumber = index + 1;
@@ -476,7 +496,7 @@ var HttpRequestHandlerClient = class {
     newThis.createResponseDeclaration = this.isResponseDeclarationFactory(declaration) ? declaration : () => declaration;
     newThis.numberOfMatchedRequests = 0;
     newThis.unmatchedRequestGroups.length = 0;
-    newThis._requests.length = 0;
+    newThis.clearInterceptedRequests();
     this.interceptor.registerRequestHandler(this.handler);
     return newThis;
   }
@@ -500,7 +520,7 @@ var HttpRequestHandlerClient = class {
         declarationPointer: this.timesDeclarationPointer,
         unmatchedRequestGroups: this.unmatchedRequestGroups,
         hasRestrictions: this.restrictions.length > 0,
-        hasSavedRequests: this.interceptor.saveRequests
+        requestSaving: this.interceptor.requestSaving
       });
     }
   }
@@ -512,7 +532,7 @@ var HttpRequestHandlerClient = class {
     this.timesDeclarationPointer = void 0;
     this.numberOfMatchedRequests = 0;
     this.unmatchedRequestGroups.length = 0;
-    this._requests.length = 0;
+    this.clearInterceptedRequests();
     this.createResponseDeclaration = void 0;
     return this;
   }
@@ -525,7 +545,7 @@ var HttpRequestHandlerClient = class {
     if (restrictionsMatch.value) {
       this.numberOfMatchedRequests++;
     } else {
-      const shouldSaveUnmatchedGroup = this.interceptor.saveRequests && this.restrictions.length > 0 && this.timesDeclarationPointer !== void 0;
+      const shouldSaveUnmatchedGroup = this.interceptor.requestSaving.enabled && this.restrictions.length > 0 && this.timesDeclarationPointer !== void 0;
       if (shouldSaveUnmatchedGroup) {
         this.unmatchedRequestGroups.push({ request, diff: restrictionsMatch.diff });
       }
@@ -659,6 +679,11 @@ var HttpRequestHandlerClient = class {
   saveInterceptedRequest(request, response) {
     const interceptedRequest = this.createInterceptedRequest(request, response);
     this._requests.push(interceptedRequest);
+    this.interceptor.incrementNumberOfSavedRequests(1);
+  }
+  clearInterceptedRequests() {
+    this.interceptor.incrementNumberOfSavedRequests(-this._requests.length);
+    this._requests.length = 0;
   }
   createInterceptedRequest(request, response) {
     const interceptedRequest = request;
@@ -671,7 +696,7 @@ var HttpRequestHandlerClient = class {
     return interceptedRequest;
   }
   get requests() {
-    if (!this.interceptor.saveRequests) {
+    if (!this.interceptor.requestSaving.enabled) {
       throw new DisabledRequestSavingError_default();
     }
     return this._requests;
@@ -1459,6 +1484,7 @@ var RemoteHttpRequestHandler_default = RemoteHttpRequestHandler;
 
 // src/http/interceptor/HttpInterceptorClient.ts
 var SUPPORTED_BASE_URL_PROTOCOLS = Object.freeze(["http", "https"]);
+var DEFAULT_REQUEST_SAVING_SAFE_LIMIT = 1e3;
 var HttpInterceptorClient = class {
   static {
     __name(this, "HttpInterceptorClient");
@@ -1466,7 +1492,8 @@ var HttpInterceptorClient = class {
   worker;
   store;
   _baseURL;
-  _saveRequests;
+  requestSaving;
+  numberOfSavedRequests = 0;
   onUnhandledRequest;
   isRunning = false;
   Handler;
@@ -1483,10 +1510,16 @@ var HttpInterceptorClient = class {
     this.worker = options.worker;
     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;
     this.Handler = options.Handler;
   }
+  getDefaultRequestSavingEnabled() {
+    return isServerSide() ? process.env.NODE_ENV === "test" : false;
+  }
   get baseURL() {
     return this._baseURL;
   }
@@ -1506,15 +1539,6 @@ var HttpInterceptorClient = class {
     }
     return this.baseURL.href;
   }
-  get saveRequests() {
-    if (this._saveRequests === void 0) {
-      return isServerSide() ? process.env.NODE_ENV === "test" : false;
-    }
-    return this._saveRequests;
-  }
-  set saveRequests(saveRequests) {
-    this._saveRequests = saveRequests;
-  }
   get platform() {
     return this.worker.platform;
   }
@@ -1612,13 +1636,21 @@ var HttpInterceptorClient = class {
     }
     const responseDeclaration = await matchedHandler.applyResponseDeclaration(parsedRequest);
     const response = HttpInterceptorWorker_default.createResponseFromDeclaration(request, responseDeclaration);
-    if (this.saveRequests) {
+    if (this.requestSaving.enabled) {
       const responseClone = response.clone();
       const parsedResponse = await HttpInterceptorWorker_default.parseRawResponse(responseClone);
       matchedHandler.saveInterceptedRequest(parsedRequest, parsedResponse);
     }
     return response;
   }
+  incrementNumberOfSavedRequests(increment) {
+    this.numberOfSavedRequests = Math.max(this.numberOfSavedRequests + increment, 0);
+    const exceedsSafeLimit = this.numberOfSavedRequests > this.requestSaving.safeLimit;
+    if (increment > 0 && exceedsSafeLimit) {
+      const error = new RequestSavingSafeLimitExceededError_default(this.numberOfSavedRequests, this.requestSaving.safeLimit);
+      console.warn(error);
+    }
+  }
   async findMatchedHandler(method, path, parsedRequest) {
     const handlersByPath = this.handlerClientsByMethod[method].get(path) ?? [];
     for (let handlerIndex = handlersByPath.length - 1; handlerIndex >= 0; handlerIndex--) {
@@ -2367,7 +2399,7 @@ var LocalHttpInterceptor = class {
       baseURL,
       Handler: LocalHttpRequestHandler_default,
       onUnhandledRequest: options.onUnhandledRequest,
-      saveRequests: options.saveRequests
+      requestSaving: options.requestSaving
     });
   }
   get type() {
@@ -2379,11 +2411,11 @@ var LocalHttpInterceptor = class {
   set baseURL(baseURL) {
     this.client.baseURL = new URL(baseURL);
   }
-  get saveRequests() {
-    return this.client.saveRequests;
+  get requestSaving() {
+    return this.client.requestSaving;
   }
-  set saveRequests(saveRequests) {
-    this.client.saveRequests = saveRequests;
+  set requestSaving(requestSaving) {
+    this.client.requestSaving = requestSaving;
   }
   get onUnhandledRequest() {
     return this.client.onUnhandledRequest;
@@ -2457,7 +2489,7 @@ var RemoteHttpInterceptor = class {
       baseURL,
       Handler: RemoteHttpRequestHandler_default,
       onUnhandledRequest: options.onUnhandledRequest,
-      saveRequests: options.saveRequests
+      requestSaving: options.requestSaving
     });
   }
   get type() {
@@ -2469,11 +2501,11 @@ var RemoteHttpInterceptor = class {
   set baseURL(baseURL) {
     this.client.baseURL = new URL(baseURL);
   }
-  get saveRequests() {
-    return this.client.saveRequests;
+  get requestSaving() {
+    return this.client.requestSaving;
   }
-  set saveRequests(saveRequests) {
-    this.client.saveRequests = saveRequests;
+  set requestSaving(requestSaving) {
+    this.client.requestSaving = requestSaving;
   }
   get onUnhandledRequest() {
     return this.client.onUnhandledRequest;
@@ -2576,6 +2608,6 @@ __name(createHttpInterceptor, "createHttpInterceptor");
  * Reply listeners are always present when notified in normal conditions. If they were not present, the request
  * would reach a timeout and not be responded. The empty set serves as a fallback. */
 
-export { DisabledRequestSavingError_default as DisabledRequestSavingError, InvalidFormDataError_default as InvalidFormDataError, InvalidJSONError_default as InvalidJSONError, NotRunningHttpInterceptorError_default as NotRunningHttpInterceptorError, RunningHttpInterceptorError_default as RunningHttpInterceptorError, TimesCheckError_default as TimesCheckError, UnknownHttpInterceptorPlatformError_default as UnknownHttpInterceptorPlatformError, UnknownHttpInterceptorTypeError_default as UnknownHttpInterceptorTypeError, UnregisteredBrowserServiceWorkerError_default as UnregisteredBrowserServiceWorkerError, createHttpInterceptor };
+export { DisabledRequestSavingError_default as DisabledRequestSavingError, InvalidFormDataError_default as InvalidFormDataError, InvalidJSONError_default as InvalidJSONError, NotRunningHttpInterceptorError_default as NotRunningHttpInterceptorError, RequestSavingSafeLimitExceededError_default as RequestSavingSafeLimitExceededError, RunningHttpInterceptorError_default as RunningHttpInterceptorError, TimesCheckError_default as TimesCheckError, UnknownHttpInterceptorPlatformError_default as UnknownHttpInterceptorPlatformError, UnknownHttpInterceptorTypeError_default as UnknownHttpInterceptorTypeError, UnregisteredBrowserServiceWorkerError_default as UnregisteredBrowserServiceWorkerError, createHttpInterceptor };
 //# sourceMappingURL=http.mjs.map
 //# sourceMappingURL=http.mjs.map