mv3-proxy-kit

Open-source toolkit for building reliable Manifest V3 proxy/VPN browser extensions.

Packages

• @infralayers/mv3-proxy-kit — the core library:
  • registerProxyAuth — reliable per-request proxy authentication
  • createPersistedState — state that survives MV3 service-worker restarts
  • setProxyConfig / buildPacScript — proxy config and PAC script management
  • createChannel — typed background↔popup↔content-script messaging
• example-extension — a working Chrome + Firefox extension built with the library

Status

v1 — core modules implemented and unit-tested (14/14 passing), example extension builds cleanly and type-checks for both browsers. Manual browser verification (loading the unpacked extension in chrome://extensions and about:debugging, and confirming proxy auth + config switching actually work end-to-end) is the one remaining step and needs a real browser — see packages/example-extension/README.md for how to do that.

Known gap: Firefox's MV3 webRequest auth-callback shape (webRequestBlocking + synchronous return) differs from Chrome's (webRequestAuthProvider + asyncBlocking). registerProxyAuth currently targets Chrome's async callback shape; PAC-based config switching works on both browsers, but full Firefox auth-callback parity is a follow-up, not yet implemented.

Development

npm install
npm test          # run all unit tests
npm run typecheck # type-check the core library
npm run build --workspace=packages/core
npm run build --workspace=packages/example-extension

License

MIT