portprism 2.0.1 → 2.0.3

package/dist/inspector.d.ts

@@ -0,0 +1,58 @@
+/** Raw event the Agent emits on its `traffic` channel. */
+export interface TrafficEvent {
+    phase: "request" | "response";
+    id: string;
+    ts?: number;
+    method?: string;
+    path?: string;
+    /** base64 (as it travels on the wire); decoded for display. */
+    body?: string;
+    headers?: Record<string, string>;
+    status?: number;
+    durationMs?: number;
+}
+/** A decoded request/response body plus how to interpret it. */
+interface DecodedBody {
+    /** Decoded UTF-8 text, or base64 for binary payloads. `null` when empty. */
+    text: string | null;
+    binary: boolean;
+    /** Byte length of the full (pre-truncation) payload. */
+    size: number;
+    truncated: boolean;
+}
+/** One fully-merged entry in the ledger. */
+export interface RequestRecord {
+    id: string;
+    ts: number;
+    method: string;
+    path: string;
+    query: Record<string, string> | null;
+    reqHeaders: Record<string, string>;
+    reqBody: DecodedBody;
+    status?: number;
+    resHeaders?: Record<string, string>;
+    resBody?: DecodedBody;
+    durationMs?: number;
+    pending: boolean;
+}
+export declare class Inspector {
+    private readonly records;
+    private readonly byId;
+    private readonly sseClients;
+    private server;
+    private boundPort;
+    /** Ingest one traffic event from the agent, merging by request id. */
+    record(evt: TrafficEvent): void;
+    /** Compact summary used by the list view. */
+    private summary;
+    private broadcast;
+    /**
+     * Start the inspector HTTP server. Resolves with the bound URL, or `null` if the
+     * port is already taken (the tunnel must never fail because :4040 is busy).
+     */
+    start(port: number): Promise<string | null>;
+    stop(): void;
+    private handle;
+}
+export {};
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"AAgBA,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gEAAgE;AAChE,UAAU,WAAW;IACnB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AA6CD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAAuB;IAExC,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAmC/B,6CAA6C;IAC7C,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,SAAS;IAYjB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkB3C,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,MAAM;CA8Cf"}

package/dist/inspector.js

@@ -0,0 +1,328 @@
+/**
+ * inspector.ts — the `--inspect` Local Request Inspector.
+ *
+ * An ngrok-style traffic ledger served on localhost:4040. Every HTTP request the
+ * agent forwards to the local server is recorded here with its headers, query
+ * params, and (decoded) bodies, then surfaced through a small web UI and a JSON
+ * API — handy for webhook / API debugging.
+ *
+ * The agent emits `traffic` events ({ phase: "request" | "response", ... }); this
+ * module records them, merges the two phases by id, and pushes live updates to any
+ * connected browser over Server-Sent Events. Built on Node's native `http` — no
+ * extra dependency ships in the published CLI.
+ */
+import http from "node:http";
+const MAX_RECORDS = 200;
+const MAX_BODY_BYTES = 256 * 1024;
+/** Content types we render as text rather than base64. */
+const TEXT_CONTENT_RE = /(json|text\/|xml|x-www-form-urlencoded|javascript|html|csv|graphql)/i;
+/** Split a raw request path into its pathname and parsed query object. */
+function splitPath(rawPath) {
+    const qIdx = rawPath.indexOf("?");
+    if (qIdx === -1)
+        return { path: rawPath, query: null };
+    const path = rawPath.slice(0, qIdx);
+    const query = {};
+    const params = new URLSearchParams(rawPath.slice(qIdx + 1));
+    for (const [k, v] of params)
+        query[k] = v;
+    return { path, query: Object.keys(query).length ? query : null };
+}
+/** Decode a base64 wire body into text (or capped base64 for binary). */
+function decodeBody(base64, headers) {
+    if (!base64)
+        return { text: null, binary: false, size: 0, truncated: false };
+    const buf = Buffer.from(base64, "base64");
+    const size = buf.length;
+    const truncated = size > MAX_BODY_BYTES;
+    const slice = truncated ? buf.subarray(0, MAX_BODY_BYTES) : buf;
+    const contentType = (headers?.["content-type"] ?? "").toLowerCase();
+    const looksText = contentType
+        ? TEXT_CONTENT_RE.test(contentType)
+        : !slice.includes(0); // no content-type: treat as text unless it has NUL bytes
+    if (looksText) {
+        return { text: slice.toString("utf8"), binary: false, size, truncated };
+    }
+    return { text: slice.toString("base64"), binary: true, size, truncated };
+}
+export class Inspector {
+    records = [];
+    byId = new Map();
+    sseClients = new Set();
+    server = null;
+    boundPort = null;
+    /** Ingest one traffic event from the agent, merging by request id. */
+    record(evt) {
+        if (evt.phase === "request") {
+            const { path, query } = splitPath(evt.path ?? "");
+            const rec = {
+                id: evt.id,
+                ts: evt.ts ?? Date.now(),
+                method: evt.method ?? "GET",
+                path,
+                query,
+                reqHeaders: evt.headers ?? {},
+                reqBody: decodeBody(evt.body, evt.headers),
+                pending: true,
+            };
+            this.byId.set(rec.id, rec);
+            this.records.push(rec);
+            // Evict oldest beyond the cap.
+            while (this.records.length > MAX_RECORDS) {
+                const dropped = this.records.shift();
+                if (dropped)
+                    this.byId.delete(dropped.id);
+            }
+            this.broadcast(rec);
+            return;
+        }
+        // response phase — merge into the existing record.
+        const rec = this.byId.get(evt.id);
+        if (!rec)
+            return;
+        rec.status = evt.status;
+        rec.resHeaders = evt.headers ?? {};
+        rec.resBody = decodeBody(evt.body, evt.headers);
+        rec.durationMs = evt.durationMs;
+        rec.pending = false;
+        this.broadcast(rec);
+    }
+    /** Compact summary used by the list view. */
+    summary(r) {
+        return {
+            id: r.id,
+            ts: r.ts,
+            method: r.method,
+            path: r.path,
+            status: r.status ?? null,
+            durationMs: r.durationMs ?? null,
+            pending: r.pending,
+            reqSize: r.reqBody.size,
+            resSize: r.resBody?.size ?? 0,
+            resContentType: r.resHeaders?.["content-type"] ?? null,
+        };
+    }
+    broadcast(rec) {
+        if (this.sseClients.size === 0)
+            return;
+        const line = `data: ${JSON.stringify(this.summary(rec))}\n\n`;
+        for (const res of this.sseClients) {
+            try {
+                res.write(line);
+            }
+            catch {
+                /* client gone; cleaned up on close */
+            }
+        }
+    }
+    /**
+     * Start the inspector HTTP server. Resolves with the bound URL, or `null` if the
+     * port is already taken (the tunnel must never fail because :4040 is busy).
+     */
+    start(port) {
+        return new Promise((resolve) => {
+            const server = http.createServer((req, res) => this.handle(req, res));
+            server.once("error", (err) => {
+                if (err.code === "EADDRINUSE") {
+                    resolve(null);
+                }
+                else {
+                    resolve(null);
+                }
+            });
+            server.listen(port, "127.0.0.1", () => {
+                this.server = server;
+                this.boundPort = server.address().port;
+                resolve(`http://localhost:${this.boundPort}`);
+            });
+        });
+    }
+    stop() {
+        for (const res of this.sseClients) {
+            try {
+                res.end();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.sseClients.clear();
+        this.server?.close();
+        this.server = null;
+    }
+    handle(req, res) {
+        const url = req.url ?? "/";
+        if (url === "/" || url === "/index.html") {
+            res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+            res.end(INDEX_HTML);
+            return;
+        }
+        if (url === "/__pp/requests") {
+            const body = JSON.stringify(this.records.map((r) => this.summary(r)).reverse());
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(body);
+            return;
+        }
+        if (url.startsWith("/__pp/requests/")) {
+            const id = decodeURIComponent(url.slice("/__pp/requests/".length));
+            const rec = this.byId.get(id);
+            if (!rec) {
+                res.writeHead(404, { "content-type": "application/json" });
+                res.end(JSON.stringify({ error: "not found" }));
+                return;
+            }
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(JSON.stringify(rec));
+            return;
+        }
+        if (url === "/__pp/stream") {
+            res.writeHead(200, {
+                "content-type": "text/event-stream",
+                "cache-control": "no-cache",
+                connection: "keep-alive",
+            });
+            res.write("retry: 3000\n\n");
+            this.sseClients.add(res);
+            req.on("close", () => this.sseClients.delete(res));
+            return;
+        }
+        res.writeHead(404, { "content-type": "text/plain" });
+        res.end("Not found");
+    }
+}
+// ── Web UI ──────────────────────────────────────────────────────────────────────
+// Single self-contained page. Client JS uses string concatenation (no template
+// literals) so it survives being embedded in this module's own template literal.
+const INDEX_HTML = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>PortPrism Inspector</title>
+<style>
+  :root { color-scheme: dark; }
+  * { box-sizing: border-box; }
+  body { margin:0; font:13px/1.5 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
+         background:#0b0d12; color:#e6e8ee; }
+  header { display:flex; align-items:center; gap:10px; padding:12px 16px;
+           border-bottom:1px solid #1c2030; background:#0e1017; position:sticky; top:0; }
+  header .logo { font-weight:700; background:linear-gradient(90deg,#6366f1,#8b5cf6,#34d399);
+                 -webkit-background-clip:text; background-clip:text; color:transparent; }
+  header .dim { color:#7b8194; font-size:12px; }
+  header .live { margin-left:auto; display:flex; align-items:center; gap:6px; color:#7b8194; }
+  header .dot { width:8px; height:8px; border-radius:50%; background:#34d399; box-shadow:0 0 8px #34d399; }
+  .layout { display:grid; grid-template-columns: 1fr; }
+  table { width:100%; border-collapse:collapse; }
+  th,td { text-align:left; padding:7px 12px; border-bottom:1px solid #151824; white-space:nowrap; }
+  th { color:#7b8194; font-weight:600; font-size:11px; text-transform:uppercase; letter-spacing:.05em; }
+  tr.row { cursor:pointer; }
+  tr.row:hover { background:#12151f; }
+  .method { font-weight:700; }
+  .m-GET{color:#34d399} .m-POST{color:#60a5fa} .m-PUT{color:#fbbf24}
+  .m-DELETE{color:#f87171} .m-PATCH{color:#c084fc}
+  .st-2{color:#34d399} .st-3{color:#60a5fa} .st-4{color:#fbbf24} .st-5{color:#f87171}
+  .pending{color:#7b8194}
+  .path { color:#e6e8ee; max-width:48vw; overflow:hidden; text-overflow:ellipsis; }
+  .empty { padding:48px 16px; text-align:center; color:#7b8194; }
+  dialog { width:min(860px,92vw); max-height:86vh; overflow:auto; background:#0e1017;
+           color:#e6e8ee; border:1px solid #262b3d; border-radius:12px; padding:0; }
+  dialog::backdrop { background:rgba(0,0,0,.6); }
+  .d-head { display:flex; align-items:center; gap:10px; padding:14px 18px; border-bottom:1px solid #1c2030;
+            position:sticky; top:0; background:#0e1017; }
+  .d-head .x { margin-left:auto; cursor:pointer; color:#7b8194; background:none; border:none; font-size:18px; }
+  .d-body { padding:14px 18px; }
+  h4 { margin:18px 0 6px; color:#7b8194; font-size:11px; text-transform:uppercase; letter-spacing:.05em; }
+  h4:first-child { margin-top:0; }
+  pre { margin:0; padding:10px 12px; background:#0b0d12; border:1px solid #151824; border-radius:8px;
+        overflow:auto; white-space:pre-wrap; word-break:break-word; }
+  .kv { display:grid; grid-template-columns:200px 1fr; gap:2px 12px; }
+  .kv .k { color:#7b8194; } .kv .v { word-break:break-word; }
+  .tag { font-size:11px; color:#7b8194; }
+</style>
+</head>
+<body>
+<header>
+  <span class="logo">PortPrism</span><span class="dim">Request Inspector</span>
+  <span class="live"><span class="dot"></span> live</span>
+</header>
+<div class="layout">
+  <table>
+    <thead><tr><th>Time</th><th>Method</th><th>Status</th><th>Path</th><th>Dur</th><th>Size</th></tr></thead>
+    <tbody id="rows"></tbody>
+  </table>
+  <div class="empty" id="empty">Waiting for requests… send traffic through your tunnel.</div>
+</div>
+<dialog id="dlg"><div class="d-head"><b id="d-title"></b><button class="x" id="d-close">✕</button></div><div class="d-body" id="d-body"></div></dialog>
+<script>
+(function(){
+  var rows = document.getElementById("rows");
+  var empty = document.getElementById("empty");
+  var dlg = document.getElementById("dlg");
+  var seen = {};
+
+  function esc(s){ return String(s).replace(/[&<>"]/g, function(c){
+    return {"&":"&amp;","<":"&lt;",">":"&gt;","\\"":"&quot;"}[c]; }); }
+  function mclass(m){ return "method m-" + esc(m); }
+  function sclass(s){ return s ? "st-" + String(s)[0] : "pending"; }
+  function fmtTime(ts){ var d = new Date(ts); return d.toLocaleTimeString(); }
+  function fmtSize(n){ if(!n) return "—"; if(n<1024) return n+" B"; return (n/1024).toFixed(1)+" KB"; }
+  function fmtDur(d){ return d==null ? "…" : d+" ms"; }
+
+  function upsert(s){
+    empty.style.display = "none";
+    var id = s.id;
+    var tr = document.getElementById("r-"+id);
+    var html = "<td>"+fmtTime(s.ts)+"</td>"
+      + "<td class='"+mclass(s.method)+"'>"+esc(s.method)+"</td>"
+      + "<td class='"+sclass(s.status)+"'>"+(s.status||"…")+"</td>"
+      + "<td class='path'>"+esc(s.path)+"</td>"
+      + "<td class='tag'>"+fmtDur(s.durationMs)+"</td>"
+      + "<td class='tag'>"+fmtSize(s.resSize||s.reqSize)+"</td>";
+    if(tr){ tr.innerHTML = html; }
+    else {
+      tr = document.createElement("tr");
+      tr.className = "row"; tr.id = "r-"+id; tr.innerHTML = html;
+      tr.onclick = function(){ openDetail(id); };
+      rows.insertBefore(tr, rows.firstChild);
+    }
+  }
+
+  function section(title, obj){
+    if(!obj || !Object.keys(obj).length) return "";
+    var out = "<h4>"+esc(title)+"</h4><div class='kv'>";
+    Object.keys(obj).forEach(function(k){
+      out += "<div class='k'>"+esc(k)+"</div><div class='v'>"+esc(obj[k])+"</div>";
+    });
+    return out + "</div>";
+  }
+  function bodySection(title, b){
+    if(!b || !b.text) return "";
+    var note = (b.binary ? " (binary, base64)" : "") + (b.truncated ? " (truncated)" : "");
+    return "<h4>"+esc(title)+note+"</h4><pre>"+esc(b.text)+"</pre>";
+  }
+
+  function openDetail(id){
+    fetch("/__pp/requests/"+encodeURIComponent(id)).then(function(r){return r.json();}).then(function(d){
+      document.getElementById("d-title").textContent = d.method+" "+d.path
+        + (d.status ? "  →  "+d.status : "");
+      var html = section("Query", d.query)
+        + section("Request headers", d.reqHeaders)
+        + bodySection("Request body", d.reqBody)
+        + section("Response headers", d.resHeaders)
+        + bodySection("Response body", d.resBody);
+      document.getElementById("d-body").innerHTML = html || "<p class='tag'>No details.</p>";
+      dlg.showModal();
+    });
+  }
+  document.getElementById("d-close").onclick = function(){ dlg.close(); };
+
+  fetch("/__pp/requests").then(function(r){return r.json();}).then(function(list){
+    list.reverse().forEach(upsert);
+  });
+  var es = new EventSource("/__pp/stream");
+  es.onmessage = function(e){ try { upsert(JSON.parse(e.data)); } catch(_){} };
+})();
+</script>
+</body>
+</html>`;
+//# sourceMappingURL=inspector.js.map

package/dist/inspector.js.map

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

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "portprism",
-  "version": "2.0.1",
+  "version": "2.0.3",
+  "license": "MIT",
   "description": "Share your local server with anyone, instantly.",
   "type": "module",
   "bin": {
@@ -16,12 +17,13 @@
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --banner:js=\"#!/usr/bin/env node\nimport { createRequire as _createRequire } from 'module';\nimport { fileURLToPath as _fileURLToPath } from 'url';\nconst require = _createRequire(import.meta.url);\nconst __filename = _fileURLToPath(import.meta.url);\nconst __dirname = _fileURLToPath(new URL('.', import.meta.url));\"",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"No tests yet\" && exit 0"
   },
   "dependencies": {
     "chalk": "^4.1.2",
     "commander": "^8.3.0",
-    "dotenv": "^10.0.0",
     "open": "^8.4.2",
     "ora": "^9.4.0",
     "puppeteer-core": "^25.0.2",

package/README.md

@@ -1,12 +0,0 @@
-# PortPrism
-
-**Share your local dev server with anyone, instantly.** No account, no config —
-point PortLens at a local port and you get a clean, branded preview URL that
-recipients open in any browser.
-
-- 🔗 **Instant public URL** for any local HTTP server
-- 🖥️ **Branded viewer** — recipients see your app, not a tunnel warning page
-- 🔒 **TLS end-to-end**; optional password protection (Pro)
-- 🔁 **Auto-reconnect** — brief network drops recover on the same URL
-- 📱 **QR code** for quick mobile testing
-- 🤖 **`--json` output** for scripts and CI