@spawn-dock/dev-tunnel 1.0.0-canary.20260320130238.da674ff

package/README.md

@@ -0,0 +1,60 @@
+# `@spawn-dock/dev-tunnel`
+
+WebSocket tunnel client for SpawnDock local development preview. Exposes your local dev server through the SpawnDock control plane so others can preview your Telegram Mini App.
+
+## Install
+
+```bash
+npm install -g @spawn-dock/dev-tunnel
+```
+
+Or use with npx:
+
+```bash
+npx @spawn-dock/dev-tunnel
+```
+
+## Usage
+
+### With `spawndock.dev-tunnel.json` (recommended)
+
+If your project has a `spawndock.dev-tunnel.json` file (created by the bootstrap CLI), just run:
+
+```bash
+npx @spawn-dock/dev-tunnel
+```
+
+### With CLI arguments
+
+```bash
+npx @spawn-dock/dev-tunnel \
+  --control-plane http://your-server:3000 \
+  --project-slug my-app \
+  --device-secret your-device-secret \
+  --port 3000
+```
+
+### With environment variables
+
+```bash
+export SPAWNDOCK_CONTROL_PLANE=http://your-server:3000
+export SPAWNDOCK_PROJECT_SLUG=my-app
+export SPAWNDOCK_DEVICE_SECRET=your-device-secret
+export SPAWNDOCK_PORT=3000
+npx @spawn-dock/dev-tunnel
+```
+
+## Configuration Priority
+
+CLI arguments > Environment variables > `spawndock.dev-tunnel.json` > legacy `spawndock.config.json`
+
+## How it works
+
+1. Connects to the SpawnDock control plane via WebSocket
+2. Receives HTTP requests from users viewing your preview URL
+3. Proxies those requests to your local dev server
+4. Sends responses back through the tunnel
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface TunnelConfig {
+    controlPlane: string;
+    projectSlug: string;
+    deviceSecret: string;
+    port: number;
+}
+export declare function resolveConfig(argv?: string[], cwd?: string): TunnelConfig;

package/dist/config.js

@@ -0,0 +1,117 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+const PRIMARY_CONFIG_FILE = "spawndock.dev-tunnel.json";
+const LEGACY_CONFIG_FILE = "spawndock.config.json";
+function readNumber(value) {
+    if (value === undefined || value.length === 0) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function normalizeConfig(data) {
+    if (typeof data !== "object" || data === null) {
+        return {};
+    }
+    const record = data;
+    const controlPlane = typeof record.controlPlane === "string"
+        ? record.controlPlane
+        : typeof record.controlPlaneUrl === "string"
+            ? record.controlPlaneUrl
+            : undefined;
+    const projectSlug = typeof record.projectSlug === "string" ? record.projectSlug : undefined;
+    const deviceSecret = typeof record.deviceSecret === "string"
+        ? record.deviceSecret
+        : typeof record.deviceToken === "string"
+            ? record.deviceToken
+            : undefined;
+    const port = typeof record.port === "number"
+        ? record.port
+        : typeof record.localPort === "number"
+            ? record.localPort
+            : undefined;
+    return { controlPlane, projectSlug, deviceSecret, port };
+}
+function readConfigFile(dir) {
+    for (const fileName of [PRIMARY_CONFIG_FILE, LEGACY_CONFIG_FILE]) {
+        try {
+            const raw = readFileSync(resolve(dir, fileName), "utf-8");
+            return normalizeConfig(JSON.parse(raw));
+        }
+        catch {
+            // Try next candidate.
+        }
+    }
+    return {};
+}
+function parseArgs(argv) {
+    const result = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--control-plane" || arg.startsWith("--control-plane=")) {
+            const value = arg.includes("=") ? arg.slice(arg.indexOf("=") + 1) : next;
+            if (value) {
+                result.controlPlane = value;
+            }
+            if (!arg.includes("=")) {
+                i++;
+            }
+            continue;
+        }
+        if (arg === "--project-slug" || arg.startsWith("--project-slug=")) {
+            const value = arg.includes("=") ? arg.slice(arg.indexOf("=") + 1) : next;
+            if (value) {
+                result.projectSlug = value;
+            }
+            if (!arg.includes("=")) {
+                i++;
+            }
+            continue;
+        }
+        if (arg === "--device-secret" || arg.startsWith("--device-secret=")) {
+            const value = arg.includes("=") ? arg.slice(arg.indexOf("=") + 1) : next;
+            if (value) {
+                result.deviceSecret = value;
+            }
+            if (!arg.includes("=")) {
+                i++;
+            }
+            continue;
+        }
+        if (arg === "--port" || arg.startsWith("--port=")) {
+            const value = arg.includes("=") ? arg.slice(arg.indexOf("=") + 1) : next;
+            const parsed = readNumber(value);
+            if (parsed !== undefined) {
+                result.port = parsed;
+            }
+            if (!arg.includes("=")) {
+                i++;
+            }
+        }
+    }
+    return result;
+}
+export function resolveConfig(argv = process.argv.slice(2), cwd = process.cwd()) {
+    const file = readConfigFile(cwd);
+    const args = parseArgs(argv);
+    const env = {
+        controlPlane: process.env.SPAWNDOCK_CONTROL_PLANE,
+        projectSlug: process.env.SPAWNDOCK_PROJECT_SLUG,
+        deviceSecret: process.env.SPAWNDOCK_DEVICE_SECRET,
+        port: readNumber(process.env.SPAWNDOCK_PORT),
+    };
+    // Priority: CLI > Env > File
+    const controlPlane = args.controlPlane ?? env.controlPlane ?? file.controlPlane;
+    const projectSlug = args.projectSlug ?? env.projectSlug ?? file.projectSlug;
+    const deviceSecret = args.deviceSecret ?? env.deviceSecret ?? file.deviceSecret;
+    const port = args.port ?? env.port ?? file.port ?? 3000;
+    if (!controlPlane)
+        throw new Error("Missing --control-plane or SPAWNDOCK_CONTROL_PLANE");
+    if (!projectSlug)
+        throw new Error("Missing --project-slug or SPAWNDOCK_PROJECT_SLUG");
+    if (!deviceSecret)
+        throw new Error("Missing --device-secret or SPAWNDOCK_DEVICE_SECRET");
+    return { controlPlane, projectSlug, deviceSecret, port };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { resolveConfig } from "./config.js";
+import { createTunnel } from "./tunnel.js";
+try {
+    const config = resolveConfig();
+    console.log(`SpawnDock dev tunnel: ${config.projectSlug} -> http://127.0.0.1:${config.port}`);
+    createTunnel(config);
+}
+catch (err) {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,OAAO,CAAC,GAAG,CACT,yBAAyB,MAAM,CAAC,WAAW,wBAAwB,MAAM,CAAC,IAAI,EAAE,CACjF,CAAC;IACF,YAAY,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAAC,OAAO,GAAQ,EAAE,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,48 @@
+export interface SerializedHttpRequest {
+    requestId: string;
+    method: string;
+    path: string;
+    headers: [string, string][];
+    body?: {
+        encoding: "utf8" | "base64";
+        value: string;
+    };
+}
+export interface SerializedHttpResponse {
+    requestId: string;
+    status: number;
+    headers: [string, string][];
+    body?: {
+        encoding: "utf8" | "base64";
+        value: string;
+    };
+}
+export type InboundMessage = {
+    type: "http-request";
+    request: SerializedHttpRequest;
+} | {
+    type: "ping";
+    nonce: string;
+};
+export type OutboundMessage = {
+    type: "hello";
+    projectSlug: string;
+    port: number;
+    protocolVersion: 1;
+} | {
+    type: "heartbeat";
+    projectSlug: string;
+    timestamp: number;
+} | {
+    type: "http-response";
+    response: SerializedHttpResponse;
+} | {
+    type: "pong";
+    nonce: string;
+} | {
+    type: "error";
+    requestId?: string;
+    message: string;
+};
+export declare function parseInbound(data: string): InboundMessage | null;
+export declare function serialize(msg: OutboundMessage): string;

package/dist/protocol.js

@@ -0,0 +1,17 @@
+export function parseInbound(data) {
+    try {
+        const msg = JSON.parse(data);
+        if (msg.type === "http-request" && msg.request)
+            return msg;
+        if (msg.type === "ping" && typeof msg.nonce === "string")
+            return msg;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function serialize(msg) {
+    return JSON.stringify(msg);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC;QAC3D,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAoB;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,2 @@
+import type { SerializedHttpRequest, SerializedHttpResponse } from "./protocol.js";
+export declare function proxyRequest(request: SerializedHttpRequest, localOrigin: string): Promise<SerializedHttpResponse>;

package/dist/proxy.js

@@ -0,0 +1,50 @@
+const HOP_BY_HOP = new Set([
+    "connection", "host", "keep-alive", "proxy-authenticate",
+    "proxy-authorization", "te", "trailer", "transfer-encoding", "upgrade", "content-length",
+]);
+function decodeBody(body) {
+    if (body.encoding === "utf8")
+        return body.value;
+    const buf = Buffer.from(body.value, "base64");
+    return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+}
+export async function proxyRequest(request, localOrigin) {
+    const url = new URL(request.path, localOrigin);
+    const headers = new Headers();
+    for (const [name, value] of request.headers) {
+        if (!HOP_BY_HOP.has(name.toLowerCase())) {
+            headers.set(name, value);
+        }
+    }
+    const init = { method: request.method, headers };
+    const method = request.method.toUpperCase();
+    if (request.body && method !== "GET" && method !== "HEAD") {
+        init.body = decodeBody(request.body);
+    }
+    try {
+        const res = await fetch(url, init);
+        const bodyBytes = new Uint8Array(await res.arrayBuffer());
+        const responseHeaders = Array.from(res.headers.entries());
+        const response = {
+            requestId: request.requestId,
+            status: res.status,
+            headers: responseHeaders,
+        };
+        if (bodyBytes.byteLength > 0) {
+            return {
+                ...response,
+                body: { encoding: "base64", value: Buffer.from(bodyBytes).toString("base64") },
+            };
+        }
+        return response;
+    }
+    catch (err) {
+        return {
+            requestId: request.requestId,
+            status: 502,
+            headers: [["content-type", "application/json"]],
+            body: { encoding: "utf8", value: JSON.stringify({ error: "proxy_failed", message: err.message }) },
+        };
+    }
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB;IACxD,qBAAqB,EAAE,IAAI,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB;CACzF,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,IAAyC;IAC3D,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA8B,EAC9B,WAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAuB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAE9E,MAAM,QAAQ,GAA2B;YACvC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,eAAe;SACzB,CAAC;QAEF,IAAI,SAAS,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,GAAG,QAAQ;gBACX,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;aAC/E,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,CAAC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAC/C,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE;SACnG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tunnel.d.ts

@@ -0,0 +1,3 @@
+import type { TunnelConfig } from "./config.js";
+export declare function createTunnel(config: TunnelConfig): void;
+export declare function buildWsUrl(config: TunnelConfig): string;

package/dist/tunnel.js

@@ -0,0 +1,79 @@
+import WebSocket from "ws";
+import { parseInbound, serialize } from "./protocol.js";
+import { proxyRequest } from "./proxy.js";
+export function createTunnel(config) {
+    const localOrigin = `http://127.0.0.1:${config.port}`;
+    const wsUrl = buildWsUrl(config);
+    connect(wsUrl, config, localOrigin);
+}
+export function buildWsUrl(config) {
+    if (!URL.canParse(config.controlPlane)) {
+        throw new Error(`Invalid control plane URL: ${config.controlPlane}`);
+    }
+    const url = new URL(config.controlPlane);
+    if (url.protocol === "http:") {
+        url.protocol = "ws:";
+    }
+    else if (url.protocol === "https:") {
+        url.protocol = "wss:";
+    }
+    const currentPath = url.pathname.replace(/\/+$/, "");
+    url.pathname = currentPath.length === 0 ? "/tunnel/connect" : `${currentPath}/tunnel/connect`;
+    url.searchParams.set("protocolVersion", "1");
+    url.searchParams.set("token", config.deviceSecret);
+    return url.toString();
+}
+function connect(wsUrl, config, localOrigin) {
+    const ws = new WebSocket(wsUrl);
+    let heartbeatInterval = null;
+    ws.on("open", () => {
+        console.log(`Connected to ${config.controlPlane}`);
+        ws.send(serialize({
+            type: "hello",
+            projectSlug: config.projectSlug,
+            port: config.port,
+            protocolVersion: 1,
+        }));
+        heartbeatInterval = setInterval(() => {
+            if (ws.readyState === WebSocket.OPEN) {
+                ws.send(serialize({
+                    type: "heartbeat",
+                    projectSlug: config.projectSlug,
+                    timestamp: Date.now(),
+                }));
+            }
+        }, 15_000);
+    });
+    ws.on("message", async (data) => {
+        const msg = parseInbound(data.toString());
+        if (!msg)
+            return;
+        if (msg.type === "ping") {
+            ws.send(serialize({ type: "pong", nonce: msg.nonce }));
+            return;
+        }
+        if (msg.type === "http-request") {
+            try {
+                const response = await proxyRequest(msg.request, localOrigin);
+                ws.send(serialize({ type: "http-response", response }));
+            }
+            catch (err) {
+                ws.send(serialize({
+                    type: "error",
+                    requestId: msg.request.requestId,
+                    message: err.message,
+                }));
+            }
+        }
+    });
+    ws.on("close", () => {
+        if (heartbeatInterval)
+            clearInterval(heartbeatInterval);
+        console.log("Disconnected. Reconnecting in 2s...");
+        setTimeout(() => connect(wsUrl, config, localOrigin), 2000);
+    });
+    ws.on("error", (err) => {
+        console.error(`WebSocket error: ${err.message}`);
+    });
+}
+//# 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,38 @@
+{
+  "name": "@spawn-dock/dev-tunnel",
+  "version": "1.0.0-canary.20260320130238.da674ff",
+  "description": "WebSocket tunnel client for SpawnDock local development preview",
+  "type": "module",
+  "bin": {
+    "spawn-dock-tunnel": "./dist/index.js",
+    "spawndock-tunnel": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "spawndock",
+    "tunnel",
+    "telegram-mini-app",
+    "tma",
+    "dev-tunnel"
+  ],
+  "license": "MIT"
+}