@hamedb89/localghost 0.5.0 → 0.6.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DevHostEntry, R as ReadDevHostsOptions, a as ResolvedDevHostsPath, b as ConstructGhostTunnelUrlInput, c as GhostTunnelTransportOptions, d as GhostTunnelTransportConfig, e as GhostTunnelRoute, f as GhostTunnelConfig, C as ConfigPattern, G as GhostTunnelOptions } from './tunnel-BA52DD9e.js';
-export { g as GhostTunnelAdapterOptions, h as GhostTunnelAdapterProvider, i as GhostTunnelAdapterStrategy, j as GhostTunnelAdapterTransport, k as GhostTunnelDisplayDefaults, l as GhostTunnelDomainOptions, m as GhostTunnelMode, n as GhostTunnelNamespaceConfig, o as GhostTunnelNamespaceOptions, p as GhostTunnelNamespaceTag, q as GhostTunnelNamespaceValues, r as GhostTunnelPreviewOptions, s as GhostTunnelTransportKind, t as GhostTunnelTunnelStoreEnv, u as GhostTunnelTunnelStoreOptions, v as GhostTunnelTunnelStoreProvider, L as LOCALGHOST_CONFIG_FILE, w as assertSecureGhostTunnelRequest, x as constructGhostTunnelHost, y as constructGhostTunnelURL, z as constructGhostTunnelUrl, A as findLocalMdnsHosts, B as getConfigFileCandidates, E as getDevHostsPath, F as getGhostTunnelDefaultDisplayUrl, H as getGhostTunnelDisplayUrl, I as getGhostTunnelDisplayUrls, J as getGhostTunnelEntryHost, K as getGhostTunnelPreviewUrl, M as getGhostTunnelWildcardHost, N as getProjectName, O as parseDevHosts, P as parseGhostTunnelHost, Q as readDevHosts, S as resolveDevHostsPath, T as resolveGhostTunnelConfig, U as sanitizeProjectName } from './tunnel-BA52DD9e.js';
+import { D as DevHostEntry$1, a as ConstructGhostTunnelUrlInput, b as GhostTunnelTransportOptions, c as GhostTunnelTransportConfig, G as GhostTunnelOptions, d as GhostTunnelConfig, e as GhostTunnelRoute, R as ReadDevHostsOptions$1, C as ConfigPattern } from './tunnel-DHYPpsX2.js';
+export { f as GhostTunnelAdapterOptions, g as GhostTunnelAdapterProvider, h as GhostTunnelAdapterStrategy, i as GhostTunnelAdapterTransport, j as GhostTunnelDisplayDefaults, k as GhostTunnelDomainOptions, l as GhostTunnelMode, m as GhostTunnelNamespaceConfig, n as GhostTunnelNamespaceOptions, o as GhostTunnelNamespaceTag, p as GhostTunnelNamespaceValues, q as GhostTunnelPreviewOptions, r as GhostTunnelTransportKind, s as GhostTunnelTunnelStoreEnv, t as GhostTunnelTunnelStoreOptions, u as GhostTunnelTunnelStoreProvider, L as LOCALGHOST_CONFIG_FILE, v as ResolvedDevHostsPath, w as assertSecureGhostTunnelRequest, x as constructGhostTunnelHost, y as constructGhostTunnelURL, z as constructGhostTunnelUrl, A as findLocalMdnsHosts, B as getConfigFileCandidates, E as getDevHostsPath, F as getGhostTunnelDefaultDisplayUrl, H as getGhostTunnelDisplayUrl, I as getGhostTunnelDisplayUrls, J as getGhostTunnelEntryHost, K as getGhostTunnelPreviewUrl, M as getGhostTunnelWildcardHost, N as getProjectName, O as parseDevHosts, P as parseGhostTunnelHost, Q as readDevHosts, S as resolveDevHostsPath, T as resolveGhostTunnelConfig, U as sanitizeProjectName } from './tunnel-DHYPpsX2.js';
 import * as execa from 'execa';
 import { ChildProcess } from 'node:child_process';
 
@@ -23,7 +23,7 @@ type LocalghostRunRecord = {
     requestedPort?: number;
     port?: number;
     dynamicPort?: boolean;
-    entries: DevHostEntry[];
+    entries: DevHostEntry$1[];
 };
 type LocalghostSetupRecord = {
     id: string;
@@ -33,7 +33,7 @@ type LocalghostSetupRecord = {
     configPath?: string;
     caddyfilePath?: string;
     https?: boolean;
-    entries: DevHostEntry[];
+    entries: DevHostEntry$1[];
 };
 type LocalghostActivity = {
     version: typeof LOCALGHOST_ACTIVITY_VERSION;
@@ -75,14 +75,6 @@ declare function renderCompactLocalghostBanner(): string;
 declare const LOCALGHOST_AGENT_GUIDE = "# Localghost agent guide\n\nLocalghost owns the local development proxy and the app process boundary.\n\n## Preferred repository setup\n\nFor a normal repository with Localghost installed as a dev dependency, use this package script:\n\n    \"dev\": \"localghost\"\n\nIf the repository does not have a local CLI yet, use the package-manager launcher:\n\n    npm exec --yes --package=@hamedb89/localghost -- localghost\n    pnpm dlx @hamedb89/localghost\n    yarn dlx @hamedb89/localghost\n    bunx --package @hamedb89/localghost localghost\n\nFor an explicit app command, keep the raw command separate:\n\n    \"dev\": \"localghost run -- vite\"\n    \"dev:raw\": \"vite\"\n\nUse `localghost dev` only when the Caddy proxy should run without starting the app.\n\n## Useful commands\n\n- `localghost`: detect and run the repository development command.\n- `localghost run -- <command>`: wrap an explicit app command.\n- `localghost dev`: run only the local Caddy proxy.\n- `localghost status --ready`: check project setup.\n- `localghost repair`: repair managed hosts and Caddy setup.\n- `localghost ps --json`: inspect Localghost-managed repositories, instances, and ports.\n- `localghost routes`: inspect hostname-to-port routing.\n- `localghost doctor`: check machine prerequisites, ports, and registry state.\n- `localghost repair --reallocate-port`: move an occupied project port to a stable available port.\n\n- `localghost update`: check npm for a newer Localghost release.\n- `localghost upgrade`: install or update Localghost as a repository dev dependency.\n\nUse `localghost` directly when the package is installed locally. Use `npm exec --yes --package=@hamedb89/localghost -- localghost <command>`, `pnpm dlx @hamedb89/localghost <command>`, `yarn dlx @hamedb89/localghost <command>`, or `bunx --package @hamedb89/localghost localghost <command>` when it is not.\n\n## Configuration\n\n- Commit repository defaults in `localghost.config.mjs`.\n- Keep hostname and requested-port routes in `.localghost`.\n- CLI flags override repository configuration for one invocation.\n- Localghost remembers active project and instance port assignments in user state under `~/.localghost`.\n- Do not edit the registry manually and do not start Caddy separately.\n\n## Port behavior\n\nLocalghost remembers ports by canonical repository path and instance key. Concurrent Localghost instances receive distinct ports. The operating-system bind check remains authoritative when another tool already owns a port.\n";
 declare function formatLocalghostAgentGuide(format?: "text" | "json"): string;
 
-declare const LOCALGHOST_GHOST_TUNNEL_FILE = ".ghosttunnel";
-type ReadGhostTunnelOptions = ReadDevHostsOptions;
-declare function resolveGhostTunnelPath(options?: ReadGhostTunnelOptions | string): ResolvedDevHostsPath;
-declare function getGhostTunnelPath(options?: ReadGhostTunnelOptions | string): string;
-declare function readGhostTunnelEntries(options?: ReadGhostTunnelOptions | string): DevHostEntry[];
-declare function listGhostTunnelEntries(options?: ReadGhostTunnelOptions | string): DevHostEntry[];
-declare function findGhostTunnelEntry(host: string, options?: ReadGhostTunnelOptions | string): DevHostEntry | undefined;
-
 type RelayProtocol = "http" | "https";
 type RelayAccessMode = "private" | "public";
 type RelayLocalTarget = {
@@ -169,6 +161,80 @@ declare function redactRelayHeaders(headers: Record<string, string | string[] |
 declare function redactRelayLogUrl(input: string): string;
 declare function renderRelayOfflineResponse(): RelayOfflineResponse;
 
+type DevHostEntry = {
+    host: string;
+    port: number;
+    target: string;
+};
+declare const LOCALGHOST_GHOST_TUNNEL_FILE = ".ghosttunnel";
+type ReadGhostTunnelOptions = ReadDevHostsOptions;
+type ReadDevHostsOptions = {
+    cwd?: string;
+    fileName?: string;
+    configFiles?: string[];
+    configPattern?: string | RegExp;
+};
+declare function resolveGhostTunnelPath(options?: ReadGhostTunnelOptions | string): {
+    path: string;
+    fileName: string;
+    exists: boolean;
+    searchedFiles: string[];
+};
+declare function getGhostTunnelPath(options?: ReadGhostTunnelOptions | string): string;
+declare function readGhostTunnelEntries(options?: ReadGhostTunnelOptions | string): DevHostEntry[];
+declare function listGhostTunnelEntries(options?: ReadGhostTunnelOptions | string): DevHostEntry[];
+declare function findGhostTunnelEntry(host: string, options?: ReadGhostTunnelOptions | string): DevHostEntry | undefined;
+
+declare const DEFAULT_GHOST_TUNNEL_TRANSPORT_QUERY_PARAM = "__localghost";
+declare const DEFAULT_GHOST_TUNNEL_IP_TRANSPORT_TTL_SECONDS: number;
+type GhostTunnelIpTransportClaim = {
+    kind: "ip";
+    host: string;
+    address: string;
+    protocol: RelayProtocol;
+    expiresAt: string;
+};
+type SignedGhostTunnelIpTransportClaim = {
+    payload: GhostTunnelIpTransportClaim;
+    token: string;
+};
+type ConstructGhostTunnelIpUrlInput = ({
+    url: string;
+} | ConstructGhostTunnelUrlInput) & {
+    address: string;
+    signingSecret: string;
+    expiresAt?: string;
+    ttlSeconds?: number;
+    queryParam?: string;
+    targetProtocol?: RelayProtocol;
+    allowPrivateNetworkAddress?: boolean;
+};
+type ResolveGhostTunnelIpRedirectInput = {
+    requestUrl: string;
+    host: string;
+    entryPort: number;
+    signingSecret: string;
+    transport?: GhostTunnelTransportOptions | GhostTunnelTransportConfig;
+    queryParam?: string;
+    now?: Date;
+};
+type ResolvedGhostTunnelIpRedirect = {
+    claim: GhostTunnelIpTransportClaim;
+    queryParam: string;
+    target: Required<RelayLocalTarget>;
+    url: string;
+};
+declare function signGhostTunnelIpTransportClaim(claim: GhostTunnelIpTransportClaim, signingSecret: string, options?: {
+    allowPrivateNetworkAddress?: boolean;
+}): SignedGhostTunnelIpTransportClaim;
+declare function verifyGhostTunnelIpTransportClaim(token: string, signingSecret: string, options: {
+    host: string;
+    allowPrivateNetworkAddress?: boolean;
+    now?: Date;
+}): GhostTunnelIpTransportClaim;
+declare function constructGhostTunnelIpUrl(input: ConstructGhostTunnelIpUrlInput): string;
+declare function resolveGhostTunnelIpRedirect(input: ResolveGhostTunnelIpRedirectInput): ResolvedGhostTunnelIpRedirect;
+
 declare const DEFAULT_GHOST_TUNNEL_RESPONSE_TTL_SECONDS = 60;
 type GhostTunnelStoreEnv = Record<string, string | undefined>;
 type GhostTunnelQueuedRequest = {
@@ -270,55 +336,59 @@ type ServeGhostTunnelLocalRequestInput = {
 declare function serveGhostTunnelLocalRequest(input: ServeGhostTunnelLocalRequestInput): Promise<GhostTunnelQueuedResponse>;
 declare function startGhostTunnelAgent(options: GhostTunnelAgentOptions): GhostTunnelAgent;
 
-declare const DEFAULT_GHOST_TUNNEL_TRANSPORT_QUERY_PARAM = "__localghost";
-declare const DEFAULT_GHOST_TUNNEL_IP_TRANSPORT_TTL_SECONDS: number;
-type GhostTunnelIpTransportClaim = {
-    kind: "ip";
+type ResolveGhostTunnelRequestInput$1 = {
+    cwd?: string;
     host: string;
-    address: string;
-    protocol: RelayProtocol;
-    expiresAt: string;
+    domain: string;
+    protocol: "http" | "https";
+    authenticated?: boolean;
+    ghostTunnel?: GhostTunnelOptions | GhostTunnelConfig;
+    resolveGhostTunnel?: (input: {
+        domain: string;
+        cwd?: string;
+    }) => GhostTunnelOptions | GhostTunnelConfig | Promise<GhostTunnelOptions | GhostTunnelConfig>;
+    ghostTunnelFile?: string;
 };
-type SignedGhostTunnelIpTransportClaim = {
-    payload: GhostTunnelIpTransportClaim;
-    token: string;
+type ResolvedGhostTunnelRequest = {
+    route: GhostTunnelRoute;
+    ghostTunnel: GhostTunnelConfig;
+    entry?: DevHostEntry;
+    target?: Required<RelayLocalTarget>;
+    ghostTunnelPath?: string;
 };
-type ConstructGhostTunnelIpUrlInput = ({
-    url: string;
-} | ConstructGhostTunnelUrlInput) & {
-    address: string;
-    signingSecret: string;
-    expiresAt?: string;
-    ttlSeconds?: number;
-    queryParam?: string;
-    targetProtocol?: RelayProtocol;
-    allowPrivateNetworkAddress?: boolean;
+type GhostTunnelHttpResponse = {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
 };
-type ResolveGhostTunnelIpRedirectInput = {
-    requestUrl: string;
-    host: string;
-    entryPort: number;
-    signingSecret: string;
-    transport?: GhostTunnelTransportOptions | GhostTunnelTransportConfig;
-    queryParam?: string;
-    now?: Date;
+declare function renderGhostTunnelRouteMissingResponse(resolved: Pick<ResolvedGhostTunnelRequest, "route">): GhostTunnelHttpResponse;
+declare function renderGhostTunnelRelayOfflineResponse(resolved: Pick<ResolvedGhostTunnelRequest, "route"> & Partial<Pick<ResolvedGhostTunnelRequest, "entry">>): GhostTunnelHttpResponse;
+
+type VercelGhostTunnelRequestLike = {
+    headers: Record<string, string | string[] | undefined>;
+    url?: string;
+    method?: string;
+    [Symbol.asyncIterator]?: () => AsyncIterator<Buffer | Uint8Array | string>;
 };
-type ResolvedGhostTunnelIpRedirect = {
-    claim: GhostTunnelIpTransportClaim;
-    queryParam: string;
-    target: Required<RelayLocalTarget>;
-    url: string;
+type VercelGhostTunnelResponseLike = {
+    setHeader(name: string, value: string): void;
+    end(body: string): void;
+    statusCode: number;
+};
+type CreateVercelGhostTunnelHandlerOptions$1 = {
+    cwd?: string;
+    domain: string;
+    ghostTunnel?: GhostTunnelOptions | GhostTunnelConfig;
+    resolveGhostTunnel?: (input: {
+        domain: string;
+        cwd?: string;
+    }) => GhostTunnelOptions | GhostTunnelConfig | Promise<GhostTunnelOptions | GhostTunnelConfig>;
+    ghostTunnelFile?: string;
+    ipSigningSecret?: string;
+    tunnelStore?: GhostTunnelStore;
+    tunnelEnv?: GhostTunnelStoreEnv;
+    authenticated?: boolean | ((request: VercelGhostTunnelRequestLike) => boolean | Promise<boolean>);
 };
-declare function signGhostTunnelIpTransportClaim(claim: GhostTunnelIpTransportClaim, signingSecret: string, options?: {
-    allowPrivateNetworkAddress?: boolean;
-}): SignedGhostTunnelIpTransportClaim;
-declare function verifyGhostTunnelIpTransportClaim(token: string, signingSecret: string, options: {
-    host: string;
-    allowPrivateNetworkAddress?: boolean;
-    now?: Date;
-}): GhostTunnelIpTransportClaim;
-declare function constructGhostTunnelIpUrl(input: ConstructGhostTunnelIpUrlInput): string;
-declare function resolveGhostTunnelIpRedirect(input: ResolveGhostTunnelIpRedirectInput): ResolvedGhostTunnelIpRedirect;
 
 type CaddyModeOptions = {
     https?: boolean;
@@ -333,8 +403,8 @@ type CaddyProcessStopResult = {
 };
 type CaddyProcessKiller = (pid: number, signal: NodeJS.Signals) => void;
 declare function getCaddyfilePath(cwd?: string): string;
-declare function renderCaddyfile(entries: DevHostEntry[], options?: CaddyModeOptions): string;
-declare function writeCaddyfile(entries: DevHostEntry[], cwd?: string, options?: CaddyModeOptions): Promise<string>;
+declare function renderCaddyfile(entries: DevHostEntry$1[], options?: CaddyModeOptions): string;
+declare function writeCaddyfile(entries: DevHostEntry$1[], cwd?: string, options?: CaddyModeOptions): Promise<string>;
 declare function validateCaddyfile(path: string): Promise<void>;
 declare function runCaddy(path: string): Promise<void>;
 declare function startCaddy(path: string): execa.ResultPromise<{
@@ -345,31 +415,14 @@ declare function startCaddy(path: string): execa.ResultPromise<{
 declare function stopCaddyProcesses(pids: Iterable<number>, killProcess?: CaddyProcessKiller): CaddyProcessStopResult;
 declare function trustCaddy(path: string): Promise<void>;
 
-type ResolveGhostTunnelRequestInput = {
-    cwd?: string;
-    host: string;
-    domain: string;
-    protocol: "http" | "https";
-    authenticated?: boolean;
+type ResolveGhostTunnelRequestInput = Omit<ResolveGhostTunnelRequestInput$1, "ghostTunnel" | "resolveGhostTunnel"> & {
     localghostConfig?: string | false;
-    ghostTunnelFile?: string;
 };
-type ResolvedGhostTunnelRequest = {
-    route: GhostTunnelRoute;
-    ghostTunnel: GhostTunnelConfig;
-    entry?: DevHostEntry;
-    target?: Required<RelayLocalTarget>;
+type ResolvedLocalghostTunnelRequest = ResolvedGhostTunnelRequest & {
     projectConfigPath?: string;
-    ghostTunnelPath?: string;
-};
-type GhostTunnelHttpResponse = {
-    status: number;
-    headers: Record<string, string>;
-    body: string;
 };
-declare function resolveGhostTunnelRequest(input: ResolveGhostTunnelRequestInput): Promise<ResolvedGhostTunnelRequest>;
-declare function renderGhostTunnelRouteMissingResponse(resolved: Pick<ResolvedGhostTunnelRequest, "route">): GhostTunnelHttpResponse;
-declare function renderGhostTunnelRelayOfflineResponse(resolved: Pick<ResolvedGhostTunnelRequest, "route"> & Partial<Pick<ResolvedGhostTunnelRequest, "entry">>): GhostTunnelHttpResponse;
+
+declare function resolveGhostTunnelRequest(input: ResolveGhostTunnelRequestInput): Promise<ResolvedLocalghostTunnelRequest>;
 
 type LocalghostPackageManager = "npm" | "pnpm" | "yarn" | "bun";
 type DetectedDevCommand = {
@@ -431,11 +484,11 @@ type LocalghostContextOptions = {
 type LocalghostContext = {
     cwd: string;
     projectName: string;
-    readOptions: ReadDevHostsOptions;
+    readOptions: ReadDevHostsOptions$1;
     configPath: string;
     configFileName: string;
-    configEntries: DevHostEntry[];
-    entries: DevHostEntry[];
+    configEntries: DevHostEntry$1[];
+    entries: DevHostEntry$1[];
     hosts: string[];
     requestedPort: number;
     port: number;
@@ -512,10 +565,10 @@ type RemoveSystemHostsResult = UpdateSystemHostsResult & {
     removed: boolean;
 };
 declare function getSystemHostsPath(env?: NodeJS.ProcessEnv): string;
-declare function renderHostsBlock(projectName: string, entries: DevHostEntry[]): string;
+declare function renderHostsBlock(projectName: string, entries: DevHostEntry$1[]): string;
 declare function upsertManagedBlock(existing: string, projectName: string, block: string): string;
 declare function removeManagedBlock(existing: string, projectName: string): string;
-declare function updateSystemHosts(projectName: string, entries: DevHostEntry[]): Promise<UpdateSystemHostsResult>;
+declare function updateSystemHosts(projectName: string, entries: DevHostEntry$1[]): Promise<UpdateSystemHostsResult>;
 declare function removeSystemHosts(projectName: string): Promise<RemoveSystemHostsResult>;
 
 type PackageManager = "npm" | "yarn" | "pnpm" | "bun";
@@ -607,6 +660,11 @@ type LocalghostRegistry = {
     prune(): Promise<{
         removedLeases: number;
     }>;
+    pruneTestSessions(): Promise<{
+        removedLeases: number;
+        removedAllocations: number;
+    }>;
+    reset(): Promise<void>;
 };
 declare function getLocalghostRegistryRoot(env?: NodeJS.ProcessEnv): string;
 declare function canonicalizeLocalghostProjectCwd(cwd?: string): string;
@@ -658,8 +716,8 @@ type GhostTunnelFormatOptions = {
     label?: "configured" | "expected" | "ready" | "running";
     verbose?: boolean;
 };
-declare function getDomainRoutes(entries: DevHostEntry[], options?: DomainRouteOptions): DomainRoute[];
-declare function formatDomainRoutes(entries: DevHostEntry[], options?: DomainRouteOptions): string;
+declare function getDomainRoutes(entries: DevHostEntry$1[], options?: DomainRouteOptions): DomainRoute[];
+declare function formatDomainRoutes(entries: DevHostEntry$1[], options?: DomainRouteOptions): string;
 declare function formatGhostTunnel(config: GhostTunnelConfig, options?: GhostTunnelFormatOptions): string | null;
 
 declare const LOCALGHOST_STATE_FILE = "ops/local/localghost-state.json";
@@ -679,7 +737,7 @@ type LocalghostState = {
     caddyHttps?: boolean;
     caddyTrustedAt?: string;
     caddyTrustPromptedAt?: string;
-    entries?: DevHostEntry[];
+    entries?: DevHostEntry$1[];
 };
 type WriteLocalghostStateInput = Omit<LocalghostState, "version" | "updatedAt">;
 declare function getLocalghostStatePath(cwd?: string): string;
@@ -687,31 +745,13 @@ declare function readLocalghostState(cwd?: string): LocalghostState | null;
 declare function writeLocalghostState(cwd: string, state: WriteLocalghostStateInput): string;
 declare function patchLocalghostState(cwd: string, patch: Partial<WriteLocalghostStateInput>): string | null;
 
-type VercelGhostTunnelRequestLike = {
-    headers: Record<string, string | string[] | undefined>;
-    url?: string;
-    method?: string;
-    [Symbol.asyncIterator]?: () => AsyncIterator<Buffer | Uint8Array | string>;
-};
-type VercelGhostTunnelResponseLike = {
-    setHeader(name: string, value: string): void;
-    end(body: string): void;
-    statusCode: number;
-};
-type CreateVercelGhostTunnelHandlerOptions = {
-    cwd?: string;
-    domain: string;
+type CreateVercelGhostTunnelHandlerOptions = Omit<CreateVercelGhostTunnelHandlerOptions$1, "resolveGhostTunnel"> & {
     localghostConfig?: string | false;
-    ghostTunnelFile?: string;
-    ipSigningSecret?: string;
-    tunnelStore?: GhostTunnelStore;
-    tunnelEnv?: GhostTunnelStoreEnv;
-    authenticated?: boolean | ((request: VercelGhostTunnelRequestLike) => boolean | Promise<boolean>);
 };
 declare function createVercelGhostTunnelHandler(options: CreateVercelGhostTunnelHandlerOptions): (request: VercelGhostTunnelRequestLike, response: VercelGhostTunnelResponseLike) => Promise<void>;
 
 declare const LOCALGHOST_PACKAGE_NAME = "@hamedb89/localghost";
-declare const LOCALGHOST_VERSION = "0.5.0";
+declare const LOCALGHOST_VERSION = "0.6.2";
 declare const UPDATE_CHECK_CACHE_TTL_MS: number;
 declare const UPDATE_CHECK_NOTIFY_TTL_MS: number;
 declare const UPDATE_CHECK_TIMEOUT_MS = 900;
@@ -748,4 +788,4 @@ declare function maybeNotifyAboutUpdate(options?: {
     disabled?: boolean;
 }): Promise<void>;
 
-export { type AcquireLocalghostPortOptions, type ActiveRelayRoute, type CaddyModeOptions, type CaddyProcessKiller, type CaddyProcessStopResult, ConfigPattern, type ConstructGhostTunnelIpUrlInput, ConstructGhostTunnelUrlInput, type CreateVercelGhostTunnelHandlerOptions, DEFAULT_GHOST_TUNNEL_IP_TRANSPORT_TTL_SECONDS, DEFAULT_GHOST_TUNNEL_RESPONSE_TTL_SECONDS, DEFAULT_GHOST_TUNNEL_TRANSPORT_QUERY_PARAM, DEFAULT_RELAY_ALLOWED_TARGET_HOSTS, DEFAULT_RELAY_BLOCKED_PORTS, DEFAULT_RELAY_LIMITS, DEFAULT_RELAY_TARGET_POLICY, type DetectedDevCommand, type DetectedDevService, DevHostEntry, type DoctorOptions, type DoctorResult, type DomainRoute, type DomainRouteOptions, type FindAvailablePortOptions, type GhostTunnelAgent, type GhostTunnelAgentOptions, GhostTunnelConfig, type GhostTunnelHttpResponse, type GhostTunnelIpTransportClaim, GhostTunnelOptions, type GhostTunnelQueuedRequest, type GhostTunnelQueuedResponse, GhostTunnelRoute, type GhostTunnelRouteHeartbeat, type GhostTunnelStore, type GhostTunnelStoreEnv, GhostTunnelTransportConfig, GhostTunnelTransportOptions, type InitOptions, type InitResult, LOCALGHOST_ACTIVITY_VERSION, LOCALGHOST_AGENT_GUIDE, LOCALGHOST_GHOST_TUNNEL_FILE, LOCALGHOST_PACKAGE_NAME, LOCALGHOST_REGISTRY_FILE, LOCALGHOST_REGISTRY_LOCK_FILE, LOCALGHOST_STATE_FILE, LOCALGHOST_VERSION, type LocalghostActivity, type LocalghostContext, type LocalghostContextOptions, type LocalghostEnvironment, type LocalghostLease, type LocalghostPackageManager, type LocalghostProjectConfig, type LocalghostProjectConfigResult, type LocalghostRegistry, type LocalghostRegistryData, type LocalghostRegistryEntry, type LocalghostRegistryOptions, type LocalghostRunMode, type LocalghostRunRecord, type LocalghostServiceOptions, type LocalghostSetupRecord, type LocalghostState, type LocalghostStateAction, type LocalghostTestSession, type LocalghostTestSessionOptions, type PackageManager, type PortAvailabilityCheck, ReadDevHostsOptions, type ReadGhostTunnelOptions, type RedisGhostTunnelEnvResolution, type RedisGhostTunnelStoreOptions, type RegisterLocalghostRunInput, type RegisterLocalghostSetupInput, type RelayAccessMode, type RelayLimits, type RelayLocalTarget, type RelayOfflineResponse, type RelayProtocol, type RelayRouteClaim, type RelayRouteRegistrationInput, type RelayTargetPolicy, type RemoveSystemHostsResult, type ResolveGhostTunnelIpRedirectInput, type ResolveGhostTunnelRequestInput, ResolvedDevHostsPath, type ResolvedGhostTunnelIpRedirect, type ResolvedGhostTunnelRequest, type ServeGhostTunnelLocalRequestInput, type SignedGhostTunnelIpTransportClaim, type SignedRelayRouteClaim, UPDATE_CHECK_CACHE_TTL_MS, UPDATE_CHECK_NOTIFY_TTL_MS, UPDATE_CHECK_TIMEOUT_MS, type UpdateCheckCache, type UpdateCheckResult, type UpdateSystemHostsResult, type VercelGhostTunnelRequestLike, type VercelGhostTunnelResponseLike, type WriteLocalghostStateInput, assertExactRelayHost, assertLocalDevelopment, assertRelayLocalTarget, authenticateRelayAgentToken, canonicalizeLocalghostProjectCwd, checkCaddy, checkForUpdate, compareVersions, constructGhostTunnelIpUrl, createGhostTunnelQueuedRequest, createGhostTunnelRouteHeartbeat, createLocalghostRegistry, createLocalghostTestSession, createMemoryGhostTunnelStore, createRedisGhostTunnelStore, createRedisGhostTunnelStoreFromEnv, createRelayRouteRegistration, createVercelGhostTunnelHandler, decodeGhostTunnelBody, defineLocalghostConfig, detectDevCommand, detectDevPackageManager, detectDevServices, detectPackageManager, encodeGhostTunnelBody, findAvailablePort, findGhostTunnelEntry, formatDetectedDevCommand, formatDetectedDevServices, formatDomainRoutes, formatGhostTunnel, formatLocalghostAgentGuide, formatUpdateMessage, getCaddyfilePath, getDomainRoutes, getGhostTunnelPath, getLocalghostActivityPath, getLocalghostRegistryRoot, getLocalghostStatePath, getProductionEnvKeys, getProductionReason, getSystemHostsPath, getUpdateCheckCachePath, initLocalghost, isNewerVersion, isPortAvailable, isProcessRunning, isProductionLike, isRelayRouteActive, isUpdateCheckDisabled, listGhostTunnelEntries, listLocalghostRuns, listLocalghostSetups, markUpdateNotified, maybeNotifyAboutUpdate, packageAddCommand, packageRunCommand, patchLocalghostState, pruneLocalghostActivity, readGhostTunnelEntries, readLocalghostActivity, readLocalghostProjectConfig, readLocalghostState, redactRelayHeaders, redactRelayLogUrl, registerLocalghostRun, registerLocalghostSetup, removeManagedBlock, removeSystemHosts, renderCaddyfile, renderCompactLocalghostBanner, renderGhostTunnelRelayOfflineResponse, renderGhostTunnelRouteMissingResponse, renderHostsBlock, renderLocalghostBanner, renderRelayOfflineResponse, resolveGhostTunnelIpRedirect, resolveGhostTunnelPath, resolveGhostTunnelRequest, resolveLocalghostContext, resolveRedisGhostTunnelEnv, runCaddy, runDoctor, serveGhostTunnelLocalRequest, shouldNotifyAboutUpdate, signGhostTunnelIpTransportClaim, signRelayRouteClaim, signalManagedProcess, signalManagedProcessPid, startCaddy, startGhostTunnelAgent, stopCaddyProcesses, stripRelayForwardHeaders, trustCaddy, unregisterLocalghostRun, unregisterLocalghostSetup, updateSystemHosts, upsertManagedBlock, validateCaddyfile, verifyGhostTunnelIpTransportClaim, verifyRelayRouteClaim, writeCaddyfile, writeLocalghostActivity, writeLocalghostState };
+export { type AcquireLocalghostPortOptions, type ActiveRelayRoute, type CaddyModeOptions, type CaddyProcessKiller, type CaddyProcessStopResult, ConfigPattern, type ConstructGhostTunnelIpUrlInput, ConstructGhostTunnelUrlInput, type CreateVercelGhostTunnelHandlerOptions, DEFAULT_GHOST_TUNNEL_IP_TRANSPORT_TTL_SECONDS, DEFAULT_GHOST_TUNNEL_RESPONSE_TTL_SECONDS, DEFAULT_GHOST_TUNNEL_TRANSPORT_QUERY_PARAM, DEFAULT_RELAY_ALLOWED_TARGET_HOSTS, DEFAULT_RELAY_BLOCKED_PORTS, DEFAULT_RELAY_LIMITS, DEFAULT_RELAY_TARGET_POLICY, type DetectedDevCommand, type DetectedDevService, DevHostEntry$1 as DevHostEntry, type DoctorOptions, type DoctorResult, type DomainRoute, type DomainRouteOptions, type FindAvailablePortOptions, type GhostTunnelAgent, type GhostTunnelAgentOptions, GhostTunnelConfig, type GhostTunnelHttpResponse, type GhostTunnelIpTransportClaim, GhostTunnelOptions, type GhostTunnelQueuedRequest, type GhostTunnelQueuedResponse, GhostTunnelRoute, type GhostTunnelRouteHeartbeat, type GhostTunnelStore, type GhostTunnelStoreEnv, GhostTunnelTransportConfig, GhostTunnelTransportOptions, type InitOptions, type InitResult, LOCALGHOST_ACTIVITY_VERSION, LOCALGHOST_AGENT_GUIDE, LOCALGHOST_GHOST_TUNNEL_FILE, LOCALGHOST_PACKAGE_NAME, LOCALGHOST_REGISTRY_FILE, LOCALGHOST_REGISTRY_LOCK_FILE, LOCALGHOST_STATE_FILE, LOCALGHOST_VERSION, type LocalghostActivity, type LocalghostContext, type LocalghostContextOptions, type LocalghostEnvironment, type LocalghostLease, type LocalghostPackageManager, type LocalghostProjectConfig, type LocalghostProjectConfigResult, type LocalghostRegistry, type LocalghostRegistryData, type LocalghostRegistryEntry, type LocalghostRegistryOptions, type LocalghostRunMode, type LocalghostRunRecord, type LocalghostServiceOptions, type LocalghostSetupRecord, type LocalghostState, type LocalghostStateAction, type LocalghostTestSession, type LocalghostTestSessionOptions, type PackageManager, type PortAvailabilityCheck, ReadDevHostsOptions$1 as ReadDevHostsOptions, type ReadGhostTunnelOptions, type RedisGhostTunnelEnvResolution, type RedisGhostTunnelStoreOptions, type RegisterLocalghostRunInput, type RegisterLocalghostSetupInput, type RelayAccessMode, type RelayLimits, type RelayLocalTarget, type RelayOfflineResponse, type RelayProtocol, type RelayRouteClaim, type RelayRouteRegistrationInput, type RelayTargetPolicy, type RemoveSystemHostsResult, type ResolveGhostTunnelIpRedirectInput, type ResolveGhostTunnelRequestInput, type ResolvedGhostTunnelIpRedirect, type ResolvedLocalghostTunnelRequest as ResolvedGhostTunnelRequest, type ServeGhostTunnelLocalRequestInput, type SignedGhostTunnelIpTransportClaim, type SignedRelayRouteClaim, UPDATE_CHECK_CACHE_TTL_MS, UPDATE_CHECK_NOTIFY_TTL_MS, UPDATE_CHECK_TIMEOUT_MS, type UpdateCheckCache, type UpdateCheckResult, type UpdateSystemHostsResult, type VercelGhostTunnelRequestLike, type VercelGhostTunnelResponseLike, type WriteLocalghostStateInput, assertExactRelayHost, assertLocalDevelopment, assertRelayLocalTarget, authenticateRelayAgentToken, canonicalizeLocalghostProjectCwd, checkCaddy, checkForUpdate, compareVersions, constructGhostTunnelIpUrl, createGhostTunnelQueuedRequest, createGhostTunnelRouteHeartbeat, createLocalghostRegistry, createLocalghostTestSession, createMemoryGhostTunnelStore, createRedisGhostTunnelStore, createRedisGhostTunnelStoreFromEnv, createRelayRouteRegistration, createVercelGhostTunnelHandler, decodeGhostTunnelBody, defineLocalghostConfig, detectDevCommand, detectDevPackageManager, detectDevServices, detectPackageManager, encodeGhostTunnelBody, findAvailablePort, findGhostTunnelEntry, formatDetectedDevCommand, formatDetectedDevServices, formatDomainRoutes, formatGhostTunnel, formatLocalghostAgentGuide, formatUpdateMessage, getCaddyfilePath, getDomainRoutes, getGhostTunnelPath, getLocalghostActivityPath, getLocalghostRegistryRoot, getLocalghostStatePath, getProductionEnvKeys, getProductionReason, getSystemHostsPath, getUpdateCheckCachePath, initLocalghost, isNewerVersion, isPortAvailable, isProcessRunning, isProductionLike, isRelayRouteActive, isUpdateCheckDisabled, listGhostTunnelEntries, listLocalghostRuns, listLocalghostSetups, markUpdateNotified, maybeNotifyAboutUpdate, packageAddCommand, packageRunCommand, patchLocalghostState, pruneLocalghostActivity, readGhostTunnelEntries, readLocalghostActivity, readLocalghostProjectConfig, readLocalghostState, redactRelayHeaders, redactRelayLogUrl, registerLocalghostRun, registerLocalghostSetup, removeManagedBlock, removeSystemHosts, renderCaddyfile, renderCompactLocalghostBanner, renderGhostTunnelRelayOfflineResponse, renderGhostTunnelRouteMissingResponse, renderHostsBlock, renderLocalghostBanner, renderRelayOfflineResponse, resolveGhostTunnelIpRedirect, resolveGhostTunnelPath, resolveGhostTunnelRequest, resolveLocalghostContext, resolveRedisGhostTunnelEnv, runCaddy, runDoctor, serveGhostTunnelLocalRequest, shouldNotifyAboutUpdate, signGhostTunnelIpTransportClaim, signRelayRouteClaim, signalManagedProcess, signalManagedProcessPid, startCaddy, startGhostTunnelAgent, stopCaddyProcesses, stripRelayForwardHeaders, trustCaddy, unregisterLocalghostRun, unregisterLocalghostSetup, updateSystemHosts, upsertManagedBlock, validateCaddyfile, verifyGhostTunnelIpTransportClaim, verifyRelayRouteClaim, writeCaddyfile, writeLocalghostActivity, writeLocalghostState };