skybridge 0.0.0-dev.e1b82ca → 0.0.0-dev.e1ca873

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 type { Readable } from \"node:stream\";\nimport spawn from \"cross-spawn\";\n\nexport type TunnelState =\n  | { status: \"idle\" }\n  | { status: \"starting\"; message: string }\n  | { status: \"connected\"; url: string }\n  | { status: \"error\"; message: string };\n\nexport type ParsedStdoutEvent =\n  | { kind: \"connected\"; url: string }\n  | { kind: \"starting\"; message: string };\n\nconst FORWARDING_RE = /Forwarding:\\s+(https?:\\/\\/\\S+)\\s*->\\s*(\\S+)/;\n\nexport function parseStdoutLine(line: string): ParsedStdoutEvent | null {\n  const trimmed = line.trim();\n  if (!trimmed) {\n    return null;\n  }\n\n  const match = trimmed.match(FORWARDING_RE);\n  if (match?.[1]) {\n    return { kind: \"connected\", url: match[1].replace(/\\/$/, \"\") };\n  }\n  return { kind: \"starting\", message: trimmed };\n}\n\nconst CONNECT_TIMEOUT_MS = 60_000;\nconst STDERR_BUFFER_BYTES = 1024;\n\nexport type TunnelActivity = {\n  time: string;\n  text: string;\n  level: \"log\" | \"error\";\n};\n\nexport type TunnelChildProcess = {\n  stdout: Pick<Readable, \"on\"> | null;\n  stderr: Pick<Readable, \"on\"> | null;\n  kill: (signal?: NodeJS.Signals | number) => boolean;\n  on(event: \"error\", listener: (err: Error) => void): unknown;\n  on(event: \"close\", listener: (code: number | null) => void): unknown;\n};\n\nexport type SpawnFn = (port: number) => TunnelChildProcess;\n\nconst defaultSpawn: SpawnFn = (port) =>\n  spawn(\n    \"npx\",\n    [\"--yes\", \"alpic\", \"tunnel\", \"--port\", String(port), \"--plain\"],\n    {\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\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 stderrBuffer = \"\";\n  private connected = false;\n  private readonly getPort: () => number;\n  private readonly spawnFn: SpawnFn;\n\n  constructor(opts: { getPort: () => number; spawn?: SpawnFn }) {\n    super();\n    this.getPort = opts.getPort;\n    this.spawnFn = opts.spawn ?? defaultSpawn;\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 (this.state.status === \"starting\" || this.state.status === \"connected\") {\n      return;\n    }\n\n    this.connected = false;\n    this.stderrBuffer = \"\";\n    this.setState({ status: \"starting\", message: \"Starting tunnel…\" });\n\n    const child = this.spawnFn(this.getPort());\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.\n        this.child = null;\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.setState({ status: \"error\", message: err.message });\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      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      this.child = null;\n    });\n  }\n\n  stop(): void {\n    this.clearConnectTimeout();\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 = parseStdoutLine(raw);\n      if (!parsed) {\n        continue;\n      }\n      if (parsed.kind === \"connected\") {\n        this.connected = true;\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"]}

package/dist/cli/tunnel.test.js

@@ -0,0 +1,190 @@
+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", () => {
+    it("returns a connected event when the forwarding line is seen", () => {
+        const result = parseStdoutLine("Forwarding: https://abc.tunnel.example -> http://localhost:3000");
+        expect(result).toEqual({
+            kind: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    it("strips a trailing slash from the forwarded URL", () => {
+        const result = parseStdoutLine("Forwarding: https://abc.tunnel.example/ -> http://localhost:3000");
+        expect(result).toEqual({
+            kind: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    it("returns a starting event for any other non-empty line", () => {
+        expect(parseStdoutLine("Opening tunnel...")).toEqual({
+            kind: "starting",
+            message: "Opening tunnel...",
+        });
+    });
+    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("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        expect(states).toEqual(["starting", "starting", "connected"]);
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    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("Forwarding: https://abc.tunnel.example -> http://localhost:3000\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("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        let received;
+        const unsubscribe = manager.subscribe((s) => {
+            received = s;
+        });
+        expect(received).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+        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("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+        // Stale close from childA arrives only now — must not clobber state.
+        childA.emit("close", null);
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.example",
+        });
+    });
+    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("Forwarding: https://abc.tunnel.example -> http://localhost:3000\n"));
+        childA.emit("error", new Error("late spawn failure"));
+        expect(manager.getState()).toEqual({
+            status: "connected",
+            url: "https://abc.tunnel.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\", () => {\n  it(\"returns a connected event when the forwarding line is seen\", () => {\n    const result = parseStdoutLine(\n      \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"strips a trailing slash from the forwarded URL\", () => {\n    const result = parseStdoutLine(\n      \"Forwarding: https://abc.tunnel.example/ -> http://localhost:3000\",\n    );\n    expect(result).toEqual({\n      kind: \"connected\",\n      url: \"https://abc.tunnel.example\",\n    });\n  });\n\n  it(\"returns a starting event for any other non-empty line\", () => {\n    expect(parseStdoutLine(\"Opening tunnel...\")).toEqual({\n      kind: \"starting\",\n      message: \"Opening tunnel...\",\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(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    expect(states).toEqual([\"starting\", \"starting\", \"connected\"]);\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\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(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\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(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\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://abc.tunnel.example\",\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(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.example\",\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://abc.tunnel.example\",\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(\n      \"data\",\n      Buffer.from(\n        \"Forwarding: https://abc.tunnel.example -> http://localhost:3000\\n\",\n      ),\n    );\n\n    childA.emit(\"error\", new Error(\"late spawn failure\"));\n    expect(manager.getState()).toEqual({\n      status: \"connected\",\n      url: \"https://abc.tunnel.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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-execute-steps.js","sourceRoot":"","sources":["../../src/cli/use-execute-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAoB,EAAE,EAAE;IACtD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,SAAS,CACV,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,IAAI,CAAC;YACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,EAAE,CAAC;oBACT,cAAc,CAAC,CAAC,CAAC,CAAC;oBAClB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;wBACb,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;oBACnB,CAAC;oBACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjB,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC,CAAC","sourcesContent":["import { useCallback, useState } from \"react\";\nimport { runCommand } from \"./run-command.js\";\n\nexport interface CommandStep {\n  label: string;\n  command?: string;\n  run?: () => void | Promise<void>;\n}\n\nexport const useExecuteSteps = (steps: CommandStep[]) => {\n  const [currentStep, setCurrentStep] = useState<number>(0);\n  const [status, setStatus] = useState<\"running\" | \"success\" | \"error\">(\n    \"running\",\n  );\n  const [error, setError] = useState<string | null>(null);\n\n  const execute = useCallback(async () => {\n    try {\n      for (let i = 0; i < steps.length; i++) {\n        const step = steps[i];\n        if (step) {\n          setCurrentStep(i);\n          if (step.run) {\n            await step.run();\n          }\n          if (step.command) {\n            await runCommand(step.command);\n          }\n        }\n      }\n      setStatus(\"success\");\n      setImmediate(() => {\n        process.exit(0);\n      });\n    } catch (err) {\n      setStatus(\"error\");\n      setError(err instanceof Error ? err.message : String(err));\n      setImmediate(() => {\n        process.exit(1);\n      });\n    }\n  }, [steps]);\n\n  return { currentStep, status, error, execute };\n};\n"]}

package/dist/cli/use-messages.d.ts

@@ -0,0 +1,3 @@
+import type { Message } from "./types.js";
+export type PushMessage = (text: string, type: Message["type"]) => void;
+export declare function useMessages(): [Array<Message>, PushMessage];

package/dist/cli/use-messages.js

@@ -0,0 +1,11 @@
+import { randomUUID } from "node:crypto";
+import { useCallback, useState } from "react";
+const MAX_MESSAGES = 10;
+export function useMessages() {
+    const [messages, setMessages] = useState([]);
+    const push = useCallback((text, type) => {
+        setMessages((prev) => [...prev, { id: randomUUID(), text, type }].slice(-MAX_MESSAGES));
+    }, []);
+    return [messages, push];
+}
+//# sourceMappingURL=use-messages.js.map

package/dist/cli/use-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-messages.js","sourceRoot":"","sources":["../../src/cli/use-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,MAAM,YAAY,GAAG,EAAE,CAAC;AAIxB,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IAE7D,MAAM,IAAI,GAAG,WAAW,CAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACnD,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CACjE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { useCallback, useState } from \"react\";\nimport type { Message } from \"./types.js\";\n\nconst MAX_MESSAGES = 10;\n\nexport type PushMessage = (text: string, type: Message[\"type\"]) => void;\n\nexport function useMessages(): [Array<Message>, PushMessage] {\n  const [messages, setMessages] = useState<Array<Message>>([]);\n\n  const push = useCallback<PushMessage>((text, type) => {\n    setMessages((prev) =>\n      [...prev, { id: randomUUID(), text, type }].slice(-MAX_MESSAGES),\n    );\n  }, []);\n\n  return [messages, push];\n}\n"]}

package/dist/cli/use-nodemon.d.ts

@@ -0,0 +1,26 @@
+import type { PushMessage } from "./use-messages.js";
+export declare const CRASH_MESSAGE = "\uD83D\uDCA5  Server crashed. Fix the error, then save a watched file to restart it.";
+export interface NodemonHandlers {
+    /** A raw chunk of server stdout, forwarded untouched. */
+    onStdout: (chunk: Buffer) => void;
+    /** A (filtered) chunk of server stderr. */
+    onStderr: (message: string) => void;
+    /** The server restarted because the listed files changed. */
+    onRestart: (files: string[]) => void;
+    /**
+     * The server exited with a non-zero code. nodemon does not restart it on its
+     * own: it waits for the next file change.
+     */
+    onCrash: () => void;
+}
+/**
+ * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a
+ * cleanup function that detaches the listeners and quits nodemon. Shared by the
+ * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.
+ */
+export declare function startNodemon(env: NodeJS.ProcessEnv, handlers: NodemonHandlers): () => void;
+/**
+ * Boot nodemon for the Ink dev UI. Returns whether the server is currently
+ * down after a crash, so the UI can stop advertising a URL nothing listens on.
+ */
+export declare function useNodemon(env: NodeJS.ProcessEnv, pushMessage: PushMessage): boolean;

package/dist/cli/use-nodemon.js

@@ -0,0 +1,106 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { useEffect, useState } from "react";
+function loadNodemon() {
+    try {
+        return createRequire(import.meta.url)("nodemon");
+    }
+    catch {
+        throw new Error('skybridge dev needs the "nodemon" peer dependency. Install it with `npm install -D nodemon`.');
+    }
+}
+export const CRASH_MESSAGE = "💥  Server crashed. Fix the error, then save a watched file to restart it.";
+const SOURCEMAP_WARNING = /^Sourcemap for ".*" points to missing source files$/;
+/**
+ * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a
+ * cleanup function that detaches the listeners and quits nodemon. Shared by the
+ * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.
+ */
+export function startNodemon(env, handlers) {
+    const nodemon = loadNodemon();
+    const configFile = resolve(process.cwd(), "nodemon.json");
+    const config = existsSync(configFile)
+        ? {
+            configFile,
+        }
+        : {
+            watch: ["src"],
+            ext: "ts,json,md",
+            exec: "tsx src/index.ts",
+        };
+    nodemon({ ...config, env, stdout: false });
+    const handleStdoutData = (chunk) => {
+        handlers.onStdout(chunk);
+    };
+    const handleStderrData = (chunk) => {
+        const message = chunk.toString().trim();
+        if (!message) {
+            return;
+        }
+        // Node's source-map warnings for third-party deps (superjson, @mcp/sdk, …) — not actionable.
+        const filtered = message
+            .split("\n")
+            .filter((line) => !SOURCEMAP_WARNING.test(line))
+            .join("\n");
+        if (filtered) {
+            handlers.onStderr(filtered);
+        }
+    };
+    const setupStdoutListener = () => {
+        if (nodemon.stdout) {
+            nodemon.stdout.off("data", handleStdoutData);
+            nodemon.stdout.on("data", handleStdoutData);
+        }
+    };
+    const setupStderrListener = () => {
+        if (nodemon.stderr) {
+            nodemon.stderr.off("data", handleStderrData);
+            nodemon.stderr.on("data", handleStderrData);
+        }
+    };
+    const reattachListeners = () => {
+        setupStdoutListener();
+        setupStderrListener();
+    };
+    nodemon.on("readable", reattachListeners);
+    nodemon.on("crash", () => {
+        handlers.onCrash();
+    });
+    nodemon.on("restart", (files) => {
+        handlers.onRestart(files);
+        reattachListeners();
+    });
+    return () => {
+        if (nodemon.stdout) {
+            nodemon.stdout.off("data", handleStdoutData);
+        }
+        if (nodemon.stderr) {
+            nodemon.stderr.off("data", handleStderrData);
+        }
+        nodemon.emit("quit");
+    };
+}
+/**
+ * Boot nodemon for the Ink dev UI. Returns whether the server is currently
+ * down after a crash, so the UI can stop advertising a URL nothing listens on.
+ */
+export function useNodemon(env, pushMessage) {
+    const [crashed, setCrashed] = useState(false);
+    useEffect(() => startNodemon(env, {
+        onStdout: (chunk) => {
+            const message = chunk.toString().trim();
+            if (message) {
+                pushMessage(message, "log");
+            }
+        },
+        onStderr: (message) => pushMessage(message, "error"),
+        onRestart: (files) => {
+            setCrashed(false);
+            pushMessage(`Server restarted due to file changes: ${files.join(", ")}`, "restart");
+        },
+        onCrash: () => setCrashed(true),
+    }), [env, pushMessage]);
+    return crashed;
+}
+//# sourceMappingURL=use-nodemon.js.map

package/dist/cli/use-nodemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nodemon.js","sourceRoot":"","sources":["../../src/cli/use-nodemon.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { resolve } from \"node:path\";\nimport { useEffect, useState } from \"react\";\nimport type { ExtendedNodemon } from \"./nodemon.d.ts\";\nimport type { PushMessage } from \"./use-messages.js\";\n\nfunction loadNodemon(): ExtendedNodemon {\n  try {\n    return createRequire(import.meta.url)(\"nodemon\") as ExtendedNodemon;\n  } catch {\n    throw new Error(\n      'skybridge dev needs the \"nodemon\" peer dependency. Install it with `npm install -D nodemon`.',\n    );\n  }\n}\n\nexport const CRASH_MESSAGE =\n  \"💥  Server crashed. Fix the error, then save a watched file to restart it.\";\n\nconst SOURCEMAP_WARNING = /^Sourcemap for \".*\" points to missing source files$/;\n\nexport interface NodemonHandlers {\n  /** A raw chunk of server stdout, forwarded untouched. */\n  onStdout: (chunk: Buffer) => void;\n  /** A (filtered) chunk of server stderr. */\n  onStderr: (message: string) => void;\n  /** The server restarted because the listed files changed. */\n  onRestart: (files: string[]) => void;\n  /**\n   * The server exited with a non-zero code. nodemon does not restart it on its\n   * own: it waits for the next file change.\n   */\n  onCrash: () => void;\n}\n\n/**\n * Boot nodemon and wire its stdout/stderr to the provided handlers. Returns a\n * cleanup function that detaches the listeners and quits nodemon. Shared by the\n * Ink-based dev UI (via {@link useNodemon}) and the `--plain` runner.\n */\nexport function startNodemon(\n  env: NodeJS.ProcessEnv,\n  handlers: NodemonHandlers,\n): () => void {\n  const nodemon = loadNodemon();\n  const configFile = resolve(process.cwd(), \"nodemon.json\");\n\n  const config = existsSync(configFile)\n    ? {\n        configFile,\n      }\n    : {\n        watch: [\"src\"],\n        ext: \"ts,json,md\",\n        exec: \"tsx src/index.ts\",\n      };\n\n  nodemon({ ...config, env, stdout: false });\n\n  const handleStdoutData = (chunk: Buffer) => {\n    handlers.onStdout(chunk);\n  };\n\n  const handleStderrData = (chunk: Buffer) => {\n    const message = chunk.toString().trim();\n    if (!message) {\n      return;\n    }\n    // Node's source-map warnings for third-party deps (superjson, @mcp/sdk, …) — not actionable.\n    const filtered = message\n      .split(\"\\n\")\n      .filter((line) => !SOURCEMAP_WARNING.test(line))\n      .join(\"\\n\");\n    if (filtered) {\n      handlers.onStderr(filtered);\n    }\n  };\n\n  const setupStdoutListener = () => {\n    if (nodemon.stdout) {\n      nodemon.stdout.off(\"data\", handleStdoutData);\n      nodemon.stdout.on(\"data\", handleStdoutData);\n    }\n  };\n\n  const setupStderrListener = () => {\n    if (nodemon.stderr) {\n      nodemon.stderr.off(\"data\", handleStderrData);\n      nodemon.stderr.on(\"data\", handleStderrData);\n    }\n  };\n\n  const reattachListeners = () => {\n    setupStdoutListener();\n    setupStderrListener();\n  };\n\n  nodemon.on(\"readable\", reattachListeners);\n\n  nodemon.on(\"crash\", () => {\n    handlers.onCrash();\n  });\n\n  nodemon.on(\"restart\", (files: string[]) => {\n    handlers.onRestart(files);\n    reattachListeners();\n  });\n\n  return () => {\n    if (nodemon.stdout) {\n      nodemon.stdout.off(\"data\", handleStdoutData);\n    }\n    if (nodemon.stderr) {\n      nodemon.stderr.off(\"data\", handleStderrData);\n    }\n    nodemon.emit(\"quit\");\n  };\n}\n\n/**\n * Boot nodemon for the Ink dev UI. Returns whether the server is currently\n * down after a crash, so the UI can stop advertising a URL nothing listens on.\n */\nexport function useNodemon(\n  env: NodeJS.ProcessEnv,\n  pushMessage: PushMessage,\n): boolean {\n  const [crashed, setCrashed] = useState(false);\n\n  useEffect(\n    () =>\n      startNodemon(env, {\n        onStdout: (chunk) => {\n          const message = chunk.toString().trim();\n          if (message) {\n            pushMessage(message, \"log\");\n          }\n        },\n        onStderr: (message) => pushMessage(message, \"error\"),\n        onRestart: (files) => {\n          setCrashed(false);\n          pushMessage(\n            `Server restarted due to file changes: ${files.join(\", \")}`,\n            \"restart\",\n          );\n        },\n        onCrash: () => setCrashed(true),\n      }),\n    [env, pushMessage],\n  );\n\n  return crashed;\n}\n"]}

package/dist/cli/use-open-browser.d.ts

@@ -0,0 +1 @@
+export declare function useOpenBrowser(port: number, enabled: boolean): void;

package/dist/cli/use-open-browser.js

@@ -0,0 +1,44 @@
+import net from "node:net";
+import open from "open";
+import { useEffect, useRef } from "react";
+const POLL_INTERVAL_MS = 200;
+const POLL_TIMEOUT_MS = 5_000;
+const isPortListening = (port) => new Promise((resolve) => {
+    const socket = net.createConnection({ port, host: "127.0.0.1" });
+    socket.once("connect", () => {
+        socket.end();
+        resolve(true);
+    });
+    socket.once("error", () => {
+        socket.destroy();
+        resolve(false);
+    });
+});
+export function useOpenBrowser(port, enabled) {
+    const opened = useRef(false);
+    useEffect(() => {
+        if (!enabled || opened.current) {
+            return;
+        }
+        let cancelled = false;
+        const deadline = Date.now() + POLL_TIMEOUT_MS;
+        const tick = async () => {
+            while (!cancelled && Date.now() < deadline) {
+                if (await isPortListening(port)) {
+                    if (cancelled || opened.current) {
+                        return;
+                    }
+                    opened.current = true;
+                    await open(`http://localhost:${port}/`).catch(() => { });
+                    return;
+                }
+                await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+            }
+        };
+        void tick();
+        return () => {
+            cancelled = true;
+        };
+    }, [port, enabled]);
+}
+//# sourceMappingURL=use-open-browser.js.map

package/dist/cli/use-open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-open-browser.js","sourceRoot":"","sources":["../../src/cli/use-open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,MAAM,eAAe,GAAG,CAAC,IAAY,EAAoB,EAAE,CACzD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAgB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;QAE9C,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC3C,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChC,IAAI,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBAChC,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;oBACtB,MAAM,IAAI,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACxD,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,IAAI,EAAE,CAAC;QAEZ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import net from \"node:net\";\nimport open from \"open\";\nimport { useEffect, useRef } from \"react\";\n\nconst POLL_INTERVAL_MS = 200;\nconst POLL_TIMEOUT_MS = 5_000;\n\nconst isPortListening = (port: number): Promise<boolean> =>\n  new Promise((resolve) => {\n    const socket = net.createConnection({ port, host: \"127.0.0.1\" });\n    socket.once(\"connect\", () => {\n      socket.end();\n      resolve(true);\n    });\n    socket.once(\"error\", () => {\n      socket.destroy();\n      resolve(false);\n    });\n  });\n\nexport function useOpenBrowser(port: number, enabled: boolean): void {\n  const opened = useRef(false);\n\n  useEffect(() => {\n    if (!enabled || opened.current) {\n      return;\n    }\n\n    let cancelled = false;\n    const deadline = Date.now() + POLL_TIMEOUT_MS;\n\n    const tick = async () => {\n      while (!cancelled && Date.now() < deadline) {\n        if (await isPortListening(port)) {\n          if (cancelled || opened.current) {\n            return;\n          }\n          opened.current = true;\n          await open(`http://localhost:${port}/`).catch(() => {});\n          return;\n        }\n        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));\n      }\n    };\n\n    void tick();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [port, enabled]);\n}\n"]}

package/dist/cli/use-tunnel.d.ts

@@ -0,0 +1,14 @@
+import type { PushMessage } from "./use-messages.js";
+export type TunnelState = {
+    status: "idle";
+} | {
+    status: "starting";
+    message: string;
+} | {
+    status: "connected";
+    url: string;
+} | {
+    status: "error";
+    message: string;
+};
+export declare function useTunnel(port: number | null, pushMessage: PushMessage, verbose: boolean, autoStart: boolean): TunnelState;