enpilink 1.0.2

package/dist/cli/tunnel.js

@@ -0,0 +1,254 @@
+import { EventEmitter } from "node:events";
+import { defaultProvider, } from "./tunnel-providers/index.js";
+/**
+ * Parse a single stdout line using the default (srv.us) provider. Kept as a
+ * standalone export for tests and callers that want the default parser.
+ */
+export function parseStdoutLine(line) {
+    return defaultProvider.parseLine(line);
+}
+const CONNECT_TIMEOUT_MS = 60_000;
+const STDERR_BUFFER_BYTES = 1024;
+/** Backoff before respawning after an unexpected drop. */
+const RECONNECT_BASE_DELAY_MS = 1_000;
+const RECONNECT_MAX_DELAY_MS = 30_000;
+function providerFromSpawn(spawnFn) {
+    return {
+        name: "custom",
+        spawn: spawnFn,
+        parseLine: defaultProvider.parseLine,
+    };
+}
+export class TunnelManager extends EventEmitter {
+    state = { status: "idle" };
+    child = null;
+    timeout = null;
+    reconnectTimer = null;
+    stderrBuffer = "";
+    connected = false;
+    /** True between start() and stop(): governs whether drops trigger reconnect. */
+    wantUp = false;
+    reconnectAttempts = 0;
+    ensured = false;
+    getPort;
+    provider;
+    constructor(opts) {
+        super();
+        this.getPort = opts.getPort;
+        this.provider =
+            opts.provider ??
+                (opts.spawn ? providerFromSpawn(opts.spawn) : defaultProvider);
+        // Multiple SSE subscribers (CLI, devtools, ad-hoc curl) can each register
+        // state + activity listeners; the default cap of 10 is easy to hit.
+        this.setMaxListeners(0);
+    }
+    getState() {
+        return this.state;
+    }
+    subscribe(listener) {
+        listener(this.state);
+        this.on("state", listener);
+        return () => {
+            this.off("state", listener);
+        };
+    }
+    start() {
+        if (this.state.status === "starting" ||
+            this.state.status === "connected" ||
+            this.state.status === "reconnecting") {
+            return;
+        }
+        this.wantUp = true;
+        this.reconnectAttempts = 0;
+        void this.spawnChild({ status: "starting", message: "Starting tunnel…" });
+    }
+    /**
+     * Spawn (or respawn) the tunnel child. `initialState` is what we broadcast
+     * while waiting for the URL — "starting" on first launch, "reconnecting" after
+     * a drop. Ensures provider prerequisites (e.g. SSH key) once, lazily.
+     */
+    async spawnChild(initialState) {
+        this.connected = false;
+        this.stderrBuffer = "";
+        this.setState(initialState);
+        if (!this.ensured && this.provider.ensure) {
+            try {
+                await this.provider.ensure();
+                this.ensured = true;
+            }
+            catch (err) {
+                if (!this.wantUp) {
+                    return;
+                }
+                this.setState({
+                    status: "error",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                return;
+            }
+        }
+        // A stop() may have raced the await above.
+        if (!this.wantUp) {
+            return;
+        }
+        let child;
+        try {
+            child = this.provider.spawn(this.getPort());
+        }
+        catch (err) {
+            this.setState({
+                status: "error",
+                message: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+        this.child = child;
+        this.timeout = setTimeout(() => {
+            if (!this.connected) {
+                this.setState({
+                    status: "error",
+                    message: "Tunnel connection timed out after one minute",
+                });
+                // Detach before killing so the imminent `close` event is treated as
+                // stale and does not overwrite the timeout error message / reconnect.
+                this.child = null;
+                this.wantUp = false;
+                child.kill();
+            }
+        }, CONNECT_TIMEOUT_MS);
+        child.stdout?.on("data", (data) => {
+            this.handleStdout(data);
+        });
+        child.stderr?.on("data", (data) => {
+            this.handleStderr(data);
+        });
+        child.on("error", (err) => {
+            // Stale event from a child we've already replaced via stop()+start().
+            if (child !== this.child) {
+                return;
+            }
+            this.clearConnectTimeout();
+            this.child = null;
+            if (this.wantUp) {
+                this.scheduleReconnect(err.message);
+            }
+            else {
+                this.setState({ status: "error", message: err.message });
+            }
+        });
+        child.on("close", (code) => {
+            // Stale event from a child we've already replaced via stop()+start().
+            if (child !== this.child) {
+                return;
+            }
+            this.clearConnectTimeout();
+            this.child = null;
+            // Wanted up but the process exited → unexpected drop, reconnect.
+            if (this.wantUp) {
+                const detail = this.stderrBuffer.trim() ||
+                    (code !== null ? `tunnel exited with code ${code}` : "tunnel closed");
+                this.scheduleReconnect(detail);
+                return;
+            }
+            if (code !== 0 && code !== null) {
+                const detail = this.stderrBuffer.trim() || `exited with code ${code}`;
+                this.setState({ status: "error", message: detail });
+            }
+            else {
+                this.setState({ status: "idle" });
+            }
+        });
+    }
+    /**
+     * After an unexpected drop, broadcast "reconnecting" and respawn after an
+     * exponential backoff (capped). Reset attempts once a connection succeeds.
+     */
+    scheduleReconnect(reason) {
+        if (!this.wantUp) {
+            this.setState({ status: "idle" });
+            return;
+        }
+        const delay = Math.min(RECONNECT_BASE_DELAY_MS * 2 ** this.reconnectAttempts, RECONNECT_MAX_DELAY_MS);
+        this.reconnectAttempts += 1;
+        this.setState({
+            status: "reconnecting",
+            message: `Tunnel dropped (${reason}); reconnecting…`,
+        });
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            if (!this.wantUp) {
+                return;
+            }
+            void this.spawnChild({
+                status: "reconnecting",
+                message: "Reconnecting tunnel…",
+            });
+        }, delay);
+    }
+    stop() {
+        this.wantUp = false;
+        this.clearConnectTimeout();
+        this.clearReconnectTimer();
+        if (this.child) {
+            this.child.kill();
+            this.child = null;
+        }
+        this.setState({ status: "idle" });
+    }
+    handleStdout(data) {
+        const lines = data.toString().split("\n");
+        for (const raw of lines) {
+            const parsed = this.provider.parseLine(raw);
+            if (!parsed) {
+                continue;
+            }
+            if (parsed.kind === "connected") {
+                this.connected = true;
+                this.reconnectAttempts = 0;
+                this.clearConnectTimeout();
+                this.setState({ status: "connected", url: parsed.url });
+            }
+            else if (this.connected) {
+                this.emitActivity(parsed.message, "log");
+            }
+            else {
+                this.setState({ status: "starting", message: parsed.message });
+            }
+        }
+    }
+    handleStderr(data) {
+        const text = data.toString().trim();
+        if (!text) {
+            return;
+        }
+        this.stderrBuffer = (this.stderrBuffer + text).slice(-STDERR_BUFFER_BYTES);
+        for (const line of text.split("\n").filter(Boolean)) {
+            this.emitActivity(line, "error");
+        }
+    }
+    setState(next) {
+        this.state = next;
+        this.emit("state", next);
+    }
+    emitActivity(text, level) {
+        const activity = {
+            time: new Date().toISOString(),
+            text,
+            level,
+        };
+        this.emit("activity", activity);
+    }
+    clearConnectTimeout() {
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+            this.timeout = null;
+        }
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/cli/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/cli/tunnel.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport {\n  defaultProvider,\n  type ParsedStdoutEvent,\n  type TunnelChildProcess,\n  type TunnelProvider,\n} from \"./tunnel-providers/index.js\";\n\nexport type {\n  ParsedStdoutEvent,\n  TunnelChildProcess,\n  TunnelProvider,\n} from \"./tunnel-providers/index.js\";\n\nexport type TunnelState =\n  | { status: \"idle\" }\n  | { status: \"starting\"; message: string }\n  | { status: \"connected\"; url: string }\n  | { status: \"reconnecting\"; message: string }\n  | { status: \"error\"; message: string };\n\n/**\n * Parse a single stdout line using the default (srv.us) provider. Kept as a\n * standalone export for tests and callers that want the default parser.\n */\nexport function parseStdoutLine(line: string): ParsedStdoutEvent | null {\n  return defaultProvider.parseLine(line);\n}\n\nconst CONNECT_TIMEOUT_MS = 60_000;\nconst STDERR_BUFFER_BYTES = 1024;\n/** Backoff before respawning after an unexpected drop. */\nconst RECONNECT_BASE_DELAY_MS = 1_000;\nconst RECONNECT_MAX_DELAY_MS = 30_000;\n\nexport type TunnelActivity = {\n  time: string;\n  text: string;\n  level: \"log\" | \"error\";\n};\n\n/**\n * Legacy spawn injection. A bare `(port) => child` function; when provided it is\n * adapted into a provider that uses the default (srv.us) line parser. New code\n * should pass a full `provider` instead.\n */\nexport type SpawnFn = (port: number) => TunnelChildProcess;\n\nfunction providerFromSpawn(spawnFn: SpawnFn): TunnelProvider {\n  return {\n    name: \"custom\",\n    spawn: spawnFn,\n    parseLine: defaultProvider.parseLine,\n  };\n}\n\nexport class TunnelManager extends EventEmitter {\n  private state: TunnelState = { status: \"idle\" };\n  private child: ReturnType<SpawnFn> | null = null;\n  private timeout: NodeJS.Timeout | null = null;\n  private reconnectTimer: NodeJS.Timeout | null = null;\n  private stderrBuffer = \"\";\n  private connected = false;\n  /** True between start() and stop(): governs whether drops trigger reconnect. */\n  private wantUp = false;\n  private reconnectAttempts = 0;\n  private ensured = false;\n  private readonly getPort: () => number;\n  private readonly provider: TunnelProvider;\n\n  constructor(opts: {\n    getPort: () => number;\n    provider?: TunnelProvider;\n    /** @deprecated pass `provider` instead. */\n    spawn?: SpawnFn;\n  }) {\n    super();\n    this.getPort = opts.getPort;\n    this.provider =\n      opts.provider ??\n      (opts.spawn ? providerFromSpawn(opts.spawn) : defaultProvider);\n    // Multiple SSE subscribers (CLI, devtools, ad-hoc curl) can each register\n    // state + activity listeners; the default cap of 10 is easy to hit.\n    this.setMaxListeners(0);\n  }\n\n  getState(): TunnelState {\n    return this.state;\n  }\n\n  subscribe(listener: (state: TunnelState) => void): () => void {\n    listener(this.state);\n    this.on(\"state\", listener);\n    return () => {\n      this.off(\"state\", listener);\n    };\n  }\n\n  start(): void {\n    if (\n      this.state.status === \"starting\" ||\n      this.state.status === \"connected\" ||\n      this.state.status === \"reconnecting\"\n    ) {\n      return;\n    }\n    this.wantUp = true;\n    this.reconnectAttempts = 0;\n    void this.spawnChild({ status: \"starting\", message: \"Starting tunnel…\" });\n  }\n\n  /**\n   * Spawn (or respawn) the tunnel child. `initialState` is what we broadcast\n   * while waiting for the URL — \"starting\" on first launch, \"reconnecting\" after\n   * a drop. Ensures provider prerequisites (e.g. SSH key) once, lazily.\n   */\n  private async spawnChild(initialState: TunnelState): Promise<void> {\n    this.connected = false;\n    this.stderrBuffer = \"\";\n    this.setState(initialState);\n\n    if (!this.ensured && this.provider.ensure) {\n      try {\n        await this.provider.ensure();\n        this.ensured = true;\n      } catch (err) {\n        if (!this.wantUp) {\n          return;\n        }\n        this.setState({\n          status: \"error\",\n          message: err instanceof Error ? err.message : String(err),\n        });\n        return;\n      }\n    }\n    // A stop() may have raced the await above.\n    if (!this.wantUp) {\n      return;\n    }\n\n    let child: TunnelChildProcess;\n    try {\n      child = this.provider.spawn(this.getPort());\n    } catch (err) {\n      this.setState({\n        status: \"error\",\n        message: err instanceof Error ? err.message : String(err),\n      });\n      return;\n    }\n    this.child = child;\n\n    this.timeout = setTimeout(() => {\n      if (!this.connected) {\n        this.setState({\n          status: \"error\",\n          message: \"Tunnel connection timed out after one minute\",\n        });\n        // Detach before killing so the imminent `close` event is treated as\n        // stale and does not overwrite the timeout error message / reconnect.\n        this.child = null;\n        this.wantUp = false;\n        child.kill();\n      }\n    }, CONNECT_TIMEOUT_MS);\n\n    child.stdout?.on(\"data\", (data: Buffer) => {\n      this.handleStdout(data);\n    });\n    child.stderr?.on(\"data\", (data: Buffer) => {\n      this.handleStderr(data);\n    });\n\n    child.on(\"error\", (err: Error) => {\n      // Stale event from a child we've already replaced via stop()+start().\n      if (child !== this.child) {\n        return;\n      }\n      this.clearConnectTimeout();\n      this.child = null;\n      if (this.wantUp) {\n        this.scheduleReconnect(err.message);\n      } else {\n        this.setState({ status: \"error\", message: err.message });\n      }\n    });\n\n    child.on(\"close\", (code: number | null) => {\n      // Stale event from a child we've already replaced via stop()+start().\n      if (child !== this.child) {\n        return;\n      }\n      this.clearConnectTimeout();\n      this.child = null;\n\n      // Wanted up but the process exited → unexpected drop, reconnect.\n      if (this.wantUp) {\n        const detail =\n          this.stderrBuffer.trim() ||\n          (code !== null ? `tunnel exited with code ${code}` : \"tunnel closed\");\n        this.scheduleReconnect(detail);\n        return;\n      }\n\n      if (code !== 0 && code !== null) {\n        const detail = this.stderrBuffer.trim() || `exited with code ${code}`;\n        this.setState({ status: \"error\", message: detail });\n      } else {\n        this.setState({ status: \"idle\" });\n      }\n    });\n  }\n\n  /**\n   * After an unexpected drop, broadcast \"reconnecting\" and respawn after an\n   * exponential backoff (capped). Reset attempts once a connection succeeds.\n   */\n  private scheduleReconnect(reason: string): void {\n    if (!this.wantUp) {\n      this.setState({ status: \"idle\" });\n      return;\n    }\n    const delay = Math.min(\n      RECONNECT_BASE_DELAY_MS * 2 ** this.reconnectAttempts,\n      RECONNECT_MAX_DELAY_MS,\n    );\n    this.reconnectAttempts += 1;\n    this.setState({\n      status: \"reconnecting\",\n      message: `Tunnel dropped (${reason}); reconnecting…`,\n    });\n    this.reconnectTimer = setTimeout(() => {\n      this.reconnectTimer = null;\n      if (!this.wantUp) {\n        return;\n      }\n      void this.spawnChild({\n        status: \"reconnecting\",\n        message: \"Reconnecting tunnel…\",\n      });\n    }, delay);\n  }\n\n  stop(): void {\n    this.wantUp = false;\n    this.clearConnectTimeout();\n    this.clearReconnectTimer();\n    if (this.child) {\n      this.child.kill();\n      this.child = null;\n    }\n    this.setState({ status: \"idle\" });\n  }\n\n  private handleStdout(data: Buffer): void {\n    const lines = data.toString().split(\"\\n\");\n    for (const raw of lines) {\n      const parsed = this.provider.parseLine(raw);\n      if (!parsed) {\n        continue;\n      }\n      if (parsed.kind === \"connected\") {\n        this.connected = true;\n        this.reconnectAttempts = 0;\n        this.clearConnectTimeout();\n        this.setState({ status: \"connected\", url: parsed.url });\n      } else if (this.connected) {\n        this.emitActivity(parsed.message, \"log\");\n      } else {\n        this.setState({ status: \"starting\", message: parsed.message });\n      }\n    }\n  }\n\n  private handleStderr(data: Buffer): void {\n    const text = data.toString().trim();\n    if (!text) {\n      return;\n    }\n    this.stderrBuffer = (this.stderrBuffer + text).slice(-STDERR_BUFFER_BYTES);\n    for (const line of text.split(\"\\n\").filter(Boolean)) {\n      this.emitActivity(line, \"error\");\n    }\n  }\n\n  private setState(next: TunnelState): void {\n    this.state = next;\n    this.emit(\"state\", next);\n  }\n\n  private emitActivity(text: string, level: \"log\" | \"error\"): void {\n    const activity: TunnelActivity = {\n      time: new Date().toISOString(),\n      text,\n      level,\n    };\n    this.emit(\"activity\", activity);\n  }\n\n  private clearConnectTimeout(): void {\n    if (this.timeout) {\n      clearTimeout(this.timeout);\n      this.timeout = null;\n    }\n  }\n\n  private clearReconnectTimer(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n  }\n}\n"]}

package/dist/cli/tunnel.test.d.ts

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

package/dist/cli/tunnel.test.js

@@ -0,0 +1,255 @@
+import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { parseStdoutLine, TunnelManager } from "./tunnel.js";
+describe("parseStdoutLine (delegates to the default srv.us provider)", () => {
+    it("returns a connected event when a srv.us URL is seen", () => {
+        const result = parseStdoutLine("https://qp556ma755ktlag5b2xyt334ae.srv.us/");
+        expect(result).toEqual({
+            kind: "connected",
+            url: "https://qp556ma755ktlag5b2xyt334ae.srv.us",
+        });
+    });
+    it("returns a starting event for any other non-empty line", () => {
+        expect(parseStdoutLine("Warning: Permanently added 'srv.us'")).toEqual({
+            kind: "starting",
+            message: "Warning: Permanently added 'srv.us'",
+        });
+    });
+    it("returns null for empty lines", () => {
+        expect(parseStdoutLine("")).toBeNull();
+        expect(parseStdoutLine("   ")).toBeNull();
+    });
+});
+function makeFakeChild() {
+    const child = new EventEmitter();
+    child.stdout = new Readable({ read() { } });
+    child.stderr = new Readable({ read() { } });
+    child.kill = vi.fn(() => true);
+    return child;
+}
+describe("TunnelManager", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("starts idle", () => {
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => makeFakeChild(),
+        });
+        expect(manager.getState()).toEqual({ status: "idle" });
+    });
+    it("transitions idle -> starting -> connected as stdout reports progress", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        const states = [];
+        manager.on("state", (s) => states.push(s.status));
+        manager.start();
+        child.stdout.emit("data", Buffer.from("Opening tunnel...\n"));
+        child.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        expect(states).toEqual(["starting", "starting", "connected"]);
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc123.srv.us",
+        });
+    });
+    it("emits activity events for stdout lines after connect", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        const activity = [];
+        manager.on("activity", (a) => activity.push({ text: a.text, level: a.level }));
+        manager.start();
+        child.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        child.stdout.emit("data", Buffer.from("GET /widgets/foo\n"));
+        child.stderr.emit("data", Buffer.from("connection wobble\n"));
+        expect(activity).toEqual([
+            { text: "GET /widgets/foo", level: "log" },
+            { text: "connection wobble", level: "error" },
+        ]);
+    });
+    it("calling start twice does not spawn twice", () => {
+        const spawn = vi.fn(() => makeFakeChild());
+        const manager = new TunnelManager({ getPort: () => 3000, spawn });
+        manager.start();
+        manager.start();
+        expect(spawn).toHaveBeenCalledTimes(1);
+    });
+    it("transitions to error when the connection times out", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        vi.advanceTimersByTime(60_000);
+        expect(manager.getState().status).toBe("error");
+        expect(child.kill).toHaveBeenCalled();
+    });
+    it("preserves the timeout error message when the killed child later emits close", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        vi.advanceTimersByTime(60_000);
+        // The killed child emits a non-zero close after the timeout fired.
+        child.emit("close", 1);
+        expect(manager.getState()).toEqual({
+            status: "error",
+            message: "Tunnel connection timed out after one minute",
+        });
+    });
+    it("stop() kills the subprocess and goes idle", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        manager.stop();
+        expect(child.kill).toHaveBeenCalled();
+        expect(manager.getState()).toEqual({ status: "idle" });
+    });
+    it("subscribers get the current state on subscribe", () => {
+        const child = makeFakeChild();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => child,
+        });
+        manager.start();
+        child.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        let received;
+        const unsubscribe = manager.subscribe((s) => {
+            received = s;
+        });
+        expect(received).toEqual({
+            status: "connected",
+            url: "https://abc123.srv.us",
+        });
+        unsubscribe();
+    });
+    it("ignores deferred close from a child that was replaced via stop()+start()", () => {
+        const childA = makeFakeChild();
+        const childB = makeFakeChild();
+        let spawnCount = 0;
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => (spawnCount++ === 0 ? childA : childB),
+        });
+        manager.start();
+        manager.stop();
+        manager.start();
+        childB.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc123.srv.us",
+        });
+        // Stale close from childA arrives only now — must not clobber state.
+        childA.emit("close", null);
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc123.srv.us",
+        });
+    });
+    it("ignores deferred error from a child that was replaced via stop()+start()", () => {
+        const childA = makeFakeChild();
+        const childB = makeFakeChild();
+        let spawnCount = 0;
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => (spawnCount++ === 0 ? childA : childB),
+        });
+        manager.start();
+        manager.stop();
+        manager.start();
+        childB.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        childA.emit("error", new Error("late spawn failure"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc123.srv.us",
+        });
+    });
+    it("auto-reconnects when the ssh child exits unexpectedly while up", () => {
+        const childA = makeFakeChild();
+        const childB = makeFakeChild();
+        let spawnCount = 0;
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => (spawnCount++ === 0 ? childA : childB),
+        });
+        const states = [];
+        manager.on("state", (s) => states.push(s));
+        manager.start();
+        childA.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        expect(manager.getState().status).toBe("connected");
+        expect(spawnCount).toBe(1);
+        // ssh drops unexpectedly (e.g. killed / network blip).
+        childA.emit("close", null);
+        expect(manager.getState().status).toBe("reconnecting");
+        // Backoff elapses → respawn.
+        vi.advanceTimersByTime(1_000);
+        expect(spawnCount).toBe(2);
+        // New child connects → back to connected.
+        childB.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc123.srv.us",
+        });
+        expect(states.map((s) => s.status)).toContain("reconnecting");
+    });
+    it("stop() during reconnect halts the backoff and does not respawn", () => {
+        const children = [makeFakeChild(), makeFakeChild()];
+        let spawnCount = 0;
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            spawn: () => children[spawnCount++] ?? makeFakeChild(),
+        });
+        const first = children[0];
+        manager.start();
+        first.stdout.emit("data", Buffer.from("https://abc123.srv.us/\n"));
+        first.emit("close", null);
+        expect(manager.getState().status).toBe("reconnecting");
+        manager.stop();
+        expect(manager.getState()).toEqual({ status: "idle" });
+        // Even after the backoff window, no respawn happened.
+        vi.advanceTimersByTime(60_000);
+        expect(spawnCount).toBe(1);
+    });
+    it("uses the provider's parseLine and ensure hook", async () => {
+        const child = makeFakeChild();
+        const ensure = vi.fn();
+        const manager = new TunnelManager({
+            getPort: () => 3000,
+            provider: {
+                name: "fake",
+                ensure,
+                spawn: () => child,
+                parseLine: (line) => {
+                    const m = line.match(/READY (\S+)/);
+                    return m?.[1] ? { kind: "connected", url: m[1] } : null;
+                },
+            },
+        });
+        manager.start();
+        // ensure() is awaited inside spawnChild; flush microtasks.
+        await Promise.resolve();
+        await Promise.resolve();
+        expect(ensure).toHaveBeenCalledTimes(1);
+        child.stdout.emit("data", Buffer.from("READY https://x.example\n"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://x.example",
+        });
+    });
+});
+//# sourceMappingURL=tunnel.test.js.map

package/dist/cli/tunnel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.test.js","sourceRoot":"","sources":["../../src/cli/tunnel.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { Readable } from \"node:stream\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { parseStdoutLine, TunnelManager, type TunnelState } from \"./tunnel.js\";\n\ndescribe(\"parseStdoutLine (delegates to the default srv.us provider)\", () => {\n  it(\"returns a connected event when a srv.us URL is seen\", () => {\n    const result = parseStdoutLine(\n      \"https://qp556ma755ktlag5b2xyt334ae.srv.us/\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://qp556ma755ktlag5b2xyt334ae.srv.us\",\n    });\n  });\n\n  it(\"returns a starting event for any other non-empty line\", () => {\n    expect(parseStdoutLine(\"Warning: Permanently added 'srv.us'\")).toEqual({\n      kind: \"starting\",\n      message: \"Warning: Permanently added 'srv.us'\",\n    });\n  });\n\n  it(\"returns null for empty lines\", () => {\n    expect(parseStdoutLine(\"\")).toBeNull();\n    expect(parseStdoutLine(\"   \")).toBeNull();\n  });\n});\n\ntype FakeChild = EventEmitter & {\n  stdout: Readable;\n  stderr: Readable;\n  kill: ReturnType<typeof vi.fn<() => boolean>>;\n};\n\nfunction makeFakeChild(): FakeChild {\n  const child = new EventEmitter() as FakeChild;\n  child.stdout = new Readable({ read() {} });\n  child.stderr = new Readable({ read() {} });\n  child.kill = vi.fn<() => boolean>(() => true);\n  return child;\n}\n\ndescribe(\"TunnelManager\", () => {\n  beforeEach(() => {\n    vi.useFakeTimers();\n  });\n  afterEach(() => {\n    vi.useRealTimers();\n  });\n\n  it(\"starts idle\", () => {\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => makeFakeChild(),\n    });\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n  });\n\n  it(\"transitions idle -> starting -> connected as stdout reports progress\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    const states: string[] = [];\n    manager.on(\"state\", (s: TunnelState) => states.push(s.status));\n\n    manager.start();\n    child.stdout.emit(\"data\", Buffer.from(\"Opening tunnel...\\n\"));\n    child.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n\n    expect(states).toEqual([\"starting\", \"starting\", \"connected\"]);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc123.srv.us\",\n    });\n  });\n\n  it(\"emits activity events for stdout lines after connect\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    const activity: Array<{ text: string; level: string }> = [];\n    manager.on(\"activity\", (a: { text: string; level: string }) =>\n      activity.push({ text: a.text, level: a.level }),\n    );\n\n    manager.start();\n    child.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n    child.stdout.emit(\"data\", Buffer.from(\"GET /widgets/foo\\n\"));\n    child.stderr.emit(\"data\", Buffer.from(\"connection wobble\\n\"));\n\n    expect(activity).toEqual([\n      { text: \"GET /widgets/foo\", level: \"log\" },\n      { text: \"connection wobble\", level: \"error\" },\n    ]);\n  });\n\n  it(\"calling start twice does not spawn twice\", () => {\n    const spawn = vi.fn(() => makeFakeChild());\n    const manager = new TunnelManager({ getPort: () => 3000, spawn });\n    manager.start();\n    manager.start();\n    expect(spawn).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"transitions to error when the connection times out\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n\n    vi.advanceTimersByTime(60_000);\n\n    expect(manager.getState().status).toBe(\"error\");\n    expect(child.kill).toHaveBeenCalled();\n  });\n\n  it(\"preserves the timeout error message when the killed child later emits close\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n\n    vi.advanceTimersByTime(60_000);\n    // The killed child emits a non-zero close after the timeout fired.\n    child.emit(\"close\", 1);\n\n    expect(manager.getState()).toEqual({\n      status: \"error\",\n      message: \"Tunnel connection timed out after one minute\",\n    });\n  });\n\n  it(\"stop() kills the subprocess and goes idle\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n    manager.stop();\n    expect(child.kill).toHaveBeenCalled();\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n  });\n\n  it(\"subscribers get the current state on subscribe\", () => {\n    const child = makeFakeChild();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => child,\n    });\n    manager.start();\n    child.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n\n    let received: TunnelState | undefined;\n    const unsubscribe = manager.subscribe((s) => {\n      received = s;\n    });\n    expect(received).toEqual({\n      status: \"connected\",\n      url: \"https://abc123.srv.us\",\n    });\n    unsubscribe();\n  });\n\n  it(\"ignores deferred close from a child that was replaced via stop()+start()\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n\n    manager.start();\n    manager.stop();\n    manager.start();\n    childB.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc123.srv.us\",\n    });\n\n    // Stale close from childA arrives only now — must not clobber state.\n    childA.emit(\"close\", null);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc123.srv.us\",\n    });\n  });\n\n  it(\"ignores deferred error from a child that was replaced via stop()+start()\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n\n    manager.start();\n    manager.stop();\n    manager.start();\n    childB.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n\n    childA.emit(\"error\", new Error(\"late spawn failure\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc123.srv.us\",\n    });\n  });\n\n  it(\"auto-reconnects when the ssh child exits unexpectedly while up\", () => {\n    const childA = makeFakeChild();\n    const childB = makeFakeChild();\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => (spawnCount++ === 0 ? childA : childB),\n    });\n    const states: TunnelState[] = [];\n    manager.on(\"state\", (s: TunnelState) => states.push(s));\n\n    manager.start();\n    childA.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n    expect(manager.getState().status).toBe(\"connected\");\n    expect(spawnCount).toBe(1);\n\n    // ssh drops unexpectedly (e.g. killed / network blip).\n    childA.emit(\"close\", null);\n    expect(manager.getState().status).toBe(\"reconnecting\");\n\n    // Backoff elapses → respawn.\n    vi.advanceTimersByTime(1_000);\n    expect(spawnCount).toBe(2);\n\n    // New child connects → back to connected.\n    childB.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc123.srv.us\",\n    });\n    expect(states.map((s) => s.status)).toContain(\"reconnecting\");\n  });\n\n  it(\"stop() during reconnect halts the backoff and does not respawn\", () => {\n    const children = [makeFakeChild(), makeFakeChild()];\n    let spawnCount = 0;\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      spawn: () => children[spawnCount++] ?? makeFakeChild(),\n    });\n\n    const first = children[0] as FakeChild;\n    manager.start();\n    first.stdout.emit(\"data\", Buffer.from(\"https://abc123.srv.us/\\n\"));\n    first.emit(\"close\", null);\n    expect(manager.getState().status).toBe(\"reconnecting\");\n\n    manager.stop();\n    expect(manager.getState()).toEqual({ status: \"idle\" });\n\n    // Even after the backoff window, no respawn happened.\n    vi.advanceTimersByTime(60_000);\n    expect(spawnCount).toBe(1);\n  });\n\n  it(\"uses the provider's parseLine and ensure hook\", async () => {\n    const child = makeFakeChild();\n    const ensure = vi.fn();\n    const manager = new TunnelManager({\n      getPort: () => 3000,\n      provider: {\n        name: \"fake\",\n        ensure,\n        spawn: () => child,\n        parseLine: (line) => {\n          const m = line.match(/READY (\\S+)/);\n          return m?.[1] ? { kind: \"connected\", url: m[1] } : null;\n        },\n      },\n    });\n\n    manager.start();\n    // ensure() is awaited inside spawnChild; flush microtasks.\n    await Promise.resolve();\n    await Promise.resolve();\n    expect(ensure).toHaveBeenCalledTimes(1);\n\n    child.stdout.emit(\"data\", Buffer.from(\"READY https://x.example\\n\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://x.example\",\n    });\n  });\n});\n"]}

package/dist/cli/types.d.ts

@@ -0,0 +1,5 @@
+export type Message = {
+    id: string;
+    text: string;
+    type: "log" | "restart" | "error";
+};

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Message = {\n  id: string;\n  text: string;\n  type: \"log\" | \"restart\" | \"error\";\n};\n"]}

package/dist/cli/use-execute-steps.d.ts

@@ -0,0 +1,11 @@
+export interface CommandStep {
+    label: string;
+    command?: string;
+    run?: () => void | Promise<void>;
+}
+export declare const useExecuteSteps: (steps: CommandStep[]) => {
+    currentStep: number;
+    status: "error" | "running" | "success";
+    error: string | null;
+    execute: () => Promise<void>;
+};

package/dist/cli/use-execute-steps.js

@@ -0,0 +1,36 @@
+import { useCallback, useState } from "react";
+import { runCommand } from "./run-command.js";
+export const useExecuteSteps = (steps) => {
+    const [currentStep, setCurrentStep] = useState(0);
+    const [status, setStatus] = useState("running");
+    const [error, setError] = useState(null);
+    const execute = useCallback(async () => {
+        try {
+            for (let i = 0; i < steps.length; i++) {
+                const step = steps[i];
+                if (step) {
+                    setCurrentStep(i);
+                    if (step.run) {
+                        await step.run();
+                    }
+                    if (step.command) {
+                        await runCommand(step.command);
+                    }
+                }
+            }
+            setStatus("success");
+            setImmediate(() => {
+                process.exit(0);
+            });
+        }
+        catch (err) {
+            setStatus("error");
+            setError(err instanceof Error ? err.message : String(err));
+            setImmediate(() => {
+                process.exit(1);
+            });
+        }
+    }, [steps]);
+    return { currentStep, status, error, execute };
+};
+//# sourceMappingURL=use-execute-steps.js.map