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

package/dist/daemon/rpc-socket-server.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-socket-server.mjs","sourceRoot":"","sources":["../../src/daemon/rpc-socket-server.ts"],"names":[],"mappings":"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","sourcesContent":["import { rpcErrors } from '@metamask/rpc-errors';\nimport type {\n  JsonRpcId,\n  JsonRpcParams,\n  JsonRpcResponse,\n} from '@metamask/utils';\nimport { hasProperty, isJsonRpcRequest } from '@metamask/utils';\nimport { chmod, unlink } from 'node:fs/promises';\nimport { createServer } from 'node:net';\nimport type { Server } from 'node:net';\n\nimport type { RpcHandlerMap } from './types';\nimport { isErrorWithCode } from './utils';\n\nconst CONNECTION_TIMEOUT_MS = 30_000;\n\n/**\n * Handle returned by {@link startRpcSocketServer}.\n */\nexport type RpcSocketServerHandle = {\n  close: () => Promise<void>;\n};\n\n/**\n * Options for {@link startRpcSocketServer}.\n */\nexport type StartRpcSocketServerOptions = {\n  /** The Unix socket path to listen on. */\n  socketPath: string;\n  /** Map of RPC method names to handler functions. */\n  handlers: RpcHandlerMap;\n  /** Callback invoked when a `shutdown` RPC is received. */\n  onShutdown?: (() => Promise<void>) | undefined;\n  /**\n   * Optional logger for server-side diagnostics (unexpected socket errors,\n   * unhandled handler rejections, `onShutdown` callback failures). Without\n   * this, failures fall back to `process.stderr.write`, which is discarded\n   * when the daemon is spawned with `stdio: 'ignore'`.\n   */\n  log?: ((message: string) => void) | undefined;\n};\n\n/**\n * Start a Unix socket server that processes JSON-RPC requests.\n *\n * Each connection reads one newline-delimited JSON-RPC request, processes it\n * via the provided handler map, writes a JSON-RPC response, and closes.\n *\n * The special `shutdown` method is intercepted before handler dispatch and\n * triggers the provided {@link StartRpcSocketServerOptions.onShutdown} callback\n * after responding.\n *\n * @param options - Server options.\n * @param options.socketPath - The Unix socket path to listen on.\n * @param options.handlers - Map of RPC method names to handler functions.\n * @param options.onShutdown - Optional callback invoked when a `shutdown` RPC is received.\n * @param options.log - Optional logger for server-side diagnostics.\n * @returns A handle with a `close()` function for cleanup.\n */\nexport async function startRpcSocketServer({\n  socketPath,\n  handlers,\n  onShutdown,\n  log,\n}: StartRpcSocketServerOptions): Promise<RpcSocketServerHandle> {\n  const logFn = log ?? defaultLog;\n\n  const server = createServer((socket) => {\n    let buffer = '';\n\n    // Destroy connections that never send a complete request line. `unref` so\n    // the timer alone cannot keep the event loop alive at shutdown.\n    const timer = setTimeout(() => {\n      socket.destroy();\n    }, CONNECTION_TIMEOUT_MS);\n    timer.unref();\n\n    /**\n     * Clear the idle-connection timer. Called from data, close, and error\n     * paths so the timer never outlives the connection itself.\n     */\n    const clearIdleTimer = (): void => {\n      clearTimeout(timer);\n    };\n\n    const onData = (data: Buffer): void => {\n      buffer += data.toString();\n      const idx = buffer.indexOf('\\n');\n      if (idx === -1) {\n        return;\n      }\n\n      clearIdleTimer();\n\n      // One request per connection.\n      socket.removeListener('data', onData);\n\n      const line = buffer.slice(0, idx);\n      const remaining = buffer.slice(idx + 1);\n      buffer = '';\n\n      if (remaining.length > 0) {\n        socket.end(\n          `${JSON.stringify({\n            jsonrpc: '2.0',\n            error: rpcErrors\n              .invalidRequest({\n                message: 'Only one request per connection is allowed',\n              })\n              .serialize(),\n          })}\\n`,\n        );\n        return;\n      }\n\n      handleRequest(handlers, line, onShutdown, logFn)\n        .then((response) => {\n          socket.end(`${JSON.stringify(response)}\\n`);\n          return undefined;\n        })\n        .catch((dispatchError: unknown) => {\n          logFn(`Unhandled RPC dispatch error: ${String(dispatchError)}`);\n          socket.end(\n            `${JSON.stringify({\n              jsonrpc: '2.0',\n              error: rpcErrors\n                .internal({ message: 'Internal error' })\n                .serialize(),\n            })}\\n`,\n          );\n        });\n    };\n    socket.on('data', onData);\n    socket.once('close', clearIdleTimer);\n    socket.on('error', (socketError: NodeJS.ErrnoException) => {\n      clearIdleTimer();\n      const { code } = socketError;\n      if (code === 'EPIPE' || code === 'ECONNRESET') {\n        return; // Expected during probe/disconnect.\n      }\n      logFn(`Unexpected socket error: ${String(socketError)}`);\n    });\n  });\n\n  await listen(server, socketPath);\n\n  return {\n    close: async (): Promise<void> => closeServer(server),\n  };\n}\n\n/**\n * Default fallback logger: writes to stderr. Daemons spawned with\n * `stdio: 'ignore'` should always pass an explicit `log`.\n *\n * @param message - The message to log.\n */\nfunction defaultLog(message: string): void {\n  process.stderr.write(`${message}\\n`);\n}\n\n/**\n * Handle a single JSON-RPC request line, intercepting the `shutdown` method.\n *\n * @param handlers - The RPC handler map.\n * @param line - The raw JSON line from the socket.\n * @param onShutdown - Optional shutdown callback.\n * @param log - Logger for diagnostic messages.\n * @returns A JSON-RPC response object.\n */\nasync function handleRequest(\n  handlers: RpcHandlerMap,\n  line: string,\n  onShutdown: (() => Promise<void>) | undefined,\n  log: (message: string) => void,\n): Promise<JsonRpcResponse> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(line);\n  } catch {\n    return {\n      jsonrpc: '2.0',\n      id: null,\n      error: rpcErrors.parse({ message: 'Parse error' }).serialize(),\n    };\n  }\n\n  if (!isJsonRpcRequest(parsed)) {\n    const id: JsonRpcId =\n      typeof parsed === 'object' &&\n      parsed !== null &&\n      hasProperty(parsed, 'id') &&\n      isValidJsonRpcId(parsed.id)\n        ? parsed.id\n        : null;\n    return {\n      jsonrpc: '2.0',\n      id,\n      error: rpcErrors\n        .invalidRequest({ message: 'Invalid JSON-RPC request' })\n        .serialize(),\n    };\n  }\n\n  const { id, method, params } = parsed;\n\n  try {\n    if (method === 'shutdown') {\n      if (onShutdown) {\n        setTimeout(() => {\n          onShutdown().catch((error: unknown) => {\n            log(`onShutdown callback failed: ${String(error)}`);\n          });\n        }, 0);\n      }\n      return { jsonrpc: '2.0', id, result: { status: 'shutting down' } };\n    }\n\n    const handler = Object.prototype.hasOwnProperty.call(handlers, method)\n      ? handlers[method]\n      : undefined;\n    if (!handler) {\n      return {\n        jsonrpc: '2.0',\n        id,\n        error: rpcErrors\n          .methodNotFound({ message: `Method not found: ${method}` })\n          .serialize(),\n      };\n    }\n\n    const result = await handler(coerceHandlerParams(params));\n    return { jsonrpc: '2.0', id, result: result ?? null };\n  } catch (error) {\n    log(`RPC handler \"${method}\" failed: ${String(error)}`);\n    if (isRpcError(error)) {\n      return { jsonrpc: '2.0', id, error };\n    }\n    const message = error instanceof Error ? error.message : 'Internal error';\n    return {\n      jsonrpc: '2.0',\n      id,\n      error: rpcErrors.internal({ message }).serialize(),\n    };\n  }\n}\n\n/**\n * Narrow `params` to the shape handlers expect. JSON-RPC 2.0 requires\n * `params`, when present, to be an array or object; both are valid `Json`.\n *\n * @param params - The validated `params` field from a JSON-RPC request.\n * @returns The same value, or `null` when absent.\n */\nfunction coerceHandlerParams(\n  params: JsonRpcParams | undefined,\n): JsonRpcParams | null {\n  return params ?? null;\n}\n\n/**\n * Per JSON-RPC 2.0, `id` must be a string, number, or null. Used when\n * salvaging an `id` from a parse-success-but-not-valid-request payload.\n *\n * @param value - The candidate id.\n * @returns True if the value is an acceptable JSON-RPC id.\n */\nfunction isValidJsonRpcId(value: unknown): value is JsonRpcId {\n  return (\n    value === null || typeof value === 'string' || typeof value === 'number'\n  );\n}\n\n/**\n * Check if an error is an RPC error with a numeric code.\n *\n * @param error - The error to check.\n * @returns True if the error has a numeric code property.\n */\nfunction isRpcError(\n  error: unknown,\n): error is { code: number; message: string } {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    hasProperty(error, 'code') &&\n    typeof error.code === 'number' &&\n    hasProperty(error, 'message') &&\n    typeof error.message === 'string'\n  );\n}\n\n/**\n * Start listening on a Unix socket path, removing any stale socket file.\n *\n * @param server - The net.Server instance.\n * @param socketPath - The Unix socket path.\n */\nasync function listen(server: Server, socketPath: string): Promise<void> {\n  try {\n    await unlink(socketPath);\n  } catch (error) {\n    if (!isErrorWithCode(error, 'ENOENT')) {\n      throw error;\n    }\n  }\n\n  await new Promise<void>((resolve, reject) => {\n    server.on('error', reject);\n    server.listen(socketPath, () => {\n      server.removeListener('error', reject);\n      resolve();\n    });\n  });\n\n  // Restrict the socket to its owner. The daemon hosts an unlocked wallet, so\n  // a world-connectable socket would let any local user drive it. listen()\n  // creates the socket with umask-derived (typically world-accessible) perms.\n  try {\n    await chmod(socketPath, 0o600);\n  } catch (error) {\n    // Never leave a possibly world-accessible socket listening with no handle\n    // to close it. Cleanup is best-effort so the chmod failure still surfaces.\n    await closeServer(server).catch(() => undefined);\n    await unlink(socketPath).catch(() => undefined);\n    throw error;\n  }\n}\n\n/**\n * Close a server, resolving once it stops accepting connections.\n *\n * @param server - The net.Server instance.\n */\nasync function closeServer(server: Server): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    server.close((error) => {\n      if (error) {\n        reject(error);\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n"]}

package/dist/daemon/socket-line.cjs

@@ -1,89 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readLine = exports.writeLine = void 0;
-/**
- * Write a newline-delimited line to a socket.
- *
- * @param socket - The socket to write to.
- * @param line - The line to write (without trailing newline).
- */
-async function writeLine(socket, line) {
-    return new Promise((resolve, reject) => {
-        // A socket 'error' can fire while the write is in flight without ever
-        // reaching the write callback; without this listener Node would treat it
-        // as an unhandled 'error' event and crash the process.
-        const onError = (error) => {
-            socket.removeListener('error', onError);
-            reject(error);
-        };
-        socket.once('error', onError);
-        socket.write(`${line}\n`, (error) => {
-            socket.removeListener('error', onError);
-            if (error) {
-                reject(error);
-            }
-            else {
-                resolve();
-            }
-        });
-    });
-}
-exports.writeLine = writeLine;
-/**
- * Read a single newline-delimited line from a socket.
- *
- * @param socket - The socket to read from.
- * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout
- * error if no complete line is received within the limit.
- * @returns The line read (without trailing newline).
- */
-async function readLine(socket, timeoutMs) {
-    return new Promise((resolve, reject) => {
-        let buffer = '';
-        let timer;
-        if (timeoutMs !== undefined) {
-            timer = setTimeout(() => {
-                cleanup();
-                reject(new Error('Socket read timed out'));
-            }, timeoutMs);
-        }
-        const onData = (data) => {
-            buffer += data.toString();
-            const idx = buffer.indexOf('\n');
-            if (idx !== -1) {
-                cleanup();
-                resolve(buffer.slice(0, idx));
-            }
-        };
-        const onError = (error) => {
-            cleanup();
-            reject(error);
-        };
-        const onEnd = () => {
-            cleanup();
-            reject(new Error('Socket closed before response received'));
-        };
-        const onClose = () => {
-            cleanup();
-            reject(new Error('Socket closed before response received'));
-        };
-        /**
-         * Remove listeners registered by this call and clear the timeout.
-         */
-        function cleanup() {
-            if (timer !== undefined) {
-                clearTimeout(timer);
-            }
-            socket.removeListener('data', onData);
-            socket.removeListener('error', onError);
-            socket.removeListener('end', onEnd);
-            socket.removeListener('close', onClose);
-        }
-        socket.on('data', onData);
-        socket.once('error', onError);
-        socket.once('end', onEnd);
-        socket.once('close', onClose);
-    });
-}
-exports.readLine = readLine;
-//# sourceMappingURL=socket-line.cjs.map

package/dist/daemon/socket-line.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-line.cjs","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Socket } from 'node:net';\n\n/**\n * Write a newline-delimited line to a socket.\n *\n * @param socket - The socket to write to.\n * @param line - The line to write (without trailing newline).\n */\nexport async function writeLine(socket: Socket, line: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    // A socket 'error' can fire while the write is in flight without ever\n    // reaching the write callback; without this listener Node would treat it\n    // as an unhandled 'error' event and crash the process.\n    const onError = (error: Error): void => {\n      socket.removeListener('error', onError);\n      reject(error);\n    };\n    socket.once('error', onError);\n\n    socket.write(`${line}\\n`, (error) => {\n      socket.removeListener('error', onError);\n      if (error) {\n        reject(error);\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n\n/**\n * Read a single newline-delimited line from a socket.\n *\n * @param socket - The socket to read from.\n * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout\n * error if no complete line is received within the limit.\n * @returns The line read (without trailing newline).\n */\nexport async function readLine(\n  socket: Socket,\n  timeoutMs?: number,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buffer = '';\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    if (timeoutMs !== undefined) {\n      timer = setTimeout(() => {\n        cleanup();\n        reject(new Error('Socket read timed out'));\n      }, timeoutMs);\n    }\n\n    const onData = (data: Buffer): void => {\n      buffer += data.toString();\n      const idx = buffer.indexOf('\\n');\n      if (idx !== -1) {\n        cleanup();\n        resolve(buffer.slice(0, idx));\n      }\n    };\n\n    const onError = (error: Error): void => {\n      cleanup();\n      reject(error);\n    };\n\n    const onEnd = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    const onClose = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    /**\n     * Remove listeners registered by this call and clear the timeout.\n     */\n    function cleanup(): void {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n      socket.removeListener('data', onData);\n      socket.removeListener('error', onError);\n      socket.removeListener('end', onEnd);\n      socket.removeListener('close', onClose);\n    }\n\n    socket.on('data', onData);\n    socket.once('error', onError);\n    socket.once('end', onEnd);\n    socket.once('close', onClose);\n  });\n}\n"]}

package/dist/daemon/socket-line.d.cts

@@ -1,19 +0,0 @@
-/// <reference types="node" />
-import type { Socket } from "node:net";
-/**
- * Write a newline-delimited line to a socket.
- *
- * @param socket - The socket to write to.
- * @param line - The line to write (without trailing newline).
- */
-export declare function writeLine(socket: Socket, line: string): Promise<void>;
-/**
- * Read a single newline-delimited line from a socket.
- *
- * @param socket - The socket to read from.
- * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout
- * error if no complete line is received within the limit.
- * @returns The line read (without trailing newline).
- */
-export declare function readLine(socket: Socket, timeoutMs?: number): Promise<string>;
-//# sourceMappingURL=socket-line.d.cts.map

package/dist/daemon/socket-line.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-line.d.cts","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB;AAEvC;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/daemon/socket-line.d.mts

@@ -1,19 +0,0 @@
-/// <reference types="node" />
-import type { Socket } from "node:net";
-/**
- * Write a newline-delimited line to a socket.
- *
- * @param socket - The socket to write to.
- * @param line - The line to write (without trailing newline).
- */
-export declare function writeLine(socket: Socket, line: string): Promise<void>;
-/**
- * Read a single newline-delimited line from a socket.
- *
- * @param socket - The socket to read from.
- * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout
- * error if no complete line is received within the limit.
- * @returns The line read (without trailing newline).
- */
-export declare function readLine(socket: Socket, timeoutMs?: number): Promise<string>;
-//# sourceMappingURL=socket-line.d.mts.map

package/dist/daemon/socket-line.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-line.d.mts","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB;AAEvC;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/daemon/socket-line.mjs

@@ -1,84 +0,0 @@
-/**
- * Write a newline-delimited line to a socket.
- *
- * @param socket - The socket to write to.
- * @param line - The line to write (without trailing newline).
- */
-export async function writeLine(socket, line) {
-    return new Promise((resolve, reject) => {
-        // A socket 'error' can fire while the write is in flight without ever
-        // reaching the write callback; without this listener Node would treat it
-        // as an unhandled 'error' event and crash the process.
-        const onError = (error) => {
-            socket.removeListener('error', onError);
-            reject(error);
-        };
-        socket.once('error', onError);
-        socket.write(`${line}\n`, (error) => {
-            socket.removeListener('error', onError);
-            if (error) {
-                reject(error);
-            }
-            else {
-                resolve();
-            }
-        });
-    });
-}
-/**
- * Read a single newline-delimited line from a socket.
- *
- * @param socket - The socket to read from.
- * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout
- * error if no complete line is received within the limit.
- * @returns The line read (without trailing newline).
- */
-export async function readLine(socket, timeoutMs) {
-    return new Promise((resolve, reject) => {
-        let buffer = '';
-        let timer;
-        if (timeoutMs !== undefined) {
-            timer = setTimeout(() => {
-                cleanup();
-                reject(new Error('Socket read timed out'));
-            }, timeoutMs);
-        }
-        const onData = (data) => {
-            buffer += data.toString();
-            const idx = buffer.indexOf('\n');
-            if (idx !== -1) {
-                cleanup();
-                resolve(buffer.slice(0, idx));
-            }
-        };
-        const onError = (error) => {
-            cleanup();
-            reject(error);
-        };
-        const onEnd = () => {
-            cleanup();
-            reject(new Error('Socket closed before response received'));
-        };
-        const onClose = () => {
-            cleanup();
-            reject(new Error('Socket closed before response received'));
-        };
-        /**
-         * Remove listeners registered by this call and clear the timeout.
-         */
-        function cleanup() {
-            if (timer !== undefined) {
-                clearTimeout(timer);
-            }
-            socket.removeListener('data', onData);
-            socket.removeListener('error', onError);
-            socket.removeListener('end', onEnd);
-            socket.removeListener('close', onClose);
-        }
-        socket.on('data', onData);
-        socket.once('error', onError);
-        socket.once('end', onEnd);
-        socket.once('close', onClose);
-    });
-}
-//# sourceMappingURL=socket-line.mjs.map

package/dist/daemon/socket-line.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-line.mjs","sourceRoot":"","sources":["../../src/daemon/socket-line.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Socket } from 'node:net';\n\n/**\n * Write a newline-delimited line to a socket.\n *\n * @param socket - The socket to write to.\n * @param line - The line to write (without trailing newline).\n */\nexport async function writeLine(socket: Socket, line: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    // A socket 'error' can fire while the write is in flight without ever\n    // reaching the write callback; without this listener Node would treat it\n    // as an unhandled 'error' event and crash the process.\n    const onError = (error: Error): void => {\n      socket.removeListener('error', onError);\n      reject(error);\n    };\n    socket.once('error', onError);\n\n    socket.write(`${line}\\n`, (error) => {\n      socket.removeListener('error', onError);\n      if (error) {\n        reject(error);\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n\n/**\n * Read a single newline-delimited line from a socket.\n *\n * @param socket - The socket to read from.\n * @param timeoutMs - Optional timeout in milliseconds. Rejects with a timeout\n * error if no complete line is received within the limit.\n * @returns The line read (without trailing newline).\n */\nexport async function readLine(\n  socket: Socket,\n  timeoutMs?: number,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let buffer = '';\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    if (timeoutMs !== undefined) {\n      timer = setTimeout(() => {\n        cleanup();\n        reject(new Error('Socket read timed out'));\n      }, timeoutMs);\n    }\n\n    const onData = (data: Buffer): void => {\n      buffer += data.toString();\n      const idx = buffer.indexOf('\\n');\n      if (idx !== -1) {\n        cleanup();\n        resolve(buffer.slice(0, idx));\n      }\n    };\n\n    const onError = (error: Error): void => {\n      cleanup();\n      reject(error);\n    };\n\n    const onEnd = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    const onClose = (): void => {\n      cleanup();\n      reject(new Error('Socket closed before response received'));\n    };\n\n    /**\n     * Remove listeners registered by this call and clear the timeout.\n     */\n    function cleanup(): void {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n      socket.removeListener('data', onData);\n      socket.removeListener('error', onError);\n      socket.removeListener('end', onEnd);\n      socket.removeListener('close', onClose);\n    }\n\n    socket.on('data', onData);\n    socket.once('error', onError);\n    socket.once('end', onEnd);\n    socket.once('close', onClose);\n  });\n}\n"]}

package/dist/daemon/stop-daemon.cjs

@@ -1,103 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"version":3,"file":"stop-daemon.cjs","sourceRoot":"","sources":["../../src/daemon/stop-daemon.ts"],"names":[],"mappings":";;;AAAA,+CAAsC;AAEtC,uDAA0D;AAC1D,uCAA2E;AAE3E;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,OAAe,EACf,GAA+B;IAE/B,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,IAAA,0BAAU,EAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,cAAc,GAClB,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;IAChE,MAAM,YAAY,GAAG,GAAG,KAAK,SAAS,IAAI,IAAA,sBAAc,EAAC,GAAG,CAAC,CAAC;IAE9D,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,kEAAkE;QAClE,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,EAAE,CAAC,oBAAoB,CAAC,CAAC;IAE5B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,8CAA8C;IAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,IAAA,2BAAW,EAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,EAAE,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,yEAAyE;QACzE,4EAA4E;QAC5E,8CAA8C;QAC9C,OAAO,GAAG,MAAM,IAAA,eAAO,EACrB,KAAK,IAAI,EAAE,CACT,CAAC,MAAM,IAAA,0BAAU,EAAC,UAAU,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY;YACtD,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,IAAA,sBAAc,EAAC,GAAG,CAAC,CAAC,EAC7C,IAAK,CACN,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,uEAAuE;IACvE,+CAA+C;IAC/C,IAAI,CAAC,OAAO,IAAI,YAAY,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAClD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,GAAG,EAAE,CACH,aAAa,UAAU,+BAA+B,GAAG,+BAA+B,CACzF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,IAAI,IAAA,kBAAU,EAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC/B,OAAO,GAAG,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,CAAC,IAAA,sBAAc,EAAC,GAAG,CAAC,EAAE,IAAK,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,IAAI,CAAC,CAAC,gCAAgC;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,EAAE,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,OAAO,IAAI,YAAY,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,IAAI,IAAA,kBAAU,EAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC/B,OAAO,GAAG,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,CAAC,IAAA,sBAAc,EAAC,GAAG,CAAC,EAAE,IAAK,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,IAAI,CAAC,CAAC,gCAAgC;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,EAAE,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AA/ED,gCA+EC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,WAAW,CACxB,IAAY,EACZ,KAAa,EACb,GAA4C;IAE5C,MAAM,IAAA,aAAE,EAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACvD,GAAG,EAAE,CAAC,oBAAoB,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC","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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,99 +0,0 @@
-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

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