peep-proxy 0.1.0

package/dist/utils/getTabText.js

@@ -0,0 +1,96 @@
+import { hasBinaryBytes, isBinaryContentType, parseContentType, } from "./contentType.js";
+import { decompressBody } from "./decompress.js";
+import { formatBytes } from "./formatBytes.js";
+function formatHeaders(headers) {
+    return Object.entries(headers)
+        .flatMap(([key, value]) => {
+        if (Array.isArray(value)) {
+            return value.map((v) => `${key}: ${v}`);
+        }
+        return [`${key}: ${value ?? ""}`];
+    })
+        .join("\n");
+}
+function getRequestBodyText(entry) {
+    if (entry.request.body.length === 0) {
+        return "Empty body";
+    }
+    const body = decompressBody(entry.request.body, entry.request.headers);
+    const mime = parseContentType(entry.request.headers);
+    if (isBinaryContentType(mime) || hasBinaryBytes(body)) {
+        const label = mime || "unknown";
+        const size = formatBytes(entry.request.body.length);
+        return `[Binary content: ${label}, ${size}]`;
+    }
+    return body.toString("utf-8");
+}
+function getResponseBodyText(entry) {
+    if (entry.state === "pending" || !entry.response) {
+        return "Waiting for response...";
+    }
+    if (entry.response.body.length === 0) {
+        return "Empty body";
+    }
+    const body = decompressBody(entry.response.body, entry.response.headers);
+    const mime = parseContentType(entry.response.headers);
+    if (isBinaryContentType(mime) || hasBinaryBytes(body)) {
+        const label = mime || "unknown";
+        const size = formatBytes(entry.response.body.length);
+        return `[Binary content: ${label}, ${size}]`;
+    }
+    return body.toString("utf-8");
+}
+function getRawRequest(entry) {
+    const { method, path, headers, body } = entry.request;
+    const lines = [`${method} ${path} HTTP/1.1`, formatHeaders(headers)];
+    if (body.length > 0) {
+        lines.push("");
+        const decompressed = decompressBody(body, headers);
+        const mime = parseContentType(headers);
+        if (isBinaryContentType(mime) || hasBinaryBytes(decompressed)) {
+            const label = mime || "unknown";
+            const size = formatBytes(body.length);
+            lines.push(`[Binary content: ${label}, ${size}]`);
+        }
+        else {
+            lines.push(decompressed.toString("utf-8"));
+        }
+    }
+    return lines.join("\n");
+}
+function getRawResponse(entry) {
+    if (entry.state === "pending" || !entry.response) {
+        return "Waiting for response...";
+    }
+    const { statusCode, headers, body } = entry.response;
+    const lines = [`HTTP/1.1 ${statusCode}`, formatHeaders(headers)];
+    if (body.length > 0) {
+        lines.push("");
+        const decompressed = decompressBody(body, headers);
+        const mime = parseContentType(headers);
+        if (isBinaryContentType(mime) || hasBinaryBytes(decompressed)) {
+            const label = mime || "unknown";
+            const size = formatBytes(body.length);
+            lines.push(`[Binary content: ${label}, ${size}]`);
+        }
+        else {
+            lines.push(decompressed.toString("utf-8"));
+        }
+    }
+    return lines.join("\n");
+}
+export function getTabText(entry, side, tab) {
+    if (tab === "headers") {
+        const headers = side === "request" ? entry.request.headers : entry.response?.headers;
+        if (!headers)
+            return "Waiting for response...";
+        return formatHeaders(headers);
+    }
+    if (tab === "body") {
+        if (side === "request")
+            return getRequestBodyText(entry);
+        return getResponseBodyText(entry);
+    }
+    // raw
+    return side === "request" ? getRawRequest(entry) : getRawResponse(entry);
+}

package/dist/utils/highlightBody.d.ts

@@ -0,0 +1,3 @@
+export declare function highlightJson(text: string): string;
+export declare function highlightHtml(text: string): string;
+export declare function highlightBody(text: string, language: "json" | "html" | "xml" | "plain"): string;

package/dist/utils/highlightBody.js

@@ -0,0 +1,43 @@
+import chalk from "chalk";
+export function highlightJson(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+    const pretty = JSON.stringify(parsed, null, 2);
+    return pretty.replace(/("(?:[^"\\]|\\.)*")(\s*:)?|(\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b)|(\btrue\b|\bfalse\b)|(\bnull\b)/g, (_match, str, colon, num, bool, nil) => {
+        if (str && colon)
+            return chalk.cyan(str) + colon;
+        if (str)
+            return chalk.green(str);
+        if (num)
+            return chalk.yellow(num);
+        if (bool)
+            return chalk.magenta(bool);
+        if (nil)
+            return chalk.red(nil);
+        return _match;
+    });
+}
+export function highlightHtml(text) {
+    return text.replace(/<\/?[\w-]+(?:\s+[\w-]+(?:=(?:"[^"]*"|'[^']*'|[^\s>]*))?)*\s*\/?>/g, (tag) => {
+        return tag
+            .replace(/^(<\/?)(\w[\w-]*)/, (_m, bracket, name) => chalk.cyan(bracket + name))
+            .replace(/([\w-]+)(=)("[^"]*"|'[^']*'|[^\s>]*)/g, (_m, attr, eq, val) => chalk.yellow(attr) + eq + chalk.green(val))
+            .replace(/(\/?)(>)$/, (_m, slash, bracket) => chalk.cyan(slash + bracket));
+    });
+}
+export function highlightBody(text, language) {
+    switch (language) {
+        case "json":
+            return highlightJson(text);
+        case "html":
+        case "xml":
+            return highlightHtml(text);
+        case "plain":
+            return text;
+    }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "peep-proxy",
+	"version": "0.1.0",
+	"description": "A TUI HTTP proxy for developers. Proxyman, but in your terminal.",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/mvacoimbra/peep.git"
+	},
+	"homepage": "https://github.com/mvacoimbra/peep#readme",
+	"author": "Matheus Coimbra",
+	"keywords": [
+		"proxy",
+		"http",
+		"https",
+		"tui",
+		"terminal",
+		"debug",
+		"inspect",
+		"traffic",
+		"ink"
+	],
+	"bin": {
+		"peep": "dist/cli.js"
+	},
+	"type": "module",
+	"packageManager": "pnpm@10.18.1",
+	"engines": {
+		"node": ">=18"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"format": "biome format .",
+		"lint": "biome lint .",
+		"format:fix": "biome format --write .",
+		"lint:fix": "biome check --write --unsafe ."
+	},
+	"files": [
+		"dist"
+	],
+	"dependencies": {
+		"chalk": "^5.6.2",
+		"cli-truncate": "^5.1.1",
+		"ink": "^4.1.0",
+		"meow": "^11.0.0",
+		"node-forge": "^1.3.3",
+		"react": "^18.2.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.14",
+		"@sindresorhus/tsconfig": "^3.0.1",
+		"@types/node-forge": "^1.3.14",
+		"@types/react": "^18.0.32",
+		"typescript": "^5.0.3"
+	}
+}

package/readme.md

@@ -0,0 +1,73 @@
+# peep
+
+A TUI HTTP proxy for developers who want to see what's going on. Think [Proxyman](https://proxyman.io), but in your terminal.
+
+Built with [Ink](https://github.com/vadimdemedes/ink) and React.
+
+> **Status:** Under active development. Core proxy and TUI are functional.
+
+## Why
+
+Debugging HTTP traffic shouldn't require leaving the terminal. Peep sits between your app and the internet, letting you inspect requests and responses in a clean terminal UI.
+
+## Features
+
+- HTTP and HTTPS interception (automatic CA generation and trust)
+- Three-panel TUI: domain sidebar, request list, request/response detail
+- Request/response detail with headers, body, and raw views
+- Syntax-highlighted body previews (JSON, HTML, CSS, XML)
+- Domain grouping and filtering in the sidebar
+- Sortable request list (by method, URL, status, duration, size)
+- Vim-style keyboard navigation (`hjkl`, `gg`/`G`)
+- Copy request/response to clipboard
+- Automatic system proxy configuration (macOS)
+- Firefox/Zen NSS certificate store support
+
+## Usage
+
+```bash
+peep              # start on default port 8080
+peep --port=3128  # custom port
+```
+
+Peep will automatically configure itself as the system HTTP proxy and install its CA certificate on first run.
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `j` / `k` | Scroll up/down |
+| `h` / `l` | Switch panels / expand-collapse groups / switch tabs |
+| `Enter` | Select / drill into detail |
+| `Esc` | Go back |
+| `s` | Sort request list |
+| `y` | Copy to clipboard |
+| `gg` / `G` | Jump to top/bottom |
+| `q` | Quit |
+
+## Install
+
+```bash
+npm install --global peep-proxy
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm dev       # watch mode
+pnpm build     # compile
+pnpm lint      # check linting
+pnpm format    # check formatting
+```
+
+## Tech Stack
+
+- **Runtime:** Node.js
+- **UI:** Ink v4 + React 18
+- **Language:** TypeScript
+- **Tooling:** Biome (lint + format), pnpm
+
+## License
+
+MIT