@metamask-previews/wallet-cli 0.0.0-preview-b2742a2fc → 0.0.0-preview-a8fd340

package/dist/daemon/stop-daemon.cjs

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopDaemon = void 0;
+const promises_1 = require("node:fs/promises");
+const daemon_client_1 = require("./daemon-client.cjs");
+const utils_1 = require("./utils.cjs");
+/**
+ * Stop the daemon via a `shutdown` RPC call. Falls back to PID + SIGTERM if
+ * the socket is unresponsive, and escalates to SIGKILL if SIGTERM is ignored.
+ *
+ * Signals are sent when EITHER the socket was observed (`responsive` or
+ * `unreachable`) OR the recorded PID is still alive on its own. The
+ * socket-absent + alive-PID branch trades a small risk of signalling a
+ * recycled PID for the larger risk of leaving an orphan daemon holding the
+ * SQLite database — which `daemon purge` would otherwise wipe out from
+ * under it.
+ *
+ * @param socketPath - The daemon socket path.
+ * @param pidPath - The daemon PID file path.
+ * @param log - Optional logging function for status messages.
+ * @returns True if the daemon was stopped (or was not running).
+ */
+async function stopDaemon(socketPath, pidPath, log) {
+    const pid = await (0, utils_1.readPidFile)(pidPath);
+    const ping = await (0, daemon_client_1.pingDaemon)(socketPath);
+    const socketObserved = ping.status === 'responsive' || ping.status === 'unreachable';
+    const processAlive = pid !== undefined && (0, utils_1.isProcessAlive)(pid);
+    if (!socketObserved && !processAlive) {
+        // No live daemon evidence. Just remove the stale PID file if any.
+        await cleanupFile(pidPath, 'PID file', log);
+        return true;
+    }
+    log?.('Stopping daemon...');
+    let stopped = false;
+    // Strategy 1: Graceful socket-based shutdown.
+    if (ping.status === 'responsive') {
+        try {
+            await (0, daemon_client_1.sendCommand)({ socketPath, method: 'shutdown' });
+        }
+        catch (error) {
+            log?.(`Graceful shutdown request failed: ${String(error)}`);
+        }
+        // A quiet socket does not prove the process exited; require the recorded
+        // pid to be gone too, so a daemon that outlived its socket falls through to
+        // SIGTERM/SIGKILL rather than being orphaned.
+        stopped = await (0, utils_1.waitFor)(async () => (await (0, daemon_client_1.pingDaemon)(socketPath)).status !== 'responsive' &&
+            (pid === undefined || !(0, utils_1.isProcessAlive)(pid)), 5000);
+    }
+    // Strategy 2: SIGTERM. Signal when either the socket was observed or the
+    // recorded PID is alive; the absent+alive case typically means someone
+    // removed the socket from under a live daemon.
+    if (!stopped && processAlive && pid !== undefined) {
+        if (!socketObserved) {
+            log?.(`Socket at ${socketPath} is absent but recorded pid ${pid} is alive; signalling anyway.`);
+        }
+        try {
+            if ((0, utils_1.sendSignal)(pid, 'SIGTERM')) {
+                stopped = await (0, utils_1.waitFor)(() => !(0, utils_1.isProcessAlive)(pid), 5000);
+            }
+            else {
+                stopped = true; // Process already gone (ESRCH).
+            }
+        }
+        catch (error) {
+            log?.(`SIGTERM failed: ${String(error)}`);
+        }
+    }
+    // Strategy 3: SIGKILL.
+    if (!stopped && processAlive && pid !== undefined) {
+        try {
+            if ((0, utils_1.sendSignal)(pid, 'SIGKILL')) {
+                stopped = await (0, utils_1.waitFor)(() => !(0, utils_1.isProcessAlive)(pid), 2000);
+            }
+            else {
+                stopped = true; // Process already gone (ESRCH).
+            }
+        }
+        catch (error) {
+            log?.(`SIGKILL failed: ${String(error)}`);
+        }
+    }
+    if (stopped) {
+        await cleanupFile(pidPath, 'PID file', log);
+        await cleanupFile(socketPath, 'socket file', log);
+        log?.('Daemon stopped.');
+    }
+    return stopped;
+}
+exports.stopDaemon = stopDaemon;
+/**
+ * Remove a file best-effort, logging any failure rather than letting it
+ * propagate. ENOENT is silently ignored via `force: true`.
+ *
+ * @param path - The file path to remove.
+ * @param label - Human-readable label for log messages.
+ * @param log - Optional log sink.
+ */
+async function cleanupFile(path, label, log) {
+    await (0, promises_1.rm)(path, { force: true }).catch((error) => {
+        log?.(`Failed to remove ${label}: ${String(error)}`);
+    });
+}
+//# sourceMappingURL=stop-daemon.cjs.map

package/dist/daemon/stop-daemon.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-daemon.cjs","sourceRoot":"","sources":["../../src/daemon/stop-daemon.ts"],"names":[],"mappings":"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","sourcesContent":["import { rm } from 'node:fs/promises';\n\nimport { pingDaemon, sendCommand } from './daemon-client';\nimport { isProcessAlive, readPidFile, sendSignal, waitFor } from './utils';\n\n/**\n * Stop the daemon via a `shutdown` RPC call. Falls back to PID + SIGTERM if\n * the socket is unresponsive, and escalates to SIGKILL if SIGTERM is ignored.\n *\n * Signals are sent when EITHER the socket was observed (`responsive` or\n * `unreachable`) OR the recorded PID is still alive on its own. The\n * socket-absent + alive-PID branch trades a small risk of signalling a\n * recycled PID for the larger risk of leaving an orphan daemon holding the\n * SQLite database — which `daemon purge` would otherwise wipe out from\n * under it.\n *\n * @param socketPath - The daemon socket path.\n * @param pidPath - The daemon PID file path.\n * @param log - Optional logging function for status messages.\n * @returns True if the daemon was stopped (or was not running).\n */\nexport async function stopDaemon(\n  socketPath: string,\n  pidPath: string,\n  log?: (message: string) => void,\n): Promise<boolean> {\n  const pid = await readPidFile(pidPath);\n  const ping = await pingDaemon(socketPath);\n  const socketObserved =\n    ping.status === 'responsive' || ping.status === 'unreachable';\n  const processAlive = pid !== undefined && isProcessAlive(pid);\n\n  if (!socketObserved && !processAlive) {\n    // No live daemon evidence. Just remove the stale PID file if any.\n    await cleanupFile(pidPath, 'PID file', log);\n    return true;\n  }\n\n  log?.('Stopping daemon...');\n\n  let stopped = false;\n\n  // Strategy 1: Graceful socket-based shutdown.\n  if (ping.status === 'responsive') {\n    try {\n      await sendCommand({ socketPath, method: 'shutdown' });\n    } catch (error) {\n      log?.(`Graceful shutdown request failed: ${String(error)}`);\n    }\n    // A quiet socket does not prove the process exited; require the recorded\n    // pid to be gone too, so a daemon that outlived its socket falls through to\n    // SIGTERM/SIGKILL rather than being orphaned.\n    stopped = await waitFor(\n      async () =>\n        (await pingDaemon(socketPath)).status !== 'responsive' &&\n        (pid === undefined || !isProcessAlive(pid)),\n      5_000,\n    );\n  }\n\n  // Strategy 2: SIGTERM. Signal when either the socket was observed or the\n  // recorded PID is alive; the absent+alive case typically means someone\n  // removed the socket from under a live daemon.\n  if (!stopped && processAlive && pid !== undefined) {\n    if (!socketObserved) {\n      log?.(\n        `Socket at ${socketPath} is absent but recorded pid ${pid} is alive; signalling anyway.`,\n      );\n    }\n    try {\n      if (sendSignal(pid, 'SIGTERM')) {\n        stopped = await waitFor(() => !isProcessAlive(pid), 5_000);\n      } else {\n        stopped = true; // Process already gone (ESRCH).\n      }\n    } catch (error) {\n      log?.(`SIGTERM failed: ${String(error)}`);\n    }\n  }\n\n  // Strategy 3: SIGKILL.\n  if (!stopped && processAlive && pid !== undefined) {\n    try {\n      if (sendSignal(pid, 'SIGKILL')) {\n        stopped = await waitFor(() => !isProcessAlive(pid), 2_000);\n      } else {\n        stopped = true; // Process already gone (ESRCH).\n      }\n    } catch (error) {\n      log?.(`SIGKILL failed: ${String(error)}`);\n    }\n  }\n\n  if (stopped) {\n    await cleanupFile(pidPath, 'PID file', log);\n    await cleanupFile(socketPath, 'socket file', log);\n    log?.('Daemon stopped.');\n  }\n\n  return stopped;\n}\n\n/**\n * Remove a file best-effort, logging any failure rather than letting it\n * propagate. ENOENT is silently ignored via `force: true`.\n *\n * @param path - The file path to remove.\n * @param label - Human-readable label for log messages.\n * @param log - Optional log sink.\n */\nasync function cleanupFile(\n  path: string,\n  label: string,\n  log: ((message: string) => void) | undefined,\n): Promise<void> {\n  await rm(path, { force: true }).catch((error: unknown) => {\n    log?.(`Failed to remove ${label}: ${String(error)}`);\n  });\n}\n"]}

package/dist/daemon/stop-daemon.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Stop the daemon via a `shutdown` RPC call. Falls back to PID + SIGTERM if
+ * the socket is unresponsive, and escalates to SIGKILL if SIGTERM is ignored.
+ *
+ * Signals are sent when EITHER the socket was observed (`responsive` or
+ * `unreachable`) OR the recorded PID is still alive on its own. The
+ * socket-absent + alive-PID branch trades a small risk of signalling a
+ * recycled PID for the larger risk of leaving an orphan daemon holding the
+ * SQLite database — which `daemon purge` would otherwise wipe out from
+ * under it.
+ *
+ * @param socketPath - The daemon socket path.
+ * @param pidPath - The daemon PID file path.
+ * @param log - Optional logging function for status messages.
+ * @returns True if the daemon was stopped (or was not running).
+ */
+export declare function stopDaemon(socketPath: string, pidPath: string, log?: (message: string) => void): Promise<boolean>;
+//# sourceMappingURL=stop-daemon.d.cts.map

package/dist/daemon/stop-daemon.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-daemon.d.cts","sourceRoot":"","sources":["../../src/daemon/stop-daemon.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,OAAO,CAAC,OAAO,CAAC,CA2ElB"}

package/dist/daemon/stop-daemon.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Stop the daemon via a `shutdown` RPC call. Falls back to PID + SIGTERM if
+ * the socket is unresponsive, and escalates to SIGKILL if SIGTERM is ignored.
+ *
+ * Signals are sent when EITHER the socket was observed (`responsive` or
+ * `unreachable`) OR the recorded PID is still alive on its own. The
+ * socket-absent + alive-PID branch trades a small risk of signalling a
+ * recycled PID for the larger risk of leaving an orphan daemon holding the
+ * SQLite database — which `daemon purge` would otherwise wipe out from
+ * under it.
+ *
+ * @param socketPath - The daemon socket path.
+ * @param pidPath - The daemon PID file path.
+ * @param log - Optional logging function for status messages.
+ * @returns True if the daemon was stopped (or was not running).
+ */
+export declare function stopDaemon(socketPath: string, pidPath: string, log?: (message: string) => void): Promise<boolean>;
+//# sourceMappingURL=stop-daemon.d.mts.map

package/dist/daemon/stop-daemon.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-daemon.d.mts","sourceRoot":"","sources":["../../src/daemon/stop-daemon.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,OAAO,CAAC,OAAO,CAAC,CA2ElB"}

package/dist/daemon/stop-daemon.mjs

@@ -0,0 +1,99 @@
+import { rm } from "node:fs/promises";
+import { pingDaemon, sendCommand } from "./daemon-client.mjs";
+import { isProcessAlive, readPidFile, sendSignal, waitFor } from "./utils.mjs";
+/**
+ * Stop the daemon via a `shutdown` RPC call. Falls back to PID + SIGTERM if
+ * the socket is unresponsive, and escalates to SIGKILL if SIGTERM is ignored.
+ *
+ * Signals are sent when EITHER the socket was observed (`responsive` or
+ * `unreachable`) OR the recorded PID is still alive on its own. The
+ * socket-absent + alive-PID branch trades a small risk of signalling a
+ * recycled PID for the larger risk of leaving an orphan daemon holding the
+ * SQLite database — which `daemon purge` would otherwise wipe out from
+ * under it.
+ *
+ * @param socketPath - The daemon socket path.
+ * @param pidPath - The daemon PID file path.
+ * @param log - Optional logging function for status messages.
+ * @returns True if the daemon was stopped (or was not running).
+ */
+export async function stopDaemon(socketPath, pidPath, log) {
+    const pid = await readPidFile(pidPath);
+    const ping = await pingDaemon(socketPath);
+    const socketObserved = ping.status === 'responsive' || ping.status === 'unreachable';
+    const processAlive = pid !== undefined && isProcessAlive(pid);
+    if (!socketObserved && !processAlive) {
+        // No live daemon evidence. Just remove the stale PID file if any.
+        await cleanupFile(pidPath, 'PID file', log);
+        return true;
+    }
+    log?.('Stopping daemon...');
+    let stopped = false;
+    // Strategy 1: Graceful socket-based shutdown.
+    if (ping.status === 'responsive') {
+        try {
+            await sendCommand({ socketPath, method: 'shutdown' });
+        }
+        catch (error) {
+            log?.(`Graceful shutdown request failed: ${String(error)}`);
+        }
+        // A quiet socket does not prove the process exited; require the recorded
+        // pid to be gone too, so a daemon that outlived its socket falls through to
+        // SIGTERM/SIGKILL rather than being orphaned.
+        stopped = await waitFor(async () => (await pingDaemon(socketPath)).status !== 'responsive' &&
+            (pid === undefined || !isProcessAlive(pid)), 5000);
+    }
+    // Strategy 2: SIGTERM. Signal when either the socket was observed or the
+    // recorded PID is alive; the absent+alive case typically means someone
+    // removed the socket from under a live daemon.
+    if (!stopped && processAlive && pid !== undefined) {
+        if (!socketObserved) {
+            log?.(`Socket at ${socketPath} is absent but recorded pid ${pid} is alive; signalling anyway.`);
+        }
+        try {
+            if (sendSignal(pid, 'SIGTERM')) {
+                stopped = await waitFor(() => !isProcessAlive(pid), 5000);
+            }
+            else {
+                stopped = true; // Process already gone (ESRCH).
+            }
+        }
+        catch (error) {
+            log?.(`SIGTERM failed: ${String(error)}`);
+        }
+    }
+    // Strategy 3: SIGKILL.
+    if (!stopped && processAlive && pid !== undefined) {
+        try {
+            if (sendSignal(pid, 'SIGKILL')) {
+                stopped = await waitFor(() => !isProcessAlive(pid), 2000);
+            }
+            else {
+                stopped = true; // Process already gone (ESRCH).
+            }
+        }
+        catch (error) {
+            log?.(`SIGKILL failed: ${String(error)}`);
+        }
+    }
+    if (stopped) {
+        await cleanupFile(pidPath, 'PID file', log);
+        await cleanupFile(socketPath, 'socket file', log);
+        log?.('Daemon stopped.');
+    }
+    return stopped;
+}
+/**
+ * Remove a file best-effort, logging any failure rather than letting it
+ * propagate. ENOENT is silently ignored via `force: true`.
+ *
+ * @param path - The file path to remove.
+ * @param label - Human-readable label for log messages.
+ * @param log - Optional log sink.
+ */
+async function cleanupFile(path, label, log) {
+    await rm(path, { force: true }).catch((error) => {
+        log?.(`Failed to remove ${label}: ${String(error)}`);
+    });
+}
+//# sourceMappingURL=stop-daemon.mjs.map

package/dist/daemon/stop-daemon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-daemon.mjs","sourceRoot":"","sources":["../../src/daemon/stop-daemon.ts"],"names":[],"mappings":"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","sourcesContent":["import { rm } from 'node:fs/promises';\n\nimport { pingDaemon, sendCommand } from './daemon-client';\nimport { isProcessAlive, readPidFile, sendSignal, waitFor } from './utils';\n\n/**\n * Stop the daemon via a `shutdown` RPC call. Falls back to PID + SIGTERM if\n * the socket is unresponsive, and escalates to SIGKILL if SIGTERM is ignored.\n *\n * Signals are sent when EITHER the socket was observed (`responsive` or\n * `unreachable`) OR the recorded PID is still alive on its own. The\n * socket-absent + alive-PID branch trades a small risk of signalling a\n * recycled PID for the larger risk of leaving an orphan daemon holding the\n * SQLite database — which `daemon purge` would otherwise wipe out from\n * under it.\n *\n * @param socketPath - The daemon socket path.\n * @param pidPath - The daemon PID file path.\n * @param log - Optional logging function for status messages.\n * @returns True if the daemon was stopped (or was not running).\n */\nexport async function stopDaemon(\n  socketPath: string,\n  pidPath: string,\n  log?: (message: string) => void,\n): Promise<boolean> {\n  const pid = await readPidFile(pidPath);\n  const ping = await pingDaemon(socketPath);\n  const socketObserved =\n    ping.status === 'responsive' || ping.status === 'unreachable';\n  const processAlive = pid !== undefined && isProcessAlive(pid);\n\n  if (!socketObserved && !processAlive) {\n    // No live daemon evidence. Just remove the stale PID file if any.\n    await cleanupFile(pidPath, 'PID file', log);\n    return true;\n  }\n\n  log?.('Stopping daemon...');\n\n  let stopped = false;\n\n  // Strategy 1: Graceful socket-based shutdown.\n  if (ping.status === 'responsive') {\n    try {\n      await sendCommand({ socketPath, method: 'shutdown' });\n    } catch (error) {\n      log?.(`Graceful shutdown request failed: ${String(error)}`);\n    }\n    // A quiet socket does not prove the process exited; require the recorded\n    // pid to be gone too, so a daemon that outlived its socket falls through to\n    // SIGTERM/SIGKILL rather than being orphaned.\n    stopped = await waitFor(\n      async () =>\n        (await pingDaemon(socketPath)).status !== 'responsive' &&\n        (pid === undefined || !isProcessAlive(pid)),\n      5_000,\n    );\n  }\n\n  // Strategy 2: SIGTERM. Signal when either the socket was observed or the\n  // recorded PID is alive; the absent+alive case typically means someone\n  // removed the socket from under a live daemon.\n  if (!stopped && processAlive && pid !== undefined) {\n    if (!socketObserved) {\n      log?.(\n        `Socket at ${socketPath} is absent but recorded pid ${pid} is alive; signalling anyway.`,\n      );\n    }\n    try {\n      if (sendSignal(pid, 'SIGTERM')) {\n        stopped = await waitFor(() => !isProcessAlive(pid), 5_000);\n      } else {\n        stopped = true; // Process already gone (ESRCH).\n      }\n    } catch (error) {\n      log?.(`SIGTERM failed: ${String(error)}`);\n    }\n  }\n\n  // Strategy 3: SIGKILL.\n  if (!stopped && processAlive && pid !== undefined) {\n    try {\n      if (sendSignal(pid, 'SIGKILL')) {\n        stopped = await waitFor(() => !isProcessAlive(pid), 2_000);\n      } else {\n        stopped = true; // Process already gone (ESRCH).\n      }\n    } catch (error) {\n      log?.(`SIGKILL failed: ${String(error)}`);\n    }\n  }\n\n  if (stopped) {\n    await cleanupFile(pidPath, 'PID file', log);\n    await cleanupFile(socketPath, 'socket file', log);\n    log?.('Daemon stopped.');\n  }\n\n  return stopped;\n}\n\n/**\n * Remove a file best-effort, logging any failure rather than letting it\n * propagate. ENOENT is silently ignored via `force: true`.\n *\n * @param path - The file path to remove.\n * @param label - Human-readable label for log messages.\n * @param log - Optional log sink.\n */\nasync function cleanupFile(\n  path: string,\n  label: string,\n  log: ((message: string) => void) | undefined,\n): Promise<void> {\n  await rm(path, { force: true }).catch((error: unknown) => {\n    log?.(`Failed to remove ${label}: ${String(error)}`);\n  });\n}\n"]}

package/dist/daemon/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Resolved paths for daemon state files.\n */\nexport type DaemonPaths = {\n  socketPath: string;\n  pidPath: string;\n  logPath: string;\n  dbPath: string;\n};\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * A function that handles a JSON-RPC method call.\n *\n * The `params` argument will be `null` if the client did not provide params.\n */\nexport type RpcHandler = (params: Json) => Promise<Json | void>;\n\n/**\n * A map of RPC method names to their handler functions.\n */\nexport type RpcHandlerMap = Record<string, RpcHandler>;\n\n/**\n * Resolved paths for daemon state files.\n */\nexport type DaemonPaths = {\n  socketPath: string;\n  pidPath: string;\n  logPath: string;\n  dbPath: string;\n};\n\n/**\n * Status information returned by the daemon's `getStatus` RPC method.\n */\nexport type DaemonStatusInfo = {\n  pid: number;\n  uptime: number;\n};\n\n/**\n * Configuration passed to the daemon spawner.\n */\nexport type DaemonSpawnConfig = {\n  dataDir: string;\n  infuraProjectId: string;\n  password: string;\n  srp: string;\n  packageRoot: string;\n};\n"]}

package/dist/daemon/types.d.cts

@@ -1,3 +1,14 @@
+import type { Json } from "@metamask/utils";
+/**
+ * A function that handles a JSON-RPC method call.
+ *
+ * The `params` argument will be `null` if the client did not provide params.
+ */
+export type RpcHandler = (params: Json) => Promise<Json | void>;
+/**
+ * A map of RPC method names to their handler functions.
+ */
+export type RpcHandlerMap = Record<string, RpcHandler>;
 /**
  * Resolved paths for daemon state files.
  */
@@ -7,4 +18,21 @@ export type DaemonPaths = {
     logPath: string;
     dbPath: string;
 };
+/**
+ * Status information returned by the daemon's `getStatus` RPC method.
+ */
+export type DaemonStatusInfo = {
+    pid: number;
+    uptime: number;
+};
+/**
+ * Configuration passed to the daemon spawner.
+ */
+export type DaemonSpawnConfig = {
+    dataDir: string;
+    infuraProjectId: string;
+    password: string;
+    srp: string;
+    packageRoot: string;
+};
 //# sourceMappingURL=types.d.cts.map

package/dist/daemon/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/daemon/types.d.mts

@@ -1,3 +1,14 @@
+import type { Json } from "@metamask/utils";
+/**
+ * A function that handles a JSON-RPC method call.
+ *
+ * The `params` argument will be `null` if the client did not provide params.
+ */
+export type RpcHandler = (params: Json) => Promise<Json | void>;
+/**
+ * A map of RPC method names to their handler functions.
+ */
+export type RpcHandlerMap = Record<string, RpcHandler>;
 /**
  * Resolved paths for daemon state files.
  */
@@ -7,4 +18,21 @@ export type DaemonPaths = {
     logPath: string;
     dbPath: string;
 };
+/**
+ * Status information returned by the daemon's `getStatus` RPC method.
+ */
+export type DaemonStatusInfo = {
+    pid: number;
+    uptime: number;
+};
+/**
+ * Configuration passed to the daemon spawner.
+ */
+export type DaemonSpawnConfig = {
+    dataDir: string;
+    infuraProjectId: string;
+    password: string;
+    srp: string;
+    packageRoot: string;
+};
 //# sourceMappingURL=types.d.mts.map

package/dist/daemon/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/daemon/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Resolved paths for daemon state files.\n */\nexport type DaemonPaths = {\n  socketPath: string;\n  pidPath: string;\n  logPath: string;\n  dbPath: string;\n};\n"]}
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/daemon/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * A function that handles a JSON-RPC method call.\n *\n * The `params` argument will be `null` if the client did not provide params.\n */\nexport type RpcHandler = (params: Json) => Promise<Json | void>;\n\n/**\n * A map of RPC method names to their handler functions.\n */\nexport type RpcHandlerMap = Record<string, RpcHandler>;\n\n/**\n * Resolved paths for daemon state files.\n */\nexport type DaemonPaths = {\n  socketPath: string;\n  pidPath: string;\n  logPath: string;\n  dbPath: string;\n};\n\n/**\n * Status information returned by the daemon's `getStatus` RPC method.\n */\nexport type DaemonStatusInfo = {\n  pid: number;\n  uptime: number;\n};\n\n/**\n * Configuration passed to the daemon spawner.\n */\nexport type DaemonSpawnConfig = {\n  dataDir: string;\n  infuraProjectId: string;\n  password: string;\n  srp: string;\n  packageRoot: string;\n};\n"]}

package/dist/daemon/utils.cjs

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitFor = exports.sendSignal = exports.isProcessAlive = exports.readPidFile = exports.isErrorWithCode = void 0;
+const utils_1 = require("@metamask/utils");
+const promises_1 = require("node:fs/promises");
+/**
+ * Check whether an unknown error is a Node.js system error with the given code.
+ *
+ * @param error - The error to check.
+ * @param code - The expected error code (e.g. 'ENOENT', 'EPERM').
+ * @returns True if the error matches the code.
+ */
+function isErrorWithCode(error, code) {
+    return (0, utils_1.isErrorWithCode)(error) && error.code === code;
+}
+exports.isErrorWithCode = isErrorWithCode;
+/**
+ * Read a PID from a file. The file may contain just the PID, or the PID on
+ * the first line followed by additional metadata (e.g. start time written by
+ * the daemon).
+ *
+ * @param pidPath - The PID file path.
+ * @returns The PID, or undefined if the file is missing or its first line is
+ * not a positive integer.
+ */
+async function readPidFile(pidPath) {
+    let contents;
+    try {
+        contents = await (0, promises_1.readFile)(pidPath, 'utf-8');
+    }
+    catch (error) {
+        if (isErrorWithCode(error, 'ENOENT')) {
+            return undefined;
+        }
+        throw error;
+    }
+    // String.prototype.split always returns at least one element, so [0] is safe.
+    const pid = Number(contents.split('\n')[0].trim());
+    return Number.isInteger(pid) && pid > 0 ? pid : undefined;
+}
+exports.readPidFile = readPidFile;
+/**
+ * Check whether a process is alive by sending signal 0.
+ *
+ * Treats `ESRCH` as "process is gone", `EPERM` as "process exists but we
+ * cannot signal it" (still alive from our perspective), and rethrows
+ * anything else so the caller can surface unexpected failures rather than
+ * silently assuming the process is dead.
+ *
+ * @param pid - The process ID to check.
+ * @returns True if the process exists.
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (isErrorWithCode(error, 'ESRCH')) {
+            return false;
+        }
+        if (isErrorWithCode(error, 'EPERM')) {
+            return true;
+        }
+        throw error;
+    }
+}
+exports.isProcessAlive = isProcessAlive;
+/**
+ * Send a signal to a process. Returns true if the signal was sent, false if
+ * the process does not exist (ESRCH). Re-throws on permission errors and
+ * other failures.
+ *
+ * @param pid - The process ID.
+ * @param signal - The signal to send.
+ * @returns True if the signal was delivered, false if the process is gone.
+ */
+function sendSignal(pid, signal) {
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch (error) {
+        if (isErrorWithCode(error, 'ESRCH')) {
+            return false;
+        }
+        throw error;
+    }
+}
+exports.sendSignal = sendSignal;
+/**
+ * Poll until a condition is met or the timeout elapses.
+ *
+ * @param check - A function that returns true when the condition is met.
+ * @param timeoutMs - Maximum time to wait in milliseconds.
+ * @returns True if the condition was met, false on timeout.
+ */
+async function waitFor(check, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await check()) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    return false;
+}
+exports.waitFor = waitFor;
+//# sourceMappingURL=utils.cjs.map

package/dist/daemon/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/daemon/utils.ts"],"names":[],"mappings":";;;AAAA,2CAAkE;AAClE,+CAA4C;AAE5C;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,KAAc,EAAE,IAAY;IAC1D,OAAO,IAAA,uBAAY,EAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AACpD,CAAC;AAFD,0CAEC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAe;IAEf,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAA,mBAAQ,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,8EAA8E;IAC9E,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAfD,kCAeC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAbD,wCAaC;AAED;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,GAAW,EAAE,MAAsB;IAC5D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAVD,gCAUC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,OAAO,CAC3B,KAAuC,EACvC,SAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAZD,0BAYC","sourcesContent":["import { isErrorWithCode as hasErrorCode } from '@metamask/utils';\nimport { readFile } from 'node:fs/promises';\n\n/**\n * Check whether an unknown error is a Node.js system error with the given code.\n *\n * @param error - The error to check.\n * @param code - The expected error code (e.g. 'ENOENT', 'EPERM').\n * @returns True if the error matches the code.\n */\nexport function isErrorWithCode(error: unknown, code: string): boolean {\n  return hasErrorCode(error) && error.code === code;\n}\n\n/**\n * Read a PID from a file. The file may contain just the PID, or the PID on\n * the first line followed by additional metadata (e.g. start time written by\n * the daemon).\n *\n * @param pidPath - The PID file path.\n * @returns The PID, or undefined if the file is missing or its first line is\n * not a positive integer.\n */\nexport async function readPidFile(\n  pidPath: string,\n): Promise<number | undefined> {\n  let contents: string;\n  try {\n    contents = await readFile(pidPath, 'utf-8');\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ENOENT')) {\n      return undefined;\n    }\n    throw error;\n  }\n  // String.prototype.split always returns at least one element, so [0] is safe.\n  const pid = Number(contents.split('\\n')[0].trim());\n  return Number.isInteger(pid) && pid > 0 ? pid : undefined;\n}\n\n/**\n * Check whether a process is alive by sending signal 0.\n *\n * Treats `ESRCH` as \"process is gone\", `EPERM` as \"process exists but we\n * cannot signal it\" (still alive from our perspective), and rethrows\n * anything else so the caller can surface unexpected failures rather than\n * silently assuming the process is dead.\n *\n * @param pid - The process ID to check.\n * @returns True if the process exists.\n */\nexport function isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ESRCH')) {\n      return false;\n    }\n    if (isErrorWithCode(error, 'EPERM')) {\n      return true;\n    }\n    throw error;\n  }\n}\n\n/**\n * Send a signal to a process. Returns true if the signal was sent, false if\n * the process does not exist (ESRCH). Re-throws on permission errors and\n * other failures.\n *\n * @param pid - The process ID.\n * @param signal - The signal to send.\n * @returns True if the signal was delivered, false if the process is gone.\n */\nexport function sendSignal(pid: number, signal: NodeJS.Signals): boolean {\n  try {\n    process.kill(pid, signal);\n    return true;\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ESRCH')) {\n      return false;\n    }\n    throw error;\n  }\n}\n\n/**\n * Poll until a condition is met or the timeout elapses.\n *\n * @param check - A function that returns true when the condition is met.\n * @param timeoutMs - Maximum time to wait in milliseconds.\n * @returns True if the condition was met, false on timeout.\n */\nexport async function waitFor(\n  check: () => boolean | Promise<boolean>,\n  timeoutMs: number,\n): Promise<boolean> {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() < deadline) {\n    if (await check()) {\n      return true;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 250));\n  }\n  return false;\n}\n"]}

package/dist/daemon/utils.d.cts

@@ -0,0 +1,50 @@
+/// <reference types="node" />
+/**
+ * Check whether an unknown error is a Node.js system error with the given code.
+ *
+ * @param error - The error to check.
+ * @param code - The expected error code (e.g. 'ENOENT', 'EPERM').
+ * @returns True if the error matches the code.
+ */
+export declare function isErrorWithCode(error: unknown, code: string): boolean;
+/**
+ * Read a PID from a file. The file may contain just the PID, or the PID on
+ * the first line followed by additional metadata (e.g. start time written by
+ * the daemon).
+ *
+ * @param pidPath - The PID file path.
+ * @returns The PID, or undefined if the file is missing or its first line is
+ * not a positive integer.
+ */
+export declare function readPidFile(pidPath: string): Promise<number | undefined>;
+/**
+ * Check whether a process is alive by sending signal 0.
+ *
+ * Treats `ESRCH` as "process is gone", `EPERM` as "process exists but we
+ * cannot signal it" (still alive from our perspective), and rethrows
+ * anything else so the caller can surface unexpected failures rather than
+ * silently assuming the process is dead.
+ *
+ * @param pid - The process ID to check.
+ * @returns True if the process exists.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Send a signal to a process. Returns true if the signal was sent, false if
+ * the process does not exist (ESRCH). Re-throws on permission errors and
+ * other failures.
+ *
+ * @param pid - The process ID.
+ * @param signal - The signal to send.
+ * @returns True if the signal was delivered, false if the process is gone.
+ */
+export declare function sendSignal(pid: number, signal: NodeJS.Signals): boolean;
+/**
+ * Poll until a condition is met or the timeout elapses.
+ *
+ * @param check - A function that returns true when the condition is met.
+ * @param timeoutMs - Maximum time to wait in milliseconds.
+ * @returns True if the condition was met, false on timeout.
+ */
+export declare function waitFor(check: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean>;
+//# sourceMappingURL=utils.d.cts.map

package/dist/daemon/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/daemon/utils.ts"],"names":[],"mappings":";AAGA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAUvE;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/daemon/utils.d.mts

@@ -0,0 +1,50 @@
+/// <reference types="node" />
+/**
+ * Check whether an unknown error is a Node.js system error with the given code.
+ *
+ * @param error - The error to check.
+ * @param code - The expected error code (e.g. 'ENOENT', 'EPERM').
+ * @returns True if the error matches the code.
+ */
+export declare function isErrorWithCode(error: unknown, code: string): boolean;
+/**
+ * Read a PID from a file. The file may contain just the PID, or the PID on
+ * the first line followed by additional metadata (e.g. start time written by
+ * the daemon).
+ *
+ * @param pidPath - The PID file path.
+ * @returns The PID, or undefined if the file is missing or its first line is
+ * not a positive integer.
+ */
+export declare function readPidFile(pidPath: string): Promise<number | undefined>;
+/**
+ * Check whether a process is alive by sending signal 0.
+ *
+ * Treats `ESRCH` as "process is gone", `EPERM` as "process exists but we
+ * cannot signal it" (still alive from our perspective), and rethrows
+ * anything else so the caller can surface unexpected failures rather than
+ * silently assuming the process is dead.
+ *
+ * @param pid - The process ID to check.
+ * @returns True if the process exists.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Send a signal to a process. Returns true if the signal was sent, false if
+ * the process does not exist (ESRCH). Re-throws on permission errors and
+ * other failures.
+ *
+ * @param pid - The process ID.
+ * @param signal - The signal to send.
+ * @returns True if the signal was delivered, false if the process is gone.
+ */
+export declare function sendSignal(pid: number, signal: NodeJS.Signals): boolean;
+/**
+ * Poll until a condition is met or the timeout elapses.
+ *
+ * @param check - A function that returns true when the condition is met.
+ * @param timeoutMs - Maximum time to wait in milliseconds.
+ * @returns True if the condition was met, false on timeout.
+ */
+export declare function waitFor(check: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean>;
+//# sourceMappingURL=utils.d.mts.map

package/dist/daemon/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/daemon/utils.ts"],"names":[],"mappings":";AAGA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAUvE;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB"}