msw-fetch-mock 0.3.3 → 0.4.0

package/README.md

@@ -4,16 +4,18 @@
 [![npm version](https://img.shields.io/npm/v/msw-fetch-mock.svg)](https://www.npmjs.com/package/msw-fetch-mock)
 [![license](https://img.shields.io/npm/l/msw-fetch-mock.svg)](https://github.com/recca0120/msw-fetch-mock/blob/main/LICENSE.md)
 
+[English](README.md) | [繁體中文](README.zh-TW.md)
+
 Undici-style fetch mock API built on [MSW](https://mswjs.io/) (Mock Service Worker).
 
 If you're familiar with Cloudflare Workers' `fetchMock` (from `cloudflare:test`) or Node.js undici's `MockAgent`, you already know this API.
 
-Supports both **Node.js** (`msw/node`) and **Browser** (`msw/browser`) environments via subpath exports.
+Supports **Node.js** (`msw/node`), **Browser** (`msw/browser`), and **Native** (no MSW dependency) environments via subpath exports.
 
 ## Requirements
 
 - **Node.js** >= 18
-- **MSW** ^1.0.0 (via `/legacy`) or ^2.12.7
+- **MSW** ^1.0.0 (via `/legacy`) or ^2.12.7 — **optional** when using `/native`
 
 ## Install
 
@@ -23,12 +25,18 @@ npm install -D msw-fetch-mock msw
 
 `msw` is a peer dependency — you provide your own version.
 
+For MSW-free usage (patches `globalThis.fetch` directly):
+
+```bash
+npm install -D msw-fetch-mock
+```
+
 ## Quick Start
 
 ### Node.js (Vitest, Jest)
 
 ```typescript
-// Works with default import or explicit /node subpath
+// Works with root import or explicit /node subpath
 import { fetchMock } from 'msw-fetch-mock';
 // import { fetchMock } from 'msw-fetch-mock/node';
 
@@ -78,11 +86,10 @@ If you already use MSW, pass your server to share a single interceptor:
 ```typescript
 import { setupServer } from 'msw/node';
 import { http, HttpResponse } from 'msw';
-import { FetchMock } from 'msw-fetch-mock';
-import { NodeMswAdapter } from 'msw-fetch-mock/node';
+import { createFetchMock } from 'msw-fetch-mock';
 
 const server = setupServer(http.get('/api/users', () => HttpResponse.json([{ id: 1 }])));
-const fetchMock = new FetchMock(new NodeMswAdapter(server));
+const fetchMock = createFetchMock(server);
 
 beforeAll(() => server.listen());
 afterAll(() => server.close());
@@ -92,7 +99,26 @@ afterEach(() => {
 });
 ```
 
-> **Note:** Only one MSW server can be active at a time. If another server is already listening, standalone `activate()` will throw an error guiding you to use `new FetchMock(new NodeMswAdapter(server))` instead.
+> **Note:** Only one MSW server can be active at a time. If a server is already listening, standalone `activate()` will throw an error. Use `createFetchMock(server)` to share an existing server.
+
+### Native (no MSW dependency)
+
+For environments where you don't want to install MSW, the `/native` subpath patches `globalThis.fetch` directly:
+
+```typescript
+import { fetchMock } from 'msw-fetch-mock/native';
+
+beforeAll(async () => {
+  await fetchMock.activate({ onUnhandledRequest: 'error' });
+});
+afterAll(() => fetchMock.deactivate());
+afterEach(() => {
+  fetchMock.assertNoPendingInterceptors();
+  fetchMock.reset();
+});
+```
+
+The API is identical — only the underlying transport changes (no Service Worker, no MSW server).
 
 ### Legacy (MSW v1)
 
@@ -144,12 +170,13 @@ fetchMock.activate({
 
 ### Import Paths
 
-| Path                     | Environment                  | MSW version |
-| ------------------------ | ---------------------------- | ----------- |
-| `msw-fetch-mock`         | Node.js (re-exports `/node`) | v2          |
-| `msw-fetch-mock/node`    | Node.js                      | v2          |
-| `msw-fetch-mock/browser` | Browser                      | v2          |
-| `msw-fetch-mock/legacy`  | Node.js (MSW v1)             | v1          |
+| Path                     | Environment                  | MSW version  |
+| ------------------------ | ---------------------------- | ------------ |
+| `msw-fetch-mock`         | Node.js (re-exports `/node`) | v2           |
+| `msw-fetch-mock/node`    | Node.js                      | v2           |
+| `msw-fetch-mock/browser` | Browser                      | v2           |
+| `msw-fetch-mock/native`  | Any (no MSW)                 | not required |
+| `msw-fetch-mock/legacy`  | Node.js (MSW v1)             | v1           |
 
 ### `fetchMock` (singleton)
 
@@ -162,11 +189,12 @@ Factory function that creates a `FetchMock` with the appropriate adapter.
 
 - Node: `createFetchMock(server?)` — optionally pass an existing MSW `SetupServer`
 - Browser: `createFetchMock(worker)` — pass an MSW `SetupWorker` (required)
+- Native: `createFetchMock()` — no arguments, no MSW dependency
 - Legacy: `createFetchMock(rest, server?)` — pass MSW v1 `rest` object
 
 ### `new FetchMock(adapter?)`
 
-Creates a `FetchMock` instance with an explicit `MswAdapter`. Use `NodeMswAdapter` or `BrowserMswAdapter`.
+Creates a `FetchMock` instance with an explicit `MswAdapter`. Use `NodeMswAdapter`, `BrowserMswAdapter`, or `NativeFetchAdapter`.
 
 ### Intercepting & Replying
 
@@ -204,6 +232,9 @@ E2E tests run on every CI push across these environments:
 | Jest CJS       | CJS (require) | Jest                |
 | Node.js Test   | ESM (import)  | Node test runner    |
 | Node.js CJS    | CJS (require) | Node test runner    |
+| Native ESM     | ESM (import)  | Node test runner    |
+| Native CJS     | CJS (require) | Node test runner    |
+| Legacy CJS     | CJS (require) | Jest (MSW v1)       |
 | Vitest Browser | ESM (import)  | Vitest + Playwright |
 
 ## Documentation
@@ -236,7 +267,7 @@ pnpm test:e2e -- node-cjs
 pnpm test:e2e -- --all
 ```
 
-Available suites: `jest-esm`, `jest-cjs`, `node-test`, `node-cjs`, `vitest-browser`
+Available suites: `jest-esm`, `jest-cjs`, `node-test`, `node-cjs`, `native-esm`, `native-cjs`, `legacy-cjs`, `vitest-browser`
 
 ## License
 

package/README.zh-TW.md

@@ -0,0 +1,274 @@
+# msw-fetch-mock
+
+[![CI](https://github.com/recca0120/msw-fetch-mock/actions/workflows/ci.yml/badge.svg)](https://github.com/recca0120/msw-fetch-mock/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/msw-fetch-mock.svg)](https://www.npmjs.com/package/msw-fetch-mock)
+[![license](https://img.shields.io/npm/l/msw-fetch-mock.svg)](https://github.com/recca0120/msw-fetch-mock/blob/main/LICENSE.md)
+
+[English](README.md) | [繁體中文](README.zh-TW.md)
+
+基於 [MSW](https://mswjs.io/)（Mock Service Worker）的 Undici 風格 fetch mock API。
+
+如果你熟悉 Cloudflare Workers 的 `fetchMock`（來自 `cloudflare:test`）或 Node.js undici 的 `MockAgent`，你已經會使用這個 API 了。
+
+透過 subpath exports 支援 **Node.js**（`msw/node`）、**瀏覽器**（`msw/browser`）和**原生**（無 MSW 依賴）環境。
+
+## 系統需求
+
+- **Node.js** >= 18
+- **MSW** ^1.0.0（透過 `/legacy`）或 ^2.12.7 — 使用 `/native` 時**可選**
+
+## 安裝
+
+```bash
+npm install -D msw-fetch-mock msw
+```
+
+`msw` 是 peer dependency — 需要自行安裝你的版本。
+
+若不需要 MSW（直接 patch `globalThis.fetch`）：
+
+```bash
+npm install -D msw-fetch-mock
+```
+
+## 快速開始
+
+### Node.js（Vitest、Jest）
+
+```typescript
+// 可使用根路徑匯入或明確的 /node 子路徑
+import { fetchMock } from 'msw-fetch-mock';
+// import { fetchMock } from 'msw-fetch-mock/node';
+
+beforeAll(() => fetchMock.activate({ onUnhandledRequest: 'error' }));
+afterAll(() => fetchMock.deactivate());
+afterEach(() => {
+  fetchMock.assertNoPendingInterceptors();
+  fetchMock.reset();
+});
+
+it('模擬 GET 請求', async () => {
+  fetchMock
+    .get('https://api.example.com')
+    .intercept({ path: '/users', method: 'GET' })
+    .reply(200, { users: [{ id: '1', name: 'Alice' }] });
+
+  const res = await fetch('https://api.example.com/users');
+  const data = await res.json();
+
+  expect(data.users).toHaveLength(1);
+});
+```
+
+### 瀏覽器（Storybook、Vitest Browser Mode）
+
+```typescript
+import { setupWorker } from 'msw/browser';
+import { createFetchMock } from 'msw-fetch-mock/browser';
+
+const worker = setupWorker();
+const fetchMock = createFetchMock(worker);
+
+beforeAll(async () => {
+  await fetchMock.activate({ onUnhandledRequest: 'error' });
+});
+afterAll(() => fetchMock.deactivate());
+afterEach(() => {
+  fetchMock.assertNoPendingInterceptors();
+  fetchMock.reset();
+});
+```
+
+### 搭配現有的 MSW server
+
+如果你已經在使用 MSW，可以傳入你的 server 來共用同一個攔截器：
+
+```typescript
+import { setupServer } from 'msw/node';
+import { http, HttpResponse } from 'msw';
+import { createFetchMock } from 'msw-fetch-mock';
+
+const server = setupServer(http.get('/api/users', () => HttpResponse.json([{ id: 1 }])));
+const fetchMock = createFetchMock(server);
+
+beforeAll(() => server.listen());
+afterAll(() => server.close());
+afterEach(() => {
+  server.resetHandlers();
+  fetchMock.assertNoPendingInterceptors();
+});
+```
+
+> **注意：** 同一時間只能有一個 MSW server 處於啟動狀態。如果已有 server 在監聽中，獨立模式的 `activate()` 會拋出錯誤。請使用 `createFetchMock(server)` 來共用現有的 server。
+
+### 原生模式（無 MSW 依賴）
+
+若不想安裝 MSW，`/native` 子路徑會直接 patch `globalThis.fetch`：
+
+```typescript
+import { fetchMock } from 'msw-fetch-mock/native';
+
+beforeAll(async () => {
+  await fetchMock.activate({ onUnhandledRequest: 'error' });
+});
+afterAll(() => fetchMock.deactivate());
+afterEach(() => {
+  fetchMock.assertNoPendingInterceptors();
+  fetchMock.reset();
+});
+```
+
+API 完全相同 — 只有底層傳輸方式不同（無 Service Worker、無 MSW server）。
+
+### Legacy（MSW v1）
+
+```typescript
+import { rest } from 'msw';
+import { setupServer } from 'msw/node';
+import { createFetchMock } from 'msw-fetch-mock/legacy';
+
+const server = setupServer();
+const fetchMock = createFetchMock(rest, server);
+
+beforeAll(() => fetchMock.activate());
+afterAll(() => fetchMock.deactivate());
+afterEach(() => {
+  fetchMock.assertNoPendingInterceptors();
+  fetchMock.reset();
+});
+```
+
+詳見 [MSW v1 Legacy 指南](docs/msw-v1-legacy.zh-TW.md)。
+
+## 未處理的請求
+
+預設情況下 `activate()` 使用 `'error'` 模式 — 未匹配的請求會導致 `fetch()` 拒絕。這包含對**已消耗**攔截器的請求（一次性攔截器使用後，其 handler 會從 MSW 中移除）。
+
+```typescript
+// 拒絕未匹配的請求（預設行為）
+fetchMock.activate();
+fetchMock.activate({ onUnhandledRequest: 'error' });
+
+// 記錄警告但允許通過
+fetchMock.activate({ onUnhandledRequest: 'warn' });
+
+// 靜默允許通過
+fetchMock.activate({ onUnhandledRequest: 'bypass' });
+
+// 自訂回呼
+fetchMock.activate({
+  onUnhandledRequest: (request, print) => {
+    if (request.url.includes('/health')) return; // 忽略
+    print.error(); // 阻擋其他所有請求
+  },
+});
+```
+
+> `enableNetConnect()` 的優先順序高於 `onUnhandledRequest` — 允許的主機一律直接通過。
+
+## API 概覽
+
+### 匯入路徑
+
+| 路徑                     | 環境                          | MSW 版本 |
+| ------------------------ | ----------------------------- | -------- |
+| `msw-fetch-mock`         | Node.js（re-exports `/node`） | v2       |
+| `msw-fetch-mock/node`    | Node.js                       | v2       |
+| `msw-fetch-mock/browser` | 瀏覽器                        | v2       |
+| `msw-fetch-mock/native`  | 任何環境（無 MSW）            | 不需要   |
+| `msw-fetch-mock/legacy`  | Node.js（MSW v1）             | v1       |
+
+### `fetchMock`（單例）
+
+預先建立的 `FetchMock` 實例，適用於獨立使用。匯入後直接呼叫 `activate()` 即可 — 無需額外設定。
+可從 `msw-fetch-mock` 和 `msw-fetch-mock/node` 匯入。
+
+### `createFetchMock(server?)` / `createFetchMock(worker)`
+
+建立 `FetchMock` 的工廠函式，會自動搭配對應的 adapter。
+
+- Node：`createFetchMock(server?)` — 可選擇性傳入現有的 MSW `SetupServer`
+- 瀏覽器：`createFetchMock(worker)` — 傳入 MSW `SetupWorker`（必要）
+- 原生：`createFetchMock()` — 無需參數，無 MSW 依賴
+- Legacy：`createFetchMock(rest, server?)` — 傳入 MSW v1 的 `rest` 物件
+
+### `new FetchMock(adapter?)`
+
+使用明確的 `MswAdapter` 建立 `FetchMock` 實例。可使用 `NodeMswAdapter`、`BrowserMswAdapter` 或 `NativeFetchAdapter`。
+
+### 攔截與回應
+
+```typescript
+fetchMock
+  .get(origin)                              // string、RegExp 或 function
+  .intercept({ path, method, headers, body, query })  // 匹配條件
+  .reply(status, body, options)             // 定義回應
+  .times(n) / .persist();                   // 重複控制
+```
+
+### 呼叫歷史
+
+```typescript
+fetchMock.calls.lastCall(); // 最近一次
+fetchMock.calls.firstCall(); // 最早一次
+fetchMock.calls.nthCall(2); // 第 2 次呼叫（1-indexed）
+fetchMock.calls.filterCalls({ method: 'POST', path: '/users' }, { operator: 'AND' });
+```
+
+### 斷言與清理
+
+```typescript
+fetchMock.assertNoPendingInterceptors(); // 若有未消耗的攔截器則拋出錯誤
+fetchMock.reset(); // 清除攔截器 + 呼叫歷史 + handlers
+```
+
+## 測試環境
+
+每次 CI 推送都會在以下環境執行 E2E 測試：
+
+| 環境           | 模組系統      | 測試框架            |
+| -------------- | ------------- | ------------------- |
+| Jest ESM       | ESM (import)  | Jest                |
+| Jest CJS       | CJS (require) | Jest                |
+| Node.js Test   | ESM (import)  | Node test runner    |
+| Node.js CJS    | CJS (require) | Node test runner    |
+| Native ESM     | ESM (import)  | Node test runner    |
+| Native CJS     | CJS (require) | Node test runner    |
+| Legacy CJS     | CJS (require) | Jest (MSW v1)       |
+| Vitest Browser | ESM (import)  | Vitest + Playwright |
+
+## 文件
+
+- [API 參考](docs/api.zh-TW.md) — 完整的 API 細節、匹配選項、回應回呼
+- [Cloudflare Workers 遷移指南](docs/cloudflare-migration.zh-TW.md) — 從 `cloudflare:test` fetchMock 遷移
+- [MSW v1 Legacy 指南](docs/msw-v1-legacy.zh-TW.md) — 搭配 MSW v1 使用 msw-fetch-mock
+
+## 開發
+
+```bash
+pnpm install
+pnpm build        # 使用 tsup 建置
+pnpm test         # 單元測試（vitest）
+pnpm test:e2e     # E2E 測試（jest-esm、jest-cjs、node-test、node-cjs、legacy-cjs）
+```
+
+### E2E 測試
+
+E2E 測試驗證已發佈的套件能在不同 runtime 和模組系統下正常運作。腳本會建置、透過 `npm pack` 打包 tarball，然後安裝到每個 `e2e/` 專案中 — 完全模擬 CI 流程。
+
+```bash
+# 執行預設套組（跳過 vitest-browser）
+pnpm test:e2e
+
+# 執行單一套組
+pnpm test:e2e -- node-cjs
+
+# 執行所有套組，包含 vitest-browser（會自動安裝 Playwright）
+pnpm test:e2e -- --all
+```
+
+可用套組：`jest-esm`、`jest-cjs`、`node-test`、`node-cjs`、`native-esm`、`native-cjs`、`legacy-cjs`、`vitest-browser`
+
+## 授權
+
+[MIT](LICENSE.md)

package/dist/browser.cjs

@@ -1,11 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 var _chunkLVGXTY6Jcjs = require('./chunk-LVGXTY6J.cjs');
+require('./chunk-3RE2WWHX.cjs');
 
 
 
 
-var _chunkN6B7UP6Bcjs = require('./chunk-N6B7UP6B.cjs');
+var _chunkVUNESK75cjs = require('./chunk-VUNESK75.cjs');
 
 // src/browser-adapter.ts
 var BrowserMswAdapter = class {
@@ -30,9 +31,9 @@ var BrowserMswAdapter = class {
 };
 
 // src/browser.ts
-_chunkN6B7UP6Bcjs.FetchMock._handlerFactory = _chunkLVGXTY6Jcjs.HandlerFactory;
+_chunkVUNESK75cjs.FetchMock._handlerFactory = _chunkLVGXTY6Jcjs.HandlerFactory;
 function createFetchMock(worker) {
-  return new (0, _chunkN6B7UP6Bcjs.FetchMock)(new BrowserMswAdapter(worker));
+  return new (0, _chunkVUNESK75cjs.FetchMock)(new BrowserMswAdapter(worker));
 }
 
 
@@ -40,4 +41,4 @@ function createFetchMock(worker) {
 
 
 
-exports.BrowserMswAdapter = BrowserMswAdapter; exports.FetchMock = _chunkN6B7UP6Bcjs.FetchMock; exports.MockCallHistory = _chunkN6B7UP6Bcjs.MockCallHistory; exports.MockCallHistoryLog = _chunkN6B7UP6Bcjs.MockCallHistoryLog; exports.createFetchMock = createFetchMock;
+exports.BrowserMswAdapter = BrowserMswAdapter; exports.FetchMock = _chunkVUNESK75cjs.FetchMock; exports.MockCallHistory = _chunkVUNESK75cjs.MockCallHistory; exports.MockCallHistoryLog = _chunkVUNESK75cjs.MockCallHistoryLog; exports.createFetchMock = createFetchMock;

package/dist/browser.d.cts

@@ -1,5 +1,5 @@
-import { M as MswAdapter, S as SetupWorkerLike, R as ResolvedActivateOptions, F as FetchMock } from './fetch-mock-DhiqmHdF.cjs';
-export { A as ActivateOptions, C as CallHistoryFilterCriteria, H as HandlerFactory, I as InterceptOptions, a as MockCallHistory, b as MockCallHistoryLog, c as MockCallHistoryLogData, d as MockInterceptor, e as MockPool, f as MockReplyChain, O as OnUnhandledRequest, P as PendingInterceptor, g as ReplyOptions } from './fetch-mock-DhiqmHdF.cjs';
+import { M as MswAdapter, S as SetupWorkerLike, R as ResolvedActivateOptions, F as FetchMock } from './fetch-mock-1oOS8WUJ.cjs';
+export { A as ActivateOptions, C as CallHistoryFilterCriteria, H as HandlerFactory, I as InterceptOptions, a as MockCallHistory, b as MockCallHistoryLog, c as MockCallHistoryLogData, d as MockInterceptor, e as MockPool, f as MockReplyChain, O as OnUnhandledRequest, P as PendingInterceptor, g as ReplyCallback, h as ReplyOptions, i as SingleReplyCallback, j as SingleReplyResult } from './fetch-mock-1oOS8WUJ.cjs';
 
 declare class BrowserMswAdapter implements MswAdapter {
     private readonly worker;

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
-import { M as MswAdapter, S as SetupWorkerLike, R as ResolvedActivateOptions, F as FetchMock } from './fetch-mock-DhiqmHdF.js';
-export { A as ActivateOptions, C as CallHistoryFilterCriteria, H as HandlerFactory, I as InterceptOptions, a as MockCallHistory, b as MockCallHistoryLog, c as MockCallHistoryLogData, d as MockInterceptor, e as MockPool, f as MockReplyChain, O as OnUnhandledRequest, P as PendingInterceptor, g as ReplyOptions } from './fetch-mock-DhiqmHdF.js';
+import { M as MswAdapter, S as SetupWorkerLike, R as ResolvedActivateOptions, F as FetchMock } from './fetch-mock-1oOS8WUJ.js';
+export { A as ActivateOptions, C as CallHistoryFilterCriteria, H as HandlerFactory, I as InterceptOptions, a as MockCallHistory, b as MockCallHistoryLog, c as MockCallHistoryLogData, d as MockInterceptor, e as MockPool, f as MockReplyChain, O as OnUnhandledRequest, P as PendingInterceptor, g as ReplyCallback, h as ReplyOptions, i as SingleReplyCallback, j as SingleReplyResult } from './fetch-mock-1oOS8WUJ.js';
 
 declare class BrowserMswAdapter implements MswAdapter {
     private readonly worker;

package/dist/browser.js

@@ -1,11 +1,12 @@
 import {
   HandlerFactory
 } from "./chunk-KGCQG4D2.js";
+import "./chunk-GZFGTCZB.js";
 import {
   FetchMock,
   MockCallHistory,
   MockCallHistoryLog
-} from "./chunk-3RAWYKAG.js";
+} from "./chunk-3XFP4NAO.js";
 
 // src/browser-adapter.ts
 var BrowserMswAdapter = class {

package/dist/{chunk-OSKJXLRH.cjs → chunk-27BEAYUI.cjs}

@@ -3,7 +3,7 @@
 var _chunkLVGXTY6Jcjs = require('./chunk-LVGXTY6J.cjs');
 
 
-var _chunkN6B7UP6Bcjs = require('./chunk-N6B7UP6B.cjs');
+var _chunkVUNESK75cjs = require('./chunk-VUNESK75.cjs');
 
 // src/node-adapter.ts
 var _node = require('msw/node');
@@ -44,10 +44,10 @@ var NodeMswAdapter = class {
 };
 
 // src/node.ts
-_chunkN6B7UP6Bcjs.FetchMock._defaultAdapterFactory = () => new NodeMswAdapter();
-_chunkN6B7UP6Bcjs.FetchMock._handlerFactory = _chunkLVGXTY6Jcjs.HandlerFactory;
+_chunkVUNESK75cjs.FetchMock._defaultAdapterFactory = () => new NodeMswAdapter();
+_chunkVUNESK75cjs.FetchMock._handlerFactory = _chunkLVGXTY6Jcjs.HandlerFactory;
 function createFetchMock(server) {
-  return new (0, _chunkN6B7UP6Bcjs.FetchMock)(new NodeMswAdapter(server));
+  return new (0, _chunkVUNESK75cjs.FetchMock)(new NodeMswAdapter(server));
 }
 var fetchMock = createFetchMock();
 

package/dist/chunk-3RE2WWHX.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/{chunk-3RAWYKAG.js → chunk-3XFP4NAO.js}

@@ -28,6 +28,10 @@ var MockCallHistoryLog = class {
     if (this.body === null) return null;
     return JSON.parse(this.body);
   }
+  /**
+   * Returns a Map representation of this call log.
+   * Provided for compatibility with the `cloudflare:test` fetchMock API.
+   */
   toMap() {
     return /* @__PURE__ */ new Map([
       ["body", this.body],
@@ -43,6 +47,10 @@ var MockCallHistoryLog = class {
       ["hash", this.hash]
     ]);
   }
+  /**
+   * Returns a pipe-separated string representation of this call log.
+   * Provided for compatibility with the `cloudflare:test` fetchMock API.
+   */
   toString() {
     return [
       `method->${this.method}`,
@@ -105,32 +113,47 @@ var MockCallHistory = class {
       (log) => operator === "AND" ? predicates.every((p) => p(log)) : predicates.some((p) => p(log))
     );
   }
+  /**
+   * Filter helper — matches a single field by exact string or RegExp.
+   *
+   * The `filterCallsByXxx` methods below mirror the `cloudflare:test` fetchMock
+   * API so that tests written for Cloudflare Workers can be reused with this library
+   * without modification.
+   */
   filterBy(field, filter) {
     return this.logs.filter(
       (log) => typeof filter === "string" ? log[field] === filter : filter.test(String(log[field]))
     );
   }
+  /** Filter calls by HTTP method. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByMethod(filter) {
     return this.filterBy("method", filter);
   }
+  /** Filter calls by path. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByPath(filter) {
     return this.filterBy("path", filter);
   }
+  /** Filter calls by origin. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByOrigin(filter) {
     return this.filterBy("origin", filter);
   }
+  /** Filter calls by protocol. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByProtocol(filter) {
     return this.filterBy("protocol", filter);
   }
+  /** Filter calls by host. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByHost(filter) {
     return this.filterBy("host", filter);
   }
+  /** Filter calls by port. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByPort(filter) {
     return this.filterBy("port", filter);
   }
+  /** Filter calls by URL hash. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByHash(filter) {
     return this.filterBy("hash", filter);
   }
+  /** Filter calls by full URL. Mirrors `cloudflare:test` fetchMock API. */
   filterCallsByFullUrl(filter) {
     return this.filterBy("fullUrl", filter);
   }
@@ -327,12 +350,19 @@ var FetchMock = class _FetchMock {
     const activeHandlers = [...this.mswHandlers.entries()].filter(([p]) => !p.consumed || p.persist).map(([, handler]) => handler);
     this.adapter.resetHandlers(...activeHandlers);
   }
+  /**
+   * Returns the call history instance.
+   * Provided for compatibility with the `cloudflare:test` fetchMock API.
+   * Equivalent to the `calls` getter.
+   */
   getCallHistory() {
     return this._calls;
   }
+  /** Clears recorded call history. Mirrors `cloudflare:test` fetchMock API. */
   clearCallHistory() {
     this._calls.clear();
   }
+  /** Alias for `clearCallHistory()`. Mirrors `cloudflare:test` fetchMock API. */
   clearAllCallHistory() {
     this.clearCallHistory();
   }

package/dist/{chunk-NFPFLI3N.js → chunk-IWHL7QPE.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KGCQG4D2.js";
 import {
   FetchMock
-} from "./chunk-3RAWYKAG.js";
+} from "./chunk-3XFP4NAO.js";
 
 // src/node-adapter.ts
 import { setupServer } from "msw/node";