npm - @open-probe/proxy - Versions diffs - 0.1.1 - Mend

@open-probe/proxy 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 open-probe contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,56 @@
+# @open-probe/proxy
+Reverse proxy that injects [`@open-probe/core`](../core) into any HTML
+response, so you can annotate elements on **any** dev server (Vite, Next,
+Nuxt, SvelteKit, plain Express…) without touching its build config.
+Also bundles a minimal hand-rolled WebSocket annotation sink for the
+`server (ws)` transport, so you can pipe annotations to a file, stdout,
+or a custom editor integration without an extra service.
+## Install
+```bash
+pnpm add -D @open-probe/proxy
+```
+## CLI
+```bash
+# Inject open-probe into any dev server
+npx open-probe-proxy --target http://localhost:5173 --port 4000
+# Plus a WebSocket sink that appends each annotation to a file
+npx open-probe-proxy \
+  --target http://localhost:5173 \
+  --port 4000 \
+  --ws --ws-output annotations.jsonl
+```
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--target <url>` | (required) | Upstream dev server to proxy. |
+| `--port <n>` | `4000` | Port the proxy listens on. |
+| `--host <h>` | `127.0.0.1` | Bind address. |
+| `--transport <t>` | `clipboard` | `clipboard` / `mcp` / `server`. |
+| `--mcp-endpoint <url>` | `http://127.0.0.1:3100` | MCP HTTP endpoint when `--transport=mcp`. |
+| `--ws` | off | Attach a WebSocket annotation sink at `--ws-path`. |
+| `--ws-path <p>` | `/__open-probe/ws` | WebSocket upgrade path. |
+| `--ws-output <f>` | stdout | File to append received annotation JSON. |
+## Programmatic API
+```ts
+import { createServer, attachWsSink } from '@open-probe/proxy';
+const server = createServer({
+  target: 'http://localhost:5173',
+  port: 4000,
+  injectScript: { transport: 'mcp', mcpEndpoint: 'http://127.0.0.1:3100' },
+});
+attachWsSink(server, { path: '/__open-probe/ws', onMessage: ann => save(ann) });
+```
+## License
+MIT

package/dist/cli.d.ts ADDED Viewed

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

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,355 @@
+#!/usr/bin/env node
+// src/cli.ts
+import cac from "cac";
+import { appendFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+// src/server.ts
+import { createServer } from "http";
+import { request as httpRequest } from "http";
+import { request as httpsRequest } from "https";
+import { URL } from "url";
+import { promises as fs } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+// src/injector.ts
+var HEAD_MATCH = /<head([^>]*)>/i;
+function buildInjection(scriptUrl, config) {
+  const json = JSON.stringify(config).replace(/</g, "\\u003c");
+  return `<script>window.__OPEN_PROBE_CONFIG__=${json};</script><script src="${scriptUrl}" defer></script>`;
+}
+function injectIntoHtml(html, snippet) {
+  if (!HEAD_MATCH.test(html)) {
+    return html.replace(/<html([^>]*)>/i, `<html$1><head>${snippet}</head>`);
+  }
+  return html.replace(HEAD_MATCH, (match) => `${match}${snippet}`);
+}
+// src/ws-sink.ts
+import { createHash } from "crypto";
+var GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+function attachWsSink(server, opts) {
+  server.on("upgrade", (req, socket) => {
+    if ((req.url ?? "/") !== opts.path) {
+      socket.destroy();
+      return;
+    }
+    const key = req.headers["sec-websocket-key"];
+    if (typeof key !== "string" || !key) {
+      socket.destroy();
+      return;
+    }
+    const accept = createHash("sha1").update(`${key}${GUID}`).digest("base64");
+    socket.write(
+      `HTTP/1.1 101 Switching Protocols\r
+Upgrade: websocket\r
+Connection: Upgrade\r
+Sec-WebSocket-Accept: ${accept}\r
+\r
+`
+    );
+    const remote = req.socket.remoteAddress ?? "";
+    pumpFrames(
+      socket,
+      (text) => opts.onMessage(text, { remoteAddress: remote }),
+      (err) => opts.onError?.(err)
+    );
+  });
+}
+function pumpFrames(socket, onText, onError) {
+  let buffer = Buffer.alloc(0);
+  let textChunks = [];
+  socket.on("data", (chunk) => {
+    buffer = buffer.length ? Buffer.concat([buffer, chunk]) : chunk;
+    while (buffer.length >= 2) {
+      const frame = parseFrame(buffer);
+      if (!frame) return;
+      buffer = buffer.subarray(frame.consumed);
+      if (frame.opcode === 0 || frame.opcode === 1) {
+        textChunks.push(frame.payload);
+        if (frame.fin) {
+          const full = Buffer.concat(textChunks).toString("utf8");
+          textChunks = [];
+          try {
+            onText(full);
+          } catch (err) {
+            onError(err);
+          }
+        }
+      } else if (frame.opcode === 8) {
+        socket.end(encodeFrame(8, frame.payload));
+        return;
+      } else if (frame.opcode === 9) {
+        try {
+          socket.write(encodeFrame(10, frame.payload));
+        } catch {
+        }
+      }
+    }
+  });
+  socket.on("error", (err) => onError(err));
+}
+function parseFrame(buffer) {
+  if (buffer.length < 2) return null;
+  const b0 = buffer[0];
+  const b1 = buffer[1];
+  const fin = (b0 & 128) !== 0;
+  const opcode = b0 & 15;
+  const masked = (b1 & 128) !== 0;
+  let payloadLen = b1 & 127;
+  let offset = 2;
+  if (payloadLen === 126) {
+    if (buffer.length < offset + 2) return null;
+    payloadLen = buffer.readUInt16BE(offset);
+    offset += 2;
+  } else if (payloadLen === 127) {
+    if (buffer.length < offset + 8) return null;
+    const hi = buffer.readUInt32BE(offset);
+    const lo = buffer.readUInt32BE(offset + 4);
+    if (hi !== 0 || lo > 2147483647) return null;
+    payloadLen = lo;
+    offset += 8;
+  }
+  let mask = null;
+  if (masked) {
+    if (buffer.length < offset + 4) return null;
+    mask = buffer.subarray(offset, offset + 4);
+    offset += 4;
+  }
+  if (buffer.length < offset + payloadLen) return null;
+  let payload = buffer.subarray(offset, offset + payloadLen);
+  if (mask) {
+    const out = Buffer.allocUnsafe(payloadLen);
+    for (let i = 0; i < payloadLen; i++) out[i] = payload[i] ^ mask[i & 3];
+    payload = out;
+  }
+  return { fin, opcode, payload, consumed: offset + payloadLen };
+}
+function encodeFrame(opcode, payload) {
+  const len = payload.length;
+  let header;
+  if (len < 126) {
+    header = Buffer.from([128 | opcode, len]);
+  } else if (len < 65536) {
+    header = Buffer.alloc(4);
+    header[0] = 128 | opcode;
+    header[1] = 126;
+    header.writeUInt16BE(len, 2);
+  } else {
+    header = Buffer.alloc(10);
+    header[0] = 128 | opcode;
+    header[1] = 127;
+    header.writeUInt32BE(0, 2);
+    header.writeUInt32BE(len, 6);
+  }
+  return Buffer.concat([header, payload]);
+}
+// src/server.ts
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var DEFAULT_RUNTIME_PATH = "/__open-probe/runtime.js";
+async function locateScriptFile(override) {
+  if (override) return override;
+  const candidates = [
+    resolve(__dirname, "../../core/dist/index.global.js"),
+    resolve(__dirname, "../../../core/dist/index.global.js"),
+    resolve(process.cwd(), "node_modules/@open-probe/core/dist/index.global.js")
+  ];
+  for (const path of candidates) {
+    try {
+      await fs.access(path);
+      return path;
+    } catch {
+    }
+  }
+  throw new Error(
+    "Could not locate @open-probe/core IIFE bundle. Run `pnpm --filter @open-probe/core build` first."
+  );
+}
+function isHtmlAccept(req) {
+  const accept = req.headers.accept;
+  if (!accept) return false;
+  return accept.includes("text/html");
+}
+async function createProxyServer(options) {
+  const targetUrl = new URL(options.target);
+  const runtimePath = options.runtimePath ?? DEFAULT_RUNTIME_PATH;
+  const scriptFile = await locateScriptFile(options.scriptFile);
+  const injection = buildInjection(runtimePath, options.config ?? {});
+  const requestFn = targetUrl.protocol === "https:" ? httpsRequest : httpRequest;
+  const server = createServer((req, res) => {
+    handle(req, res).catch((err) => {
+      console.error("[open-probe proxy] error:", err);
+      if (!res.headersSent) {
+        res.writeHead(502, { "Content-Type": "text/plain" });
+      }
+      res.end(`open-probe proxy error: ${err.message}`);
+    });
+  });
+  if (options.wsSink) {
+    attachWsSink(server, options.wsSink);
+  }
+  async function handle(req, res) {
+    const url = req.url ?? "/";
+    if (url === runtimePath) {
+      try {
+        const code = await fs.readFile(scriptFile, "utf-8");
+        res.writeHead(200, {
+          "Content-Type": "application/javascript; charset=utf-8",
+          "Cache-Control": "no-cache",
+          "Access-Control-Allow-Origin": "*"
+        });
+        res.end(code);
+      } catch (err) {
+        res.writeHead(500);
+        res.end(`Failed to read runtime: ${err.message}`);
+      }
+      return;
+    }
+    if (url === "/__open-probe/health") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ ok: true, target: options.target }));
+      return;
+    }
+    proxyRequest(req, res);
+  }
+  function proxyRequest(req, res) {
+    const headers = { ...req.headers };
+    headers.host = targetUrl.host;
+    delete headers["accept-encoding"];
+    const upstream = requestFn(
+      {
+        protocol: targetUrl.protocol,
+        host: targetUrl.hostname,
+        port: targetUrl.port || (targetUrl.protocol === "https:" ? 443 : 80),
+        method: req.method,
+        path: req.url,
+        headers
+      },
+      (proxyRes) => {
+        const upstreamHeaders = { ...proxyRes.headers };
+        delete upstreamHeaders["content-length"];
+        delete upstreamHeaders["content-encoding"];
+        const ct = String(proxyRes.headers["content-type"] ?? "");
+        const wantsInjection = ct.includes("text/html") && isHtmlAccept(req);
+        if (!wantsInjection) {
+          res.writeHead(proxyRes.statusCode ?? 502, upstreamHeaders);
+          proxyRes.pipe(res);
+          return;
+        }
+        const chunks = [];
+        proxyRes.on("data", (chunk) => chunks.push(chunk));
+        proxyRes.on("end", () => {
+          const body = Buffer.concat(chunks).toString("utf8");
+          const injected = injectIntoHtml(body, injection);
+          res.writeHead(proxyRes.statusCode ?? 200, upstreamHeaders);
+          res.end(injected);
+        });
+        proxyRes.on("error", (err) => {
+          if (!res.headersSent) res.writeHead(502);
+          res.end(`upstream error: ${err.message}`);
+        });
+      }
+    );
+    upstream.on("error", (err) => {
+      if (!res.headersSent) res.writeHead(502, { "Content-Type": "text/plain" });
+      res.end(`upstream connection failed: ${err.message}`);
+    });
+    req.pipe(upstream);
+  }
+  return new Promise((resolveStart, rejectStart) => {
+    server.once("error", rejectStart);
+    server.listen(options.port, options.host, () => {
+      const address = server.address();
+      if (typeof address === "object" && address) {
+        resolveStart({
+          address: { host: options.host, port: address.port },
+          close: () => new Promise((done) => {
+            server.close(() => done());
+          })
+        });
+      } else {
+        rejectStart(new Error("failed to bind proxy server"));
+      }
+    });
+  });
+}
+// src/cli.ts
+var VERSION = "0.1.0";
+var cli = cac("open-probe");
+cli.command("[]", "Start the open-probe reverse proxy").option("-t, --target <url>", "Upstream dev server URL (e.g. http://localhost:3000)").option("-p, --port <port>", "Proxy port", { default: "4000" }).option("--host <host>", "Bind address", { default: "127.0.0.1" }).option("--transport <name>", "clipboard | mcp | server", { default: "clipboard" }).option("--output-level <level>", "compact | standard | detailed | forensic", {
+  default: "standard"
+}).option("--mcp-endpoint <url>", "MCP HTTP base URL", {
+  default: "http://127.0.0.1:3100"
+}).option("--server-endpoint <url>", "Editor server endpoint (for transport=server)").option("--ws", "Enable WebSocket annotation sink on the proxy port").option("--ws-path <path>", "WebSocket upgrade path", { default: "/__open-probe/ws" }).option("--ws-output <file>", "Append received annotation payloads to FILE (default: stdout)").option("--debug", "Enable verbose logging").action(async (opts) => {
+  const target = opts.target;
+  if (!target) {
+    console.error("error: --target is required");
+    process.exit(1);
+  }
+  const port = Number(opts.port);
+  const host = String(opts.host);
+  const config = {
+    transport: String(opts.transport),
+    outputLevel: String(opts.outputLevel),
+    mcp: { endpoint: String(opts.mcpEndpoint) },
+    debug: Boolean(opts.debug)
+  };
+  if (opts.serverEndpoint) {
+    config.server = { endpoint: String(opts.serverEndpoint), protocol: "http" };
+  }
+  let wsSink;
+  const wsPath = String(opts.wsPath ?? "/__open-probe/ws");
+  if (opts.ws) {
+    const wsOutputPath = opts.wsOutput ? resolve2(String(opts.wsOutput)) : null;
+    const writeLine = wsOutputPath ? (line) => appendFileSync(wsOutputPath, line + "\n") : (line) => process.stdout.write(line + "\n");
+    wsSink = {
+      path: wsPath,
+      onMessage(payload, info) {
+        writeLine(payload);
+        if (opts.debug) {
+          console.log(`[open-probe proxy] ws annotation from ${info.remoteAddress}`);
+        }
+      },
+      onError(err) {
+        console.error("[open-probe proxy] ws error:", err.message);
+      }
+    };
+    if (!opts.serverEndpoint && String(opts.transport) === "clipboard") {
+      config.transport = "server";
+      config.server = {
+        endpoint: `ws://${host}:${port}${wsPath}`,
+        protocol: "ws"
+      };
+    }
+  }
+  const server = await createProxyServer({
+    target,
+    port,
+    host,
+    config,
+    ...wsSink ? { wsSink } : {}
+  });
+  const url = `http://${host === "0.0.0.0" ? "127.0.0.1" : host}:${server.address.port}`;
+  console.log(`\u2713 open-probe proxy listening on ${url}`);
+  console.log(`  \u2192 upstream: ${target}`);
+  console.log(`  \u2192 transport: ${config.transport}, output: ${config.outputLevel}`);
+  if (wsSink) {
+    console.log(`  \u2192 ws sink: ws://${host}:${port}${wsPath}${opts.wsOutput ? ` \u2192 ${opts.wsOutput}` : " \u2192 stdout"}`);
+  }
+  const shutdown = async () => {
+    console.log("\nshutting down\u2026");
+    await server.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+});
+cli.help();
+cli.version(VERSION);
+cli.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/cli.ts","../src/server.ts","../src/injector.ts","../src/ws-sink.ts"],"sourcesContent":["import cac from 'cac';\nimport { appendFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { DeepPartial, OutputLevel, ProbeConfig, TransportName } from '@open-probe/shared';\nimport { createProxyServer } from './server.js';\nimport type { WsSinkOptions } from './ws-sink.js';\n\nconst VERSION = '0.1.0';\n\nconst cli = cac('open-probe');\n\ncli\n .command('[]', 'Start the open-probe reverse proxy')\n .option('-t, --target <url>', 'Upstream dev server URL (e.g. http://localhost:3000)')\n .option('-p, --port <port>', 'Proxy port', { default: '4000' })\n .option('--host <host>', 'Bind address', { default: '127.0.0.1' })\n .option('--transport <name>', 'clipboard | mcp | server', { default: 'clipboard' })\n .option('--output-level <level>', 'compact | standard | detailed | forensic', {\n default: 'standard',\n })\n .option('--mcp-endpoint <url>', 'MCP HTTP base URL', {\n default: 'http://127.0.0.1:3100',\n })\n .option('--server-endpoint <url>', 'Editor server endpoint (for transport=server)')\n .option('--ws', 'Enable WebSocket annotation sink on the proxy port')\n .option('--ws-path <path>', 'WebSocket upgrade path', { default: '/__open-probe/ws' })\n .option('--ws-output <file>', 'Append received annotation payloads to FILE (default: stdout)')\n .option('--debug', 'Enable verbose logging')\n .action(async opts => {\n const target = opts.target as string | undefined;\n if (!target) {\n console.error('error: --target is required');\n process.exit(1);\n }\n const port = Number(opts.port);\n const host = String(opts.host);\n\n const config: DeepPartial<ProbeConfig> = {\n transport: String(opts.transport) as TransportName,\n outputLevel: String(opts.outputLevel) as OutputLevel,\n mcp: { endpoint: String(opts.mcpEndpoint) },\n debug: Boolean(opts.debug),\n };\n if (opts.serverEndpoint) {\n config.server = { endpoint: String(opts.serverEndpoint), protocol: 'http' };\n }\n\n let wsSink: WsSinkOptions | undefined;\n const wsPath = String(opts.wsPath ?? '/__open-probe/ws');\n if (opts.ws) {\n const wsOutputPath = opts.wsOutput ? resolve(String(opts.wsOutput)) : null;\n const writeLine = wsOutputPath\n ? (line: string) => appendFileSync(wsOutputPath, line + '\\n')\n : (line: string) => process.stdout.write(line + '\\n');\n\n wsSink = {\n path: wsPath,\n onMessage(payload, info) {\n writeLine(payload);\n if (opts.debug) {\n // eslint-disable-next-line no-console\n console.log(`[open-probe proxy] ws annotation from ${info.remoteAddress}`);\n }\n },\n onError(err) {\n // eslint-disable-next-line no-console\n console.error('[open-probe proxy] ws error:', err.message);\n },\n };\n // Auto-wire transport when user did not configure it explicitly. The\n // default cac value for --transport is 'clipboard', which is rarely\n // intended together with --ws.\n if (!opts.serverEndpoint && String(opts.transport) === 'clipboard') {\n config.transport = 'server' as TransportName;\n config.server = {\n endpoint: `ws://${host}:${port}${wsPath}`,\n protocol: 'ws',\n };\n }\n }\n\n const server = await createProxyServer({\n target,\n port,\n host,\n config,\n ...(wsSink ? { wsSink } : {}),\n });\n const url = `http://${host === '0.0.0.0' ? '127.0.0.1' : host}:${server.address.port}`;\n // eslint-disable-next-line no-console\n console.log(`✓ open-probe proxy listening on ${url}`);\n // eslint-disable-next-line no-console\n console.log(` → upstream: ${target}`);\n // eslint-disable-next-line no-console\n console.log(` → transport: ${config.transport}, output: ${config.outputLevel}`);\n if (wsSink) {\n // eslint-disable-next-line no-console\n console.log(` → ws sink: ws://${host}:${port}${wsPath}${opts.wsOutput ? ` → ${opts.wsOutput}` : ' → stdout'}`);\n }\n\n const shutdown = async () => {\n // eslint-disable-next-line no-console\n console.log('\\nshutting down…');\n await server.close();\n process.exit(0);\n };\n process.on('SIGINT', shutdown);\n process.on('SIGTERM', shutdown);\n });\n\ncli.help();\ncli.version(VERSION);\ncli.parse();\n","import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';\nimport { request as httpRequest } from 'node:http';\nimport { request as httpsRequest } from 'node:https';\nimport { URL } from 'node:url';\nimport { promises as fs } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, resolve } from 'node:path';\nimport type { DeepPartial, ProbeConfig } from '@open-probe/shared';\nimport { buildInjection, injectIntoHtml } from './injector.js';\nimport { attachWsSink, type WsSinkOptions } from './ws-sink.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nexport interface ProxyOptions {\n target: string;\n port: number;\n host: string;\n /** Path served as the open-probe runtime */\n runtimePath?: string;\n config?: DeepPartial<ProbeConfig>;\n /** Override path to the IIFE bundle */\n scriptFile?: string;\n /**\n * Enable a WebSocket sink. When set, the proxy will accept WS upgrade\n * requests on `wsSink.path` and forward each text payload to\n * `wsSink.onMessage`. Useful for editors that don't support MCP.\n */\n wsSink?: WsSinkOptions;\n}\n\nexport type { WsSinkOptions } from './ws-sink.js';\n\nconst DEFAULT_RUNTIME_PATH = '/__open-probe/runtime.js';\n\nasync function locateScriptFile(override?: string): Promise<string> {\n if (override) return override;\n const candidates = [\n resolve(__dirname, '../../core/dist/index.global.js'),\n resolve(__dirname, '../../../core/dist/index.global.js'),\n resolve(process.cwd(), 'node_modules/@open-probe/core/dist/index.global.js'),\n ];\n for (const path of candidates) {\n try {\n await fs.access(path);\n return path;\n } catch {\n // try next\n }\n }\n throw new Error(\n 'Could not locate @open-probe/core IIFE bundle. Run `pnpm --filter @open-probe/core build` first.'\n );\n}\n\nfunction isHtmlAccept(req: IncomingMessage): boolean {\n const accept = req.headers.accept;\n if (!accept) return false;\n return accept.includes('text/html');\n}\n\nexport async function createProxyServer(options: ProxyOptions) {\n const targetUrl = new URL(options.target);\n const runtimePath = options.runtimePath ?? DEFAULT_RUNTIME_PATH;\n const scriptFile = await locateScriptFile(options.scriptFile);\n const injection = buildInjection(runtimePath, options.config ?? {});\n\n const requestFn = targetUrl.protocol === 'https:' ? httpsRequest : httpRequest;\n\n const server = createServer((req, res) => {\n handle(req, res).catch(err => {\n // eslint-disable-next-line no-console\n console.error('[open-probe proxy] error:', err);\n if (!res.headersSent) {\n res.writeHead(502, { 'Content-Type': 'text/plain' });\n }\n res.end(`open-probe proxy error: ${(err as Error).message}`);\n });\n });\n\n if (options.wsSink) {\n attachWsSink(server, options.wsSink);\n }\n\n async function handle(req: IncomingMessage, res: ServerResponse): Promise<void> {\n const url = req.url ?? '/';\n\n if (url === runtimePath) {\n try {\n const code = await fs.readFile(scriptFile, 'utf-8');\n res.writeHead(200, {\n 'Content-Type': 'application/javascript; charset=utf-8',\n 'Cache-Control': 'no-cache',\n 'Access-Control-Allow-Origin': '*',\n });\n res.end(code);\n } catch (err) {\n res.writeHead(500);\n res.end(`Failed to read runtime: ${(err as Error).message}`);\n }\n return;\n }\n\n if (url === '/__open-probe/health') {\n res.writeHead(200, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ ok: true, target: options.target }));\n return;\n }\n\n proxyRequest(req, res);\n }\n\n function proxyRequest(req: IncomingMessage, res: ServerResponse): void {\n const headers = { ...req.headers };\n headers.host = targetUrl.host;\n delete headers['accept-encoding']; // We want to inspect HTML; disable compression.\n\n const upstream = requestFn(\n {\n protocol: targetUrl.protocol,\n host: targetUrl.hostname,\n port: targetUrl.port || (targetUrl.protocol === 'https:' ? 443 : 80),\n method: req.method,\n path: req.url,\n headers,\n },\n proxyRes => {\n const upstreamHeaders = { ...proxyRes.headers };\n delete upstreamHeaders['content-length'];\n delete upstreamHeaders['content-encoding'];\n\n const ct = String(proxyRes.headers['content-type'] ?? '');\n const wantsInjection = ct.includes('text/html') && isHtmlAccept(req);\n\n if (!wantsInjection) {\n res.writeHead(proxyRes.statusCode ?? 502, upstreamHeaders);\n proxyRes.pipe(res);\n return;\n }\n\n const chunks: Buffer[] = [];\n proxyRes.on('data', chunk => chunks.push(chunk as Buffer));\n proxyRes.on('end', () => {\n const body = Buffer.concat(chunks).toString('utf8');\n const injected = injectIntoHtml(body, injection);\n res.writeHead(proxyRes.statusCode ?? 200, upstreamHeaders);\n res.end(injected);\n });\n proxyRes.on('error', err => {\n if (!res.headersSent) res.writeHead(502);\n res.end(`upstream error: ${err.message}`);\n });\n }\n );\n\n upstream.on('error', err => {\n if (!res.headersSent) res.writeHead(502, { 'Content-Type': 'text/plain' });\n res.end(`upstream connection failed: ${err.message}`);\n });\n\n req.pipe(upstream);\n }\n\n return new Promise<{\n close(): Promise<void>;\n address: { host: string; port: number };\n }>((resolveStart, rejectStart) => {\n server.once('error', rejectStart);\n server.listen(options.port, options.host, () => {\n const address = server.address();\n if (typeof address === 'object' && address) {\n resolveStart({\n address: { host: options.host, port: address.port },\n close: () =>\n new Promise<void>(done => {\n server.close(() => done());\n }),\n });\n } else {\n rejectStart(new Error('failed to bind proxy server'));\n }\n });\n });\n}\n","import type { DeepPartial, ProbeConfig } from '@open-probe/shared';\n\nconst HEAD_MATCH = /<head([^>]*)>/i;\n\nexport function buildInjection(scriptUrl: string, config: DeepPartial<ProbeConfig>): string {\n const json = JSON.stringify(config).replace(/</g, '\\\\u003c');\n return `<script>window.__OPEN_PROBE_CONFIG__=${json};</script><script src=\"${scriptUrl}\" defer></script>`;\n}\n\nexport function injectIntoHtml(html: string, snippet: string): string {\n if (!HEAD_MATCH.test(html)) {\n return html.replace(/<html([^>]*)>/i, `<html$1><head>${snippet}</head>`);\n }\n return html.replace(HEAD_MATCH, match => `${match}${snippet}`);\n}\n","import { createHash } from 'node:crypto';\nimport type { Server, IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\n\n/**\n * Minimal RFC 6455 WebSocket sink. Receives text frames from the browser,\n * decodes them to UTF-8, and forwards each payload to `onMessage`. Supports\n * masked client frames, payload lengths up to 4 GiB, ping → pong replies,\n * and graceful close. Server never originates messages, so encode logic is\n * limited to control frames.\n */\n\nconst GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';\n\nexport interface WsSinkOptions {\n path: string;\n onMessage(payload: string, info: { remoteAddress: string }): void;\n onError?(err: Error): void;\n}\n\nexport function attachWsSink(server: Server, opts: WsSinkOptions): void {\n server.on('upgrade', (req: IncomingMessage, socket: Duplex) => {\n if ((req.url ?? '/') !== opts.path) {\n socket.destroy();\n return;\n }\n const key = req.headers['sec-websocket-key'];\n if (typeof key !== 'string' || !key) {\n socket.destroy();\n return;\n }\n const accept = createHash('sha1').update(`${key}${GUID}`).digest('base64');\n socket.write(\n 'HTTP/1.1 101 Switching Protocols\\r\\n' +\n 'Upgrade: websocket\\r\\n' +\n 'Connection: Upgrade\\r\\n' +\n `Sec-WebSocket-Accept: ${accept}\\r\\n` +\n '\\r\\n'\n );\n const remote = req.socket.remoteAddress ?? '';\n pumpFrames(\n socket,\n text => opts.onMessage(text, { remoteAddress: remote }),\n err => opts.onError?.(err)\n );\n });\n}\n\nfunction pumpFrames(socket: Duplex, onText: (text: string) => void, onError: (e: Error) => void): void {\n let buffer = Buffer.alloc(0);\n let textChunks: Buffer[] = [];\n\n socket.on('data', (chunk: Buffer) => {\n buffer = (buffer.length ? Buffer.concat([buffer, chunk]) : chunk) as typeof buffer;\n while (buffer.length >= 2) {\n const frame = parseFrame(buffer);\n if (!frame) return;\n buffer = buffer.subarray(frame.consumed);\n\n if (frame.opcode === 0x0 || frame.opcode === 0x1) {\n textChunks.push(frame.payload);\n if (frame.fin) {\n const full = Buffer.concat(textChunks).toString('utf8');\n textChunks = [];\n try {\n onText(full);\n } catch (err) {\n onError(err as Error);\n }\n }\n } else if (frame.opcode === 0x8) {\n socket.end(encodeFrame(0x8, frame.payload));\n return;\n } else if (frame.opcode === 0x9) {\n try {\n socket.write(encodeFrame(0xa, frame.payload));\n } catch {\n /* ignore */\n }\n }\n // 0xA pong & 0x2 binary: ignored.\n }\n });\n socket.on('error', err => onError(err));\n}\n\ninterface ParsedFrame {\n fin: boolean;\n opcode: number;\n payload: Buffer;\n consumed: number;\n}\n\nfunction parseFrame(buffer: Buffer): ParsedFrame | null {\n if (buffer.length < 2) return null;\n const b0 = buffer[0]!;\n const b1 = buffer[1]!;\n const fin = (b0 & 0x80) !== 0;\n const opcode = b0 & 0x0f;\n const masked = (b1 & 0x80) !== 0;\n let payloadLen = b1 & 0x7f;\n let offset = 2;\n\n if (payloadLen === 126) {\n if (buffer.length < offset + 2) return null;\n payloadLen = buffer.readUInt16BE(offset);\n offset += 2;\n } else if (payloadLen === 127) {\n if (buffer.length < offset + 8) return null;\n const hi = buffer.readUInt32BE(offset);\n const lo = buffer.readUInt32BE(offset + 4);\n if (hi !== 0 || lo > 0x7fffffff) return null;\n payloadLen = lo;\n offset += 8;\n }\n\n let mask: Buffer | null = null;\n if (masked) {\n if (buffer.length < offset + 4) return null;\n mask = buffer.subarray(offset, offset + 4);\n offset += 4;\n }\n\n if (buffer.length < offset + payloadLen) return null;\n let payload = buffer.subarray(offset, offset + payloadLen);\n if (mask) {\n const out = Buffer.allocUnsafe(payloadLen);\n for (let i = 0; i < payloadLen; i++) out[i] = payload[i]! ^ mask[i & 3]!;\n payload = out;\n }\n return { fin, opcode, payload, consumed: offset + payloadLen };\n}\n\nfunction encodeFrame(opcode: number, payload: Buffer): Buffer {\n const len = payload.length;\n let header: Buffer;\n if (len < 126) {\n header = Buffer.from([0x80 | opcode, len]);\n } else if (len < 0x10000) {\n header = Buffer.alloc(4);\n header[0] = 0x80 | opcode;\n header[1] = 126;\n header.writeUInt16BE(len, 2);\n } else {\n header = Buffer.alloc(10);\n header[0] = 0x80 | opcode;\n header[1] = 127;\n header.writeUInt32BE(0, 2);\n header.writeUInt32BE(len, 6);\n }\n return Buffer.concat([header, payload]);\n}\n"],"mappings":"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","names":["resolve","resolve"]}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import { DeepPartial, ProbeConfig } from '@open-probe/shared';
+import { Server } from 'node:http';
+interface WsSinkOptions {
+    path: string;
+    onMessage(payload: string, info: {
+        remoteAddress: string;
+    }): void;
+    onError?(err: Error): void;
+}
+declare function attachWsSink(server: Server, opts: WsSinkOptions): void;
+interface ProxyOptions {
+    target: string;
+    port: number;
+    host: string;
+    /** Path served as the open-probe runtime */
+    runtimePath?: string;
+    config?: DeepPartial<ProbeConfig>;
+    /** Override path to the IIFE bundle */
+    scriptFile?: string;
+    /**
+     * Enable a WebSocket sink. When set, the proxy will accept WS upgrade
+     * requests on `wsSink.path` and forward each text payload to
+     * `wsSink.onMessage`. Useful for editors that don't support MCP.
+     */
+    wsSink?: WsSinkOptions;
+}
+declare function createProxyServer(options: ProxyOptions): Promise<{
+    close(): Promise<void>;
+    address: {
+        host: string;
+        port: number;
+    };
+}>;
+declare function buildInjection(scriptUrl: string, config: DeepPartial<ProbeConfig>): string;
+declare function injectIntoHtml(html: string, snippet: string): string;
+export { type ProxyOptions, type WsSinkOptions, attachWsSink, buildInjection, createProxyServer, injectIntoHtml };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+// src/server.ts
+import { createServer } from "http";
+import { request as httpRequest } from "http";
+import { request as httpsRequest } from "https";
+import { URL } from "url";
+import { promises as fs } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+// src/injector.ts
+var HEAD_MATCH = /<head([^>]*)>/i;
+function buildInjection(scriptUrl, config) {
+  const json = JSON.stringify(config).replace(/</g, "\\u003c");
+  return `<script>window.__OPEN_PROBE_CONFIG__=${json};</script><script src="${scriptUrl}" defer></script>`;
+}
+function injectIntoHtml(html, snippet) {
+  if (!HEAD_MATCH.test(html)) {
+    return html.replace(/<html([^>]*)>/i, `<html$1><head>${snippet}</head>`);
+  }
+  return html.replace(HEAD_MATCH, (match) => `${match}${snippet}`);
+}
+// src/ws-sink.ts
+import { createHash } from "crypto";
+var GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+function attachWsSink(server, opts) {
+  server.on("upgrade", (req, socket) => {
+    if ((req.url ?? "/") !== opts.path) {
+      socket.destroy();
+      return;
+    }
+    const key = req.headers["sec-websocket-key"];
+    if (typeof key !== "string" || !key) {
+      socket.destroy();
+      return;
+    }
+    const accept = createHash("sha1").update(`${key}${GUID}`).digest("base64");
+    socket.write(
+      `HTTP/1.1 101 Switching Protocols\r
+Upgrade: websocket\r
+Connection: Upgrade\r
+Sec-WebSocket-Accept: ${accept}\r
+\r
+`
+    );
+    const remote = req.socket.remoteAddress ?? "";
+    pumpFrames(
+      socket,
+      (text) => opts.onMessage(text, { remoteAddress: remote }),
+      (err) => opts.onError?.(err)
+    );
+  });
+}
+function pumpFrames(socket, onText, onError) {
+  let buffer = Buffer.alloc(0);
+  let textChunks = [];
+  socket.on("data", (chunk) => {
+    buffer = buffer.length ? Buffer.concat([buffer, chunk]) : chunk;
+    while (buffer.length >= 2) {
+      const frame = parseFrame(buffer);
+      if (!frame) return;
+      buffer = buffer.subarray(frame.consumed);
+      if (frame.opcode === 0 || frame.opcode === 1) {
+        textChunks.push(frame.payload);
+        if (frame.fin) {
+          const full = Buffer.concat(textChunks).toString("utf8");
+          textChunks = [];
+          try {
+            onText(full);
+          } catch (err) {
+            onError(err);
+          }
+        }
+      } else if (frame.opcode === 8) {
+        socket.end(encodeFrame(8, frame.payload));
+        return;
+      } else if (frame.opcode === 9) {
+        try {
+          socket.write(encodeFrame(10, frame.payload));
+        } catch {
+        }
+      }
+    }
+  });
+  socket.on("error", (err) => onError(err));
+}
+function parseFrame(buffer) {
+  if (buffer.length < 2) return null;
+  const b0 = buffer[0];
+  const b1 = buffer[1];
+  const fin = (b0 & 128) !== 0;
+  const opcode = b0 & 15;
+  const masked = (b1 & 128) !== 0;
+  let payloadLen = b1 & 127;
+  let offset = 2;
+  if (payloadLen === 126) {
+    if (buffer.length < offset + 2) return null;
+    payloadLen = buffer.readUInt16BE(offset);
+    offset += 2;
+  } else if (payloadLen === 127) {
+    if (buffer.length < offset + 8) return null;
+    const hi = buffer.readUInt32BE(offset);
+    const lo = buffer.readUInt32BE(offset + 4);
+    if (hi !== 0 || lo > 2147483647) return null;
+    payloadLen = lo;
+    offset += 8;
+  }
+  let mask = null;
+  if (masked) {
+    if (buffer.length < offset + 4) return null;
+    mask = buffer.subarray(offset, offset + 4);
+    offset += 4;
+  }
+  if (buffer.length < offset + payloadLen) return null;
+  let payload = buffer.subarray(offset, offset + payloadLen);
+  if (mask) {
+    const out = Buffer.allocUnsafe(payloadLen);
+    for (let i = 0; i < payloadLen; i++) out[i] = payload[i] ^ mask[i & 3];
+    payload = out;
+  }
+  return { fin, opcode, payload, consumed: offset + payloadLen };
+}
+function encodeFrame(opcode, payload) {
+  const len = payload.length;
+  let header;
+  if (len < 126) {
+    header = Buffer.from([128 | opcode, len]);
+  } else if (len < 65536) {
+    header = Buffer.alloc(4);
+    header[0] = 128 | opcode;
+    header[1] = 126;
+    header.writeUInt16BE(len, 2);
+  } else {
+    header = Buffer.alloc(10);
+    header[0] = 128 | opcode;
+    header[1] = 127;
+    header.writeUInt32BE(0, 2);
+    header.writeUInt32BE(len, 6);
+  }
+  return Buffer.concat([header, payload]);
+}
+// src/server.ts
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var DEFAULT_RUNTIME_PATH = "/__open-probe/runtime.js";
+async function locateScriptFile(override) {
+  if (override) return override;
+  const candidates = [
+    resolve(__dirname, "../../core/dist/index.global.js"),
+    resolve(__dirname, "../../../core/dist/index.global.js"),
+    resolve(process.cwd(), "node_modules/@open-probe/core/dist/index.global.js")
+  ];
+  for (const path of candidates) {
+    try {
+      await fs.access(path);
+      return path;
+    } catch {
+    }
+  }
+  throw new Error(
+    "Could not locate @open-probe/core IIFE bundle. Run `pnpm --filter @open-probe/core build` first."
+  );
+}
+function isHtmlAccept(req) {
+  const accept = req.headers.accept;
+  if (!accept) return false;
+  return accept.includes("text/html");
+}
+async function createProxyServer(options) {
+  const targetUrl = new URL(options.target);
+  const runtimePath = options.runtimePath ?? DEFAULT_RUNTIME_PATH;
+  const scriptFile = await locateScriptFile(options.scriptFile);
+  const injection = buildInjection(runtimePath, options.config ?? {});
+  const requestFn = targetUrl.protocol === "https:" ? httpsRequest : httpRequest;
+  const server = createServer((req, res) => {
+    handle(req, res).catch((err) => {
+      console.error("[open-probe proxy] error:", err);
+      if (!res.headersSent) {
+        res.writeHead(502, { "Content-Type": "text/plain" });
+      }
+      res.end(`open-probe proxy error: ${err.message}`);
+    });
+  });
+  if (options.wsSink) {
+    attachWsSink(server, options.wsSink);
+  }
+  async function handle(req, res) {
+    const url = req.url ?? "/";
+    if (url === runtimePath) {
+      try {
+        const code = await fs.readFile(scriptFile, "utf-8");
+        res.writeHead(200, {
+          "Content-Type": "application/javascript; charset=utf-8",
+          "Cache-Control": "no-cache",
+          "Access-Control-Allow-Origin": "*"
+        });
+        res.end(code);
+      } catch (err) {
+        res.writeHead(500);
+        res.end(`Failed to read runtime: ${err.message}`);
+      }
+      return;
+    }
+    if (url === "/__open-probe/health") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ ok: true, target: options.target }));
+      return;
+    }
+    proxyRequest(req, res);
+  }
+  function proxyRequest(req, res) {
+    const headers = { ...req.headers };
+    headers.host = targetUrl.host;
+    delete headers["accept-encoding"];
+    const upstream = requestFn(
+      {
+        protocol: targetUrl.protocol,
+        host: targetUrl.hostname,
+        port: targetUrl.port || (targetUrl.protocol === "https:" ? 443 : 80),
+        method: req.method,
+        path: req.url,
+        headers
+      },
+      (proxyRes) => {
+        const upstreamHeaders = { ...proxyRes.headers };
+        delete upstreamHeaders["content-length"];
+        delete upstreamHeaders["content-encoding"];
+        const ct = String(proxyRes.headers["content-type"] ?? "");
+        const wantsInjection = ct.includes("text/html") && isHtmlAccept(req);
+        if (!wantsInjection) {
+          res.writeHead(proxyRes.statusCode ?? 502, upstreamHeaders);
+          proxyRes.pipe(res);
+          return;
+        }
+        const chunks = [];
+        proxyRes.on("data", (chunk) => chunks.push(chunk));
+        proxyRes.on("end", () => {
+          const body = Buffer.concat(chunks).toString("utf8");
+          const injected = injectIntoHtml(body, injection);
+          res.writeHead(proxyRes.statusCode ?? 200, upstreamHeaders);
+          res.end(injected);
+        });
+        proxyRes.on("error", (err) => {
+          if (!res.headersSent) res.writeHead(502);
+          res.end(`upstream error: ${err.message}`);
+        });
+      }
+    );
+    upstream.on("error", (err) => {
+      if (!res.headersSent) res.writeHead(502, { "Content-Type": "text/plain" });
+      res.end(`upstream connection failed: ${err.message}`);
+    });
+    req.pipe(upstream);
+  }
+  return new Promise((resolveStart, rejectStart) => {
+    server.once("error", rejectStart);
+    server.listen(options.port, options.host, () => {
+      const address = server.address();
+      if (typeof address === "object" && address) {
+        resolveStart({
+          address: { host: options.host, port: address.port },
+          close: () => new Promise((done) => {
+            server.close(() => done());
+          })
+        });
+      } else {
+        rejectStart(new Error("failed to bind proxy server"));
+      }
+    });
+  });
+}
+export {
+  attachWsSink,
+  buildInjection,
+  createProxyServer,
+  injectIntoHtml
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/server.ts","../src/injector.ts","../src/ws-sink.ts"],"sourcesContent":["import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';\nimport { request as httpRequest } from 'node:http';\nimport { request as httpsRequest } from 'node:https';\nimport { URL } from 'node:url';\nimport { promises as fs } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, resolve } from 'node:path';\nimport type { DeepPartial, ProbeConfig } from '@open-probe/shared';\nimport { buildInjection, injectIntoHtml } from './injector.js';\nimport { attachWsSink, type WsSinkOptions } from './ws-sink.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nexport interface ProxyOptions {\n target: string;\n port: number;\n host: string;\n /** Path served as the open-probe runtime */\n runtimePath?: string;\n config?: DeepPartial<ProbeConfig>;\n /** Override path to the IIFE bundle */\n scriptFile?: string;\n /**\n * Enable a WebSocket sink. When set, the proxy will accept WS upgrade\n * requests on `wsSink.path` and forward each text payload to\n * `wsSink.onMessage`. Useful for editors that don't support MCP.\n */\n wsSink?: WsSinkOptions;\n}\n\nexport type { WsSinkOptions } from './ws-sink.js';\n\nconst DEFAULT_RUNTIME_PATH = '/__open-probe/runtime.js';\n\nasync function locateScriptFile(override?: string): Promise<string> {\n if (override) return override;\n const candidates = [\n resolve(__dirname, '../../core/dist/index.global.js'),\n resolve(__dirname, '../../../core/dist/index.global.js'),\n resolve(process.cwd(), 'node_modules/@open-probe/core/dist/index.global.js'),\n ];\n for (const path of candidates) {\n try {\n await fs.access(path);\n return path;\n } catch {\n // try next\n }\n }\n throw new Error(\n 'Could not locate @open-probe/core IIFE bundle. Run `pnpm --filter @open-probe/core build` first.'\n );\n}\n\nfunction isHtmlAccept(req: IncomingMessage): boolean {\n const accept = req.headers.accept;\n if (!accept) return false;\n return accept.includes('text/html');\n}\n\nexport async function createProxyServer(options: ProxyOptions) {\n const targetUrl = new URL(options.target);\n const runtimePath = options.runtimePath ?? DEFAULT_RUNTIME_PATH;\n const scriptFile = await locateScriptFile(options.scriptFile);\n const injection = buildInjection(runtimePath, options.config ?? {});\n\n const requestFn = targetUrl.protocol === 'https:' ? httpsRequest : httpRequest;\n\n const server = createServer((req, res) => {\n handle(req, res).catch(err => {\n // eslint-disable-next-line no-console\n console.error('[open-probe proxy] error:', err);\n if (!res.headersSent) {\n res.writeHead(502, { 'Content-Type': 'text/plain' });\n }\n res.end(`open-probe proxy error: ${(err as Error).message}`);\n });\n });\n\n if (options.wsSink) {\n attachWsSink(server, options.wsSink);\n }\n\n async function handle(req: IncomingMessage, res: ServerResponse): Promise<void> {\n const url = req.url ?? '/';\n\n if (url === runtimePath) {\n try {\n const code = await fs.readFile(scriptFile, 'utf-8');\n res.writeHead(200, {\n 'Content-Type': 'application/javascript; charset=utf-8',\n 'Cache-Control': 'no-cache',\n 'Access-Control-Allow-Origin': '*',\n });\n res.end(code);\n } catch (err) {\n res.writeHead(500);\n res.end(`Failed to read runtime: ${(err as Error).message}`);\n }\n return;\n }\n\n if (url === '/__open-probe/health') {\n res.writeHead(200, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ ok: true, target: options.target }));\n return;\n }\n\n proxyRequest(req, res);\n }\n\n function proxyRequest(req: IncomingMessage, res: ServerResponse): void {\n const headers = { ...req.headers };\n headers.host = targetUrl.host;\n delete headers['accept-encoding']; // We want to inspect HTML; disable compression.\n\n const upstream = requestFn(\n {\n protocol: targetUrl.protocol,\n host: targetUrl.hostname,\n port: targetUrl.port || (targetUrl.protocol === 'https:' ? 443 : 80),\n method: req.method,\n path: req.url,\n headers,\n },\n proxyRes => {\n const upstreamHeaders = { ...proxyRes.headers };\n delete upstreamHeaders['content-length'];\n delete upstreamHeaders['content-encoding'];\n\n const ct = String(proxyRes.headers['content-type'] ?? '');\n const wantsInjection = ct.includes('text/html') && isHtmlAccept(req);\n\n if (!wantsInjection) {\n res.writeHead(proxyRes.statusCode ?? 502, upstreamHeaders);\n proxyRes.pipe(res);\n return;\n }\n\n const chunks: Buffer[] = [];\n proxyRes.on('data', chunk => chunks.push(chunk as Buffer));\n proxyRes.on('end', () => {\n const body = Buffer.concat(chunks).toString('utf8');\n const injected = injectIntoHtml(body, injection);\n res.writeHead(proxyRes.statusCode ?? 200, upstreamHeaders);\n res.end(injected);\n });\n proxyRes.on('error', err => {\n if (!res.headersSent) res.writeHead(502);\n res.end(`upstream error: ${err.message}`);\n });\n }\n );\n\n upstream.on('error', err => {\n if (!res.headersSent) res.writeHead(502, { 'Content-Type': 'text/plain' });\n res.end(`upstream connection failed: ${err.message}`);\n });\n\n req.pipe(upstream);\n }\n\n return new Promise<{\n close(): Promise<void>;\n address: { host: string; port: number };\n }>((resolveStart, rejectStart) => {\n server.once('error', rejectStart);\n server.listen(options.port, options.host, () => {\n const address = server.address();\n if (typeof address === 'object' && address) {\n resolveStart({\n address: { host: options.host, port: address.port },\n close: () =>\n new Promise<void>(done => {\n server.close(() => done());\n }),\n });\n } else {\n rejectStart(new Error('failed to bind proxy server'));\n }\n });\n });\n}\n","import type { DeepPartial, ProbeConfig } from '@open-probe/shared';\n\nconst HEAD_MATCH = /<head([^>]*)>/i;\n\nexport function buildInjection(scriptUrl: string, config: DeepPartial<ProbeConfig>): string {\n const json = JSON.stringify(config).replace(/</g, '\\\\u003c');\n return `<script>window.__OPEN_PROBE_CONFIG__=${json};</script><script src=\"${scriptUrl}\" defer></script>`;\n}\n\nexport function injectIntoHtml(html: string, snippet: string): string {\n if (!HEAD_MATCH.test(html)) {\n return html.replace(/<html([^>]*)>/i, `<html$1><head>${snippet}</head>`);\n }\n return html.replace(HEAD_MATCH, match => `${match}${snippet}`);\n}\n","import { createHash } from 'node:crypto';\nimport type { Server, IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\n\n/**\n * Minimal RFC 6455 WebSocket sink. Receives text frames from the browser,\n * decodes them to UTF-8, and forwards each payload to `onMessage`. Supports\n * masked client frames, payload lengths up to 4 GiB, ping → pong replies,\n * and graceful close. Server never originates messages, so encode logic is\n * limited to control frames.\n */\n\nconst GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';\n\nexport interface WsSinkOptions {\n path: string;\n onMessage(payload: string, info: { remoteAddress: string }): void;\n onError?(err: Error): void;\n}\n\nexport function attachWsSink(server: Server, opts: WsSinkOptions): void {\n server.on('upgrade', (req: IncomingMessage, socket: Duplex) => {\n if ((req.url ?? '/') !== opts.path) {\n socket.destroy();\n return;\n }\n const key = req.headers['sec-websocket-key'];\n if (typeof key !== 'string' || !key) {\n socket.destroy();\n return;\n }\n const accept = createHash('sha1').update(`${key}${GUID}`).digest('base64');\n socket.write(\n 'HTTP/1.1 101 Switching Protocols\\r\\n' +\n 'Upgrade: websocket\\r\\n' +\n 'Connection: Upgrade\\r\\n' +\n `Sec-WebSocket-Accept: ${accept}\\r\\n` +\n '\\r\\n'\n );\n const remote = req.socket.remoteAddress ?? '';\n pumpFrames(\n socket,\n text => opts.onMessage(text, { remoteAddress: remote }),\n err => opts.onError?.(err)\n );\n });\n}\n\nfunction pumpFrames(socket: Duplex, onText: (text: string) => void, onError: (e: Error) => void): void {\n let buffer = Buffer.alloc(0);\n let textChunks: Buffer[] = [];\n\n socket.on('data', (chunk: Buffer) => {\n buffer = (buffer.length ? Buffer.concat([buffer, chunk]) : chunk) as typeof buffer;\n while (buffer.length >= 2) {\n const frame = parseFrame(buffer);\n if (!frame) return;\n buffer = buffer.subarray(frame.consumed);\n\n if (frame.opcode === 0x0 || frame.opcode === 0x1) {\n textChunks.push(frame.payload);\n if (frame.fin) {\n const full = Buffer.concat(textChunks).toString('utf8');\n textChunks = [];\n try {\n onText(full);\n } catch (err) {\n onError(err as Error);\n }\n }\n } else if (frame.opcode === 0x8) {\n socket.end(encodeFrame(0x8, frame.payload));\n return;\n } else if (frame.opcode === 0x9) {\n try {\n socket.write(encodeFrame(0xa, frame.payload));\n } catch {\n /* ignore */\n }\n }\n // 0xA pong & 0x2 binary: ignored.\n }\n });\n socket.on('error', err => onError(err));\n}\n\ninterface ParsedFrame {\n fin: boolean;\n opcode: number;\n payload: Buffer;\n consumed: number;\n}\n\nfunction parseFrame(buffer: Buffer): ParsedFrame | null {\n if (buffer.length < 2) return null;\n const b0 = buffer[0]!;\n const b1 = buffer[1]!;\n const fin = (b0 & 0x80) !== 0;\n const opcode = b0 & 0x0f;\n const masked = (b1 & 0x80) !== 0;\n let payloadLen = b1 & 0x7f;\n let offset = 2;\n\n if (payloadLen === 126) {\n if (buffer.length < offset + 2) return null;\n payloadLen = buffer.readUInt16BE(offset);\n offset += 2;\n } else if (payloadLen === 127) {\n if (buffer.length < offset + 8) return null;\n const hi = buffer.readUInt32BE(offset);\n const lo = buffer.readUInt32BE(offset + 4);\n if (hi !== 0 || lo > 0x7fffffff) return null;\n payloadLen = lo;\n offset += 8;\n }\n\n let mask: Buffer | null = null;\n if (masked) {\n if (buffer.length < offset + 4) return null;\n mask = buffer.subarray(offset, offset + 4);\n offset += 4;\n }\n\n if (buffer.length < offset + payloadLen) return null;\n let payload = buffer.subarray(offset, offset + payloadLen);\n if (mask) {\n const out = Buffer.allocUnsafe(payloadLen);\n for (let i = 0; i < payloadLen; i++) out[i] = payload[i]! ^ mask[i & 3]!;\n payload = out;\n }\n return { fin, opcode, payload, consumed: offset + payloadLen };\n}\n\nfunction encodeFrame(opcode: number, payload: Buffer): Buffer {\n const len = payload.length;\n let header: Buffer;\n if (len < 126) {\n header = Buffer.from([0x80 | opcode, len]);\n } else if (len < 0x10000) {\n header = Buffer.alloc(4);\n header[0] = 0x80 | opcode;\n header[1] = 126;\n header.writeUInt16BE(len, 2);\n } else {\n header = Buffer.alloc(10);\n header[0] = 0x80 | opcode;\n header[1] = 127;\n header.writeUInt32BE(0, 2);\n header.writeUInt32BE(len, 6);\n }\n return Buffer.concat([header, payload]);\n}\n"],"mappings":"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","names":[]}

package/package.json ADDED Viewed

@@ -0,0 +1,67 @@
+{
+  "name": "@open-probe/proxy",
+  "version": "0.1.1",
+  "description": "Reverse proxy that injects open-probe runtime into any dev server.",
+  "license": "MIT",
+  "author": "open-probe contributors",
+  "homepage": "https://github.com/wzc520pyfm/open-probe/tree/main/packages/proxy#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wzc520pyfm/open-probe.git",
+    "directory": "packages/proxy"
+  },
+  "bugs": {
+    "url": "https://github.com/wzc520pyfm/open-probe/issues"
+  },
+  "keywords": [
+    "open-probe",
+    "reverse-proxy",
+    "injection",
+    "dev-server",
+    "html-rewrite"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "open-probe-proxy": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.18"
+  },
+  "dependencies": {
+    "cac": "^6.7.14",
+    "@open-probe/shared": "0.1.1",
+    "@open-probe/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "start": "node dist/cli.js",
+    "clean": "rm -rf dist"
+  }
+}