@metamask-previews/wallet-cli 0.0.0-preview-9de9aa4 → 0.0.0-preview-b2742a2fc

package/CHANGELOG.md

@@ -9,8 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Add a daemon transport layer: a JSON-RPC client and server over a Unix socket, plus daemon spawn/stop lifecycle helpers ([#9108](https://github.com/MetaMask/core/pull/9108))
 - Add SQLite-backed persistence for wallet controller state ([#9067](https://github.com/MetaMask/core/pull/9067))
+  - A `KeyValueStore` backed by `better-sqlite3` for synchronous reads and writes.
+  - `loadState` to rehydrate persist-flagged controller state from the store and `subscribeToChanges` to write persist-flagged controller state through to disk on every `stateChanged` event.
 - Initial package scaffold for `@metamask/wallet-cli`, an [oclif](https://oclif.io)-based `mm` CLI for `@metamask/wallet` ([#9065](https://github.com/MetaMask/core/pull/9065)).
 
 ### Changed

package/dist/daemon/types.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"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"]}

package/dist/daemon/types.d.cts

@@ -1,14 +1,3 @@
-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.
  */
@@ -18,21 +7,4 @@ 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,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"}
+{"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"}

package/dist/daemon/types.d.mts

@@ -1,14 +1,3 @@
-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.
  */
@@ -18,21 +7,4 @@ 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,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"}
+{"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"}

package/dist/daemon/types.mjs.map

@@ -1 +1 @@
-{"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"]}
+{"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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/wallet-cli",
-  "version": "0.0.0-preview-9de9aa4",
+  "version": "0.0.0-preview-b2742a2fc",
   "description": "The CLI of @metamask/wallet",
   "keywords": [
     "Ethereum",
@@ -43,9 +43,7 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "dependencies": {
-    "@inquirer/confirm": "^6.0.11",
     "@metamask/base-controller": "^9.1.0",
-    "@metamask/rpc-errors": "^7.0.2",
     "@metamask/utils": "^11.11.0",
     "@metamask/wallet": "^4.0.0",
     "@oclif/core": "^4.10.5",

package/dist/daemon/daemon-client.cjs

@@ -1,140 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pingDaemon = exports.sendCommand = void 0;
-const utils_1 = require("@metamask/utils");
-const node_crypto_1 = require("node:crypto");
-const node_net_1 = require("node:net");
-const socket_line_1 = require("./socket-line.cjs");
-const utils_2 = require("./utils.cjs");
-const DEFAULT_TIMEOUT_MS = 30000;
-async function connectSocket(socketPath) {
-    return new Promise((resolve, reject) => {
-        const socket = (0, node_net_1.createConnection)(socketPath, () => {
-            socket.removeAllListeners('error');
-            resolve(socket);
-        });
-        socket.on('error', (error) => {
-            // A failed connect never reaches the caller, so destroy the socket here
-            // to avoid leaking its file descriptor.
-            socket.destroy();
-            reject(error);
-        });
-    });
-}
-/**
- * Send a JSON-RPC request to the daemon over a Unix socket and return the
- * response.
- *
- * Opens a connection, writes one JSON-RPC request line, reads one JSON-RPC
- * response line, then closes the connection. Retries once after a short delay
- * on transient connection errors (ECONNREFUSED, ECONNRESET). Verifies that the
- * response `id` matches the outgoing request `id`.
- *
- * @param options - Command options.
- * @param options.socketPath - The Unix socket path.
- * @param options.method - The RPC method name.
- * @param options.params - Optional method parameters.
- * @param options.timeoutMs - Read timeout in milliseconds.
- * @returns The parsed JSON-RPC response.
- */
-async function sendCommand({ socketPath, method, params, timeoutMs, }) {
-    const id = (0, node_crypto_1.randomUUID)();
-    const request = {
-        jsonrpc: '2.0',
-        id,
-        method,
-        ...(params === undefined ? {} : { params }),
-    };
-    const effectiveTimeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const attempt = async () => {
-        const socket = await connectSocket(socketPath);
-        try {
-            await (0, socket_line_1.writeLine)(socket, JSON.stringify(request));
-            const responseLine = await (0, socket_line_1.readLine)(socket, effectiveTimeout);
-            const parsed = JSON.parse(responseLine);
-            (0, utils_1.assertIsJsonRpcResponse)(parsed);
-            if (parsed.id !== id) {
-                throw new Error(`JSON-RPC response id ${JSON.stringify(parsed.id)} does not match request id ${JSON.stringify(id)}`);
-            }
-            return parsed;
-        }
-        finally {
-            socket.destroy();
-        }
-    };
-    try {
-        return await attempt();
-    }
-    catch (error) {
-        if (!(0, utils_2.isErrorWithCode)(error, 'ECONNREFUSED') &&
-            !(0, utils_2.isErrorWithCode)(error, 'ECONNRESET')) {
-            throw error;
-        }
-        await new Promise((resolve) => setTimeout(resolve, 100));
-        return attempt();
-    }
-}
-exports.sendCommand = sendCommand;
-/**
- * Normalize an unknown throw into a real Error instance so that downstream
- * consumers (which read `.message`) cannot crash on string/object throws.
- *
- * @param error - The caught value.
- * @returns An Error mirroring the caught value.
- */
-function toError(error) {
-    return error instanceof Error ? error : new Error(String(error));
-}
-/**
- * Categorise an unreachable error by Node errno / message shape so callers can
- * make decisions per failure mode rather than parsing message strings.
- *
- * @param error - The caught value.
- * @returns A {@link PingUnreachableReason} label.
- */
-function classifyUnreachable(error) {
-    if ((0, utils_2.isErrorWithCode)(error, 'ECONNREFUSED') ||
-        (0, utils_2.isErrorWithCode)(error, 'ECONNRESET')) {
-        return 'refused';
-    }
-    if ((0, utils_2.isErrorWithCode)(error, 'EACCES') || (0, utils_2.isErrorWithCode)(error, 'EPERM')) {
-        return 'permission';
-    }
-    if (error instanceof Error && error.message === 'Socket read timed out') {
-        return 'timeout';
-    }
-    if (error instanceof Error &&
-        (error.message.includes('JSON-RPC response id') ||
-            /Expected .* JSON-RPC/u.test(error.message) ||
-            error.name === 'SyntaxError')) {
-        return 'protocol';
-    }
-    return 'other';
-}
-/**
- * Check whether the daemon is running by sending a lightweight `getStatus`
- * RPC call. Distinguishes "no daemon present" (socket file missing) from
- * "daemon present but unreachable" (socket file exists but the daemon is
- * wedged, mid-shutdown, or owned by a different user).
- *
- * @param socketPath - The Unix socket path.
- * @returns A {@link PingResult} describing the daemon's reachability.
- */
-async function pingDaemon(socketPath) {
-    try {
-        await sendCommand({ socketPath, method: 'getStatus', timeoutMs: 3000 });
-        return { status: 'responsive' };
-    }
-    catch (error) {
-        if ((0, utils_2.isErrorWithCode)(error, 'ENOENT')) {
-            return { status: 'absent' };
-        }
-        return {
-            status: 'unreachable',
-            reason: classifyUnreachable(error),
-            error: toError(error),
-        };
-    }
-}
-exports.pingDaemon = pingDaemon;
-//# sourceMappingURL=daemon-client.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"daemon-client.cjs","sourceRoot":"","sources":["../../src/daemon/daemon-client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonRpcParams, JsonRpcResponse } from '@metamask/utils';\nimport { assertIsJsonRpcResponse } from '@metamask/utils';\nimport { randomUUID } from 'node:crypto';\nimport { createConnection } from 'node:net';\nimport type { Socket } from 'node:net';\n\nimport { readLine, writeLine } from './socket-line';\nimport { isErrorWithCode } from './utils';\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\n/**\n * Options for {@link sendCommand}.\n */\ntype SendCommandOptions = {\n  /** The Unix socket path. */\n  socketPath: string;\n  /** The RPC method name. */\n  method: string;\n  /** Optional method parameters (object or positional array). */\n  params?: JsonRpcParams | undefined;\n  /** Response read timeout in milliseconds (default: 30 000). */\n  timeoutMs?: number | undefined;\n};\n\nasync function connectSocket(socketPath: string): Promise<Socket> {\n  return new Promise((resolve, reject) => {\n    const socket = createConnection(socketPath, () => {\n      socket.removeAllListeners('error');\n      resolve(socket);\n    });\n    socket.on('error', (error) => {\n      // A failed connect never reaches the caller, so destroy the socket here\n      // to avoid leaking its file descriptor.\n      socket.destroy();\n      reject(error);\n    });\n  });\n}\n\n/**\n * Send a JSON-RPC request to the daemon over a Unix socket and return the\n * response.\n *\n * Opens a connection, writes one JSON-RPC request line, reads one JSON-RPC\n * response line, then closes the connection. Retries once after a short delay\n * on transient connection errors (ECONNREFUSED, ECONNRESET). Verifies that the\n * response `id` matches the outgoing request `id`.\n *\n * @param options - Command options.\n * @param options.socketPath - The Unix socket path.\n * @param options.method - The RPC method name.\n * @param options.params - Optional method parameters.\n * @param options.timeoutMs - Read timeout in milliseconds.\n * @returns The parsed JSON-RPC response.\n */\nexport async function sendCommand({\n  socketPath,\n  method,\n  params,\n  timeoutMs,\n}: SendCommandOptions): Promise<JsonRpcResponse> {\n  const id = randomUUID();\n  const request = {\n    jsonrpc: '2.0',\n    id,\n    method,\n    ...(params === undefined ? {} : { params }),\n  };\n\n  const effectiveTimeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n  const attempt = async (): Promise<JsonRpcResponse> => {\n    const socket = await connectSocket(socketPath);\n    try {\n      await writeLine(socket, JSON.stringify(request));\n      const responseLine = await readLine(socket, effectiveTimeout);\n      const parsed: unknown = JSON.parse(responseLine);\n      assertIsJsonRpcResponse(parsed);\n      if (parsed.id !== id) {\n        throw new Error(\n          `JSON-RPC response id ${JSON.stringify(parsed.id)} does not match request id ${JSON.stringify(id)}`,\n        );\n      }\n      return parsed;\n    } finally {\n      socket.destroy();\n    }\n  };\n\n  try {\n    return await attempt();\n  } catch (error: unknown) {\n    if (\n      !isErrorWithCode(error, 'ECONNREFUSED') &&\n      !isErrorWithCode(error, 'ECONNRESET')\n    ) {\n      throw error;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 100));\n    return attempt();\n  }\n}\n\n/**\n * Why an unreachable daemon cannot be queried.\n *\n * - `'refused'`: connection refused after retry (`ECONNREFUSED` / `ECONNRESET`).\n *   Typical of a daemon that has crashed or is mid-restart.\n * - `'timeout'`: the daemon accepted the connection but did not respond within\n *   the read timeout — most likely wedged on a long-running operation.\n * - `'permission'`: the socket exists but cannot be opened (`EACCES` / `EPERM`).\n *   The daemon almost certainly belongs to another user.\n * - `'protocol'`: the daemon responded but the response did not parse as a\n *   valid JSON-RPC response, or the response id did not match.\n * - `'other'`: anything else.\n */\nexport type PingUnreachableReason =\n  | 'refused'\n  | 'timeout'\n  | 'permission'\n  | 'protocol'\n  | 'other';\n\n/**\n * Outcome of a daemon health check.\n *\n * - `'responsive'`: the daemon answered a `getStatus` RPC.\n * - `'absent'`: the socket connect attempt failed with `ENOENT`, i.e. no\n *   socket file exists at the path. No daemon present.\n * - `'unreachable'`: any other non-success outcome. The daemon may still be\n *   alive but is not responding. Callers should not silently take over the\n *   slot or assume the daemon is dead. The `reason` field categorises the\n *   failure so callers can distinguish a wedged sibling daemon from a\n *   foreign-user daemon from a transient crash. User-initiated stop / purge\n *   flows may still escalate to signals against the recorded PID.\n */\nexport type PingResult =\n  | { status: 'responsive' }\n  | { status: 'absent' }\n  | { status: 'unreachable'; reason: PingUnreachableReason; error: Error };\n\n/**\n * Normalize an unknown throw into a real Error instance so that downstream\n * consumers (which read `.message`) cannot crash on string/object throws.\n *\n * @param error - The caught value.\n * @returns An Error mirroring the caught value.\n */\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\n/**\n * Categorise an unreachable error by Node errno / message shape so callers can\n * make decisions per failure mode rather than parsing message strings.\n *\n * @param error - The caught value.\n * @returns A {@link PingUnreachableReason} label.\n */\nfunction classifyUnreachable(error: unknown): PingUnreachableReason {\n  if (\n    isErrorWithCode(error, 'ECONNREFUSED') ||\n    isErrorWithCode(error, 'ECONNRESET')\n  ) {\n    return 'refused';\n  }\n  if (isErrorWithCode(error, 'EACCES') || isErrorWithCode(error, 'EPERM')) {\n    return 'permission';\n  }\n  if (error instanceof Error && error.message === 'Socket read timed out') {\n    return 'timeout';\n  }\n  if (\n    error instanceof Error &&\n    (error.message.includes('JSON-RPC response id') ||\n      /Expected .* JSON-RPC/u.test(error.message) ||\n      error.name === 'SyntaxError')\n  ) {\n    return 'protocol';\n  }\n  return 'other';\n}\n\n/**\n * Check whether the daemon is running by sending a lightweight `getStatus`\n * RPC call. Distinguishes \"no daemon present\" (socket file missing) from\n * \"daemon present but unreachable\" (socket file exists but the daemon is\n * wedged, mid-shutdown, or owned by a different user).\n *\n * @param socketPath - The Unix socket path.\n * @returns A {@link PingResult} describing the daemon's reachability.\n */\nexport async function pingDaemon(socketPath: string): Promise<PingResult> {\n  try {\n    await sendCommand({ socketPath, method: 'getStatus', timeoutMs: 3_000 });\n    return { status: 'responsive' };\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ENOENT')) {\n      return { status: 'absent' };\n    }\n    return {\n      status: 'unreachable',\n      reason: classifyUnreachable(error),\n      error: toError(error),\n    };\n  }\n}\n"]}

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

@@ -1,79 +0,0 @@
-import type { JsonRpcParams, JsonRpcResponse } from "@metamask/utils";
-/**
- * Options for {@link sendCommand}.
- */
-type SendCommandOptions = {
-    /** The Unix socket path. */
-    socketPath: string;
-    /** The RPC method name. */
-    method: string;
-    /** Optional method parameters (object or positional array). */
-    params?: JsonRpcParams | undefined;
-    /** Response read timeout in milliseconds (default: 30 000). */
-    timeoutMs?: number | undefined;
-};
-/**
- * Send a JSON-RPC request to the daemon over a Unix socket and return the
- * response.
- *
- * Opens a connection, writes one JSON-RPC request line, reads one JSON-RPC
- * response line, then closes the connection. Retries once after a short delay
- * on transient connection errors (ECONNREFUSED, ECONNRESET). Verifies that the
- * response `id` matches the outgoing request `id`.
- *
- * @param options - Command options.
- * @param options.socketPath - The Unix socket path.
- * @param options.method - The RPC method name.
- * @param options.params - Optional method parameters.
- * @param options.timeoutMs - Read timeout in milliseconds.
- * @returns The parsed JSON-RPC response.
- */
-export declare function sendCommand({ socketPath, method, params, timeoutMs, }: SendCommandOptions): Promise<JsonRpcResponse>;
-/**
- * Why an unreachable daemon cannot be queried.
- *
- * - `'refused'`: connection refused after retry (`ECONNREFUSED` / `ECONNRESET`).
- *   Typical of a daemon that has crashed or is mid-restart.
- * - `'timeout'`: the daemon accepted the connection but did not respond within
- *   the read timeout — most likely wedged on a long-running operation.
- * - `'permission'`: the socket exists but cannot be opened (`EACCES` / `EPERM`).
- *   The daemon almost certainly belongs to another user.
- * - `'protocol'`: the daemon responded but the response did not parse as a
- *   valid JSON-RPC response, or the response id did not match.
- * - `'other'`: anything else.
- */
-export type PingUnreachableReason = 'refused' | 'timeout' | 'permission' | 'protocol' | 'other';
-/**
- * Outcome of a daemon health check.
- *
- * - `'responsive'`: the daemon answered a `getStatus` RPC.
- * - `'absent'`: the socket connect attempt failed with `ENOENT`, i.e. no
- *   socket file exists at the path. No daemon present.
- * - `'unreachable'`: any other non-success outcome. The daemon may still be
- *   alive but is not responding. Callers should not silently take over the
- *   slot or assume the daemon is dead. The `reason` field categorises the
- *   failure so callers can distinguish a wedged sibling daemon from a
- *   foreign-user daemon from a transient crash. User-initiated stop / purge
- *   flows may still escalate to signals against the recorded PID.
- */
-export type PingResult = {
-    status: 'responsive';
-} | {
-    status: 'absent';
-} | {
-    status: 'unreachable';
-    reason: PingUnreachableReason;
-    error: Error;
-};
-/**
- * Check whether the daemon is running by sending a lightweight `getStatus`
- * RPC call. Distinguishes "no daemon present" (socket file missing) from
- * "daemon present but unreachable" (socket file exists but the daemon is
- * wedged, mid-shutdown, or owned by a different user).
- *
- * @param socketPath - The Unix socket path.
- * @returns A {@link PingResult} describing the daemon's reachability.
- */
-export declare function pingDaemon(socketPath: string): Promise<PingResult>;
-export {};
-//# sourceMappingURL=daemon-client.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"daemon-client.d.cts","sourceRoot":"","sources":["../../src/daemon/daemon-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,wBAAwB;AAWtE;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACxB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACnC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAiBF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAAC,EAChC,UAAU,EACV,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyC/C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,SAAS,GACT,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AA4C3E;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAcxE"}

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

@@ -1,79 +0,0 @@
-import type { JsonRpcParams, JsonRpcResponse } from "@metamask/utils";
-/**
- * Options for {@link sendCommand}.
- */
-type SendCommandOptions = {
-    /** The Unix socket path. */
-    socketPath: string;
-    /** The RPC method name. */
-    method: string;
-    /** Optional method parameters (object or positional array). */
-    params?: JsonRpcParams | undefined;
-    /** Response read timeout in milliseconds (default: 30 000). */
-    timeoutMs?: number | undefined;
-};
-/**
- * Send a JSON-RPC request to the daemon over a Unix socket and return the
- * response.
- *
- * Opens a connection, writes one JSON-RPC request line, reads one JSON-RPC
- * response line, then closes the connection. Retries once after a short delay
- * on transient connection errors (ECONNREFUSED, ECONNRESET). Verifies that the
- * response `id` matches the outgoing request `id`.
- *
- * @param options - Command options.
- * @param options.socketPath - The Unix socket path.
- * @param options.method - The RPC method name.
- * @param options.params - Optional method parameters.
- * @param options.timeoutMs - Read timeout in milliseconds.
- * @returns The parsed JSON-RPC response.
- */
-export declare function sendCommand({ socketPath, method, params, timeoutMs, }: SendCommandOptions): Promise<JsonRpcResponse>;
-/**
- * Why an unreachable daemon cannot be queried.
- *
- * - `'refused'`: connection refused after retry (`ECONNREFUSED` / `ECONNRESET`).
- *   Typical of a daemon that has crashed or is mid-restart.
- * - `'timeout'`: the daemon accepted the connection but did not respond within
- *   the read timeout — most likely wedged on a long-running operation.
- * - `'permission'`: the socket exists but cannot be opened (`EACCES` / `EPERM`).
- *   The daemon almost certainly belongs to another user.
- * - `'protocol'`: the daemon responded but the response did not parse as a
- *   valid JSON-RPC response, or the response id did not match.
- * - `'other'`: anything else.
- */
-export type PingUnreachableReason = 'refused' | 'timeout' | 'permission' | 'protocol' | 'other';
-/**
- * Outcome of a daemon health check.
- *
- * - `'responsive'`: the daemon answered a `getStatus` RPC.
- * - `'absent'`: the socket connect attempt failed with `ENOENT`, i.e. no
- *   socket file exists at the path. No daemon present.
- * - `'unreachable'`: any other non-success outcome. The daemon may still be
- *   alive but is not responding. Callers should not silently take over the
- *   slot or assume the daemon is dead. The `reason` field categorises the
- *   failure so callers can distinguish a wedged sibling daemon from a
- *   foreign-user daemon from a transient crash. User-initiated stop / purge
- *   flows may still escalate to signals against the recorded PID.
- */
-export type PingResult = {
-    status: 'responsive';
-} | {
-    status: 'absent';
-} | {
-    status: 'unreachable';
-    reason: PingUnreachableReason;
-    error: Error;
-};
-/**
- * Check whether the daemon is running by sending a lightweight `getStatus`
- * RPC call. Distinguishes "no daemon present" (socket file missing) from
- * "daemon present but unreachable" (socket file exists but the daemon is
- * wedged, mid-shutdown, or owned by a different user).
- *
- * @param socketPath - The Unix socket path.
- * @returns A {@link PingResult} describing the daemon's reachability.
- */
-export declare function pingDaemon(socketPath: string): Promise<PingResult>;
-export {};
-//# sourceMappingURL=daemon-client.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"daemon-client.d.mts","sourceRoot":"","sources":["../../src/daemon/daemon-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,wBAAwB;AAWtE;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACxB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACnC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAiBF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAAC,EAChC,UAAU,EACV,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyC/C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,SAAS,GACT,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AA4C3E;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAcxE"}

package/dist/daemon/daemon-client.mjs

@@ -1,135 +0,0 @@
-import { assertIsJsonRpcResponse } from "@metamask/utils";
-import { randomUUID } from "node:crypto";
-import { createConnection } from "node:net";
-import { readLine, writeLine } from "./socket-line.mjs";
-import { isErrorWithCode } from "./utils.mjs";
-const DEFAULT_TIMEOUT_MS = 30000;
-async function connectSocket(socketPath) {
-    return new Promise((resolve, reject) => {
-        const socket = createConnection(socketPath, () => {
-            socket.removeAllListeners('error');
-            resolve(socket);
-        });
-        socket.on('error', (error) => {
-            // A failed connect never reaches the caller, so destroy the socket here
-            // to avoid leaking its file descriptor.
-            socket.destroy();
-            reject(error);
-        });
-    });
-}
-/**
- * Send a JSON-RPC request to the daemon over a Unix socket and return the
- * response.
- *
- * Opens a connection, writes one JSON-RPC request line, reads one JSON-RPC
- * response line, then closes the connection. Retries once after a short delay
- * on transient connection errors (ECONNREFUSED, ECONNRESET). Verifies that the
- * response `id` matches the outgoing request `id`.
- *
- * @param options - Command options.
- * @param options.socketPath - The Unix socket path.
- * @param options.method - The RPC method name.
- * @param options.params - Optional method parameters.
- * @param options.timeoutMs - Read timeout in milliseconds.
- * @returns The parsed JSON-RPC response.
- */
-export async function sendCommand({ socketPath, method, params, timeoutMs, }) {
-    const id = randomUUID();
-    const request = {
-        jsonrpc: '2.0',
-        id,
-        method,
-        ...(params === undefined ? {} : { params }),
-    };
-    const effectiveTimeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const attempt = async () => {
-        const socket = await connectSocket(socketPath);
-        try {
-            await writeLine(socket, JSON.stringify(request));
-            const responseLine = await readLine(socket, effectiveTimeout);
-            const parsed = JSON.parse(responseLine);
-            assertIsJsonRpcResponse(parsed);
-            if (parsed.id !== id) {
-                throw new Error(`JSON-RPC response id ${JSON.stringify(parsed.id)} does not match request id ${JSON.stringify(id)}`);
-            }
-            return parsed;
-        }
-        finally {
-            socket.destroy();
-        }
-    };
-    try {
-        return await attempt();
-    }
-    catch (error) {
-        if (!isErrorWithCode(error, 'ECONNREFUSED') &&
-            !isErrorWithCode(error, 'ECONNRESET')) {
-            throw error;
-        }
-        await new Promise((resolve) => setTimeout(resolve, 100));
-        return attempt();
-    }
-}
-/**
- * Normalize an unknown throw into a real Error instance so that downstream
- * consumers (which read `.message`) cannot crash on string/object throws.
- *
- * @param error - The caught value.
- * @returns An Error mirroring the caught value.
- */
-function toError(error) {
-    return error instanceof Error ? error : new Error(String(error));
-}
-/**
- * Categorise an unreachable error by Node errno / message shape so callers can
- * make decisions per failure mode rather than parsing message strings.
- *
- * @param error - The caught value.
- * @returns A {@link PingUnreachableReason} label.
- */
-function classifyUnreachable(error) {
-    if (isErrorWithCode(error, 'ECONNREFUSED') ||
-        isErrorWithCode(error, 'ECONNRESET')) {
-        return 'refused';
-    }
-    if (isErrorWithCode(error, 'EACCES') || isErrorWithCode(error, 'EPERM')) {
-        return 'permission';
-    }
-    if (error instanceof Error && error.message === 'Socket read timed out') {
-        return 'timeout';
-    }
-    if (error instanceof Error &&
-        (error.message.includes('JSON-RPC response id') ||
-            /Expected .* JSON-RPC/u.test(error.message) ||
-            error.name === 'SyntaxError')) {
-        return 'protocol';
-    }
-    return 'other';
-}
-/**
- * Check whether the daemon is running by sending a lightweight `getStatus`
- * RPC call. Distinguishes "no daemon present" (socket file missing) from
- * "daemon present but unreachable" (socket file exists but the daemon is
- * wedged, mid-shutdown, or owned by a different user).
- *
- * @param socketPath - The Unix socket path.
- * @returns A {@link PingResult} describing the daemon's reachability.
- */
-export async function pingDaemon(socketPath) {
-    try {
-        await sendCommand({ socketPath, method: 'getStatus', timeoutMs: 3000 });
-        return { status: 'responsive' };
-    }
-    catch (error) {
-        if (isErrorWithCode(error, 'ENOENT')) {
-            return { status: 'absent' };
-        }
-        return {
-            status: 'unreachable',
-            reason: classifyUnreachable(error),
-            error: toError(error),
-        };
-    }
-}
-//# sourceMappingURL=daemon-client.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"daemon-client.mjs","sourceRoot":"","sources":["../../src/daemon/daemon-client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonRpcParams, JsonRpcResponse } from '@metamask/utils';\nimport { assertIsJsonRpcResponse } from '@metamask/utils';\nimport { randomUUID } from 'node:crypto';\nimport { createConnection } from 'node:net';\nimport type { Socket } from 'node:net';\n\nimport { readLine, writeLine } from './socket-line';\nimport { isErrorWithCode } from './utils';\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\n/**\n * Options for {@link sendCommand}.\n */\ntype SendCommandOptions = {\n  /** The Unix socket path. */\n  socketPath: string;\n  /** The RPC method name. */\n  method: string;\n  /** Optional method parameters (object or positional array). */\n  params?: JsonRpcParams | undefined;\n  /** Response read timeout in milliseconds (default: 30 000). */\n  timeoutMs?: number | undefined;\n};\n\nasync function connectSocket(socketPath: string): Promise<Socket> {\n  return new Promise((resolve, reject) => {\n    const socket = createConnection(socketPath, () => {\n      socket.removeAllListeners('error');\n      resolve(socket);\n    });\n    socket.on('error', (error) => {\n      // A failed connect never reaches the caller, so destroy the socket here\n      // to avoid leaking its file descriptor.\n      socket.destroy();\n      reject(error);\n    });\n  });\n}\n\n/**\n * Send a JSON-RPC request to the daemon over a Unix socket and return the\n * response.\n *\n * Opens a connection, writes one JSON-RPC request line, reads one JSON-RPC\n * response line, then closes the connection. Retries once after a short delay\n * on transient connection errors (ECONNREFUSED, ECONNRESET). Verifies that the\n * response `id` matches the outgoing request `id`.\n *\n * @param options - Command options.\n * @param options.socketPath - The Unix socket path.\n * @param options.method - The RPC method name.\n * @param options.params - Optional method parameters.\n * @param options.timeoutMs - Read timeout in milliseconds.\n * @returns The parsed JSON-RPC response.\n */\nexport async function sendCommand({\n  socketPath,\n  method,\n  params,\n  timeoutMs,\n}: SendCommandOptions): Promise<JsonRpcResponse> {\n  const id = randomUUID();\n  const request = {\n    jsonrpc: '2.0',\n    id,\n    method,\n    ...(params === undefined ? {} : { params }),\n  };\n\n  const effectiveTimeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n  const attempt = async (): Promise<JsonRpcResponse> => {\n    const socket = await connectSocket(socketPath);\n    try {\n      await writeLine(socket, JSON.stringify(request));\n      const responseLine = await readLine(socket, effectiveTimeout);\n      const parsed: unknown = JSON.parse(responseLine);\n      assertIsJsonRpcResponse(parsed);\n      if (parsed.id !== id) {\n        throw new Error(\n          `JSON-RPC response id ${JSON.stringify(parsed.id)} does not match request id ${JSON.stringify(id)}`,\n        );\n      }\n      return parsed;\n    } finally {\n      socket.destroy();\n    }\n  };\n\n  try {\n    return await attempt();\n  } catch (error: unknown) {\n    if (\n      !isErrorWithCode(error, 'ECONNREFUSED') &&\n      !isErrorWithCode(error, 'ECONNRESET')\n    ) {\n      throw error;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 100));\n    return attempt();\n  }\n}\n\n/**\n * Why an unreachable daemon cannot be queried.\n *\n * - `'refused'`: connection refused after retry (`ECONNREFUSED` / `ECONNRESET`).\n *   Typical of a daemon that has crashed or is mid-restart.\n * - `'timeout'`: the daemon accepted the connection but did not respond within\n *   the read timeout — most likely wedged on a long-running operation.\n * - `'permission'`: the socket exists but cannot be opened (`EACCES` / `EPERM`).\n *   The daemon almost certainly belongs to another user.\n * - `'protocol'`: the daemon responded but the response did not parse as a\n *   valid JSON-RPC response, or the response id did not match.\n * - `'other'`: anything else.\n */\nexport type PingUnreachableReason =\n  | 'refused'\n  | 'timeout'\n  | 'permission'\n  | 'protocol'\n  | 'other';\n\n/**\n * Outcome of a daemon health check.\n *\n * - `'responsive'`: the daemon answered a `getStatus` RPC.\n * - `'absent'`: the socket connect attempt failed with `ENOENT`, i.e. no\n *   socket file exists at the path. No daemon present.\n * - `'unreachable'`: any other non-success outcome. The daemon may still be\n *   alive but is not responding. Callers should not silently take over the\n *   slot or assume the daemon is dead. The `reason` field categorises the\n *   failure so callers can distinguish a wedged sibling daemon from a\n *   foreign-user daemon from a transient crash. User-initiated stop / purge\n *   flows may still escalate to signals against the recorded PID.\n */\nexport type PingResult =\n  | { status: 'responsive' }\n  | { status: 'absent' }\n  | { status: 'unreachable'; reason: PingUnreachableReason; error: Error };\n\n/**\n * Normalize an unknown throw into a real Error instance so that downstream\n * consumers (which read `.message`) cannot crash on string/object throws.\n *\n * @param error - The caught value.\n * @returns An Error mirroring the caught value.\n */\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\n/**\n * Categorise an unreachable error by Node errno / message shape so callers can\n * make decisions per failure mode rather than parsing message strings.\n *\n * @param error - The caught value.\n * @returns A {@link PingUnreachableReason} label.\n */\nfunction classifyUnreachable(error: unknown): PingUnreachableReason {\n  if (\n    isErrorWithCode(error, 'ECONNREFUSED') ||\n    isErrorWithCode(error, 'ECONNRESET')\n  ) {\n    return 'refused';\n  }\n  if (isErrorWithCode(error, 'EACCES') || isErrorWithCode(error, 'EPERM')) {\n    return 'permission';\n  }\n  if (error instanceof Error && error.message === 'Socket read timed out') {\n    return 'timeout';\n  }\n  if (\n    error instanceof Error &&\n    (error.message.includes('JSON-RPC response id') ||\n      /Expected .* JSON-RPC/u.test(error.message) ||\n      error.name === 'SyntaxError')\n  ) {\n    return 'protocol';\n  }\n  return 'other';\n}\n\n/**\n * Check whether the daemon is running by sending a lightweight `getStatus`\n * RPC call. Distinguishes \"no daemon present\" (socket file missing) from\n * \"daemon present but unreachable\" (socket file exists but the daemon is\n * wedged, mid-shutdown, or owned by a different user).\n *\n * @param socketPath - The Unix socket path.\n * @returns A {@link PingResult} describing the daemon's reachability.\n */\nexport async function pingDaemon(socketPath: string): Promise<PingResult> {\n  try {\n    await sendCommand({ socketPath, method: 'getStatus', timeoutMs: 3_000 });\n    return { status: 'responsive' };\n  } catch (error: unknown) {\n    if (isErrorWithCode(error, 'ENOENT')) {\n      return { status: 'absent' };\n    }\n    return {\n      status: 'unreachable',\n      reason: classifyUnreachable(error),\n      error: toError(error),\n    };\n  }\n}\n"]}