@hamedb89/localghost 0.4.1 → 0.6.1

package/dist/index.d.ts

@@ -543,18 +543,6 @@ declare function packageRunCommand(packageManager: PackageManager, script: strin
 declare function packageAddCommand(packageManager: PackageManager, packageName?: string): string;
 declare function initLocalghost(options?: InitOptions): InitResult;
 
-type FindAvailablePortOptions = {
-    host?: string;
-    maxAttempts?: number;
-};
-declare function isPortAvailable(port: number, host?: string): Promise<boolean>;
-declare function findAvailablePort(startPort: number, options?: FindAvailablePortOptions): Promise<number>;
-
-type ProcessSignal = NodeJS.Signals;
-type ProcessKiller = (pid: number, signal: ProcessSignal) => void;
-declare function signalManagedProcessPid(pid: number | undefined, signal: ProcessSignal, killProcess?: ProcessKiller): boolean;
-declare function signalManagedProcess(child: Pick<ChildProcess, "pid" | "kill" | "killed">, signal: ProcessSignal): boolean;
-
 declare const LOCALGHOST_REGISTRY_FILE = "registry.json";
 declare const LOCALGHOST_REGISTRY_LOCK_FILE = "registry.lock";
 type PortAvailabilityCheck = (port: number, host?: string) => boolean | Promise<boolean>;
@@ -599,12 +587,18 @@ type AcquireLocalghostPortOptions = {
     leaseTtlMs?: number;
     host?: string;
 };
+type RenewLocalghostPortOptions = {
+    projectCwd?: string;
+    instanceKey: string;
+    leaseTtlMs?: number;
+};
 type LocalghostRegistry = {
     root: string;
     registryPath: string;
     lockPath: string;
     ownerToken: string;
     acquirePort(options: AcquireLocalghostPortOptions): Promise<LocalghostLease>;
+    renewPort(options: RenewLocalghostPortOptions): Promise<LocalghostLease | undefined>;
     releasePort(options: {
         projectCwd?: string;
         instanceKey: string;
@@ -613,11 +607,48 @@ 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;
 declare function createLocalghostRegistry(options?: LocalghostRegistryOptions): LocalghostRegistry;
 
+type LocalghostTestSessionOptions = {
+    cwd?: string;
+    instanceKey: string;
+    services: Record<string, {
+        startPort: number;
+        maxAttempts?: number;
+        host?: string;
+    }>;
+    leaseTtlMs?: number;
+};
+type LocalghostTestSession = {
+    instanceKey: string;
+    ports: Record<string, number>;
+    leases: LocalghostLease[];
+    renew: () => Promise<void>;
+    startHeartbeat: (intervalMs?: number) => NodeJS.Timeout;
+    release: () => Promise<void>;
+};
+declare function createLocalghostTestSession(options: LocalghostTestSessionOptions): Promise<LocalghostTestSession>;
+
+type FindAvailablePortOptions = {
+    host?: string;
+    maxAttempts?: number;
+};
+declare function isPortAvailable(port: number, host?: string): Promise<boolean>;
+declare function findAvailablePort(startPort: number, options?: FindAvailablePortOptions): Promise<number>;
+
+type ProcessSignal = NodeJS.Signals;
+type ProcessKiller = (pid: number, signal: ProcessSignal) => void;
+declare function signalManagedProcessPid(pid: number | undefined, signal: ProcessSignal, killProcess?: ProcessKiller): boolean;
+declare function signalManagedProcess(child: Pick<ChildProcess, "pid" | "kill" | "killed">, signal: ProcessSignal): boolean;
+
 type DomainRoute = {
     host: string;
     port: number;
@@ -685,7 +716,7 @@ type CreateVercelGhostTunnelHandlerOptions = {
 declare function createVercelGhostTunnelHandler(options: CreateVercelGhostTunnelHandlerOptions): (request: VercelGhostTunnelRequestLike, response: VercelGhostTunnelResponseLike) => Promise<void>;
 
 declare const LOCALGHOST_PACKAGE_NAME = "@hamedb89/localghost";
-declare const LOCALGHOST_VERSION = "0.4.1";
+declare const LOCALGHOST_VERSION = "0.6.1";
 declare const UPDATE_CHECK_CACHE_TTL_MS: number;
 declare const UPDATE_CHECK_NOTIFY_TTL_MS: number;
 declare const UPDATE_CHECK_TIMEOUT_MS = 900;
@@ -722,4 +753,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 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, 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, 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 };

package/dist/index.js

@@ -844,11 +844,11 @@ function isStopped(signal, localSignal) {
 }
 function wait(ms, signal, localSignal) {
   if (isStopped(signal, localSignal)) return Promise.resolve();
-  return new Promise((resolve4) => {
-    const timeout = setTimeout(resolve4, ms);
+  return new Promise((resolve5) => {
+    const timeout = setTimeout(resolve5, ms);
     const stop = () => {
       clearTimeout(timeout);
-      resolve4();
+      resolve5();
     };
     signal?.addEventListener("abort", stop, { once: true });
     localSignal.addEventListener("abort", stop, { once: true });
@@ -1696,13 +1696,13 @@ import { pathToFileURL } from "url";
 // src/port.ts
 import { createServer } from "net";
 async function isPortAvailable(port, host = "127.0.0.1") {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const server = createServer();
     server.once("error", () => {
-      resolve4(false);
+      resolve5(false);
     });
     server.once("listening", () => {
-      server.close(() => resolve4(true));
+      server.close(() => resolve5(true));
     });
     server.listen(port, host);
   });
@@ -1755,6 +1755,9 @@ function validRegistry(value) {
 function pruneRegistry(registry, now, isRunning) {
   registry.leases = registry.leases.filter((lease) => lease.expiresAt > now && isRunning(lease.pid));
 }
+function isTestSessionKey(instanceKey) {
+  return instanceKey.startsWith("test:");
+}
 async function readJson(path) {
   try {
     return JSON.parse(await readFile(path, "utf8"));
@@ -1851,6 +1854,37 @@ function createLocalghostRegistry(options = {}) {
         await releaseLock();
       }
     },
+    async pruneTestSessions() {
+      const releaseLock = await lock();
+      try {
+        const registry = await readRegistry();
+        const staleTestKeys = new Set(
+          registry.leases.filter((lease) => isTestSessionKey(lease.instanceKey) && (lease.expiresAt <= now() || !isRunning(lease.pid))).map((lease) => leaseKey(lease.projectCwd, lease.instanceKey))
+        );
+        const beforeLeases = registry.leases.length;
+        registry.leases = registry.leases.filter((lease) => !staleTestKeys.has(leaseKey(lease.projectCwd, lease.instanceKey)));
+        const activeKeys = new Set(registry.leases.map((lease) => leaseKey(lease.projectCwd, lease.instanceKey)));
+        const beforeAllocations = registry.allocations.length;
+        registry.allocations = registry.allocations.filter(
+          (allocation) => !isTestSessionKey(allocation.instanceKey) || activeKeys.has(leaseKey(allocation.projectCwd, allocation.instanceKey))
+        );
+        await writeRegistry(registry);
+        return {
+          removedLeases: beforeLeases - registry.leases.length,
+          removedAllocations: beforeAllocations - registry.allocations.length
+        };
+      } finally {
+        await releaseLock();
+      }
+    },
+    async reset() {
+      const releaseLock = await lock();
+      try {
+        await writeRegistry({ version: 1, allocations: [], leases: [] });
+      } finally {
+        await releaseLock();
+      }
+    },
     async acquirePort(acquireOptions) {
       const projectCwd = canonicalizeLocalghostProjectCwd(acquireOptions.projectCwd ?? cwd);
       if (!acquireOptions.instanceKey) throw new Error("instanceKey is required");
@@ -1888,6 +1922,18 @@ function createLocalghostRegistry(options = {}) {
         return lease;
       });
     },
+    async renewPort(renewOptions) {
+      const projectCwd = canonicalizeLocalghostProjectCwd(renewOptions.projectCwd ?? cwd);
+      return withLock(async (registry) => {
+        const lease = registry.leases.find(
+          (candidate) => candidate.projectCwd === projectCwd && candidate.instanceKey === renewOptions.instanceKey && candidate.ownerToken === ownerToken
+        );
+        if (!lease || lease.expiresAt <= now() || !isRunning(lease.pid)) return void 0;
+        lease.expiresAt = now() + (renewOptions.leaseTtlMs ?? 30 * 60 * 1e3);
+        await writeRegistry(registry);
+        return lease;
+      });
+    },
     async releasePort(releaseOptions) {
       const projectCwd = canonicalizeLocalghostProjectCwd(releaseOptions.projectCwd ?? cwd);
       return withLock(async (registry) => {
@@ -2429,7 +2475,7 @@ async function removeSystemHosts(projectName) {
 
 // src/init.ts
 import { existsSync as existsSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
-import { join as join8 } from "path";
+import { dirname as dirname4, join as join8, resolve as resolve4 } from "path";
 function detectPackageManager(cwd = process.cwd()) {
   if (existsSync5(join8(cwd, "pnpm-lock.yaml"))) return "pnpm";
   if (existsSync5(join8(cwd, "yarn.lock"))) return "yarn";
@@ -2561,9 +2607,62 @@ function initLocalghost(options = {}) {
   };
 }
 
+// src/test-session.ts
+async function createLocalghostTestSession(options) {
+  if (!options.instanceKey) throw new Error("instanceKey is required");
+  const registry = createLocalghostRegistry(options.cwd ? { cwd: options.cwd } : {});
+  const leases = [];
+  const ports = {};
+  const leaseTtlMs = options.leaseTtlMs ?? 30 * 60 * 1e3;
+  if (!Number.isFinite(leaseTtlMs) || leaseTtlMs < 1e3) throw new Error("leaseTtlMs must be at least 1000 milliseconds.");
+  try {
+    for (const [name, service] of Object.entries(options.services)) {
+      const lease = await registry.acquirePort({
+        ...options.cwd ? { projectCwd: options.cwd } : {},
+        instanceKey: `test:${options.instanceKey}:${name}`,
+        startPort: service.startPort,
+        ...service.maxAttempts !== void 0 ? { maxAttempts: service.maxAttempts } : {},
+        ...service.host !== void 0 ? { host: service.host } : {},
+        leaseTtlMs,
+        reservedPorts: Object.values(ports)
+      });
+      leases.push(lease);
+      ports[name] = lease.port;
+    }
+  } catch (error) {
+    await Promise.all(leases.map((lease) => registry.releasePort({ projectCwd: lease.projectCwd, instanceKey: lease.instanceKey })));
+    throw error;
+  }
+  let released = false;
+  const renew = async () => {
+    if (released) return;
+    await Promise.all(leases.map(async (lease) => {
+      const renewed = await registry.renewPort({ projectCwd: lease.projectCwd, instanceKey: lease.instanceKey, leaseTtlMs });
+      if (!renewed) throw new Error(`Localghost test lease expired: ${lease.instanceKey}`);
+    }));
+  };
+  return {
+    instanceKey: options.instanceKey,
+    ports,
+    leases,
+    renew,
+    startHeartbeat(intervalMs = Math.max(1e3, Math.floor(leaseTtlMs / 3))) {
+      if (!Number.isFinite(intervalMs) || intervalMs < 1e3) throw new Error("Heartbeat interval must be at least 1000 milliseconds.");
+      const timer = setInterval(() => void renew().catch(() => void 0), intervalMs);
+      timer.unref();
+      return timer;
+    },
+    async release() {
+      if (released) return;
+      released = true;
+      await Promise.all(leases.map((lease) => registry.releasePort({ projectCwd: lease.projectCwd, instanceKey: lease.instanceKey })));
+    }
+  };
+}
+
 // src/process.ts
 function signalManagedProcessPid(pid, signal, killProcess = (value, processSignal) => process.kill(value, processSignal)) {
-  if (typeof pid !== "number" || !Number.isInteger(pid) || pid < 1) return false;
+  if (typeof pid !== "number" || !Number.isInteger(pid) || pid <= 1 || pid === process.pid) return false;
   try {
     killProcess(process.platform === "win32" ? pid : -pid, signal);
     return true;
@@ -2796,7 +2895,7 @@ async function waitForTunnelResponse(input) {
       await input.store.cleanup(input.requestId);
       return response;
     }
-    await new Promise((resolve4) => setTimeout(resolve4, input.pollIntervalMs));
+    await new Promise((resolve5) => setTimeout(resolve5, input.pollIntervalMs));
   }
   return null;
 }
@@ -2897,9 +2996,9 @@ function createVercelGhostTunnelHandler(options) {
 // src/update-check.ts
 import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { homedir as homedir3 } from "os";
-import { dirname as dirname4, join as join10 } from "path";
+import { dirname as dirname5, join as join10 } from "path";
 var LOCALGHOST_PACKAGE_NAME = "@hamedb89/localghost";
-var LOCALGHOST_VERSION = "0.4.1";
+var LOCALGHOST_VERSION = "0.6.1";
 var UPDATE_CHECK_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 var UPDATE_CHECK_NOTIFY_TTL_MS = 24 * 60 * 60 * 1e3;
 var UPDATE_CHECK_TIMEOUT_MS = 900;
@@ -2924,7 +3023,7 @@ function readCache(path = getUpdateCheckCachePath()) {
 }
 function writeCache(cache, path = getUpdateCheckCachePath()) {
   try {
-    mkdirSync3(dirname4(path), { recursive: true });
+    mkdirSync3(dirname5(path), { recursive: true });
     writeFileSync5(path, `${JSON.stringify(cache, null, 2)}
 `, "utf8");
   } catch {
@@ -3097,6 +3196,7 @@ export {
   createGhostTunnelQueuedRequest,
   createGhostTunnelRouteHeartbeat,
   createLocalghostRegistry,
+  createLocalghostTestSession,
   createMemoryGhostTunnelStore,
   createRedisGhostTunnelStore,
   createRedisGhostTunnelStoreFromEnv,