pi-kot 0.1.21 → 0.1.23

package/dist/server/tunnel/providers/ngrok.js

@@ -0,0 +1,461 @@
+/**
+ * Ngrok tunnel provider — spawns ngrok as a child process, parses JSON-log
+ * output for the public URL, and manages the tunnel lifecycle.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { createExecutableSearchEnv, resolveExecutableLaunchTarget, } from "../executable-search.js";
+import { getTunnelDependencyInstallInfo } from "../install-help.js";
+import { TUNNEL_INTENT_EPHEMERAL_PUBLIC, TUNNEL_MODE_QUICK, TUNNEL_PROVIDER_NGROK, TunnelServiceError, } from "../types.js";
+// ── Constants ─────────────────────────────────────────────────────────────
+const DEFAULT_STARTUP_TIMEOUT_MS = 30_000;
+const NGROK_API_URL = "http://127.0.0.1:4040/api/tunnels";
+const NGROK_PUBLIC_URL_REGEX = /https:\/\/[^\s"']+/i;
+const NGROK_AUTHTOKEN_HELP = "Run: ngrok config add-authtoken <your-ngrok-token>";
+function getNgrokInstallInfo() {
+    return getTunnelDependencyInstallInfo(TUNNEL_PROVIDER_NGROK);
+}
+// ── Capabilities ──────────────────────────────────────────────────────────
+export const ngrokTunnelProviderCapabilities = {
+    provider: TUNNEL_PROVIDER_NGROK,
+    defaults: {
+        mode: TUNNEL_MODE_QUICK,
+        optionDefaults: {},
+    },
+    modes: [
+        {
+            key: TUNNEL_MODE_QUICK,
+            label: "Quick Tunnel",
+            intent: TUNNEL_INTENT_EPHEMERAL_PUBLIC,
+            requires: [],
+            supports: ["sessionTTL"],
+            stability: "beta",
+        },
+    ],
+};
+// ── Dependency checks ─────────────────────────────────────────────────────
+export async function checkNgrokAvailable() {
+    const target = resolveExecutableLaunchTarget("ngrok");
+    if (target) {
+        try {
+            const result = spawnSync(target.command, ["version"], {
+                encoding: "utf8",
+                stdio: ["pipe", "pipe", "pipe"],
+                windowsHide: true,
+                env: target.env,
+            });
+            if (result.status === 0) {
+                const version = (result.stdout || result.stderr || "").trim();
+                return {
+                    available: true,
+                    path: target.command,
+                    version: (version || undefined) ?? null,
+                };
+            }
+        }
+        catch {
+            // Ignore and report unavailable below.
+        }
+    }
+    return { available: false, path: null, version: null };
+}
+export async function checkNgrokAuthtokenConfigured(ngrokPath = null) {
+    const authTokenEnv = process.env.NGROK_AUTHTOKEN;
+    if (typeof authTokenEnv === "string" && authTokenEnv.trim().length > 0) {
+        return { configured: true, detail: "NGROK_AUTHTOKEN is set." };
+    }
+    const target = ngrokPath
+        ? { command: ngrokPath, env: createExecutableSearchEnv() }
+        : resolveExecutableLaunchTarget("ngrok");
+    if (!target) {
+        return { configured: false, detail: getNgrokInstallInfo().message };
+    }
+    try {
+        const result = spawnSync(target.command, ["config", "check"], {
+            encoding: "utf8",
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+            env: target.env,
+        });
+        const output = `${result.stdout || ""}${result.stderr || ""}`.trim();
+        if (result.status === 0) {
+            return { configured: true, detail: output || "ngrok config is valid." };
+        }
+        return { configured: false, detail: output || NGROK_AUTHTOKEN_HELP };
+    }
+    catch (error) {
+        return {
+            configured: false,
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function checkNgrokApiReachability(options = {}) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? 5000;
+    if (typeof fetchImpl !== "function") {
+        return { reachable: false, status: null, error: "Fetch API is unavailable in this runtime." };
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchImpl("https://api.ngrok.com/", {
+            method: "GET",
+            signal: controller.signal,
+        });
+        return { reachable: true, status: response.status, error: null };
+    }
+    catch (error) {
+        return {
+            reachable: false,
+            status: null,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+// ── URL extraction ────────────────────────────────────────────────────────
+function normalizeNgrokPublicUrl(value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return null;
+    }
+    const trimmed = value.trim();
+    try {
+        const parsed = new URL(trimmed);
+        if (parsed.protocol === "https:" && parsed.hostname.includes("ngrok")) {
+            return parsed.toString().replace(/\/$/, "");
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export function extractNgrokPublicUrlFromText(text) {
+    if (typeof text !== "string" || text.trim().length === 0) {
+        return null;
+    }
+    const lines = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    for (const line of lines) {
+        // Try JSON parse (ngrok --log-format=json)
+        try {
+            const parsed = JSON.parse(line);
+            const parsedUrl = normalizeNgrokPublicUrl(parsed?.url) ??
+                normalizeNgrokPublicUrl(parsed?.public_url);
+            if (parsedUrl) {
+                return parsedUrl;
+            }
+        }
+        catch {
+            // ngrok may emit non-JSON diagnostics even when log-format=json.
+        }
+        // Fallback: regex scan
+        const match = line.match(NGROK_PUBLIC_URL_REGEX);
+        const matchedUrl = normalizeNgrokPublicUrl(match?.[0] ?? "");
+        if (matchedUrl) {
+            return matchedUrl;
+        }
+    }
+    return null;
+}
+// ── Output summarization ──────────────────────────────────────────────────
+function normalizeNgrokDiagnosticText(value) {
+    if (typeof value !== "string") {
+        return "";
+    }
+    return value
+        .replace(/\r/g, "")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .join(" ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function summarizeNgrokOutput(lines) {
+    const nonEmptyLines = Array.isArray(lines)
+        ? lines.map((line) => String(line || "").trim()).filter(Boolean)
+        : [];
+    if (nonEmptyLines.length === 0) {
+        return "";
+    }
+    // Scan for error-level JSON lines first
+    for (const line of [...nonEmptyLines].reverse()) {
+        try {
+            const parsed = JSON.parse(line);
+            const level = typeof parsed?.lvl === "string" ? parsed.lvl.toLowerCase() : "";
+            if (level !== "eror" && level !== "error" && level !== "crit") {
+                continue;
+            }
+            const err = normalizeNgrokDiagnosticText(parsed?.err);
+            if (err && err !== "<nil>") {
+                return err;
+            }
+        }
+        catch {
+            // Not a JSON ngrok log line.
+        }
+    }
+    // Scan for any JSON line with a meaningful error
+    for (const line of [...nonEmptyLines].reverse()) {
+        try {
+            const parsed = JSON.parse(line);
+            const err = normalizeNgrokDiagnosticText(parsed?.err);
+            if (err && err !== "<nil>" && !/context canceled/i.test(err)) {
+                return err;
+            }
+            const msg = normalizeNgrokDiagnosticText(parsed?.msg);
+            if (msg && /failed|error|invalid|auth/i.test(msg)) {
+                return msg;
+            }
+        }
+        catch {
+            // Not a JSON ngrok log line.
+        }
+    }
+    // Fallback: scan for ERROR: prefix lines
+    const errorLines = nonEmptyLines
+        .filter((line) => /^ERROR:/i.test(line))
+        .map((line) => normalizeNgrokDiagnosticText(line.replace(/^ERROR:\s*/i, "")))
+        .filter(Boolean);
+    if (errorLines.length > 0) {
+        return errorLines.slice(0, 4).join(" ");
+    }
+    // Last resort: return the last non-empty line
+    const lastLine = [...nonEmptyLines].reverse().find((line) => line.trim().length > 0);
+    if (!lastLine) {
+        return "";
+    }
+    try {
+        const parsed = JSON.parse(lastLine);
+        if (typeof parsed?.err === "string" && parsed.err.trim().length > 0) {
+            return normalizeNgrokDiagnosticText(parsed.err);
+        }
+        if (typeof parsed?.msg === "string" && parsed.msg.trim().length > 0) {
+            return normalizeNgrokDiagnosticText(parsed.msg);
+        }
+    }
+    catch {
+        // Fall through to plain text.
+    }
+    return normalizeNgrokDiagnosticText(lastLine);
+}
+function appendNgrokOutputSummary(message, lines) {
+    const summary = summarizeNgrokOutput(lines);
+    return summary ? `${message}: ${summary}` : message;
+}
+// ── API-based URL fetch ───────────────────────────────────────────────────
+async function fetchNgrokPublicUrl(fetchImpl = globalThis.fetch) {
+    if (typeof fetchImpl !== "function") {
+        return null;
+    }
+    try {
+        const response = await fetchImpl(NGROK_API_URL, { method: "GET" });
+        if (!response.ok) {
+            return null;
+        }
+        const payload = (await response.json());
+        const tunnels = Array.isArray(payload?.tunnels) ? payload.tunnels : [];
+        const httpsTunnel = tunnels.find((entry) => entry?.proto === "https" && normalizeNgrokPublicUrl(entry?.public_url ?? ""));
+        const fallbackTunnel = tunnels.find((entry) => normalizeNgrokPublicUrl(entry?.public_url ?? ""));
+        return (normalizeNgrokPublicUrl(httpsTunnel?.public_url ?? "") ??
+            normalizeNgrokPublicUrl(fallbackTunnel?.public_url ?? ""));
+    }
+    catch {
+        return null;
+    }
+}
+// ── Tunnel starter ────────────────────────────────────────────────────────
+function spawnNgrok(args, resolvedBinaryPath = "ngrok") {
+    return spawn(resolvedBinaryPath, args, {
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        env: createExecutableSearchEnv(),
+        killSignal: "SIGINT",
+    });
+}
+export async function startNgrokQuickTunnel(params) {
+    const ngrokCheck = await checkNgrokAvailable();
+    if (!ngrokCheck.available) {
+        throw new Error(getNgrokInstallInfo().message);
+    }
+    const authtokenCheck = await checkNgrokAuthtokenConfigured(ngrokCheck.path);
+    if (!authtokenCheck.configured) {
+        throw new Error(`ngrok authtoken is not configured. ${authtokenCheck.detail || NGROK_AUTHTOKEN_HELP}`);
+    }
+    if (!Number.isFinite(params.port)) {
+        throw new Error("A local port is required to start an ngrok tunnel");
+    }
+    const child = spawnNgrok(["http", "--log=stdout", "--log-format=json", `127.0.0.1:${params.port}`], ngrokCheck.path ?? undefined);
+    let publicUrl = null;
+    const recentOutput = [];
+    const captureOutput = (chunk) => {
+        const text = chunk.toString("utf8");
+        const parsedUrl = extractNgrokPublicUrlFromText(text);
+        if (parsedUrl) {
+            publicUrl = parsedUrl;
+        }
+        for (const line of text.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (!trimmed) {
+                continue;
+            }
+            recentOutput.push(trimmed);
+            if (recentOutput.length > 200) {
+                recentOutput.shift();
+            }
+        }
+        return text;
+    };
+    child.stdout?.on("data", (chunk) => {
+        captureOutput(chunk);
+    });
+    child.stderr?.on("data", (chunk) => {
+        const text = captureOutput(chunk);
+        process.stderr.write(text);
+    });
+    await new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (handler, value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            clearInterval(checkReady);
+            child.off("error", onError);
+            child.off("exit", onExit);
+            handler(value);
+        };
+        const timeout = setTimeout(() => {
+            try {
+                child.kill("SIGINT");
+            }
+            catch { /* ignore */ }
+            finish(reject, new Error(appendNgrokOutputSummary("Ngrok tunnel URL not received within 30 seconds", recentOutput)));
+        }, DEFAULT_STARTUP_TIMEOUT_MS);
+        const checkReady = setInterval(async () => {
+            publicUrl = publicUrl || (await fetchNgrokPublicUrl());
+            if (publicUrl) {
+                finish(resolve, undefined);
+            }
+        }, 250);
+        const onError = (error) => {
+            finish(reject, new Error(`Ngrok failed to start: ${error.message}`));
+        };
+        const onExit = (code) => {
+            finish(reject, new Error(appendNgrokOutputSummary(`Ngrok exited while starting (code ${code ?? "unknown"})`, recentOutput)));
+        };
+        child.once("error", onError);
+        child.once("exit", onExit);
+    });
+    return {
+        mode: TUNNEL_MODE_QUICK,
+        provider: TUNNEL_PROVIDER_NGROK,
+        process: child,
+        stop: () => {
+            try {
+                child.kill("SIGINT");
+            }
+            catch {
+                // Ignore.
+            }
+        },
+        getPublicUrl: () => publicUrl,
+    };
+}
+// ── Standalone diagnose (used by routes without creating a provider instance) ──
+export async function diagnoseNgrok() {
+    const dependency = await checkNgrokAvailable();
+    const authtoken = await checkNgrokAuthtokenConfigured(dependency.path);
+    const network = await checkNgrokApiReachability();
+    const installInfo = getTunnelDependencyInstallInfo(TUNNEL_PROVIDER_NGROK);
+    const startupReady = dependency.available && authtoken.configured && network.reachable;
+    const providerChecks = [
+        {
+            id: "dependency",
+            label: "ngrok installed",
+            status: dependency.available ? "pass" : "fail",
+            detail: dependency.available
+                ? (dependency.version || dependency.path || "ngrok available")
+                : installInfo.message,
+        },
+        {
+            id: "authtoken",
+            label: "ngrok authtoken configured",
+            status: authtoken.configured ? "pass" : "fail",
+            detail: authtoken.configured
+                ? authtoken.detail
+                : (authtoken.detail || "Run: ngrok config add-authtoken <your-ngrok-token>"),
+        },
+        {
+            id: "network",
+            label: "ngrok API reachable",
+            status: network.reachable ? "pass" : "fail",
+            detail: network.reachable
+                ? (network.status ? `HTTP ${network.status}` : "Reachable")
+                : (network.error || "Could not reach api.ngrok.com"),
+        },
+    ];
+    return {
+        providerChecks,
+        modes: [
+            {
+                mode: TUNNEL_MODE_QUICK,
+                checks: [
+                    {
+                        id: "startup_readiness",
+                        label: "Provider startup readiness",
+                        status: startupReady ? "pass" : "fail",
+                        detail: startupReady
+                            ? "Provider dependency, auth, and network checks passed."
+                            : "Resolve provider checks before starting tunnels.",
+                    },
+                ],
+                summary: {
+                    ready: startupReady,
+                    failures: startupReady ? 0 : 1,
+                    warnings: 0,
+                },
+                ready: startupReady,
+                blockers: startupReady ? [] : ["Resolve provider checks before starting tunnels."],
+            },
+        ],
+    };
+}
+// ── Provider factory ──────────────────────────────────────────────────────
+export function createNgrokTunnelProvider() {
+    return {
+        id: TUNNEL_PROVIDER_NGROK,
+        capabilities: ngrokTunnelProviderCapabilities,
+        checkAvailability: async () => {
+            const result = await checkNgrokAvailable();
+            if (result.available) {
+                return {
+                    ...result,
+                    ...getTunnelDependencyInstallInfo(TUNNEL_PROVIDER_NGROK),
+                };
+            }
+            const installInfo = getTunnelDependencyInstallInfo(TUNNEL_PROVIDER_NGROK);
+            return {
+                ...result,
+                ...installInfo,
+            };
+        },
+        diagnose: async (_request) => {
+            return diagnoseNgrok();
+        },
+        start: async (request, context) => {
+            if (request.mode !== TUNNEL_MODE_QUICK) {
+                throw new TunnelServiceError("mode_unsupported", `Ngrok only supports '${TUNNEL_MODE_QUICK}' mode right now`);
+            }
+            return startNgrokQuickTunnel({ port: context.activePort ?? 0 });
+        },
+        stop: (controller) => {
+            controller?.stop?.();
+        },
+        resolvePublicUrl: (controller) => controller?.getPublicUrl?.() ?? null,
+        getMetadata: () => null,
+    };
+}
+//# sourceMappingURL=ngrok.js.map

package/dist/server/tunnel/providers/ngrok.js.map

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

package/dist/server/tunnel/registry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tunnel provider registry — a sealable Map-based registry that validates
+ * required methods on registration.
+ */
+import type { TunnelProvider, TunnelProviderRegistry } from "./types.js";
+/**
+ * Create a sealable tunnel provider registry.
+ *
+ * @param initialProviders - Optional array of providers to register immediately.
+ * @returns A registry with register, get, list, listCapabilities, and seal.
+ */
+export declare function createTunnelProviderRegistry(initialProviders?: TunnelProvider[]): TunnelProviderRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/server/tunnel/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tunnel/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA8B,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIrG;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,gBAAgB,GAAE,cAAc,EAAO,GACtC,sBAAsB,CAmDxB"}

package/dist/server/tunnel/registry.js

@@ -0,0 +1,56 @@
+/**
+ * Tunnel provider registry — a sealable Map-based registry that validates
+ * required methods on registration.
+ */
+const REQUIRED_PROVIDER_METHODS = ["start", "stop", "checkAvailability", "resolvePublicUrl"];
+/**
+ * Create a sealable tunnel provider registry.
+ *
+ * @param initialProviders - Optional array of providers to register immediately.
+ * @returns A registry with register, get, list, listCapabilities, and seal.
+ */
+export function createTunnelProviderRegistry(initialProviders = []) {
+    const providers = new Map();
+    let sealed = false;
+    const register = (provider) => {
+        if (sealed) {
+            throw new Error("Tunnel provider registry is sealed; no further registrations allowed");
+        }
+        if (!provider || typeof provider.id !== "string" || provider.id.trim().length === 0) {
+            throw new Error("Tunnel provider must define a non-empty id");
+        }
+        for (const method of REQUIRED_PROVIDER_METHODS) {
+            if (typeof provider[method] !== "function") {
+                throw new Error(`Tunnel provider '${provider.id}' must implement ${method}()`);
+            }
+        }
+        const key = provider.id.trim().toLowerCase();
+        if (providers.has(key)) {
+            throw new Error(`Tunnel provider '${key}' is already registered`);
+        }
+        providers.set(key, provider);
+        return provider;
+    };
+    const get = (providerId) => {
+        if (typeof providerId !== "string" || providerId.trim().length === 0) {
+            return null;
+        }
+        return providers.get(providerId.trim().toLowerCase()) ?? null;
+    };
+    const list = () => Array.from(providers.values());
+    const listCapabilities = () => list().map((provider) => ({ ...provider.capabilities }));
+    for (const provider of initialProviders) {
+        register(provider);
+    }
+    const seal = () => {
+        sealed = true;
+    };
+    return {
+        register,
+        get,
+        list,
+        listCapabilities,
+        seal,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/server/tunnel/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tunnel/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,kBAAkB,CAAU,CAAC;AAEtG;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,gBAAgB,GAAqB,EAAE;IAEvC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IACpD,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAkB,EAAE;QAC5D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,yBAAyB,EAAE,CAAC;YAC/C,IAAI,OAAQ,QAA+C,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;gBACnF,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,EAAE,oBAAoB,MAAM,IAAI,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,yBAAyB,CAAC,CAAC;QACpE,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,UAAkB,EAAyB,EAAE;QACxD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;IAChE,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAqB,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpE,MAAM,gBAAgB,GAAG,GAAiC,EAAE,CAC1D,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAE3D,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,GAAG;QACH,IAAI;QACJ,gBAAgB;QAChB,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/server/tunnel/service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tunnel service — orchestrates tunnel provider lifecycle with a start mutex
+ * to prevent concurrent starts from orphaning child processes.
+ */
+import { type TunnelService, type TunnelServiceDeps } from "./types.js";
+/**
+ * Create the tunnel service.
+ *
+ * @param deps - Service dependencies (registry, controller accessors, port, warning callback).
+ * @returns A TunnelService with start, stop, checkAvailability, getPublicUrl, etc.
+ */
+export declare function createTunnelService(deps: TunnelServiceDeps): TunnelService;
+//# sourceMappingURL=service.d.ts.map

package/dist/server/tunnel/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/tunnel/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAIvB,MAAM,YAAY,CAAC;AAGpB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAyL1E"}