@zimic/interceptor 0.19.1-canary.7 → 0.19.1

package/dist/server.js

@@ -1,29 +1,29 @@
 'use strict';
 
-var chunkPKURIUS2_js = require('./chunk-PKURIUS2.js');
+var chunk3LOHF6BU_js = require('./chunk-3LOHF6BU.js');
 require('./chunk-WCQVDF3K.js');
 
 
 
 Object.defineProperty(exports, "DEFAULT_ACCESS_CONTROL_HEADERS", {
   enumerable: true,
-  get: function () { return chunkPKURIUS2_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
+  get: function () { return chunk3LOHF6BU_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
 });
 Object.defineProperty(exports, "DEFAULT_PREFLIGHT_STATUS_CODE", {
   enumerable: true,
-  get: function () { return chunkPKURIUS2_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
+  get: function () { return chunk3LOHF6BU_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
 });
 Object.defineProperty(exports, "NotRunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkPKURIUS2_js.NotRunningInterceptorServerError_default; }
+  get: function () { return chunk3LOHF6BU_js.NotRunningInterceptorServerError_default; }
 });
 Object.defineProperty(exports, "RunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkPKURIUS2_js.RunningInterceptorServerError_default; }
+  get: function () { return chunk3LOHF6BU_js.RunningInterceptorServerError_default; }
 });
 Object.defineProperty(exports, "createInterceptorServer", {
   enumerable: true,
-  get: function () { return chunkPKURIUS2_js.createInterceptorServer; }
+  get: function () { return chunk3LOHF6BU_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, createInterceptorServer } from './chunk-XBLRKSEM.mjs';
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, NotRunningInterceptorServerError_default as NotRunningInterceptorServerError, RunningInterceptorServerError_default as RunningInterceptorServerError, createInterceptorServer } from './chunk-5RMPVTKM.mjs';
 import './chunk-CGILA3WO.mjs';
 //# sourceMappingURL=server.mjs.map
 //# sourceMappingURL=server.mjs.map

package/package.json

@@ -14,7 +14,7 @@
     "api",
     "static"
   ],
-  "version": "0.19.1-canary.7",
+  "version": "0.19.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/zimicjs/zimic.git",
@@ -99,14 +99,14 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.1",
+    "@zimic/eslint-config-node": "0.0.0",
     "@zimic/lint-staged-config": "0.0.0",
-    "@zimic/utils": "0.0.0",
     "@zimic/tsconfig": "0.0.0",
-    "@zimic/eslint-config-node": "0.0.0"
+    "@zimic/utils": "0.0.0"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0",
-    "@zimic/http": "^0.5.0 || 0.5.1-canary.2"
+    "@zimic/http": "^0.5.0 || 0.5.1"
   },
   "peerDependenciesMeta": {
     "typescript": {

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

@@ -15,32 +15,19 @@ import {
 } from './requests';
 import { HttpRequestHandlerRestriction } from './restrictions';
 
-/**
- * An HTTP request handler to declare responses for intercepted requests.
- *
- * When multiple handlers of the same interceptor match the same method and path, the _last_ handler created with
- * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#interceptormethodpath `interceptor.<method>(path)`}
- * will be used.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler `HttpRequestHandler` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler `HttpRequestHandler` API reference} */
 export interface HttpRequestHandler<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
   Path extends HttpSchemaPath<Schema, Method>,
 > {
   /**
-   * The method that matches this handler.
-   *
    * @readonly
    * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlermethod `handler.method` API reference}
    */
   get method(): Method;
 
   /**
-   * The path that matches this handler. The base URL of the interceptor is not included, but it is used when matching
-   * requests.
-   *
    * @readonly
    * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerpath `handler.path` API reference}
    */
@@ -56,16 +43,7 @@ export interface InternalHttpRequestHandler<
   client: HttpRequestHandlerClient<Schema, Method, Path, StatusCode>;
 }
 
-/**
- * A local HTTP request handler to declare responses for intercepted requests. In a local handler, the mocking
- * operations are synchronous and are executed in the same process where it was created.
- *
- * When multiple handlers of the same interceptor match the same method and path, the _last_ handler created with
- * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#interceptormethodpath `interceptor.<method>(path)`}
- * will be used.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler `HttpRequestHandler` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler `HttpRequestHandler` API reference} */
 export interface LocalHttpRequestHandler<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
@@ -75,113 +53,26 @@ export interface LocalHttpRequestHandler<
   /** @readonly */
   get type(): 'local';
 
-  /**
-   * Declares a restriction to intercepted request matches. `headers`, `searchParams`, and `body` are supported to limit
-   * which requests will match the handler and receive the mock response. If multiple restrictions are declared, either
-   * in a single object or with multiple calls to `handler.with()`, all of them must be met, essentially creating an AND
-   * condition.
-   *
-   * By default, restrictions use `exact: false`, meaning that any request **containing** the declared restrictions will
-   * match the handler, regardless of having more properties or values. If you want to match only requests with the
-   * exact values declared, you can use `exact: true`.
-   *
-   * A function is also supported to declare restrictions, in case they are dynamic.
-   *
-   * @param restriction The restriction to match intercepted requests.
-   * @returns The same handler, now considering the specified restriction.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
   with: (restriction: HttpRequestHandlerRestriction<Schema, Method, Path>) => this;
 
-  /**
-   * Declares a response to return for matched intercepted requests.
-   *
-   * When the handler matches a request, it will respond with the given declaration. The response type is statically
-   * validated against the schema of the interceptor.
-   *
-   * @param declaration The response declaration or a factory to create it.
-   * @returns The same handler, now including type information about the response declaration based on the specified
-   *   status code.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()` API reference} */
   respond: <NewStatusCode extends HttpResponseSchemaStatusCode<Default<Default<Schema[Path][Method]>['response']>>>(
     declaration:
       | HttpRequestHandlerResponseDeclaration<Default<Schema[Path][Method]>, NewStatusCode>
       | HttpRequestHandlerResponseDeclarationFactory<Path, Default<Schema[Path][Method]>, NewStatusCode>,
   ) => LocalHttpRequestHandler<Schema, Method, Path, NewStatusCode>;
 
-  /**
-   * Declares a number of intercepted requests that the handler will be able to match and return its response.
-   *
-   * If only one argument is provided, the handler will match exactly that number of requests. In case of two arguments,
-   * the handler will consider an inclusive range, matching at least the minimum (first argument) and at most the
-   * maximum (second argument) number of requests.
-   *
-   * Once the handler receives more requests than the maximum number declared, it will stop matching requests and
-   * returning its response. In this case, Zimic will try other handlers until one eligible is found, otherwise the
-   * request will be either bypassed or rejected. Learn more about how Zimic decides which handler to use for an
-   * intercepted request in the
-   * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#declaring-request-handlers Declaring request handlers}.
-   *
-   * **Important**: To make sure that all expected requests were made, use
-   * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#interceptorchecktimes `interceptor.checkTimes()`} or
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()`}.
-   * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#interceptorchecktimes `interceptor.checkTimes()`} is
-   * generally preferred, as it checks all handlers created by the interceptor with a single call.
-   *
-   * @param numberOfRequests The number of times the handler should match intercepted requests.
-   * @param minNumberOfRequests The minimum number of times the handler should match intercepted requests.
-   * @param maxNumberOfRequests The maximum number of times the handler should match intercepted requests.
-   * @returns The same handler, now considering the specified number of times.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()` API reference} */
   times: ((numberOfRequests: number) => this) & ((minNumberOfRequests: number, maxNumberOfRequests: number) => this);
 
-  /**
-   * Checks if the handler has matched the expected number of requests declared with
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()`}.
-   *
-   * If the handler has matched fewer or more requests than expected, this method will throw a `TimesCheckError` error
-   * pointing to the
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()` API reference}
-   * that was not satisfied.
-   *
-   * When {@link https://zimic.dev/docs/interceptor/api/create-http-interceptor `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://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction restrictions}.
-   *
-   * @throws {TimesCheckError} If the handler has matched less or more requests than the expected number of requests.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerchecktimes `handler.checkTimes()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerchecktimes `handler.checkTimes()` API reference} */
   checkTimes: () => void;
 
-  /**
-   * Clears any response declared with
-   * [`handler.respond(declaration)`](https://zimic.dev/docs/interceptor/api/http-request-handler#handlerresponddeclaration),
-   * restrictions declared with
-   * [`handler.with(restriction)`](https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction),
-   * and intercepted requests, making the handler stop matching requests. The next handler, created before this one,
-   * that matches the same method and path will be used if present. If not, the requests of the method and path will not
-   * be intercepted.
-   *
-   * To make the handler match requests again, register a new response with
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()`}.
-   *
-   * @returns The same handler, now cleared of any declared responses, restrictions, and intercepted requests.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerclear `handler.clear()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerclear `handler.clear()` API reference} */
   clear: () => this;
 
   /**
-   * The intercepted requests that matched this handler, along with the responses returned to each of them. This is
-   * useful for testing that the correct requests were made by your application.
-   *
-   * **Important**: This method can only be used if
-   * {@link https://zimic.dev/docs/interceptor/api/create-http-interceptor `requestSaving.enabled`} is `true` in the
-   * interceptor.
-   *
-   * @throws {DisabledRequestSavingError} If the interceptor has `requestSaving.enabled: false`.
    * @readonly
    * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrequests `handler.requests` API reference}
    */
@@ -203,119 +94,32 @@ export interface SyncedRemoteHttpRequestHandler<
   /** @readonly */
   get type(): 'remote';
 
-  /**
-   * Declares a restriction to intercepted request matches. `headers`, `searchParams`, and `body` are supported to limit
-   * which requests will match the handler and receive the mock response. If multiple restrictions are declared, either
-   * in a single object or with multiple calls to `handler.with()`, all of them must be met, essentially creating an AND
-   * condition.
-   *
-   * By default, restrictions use `exact: false`, meaning that any request **containing** the declared restrictions will
-   * match the handler, regardless of having more properties or values. If you want to match only requests with the
-   * exact values declared, you can use `exact: true`.
-   *
-   * A function is also supported to declare restrictions, in case they are dynamic.
-   *
-   * @param restriction The restriction to match intercepted requests.
-   * @returns The same handler, now considering the specified restriction.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
   with: (
     restriction: HttpRequestHandlerRestriction<Schema, Method, Path>,
   ) => PendingRemoteHttpRequestHandler<Schema, Method, Path, StatusCode>;
 
-  /**
-   * Declares a response to return for matched intercepted requests.
-   *
-   * When the handler matches a request, it will respond with the given declaration. The response type is statically
-   * validated against the schema of the interceptor.
-   *
-   * @param declaration The response declaration or a factory to create it.
-   * @returns The same handler, now including type information about the response declaration based on the specified
-   *   status code.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()` API reference} */
   respond: <NewStatusCode extends HttpResponseSchemaStatusCode<Default<Default<Schema[Path][Method]>['response']>>>(
     declaration:
       | HttpRequestHandlerResponseDeclaration<Default<Schema[Path][Method]>, NewStatusCode>
       | HttpRequestHandlerResponseDeclarationFactory<Path, Default<Schema[Path][Method]>, NewStatusCode>,
   ) => PendingRemoteHttpRequestHandler<Schema, Method, Path, NewStatusCode>;
 
-  /**
-   * Declares a number of intercepted requests that the handler will be able to match and return its response.
-   *
-   * If only one argument is provided, the handler will match exactly that number of requests. In case of two arguments,
-   * the handler will consider an inclusive range, matching at least the minimum (first argument) and at most the
-   * maximum (second argument) number of requests.
-   *
-   * Once the handler receives more requests than the maximum number declared, it will stop matching requests and
-   * returning its response. In this case, Zimic will try other handlers until one eligible is found, otherwise the
-   * request will be either bypassed or rejected. Learn more about how Zimic decides which handler to use for an
-   * intercepted request in the
-   * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#declaring-request-handlers Declaring request handlers}.
-   *
-   * **Important**: To make sure that all expected requests were made, use
-   * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#interceptorchecktimes `interceptor.checkTimes()`} or
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerchecktimes `handler.checkTimes()`}.
-   * {@link https://zimic.dev/docs/interceptor/api/http-interceptor#interceptorchecktimes `interceptor.checkTimes()`} is
-   * generally preferred, as it checks all handlers created by the interceptor with a single call.
-   *
-   * @param numberOfRequests The number of times the handler should match intercepted requests.
-   * @param minNumberOfRequests The minimum number of times the handler should match intercepted requests.
-   * @param maxNumberOfRequests The maximum number of times the handler should match intercepted requests.
-   * @returns The same handler, now considering the specified number of times.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()` API reference} */
   times: ((numberOfRequests: number) => PendingRemoteHttpRequestHandler<Schema, Method, Path, StatusCode>) &
     ((
       minNumberOfRequests: number,
       maxNumberOfRequests: number,
     ) => PendingRemoteHttpRequestHandler<Schema, Method, Path, StatusCode>);
 
-  /**
-   * Checks if the handler has matched the expected number of requests declared with
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()`}.
-   *
-   * If the handler has matched fewer or more requests than expected, this method will throw a `TimesCheckError` error
-   * pointing to the
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlertimes `handler.times()` API reference}
-   * that was not satisfied.
-   *
-   * When {@link https://zimic.dev/docs/interceptor/api/create-http-interceptor `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://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction restrictions}.
-   *
-   * @throws {TimesCheckError} If the handler has matched less or more requests than the expected number of requests.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerchecktimes `handler.checkTimes()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerchecktimes `handler.checkTimes()` API reference} */
   checkTimes: () => Promise<void>;
 
-  /**
-   * Clears any response declared with
-   * [`handler.respond(declaration)`](https://zimic.dev/docs/interceptor/api/http-request-handler#handlerresponddeclaration),
-   * restrictions declared with
-   * [`handler.with(restriction)`](https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction),
-   * and intercepted requests, making the handler stop matching requests. The next handler, created before this one,
-   * that matches the same method and path will be used if present. If not, the requests of the method and path will not
-   * be intercepted.
-   *
-   * To make the handler match requests again, register a new response with
-   * {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()`}.
-   *
-   * @returns The same handler, now cleared of any declared responses, restrictions, and intercepted requests.
-   * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerclear `handler.clear()` API reference}
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerclear `handler.clear()` API reference} */
   clear: () => PendingRemoteHttpRequestHandler<Schema, Method, Path, StatusCode>;
 
   /**
-   * The intercepted requests that matched this handler, along with the responses returned to each of them. This is
-   * useful for testing that the correct requests were made by your application.
-   *
-   * **Important**: This method can only be used if
-   * {@link https://zimic.dev/docs/interceptor/api/create-http-interceptor `requestSaving.enabled`} is `true` in the
-   * interceptor.
-   *
-   * @throws {DisabledRequestSavingError} If the interceptor has `requestSaving.enabled: false`.
    * @readonly
    * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrequests `handler.requests` API reference}
    */

package/src/http/requestHandler/types/requests.ts

@@ -41,7 +41,7 @@ export type HttpRequestHandlerResponseDeclarationWithHeaders<ResponseSchema exte
       ? { headers?: HttpRequestHandlerResponseDeclarationHeaders<ResponseSchema> }
       : { headers: HttpRequestHandlerResponseDeclarationHeaders<ResponseSchema> };
 
-/** A declaration of an HTTP response for an intercepted request. */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()` API reference} */
 export type HttpRequestHandlerResponseDeclaration<
   MethodSchema extends HttpMethodSchema = HttpMethodSchema,
   StatusCode extends HttpStatusCode = HttpStatusCode,
@@ -53,12 +53,7 @@ export type HttpRequestHandlerResponseDeclaration<
       HttpRequestHandlerResponseDeclarationWithHeaders<Default<Default<MethodSchema['response']>[StatusCode]>>
   : never;
 
-/**
- * A factory to create {@link HttpRequestHandlerResponseDeclaration} objects.
- *
- * @param request The intercepted request.
- * @returns The response declaration.
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrespond `handler.respond()` API reference} */
 export type HttpRequestHandlerResponseDeclarationFactory<
   Path extends string,
   MethodSchema extends HttpMethodSchema,
@@ -67,10 +62,7 @@ export type HttpRequestHandlerResponseDeclarationFactory<
   request: Omit<HttpInterceptorRequest<Path, MethodSchema>, 'response'>,
 ) => PossiblePromise<HttpRequestHandlerResponseDeclaration<MethodSchema, StatusCode>>;
 
-/**
- * A strict representation of an intercepted HTTP request. The body, search params and path params are already parsed by
- * default.
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrequests `handler.requests` API reference} */
 export interface HttpInterceptorRequest<Path extends string, MethodSchema extends HttpMethodSchema>
   extends Omit<HttpRequest, keyof Body | 'headers' | 'clone'> {
   /** The headers of the request. */
@@ -85,10 +77,7 @@ export interface HttpInterceptorRequest<Path extends string, MethodSchema extend
   raw: HttpRequest<HttpRequestBodySchema<MethodSchema>, Default<HttpRequestHeadersSchema<MethodSchema>>>;
 }
 
-/**
- * A strict representation of an intercepted HTTP response. The body, search params and path params are already parsed
- * by default.
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrequests `handler.requests` API reference} */
 export interface HttpInterceptorResponse<MethodSchema extends HttpMethodSchema, StatusCode extends HttpStatusCode>
   extends Omit<HttpResponse, keyof Body | 'headers' | 'clone'> {
   /** The headers of the response. */
@@ -123,10 +112,7 @@ export const HTTP_INTERCEPTOR_RESPONSE_HIDDEN_PROPERTIES = Object.freeze(
   ),
 );
 
-/**
- * A strict representation of an intercepted HTTP request, along with its response. The body, search params and path
- * params are already parsed by default.
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerrequests `handler.requests` API reference} */
 export interface InterceptedHttpInterceptorRequest<
   Path extends string,
   MethodSchema extends HttpMethodSchema,

package/src/http/requestHandler/types/restrictions.ts

@@ -22,11 +22,7 @@ type PartialHttpHeadersOrSchema<Schema extends HttpHeadersSchema.Loose> = IfNeve
   Partial<Schema> | HttpHeaders<Partial<Schema>> | HttpHeaders<Schema>
 >;
 
-/**
- * A static headers restriction to match intercepted requests.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
 export type HttpRequestHandlerHeadersStaticRestriction<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
@@ -39,11 +35,7 @@ type PartialHttpSearchParamsOrSchema<Schema extends HttpSearchParamsSchema.Loose
   Partial<Schema> | HttpSearchParams<Partial<Schema>> | HttpSearchParams<Schema>
 >;
 
-/**
- * A static search params restriction to match intercepted requests.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
 export type HttpRequestHandlerSearchParamsStaticRestriction<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
@@ -59,68 +51,40 @@ type PartialBodyOrSchema<Body extends HttpBody> =
         ? Body
         : DeepPartial<Body>;
 
-/**
- * A static body restriction to match intercepted requests.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
 export type HttpRequestHandlerBodyStaticRestriction<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
   Path extends HttpSchemaPath<Schema, Method>,
 > = PartialBodyOrSchema<HttpRequestBodySchema<Default<Schema[Path][Method]>>>;
 
-/**
- * A static restriction to match intercepted requests.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
 export interface HttpRequestHandlerStaticRestriction<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
   Path extends HttpSchemaPath<Schema, Method>,
 > {
-  /**
-   * A set of headers that the intercepted request must contain to match the handler. If exact is `true`, the request
-   * must contain exactly these headers and no others.
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
   headers?: HttpRequestHandlerHeadersStaticRestriction<Schema, Method, Path>;
 
-  /**
-   * A set of search params that the intercepted request must contain to match the handler. If exact is `true`, the
-   * request must contain exactly these search params and no others.
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
   searchParams?: HttpRequestHandlerSearchParamsStaticRestriction<Schema, Method, Path>;
 
-  /**
-   * The body that the intercepted request must contain to match the handler. If exact is `true`, the request must
-   * contain exactly this body and no other.
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
   body?: HttpRequestHandlerBodyStaticRestriction<Schema, Method, Path>;
 
-  /**
-   * If `true`, the request must contain **exactly** the headers, search params, and body declared in this restriction.
-   * Otherwise, the request must contain **at least** them.
-   */
+  /** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
   exact?: boolean;
 }
 
-/**
- * A computed restriction to match intercepted requests.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
 export type HttpRequestHandlerComputedRestriction<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,
   Path extends HttpSchemaPath<Schema, Method>,
 > = (request: HttpInterceptorRequest<Path, Default<Schema[Path][Method]>>) => PossiblePromise<boolean>;
 
-/**
- * A restriction to match intercepted requests.
- *
- * @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference}
- */
+/** @see {@link https://zimic.dev/docs/interceptor/api/http-request-handler#handlerwithrestriction `handler.with()` API reference} */
 export type HttpRequestHandlerRestriction<
   Schema extends HttpSchema,
   Method extends HttpSchemaMethod<Schema>,