pi-kot 0.1.21 → 0.1.22

package/server/tunnel/service.js

@@ -0,0 +1,156 @@
+/**
+ * Tunnel service — orchestrates tunnel provider lifecycle with a start mutex
+ * to prevent concurrent starts from orphaning child processes.
+ */
+import { TUNNEL_MODE_QUICK, TunnelServiceError, normalizeTunnelStartRequest, validateTunnelStartRequest, } 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 function createTunnelService(deps) {
+    const { registry, getController, setController, getActivePort, onQuickTunnelWarning, } = deps;
+    if (!registry) {
+        throw new Error("Tunnel service requires a provider registry");
+    }
+    const resolveActiveMode = () => {
+        const controller = getController();
+        if (!controller || typeof controller.mode !== "string") {
+            return null;
+        }
+        return controller.mode;
+    };
+    const resolveActiveProvider = () => {
+        const controller = getController();
+        if (!controller || typeof controller.provider !== "string") {
+            return null;
+        }
+        return controller.provider;
+    };
+    const stop = () => {
+        const controller = getController();
+        if (!controller) {
+            return false;
+        }
+        const providerId = typeof controller.provider === "string" ? controller.provider : "";
+        const provider = providerId ? registry.get(providerId) : null;
+        if (provider?.stop) {
+            provider.stop(controller);
+        }
+        else {
+            controller.stop?.();
+        }
+        setController(null);
+        return true;
+    };
+    const checkAvailability = async (providerId) => {
+        const provider = registry.get(providerId);
+        if (!provider) {
+            throw new TunnelServiceError("provider_unsupported", `Unsupported tunnel provider: ${providerId}`);
+        }
+        const result = await provider.checkAvailability();
+        return result;
+    };
+    // Mutex to prevent concurrent tunnel starts from orphaning child processes.
+    let startLock = Promise.resolve();
+    const start = async (rawRequest, options = {}) => {
+        let releaseLock;
+        const lockPromise = new Promise((resolve) => { releaseLock = resolve; });
+        const previousLock = startLock;
+        startLock = lockPromise;
+        await previousLock;
+        try {
+            const request = normalizeTunnelStartRequest(rawRequest);
+            const provider = registry.get(request.provider);
+            if (!provider) {
+                throw new TunnelServiceError("provider_unsupported", `Unsupported tunnel provider: ${request.provider}`);
+            }
+            validateTunnelStartRequest(request, provider.capabilities);
+            let publicUrl = getController() ? provider.resolvePublicUrl(getController()) : null;
+            const activeMode = resolveActiveMode();
+            const activeProvider = resolveActiveProvider();
+            if (publicUrl && (activeMode !== request.mode || activeProvider !== request.provider)) {
+                stop();
+                publicUrl = null;
+            }
+            if (!publicUrl) {
+                const availability = await provider.checkAvailability();
+                if (!availability?.available) {
+                    const missingDependencyMessage = typeof availability?.message === "string" && availability.message.trim().length > 0
+                        ? availability.message
+                        : `Required dependency for provider '${request.provider}' is missing`;
+                    throw new TunnelServiceError("missing_dependency", missingDependencyMessage);
+                }
+                const activePort = Number.isFinite(getActivePort?.()) ? getActivePort() : null;
+                const originUrl = activePort !== null ? `http://127.0.0.1:${activePort}` : undefined;
+                let controller;
+                try {
+                    controller = await provider.start(request, {
+                        activePort,
+                        originUrl,
+                        ...options,
+                    });
+                }
+                catch (error) {
+                    if (error instanceof TunnelServiceError) {
+                        throw error;
+                    }
+                    const message = error instanceof Error && error.message.trim().length > 0
+                        ? error.message
+                        : "Failed to start tunnel";
+                    throw new TunnelServiceError("startup_failed", message);
+                }
+                controller.provider = request.provider;
+                setController(controller);
+                publicUrl = provider.resolvePublicUrl(controller);
+                if (!publicUrl) {
+                    stop();
+                    throw new TunnelServiceError("startup_failed", "Tunnel started but no public URL was assigned");
+                }
+                if (request.mode === TUNNEL_MODE_QUICK) {
+                    onQuickTunnelWarning();
+                }
+            }
+            return {
+                publicUrl,
+                request,
+                activeMode: request.mode,
+                provider: request.provider,
+                providerMetadata: provider.getMetadata?.(getController()) ?? null,
+            };
+        }
+        finally {
+            releaseLock?.();
+        }
+    };
+    const getPublicUrl = () => {
+        const controller = getController();
+        if (!controller) {
+            return null;
+        }
+        const provider = registry.get(controller.provider);
+        if (!provider) {
+            return controller.getPublicUrl?.() ?? null;
+        }
+        return provider.resolvePublicUrl(controller);
+    };
+    const getProviderMetadata = () => {
+        const controller = getController();
+        if (!controller) {
+            return null;
+        }
+        const provider = registry.get(controller.provider);
+        return provider?.getMetadata?.(controller) ?? null;
+    };
+    return {
+        start,
+        stop,
+        checkAvailability,
+        getPublicUrl,
+        getProviderMetadata,
+        resolveActiveMode,
+        resolveActiveProvider,
+    };
+}
+//# sourceMappingURL=service.js.map

package/server/tunnel/service.js.map

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

package/server/tunnel/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Tunnel module types — constants, error class, normalizers, validators,
+ * and the provider interface contract.
+ */
+export declare const TUNNEL_PROVIDER_CLOUDFLARE: "cloudflare";
+export declare const TUNNEL_PROVIDER_NGROK: "ngrok";
+export type TunnelProviderId = typeof TUNNEL_PROVIDER_CLOUDFLARE | typeof TUNNEL_PROVIDER_NGROK | (string & {});
+export declare const TUNNEL_MODE_QUICK: "quick";
+export declare const TUNNEL_MODE_MANAGED_REMOTE: "managed-remote";
+export declare const TUNNEL_MODE_MANAGED_LOCAL: "managed-local";
+export type TunnelMode = typeof TUNNEL_MODE_QUICK | typeof TUNNEL_MODE_MANAGED_REMOTE | typeof TUNNEL_MODE_MANAGED_LOCAL;
+export declare const TUNNEL_INTENT_EPHEMERAL_PUBLIC: "ephemeral-public";
+export declare const TUNNEL_INTENT_PERSISTENT_PUBLIC: "persistent-public";
+export declare const TUNNEL_INTENT_PRIVATE_NETWORK: "private-network";
+export type TunnelIntent = typeof TUNNEL_INTENT_EPHEMERAL_PUBLIC | typeof TUNNEL_INTENT_PERSISTENT_PUBLIC | typeof TUNNEL_INTENT_PRIVATE_NETWORK;
+export declare class TunnelServiceError extends Error {
+    readonly code: string;
+    readonly details: unknown;
+    constructor(code: string, message: string, details?: unknown);
+}
+export interface TunnelModeDescriptor {
+    key: string;
+    label: string;
+    intent: string;
+    requires: string[];
+    supports: string[];
+    stability: string;
+}
+export interface TunnelProviderCapabilities {
+    provider: string;
+    defaults: {
+        mode: string;
+        optionDefaults: Record<string, unknown>;
+    };
+    modes: TunnelModeDescriptor[];
+}
+export interface TunnelAvailability {
+    available: boolean;
+    path: string | null;
+    version: string | null;
+    dependency?: string;
+    installCommand?: string;
+    installUrl?: string;
+    platform?: string;
+    message?: string;
+}
+export interface TunnelStartRequest {
+    provider: string;
+    mode: string;
+    intent?: string;
+    configPath?: string | null;
+    token?: string;
+    hostname?: string;
+}
+export interface TunnelContext {
+    activePort?: number | null;
+    originUrl?: string;
+}
+export interface TunnelController {
+    /** Set by the provider on start(). */
+    mode: string;
+    /** Set by the service after start(). */
+    provider: string;
+    /** Kill the tunnel process. */
+    stop(): void;
+    /** Resolve the public URL from internal state. */
+    getPublicUrl(): string | null;
+    /** The underlying child process, if any. */
+    process?: import("node:child_process").ChildProcess;
+    /** Resolve the effective config path (cloudflare managed-local). */
+    getEffectiveConfigPath?(): string | null;
+    /** Resolve the resolved hostname (cloudflare managed-local). */
+    getResolvedHostname?(): string | null;
+}
+export interface TunnelCheck {
+    id: string;
+    label: string;
+    status: "pass" | "fail" | "warn";
+    detail: string;
+}
+export interface TunnelModeDiagnosis {
+    mode: string;
+    checks: TunnelCheck[];
+    summary: {
+        ready: boolean;
+        failures: number;
+        warnings: number;
+    };
+    ready: boolean;
+    blockers: string[];
+}
+export interface TunnelDiagnosis {
+    providerChecks: TunnelCheck[];
+    modes: TunnelModeDiagnosis[];
+}
+export interface DoctorRequest {
+    mode?: string | null;
+    hostname?: string;
+    token?: string;
+    tokenProvided?: boolean;
+    hostnameProvided?: boolean;
+    configPath?: string | null;
+    hasSavedManagedRemoteProfile?: boolean;
+}
+export interface TunnelProvider {
+    readonly id: string;
+    readonly capabilities: TunnelProviderCapabilities;
+    checkAvailability(): Promise<TunnelAvailability>;
+    diagnose?(request?: DoctorRequest, context?: {
+        capabilities: TunnelProviderCapabilities;
+    }): Promise<TunnelDiagnosis>;
+    start(request: TunnelStartRequest, context: TunnelContext): Promise<TunnelController>;
+    stop(controller: TunnelController): void;
+    resolvePublicUrl(controller: TunnelController): string | null;
+    getMetadata?(controller: TunnelController | null): Record<string, unknown> | null;
+}
+export interface TunnelStartResult {
+    publicUrl: string;
+    request: TunnelStartRequest;
+    activeMode: string;
+    provider: string;
+    providerMetadata: Record<string, unknown> | null;
+}
+export interface TunnelServiceDeps {
+    registry: TunnelProviderRegistry;
+    getController: () => TunnelController | null;
+    setController: (controller: TunnelController | null) => void;
+    getActivePort: () => number | null;
+    onQuickTunnelWarning: () => void;
+}
+export interface TunnelService {
+    start(rawRequest: Partial<TunnelStartRequest>, options?: Record<string, unknown>): Promise<TunnelStartResult>;
+    stop(): boolean;
+    checkAvailability(providerId: string): Promise<TunnelAvailability>;
+    getPublicUrl(): string | null;
+    getProviderMetadata(): Record<string, unknown> | null;
+    resolveActiveMode(): string | null;
+    resolveActiveProvider(): string | null;
+}
+export interface TunnelProviderRegistry {
+    register(provider: TunnelProvider): TunnelProvider;
+    get(providerId: string): TunnelProvider | null;
+    list(): TunnelProvider[];
+    listCapabilities(): TunnelProviderCapabilities[];
+    seal(): void;
+}
+export declare function isPathWithinDirectory(candidatePath: string, directoryPath: string, platform?: string): boolean;
+export declare function resolveTunnelConfigPath(value: string, home?: string, platform?: string): string;
+export declare function normalizeTunnelProvider(value: unknown): string;
+export declare function normalizeTunnelMode(value: unknown): string;
+export declare function normalizeOptionalPath(value: unknown): string | null | undefined;
+export declare function isSupportedTunnelMode(mode: string): boolean;
+export interface NormalizedTunnelStartRequest {
+    provider: string;
+    mode: string;
+    intent?: string;
+    configPath?: string | null;
+    token: string;
+    hostname: string;
+}
+export declare function normalizeTunnelStartRequest(input?: Record<string, unknown>, defaults?: Record<string, unknown>): NormalizedTunnelStartRequest;
+export declare function validateTunnelStartRequest(request: NormalizedTunnelStartRequest, capabilities: TunnelProviderCapabilities): void;
+//# sourceMappingURL=types.d.ts.map

package/server/tunnel/types.d.ts.map

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

package/server/tunnel/types.js

@@ -0,0 +1,214 @@
+/**
+ * Tunnel module types — constants, error class, normalizers, validators,
+ * and the provider interface contract.
+ */
+import path from "node:path";
+import os from "node:os";
+// ── Provider constants ────────────────────────────────────────────────────
+export const TUNNEL_PROVIDER_CLOUDFLARE = "cloudflare";
+export const TUNNEL_PROVIDER_NGROK = "ngrok";
+// ── Mode constants ────────────────────────────────────────────────────────
+export const TUNNEL_MODE_QUICK = "quick";
+export const TUNNEL_MODE_MANAGED_REMOTE = "managed-remote";
+export const TUNNEL_MODE_MANAGED_LOCAL = "managed-local";
+// ── Intent constants ──────────────────────────────────────────────────────
+export const TUNNEL_INTENT_EPHEMERAL_PUBLIC = "ephemeral-public";
+export const TUNNEL_INTENT_PERSISTENT_PUBLIC = "persistent-public";
+export const TUNNEL_INTENT_PRIVATE_NETWORK = "private-network";
+// ── Sets for validation ───────────────────────────────────────────────────
+const SUPPORTED_TUNNEL_PROVIDERS = new Set([
+    TUNNEL_PROVIDER_CLOUDFLARE,
+    TUNNEL_PROVIDER_NGROK,
+]);
+const SUPPORTED_TUNNEL_MODES = new Set([
+    TUNNEL_MODE_QUICK,
+    TUNNEL_MODE_MANAGED_REMOTE,
+    TUNNEL_MODE_MANAGED_LOCAL,
+]);
+const SUPPORTED_TUNNEL_INTENTS = new Set([
+    TUNNEL_INTENT_EPHEMERAL_PUBLIC,
+    TUNNEL_INTENT_PERSISTENT_PUBLIC,
+    TUNNEL_INTENT_PRIVATE_NETWORK,
+]);
+// ── Error class ───────────────────────────────────────────────────────────
+export class TunnelServiceError extends Error {
+    code;
+    details;
+    constructor(code, message, details = null) {
+        super(message);
+        this.name = "TunnelServiceError";
+        this.code = code;
+        this.details = details;
+    }
+}
+// ── Path helpers ──────────────────────────────────────────────────────────
+function getPathApiForPlatform(platform) {
+    return platform === "win32" ? path.win32 : path;
+}
+export function isPathWithinDirectory(candidatePath, directoryPath, platform = process.platform) {
+    if (typeof candidatePath !== "string" || typeof directoryPath !== "string") {
+        return false;
+    }
+    const pathApi = getPathApiForPlatform(platform);
+    const resolvedCandidate = pathApi.resolve(candidatePath);
+    const resolvedDirectory = pathApi.resolve(directoryPath);
+    const comparableCandidate = platform === "win32" ? resolvedCandidate.toLowerCase() : resolvedCandidate;
+    const comparableDirectory = platform === "win32" ? resolvedDirectory.toLowerCase() : resolvedDirectory;
+    const directoryPrefix = comparableDirectory.endsWith(pathApi.sep)
+        ? comparableDirectory
+        : `${comparableDirectory}${pathApi.sep}`;
+    return comparableCandidate === comparableDirectory || comparableCandidate.startsWith(directoryPrefix);
+}
+export function resolveTunnelConfigPath(value, home = os.homedir(), platform = process.platform) {
+    const pathApi = getPathApiForPlatform(platform);
+    let resolved;
+    if (value === "~") {
+        resolved = home;
+    }
+    else if (value.startsWith("~/") || value.startsWith("~\\")) {
+        resolved = pathApi.join(home, value.slice(2));
+    }
+    else {
+        resolved = pathApi.resolve(value);
+    }
+    if (!isPathWithinDirectory(resolved, home, platform)) {
+        throw new TunnelServiceError("validation_error", `Config path must be within the home directory (${home}). Got: ${resolved}`);
+    }
+    return resolved;
+}
+// ── Normalizers ───────────────────────────────────────────────────────────
+export function normalizeTunnelProvider(value) {
+    if (typeof value !== "string") {
+        return TUNNEL_PROVIDER_CLOUDFLARE;
+    }
+    const provider = value.trim().toLowerCase();
+    if (!provider || !SUPPORTED_TUNNEL_PROVIDERS.has(provider)) {
+        return TUNNEL_PROVIDER_CLOUDFLARE;
+    }
+    return provider;
+}
+export function normalizeTunnelMode(value) {
+    if (typeof value !== "string") {
+        return TUNNEL_MODE_QUICK;
+    }
+    const mode = value.trim().toLowerCase();
+    if (!mode) {
+        return TUNNEL_MODE_QUICK;
+    }
+    if (mode === TUNNEL_MODE_QUICK)
+        return TUNNEL_MODE_QUICK;
+    return TUNNEL_MODE_QUICK;
+}
+function normalizeTunnelIntent(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const intent = value.trim().toLowerCase();
+    if (!intent || !SUPPORTED_TUNNEL_INTENTS.has(intent)) {
+        return undefined;
+    }
+    return intent;
+}
+function modeIntentFallback(mode) {
+    if (mode === TUNNEL_MODE_QUICK)
+        return TUNNEL_INTENT_EPHEMERAL_PUBLIC;
+    return undefined;
+}
+function normalizeTunnelModeForRequest(value) {
+    if (typeof value === "string") {
+        const mode = value.trim().toLowerCase();
+        if (mode === TUNNEL_MODE_QUICK) {
+            return mode;
+        }
+    }
+    return TUNNEL_MODE_QUICK;
+}
+export function normalizeOptionalPath(value) {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return null;
+    }
+    return resolveTunnelConfigPath(trimmed);
+}
+export function isSupportedTunnelMode(mode) {
+    return SUPPORTED_TUNNEL_MODES.has(mode);
+}
+export function normalizeTunnelStartRequest(input = {}, defaults = {}) {
+    const provider = normalizeTunnelProvider(input.provider ?? defaults.provider);
+    const mode = normalizeTunnelModeForRequest(input.mode ?? defaults.mode);
+    const explicitIntent = normalizeTunnelIntent(input.intent ?? defaults.intent);
+    const intent = explicitIntent ?? modeIntentFallback(mode);
+    const configPathValue = Object.prototype.hasOwnProperty.call(input, "configPath")
+        ? input.configPath
+        : defaults.configPath;
+    const configPath = normalizeOptionalPath(configPathValue);
+    const rawToken = input.token ?? defaults.token;
+    const token = typeof rawToken === "string"
+        ? rawToken.trim()
+        : "";
+    const rawHostname = input.hostname ?? defaults.hostname;
+    const hostname = typeof rawHostname === "string"
+        ? rawHostname.trim().toLowerCase()
+        : "";
+    return {
+        provider,
+        mode,
+        intent,
+        configPath,
+        token,
+        hostname,
+    };
+}
+// ── Validator ─────────────────────────────────────────────────────────────
+export function validateTunnelStartRequest(request, capabilities) {
+    if (!request || typeof request !== "object") {
+        throw new TunnelServiceError("validation_error", "Tunnel start request must be an object");
+    }
+    if (!request.provider) {
+        throw new TunnelServiceError("validation_error", "Tunnel provider is required");
+    }
+    if (!isSupportedTunnelMode(request.mode)) {
+        throw new TunnelServiceError("mode_unsupported", `Unsupported tunnel mode: ${request.mode}`);
+    }
+    if (!capabilities || capabilities.provider !== request.provider) {
+        throw new TunnelServiceError("provider_unsupported", `Unsupported tunnel provider: ${request.provider}`);
+    }
+    if (!Array.isArray(capabilities.modes)) {
+        throw new TunnelServiceError("mode_unsupported", `Provider '${request.provider}' does not declare tunnel modes`);
+    }
+    const modeDescriptor = capabilities.modes.find((entry) => entry?.key === request.mode);
+    if (!modeDescriptor) {
+        throw new TunnelServiceError("mode_unsupported", `Provider '${request.provider}' does not support mode '${request.mode}'`);
+    }
+    if (typeof request.intent === "string" && request.intent.length > 0) {
+        if (!SUPPORTED_TUNNEL_INTENTS.has(request.intent)) {
+            throw new TunnelServiceError("validation_error", `Unsupported tunnel intent: ${request.intent}`);
+        }
+        if (modeDescriptor.intent !== request.intent) {
+            throw new TunnelServiceError("validation_error", `Tunnel intent '${request.intent}' does not match mode '${request.mode}' (expected '${modeDescriptor.intent}')`);
+        }
+    }
+    const requiredFields = Array.isArray(modeDescriptor.requires) ? modeDescriptor.requires : [];
+    if (requiredFields.includes("token")) {
+        if (!request.token) {
+            throw new TunnelServiceError("validation_error", "Managed remote tunnel token is required");
+        }
+    }
+    if (requiredFields.includes("hostname")) {
+        if (!request.hostname) {
+            throw new TunnelServiceError("validation_error", "Managed remote tunnel hostname is required");
+        }
+    }
+    if (requiredFields.includes("configPath")) {
+        if (request.configPath === undefined || request.configPath === null || request.configPath === "") {
+            throw new TunnelServiceError("validation_error", `Mode '${request.mode}' requires a configPath`);
+        }
+    }
+}
+//# sourceMappingURL=types.js.map

package/server/tunnel/types.js.map

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

package/server/ui-settings-store.d.ts

@@ -0,0 +1,25 @@
+export type UiSettings = {
+    version: 1;
+    theme?: string;
+    stickyUserHeader: boolean;
+    showTokenUsage: boolean;
+    compressImages: boolean;
+};
+export declare function createUiSettingsStore(): {
+    read: typeof read;
+    write: typeof write;
+    patch: typeof patch;
+    reset: typeof reset;
+};
+declare function read(): Promise<UiSettings>;
+declare function write(settings: UiSettings): Promise<UiSettings>;
+declare function patch(patch: Partial<UiSettings>): Promise<UiSettings>;
+declare function reset(): Promise<UiSettings>;
+export declare const uiSettings: {
+    read: typeof read;
+    write: typeof write;
+    patch: typeof patch;
+    reset: typeof reset;
+};
+export {};
+//# sourceMappingURL=ui-settings-store.d.ts.map

package/server/ui-settings-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-settings-store.d.ts","sourceRoot":"","sources":["../src/ui-settings-store.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAsCF,wBAAgB,qBAAqB;;;;;EAEpC;AAMD,iBAAe,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAYzC;AAED,iBAAe,KAAK,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ9D;AAED,iBAAe,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CASpE;AAED,iBAAe,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAQ1C;AAID,eAAO,MAAM,UAAU;;;;;CAAgC,CAAC"}