@openclaw/proxyline 0.1.0 → 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+import type { Agent as HttpAgent } from "node:http";
+import type { Dispatcher } from "undici";
+import type { ProxylineTlsOptions } from "./shared.js";
+export type ProxylineMode = "managed" | "ambient";
+export type ProxylineSurface = "node-http" | "node-https" | "undici" | "websocket" | "connect" | "unknown";
+export type ProxylineOptions = Readonly<{
+    mode: ProxylineMode;
+    proxyUrl?: string | URL;
+    proxyTls?: ProxylineTlsOptions;
+    bypassPolicy?: ProxylineBypassPolicy;
+    ifActive?: "error" | "reuse-compatible" | "replace";
+    onEvent?: (event: ProxylineEvent) => void;
+    undici?: ProxylineUndiciOptions;
+}>;
+export type ProxylineDecision = Readonly<{
+    kind: "proxied" | "direct" | "blocked";
+    reason: string;
+    surface: ProxylineSurface;
+    url: string;
+    proxyUrl?: string;
+}>;
+export type ProxylineBypassRequest = Readonly<{
+    surface: ProxylineSurface;
+    url: string;
+}>;
+export type ProxylineBypassPolicy = (request: ProxylineBypassRequest) => boolean;
+export type ProxylineEvent = Readonly<{
+    type: "runtime.installed";
+    mode: ProxylineMode;
+    active: boolean;
+    proxyUrl?: string;
+}> | Readonly<{
+    type: "runtime.stopped";
+    mode: ProxylineMode;
+}> | Readonly<{
+    type: "decision";
+    decision: ProxylineDecision;
+}> | Readonly<{
+    type: "warning";
+    code: string;
+    message: string;
+}>;
+export type ExplainOptions = Readonly<{
+    surface?: ProxylineSurface;
+}>;
+export type ProxylineBypassRegistration = Readonly<{
+    surface?: ProxylineSurface;
+    url: string | URL;
+}>;
+export type ProxylineUndiciOptions = Readonly<{
+    allowH2?: boolean;
+    bodyTimeout?: number;
+    headersTimeout?: number;
+    connect?: Readonly<{
+        autoSelectFamily?: boolean;
+        autoSelectFamilyAttemptTimeout?: number;
+    }>;
+}>;
+export type ProxylineHandle = Readonly<{
+    mode: ProxylineMode;
+    active: boolean;
+    proxyUrl?: string;
+    createNodeAgent: () => HttpAgent;
+    createUndiciDispatcher: () => Dispatcher;
+    createWebSocketAgent: () => HttpAgent;
+    explain: (url: string | URL, options?: ExplainOptions) => ProxylineDecision;
+    registerBypass: (registration: ProxylineBypassRegistration) => () => void;
+    stop: () => void;
+    withBypass: <T>(registration: ProxylineBypassRegistration, run: () => T) => T;
+}>;
+export type ProxyResolver = Readonly<{
+    active: boolean;
+    describeProxy: () => string | undefined;
+    explain: (url: string | URL, surface: ProxylineSurface) => ProxylineDecision;
+    getProxyForUrl: (url: string, surface?: ProxylineSurface) => string;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/proxyline",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Process-global proxy routing for Node.js.",
   "type": "module",
   "license": "MIT",
@@ -17,10 +17,15 @@
     "url": "https://github.com/openclaw/proxyline/issues"
   },
   "homepage": "https://proxyline.dev",
+  "packageManager": "pnpm@10.33.2",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./dispatcher-brand": {
+      "types": "./dist/dispatcher-brand.d.ts",
+      "default": "./dist/dispatcher-brand.js"
     }
   },
   "files": [
@@ -31,27 +36,31 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "pnpm build && tsc --noEmit && pnpm coverage:run",
+    "coverage": "pnpm build && pnpm coverage:run",
+    "coverage:run": "node scripts/run-coverage.mjs",
+    "docs:build": "node scripts/build-docs-site.mjs",
+    "package:dry-run": "pnpm pack --dry-run",
+    "prepack": "node scripts/prepack-build.mjs",
+    "prepare": "node scripts/prepack-build.mjs",
+    "publish:dry-run": "pnpm publish --dry-run --access public",
+    "test": "pnpm build && tsx --test test/index.test.ts test/e2e.test.ts test/package.test.ts",
+    "typecheck": "pnpm build && tsc --noEmit"
+  },
   "devDependencies": {
-    "@types/node": "^20.19.25",
+    "@types/node": "^20.19.40",
     "@types/ws": "^8.18.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
+    "undici": "^7.25.0",
     "ws": "^8.20.0"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20.18.1"
   },
-  "dependencies": {
-    "proxy-agent": "^8.0.1",
-    "undici": "^7.25.0"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "check": "pnpm typecheck && pnpm test && pnpm build",
-    "docs:build": "node scripts/build-docs-site.mjs",
-    "package:dry-run": "pnpm pack --dry-run",
-    "publish:dry-run": "pnpm publish --dry-run --access public",
-    "test": "tsx --test test/index.test.ts test/e2e.test.ts",
-    "typecheck": "tsc --noEmit"
+  "peerDependencies": {
+    "undici": ">=7.25.0 <9"
   }
-}
+}