@privateclaw/privateclaw-relay 0.1.0

package/dist/tunnel.js

@@ -0,0 +1,334 @@
+import { spawn } from "node:child_process";
+import { once } from "node:events";
+export class MissingRelayTunnelBinaryError extends Error {
+    command;
+    hint;
+    constructor(command, hint) {
+        super(`Could not run the \`${command}\` CLI from PATH because it is missing or not executable. ${hint}`);
+        this.command = command;
+        this.hint = hint;
+        this.name = "MissingRelayTunnelBinaryError";
+    }
+}
+const PUBLIC_URL_PATTERN = /https:\/\/[^\s"'`<>]+/gu;
+function formatTunnelCommand(plan) {
+    return [plan.command, ...plan.args].join(" ");
+}
+function formatMissingBinaryError(command, hint) {
+    return new MissingRelayTunnelBinaryError(command, hint);
+}
+function getMissingBinaryHint(command) {
+    return command === "tailscale"
+        ? "Install Tailscale and run `tailscale up` before using `--public tailscale`."
+        : "Install cloudflared before using `--public cloudflare`.";
+}
+export function isUnavailableTunnelBinaryError(error) {
+    const code = error?.code;
+    return code === "ENOENT" || code === "EACCES" || code === "EPERM";
+}
+function trimTrailingPunctuation(value) {
+    return value.replace(/[),.;:]+$/u, "");
+}
+function emitBufferedLines(buffer, params) {
+    const lines = buffer.split(/\r?\n/u);
+    const remainder = lines.pop() ?? "";
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed !== "") {
+            params.onLog?.(`[privateclaw-relay] ${params.prefix} ${trimmed}`);
+        }
+    }
+    return remainder;
+}
+async function runOneShotCommand(params) {
+    const spawnCommand = params.spawnCommand ?? spawn;
+    const child = spawnCommand(params.plan.command, params.plan.args, {
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    let stdout = "";
+    let stderr = "";
+    let stdoutRemainder = "";
+    let stderrRemainder = "";
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+        stdout += chunk;
+        stdoutRemainder = emitBufferedLines(stdoutRemainder + chunk, {
+            prefix: params.logPrefix,
+            ...(params.onLog ? { onLog: params.onLog } : {}),
+        });
+    });
+    child.stderr.on("data", (chunk) => {
+        stderr += chunk;
+        stderrRemainder = emitBufferedLines(stderrRemainder + chunk, {
+            prefix: params.logPrefix,
+            ...(params.onLog ? { onLog: params.onLog } : {}),
+        });
+    });
+    const childError = once(child, "error").then(([error]) => {
+        throw error;
+    });
+    const childClose = once(child, "close").then(([code, signal]) => ({
+        code,
+        signal,
+    }));
+    try {
+        const { code, signal } = await Promise.race([childError, childClose]);
+        if (stdoutRemainder.trim() !== "") {
+            params.onLog?.(`[privateclaw-relay] ${params.logPrefix} ${stdoutRemainder.trim()}`);
+        }
+        if (stderrRemainder.trim() !== "") {
+            params.onLog?.(`[privateclaw-relay] ${params.logPrefix} ${stderrRemainder.trim()}`);
+        }
+        if (code !== 0) {
+            const combined = `${stdout}${stderr}`.trim();
+            throw new Error(`Command \`${formatTunnelCommand(params.plan)}\` exited with ${code == null ? `signal ${signal ?? "unknown"}` : `code ${code}`}${combined ? `: ${combined}` : "."}`);
+        }
+        return {
+            stdout,
+            stderr,
+            combined: `${stdout}${stderr}`,
+        };
+    }
+    catch (error) {
+        if (isUnavailableTunnelBinaryError(error)) {
+            throw formatMissingBinaryError(params.plan.command, getMissingBinaryHint(params.plan.command));
+        }
+        throw error;
+    }
+}
+async function stopPersistentChild(child) {
+    if (child.exitCode != null) {
+        return;
+    }
+    child.kill("SIGTERM");
+    const timer = setTimeout(() => {
+        if (child.exitCode == null) {
+            child.kill("SIGKILL");
+        }
+    }, 5_000);
+    try {
+        await once(child, "exit");
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function isRelayTunnelProvider(value) {
+    return value === "tailscale" || value === "cloudflare";
+}
+function extractPublicUrls(output) {
+    const matches = output.match(PUBLIC_URL_PATTERN);
+    if (!matches) {
+        return [];
+    }
+    return matches.map((match) => trimTrailingPunctuation(match));
+}
+export function extractRelayTunnelPublicUrl(output) {
+    return extractPublicUrls(output)[0];
+}
+export function extractCloudflareQuickTunnelPublicUrl(output) {
+    for (const candidate of extractPublicUrls(output)) {
+        try {
+            const hostname = new URL(candidate).hostname;
+            if (hostname === "trycloudflare.com" ||
+                hostname.endsWith(".trycloudflare.com")) {
+                return candidate;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+export function buildRelayTunnelCommand(params) {
+    if (params.provider === "tailscale") {
+        return {
+            command: "tailscale",
+            args: ["funnel", "--bg", String(params.localPort)],
+        };
+    }
+    return {
+        command: "cloudflared",
+        args: ["tunnel", "--url", params.localUrl],
+    };
+}
+async function openTailscaleFunnel(params) {
+    const statusPlan = {
+        command: "tailscale",
+        args: ["funnel", "status"],
+    };
+    const previousStatus = await runOneShotCommand({
+        plan: statusPlan,
+        logPrefix: "[tailscale]",
+        ...(params.onLog ? { onLog: params.onLog } : {}),
+        ...(params.spawnCommand ? { spawnCommand: params.spawnCommand } : {}),
+    }).catch((error) => {
+        if (error instanceof Error &&
+            error.message.includes("Could not find the `tailscale` CLI")) {
+            throw error;
+        }
+        return {
+            stdout: "",
+            stderr: "",
+            combined: "",
+        };
+    });
+    const hadExistingPublicUrl = extractRelayTunnelPublicUrl(previousStatus.combined) != null;
+    const enablePlan = buildRelayTunnelCommand({
+        provider: "tailscale",
+        localPort: params.localPort,
+        localUrl: params.localUrl,
+    });
+    const enableResult = await runOneShotCommand({
+        plan: enablePlan,
+        logPrefix: "[tailscale]",
+        ...(params.onLog ? { onLog: params.onLog } : {}),
+        ...(params.spawnCommand ? { spawnCommand: params.spawnCommand } : {}),
+    });
+    const currentStatus = await runOneShotCommand({
+        plan: statusPlan,
+        logPrefix: "[tailscale]",
+        ...(params.onLog ? { onLog: params.onLog } : {}),
+        ...(params.spawnCommand ? { spawnCommand: params.spawnCommand } : {}),
+    });
+    const publicUrl = extractRelayTunnelPublicUrl(currentStatus.combined) ??
+        extractRelayTunnelPublicUrl(enableResult.combined);
+    return {
+        kind: "tailscale",
+        ...(publicUrl ? { publicUrl } : {}),
+        notes: hadExistingPublicUrl
+            ? [
+                "Tailscale Funnel was already configured before this run, so the CLI will leave that public endpoint in place on shutdown.",
+            ]
+            : [
+                "The CLI will run `tailscale funnel off` on shutdown to remove the public endpoint it created.",
+            ],
+        close: async () => {
+            if (hadExistingPublicUrl) {
+                return;
+            }
+            try {
+                await runOneShotCommand({
+                    plan: {
+                        command: "tailscale",
+                        args: ["funnel", "off"],
+                    },
+                    logPrefix: "[tailscale]",
+                    ...(params.onLog ? { onLog: params.onLog } : {}),
+                    ...(params.spawnCommand ? { spawnCommand: params.spawnCommand } : {}),
+                });
+            }
+            catch (error) {
+                params.onLog?.(`[privateclaw-relay] [tailscale] failed to disable Funnel automatically: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+}
+async function openCloudflareTunnel(params) {
+    const spawnCommand = params.spawnCommand ?? spawn;
+    const plan = buildRelayTunnelCommand({
+        provider: "cloudflare",
+        localPort: params.localPort,
+        localUrl: params.localUrl,
+    });
+    const child = spawnCommand(plan.command, plan.args, {
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let stdout = "";
+        let stderr = "";
+        let stdoutRemainder = "";
+        let stderrRemainder = "";
+        const cleanup = () => {
+            clearTimeout(timeout);
+            child.stdout.removeAllListeners("data");
+            child.stderr.removeAllListeners("data");
+            child.removeAllListeners("error");
+            child.removeAllListeners("close");
+        };
+        const resolveWithUrl = (publicUrl) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            resolve({
+                kind: "cloudflare",
+                ...(publicUrl ? { publicUrl } : {}),
+                notes: [
+                    "Cloudflare quick tunnels are temporary and use a random trycloudflare.com URL.",
+                ],
+                close: async () => {
+                    await stopPersistentChild(child);
+                },
+            });
+        };
+        const rejectWithError = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            if (isUnavailableTunnelBinaryError(error)) {
+                reject(formatMissingBinaryError("cloudflared", getMissingBinaryHint("cloudflared")));
+                return;
+            }
+            reject(error);
+        };
+        const handleChunk = (chunk, prefix, target) => {
+            if (target === "stdout") {
+                stdout += chunk;
+                stdoutRemainder = emitBufferedLines(stdoutRemainder + chunk, {
+                    prefix,
+                    ...(params.onLog ? { onLog: params.onLog } : {}),
+                });
+            }
+            else {
+                stderr += chunk;
+                stderrRemainder = emitBufferedLines(stderrRemainder + chunk, {
+                    prefix,
+                    ...(params.onLog ? { onLog: params.onLog } : {}),
+                });
+            }
+            const publicUrl = extractCloudflareQuickTunnelPublicUrl(`${stdout}${stderr}`);
+            if (publicUrl) {
+                if (stdoutRemainder.trim() !== "") {
+                    params.onLog?.(`[privateclaw-relay] ${prefix} ${stdoutRemainder.trim()}`);
+                }
+                if (stderrRemainder.trim() !== "") {
+                    params.onLog?.(`[privateclaw-relay] ${prefix} ${stderrRemainder.trim()}`);
+                }
+                resolveWithUrl(publicUrl);
+            }
+        };
+        child.stdout.on("data", (chunk) => {
+            handleChunk(chunk, "[cloudflare]", "stdout");
+        });
+        child.stderr.on("data", (chunk) => {
+            handleChunk(chunk, "[cloudflare]", "stderr");
+        });
+        child.once("error", rejectWithError);
+        child.once("close", (code, signal) => {
+            if (settled) {
+                return;
+            }
+            const combined = `${stdout}${stderr}`.trim();
+            rejectWithError(new Error(`Command \`${formatTunnelCommand(plan)}\` exited with ${code == null ? `signal ${signal ?? "unknown"}` : `code ${code}`}${combined ? `: ${combined}` : "."}`));
+        });
+        const timeout = setTimeout(() => {
+            rejectWithError(new Error(`Timed out waiting for Cloudflare Tunnel to report a public URL after running \`${formatTunnelCommand(plan)}\`.`));
+        }, 30_000);
+    });
+}
+export async function openRelayTunnel(params) {
+    if (params.provider === "tailscale") {
+        return openTailscaleFunnel(params);
+    }
+    return openCloudflareTunnel(params);
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/tunnel.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@privateclaw/privateclaw-relay",
+  "version": "0.1.0",
+  "description": "Blind WebSocket relay for PrivateClaw encrypted sessions with local CLI startup and optional Tailscale Funnel or Cloudflare Tunnel exposure",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "privateclaw-relay": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    ".env.example",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "prepack": "npm run build",
+    "test": "node --import tsx --test src/**/*.test.ts"
+  },
+  "dependencies": {
+    "@privateclaw/protocol": "^0.1.2",
+    "ioredis": "^5.8.1",
+    "ws": "^8.18.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/topcheer/PrivateClaw.git",
+    "directory": "services/relay-server"
+  },
+  "homepage": "https://github.com/topcheer/PrivateClaw/tree/main/services/relay-server",
+  "bugs": {
+    "url": "https://github.com/topcheer/PrivateClaw/issues"
+  }
+}