feat: support "CONNECT", socket-based interception

.github/workflows/ci.yml

@@ -1,34 +1,44 @@
 name: ci
+
 on:
   push:
     branches: [main]
   pull_request:
+  workflow_dispatch:
+
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: macos-latest
     strategy:
       matrix:
-        node: [18.8.0]
+        node: [18.14]
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
 
       - name: Setup Node.js
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v3
         with:
           node-version: ${{ matrix.node }}
 
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 7.12
+
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: pnpm install
 
       - name: Unit tests
-        run: yarn test:unit
+        run: pnpm test:unit
 
       - name: Build
-        run: yarn build
+        run: pnpm build
 
       - name: Node.js tests
-        run: yarn test:integration:node
+        run: pnpm test:node
+
+      - name: Install Playwright browsers
+        run: npx playwright install
 
       - name: Browser tests
-        run: yarn test:integration:browser
+        run: pnpm test:browser

.github/workflows/release.yml

@@ -10,28 +10,35 @@ jobs:
     runs-on: macos-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           fetch-depth: 0
           token: ${{ secrets.GH_ADMIN_TOKEN }}
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v2
-        with:
-          node-version: 18.8.0
-          always-auth: true
-          cache: yarn
-
       - name: Setup Git
         run: |
           git config --local user.name "Artem Zakharchenko"
           git config --local user.email "kettanaito@gmail.com"
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18.14
+          always-auth: true
+          registry-url: https://registry.npmjs.org
+
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 7.12
+
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: pnpm install
+
+      - name: Install Playwright browsers
+        run: npx playwright install
 
       - name: Release
-        run: yarn release
+        run: pnpm release
         env:
           GITHUB_TOKEN: ${{ secrets.GH_ADMIN_TOKEN }}
-          NPM_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.nvmrc

@@ -1 +1 @@
-v18.8.0
+v18.14.2

CLAUDE.md

@@ -0,0 +1,74 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is `@mswjs/interceptors`, a low-level HTTP/HTTPS/XHR/fetch request interception library. It extends native Node.js modules and browser APIs using class extensions rather than module rewrites, allowing for more resilient request interception.
+
+## Commands
+
+### Building
+- `pnpm build` - Clean and build the project for production (outputs to `lib/` directory)
+- `pnpm start` - Start TypeScript compiler in watch mode
+- `pnpm clean` - Remove built files from `lib/` directory
+
+### Testing
+- `pnpm test` - Run all tests (unit + integration)
+- `pnpm test:unit` - Run unit tests only (using Vitest)
+- `pnpm test:integration` - Run integration tests (both Node.js and browser)
+- `pnpm test:node` - Run Node.js integration tests (using Vitest with custom config)
+- `pnpm test:browser` - Run browser integration tests (using Playwright)
+
+### Development
+- `pnpm prepare` - Initialize git hooks
+- `pnpm release` - Publish a release
+- `pnpm prepublishOnly` - Build and test before publishing (runs automatically on publish)
+
+## Architecture
+
+### Core Components
+
+- **`Interceptor`** - Abstract base class for all interceptors with `apply()`, `on()`, and `dispose()` methods
+- **`BatchInterceptor`** - Combines multiple interceptors and manages them as a group
+- **`RemoteHttpInterceptor`** - Enables request interception in child processes with parent process resolution
+
+### Interceptor Types
+
+The library provides specific interceptors for different request sources:
+- **`ClientRequestInterceptor`** - Intercepts `http.get`/`http.request` calls (Node.js only)
+- **`XMLHttpRequestInterceptor`** - Intercepts `XMLHttpRequest` (both Node.js and browser)
+- **`FetchInterceptor`** - Intercepts `fetch` calls (both Node.js and browser)
+
+### Build System
+
+- **Dual Platform Builds**: Uses `tsup` to build separate bundles for Node.js (`lib/node/`) and browser (`lib/browser/`)
+- **Multiple Formats**: Outputs both CommonJS (`.js`) and ES modules (`.mjs`) with TypeScript declarations (`.d.ts`)
+- **Package Exports**: Complex export map in `package.json` provides platform-specific entry points
+
+### Request/Response Flow
+
+1. All intercepted requests are normalized to Fetch API `Request` instances
+2. Responses use Fetch API `Response` instances as the common format
+3. The library handles coercion between different request/response formats (e.g., `http.OutgoingMessage` for `http.ClientRequest`)
+
+### Event System
+
+All interceptors emit:
+- `request` - When a request is dispatched (allows inspection and mocking)
+- `response` - When any request receives a response (read-only observation)
+
+### Testing Strategy
+
+- **Unit Tests**: Located in `src/` alongside source files (`.test.ts` files), use Vitest
+- **Integration Tests**: Located in `test/` directory
+  - Node.js integration tests use Vitest with custom config
+  - Browser integration tests use Playwright
+  - Tests are organized by interceptor type and feature
+
+### Key Directories
+
+- `src/interceptors/` - Individual interceptor implementations
+- `src/presets/` - Pre-configured interceptor combinations for Node.js and browser
+- `src/utils/` - Utility functions for request/response handling
+- `test/` - Integration tests with separate configurations for different environments

README.md

@@ -206,7 +206,7 @@ All HTTP request interceptors emit a "request" event. In the listener to this ev
 > There are many ways to describe a request in Node.js but this library coerces different request definitions to a single specification-compliant `Request` instance to make the handling consistent.
 
 ```js
-interceptor.on('reqest', ({ request, requestId }) => {
+interceptor.on('request', ({ request, requestId }) => {
   console.log(request.method, request.url)
 })
 ```

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mswjs/interceptors",
   "description": "Low-level HTTP/HTTPS/XHR/fetch request interception library.",
-  "version": "0.23.0",
+  "version": "0.25.11",
   "main": "./lib/node/index.js",
   "module": "./lib/node/index.mjs",
   "types": "./lib/node/index.d.ts",
@@ -45,10 +45,10 @@
     },
     "./RemoteHttpInterceptor": {
       "browser": null,
-      "types": "./lib/node/interceptors/RemoteHttpInterceptor.d.ts",
-      "require": "./lib/node/interceptors/RemoteHttpInterceptor.js",
-      "import": "./lib/node/interceptors/RemoteHttpInterceptor.mjs",
-      "default": "./lib/node/interceptors/RemoteHttpInterceptor.js"
+      "types": "./lib/node/RemoteHttpInterceptor.d.ts",
+      "require": "./lib/node/RemoteHttpInterceptor.js",
+      "import": "./lib/node/RemoteHttpInterceptor.mjs",
+      "default": "./lib/node/RemoteHttpInterceptor.js"
     },
     "./presets/node": {
       "browser": null,
@@ -73,16 +73,16 @@
   },
   "scripts": {
     "start": "tsc --build -w",
-    "test": "yarn test:unit && yarn test:integration",
+    "test": "pnpm test:unit && pnpm test:integration",
     "test:unit": "vitest run",
-    "test:integration": "yarn test:integration:node && yarn test:integration:browser",
-    "test:integration:node": "vitest run -c test/vitest.config.js",
-    "test:integration:browser": "playwright test -c test/playwright.config.ts",
+    "test:integration": "pnpm test:node && pnpm test:browser",
+    "test:node": "vitest run -c test/vitest.config.js",
+    "test:browser": "pnpm playwright test -c test/playwright.config.ts",
     "clean": "rimraf lib",
-    "build": "yarn clean && cross-env NODE_ENV=production tsup --splitting",
-    "prepare": "yarn simple-git-hooks init",
+    "build": "pnpm clean && cross-env NODE_ENV=production tsup --splitting",
+    "prepare": "pnpm simple-git-hooks init",
     "release": "release publish",
-    "prepublishOnly": "yarn build && yarn test"
+    "prepublishOnly": "pnpm build && pnpm test"
   },
   "files": [
     "lib",
@@ -101,8 +101,8 @@
     "@commitlint/cli": "^16.0.2",
     "@commitlint/config-conventional": "^16.0.0",
     "@open-draft/test-server": "^0.5.1",
-    "@ossjs/release": "^0.4.0",
-    "@playwright/test": "^1.31.1",
+    "@ossjs/release": "^0.7.2",
+    "@playwright/test": "^1.37.1",
     "@types/cors": "^2.8.12",
     "@types/express": "^4.17.13",
     "@types/express-rate-limit": "^6.0.0",
@@ -111,7 +111,7 @@
     "@types/node": "^16.11.26",
     "@types/node-fetch": "2.5.12",
     "@types/supertest": "^2.0.11",
-    "axios": "^0.24.0",
+    "axios": "^1.6.0",
     "body-parser": "^1.19.0",
     "commitizen": "^4.2.4",
     "cors": "^2.8.5",
@@ -121,9 +121,10 @@
     "express-rate-limit": "^6.3.0",
     "follow-redirects": "^1.15.1",
     "got": "^11.8.3",
+    "happy-dom": "^12.10.3",
+    "hpagent": "^1.2.0",
     "jest": "^27.4.3",
     "node-fetch": "2.6.7",
-    "playwright": "^1.31.1",
     "rimraf": "^3.0.2",
     "simple-git-hooks": "^2.7.0",
     "superagent": "^6.1.0",
@@ -132,17 +133,18 @@
     "tsup": "^6.5.0",
     "typescript": "^4.9.4",
     "vitest": "^0.28.5",
+    "vitest-environment-miniflare": "^2.14.1",
     "wait-for-expect": "^3.0.2",
     "web-encoding": "^1.1.5",
     "webpack-http-server": "^0.5.0"
   },
   "dependencies": {
-    "@open-draft/deferred-promise": "^2.1.0",
+    "@open-draft/deferred-promise": "^2.2.0",
     "@open-draft/logger": "^0.3.0",
     "@open-draft/until": "^2.0.0",
-    "headers-polyfill": "^3.1.0",
+    "is-node-process": "^1.2.0",
     "outvariant": "^1.2.1",
-    "strict-event-emitter": "^0.5.0"
+    "strict-event-emitter": "^0.5.1"
   },
   "resolutions": {
     "memfs": "^3.4.13"