pinggy 0.5.6 → 0.5.7

package/CLAUDE.md

@@ -48,7 +48,7 @@ CLI code calls `TunnelClient` (`src/daemon/tunnelClient.ts`), the public facade
 
 Single daemon per user. State lives under `~/.config/pinggy/` on Linux/macOS or `%APPDATA%/pinggy/` on Windows (helper: `src/utils/configDir.ts`):
 
-- `daemon.json`: `{pid, port, startedAt}`.
+- `daemon.json`: `{pid, port, startedAt, host, ipcVersion}`. `ipcVersion` is `IPC_VERSION` from `src/daemon/ipc/ipcRoutes.ts`. `ensureDaemonRunning()` refuses a live daemon whose version differs and tells the user to run `pinggy daemon stop`. Bump `IPC_VERSION` on any incompatible IPC or WebSocket change.
 - `daemon-state.json`: detached tunnel configs for crash recovery (`src/daemon/stateStore.ts`). Deleted on clean shutdown; replayed on next start.
 - `daemon.log`: SDK + daemon logs. CLI logs stay separate.
 - `tunnels/<name>_<configId>.json`: saved tunnel configs from `pinggy config save`.

package/dist/{chunk-OH6FSLYF.js → chunk-GA6UTBOU.js}

@@ -3,23 +3,27 @@ import {
   TunnelClient,
   TunnelOperations,
   buildRemoteManagementWsUrl,
+  daemonIpcVersion,
   getDaemonInfo,
   initiateRemoteManagement,
+  ipcMismatchMessage,
   isDaemonRunning,
   isErrorResponse,
+  isIpcCompatible,
   startDaemon,
   startRemoteManagement,
   stopDaemon
-} from "./chunk-HN4YLM7U.js";
+} from "./chunk-HS3OI4OL.js";
 import {
   readDaemonConfig
 } from "./chunk-MT44NAXX.js";
 import {
   DaemonHost,
+  IPC_VERSION,
   Route,
   SessionMode,
   ShutdownStatus
-} from "./chunk-YTJEV27N.js";
+} from "./chunk-I4HXBP5G.js";
 import {
   ConfigVerb,
   SUBCOMMANDS,
@@ -1779,9 +1783,13 @@ async function handleDaemon(args) {
   }
 }
 async function handleDaemonStart() {
-  if (isDaemonRunning()) {
-    const info = getDaemonInfo();
-    printer_default.print(pico2.yellow(`Daemon already running (PID ${info?.pid}, port ${info?.port}). Use: pinggy daemon status for details.`));
+  const info = getDaemonInfo();
+  if (info) {
+    if (!isIpcCompatible(info)) {
+      printer_default.error(ipcMismatchMessage(info));
+      process.exit(1);
+    }
+    printer_default.print(pico2.yellow(`Daemon already running (PID ${info.pid}, port ${info.port}). Use: pinggy daemon status for details.`));
     return;
   }
   const autoConfigs = getAutoStartConfigs();
@@ -1794,8 +1802,8 @@ async function handleDaemonStart() {
     printer_default.print(pico2.cyanBright("Starting daemon..."));
   }
   try {
-    const info = await startDaemon();
-    printer_default.success(`Daemon started PID ${info.pid}.`);
+    const info2 = await startDaemon();
+    printer_default.success(`Daemon started PID ${info2.pid}.`);
   } catch (err) {
     printer_default.error(`Failed to start daemon: ${errorMessage(err)}`);
     process.exit(1);
@@ -1832,6 +1840,10 @@ function handleDaemonStatus() {
   printer_default.print(`  Started:   ${info.startedAt}`);
   printer_default.print(`  Uptime:    ${uptimeStr}`);
   printer_default.print(`  Host:      ${info.host === DaemonHost.APP ? "Pinggy app (in-process)" : "standalone (CLI)"}`);
+  printer_default.print(`  IPC:       v${daemonIpcVersion(info)}`);
+  if (!isIpcCompatible(info)) {
+    printer_default.print(pico2.yellow(`  Warning:   ${ipcMismatchMessage(info)}`));
+  }
 }
 
 // src/cli/subcommand/handlers/psCommand.ts
@@ -2610,7 +2622,8 @@ var IPCServer = class {
       [Route.Ping]: () => ({
         status: "ok",
         pid: process.pid,
-        uptime: Math.floor((Date.now() - this.startedAt) / 1e3)
+        uptime: Math.floor((Date.now() - this.startedAt) / 1e3),
+        ipcVersion: IPC_VERSION
       }),
       [Route.ListTunnels]: async () => {
         const res = await this.ops.handleListV2();
@@ -3403,7 +3416,8 @@ async function runDaemonChild(opts = {}) {
       pid: process.pid,
       port,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      host: daemonHost
+      host: daemonHost,
+      ipcVersion: IPC_VERSION
     };
     writeDaemonInfo(info);
     logger.info("Daemon info written", info);
@@ -3444,7 +3458,7 @@ async function main() {
     const { values, positionals, hasAnyArgs } = parseCliArgs(cliOptions);
     configureLogger(values);
     if (values["_daemon-child"]) {
-      const { runDaemonChild: runDaemonChild2 } = await import("./daemonChild-3ONQO2XI.js");
+      const { runDaemonChild: runDaemonChild2 } = await import("./daemonChild-STFB5OQL.js");
       await runDaemonChild2();
       return;
     }

package/dist/{chunk-HN4YLM7U.js → chunk-HS3OI4OL.js}

@@ -1,9 +1,10 @@
 import {
   DaemonHost,
   IPCClient,
+  IPC_VERSION,
   SessionMode,
   ShutdownStatus
-} from "./chunk-YTJEV27N.js";
+} from "./chunk-I4HXBP5G.js";
 import {
   TunnelAlreadyRunningError,
   TunnelManager,
@@ -1612,6 +1613,19 @@ function getDaemonInfo() {
 function isDaemonRunning() {
   return getDaemonInfo() !== null;
 }
+function daemonIpcVersion(info) {
+  return info.ipcVersion ?? 0;
+}
+function isIpcCompatible(info) {
+  return daemonIpcVersion(info) === IPC_VERSION;
+}
+function ipcMismatchMessage(info) {
+  const versions = `daemon IPC v${daemonIpcVersion(info)}, this CLI expects v${IPC_VERSION}`;
+  if (info.host === DaemonHost.APP) {
+    return `The Pinggy app is running a daemon from a different version (${versions}). Update or restart the Pinggy app.`;
+  }
+  return `A daemon from a different Pinggy CLI version is running (PID ${info.pid}; ${versions}). Run "pinggy daemon stop" and retry. This stops all running tunnels.`;
+}
 function getDaemonSpawnArgs() {
   return {
     command: process.execPath,
@@ -1658,9 +1672,12 @@ async function startDaemon() {
 }
 async function ensureDaemonRunning() {
   const existing = getDaemonInfo();
-  if (existing) return existing;
+  if (existing) {
+    if (!isIpcCompatible(existing)) throw new Error(ipcMismatchMessage(existing));
+    return existing;
+  }
   if (process.versions.electron) {
-    const { runDaemonChild } = await import("./daemonChild-3ONQO2XI.js");
+    const { runDaemonChild } = await import("./daemonChild-STFB5OQL.js");
     const handle = await runDaemonChild({
       installSignalHandlers: false,
       exitOnFailure: false,
@@ -1671,7 +1688,8 @@ async function ensureDaemonRunning() {
       pid: handle.pid,
       port: handle.port,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      host: DaemonHost.APP
+      host: DaemonHost.APP,
+      ipcVersion: IPC_VERSION
     };
   }
   return startDaemon();
@@ -1682,7 +1700,7 @@ function getInProcessDaemonHandle() {
 async function getActiveTunnelSummaries(origin = "app") {
   const info = getDaemonInfo();
   if (!info) return [];
-  const { IPCClient: IPCClient2 } = await import("./ipcClient-XRL2WUUM.js");
+  const { IPCClient: IPCClient2 } = await import("./ipcClient-URHJKNEH.js");
   const client = new IPCClient2(info.port, origin);
   let tunnels;
   try {
@@ -1729,7 +1747,7 @@ async function stopDaemon() {
   if (!info) return { ok: false, error: "No daemon is running." };
   let daemonErrors = [];
   try {
-    const { IPCClient: IPCClient2 } = await import("./ipcClient-XRL2WUUM.js");
+    const { IPCClient: IPCClient2 } = await import("./ipcClient-URHJKNEH.js");
     const client = new IPCClient2(info.port);
     const result = await client.shutdown();
     logger.debug("Sent shutdown command to daemon", { result });
@@ -2351,6 +2369,9 @@ export {
   getRemoteManagementState,
   getDaemonInfo,
   isDaemonRunning,
+  daemonIpcVersion,
+  isIpcCompatible,
+  ipcMismatchMessage,
   startDaemon,
   ensureDaemonRunning,
   getInProcessDaemonHandle,

package/dist/{chunk-YTJEV27N.js → chunk-I4HXBP5G.js}

@@ -2,6 +2,7 @@
 import http from "http";
 
 // src/daemon/ipc/ipcRoutes.ts
+var IPC_VERSION = 1;
 var Route = {
   Ping: "GET /ping",
   ListTunnels: "GET /tunnels",
@@ -166,6 +167,7 @@ var IPCClient = class {
 };
 
 export {
+  IPC_VERSION,
   Route,
   DaemonHost,
   ShutdownStatus,

package/dist/{daemonChild-3ONQO2XI.js → daemonChild-STFB5OQL.js}

@@ -6,12 +6,12 @@ import {
   trackIPCTunnelStart,
   trackTunnelStart,
   trackTunnelStop
-} from "./chunk-OH6FSLYF.js";
-import "./chunk-HN4YLM7U.js";
+} from "./chunk-GA6UTBOU.js";
+import "./chunk-HS3OI4OL.js";
 import "./chunk-MT44NAXX.js";
 import {
   DaemonHost
-} from "./chunk-YTJEV27N.js";
+} from "./chunk-I4HXBP5G.js";
 import "./chunk-YWXADADB.js";
 import "./chunk-PQSLSIDA.js";
 import "./chunk-UB26QJ4T.js";

package/dist/index.cjs

@@ -2791,11 +2791,12 @@ var init_handler = __esm({
 });
 
 // src/daemon/ipc/ipcRoutes.ts
-var Route, DaemonHost, ShutdownStatus, SessionMode;
+var IPC_VERSION, Route, DaemonHost, ShutdownStatus, SessionMode;
 var init_ipcRoutes = __esm({
   "src/daemon/ipc/ipcRoutes.ts"() {
     "use strict";
     init_cjs_shims();
+    IPC_VERSION = 1;
     Route = {
       Ping: "GET /ping",
       ListTunnels: "GET /tunnels",
@@ -7527,9 +7528,13 @@ async function handleDaemon(args) {
   }
 }
 async function handleDaemonStart() {
-  if (isDaemonRunning()) {
-    const info = getDaemonInfo();
-    printer_default.print(import_picocolors6.default.yellow(`Daemon already running (PID ${info?.pid}, port ${info?.port}). Use: pinggy daemon status for details.`));
+  const info = getDaemonInfo();
+  if (info) {
+    if (!isIpcCompatible(info)) {
+      printer_default.error(ipcMismatchMessage(info));
+      process.exit(1);
+    }
+    printer_default.print(import_picocolors6.default.yellow(`Daemon already running (PID ${info.pid}, port ${info.port}). Use: pinggy daemon status for details.`));
     return;
   }
   const autoConfigs = getAutoStartConfigs();
@@ -7542,8 +7547,8 @@ async function handleDaemonStart() {
     printer_default.print(import_picocolors6.default.cyanBright("Starting daemon..."));
   }
   try {
-    const info = await startDaemon();
-    printer_default.success(`Daemon started PID ${info.pid}.`);
+    const info2 = await startDaemon();
+    printer_default.success(`Daemon started PID ${info2.pid}.`);
   } catch (err) {
     printer_default.error(`Failed to start daemon: ${errorMessage(err)}`);
     process.exit(1);
@@ -7580,6 +7585,10 @@ function handleDaemonStatus() {
   printer_default.print(`  Started:   ${info.startedAt}`);
   printer_default.print(`  Uptime:    ${uptimeStr}`);
   printer_default.print(`  Host:      ${info.host === DaemonHost.APP ? "Pinggy app (in-process)" : "standalone (CLI)"}`);
+  printer_default.print(`  IPC:       v${daemonIpcVersion(info)}`);
+  if (!isIpcCompatible(info)) {
+    printer_default.print(import_picocolors6.default.yellow(`  Warning:   ${ipcMismatchMessage(info)}`));
+  }
 }
 var import_picocolors6;
 var init_daemonCommandsHandler = __esm({
@@ -8573,7 +8582,8 @@ var init_ipcServer = __esm({
           [Route.Ping]: () => ({
             status: "ok",
             pid: process.pid,
-            uptime: Math.floor((Date.now() - this.startedAt) / 1e3)
+            uptime: Math.floor((Date.now() - this.startedAt) / 1e3),
+            ipcVersion: IPC_VERSION
           }),
           [Route.ListTunnels]: async () => {
             const res = await this.ops.handleListV2();
@@ -9388,7 +9398,8 @@ async function runDaemonChild(opts = {}) {
       pid: process.pid,
       port,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      host: daemonHost
+      host: daemonHost,
+      ipcVersion: IPC_VERSION
     };
     writeDaemonInfo(info);
     logger.info("Daemon info written", info);
@@ -9475,6 +9486,19 @@ function getDaemonInfo() {
 function isDaemonRunning() {
   return getDaemonInfo() !== null;
 }
+function daemonIpcVersion(info) {
+  return info.ipcVersion ?? 0;
+}
+function isIpcCompatible(info) {
+  return daemonIpcVersion(info) === IPC_VERSION;
+}
+function ipcMismatchMessage(info) {
+  const versions = `daemon IPC v${daemonIpcVersion(info)}, this CLI expects v${IPC_VERSION}`;
+  if (info.host === DaemonHost.APP) {
+    return `The Pinggy app is running a daemon from a different version (${versions}). Update or restart the Pinggy app.`;
+  }
+  return `A daemon from a different Pinggy CLI version is running (PID ${info.pid}; ${versions}). Run "pinggy daemon stop" and retry. This stops all running tunnels.`;
+}
 function getDaemonSpawnArgs() {
   return {
     command: process.execPath,
@@ -9521,7 +9545,10 @@ async function startDaemon() {
 }
 async function ensureDaemonRunning() {
   const existing = getDaemonInfo();
-  if (existing) return existing;
+  if (existing) {
+    if (!isIpcCompatible(existing)) throw new Error(ipcMismatchMessage(existing));
+    return existing;
+  }
   if (process.versions.electron) {
     const { runDaemonChild: runDaemonChild2 } = await Promise.resolve().then(() => (init_daemonChild(), daemonChild_exports));
     const handle = await runDaemonChild2({
@@ -9534,7 +9561,8 @@ async function ensureDaemonRunning() {
       pid: handle.pid,
       port: handle.port,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      host: DaemonHost.APP
+      host: DaemonHost.APP,
+      ipcVersion: IPC_VERSION
     };
   }
   return startDaemon();

package/dist/index.d.cts

@@ -658,6 +658,7 @@ interface PingResponse {
     status: string;
     pid: number;
     uptime: number;
+    ipcVersion: number;
 }
 type ListTunnelsResponse = (TunnelResponseV2 & {
     mode?: SessionMode;
@@ -1085,11 +1086,7 @@ declare class TunnelClient {
      * Close the WebSocket connection and cleanup.
      */
     close(): void;
-    ping(): Promise<{
-        status: string;
-        pid: number;
-        uptime: number;
-    }>;
+    ping(): Promise<PingResponse>;
     handleStartV2(config: object, noWait?: boolean, mode?: SessionMode): Promise<TunnelResponseV2 | ErrorResponse>;
     handleStart(config: object, noWait?: boolean, mode?: SessionMode): Promise<TunnelResponse | ErrorResponse>;
     handleUpdateConfig(config: object, noWait?: boolean): Promise<TunnelResponse | ErrorResponse>;
@@ -1143,6 +1140,8 @@ interface DaemonInfo {
     port: number;
     startedAt: string;
     host?: DaemonHost;
+    /** IPC protocol version the daemon speaks. Absent in daemon.json written by older builds. */
+    ipcVersion?: number;
 }
 
 /**

package/dist/index.d.ts

@@ -658,6 +658,7 @@ interface PingResponse {
     status: string;
     pid: number;
     uptime: number;
+    ipcVersion: number;
 }
 type ListTunnelsResponse = (TunnelResponseV2 & {
     mode?: SessionMode;
@@ -1085,11 +1086,7 @@ declare class TunnelClient {
      * Close the WebSocket connection and cleanup.
      */
     close(): void;
-    ping(): Promise<{
-        status: string;
-        pid: number;
-        uptime: number;
-    }>;
+    ping(): Promise<PingResponse>;
     handleStartV2(config: object, noWait?: boolean, mode?: SessionMode): Promise<TunnelResponseV2 | ErrorResponse>;
     handleStart(config: object, noWait?: boolean, mode?: SessionMode): Promise<TunnelResponse | ErrorResponse>;
     handleUpdateConfig(config: object, noWait?: boolean): Promise<TunnelResponse | ErrorResponse>;
@@ -1143,6 +1140,8 @@ interface DaemonInfo {
     port: number;
     startedAt: string;
     host?: DaemonHost;
+    /** IPC protocol version the daemon speaks. Absent in daemon.json written by older builds. */
+    ipcVersion?: number;
 }
 
 /**

package/dist/index.js

@@ -14,8 +14,8 @@ import {
   initiateRemoteManagement,
   isDaemonRunning,
   startRemoteManagement
-} from "./chunk-HN4YLM7U.js";
-import "./chunk-YTJEV27N.js";
+} from "./chunk-HS3OI4OL.js";
+import "./chunk-I4HXBP5G.js";
 import {
   bulkReplace,
   configureStorageLogger,
@@ -139,7 +139,7 @@ async function verifyAndLoad() {
       process.exit(1);
     }
   }
-  await import("./main-WXFARRMN.js");
+  await import("./main-M5PCTJTB.js");
 }
 verifyAndLoad().catch((err) => {
   printer_default.fatal(`Failed to start CLI:, ${err}`);

package/dist/{ipcClient-XRL2WUUM.js → ipcClient-URHJKNEH.js}

@@ -1,6 +1,6 @@
 import {
   IPCClient
-} from "./chunk-YTJEV27N.js";
+} from "./chunk-I4HXBP5G.js";
 export {
   IPCClient
 };

package/dist/{main-WXFARRMN.js → main-M5PCTJTB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDaemonChild
-} from "./chunk-OH6FSLYF.js";
+} from "./chunk-GA6UTBOU.js";
 import {
   RemoteManagementUnauthorizedError,
   TunnelOperations,
@@ -13,11 +13,11 @@ import {
   getRemoteManagementState,
   initiateRemoteManagement,
   isDaemonRunning
-} from "./chunk-HN4YLM7U.js";
+} from "./chunk-HS3OI4OL.js";
 import "./chunk-MT44NAXX.js";
 import {
   DaemonHost
-} from "./chunk-YTJEV27N.js";
+} from "./chunk-I4HXBP5G.js";
 import "./chunk-YWXADADB.js";
 import {
   TunnelManager

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinggy",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Create secure, shareable tunnels to your localhost and manage them from the command line. ",