@zimic/interceptor 0.15.0-canary.1 → 0.15.0-canary.3

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/cli/browser/shared/constants.ts","../src/cli/browser/init.ts","../src/utils/processes.ts","../src/cli/server/start.ts","../src/cli/cli.ts","../src/cli/index.ts"],"names":["exitEvent","yargs"],"mappings":"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","file":"cli.mjs","sourcesContent":["{\n  \"name\": \"@zimic/interceptor\",\n  \"description\": \"TypeScript-first HTTP intercepting and mocking\",\n  \"keywords\": [\n    \"zimic\",\n    \"typescript\",\n    \"types\",\n    \"typegen\",\n    \"validation\",\n    \"inference\",\n    \"http\",\n    \"interceptor\",\n    \"mock\",\n    \"api\",\n    \"static\"\n  ],\n  \"version\": \"0.15.0-canary.1\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/zimicjs/zimic.git\",\n    \"directory\": \"packages/zimic-interceptor\"\n  },\n  \"author\": {\n    \"name\": \"Diego Aquino\",\n    \"url\": \"https://github.com/diego-aquino\"\n  },\n  \"private\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"engines\": {\n    \"node\": \">=18.13.0\"\n  },\n  \"license\": \"MIT\",\n  \"files\": [\n    \"package.json\",\n    \"README.md\",\n    \"LICENSE.md\",\n    \"src\",\n    \"!src/**/tests\",\n    \"!src/**/__tests__\",\n    \"!src/**/*.test.ts\",\n    \"dist\",\n    \"index.d.ts\",\n    \"http.d.ts\",\n    \"server.d.ts\"\n  ],\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"types\": \"index.d.ts\",\n  \"bin\": {\n    \"zimic-interceptor\": \"./dist/cli.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./http\": {\n      \"types\": \"./http.d.ts\",\n      \"import\": \"./dist/http.mjs\",\n      \"require\": \"./dist/http.js\",\n      \"default\": \"./dist/http.js\"\n    },\n    \"./server\": {\n      \"types\": \"./server.d.ts\",\n      \"import\": \"./dist/server.mjs\",\n      \"require\": \"./dist/server.js\",\n      \"default\": \"./dist/server.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"cli\": \"node ./dist/cli.js\",\n    \"build\": \"tsup\",\n    \"lint\": \"eslint --cache --no-error-on-unmatched-pattern --no-warn-ignored --fix\",\n    \"lint:turbo\": \"pnpm lint . --max-warnings 0\",\n    \"style\": \"prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache\",\n    \"style:check\": \"pnpm style --check\",\n    \"style:format\": \"pnpm style --write\",\n    \"test\": \"dotenv -v NODE_ENV=test -- vitest\",\n    \"test:turbo\": \"dotenv -v CI=true -- pnpm run test run --coverage\",\n    \"types:check\": \"tsc --noEmit\",\n    \"deps:install-playwright\": \"playwright install chromium\",\n    \"deps:init-msw\": \"msw init ./public --no-save\",\n    \"deps:init\": \"pnpm deps:install-playwright && pnpm deps:init-msw\",\n    \"postinstall\": \"node -e \\\"try{require('./dist/scripts/postinstall')}catch(error){console.error(error)}\\\"\"\n  },\n  \"dependencies\": {\n    \"@whatwg-node/server\": \"0.9.70\",\n    \"chalk\": \"4.1.2\",\n    \"execa\": \"9.5.2\",\n    \"isomorphic-ws\": \"5.0.0\",\n    \"msw\": \"2.7.3\",\n    \"ws\": \"8.18.1\",\n    \"yargs\": \"17.7.2\"\n  },\n  \"optionalDependencies\": {\n    \"bufferutil\": \"4.0.9\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^22.13.8\",\n    \"@types/ws\": \"^8.5.14\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@vitest/browser\": \"^3.0.7\",\n    \"@vitest/coverage-istanbul\": \"^3.0.7\",\n    \"@zimic/eslint-config-node\": \"workspace:*\",\n    \"@zimic/lint-staged-config\": \"workspace:*\",\n    \"@zimic/tsconfig\": \"workspace:*\",\n    \"@zimic/utils\": \"workspace:*\",\n    \"dotenv-cli\": \"^8.0.0\",\n    \"eslint\": \"^9.21.0\",\n    \"playwright\": \"^1.50.1\",\n    \"tsup\": \"^8.4.0\",\n    \"typescript\": \"^5.8.2\",\n    \"vitest\": \"^3.0.7\"\n  },\n  \"peerDependencies\": {\n    \"@zimic/http\": \"^0.1.0 || ^0.1.0-canary.0\",\n    \"typescript\": \">=4.8.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"typescript\": {\n      \"optional\": true\n    }\n  }\n}\n","export const SERVICE_WORKER_FILE_NAME = 'mockServiceWorker.js';\n","import chalk from 'chalk';\nimport filesystem from 'fs/promises';\nimport path from 'path';\n\nimport { logWithPrefix } from '@/utils/console';\n\nimport { SERVICE_WORKER_FILE_NAME } from './shared/constants';\n\nconst MSW_ROOT_PATH = path.join(require.resolve('msw'), '..', '..', '..');\nexport const MOCK_SERVICE_WORKER_PATH = path.join(MSW_ROOT_PATH, 'lib', SERVICE_WORKER_FILE_NAME);\n\ninterface BrowserServiceWorkerInitOptions {\n  publicDirectory: string;\n}\n\nasync function initializeBrowserServiceWorker({ publicDirectory }: BrowserServiceWorkerInitOptions) {\n  const absolutePublicDirectory = path.resolve(publicDirectory);\n  await filesystem.mkdir(absolutePublicDirectory, { recursive: true });\n\n  const destinationPath = path.join(absolutePublicDirectory, SERVICE_WORKER_FILE_NAME);\n  await filesystem.copyFile(MOCK_SERVICE_WORKER_PATH, destinationPath);\n\n  logWithPrefix(`Service worker script saved to ${chalk.green(destinationPath)}!`);\n  logWithPrefix('You can now use browser interceptors!');\n}\n\nexport default initializeBrowserServiceWorker;\n","import createCachedDynamicImport from '@zimic/utils/import/createCachedDynamicImport';\n\nexport const PROCESS_EXIT_EVENTS = Object.freeze([\n  'beforeExit',\n  'uncaughtExceptionMonitor',\n  'SIGINT',\n  'SIGTERM',\n  'SIGHUP',\n  'SIGBREAK',\n] as const);\n\nexport type ProcessExitEvent = (typeof PROCESS_EXIT_EVENTS)[number];\n\n// Having an undefined exit code means that the process will already exit with the default exit code.\nexport const PROCESS_EXIT_CODE_BY_EXIT_EVENT: Record<string, number | undefined> = {\n  beforeExit: undefined,\n  uncaughtExceptionMonitor: undefined,\n  SIGINT: 130,\n  SIGTERM: 143,\n  SIGHUP: 129,\n  SIGBREAK: 131,\n} satisfies Record<ProcessExitEvent, number | undefined>;\n\nexport const importExeca = createCachedDynamicImport(() => import('execa'));\n\ninterface CommandErrorOptions {\n  command?: string[];\n  exitCode?: number;\n  signal?: NodeJS.Signals;\n  originalMessage?: string;\n}\n\nexport class CommandError extends Error {\n  static readonly DEFAULT_EXIT_CODE = 1;\n\n  readonly command: string[];\n  readonly exitCode: number;\n  readonly signal?: NodeJS.Signals;\n\n  constructor(executable: string, options: CommandErrorOptions) {\n    const message = CommandError.createMessage(executable, options);\n    super(message);\n\n    this.name = 'CommandError';\n    this.command = options.command ?? [executable];\n    this.exitCode = this.getExitCode(options);\n    this.signal = options.signal;\n  }\n\n  private getExitCode(options: CommandErrorOptions): number {\n    const existingExitCode = options.exitCode;\n    const exitCodeInferredFromSignal =\n      options.signal === undefined ? undefined : PROCESS_EXIT_CODE_BY_EXIT_EVENT[options.signal];\n\n    return existingExitCode ?? exitCodeInferredFromSignal ?? CommandError.DEFAULT_EXIT_CODE;\n  }\n\n  private static createMessage(command: string, options: CommandErrorOptions) {\n    const suffix = options.originalMessage ? `: ${options.originalMessage}` : '';\n\n    if (options.exitCode === undefined && options.signal === undefined) {\n      return `Command '${command}' failed${suffix}`;\n    }\n\n    const prefix = `Command '${command}' exited `;\n    const infix = options.exitCode === undefined ? `after signal ${options.signal}` : `with code ${options.exitCode}`;\n\n    return `${prefix}${infix}${suffix}`;\n  }\n}\n\nexport async function runCommand(command: string, commandArguments: string[]) {\n  const { execa: $, ExecaError } = await importExeca();\n\n  try {\n    await $(command, commandArguments, { stdio: 'inherit' });\n  } catch (error) {\n    /* istanbul ignore if -- @preserve\n     * This is a safeguard if the error is not an ExecaError. It is not expected to run. */\n    if (!(error instanceof ExecaError)) {\n      throw error;\n    }\n\n    const commandError = new CommandError(command, {\n      command: [command, ...commandArguments],\n      exitCode: error.exitCode,\n      signal: error.signal,\n      originalMessage: error.originalMessage,\n    });\n\n    throw commandError;\n  }\n}\n","import { InterceptorServer, interceptorServer } from '@/server';\nimport { InterceptorServerOptions } from '@/server/types/options';\nimport { logWithPrefix } from '@/utils/console';\nimport {\n  CommandError,\n  PROCESS_EXIT_CODE_BY_EXIT_EVENT,\n  PROCESS_EXIT_EVENTS,\n  ProcessExitEvent,\n  runCommand,\n} from '@/utils/processes';\n\ninterface InterceptorServerStartOptions extends InterceptorServerOptions {\n  ephemeral: boolean;\n  onReady?: {\n    command: string;\n    arguments: string[];\n  };\n}\n\nexport let serverSingleton: InterceptorServer | undefined;\n\nasync function startInterceptorServer({\n  hostname,\n  port,\n  ephemeral,\n  logUnhandledRequests,\n  onReady,\n}: InterceptorServerStartOptions) {\n  const server = interceptorServer.create({\n    hostname,\n    port,\n    logUnhandledRequests,\n  });\n\n  async function handleExitEvent(exitEvent: ProcessExitEvent | undefined) {\n    await server.stop();\n\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    for (const { exitEvent, exitHandler } of exitHandlerGroups) {\n      process.off(exitEvent, exitHandler);\n    }\n\n    const exitCode = exitEvent ? PROCESS_EXIT_CODE_BY_EXIT_EVENT[exitEvent] : undefined;\n    if (exitCode !== undefined) {\n      process.exit(exitCode);\n    }\n  }\n\n  const exitHandlerGroups = PROCESS_EXIT_EVENTS.map((exitEvent) => ({\n    exitEvent,\n    exitHandler: handleExitEvent.bind(null, exitEvent),\n  }));\n\n  for (const { exitEvent, exitHandler } of exitHandlerGroups) {\n    process.on(exitEvent, exitHandler);\n  }\n\n  serverSingleton = server;\n\n  await server.start();\n\n  logWithPrefix(`${ephemeral ? 'Ephemeral s' : 'S'}erver is running on ${server.httpURL}`);\n\n  if (onReady) {\n    try {\n      await runCommand(onReady.command, onReady.arguments);\n    } catch (error) {\n      console.error(error);\n\n      /* istanbul ignore if -- @preserve\n       * A CommandError is always expected here. */\n      if (!(error instanceof CommandError)) {\n        throw error;\n      }\n\n      process.exit(error.exitCode);\n    }\n  }\n\n  if (ephemeral) {\n    await handleExitEvent(undefined);\n    process.exit(0);\n  }\n}\n\nexport default startInterceptorServer;\n","import yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport { version } from '@@/package.json';\n\nimport initializeBrowserServiceWorker from './browser/init';\nimport startInterceptorServer from './server/start';\n\nasync function runCLI() {\n  await yargs(hideBin(process.argv))\n    .scriptName('zimic-interceptor')\n    .version(version)\n    .showHelpOnFail(false)\n    .strict()\n\n    .command('browser', 'Manage your browser mock configuration', (yargs) =>\n      yargs.demandCommand().command(\n        'init <publicDirectory>',\n        'Initialize the browser service worker configuration.',\n        (yargs) =>\n          yargs.positional('publicDirectory', {\n            type: 'string',\n            description: 'The path to the public directory of your application.',\n            demandOption: true,\n          }),\n        async (cliArguments) => {\n          await initializeBrowserServiceWorker({\n            publicDirectory: cliArguments.publicDirectory,\n          });\n        },\n      ),\n    )\n\n    .command('server', 'Manage interceptor servers', (yargs) =>\n      yargs.demandCommand().command(\n        'start [-- onReady]',\n        'Start an interceptor server.',\n        (yargs) =>\n          yargs\n            .positional('onReady', {\n              description: 'A command to run when the server is ready to accept connections.',\n              type: 'string',\n            })\n            .option('hostname', {\n              type: 'string',\n              description: 'The hostname to start the server on.',\n              alias: 'h',\n              default: 'localhost',\n            })\n            .option('port', {\n              type: 'number',\n              description: 'The port to start the server on.',\n              alias: 'p',\n            })\n            .option('ephemeral', {\n              type: 'boolean',\n              description:\n                'Whether the server should stop automatically after the on-ready command finishes. ' +\n                'If no on-ready command is provided and ephemeral is true, the server will stop immediately after ' +\n                'starting.',\n              alias: 'e',\n              default: false,\n            })\n            .option('log-unhandled-requests', {\n              type: 'boolean',\n              description:\n                'Whether to log a warning when no interceptors were found for the base URL of a request. ' +\n                'If an interceptor was matched, the logging behavior for that base URL is configured in the ' +\n                'interceptor itself.',\n              alias: 'l',\n            }),\n        async (cliArguments) => {\n          const onReadyCommand = cliArguments._.at(2)?.toString();\n          const onReadyCommandArguments = cliArguments._.slice(3).map((argument) => argument.toString());\n\n          await startInterceptorServer({\n            hostname: cliArguments.hostname,\n            port: cliArguments.port,\n            ephemeral: cliArguments.ephemeral,\n            logUnhandledRequests: cliArguments.logUnhandledRequests,\n            onReady: onReadyCommand\n              ? {\n                  command: onReadyCommand.toString(),\n                  arguments: onReadyCommandArguments,\n                }\n              : undefined,\n          });\n        },\n      ),\n    )\n\n    .parse();\n}\n\nexport default runCLI;\n","#!/usr/bin/env node\nimport runCLI from './cli';\n\nvoid runCLI();\n"]}
+{"version":3,"sources":["../package.json","../src/cli/browser/shared/constants.ts","../src/cli/browser/init.ts","../src/utils/processes.ts","../src/cli/server/start.ts","../src/cli/cli.ts","../src/cli/index.ts"],"names":["exitEvent","yargs"],"mappings":"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","file":"cli.mjs","sourcesContent":["{\n  \"name\": \"@zimic/interceptor\",\n  \"description\": \"TypeScript-first HTTP intercepting and mocking\",\n  \"keywords\": [\n    \"zimic\",\n    \"typescript\",\n    \"types\",\n    \"typegen\",\n    \"validation\",\n    \"inference\",\n    \"http\",\n    \"interceptor\",\n    \"mock\",\n    \"api\",\n    \"static\"\n  ],\n  \"version\": \"0.15.0-canary.3\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/zimicjs/zimic.git\",\n    \"directory\": \"packages/zimic-interceptor\"\n  },\n  \"author\": {\n    \"name\": \"Diego Aquino\",\n    \"url\": \"https://github.com/diego-aquino\"\n  },\n  \"private\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"engines\": {\n    \"node\": \">=18.13.0\"\n  },\n  \"license\": \"MIT\",\n  \"files\": [\n    \"package.json\",\n    \"README.md\",\n    \"LICENSE.md\",\n    \"src\",\n    \"!src/**/tests\",\n    \"!src/**/__tests__\",\n    \"!src/**/*.test.ts\",\n    \"dist\",\n    \"index.d.ts\",\n    \"http.d.ts\",\n    \"server.d.ts\"\n  ],\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"types\": \"index.d.ts\",\n  \"bin\": {\n    \"zimic-interceptor\": \"./dist/cli.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./http\": {\n      \"types\": \"./http.d.ts\",\n      \"import\": \"./dist/http.mjs\",\n      \"require\": \"./dist/http.js\",\n      \"default\": \"./dist/http.js\"\n    },\n    \"./server\": {\n      \"types\": \"./server.d.ts\",\n      \"import\": \"./dist/server.mjs\",\n      \"require\": \"./dist/server.js\",\n      \"default\": \"./dist/server.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"cli\": \"node ./dist/cli.js\",\n    \"build\": \"tsup\",\n    \"lint\": \"eslint --cache --no-error-on-unmatched-pattern --no-warn-ignored --fix\",\n    \"lint:turbo\": \"pnpm lint . --max-warnings 0\",\n    \"style\": \"prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache\",\n    \"style:check\": \"pnpm style --check\",\n    \"style:format\": \"pnpm style --write\",\n    \"test\": \"dotenv -v NODE_ENV=test -- vitest\",\n    \"test:turbo\": \"dotenv -v CI=true -- pnpm run test run --coverage\",\n    \"types:check\": \"tsc --noEmit\",\n    \"deps:install-playwright\": \"playwright install chromium\",\n    \"deps:init-msw\": \"msw init ./public --no-save\",\n    \"deps:init\": \"pnpm deps:install-playwright && pnpm deps:init-msw\",\n    \"postinstall\": \"node -e \\\"try{require('./dist/scripts/postinstall')}catch(error){console.error(error)}\\\"\"\n  },\n  \"dependencies\": {\n    \"@whatwg-node/server\": \"0.10.1\",\n    \"chalk\": \"4.1.2\",\n    \"execa\": \"9.5.2\",\n    \"isomorphic-ws\": \"5.0.0\",\n    \"msw\": \"2.7.3\",\n    \"ws\": \"8.18.1\",\n    \"yargs\": \"17.7.2\"\n  },\n  \"optionalDependencies\": {\n    \"bufferutil\": \"4.0.9\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^22.13.10\",\n    \"@types/ws\": \"^8.18.0\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@vitest/browser\": \"^3.0.8\",\n    \"@vitest/coverage-istanbul\": \"^3.0.8\",\n    \"@zimic/eslint-config-node\": \"workspace:*\",\n    \"@zimic/lint-staged-config\": \"workspace:*\",\n    \"@zimic/tsconfig\": \"workspace:*\",\n    \"@zimic/utils\": \"workspace:*\",\n    \"dotenv-cli\": \"^8.0.0\",\n    \"eslint\": \"^9.22.0\",\n    \"playwright\": \"^1.51.0\",\n    \"tsup\": \"^8.4.0\",\n    \"typescript\": \"^5.8.2\",\n    \"vitest\": \"^3.0.8\"\n  },\n  \"peerDependencies\": {\n    \"@zimic/http\": \"^0.1.0 || ^0.1.0-canary.0\",\n    \"typescript\": \">=4.8.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"typescript\": {\n      \"optional\": true\n    }\n  }\n}\n","export const SERVICE_WORKER_FILE_NAME = 'mockServiceWorker.js';\n","import chalk from 'chalk';\nimport filesystem from 'fs/promises';\nimport path from 'path';\n\nimport { logWithPrefix } from '@/utils/console';\n\nimport { SERVICE_WORKER_FILE_NAME } from './shared/constants';\n\nconst MSW_ROOT_PATH = path.join(require.resolve('msw'), '..', '..', '..');\nexport const MOCK_SERVICE_WORKER_PATH = path.join(MSW_ROOT_PATH, 'lib', SERVICE_WORKER_FILE_NAME);\n\ninterface BrowserServiceWorkerInitOptions {\n  publicDirectory: string;\n}\n\nasync function initializeBrowserServiceWorker({ publicDirectory }: BrowserServiceWorkerInitOptions) {\n  const absolutePublicDirectory = path.resolve(publicDirectory);\n  await filesystem.mkdir(absolutePublicDirectory, { recursive: true });\n\n  const destinationPath = path.join(absolutePublicDirectory, SERVICE_WORKER_FILE_NAME);\n  await filesystem.copyFile(MOCK_SERVICE_WORKER_PATH, destinationPath);\n\n  logWithPrefix(`Service worker script saved to ${chalk.green(destinationPath)}!`);\n  logWithPrefix('You can now use browser interceptors!');\n}\n\nexport default initializeBrowserServiceWorker;\n","import createCachedDynamicImport from '@zimic/utils/import/createCachedDynamicImport';\n\nexport const PROCESS_EXIT_EVENTS = Object.freeze([\n  'beforeExit',\n  'uncaughtExceptionMonitor',\n  'SIGINT',\n  'SIGTERM',\n  'SIGHUP',\n  'SIGBREAK',\n] as const);\n\nexport type ProcessExitEvent = (typeof PROCESS_EXIT_EVENTS)[number];\n\n// Having an undefined exit code means that the process will already exit with the default exit code.\nexport const PROCESS_EXIT_CODE_BY_EXIT_EVENT: Record<string, number | undefined> = {\n  beforeExit: undefined,\n  uncaughtExceptionMonitor: undefined,\n  SIGINT: 130,\n  SIGTERM: 143,\n  SIGHUP: 129,\n  SIGBREAK: 131,\n} satisfies Record<ProcessExitEvent, number | undefined>;\n\nexport const importExeca = createCachedDynamicImport(() => import('execa'));\n\ninterface CommandErrorOptions {\n  command?: string[];\n  exitCode?: number;\n  signal?: NodeJS.Signals;\n  originalMessage?: string;\n}\n\nexport class CommandError extends Error {\n  static readonly DEFAULT_EXIT_CODE = 1;\n\n  readonly command: string[];\n  readonly exitCode: number;\n  readonly signal?: NodeJS.Signals;\n\n  constructor(executable: string, options: CommandErrorOptions) {\n    const message = CommandError.createMessage(executable, options);\n    super(message);\n\n    this.name = 'CommandError';\n    this.command = options.command ?? [executable];\n    this.exitCode = this.getExitCode(options);\n    this.signal = options.signal;\n  }\n\n  private getExitCode(options: CommandErrorOptions): number {\n    const existingExitCode = options.exitCode;\n    const exitCodeInferredFromSignal =\n      options.signal === undefined ? undefined : PROCESS_EXIT_CODE_BY_EXIT_EVENT[options.signal];\n\n    return existingExitCode ?? exitCodeInferredFromSignal ?? CommandError.DEFAULT_EXIT_CODE;\n  }\n\n  private static createMessage(command: string, options: CommandErrorOptions) {\n    const suffix = options.originalMessage ? `: ${options.originalMessage}` : '';\n\n    if (options.exitCode === undefined && options.signal === undefined) {\n      return `Command '${command}' failed${suffix}`;\n    }\n\n    const prefix = `Command '${command}' exited `;\n    const infix = options.exitCode === undefined ? `after signal ${options.signal}` : `with code ${options.exitCode}`;\n\n    return `${prefix}${infix}${suffix}`;\n  }\n}\n\nexport async function runCommand(command: string, commandArguments: string[]) {\n  const { execa: $, ExecaError } = await importExeca();\n\n  try {\n    await $(command, commandArguments, { stdio: 'inherit' });\n  } catch (error) {\n    /* istanbul ignore if -- @preserve\n     * This is a safeguard if the error is not an ExecaError. It is not expected to run. */\n    if (!(error instanceof ExecaError)) {\n      throw error;\n    }\n\n    const commandError = new CommandError(command, {\n      command: [command, ...commandArguments],\n      exitCode: error.exitCode,\n      signal: error.signal,\n      originalMessage: error.originalMessage,\n    });\n\n    throw commandError;\n  }\n}\n","import { InterceptorServer, interceptorServer } from '@/server';\nimport { InterceptorServerOptions } from '@/server/types/options';\nimport { logWithPrefix } from '@/utils/console';\nimport {\n  CommandError,\n  PROCESS_EXIT_CODE_BY_EXIT_EVENT,\n  PROCESS_EXIT_EVENTS,\n  ProcessExitEvent,\n  runCommand,\n} from '@/utils/processes';\n\ninterface InterceptorServerStartOptions extends InterceptorServerOptions {\n  ephemeral: boolean;\n  onReady?: {\n    command: string;\n    arguments: string[];\n  };\n}\n\nexport let serverSingleton: InterceptorServer | undefined;\n\nasync function startInterceptorServer({\n  hostname,\n  port,\n  ephemeral,\n  logUnhandledRequests,\n  onReady,\n}: InterceptorServerStartOptions) {\n  const server = interceptorServer.create({\n    hostname,\n    port,\n    logUnhandledRequests,\n  });\n\n  async function handleExitEvent(exitEvent: ProcessExitEvent | undefined) {\n    await server.stop();\n\n    // eslint-disable-next-line @typescript-eslint/no-use-before-define\n    for (const { exitEvent, exitHandler } of exitHandlerGroups) {\n      process.off(exitEvent, exitHandler);\n    }\n\n    const exitCode = exitEvent ? PROCESS_EXIT_CODE_BY_EXIT_EVENT[exitEvent] : undefined;\n    if (exitCode !== undefined) {\n      process.exit(exitCode);\n    }\n  }\n\n  const exitHandlerGroups = PROCESS_EXIT_EVENTS.map((exitEvent) => ({\n    exitEvent,\n    exitHandler: handleExitEvent.bind(null, exitEvent),\n  }));\n\n  for (const { exitEvent, exitHandler } of exitHandlerGroups) {\n    process.on(exitEvent, exitHandler);\n  }\n\n  serverSingleton = server;\n\n  await server.start();\n\n  logWithPrefix(`${ephemeral ? 'Ephemeral s' : 'S'}erver is running on ${server.hostname}:${server.port}`);\n\n  if (onReady) {\n    try {\n      await runCommand(onReady.command, onReady.arguments);\n    } catch (error) {\n      console.error(error);\n\n      /* istanbul ignore if -- @preserve\n       * A CommandError is always expected here. */\n      if (!(error instanceof CommandError)) {\n        throw error;\n      }\n\n      process.exit(error.exitCode);\n    }\n  }\n\n  if (ephemeral) {\n    await handleExitEvent(undefined);\n    process.exit(0);\n  }\n}\n\nexport default startInterceptorServer;\n","import yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport { version } from '@@/package.json';\n\nimport initializeBrowserServiceWorker from './browser/init';\nimport startInterceptorServer from './server/start';\n\nasync function runCLI() {\n  await yargs(hideBin(process.argv))\n    .scriptName('zimic-interceptor')\n    .version(version)\n    .showHelpOnFail(false)\n    .strict()\n\n    .command('browser', 'Manage your browser mock configuration', (yargs) =>\n      yargs.demandCommand().command(\n        'init <publicDirectory>',\n        'Initialize the browser service worker configuration.',\n        (yargs) =>\n          yargs.positional('publicDirectory', {\n            type: 'string',\n            description: 'The path to the public directory of your application.',\n            demandOption: true,\n          }),\n        async (cliArguments) => {\n          await initializeBrowserServiceWorker({\n            publicDirectory: cliArguments.publicDirectory,\n          });\n        },\n      ),\n    )\n\n    .command('server', 'Manage interceptor servers', (yargs) =>\n      yargs.demandCommand().command(\n        'start [-- onReady]',\n        'Start an interceptor server.',\n        (yargs) =>\n          yargs\n            .positional('onReady', {\n              description: 'A command to run when the server is ready to accept connections.',\n              type: 'string',\n            })\n            .option('hostname', {\n              type: 'string',\n              description: 'The hostname to start the server on.',\n              alias: 'h',\n              default: 'localhost',\n            })\n            .option('port', {\n              type: 'number',\n              description: 'The port to start the server on.',\n              alias: 'p',\n            })\n            .option('ephemeral', {\n              type: 'boolean',\n              description:\n                'Whether the server should stop automatically after the on-ready command finishes. ' +\n                'If no on-ready command is provided and ephemeral is true, the server will stop immediately after ' +\n                'starting.',\n              alias: 'e',\n              default: false,\n            })\n            .option('log-unhandled-requests', {\n              type: 'boolean',\n              description:\n                'Whether to log a warning when no interceptors were found for the base URL of a request. ' +\n                'If an interceptor was matched, the logging behavior for that base URL is configured in the ' +\n                'interceptor itself.',\n              alias: 'l',\n            }),\n        async (cliArguments) => {\n          const onReadyCommand = cliArguments._.at(2)?.toString();\n          const onReadyCommandArguments = cliArguments._.slice(3).map((argument) => argument.toString());\n\n          await startInterceptorServer({\n            hostname: cliArguments.hostname,\n            port: cliArguments.port,\n            ephemeral: cliArguments.ephemeral,\n            logUnhandledRequests: cliArguments.logUnhandledRequests,\n            onReady: onReadyCommand\n              ? {\n                  command: onReadyCommand.toString(),\n                  arguments: onReadyCommandArguments,\n                }\n              : undefined,\n          });\n        },\n      ),\n    )\n\n    .parse();\n}\n\nexport default runCLI;\n","#!/usr/bin/env node\nimport runCLI from './cli';\n\nvoid runCLI();\n"]}

package/dist/http.d.ts

@@ -1,4 +1,4 @@
-import { HttpMethodSchema, HttpStatusCode, HttpRequest, HttpHeaders, HttpRequestHeadersSchema, InferPathParams, HttpSearchParams, HttpRequestSearchParamsSchema, HttpRequestBodySchema, HttpResponse, HttpResponseHeadersSchema, HttpResponseBodySchema, HttpResponseSchema, HttpHeadersInit, HttpSchema, HttpBody, HttpSchemaMethod, HttpSchemaPath, HttpHeadersSchema, HttpSearchParamsSchema, HttpFormData, HttpResponseSchemaStatusCode, HttpMethod, LiteralHttpSchemaPathFromNonLiteral } from '@zimic/http';
+import { HttpMethodSchema, HttpRequest, HttpHeaders, HttpRequestHeadersSchema, InferPathParams, HttpSearchParams, HttpRequestSearchParamsSchema, HttpRequestBodySchema, HttpStatusCode, HttpResponseSchema, HttpHeadersInit, HttpResponse, HttpResponseHeadersSchema, HttpResponseBodySchema, HttpSchema, HttpBody, HttpSchemaMethod, HttpSchemaPath, HttpHeadersSchema, HttpSearchParamsSchema, HttpFormData, HttpResponseSchemaStatusCode, HttpMethod, LiteralHttpSchemaPathFromNonLiteral } from '@zimic/http';
 
 type Default<Type, IfEmpty = never> = [undefined | void] extends [Type] ? IfEmpty : Exclude<Type, undefined | void>;
 type IfNever<Type, Yes, No = Type> = [Type] extends [never] ? Yes : No;
@@ -185,18 +185,16 @@ interface SharedHttpInterceptorOptions {
      * {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}. It may include
      * additional paths to differentiate between conflicting mocks.
      */
-    baseURL: string | URL;
+    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**: Saving the intercepted requests will lead to a memory leak if not accompanied by clearing of the
-     * interceptor or disposal of the handlers (i.e. garbage collection). If you plan on accessing those requests, such as
-     * to assert them in your tests, set this option to `true` and make sure to regularly clear the interceptor. A common
-     * practice is to call
+     * **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. This prevents leaking memory from the accumulated requests.
+     * after each test.
      *
      * @default false
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
@@ -334,16 +332,18 @@ interface HttpRequestHandler<Schema extends HttpSchema, Method extends HttpSchem
     /**
      * The method that matches this handler.
      *
+     * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlermethod `handler.method` API reference}
      */
-    method: Method;
+    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://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerpath `handler.path` API reference}
      */
-    path: Path;
+    get path(): Path;
 }
 /**
  * A local HTTP request handler to declare responses for intercepted requests. In a local handler, the mocking
@@ -356,7 +356,8 @@ interface HttpRequestHandler<Schema extends HttpSchema, Method extends HttpSchem
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler` API reference}
  */
 interface LocalHttpRequestHandler<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>, StatusCode extends HttpStatusCode = never> extends HttpRequestHandler<Schema, Method, Path> {
-    readonly type: 'local';
+    /** @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
@@ -456,9 +457,10 @@ interface LocalHttpRequestHandler<Schema extends HttpSchema, Method extends Http
      * for more information.
      *
      * @throws {DisabledRequestSavingError} If the interceptor was not created with `saveRequests: true`.
+     * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests` API reference}
      */
-    requests: readonly InterceptedHttpInterceptorRequest<Path, Default<Schema[Path][Method]>, StatusCode>[];
+    get requests(): readonly InterceptedHttpInterceptorRequest<Path, Default<Schema[Path][Method]>, StatusCode>[];
 }
 /**
  * A synced remote HTTP request handler. When a remote handler is synced, it is guaranteed that all of the mocking
@@ -468,7 +470,8 @@ interface LocalHttpRequestHandler<Schema extends HttpSchema, Method extends Http
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler` API reference}
  */
 interface SyncedRemoteHttpRequestHandler<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>, StatusCode extends HttpStatusCode = never> extends HttpRequestHandler<Schema, Method, Path> {
-    readonly type: 'remote';
+    /** @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
@@ -569,9 +572,10 @@ interface SyncedRemoteHttpRequestHandler<Schema extends HttpSchema, Method exten
      * for more information.
      *
      * @throws {DisabledRequestSavingError} If the interceptor was not created with `saveRequests: true`.
+     * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests` API reference}
      */
-    requests: readonly InterceptedHttpInterceptorRequest<Path, Default<Schema[Path][Method]>, StatusCode>[];
+    get requests(): readonly InterceptedHttpInterceptorRequest<Path, Default<Schema[Path][Method]>, StatusCode>[];
 }
 /**
  * A pending remote HTTP request handler. When a remote handler is pending, it is not guaranteed that all of the mocking
@@ -629,18 +633,35 @@ interface HttpInterceptor<_Schema extends HttpSchema> {
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorbaseurl `interceptor.baseURL` API reference}
      */
     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.
+     *
+     * @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;
     /**
      * The platform the interceptor is running on.
      *
+     * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorplatform `interceptor.platform` API reference}
      */
-    platform: HttpInterceptorPlatform | null;
+    get platform(): HttpInterceptorPlatform | null;
     /**
      * Whether the interceptor is currently running and ready to use.
      *
+     * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorisrunning `interceptor.isRunning` API reference}
      */
-    isRunning: boolean;
+    get isRunning(): boolean;
     /**
      * Starts the interceptor, allowing it to intercept HTTP requests.
      *
@@ -692,7 +713,7 @@ interface HttpInterceptor<_Schema extends HttpSchema> {
      *
      * This method is useful to reset the interceptor mocks between tests.
      *
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()` API reference}
      */
     clear: (() => void) | (() => Promise<void>);
@@ -707,7 +728,16 @@ interface HttpInterceptor<_Schema extends HttpSchema> {
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptor `HttpInterceptor` API reference}
  */
 interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpInterceptor<Schema> {
-    readonly type: 'local';
+    /** @readonly */
+    get type(): 'local';
+    /**
+     * The strategy to use for unhandled requests. If a request starts with the base URL of the interceptor, but no
+     * matching handler exists, this strategy will be used. If a function is provided, it will be called with the
+     * unhandled request.
+     *
+     * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#unhandled-requests Unhandled requests}
+     */
+    onUnhandledRequest: UnhandledRequestStrategy.Local | undefined;
     /**
      * Creates a GET
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`} for
@@ -729,7 +759,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns A GET
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     get: SyncHttpInterceptorMethodHandler<Schema, 'GET'>;
@@ -754,7 +784,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns A POST
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     post: SyncHttpInterceptorMethodHandler<Schema, 'POST'>;
@@ -779,7 +809,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns A PATCH
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     patch: SyncHttpInterceptorMethodHandler<Schema, 'PATCH'>;
@@ -804,7 +834,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns A PUT
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     put: SyncHttpInterceptorMethodHandler<Schema, 'PUT'>;
@@ -829,7 +859,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns A DELETE
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     delete: SyncHttpInterceptorMethodHandler<Schema, 'DELETE'>;
@@ -854,7 +884,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns A HEAD
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     head: SyncHttpInterceptorMethodHandler<Schema, 'HEAD'>;
@@ -879,7 +909,7 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
      * @returns An OPTIONS
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     options: SyncHttpInterceptorMethodHandler<Schema, 'OPTIONS'>;
@@ -898,7 +928,16 @@ interface LocalHttpInterceptor<Schema extends HttpSchema> extends HttpIntercepto
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptor `HttpInterceptor` API reference}
  */
 interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpInterceptor<Schema> {
-    readonly type: 'remote';
+    /** @readonly */
+    get type(): 'remote';
+    /**
+     * The strategy to use for unhandled requests. If a request starts with the base URL of the interceptor, but no
+     * matching handler exists, this strategy will be used. If a function is provided, it will be called with the
+     * unhandled request.
+     *
+     * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#unhandled-requests Unhandled requests}
+     */
+    onUnhandledRequest: UnhandledRequestStrategy.Remote | undefined;
     /**
      * Creates a GET
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`} for
@@ -925,7 +964,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns A GET
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     get: AsyncHttpInterceptorMethodHandler<Schema, 'GET'>;
@@ -955,7 +994,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns A POST
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     post: AsyncHttpInterceptorMethodHandler<Schema, 'POST'>;
@@ -985,7 +1024,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns A PATCH
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     patch: AsyncHttpInterceptorMethodHandler<Schema, 'PATCH'>;
@@ -1015,7 +1054,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns A PUT
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     put: AsyncHttpInterceptorMethodHandler<Schema, 'PUT'>;
@@ -1045,7 +1084,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns A DELETE
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     delete: AsyncHttpInterceptorMethodHandler<Schema, 'DELETE'>;
@@ -1075,7 +1114,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns A HEAD
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     head: AsyncHttpInterceptorMethodHandler<Schema, 'HEAD'>;
@@ -1105,7 +1144,7 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
      * @returns An OPTIONS
      *   {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler `HttpRequestHandler`}
      *   for the provided path. The path and method must be declared in the interceptor schema.
-     * @throws {NotStartedHttpInterceptorError} If the interceptor is not running.
+     * @throws {NotRunningHttpInterceptorError} If the interceptor is not running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptormethodpath `interceptor.<method>(path)` API reference}
      */
     options: AsyncHttpInterceptorMethodHandler<Schema, 'OPTIONS'>;
@@ -1196,6 +1235,17 @@ declare class InvalidFormDataError extends SyntaxError {
     constructor(value: string);
 }
 
+/**
+ * An error thrown when the interceptor is running and some operation requires it to be stopped first.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorstart `interceptor.start()` API reference}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorstop `interceptor.stop()` API reference}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorisrunning `interceptor.isRunning` API reference}
+ */
+declare class RunningHttpInterceptorError extends Error {
+    constructor(additionalMessage: string);
+}
+
 /**
  * An error thrown when the interceptor is not running and it's not possible to use the mocking utilities.
  *
@@ -1203,7 +1253,7 @@ declare class InvalidFormDataError extends SyntaxError {
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorstop `interceptor.stop()` API reference}
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorisrunning `interceptor.isRunning` API reference}
  */
-declare class NotStartedHttpInterceptorError extends Error {
+declare class NotRunningHttpInterceptorError extends Error {
     constructor();
 }
 
@@ -1287,12 +1337,6 @@ declare class TimesCheckError extends TypeError {
  */
 type InferHttpInterceptorSchema<Interceptor> = Interceptor extends LocalHttpInterceptor<infer Schema> ? Schema : Interceptor extends RemoteHttpInterceptor<infer Schema> ? Schema : never;
 
-/**
- * @deprecated This type was renamed to {@link InterceptedHttpInterceptorRequest `InterceptedHttpInterceptorRequest`}.
- *   Please use it instead.
- */
-type TrackedHttpInterceptorRequest<Path extends string, MethodSchema extends HttpMethodSchema, StatusCode extends HttpStatusCode = never> = InterceptedHttpInterceptorRequest<Path, MethodSchema, StatusCode>;
-
 /**
  * A namespace of interceptor resources for mocking HTTP requests.
  *
@@ -1300,4 +1344,4 @@ type TrackedHttpInterceptorRequest<Path extends string, MethodSchema extends Htt
  */
 declare const httpInterceptor: Readonly<HttpInterceptorNamespace>;
 
-export { DisabledRequestSavingError, type HttpInterceptor, HttpInterceptorNamespace, HttpInterceptorNamespaceDefault, type HttpInterceptorOptions, type HttpInterceptorPlatform, type HttpInterceptorRequest, type HttpInterceptorResponse, type HttpInterceptorType, type HttpRequestHandler, type HttpRequestHandlerBodyStaticRestriction, type HttpRequestHandlerComputedRestriction, type HttpRequestHandlerHeadersStaticRestriction, type HttpRequestHandlerResponseDeclaration, type HttpRequestHandlerResponseDeclarationFactory, type HttpRequestHandlerRestriction, type HttpRequestHandlerSearchParamsStaticRestriction, type HttpRequestHandlerStaticRestriction, type InferHttpInterceptorSchema, type InterceptedHttpInterceptorRequest, InvalidFormDataError, InvalidJSONError, type LocalHttpInterceptor, type LocalHttpInterceptorOptions, type LocalHttpRequestHandler, NotStartedHttpInterceptorError, type PendingRemoteHttpRequestHandler, type RemoteHttpInterceptor, type RemoteHttpInterceptorOptions, type RemoteHttpRequestHandler, type SyncedRemoteHttpRequestHandler, TimesCheckError, type TrackedHttpInterceptorRequest, type UnhandledHttpInterceptorRequest, UnhandledRequestStrategy, UnknownHttpInterceptorPlatformError, UnknownHttpInterceptorTypeError, UnregisteredBrowserServiceWorkerError, httpInterceptor };
+export { DisabledRequestSavingError, type HttpInterceptor, HttpInterceptorNamespace, HttpInterceptorNamespaceDefault, type HttpInterceptorOptions, type HttpInterceptorPlatform, type HttpInterceptorRequest, type HttpInterceptorResponse, type HttpInterceptorType, type HttpRequestHandler, type HttpRequestHandlerBodyStaticRestriction, type HttpRequestHandlerComputedRestriction, type HttpRequestHandlerHeadersStaticRestriction, type HttpRequestHandlerResponseDeclaration, type HttpRequestHandlerResponseDeclarationFactory, type HttpRequestHandlerRestriction, type HttpRequestHandlerSearchParamsStaticRestriction, type HttpRequestHandlerStaticRestriction, type InferHttpInterceptorSchema, type InterceptedHttpInterceptorRequest, InvalidFormDataError, InvalidJSONError, type LocalHttpInterceptor, type LocalHttpInterceptorOptions, type LocalHttpRequestHandler, NotRunningHttpInterceptorError, type PendingRemoteHttpRequestHandler, type RemoteHttpInterceptor, type RemoteHttpInterceptorOptions, type RemoteHttpRequestHandler, RunningHttpInterceptorError, type SyncedRemoteHttpRequestHandler, TimesCheckError, type UnhandledHttpInterceptorRequest, UnhandledRequestStrategy, UnknownHttpInterceptorPlatformError, UnknownHttpInterceptorTypeError, UnregisteredBrowserServiceWorkerError, httpInterceptor };