@metamask-previews/wallet-cli 0.0.0-preview-5588db68c → 0.0.0-preview-138a209ad

package/CHANGELOG.md

@@ -9,9 +9,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- 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)).
 
 [Unreleased]: https://github.com/MetaMask/core/

package/README.md

@@ -10,24 +10,6 @@ or
 
 `npm install @metamask/wallet-cli`
 
-## Troubleshooting
-
-### Rebuilding `better-sqlite3`
-
-This package depends on `better-sqlite3`, which ships a native C addon. The monorepo runs Yarn with `enableScripts: false`, so the addon is **not** fetched automatically during `yarn install`. Instead, the package's `test:prepare` script (`scripts/install-binaries.sh`) downloads the matching prebuild on demand the first time you run tests, falling back to compiling the addon from source (via `node-gyp`) when no prebuild is published for your Node ABI/platform.
-
-If you switch Node versions or branches and the binding is missing, re-run:
-
-```sh
-yarn workspace @metamask/wallet-cli run test:prepare
-```
-
-Or invoke `prebuild-install` directly from the monorepo root (where `better-sqlite3` is hoisted):
-
-```sh
-cd node_modules/better-sqlite3 && node ../.bin/prebuild-install
-```
-
 ## Contributing
 
 This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/wallet-cli",
-  "version": "0.0.0-preview-5588db68c",
+  "version": "0.0.0-preview-138a209ad",
   "description": "The CLI of @metamask/wallet",
   "keywords": [
     "Ethereum",
@@ -36,24 +36,17 @@
     "changelog:update": "../../scripts/update-changelog.sh @metamask/wallet-cli",
     "changelog:validate": "../../scripts/validate-changelog.sh @metamask/wallet-cli",
     "since-latest-release": "../../scripts/since-latest-release.sh",
-    "test:prepare": "./scripts/install-binaries.sh",
-    "test": "yarn test:prepare && NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
     "test:clean": "NODE_OPTIONS=--experimental-vm-modules jest --clearCache",
     "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "dependencies": {
-    "@metamask/base-controller": "^9.1.0",
-    "@metamask/utils": "^11.11.0",
-    "@metamask/wallet": "^3.0.0",
-    "@oclif/core": "^4.10.5",
-    "better-sqlite3": "^12.9.0",
-    "immer": "^9.0.6"
+    "@oclif/core": "^4.10.5"
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^6.1.0",
     "@ts-bridge/cli": "^0.6.4",
-    "@types/better-sqlite3": "^7.6.13",
     "@types/jest": "^29.5.14",
     "deepmerge": "^4.2.2",
     "jest": "^29.7.0",
@@ -67,6 +60,6 @@
     "topicSeparator": " "
   },
   "engines": {
-    "node": ">=20"
+    "node": "^18.18 || >=20"
   }
 }

package/dist/persistence/KeyValueStore.cjs

@@ -1,79 +0,0 @@
-"use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-var _KeyValueStore_db, _KeyValueStore_getStmt, _KeyValueStore_setStmt, _KeyValueStore_deleteStmt, _KeyValueStore_getAllStmt;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.KeyValueStore = void 0;
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
-/**
- * A synchronous key-value store backed by better-sqlite3.
- *
- * Uses a single `kv` table with TEXT key (primary key) and TEXT value
- * (JSON-serialized). Intended as the persistence backend for wallet
- * controller state.
- */
-class KeyValueStore {
-    constructor(databasePath) {
-        _KeyValueStore_db.set(this, void 0);
-        _KeyValueStore_getStmt.set(this, void 0);
-        _KeyValueStore_setStmt.set(this, void 0);
-        _KeyValueStore_deleteStmt.set(this, void 0);
-        _KeyValueStore_getAllStmt.set(this, void 0);
-        __classPrivateFieldSet(this, _KeyValueStore_db, new better_sqlite3_1.default(databasePath), "f");
-        __classPrivateFieldGet(this, _KeyValueStore_db, "f").pragma('journal_mode = WAL');
-        __classPrivateFieldGet(this, _KeyValueStore_db, "f").exec('CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY, value TEXT NOT NULL)');
-        __classPrivateFieldSet(this, _KeyValueStore_getStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('SELECT value FROM kv WHERE key = ?'), "f");
-        __classPrivateFieldSet(this, _KeyValueStore_setStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)'), "f");
-        __classPrivateFieldSet(this, _KeyValueStore_deleteStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('DELETE FROM kv WHERE key = ?'), "f");
-        __classPrivateFieldSet(this, _KeyValueStore_getAllStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('SELECT key, value FROM kv'), "f");
-    }
-    get(key) {
-        const row = __classPrivateFieldGet(this, _KeyValueStore_getStmt, "f").get(key);
-        if (!row) {
-            return undefined;
-        }
-        try {
-            return JSON.parse(row.value);
-        }
-        catch {
-            throw new Error(`Failed to parse stored value for key '${key}'`);
-        }
-    }
-    set(key, value) {
-        __classPrivateFieldGet(this, _KeyValueStore_setStmt, "f").run(key, JSON.stringify(value));
-    }
-    getAll() {
-        const rows = __classPrivateFieldGet(this, _KeyValueStore_getAllStmt, "f").all();
-        const result = {};
-        for (const row of rows) {
-            try {
-                result[row.key] = JSON.parse(row.value);
-            }
-            catch {
-                throw new Error(`Failed to parse stored value for key '${row.key}'`);
-            }
-        }
-        return result;
-    }
-    delete(key) {
-        __classPrivateFieldGet(this, _KeyValueStore_deleteStmt, "f").run(key);
-    }
-    close() {
-        __classPrivateFieldGet(this, _KeyValueStore_db, "f").close();
-    }
-}
-exports.KeyValueStore = KeyValueStore;
-_KeyValueStore_db = new WeakMap(), _KeyValueStore_getStmt = new WeakMap(), _KeyValueStore_setStmt = new WeakMap(), _KeyValueStore_deleteStmt = new WeakMap(), _KeyValueStore_getAllStmt = new WeakMap();
-//# sourceMappingURL=KeyValueStore.cjs.map

package/dist/persistence/KeyValueStore.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"KeyValueStore.cjs","sourceRoot":"","sources":["../../src/persistence/KeyValueStore.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,oEAAoC;AAEpC;;;;;;GAMG;AACH,MAAa,aAAa;IAWxB,YAAY,YAAoB;QAVvB,oCAAqB;QAErB,yCAAoE;QAEpE,yCAAmD;QAEnD,4CAA8C;QAE9C,4CAAkE;QAGzE,uBAAA,IAAI,qBAAO,IAAI,wBAAM,CAAC,YAAY,CAAC,MAAA,CAAC;QACpC,uBAAA,IAAI,yBAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACtC,uBAAA,IAAI,yBAAI,CAAC,IAAI,CACX,2EAA2E,CAC5E,CAAC;QAEF,uBAAA,IAAI,0BAAY,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAAC,oCAAoC,CAAC,MAAA,CAAC;QACvE,uBAAA,IAAI,0BAAY,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAC9B,sDAAsD,CACvD,MAAA,CAAC;QACF,uBAAA,IAAI,6BAAe,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC,MAAA,CAAC;QACpE,uBAAA,IAAI,6BAAe,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,MAAA,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,GAAG,GAAG,uBAAA,IAAI,8BAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,GAAG,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAW;QAC1B,uBAAA,IAAI,8BAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAG,uBAAA,IAAI,iCAAY,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,MAAM,GAAyB,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,uBAAA,IAAI,iCAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,uBAAA,IAAI,yBAAI,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF;AA9DD,sCA8DC","sourcesContent":["import type { Json } from '@metamask/utils';\nimport Sqlite from 'better-sqlite3';\n\n/**\n * A synchronous key-value store backed by better-sqlite3.\n *\n * Uses a single `kv` table with TEXT key (primary key) and TEXT value\n * (JSON-serialized). Intended as the persistence backend for wallet\n * controller state.\n */\nexport class KeyValueStore {\n  readonly #db: Sqlite.Database;\n\n  readonly #getStmt: Sqlite.Statement<[string], { value: string } | undefined>;\n\n  readonly #setStmt: Sqlite.Statement<[string, string], void>;\n\n  readonly #deleteStmt: Sqlite.Statement<[string], void>;\n\n  readonly #getAllStmt: Sqlite.Statement<[], { key: string; value: string }>;\n\n  constructor(databasePath: string) {\n    this.#db = new Sqlite(databasePath);\n    this.#db.pragma('journal_mode = WAL');\n    this.#db.exec(\n      'CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY, value TEXT NOT NULL)',\n    );\n\n    this.#getStmt = this.#db.prepare('SELECT value FROM kv WHERE key = ?');\n    this.#setStmt = this.#db.prepare(\n      'INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)',\n    );\n    this.#deleteStmt = this.#db.prepare('DELETE FROM kv WHERE key = ?');\n    this.#getAllStmt = this.#db.prepare('SELECT key, value FROM kv');\n  }\n\n  get(key: string): Json | undefined {\n    const row = this.#getStmt.get(key);\n    if (!row) {\n      return undefined;\n    }\n    try {\n      return JSON.parse(row.value);\n    } catch {\n      throw new Error(`Failed to parse stored value for key '${key}'`);\n    }\n  }\n\n  set(key: string, value: Json): void {\n    this.#setStmt.run(key, JSON.stringify(value));\n  }\n\n  getAll(): Record<string, Json> {\n    const rows = this.#getAllStmt.all();\n    const result: Record<string, Json> = {};\n    for (const row of rows) {\n      try {\n        result[row.key] = JSON.parse(row.value);\n      } catch {\n        throw new Error(`Failed to parse stored value for key '${row.key}'`);\n      }\n    }\n    return result;\n  }\n\n  delete(key: string): void {\n    this.#deleteStmt.run(key);\n  }\n\n  close(): void {\n    this.#db.close();\n  }\n}\n"]}

package/dist/persistence/KeyValueStore.d.cts

@@ -1,18 +0,0 @@
-import type { Json } from "@metamask/utils";
-/**
- * A synchronous key-value store backed by better-sqlite3.
- *
- * Uses a single `kv` table with TEXT key (primary key) and TEXT value
- * (JSON-serialized). Intended as the persistence backend for wallet
- * controller state.
- */
-export declare class KeyValueStore {
-    #private;
-    constructor(databasePath: string);
-    get(key: string): Json | undefined;
-    set(key: string, value: Json): void;
-    getAll(): Record<string, Json>;
-    delete(key: string): void;
-    close(): void;
-}
-//# sourceMappingURL=KeyValueStore.d.cts.map

package/dist/persistence/KeyValueStore.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"KeyValueStore.d.cts","sourceRoot":"","sources":["../../src/persistence/KeyValueStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C;;;;;;GAMG;AACH,qBAAa,aAAa;;gBAWZ,YAAY,EAAE,MAAM;IAehC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAYlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;IAInC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IAa9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/persistence/KeyValueStore.d.mts

@@ -1,18 +0,0 @@
-import type { Json } from "@metamask/utils";
-/**
- * A synchronous key-value store backed by better-sqlite3.
- *
- * Uses a single `kv` table with TEXT key (primary key) and TEXT value
- * (JSON-serialized). Intended as the persistence backend for wallet
- * controller state.
- */
-export declare class KeyValueStore {
-    #private;
-    constructor(databasePath: string);
-    get(key: string): Json | undefined;
-    set(key: string, value: Json): void;
-    getAll(): Record<string, Json>;
-    delete(key: string): void;
-    close(): void;
-}
-//# sourceMappingURL=KeyValueStore.d.mts.map

package/dist/persistence/KeyValueStore.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"KeyValueStore.d.mts","sourceRoot":"","sources":["../../src/persistence/KeyValueStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAG5C;;;;;;GAMG;AACH,qBAAa,aAAa;;gBAWZ,YAAY,EAAE,MAAM;IAehC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAYlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;IAInC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IAa9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/persistence/KeyValueStore.mjs

@@ -1,79 +0,0 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _KeyValueStore_db, _KeyValueStore_getStmt, _KeyValueStore_setStmt, _KeyValueStore_deleteStmt, _KeyValueStore_getAllStmt;
-function $importDefault(module) {
-    if (module?.__esModule) {
-        return module.default;
-    }
-    return module;
-}
-import $Sqlite from "better-sqlite3";
-const Sqlite = $importDefault($Sqlite);
-/**
- * A synchronous key-value store backed by better-sqlite3.
- *
- * Uses a single `kv` table with TEXT key (primary key) and TEXT value
- * (JSON-serialized). Intended as the persistence backend for wallet
- * controller state.
- */
-export class KeyValueStore {
-    constructor(databasePath) {
-        _KeyValueStore_db.set(this, void 0);
-        _KeyValueStore_getStmt.set(this, void 0);
-        _KeyValueStore_setStmt.set(this, void 0);
-        _KeyValueStore_deleteStmt.set(this, void 0);
-        _KeyValueStore_getAllStmt.set(this, void 0);
-        __classPrivateFieldSet(this, _KeyValueStore_db, new Sqlite(databasePath), "f");
-        __classPrivateFieldGet(this, _KeyValueStore_db, "f").pragma('journal_mode = WAL');
-        __classPrivateFieldGet(this, _KeyValueStore_db, "f").exec('CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY, value TEXT NOT NULL)');
-        __classPrivateFieldSet(this, _KeyValueStore_getStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('SELECT value FROM kv WHERE key = ?'), "f");
-        __classPrivateFieldSet(this, _KeyValueStore_setStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)'), "f");
-        __classPrivateFieldSet(this, _KeyValueStore_deleteStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('DELETE FROM kv WHERE key = ?'), "f");
-        __classPrivateFieldSet(this, _KeyValueStore_getAllStmt, __classPrivateFieldGet(this, _KeyValueStore_db, "f").prepare('SELECT key, value FROM kv'), "f");
-    }
-    get(key) {
-        const row = __classPrivateFieldGet(this, _KeyValueStore_getStmt, "f").get(key);
-        if (!row) {
-            return undefined;
-        }
-        try {
-            return JSON.parse(row.value);
-        }
-        catch {
-            throw new Error(`Failed to parse stored value for key '${key}'`);
-        }
-    }
-    set(key, value) {
-        __classPrivateFieldGet(this, _KeyValueStore_setStmt, "f").run(key, JSON.stringify(value));
-    }
-    getAll() {
-        const rows = __classPrivateFieldGet(this, _KeyValueStore_getAllStmt, "f").all();
-        const result = {};
-        for (const row of rows) {
-            try {
-                result[row.key] = JSON.parse(row.value);
-            }
-            catch {
-                throw new Error(`Failed to parse stored value for key '${row.key}'`);
-            }
-        }
-        return result;
-    }
-    delete(key) {
-        __classPrivateFieldGet(this, _KeyValueStore_deleteStmt, "f").run(key);
-    }
-    close() {
-        __classPrivateFieldGet(this, _KeyValueStore_db, "f").close();
-    }
-}
-_KeyValueStore_db = new WeakMap(), _KeyValueStore_getStmt = new WeakMap(), _KeyValueStore_setStmt = new WeakMap(), _KeyValueStore_deleteStmt = new WeakMap(), _KeyValueStore_getAllStmt = new WeakMap();
-//# sourceMappingURL=KeyValueStore.mjs.map

package/dist/persistence/KeyValueStore.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"KeyValueStore.mjs","sourceRoot":"","sources":["../../src/persistence/KeyValueStore.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,OAAO,OAAM,uBAAuB;;AAEpC;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAWxB,YAAY,YAAoB;QAVvB,oCAAqB;QAErB,yCAAoE;QAEpE,yCAAmD;QAEnD,4CAA8C;QAE9C,4CAAkE;QAGzE,uBAAA,IAAI,qBAAO,IAAI,MAAM,CAAC,YAAY,CAAC,MAAA,CAAC;QACpC,uBAAA,IAAI,yBAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACtC,uBAAA,IAAI,yBAAI,CAAC,IAAI,CACX,2EAA2E,CAC5E,CAAC;QAEF,uBAAA,IAAI,0BAAY,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAAC,oCAAoC,CAAC,MAAA,CAAC;QACvE,uBAAA,IAAI,0BAAY,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAC9B,sDAAsD,CACvD,MAAA,CAAC;QACF,uBAAA,IAAI,6BAAe,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC,MAAA,CAAC;QACpE,uBAAA,IAAI,6BAAe,uBAAA,IAAI,yBAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,MAAA,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,GAAG,GAAG,uBAAA,IAAI,8BAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,GAAG,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAW;QAC1B,uBAAA,IAAI,8BAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAG,uBAAA,IAAI,iCAAY,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,MAAM,GAAyB,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,uBAAA,IAAI,iCAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,uBAAA,IAAI,yBAAI,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF","sourcesContent":["import type { Json } from '@metamask/utils';\nimport Sqlite from 'better-sqlite3';\n\n/**\n * A synchronous key-value store backed by better-sqlite3.\n *\n * Uses a single `kv` table with TEXT key (primary key) and TEXT value\n * (JSON-serialized). Intended as the persistence backend for wallet\n * controller state.\n */\nexport class KeyValueStore {\n  readonly #db: Sqlite.Database;\n\n  readonly #getStmt: Sqlite.Statement<[string], { value: string } | undefined>;\n\n  readonly #setStmt: Sqlite.Statement<[string, string], void>;\n\n  readonly #deleteStmt: Sqlite.Statement<[string], void>;\n\n  readonly #getAllStmt: Sqlite.Statement<[], { key: string; value: string }>;\n\n  constructor(databasePath: string) {\n    this.#db = new Sqlite(databasePath);\n    this.#db.pragma('journal_mode = WAL');\n    this.#db.exec(\n      'CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY, value TEXT NOT NULL)',\n    );\n\n    this.#getStmt = this.#db.prepare('SELECT value FROM kv WHERE key = ?');\n    this.#setStmt = this.#db.prepare(\n      'INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)',\n    );\n    this.#deleteStmt = this.#db.prepare('DELETE FROM kv WHERE key = ?');\n    this.#getAllStmt = this.#db.prepare('SELECT key, value FROM kv');\n  }\n\n  get(key: string): Json | undefined {\n    const row = this.#getStmt.get(key);\n    if (!row) {\n      return undefined;\n    }\n    try {\n      return JSON.parse(row.value);\n    } catch {\n      throw new Error(`Failed to parse stored value for key '${key}'`);\n    }\n  }\n\n  set(key: string, value: Json): void {\n    this.#setStmt.run(key, JSON.stringify(value));\n  }\n\n  getAll(): Record<string, Json> {\n    const rows = this.#getAllStmt.all();\n    const result: Record<string, Json> = {};\n    for (const row of rows) {\n      try {\n        result[row.key] = JSON.parse(row.value);\n      } catch {\n        throw new Error(`Failed to parse stored value for key '${row.key}'`);\n      }\n    }\n    return result;\n  }\n\n  delete(key: string): void {\n    this.#deleteStmt.run(key);\n  }\n\n  close(): void {\n    this.#db.close();\n  }\n}\n"]}

package/dist/persistence/persistence.cjs

@@ -1,204 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.subscribeToChanges = exports.loadState = void 0;
-const utils_1 = require("@metamask/utils");
-/**
- * Construct a store key from a controller name and property name.
- *
- * @param controllerName - The controller name.
- * @param propertyName - The property name.
- * @returns The store key in the format `ControllerName.propertyName`.
- */
-function storeKey(controllerName, propertyName) {
-    return `${controllerName}.${propertyName}`;
-}
-/**
- * Load persisted state from the key-value store and reconstruct it as
- * a record keyed by controller name.
- *
- * Keys in the store follow the format `ControllerName.propertyName`.
- * This function groups them into `{ [controllerName]: { [propertyName]: value } }`.
- *
- * Only properties that are currently persist-flagged in `controllerMetadata`
- * are rehydrated. Rows for controllers or properties that no longer exist — or
- * whose `persist` flag has since been disabled — are ignored. This keeps
- * loading symmetric with {@link subscribeToChanges}, which only ever writes
- * persist-flagged properties: without the filter, a migration that stops
- * persisting a property would leave its stale row on disk to be resurrected
- * into the `Wallet` constructor state on the next restart.
- *
- * @param store - The key-value store to read from.
- * @param controllerMetadata - A map from controller name to its state metadata,
- * used to filter out keys that are no longer persist-flagged.
- * @returns A record of controller states, keyed by controller name, suitable
- * for the `state` option of the `Wallet` constructor.
- */
-function loadState(store, controllerMetadata) {
-    const allPairs = store.getAll();
-    const state = {};
-    for (const [key, value] of Object.entries(allPairs)) {
-        const dotIndex = key.indexOf('.');
-        if (dotIndex === -1) {
-            throw new Error(`Invalid key in store: '${key}'. Expected format 'ControllerName.propertyName'.`);
-        }
-        const controllerName = key.slice(0, dotIndex);
-        const propertyName = key.slice(dotIndex + 1);
-        if (!controllerName || !propertyName) {
-            throw new Error(`Invalid key in store: '${key}'. Both controller name and property name must be non-empty.`);
-        }
-        if (!isPersisted(controllerMetadata[controllerName], propertyName)) {
-            continue;
-        }
-        if (!state[controllerName]) {
-            state[controllerName] = {};
-        }
-        state[controllerName][propertyName] = value;
-    }
-    return state;
-}
-exports.loadState = loadState;
-/**
- * Subscribe to all controller `stateChanged` events and persist changes
- * to the key-value store.
- *
- * For each controller's metadata, this function determines which state
- * properties are persist-flagged. When a `stateChanged` event fires, it uses
- * the Immer patches to identify which top-level properties changed, filters
- * to only persist-flagged properties, and writes them to the store.
- *
- * @param messenger - The root messenger to subscribe on.
- * @param controllerMetadata - A map from controller name to its state metadata.
- * @param store - The key-value store to write to.
- * @param log - Optional logger for persistence-write failures. Defaults to
- * `console.error` when omitted. A daemon host should supply its own logger,
- * since a backgrounded daemon's stdio may be discarded.
- * @returns A function that unsubscribes all persistence handlers.
- */
-function subscribeToChanges(messenger, controllerMetadata, store, log) {
-    const unsubscribers = [];
-    const logFn = log ??
-        ((message) => {
-            console.error(message);
-        });
-    for (const [controllerName, metadata] of Object.entries(controllerMetadata)) {
-        const persistedProperties = getPersistPropertyNames(metadata);
-        if (persistedProperties.size === 0) {
-            continue;
-        }
-        const eventType = `${controllerName}:stateChanged`;
-        const handler = (state, patches) => {
-            const changed = getChangedProperties(patches, persistedProperties);
-            for (const prop of changed) {
-                const key = storeKey(controllerName, prop);
-                const removed = !(0, utils_1.hasProperty)(state, prop);
-                // Derive the value before the try/catch so a throwing `StateDeriver`
-                // surfaces as its own error instead of a misreported write failure.
-                const persistFlag = metadata[prop]?.persist;
-                const value = !removed && typeof persistFlag === 'function'
-                    ? persistFlag(state[prop])
-                    : state[prop];
-                try {
-                    if (removed) {
-                        store.delete(key);
-                    }
-                    else {
-                        store.set(key, value);
-                    }
-                }
-                catch (error) {
-                    // TODO: Surface persistence-write failures up the stack so callers
-                    // can decide to halt rather than continue with diverging in-memory
-                    // and on-disk state. For now, log and continue.
-                    logFn(`Failed to persist state for ${key}: ${String(error)}`);
-                }
-            }
-        };
-        unsubscribers.push(subscribeToStateChanged(messenger, eventType, handler));
-    }
-    const unsubscribeAll = () => {
-        while (unsubscribers.length > 0) {
-            unsubscribers.pop()?.();
-        }
-    };
-    return unsubscribeAll;
-}
-exports.subscribeToChanges = subscribeToChanges;
-/**
- * Subscribe a handler to a controller's `stateChanged` event.
- *
- * The event name is built from a runtime controller name, so it widens to
- * `string` and cannot be proven to be a literal member of the messenger's event
- * union at compile time. This helper localizes that single unavoidable cast
- * behind a typed {@link StateChangedHandler}, so the `(state, patches)` payload
- * shape stays compile-checked at every call site instead of being erased by a
- * statement-level `@ts-expect-error`.
- *
- * @param messenger - The root messenger to subscribe on.
- * @param eventType - The `${controllerName}:stateChanged` event name.
- * @param handler - The state-change handler to register.
- * @returns A function that unsubscribes the handler.
- */
-function subscribeToStateChanged(messenger, eventType, handler) {
-    const subscriber = messenger;
-    subscriber.subscribe(eventType, handler);
-    return () => {
-        subscriber.unsubscribe(eventType, handler);
-    };
-}
-/**
- * Determine whether a property is currently persist-flagged.
- *
- * The `persist` flag is truthy when it is `true` or a `StateDeriver` function,
- * and falsy when it is `false` or when the controller or property is absent
- * from the metadata. `loadState` and `subscribeToChanges` share this predicate
- * so the read and write paths can never disagree on what counts as persisted.
- *
- * @param metadata - The controller's state metadata, or `undefined` when the
- * controller is absent from the metadata map.
- * @param propertyName - The property name to check.
- * @returns `true` if the property should be persisted.
- */
-function isPersisted(metadata, propertyName) {
-    return Boolean(metadata?.[propertyName]?.persist);
-}
-/**
- * Get the set of property names whose `persist` metadata is truthy
- * (either `true` or a `StateDeriver` function).
- *
- * @param metadata - The controller's state metadata.
- * @returns A set of property names that should be persisted.
- */
-function getPersistPropertyNames(metadata) {
-    const names = new Set();
-    for (const key of Object.keys(metadata)) {
-        if (isPersisted(metadata, key)) {
-            names.add(key);
-        }
-    }
-    return names;
-}
-/**
- * Extracts the set of persist-flagged top-level property names that changed
- * from an array of Immer patches.
- *
- * If any patch has an empty path (indicating a root state replacement),
- * all persist-flagged properties are returned.
- *
- * @param patches - Immer patches from a state update.
- * @param persistedProperties - The set of persist-flagged property names.
- * @returns A set of top-level property names that were modified.
- */
-function getChangedProperties(patches, persistedProperties) {
-    const changed = new Set();
-    for (const patch of patches) {
-        if (patch.path.length === 0) {
-            return persistedProperties;
-        }
-        const prop = String(patch.path[0]);
-        if (persistedProperties.has(prop)) {
-            changed.add(prop);
-        }
-    }
-    return changed;
-}
-//# sourceMappingURL=persistence.cjs.map

package/dist/persistence/persistence.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.cjs","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { hasProperty } from '@metamask/utils';\nimport type { Json } from '@metamask/utils';\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from '@metamask/wallet';\nimport type { Patch } from 'immer';\n\nimport type { KeyValueStore } from './KeyValueStore';\n\n/**\n * Handler for a controller's `stateChanged` event: the new controller state and\n * the Immer patches describing what changed.\n */\ntype StateChangedHandler = (\n  state: Record<string, Json>,\n  patches: Patch[],\n) => void;\n\n/**\n * Construct a store key from a controller name and property name.\n *\n * @param controllerName - The controller name.\n * @param propertyName - The property name.\n * @returns The store key in the format `ControllerName.propertyName`.\n */\nfunction storeKey(controllerName: string, propertyName: string): string {\n  return `${controllerName}.${propertyName}`;\n}\n\n/**\n * Load persisted state from the key-value store and reconstruct it as\n * a record keyed by controller name.\n *\n * Keys in the store follow the format `ControllerName.propertyName`.\n * This function groups them into `{ [controllerName]: { [propertyName]: value } }`.\n *\n * Only properties that are currently persist-flagged in `controllerMetadata`\n * are rehydrated. Rows for controllers or properties that no longer exist — or\n * whose `persist` flag has since been disabled — are ignored. This keeps\n * loading symmetric with {@link subscribeToChanges}, which only ever writes\n * persist-flagged properties: without the filter, a migration that stops\n * persisting a property would leave its stale row on disk to be resurrected\n * into the `Wallet` constructor state on the next restart.\n *\n * @param store - The key-value store to read from.\n * @param controllerMetadata - A map from controller name to its state metadata,\n * used to filter out keys that are no longer persist-flagged.\n * @returns A record of controller states, keyed by controller name, suitable\n * for the `state` option of the `Wallet` constructor.\n */\nexport function loadState(\n  store: KeyValueStore,\n  controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >,\n): Record<string, Record<string, Json>> {\n  const allPairs = store.getAll();\n  const state: Record<string, Record<string, Json>> = {};\n\n  for (const [key, value] of Object.entries(allPairs)) {\n    const dotIndex = key.indexOf('.');\n    if (dotIndex === -1) {\n      throw new Error(\n        `Invalid key in store: '${key}'. Expected format 'ControllerName.propertyName'.`,\n      );\n    }\n    const controllerName = key.slice(0, dotIndex);\n    const propertyName = key.slice(dotIndex + 1);\n\n    if (!controllerName || !propertyName) {\n      throw new Error(\n        `Invalid key in store: '${key}'. Both controller name and property name must be non-empty.`,\n      );\n    }\n\n    if (!isPersisted(controllerMetadata[controllerName], propertyName)) {\n      continue;\n    }\n\n    if (!state[controllerName]) {\n      state[controllerName] = {};\n    }\n    state[controllerName][propertyName] = value;\n  }\n  return state;\n}\n\n/**\n * Subscribe to all controller `stateChanged` events and persist changes\n * to the key-value store.\n *\n * For each controller's metadata, this function determines which state\n * properties are persist-flagged. When a `stateChanged` event fires, it uses\n * the Immer patches to identify which top-level properties changed, filters\n * to only persist-flagged properties, and writes them to the store.\n *\n * @param messenger - The root messenger to subscribe on.\n * @param controllerMetadata - A map from controller name to its state metadata.\n * @param store - The key-value store to write to.\n * @param log - Optional logger for persistence-write failures. Defaults to\n * `console.error` when omitted. A daemon host should supply its own logger,\n * since a backgrounded daemon's stdio may be discarded.\n * @returns A function that unsubscribes all persistence handlers.\n */\nexport function subscribeToChanges(\n  messenger: RootMessenger<DefaultActions, DefaultEvents>,\n  controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >,\n  store: KeyValueStore,\n  log?: (message: string) => void,\n): () => void {\n  const unsubscribers: (() => void)[] = [];\n  const logFn =\n    log ??\n    ((message: string): void => {\n      console.error(message);\n    });\n\n  for (const [controllerName, metadata] of Object.entries(controllerMetadata)) {\n    const persistedProperties = getPersistPropertyNames(metadata);\n    if (persistedProperties.size === 0) {\n      continue;\n    }\n\n    const eventType = `${controllerName}:stateChanged`;\n\n    const handler: StateChangedHandler = (state, patches) => {\n      const changed = getChangedProperties(patches, persistedProperties);\n\n      for (const prop of changed) {\n        const key = storeKey(controllerName, prop);\n        const removed = !hasProperty(state, prop);\n\n        // Derive the value before the try/catch so a throwing `StateDeriver`\n        // surfaces as its own error instead of a misreported write failure.\n        const persistFlag = metadata[prop]?.persist;\n        const value =\n          !removed && typeof persistFlag === 'function'\n            ? persistFlag(state[prop] as never)\n            : state[prop];\n\n        try {\n          if (removed) {\n            store.delete(key);\n          } else {\n            store.set(key, value);\n          }\n        } catch (error) {\n          // TODO: Surface persistence-write failures up the stack so callers\n          // can decide to halt rather than continue with diverging in-memory\n          // and on-disk state. For now, log and continue.\n          logFn(`Failed to persist state for ${key}: ${String(error)}`);\n        }\n      }\n    };\n\n    unsubscribers.push(subscribeToStateChanged(messenger, eventType, handler));\n  }\n\n  const unsubscribeAll = (): void => {\n    while (unsubscribers.length > 0) {\n      unsubscribers.pop()?.();\n    }\n  };\n\n  return unsubscribeAll;\n}\n\n/**\n * Subscribe a handler to a controller's `stateChanged` event.\n *\n * The event name is built from a runtime controller name, so it widens to\n * `string` and cannot be proven to be a literal member of the messenger's event\n * union at compile time. This helper localizes that single unavoidable cast\n * behind a typed {@link StateChangedHandler}, so the `(state, patches)` payload\n * shape stays compile-checked at every call site instead of being erased by a\n * statement-level `@ts-expect-error`.\n *\n * @param messenger - The root messenger to subscribe on.\n * @param eventType - The `${controllerName}:stateChanged` event name.\n * @param handler - The state-change handler to register.\n * @returns A function that unsubscribes the handler.\n */\nfunction subscribeToStateChanged(\n  messenger: RootMessenger<DefaultActions, DefaultEvents>,\n  eventType: string,\n  handler: StateChangedHandler,\n): () => void {\n  const subscriber = messenger as unknown as {\n    subscribe: (eventType: string, handler: StateChangedHandler) => void;\n    unsubscribe: (eventType: string, handler: StateChangedHandler) => void;\n  };\n  subscriber.subscribe(eventType, handler);\n  return () => {\n    subscriber.unsubscribe(eventType, handler);\n  };\n}\n\n/**\n * Determine whether a property is currently persist-flagged.\n *\n * The `persist` flag is truthy when it is `true` or a `StateDeriver` function,\n * and falsy when it is `false` or when the controller or property is absent\n * from the metadata. `loadState` and `subscribeToChanges` share this predicate\n * so the read and write paths can never disagree on what counts as persisted.\n *\n * @param metadata - The controller's state metadata, or `undefined` when the\n * controller is absent from the metadata map.\n * @param propertyName - The property name to check.\n * @returns `true` if the property should be persisted.\n */\nfunction isPersisted(\n  metadata: Readonly<StateMetadataConstraint> | undefined,\n  propertyName: string,\n): boolean {\n  return Boolean(metadata?.[propertyName]?.persist);\n}\n\n/**\n * Get the set of property names whose `persist` metadata is truthy\n * (either `true` or a `StateDeriver` function).\n *\n * @param metadata - The controller's state metadata.\n * @returns A set of property names that should be persisted.\n */\nfunction getPersistPropertyNames(\n  metadata: StateMetadataConstraint,\n): ReadonlySet<string> {\n  const names = new Set<string>();\n  for (const key of Object.keys(metadata)) {\n    if (isPersisted(metadata, key)) {\n      names.add(key);\n    }\n  }\n  return names;\n}\n\n/**\n * Extracts the set of persist-flagged top-level property names that changed\n * from an array of Immer patches.\n *\n * If any patch has an empty path (indicating a root state replacement),\n * all persist-flagged properties are returned.\n *\n * @param patches - Immer patches from a state update.\n * @param persistedProperties - The set of persist-flagged property names.\n * @returns A set of top-level property names that were modified.\n */\nfunction getChangedProperties(\n  patches: Patch[],\n  persistedProperties: ReadonlySet<string>,\n): ReadonlySet<string> {\n  const changed = new Set<string>();\n  for (const patch of patches) {\n    if (patch.path.length === 0) {\n      return persistedProperties;\n    }\n\n    const prop = String(patch.path[0]);\n    if (persistedProperties.has(prop)) {\n      changed.add(prop);\n    }\n  }\n  return changed;\n}\n"]}

package/dist/persistence/persistence.d.cts

@@ -1,45 +0,0 @@
-import type { StateMetadataConstraint } from "@metamask/base-controller";
-import type { Json } from "@metamask/utils";
-import type { DefaultActions, DefaultEvents, RootMessenger } from "@metamask/wallet";
-import type { KeyValueStore } from "./KeyValueStore.cjs";
-/**
- * Load persisted state from the key-value store and reconstruct it as
- * a record keyed by controller name.
- *
- * Keys in the store follow the format `ControllerName.propertyName`.
- * This function groups them into `{ [controllerName]: { [propertyName]: value } }`.
- *
- * Only properties that are currently persist-flagged in `controllerMetadata`
- * are rehydrated. Rows for controllers or properties that no longer exist — or
- * whose `persist` flag has since been disabled — are ignored. This keeps
- * loading symmetric with {@link subscribeToChanges}, which only ever writes
- * persist-flagged properties: without the filter, a migration that stops
- * persisting a property would leave its stale row on disk to be resurrected
- * into the `Wallet` constructor state on the next restart.
- *
- * @param store - The key-value store to read from.
- * @param controllerMetadata - A map from controller name to its state metadata,
- * used to filter out keys that are no longer persist-flagged.
- * @returns A record of controller states, keyed by controller name, suitable
- * for the `state` option of the `Wallet` constructor.
- */
-export declare function loadState(store: KeyValueStore, controllerMetadata: Readonly<Record<string, Readonly<StateMetadataConstraint>>>): Record<string, Record<string, Json>>;
-/**
- * Subscribe to all controller `stateChanged` events and persist changes
- * to the key-value store.
- *
- * For each controller's metadata, this function determines which state
- * properties are persist-flagged. When a `stateChanged` event fires, it uses
- * the Immer patches to identify which top-level properties changed, filters
- * to only persist-flagged properties, and writes them to the store.
- *
- * @param messenger - The root messenger to subscribe on.
- * @param controllerMetadata - A map from controller name to its state metadata.
- * @param store - The key-value store to write to.
- * @param log - Optional logger for persistence-write failures. Defaults to
- * `console.error` when omitted. A daemon host should supply its own logger,
- * since a backgrounded daemon's stdio may be discarded.
- * @returns A function that unsubscribes all persistence handlers.
- */
-export declare function subscribeToChanges(messenger: RootMessenger<DefaultActions, DefaultEvents>, controllerMetadata: Readonly<Record<string, Readonly<StateMetadataConstraint>>>, store: KeyValueStore, log?: (message: string) => void): () => void;
-//# sourceMappingURL=persistence.d.cts.map

package/dist/persistence/persistence.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.d.cts","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAEzE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAC5C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,yBAAyB;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,4BAAwB;AAsBrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,kBAAkB,EAAE,QAAQ,CAC1B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CA8BtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,EACvD,kBAAkB,EAAE,QAAQ,CAC1B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,EACD,KAAK,EAAE,aAAa,EACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,MAAM,IAAI,CAwDZ"}

package/dist/persistence/persistence.d.mts

@@ -1,45 +0,0 @@
-import type { StateMetadataConstraint } from "@metamask/base-controller";
-import type { Json } from "@metamask/utils";
-import type { DefaultActions, DefaultEvents, RootMessenger } from "@metamask/wallet";
-import type { KeyValueStore } from "./KeyValueStore.mjs";
-/**
- * Load persisted state from the key-value store and reconstruct it as
- * a record keyed by controller name.
- *
- * Keys in the store follow the format `ControllerName.propertyName`.
- * This function groups them into `{ [controllerName]: { [propertyName]: value } }`.
- *
- * Only properties that are currently persist-flagged in `controllerMetadata`
- * are rehydrated. Rows for controllers or properties that no longer exist — or
- * whose `persist` flag has since been disabled — are ignored. This keeps
- * loading symmetric with {@link subscribeToChanges}, which only ever writes
- * persist-flagged properties: without the filter, a migration that stops
- * persisting a property would leave its stale row on disk to be resurrected
- * into the `Wallet` constructor state on the next restart.
- *
- * @param store - The key-value store to read from.
- * @param controllerMetadata - A map from controller name to its state metadata,
- * used to filter out keys that are no longer persist-flagged.
- * @returns A record of controller states, keyed by controller name, suitable
- * for the `state` option of the `Wallet` constructor.
- */
-export declare function loadState(store: KeyValueStore, controllerMetadata: Readonly<Record<string, Readonly<StateMetadataConstraint>>>): Record<string, Record<string, Json>>;
-/**
- * Subscribe to all controller `stateChanged` events and persist changes
- * to the key-value store.
- *
- * For each controller's metadata, this function determines which state
- * properties are persist-flagged. When a `stateChanged` event fires, it uses
- * the Immer patches to identify which top-level properties changed, filters
- * to only persist-flagged properties, and writes them to the store.
- *
- * @param messenger - The root messenger to subscribe on.
- * @param controllerMetadata - A map from controller name to its state metadata.
- * @param store - The key-value store to write to.
- * @param log - Optional logger for persistence-write failures. Defaults to
- * `console.error` when omitted. A daemon host should supply its own logger,
- * since a backgrounded daemon's stdio may be discarded.
- * @returns A function that unsubscribes all persistence handlers.
- */
-export declare function subscribeToChanges(messenger: RootMessenger<DefaultActions, DefaultEvents>, controllerMetadata: Readonly<Record<string, Readonly<StateMetadataConstraint>>>, store: KeyValueStore, log?: (message: string) => void): () => void;
-//# sourceMappingURL=persistence.d.mts.map

package/dist/persistence/persistence.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.d.mts","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAEzE,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAC5C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,yBAAyB;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,4BAAwB;AAsBrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,kBAAkB,EAAE,QAAQ,CAC1B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CA8BtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,EACvD,kBAAkB,EAAE,QAAQ,CAC1B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,EACD,KAAK,EAAE,aAAa,EACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,MAAM,IAAI,CAwDZ"}

package/dist/persistence/persistence.mjs

@@ -1,199 +0,0 @@
-import { hasProperty } from "@metamask/utils";
-/**
- * Construct a store key from a controller name and property name.
- *
- * @param controllerName - The controller name.
- * @param propertyName - The property name.
- * @returns The store key in the format `ControllerName.propertyName`.
- */
-function storeKey(controllerName, propertyName) {
-    return `${controllerName}.${propertyName}`;
-}
-/**
- * Load persisted state from the key-value store and reconstruct it as
- * a record keyed by controller name.
- *
- * Keys in the store follow the format `ControllerName.propertyName`.
- * This function groups them into `{ [controllerName]: { [propertyName]: value } }`.
- *
- * Only properties that are currently persist-flagged in `controllerMetadata`
- * are rehydrated. Rows for controllers or properties that no longer exist — or
- * whose `persist` flag has since been disabled — are ignored. This keeps
- * loading symmetric with {@link subscribeToChanges}, which only ever writes
- * persist-flagged properties: without the filter, a migration that stops
- * persisting a property would leave its stale row on disk to be resurrected
- * into the `Wallet` constructor state on the next restart.
- *
- * @param store - The key-value store to read from.
- * @param controllerMetadata - A map from controller name to its state metadata,
- * used to filter out keys that are no longer persist-flagged.
- * @returns A record of controller states, keyed by controller name, suitable
- * for the `state` option of the `Wallet` constructor.
- */
-export function loadState(store, controllerMetadata) {
-    const allPairs = store.getAll();
-    const state = {};
-    for (const [key, value] of Object.entries(allPairs)) {
-        const dotIndex = key.indexOf('.');
-        if (dotIndex === -1) {
-            throw new Error(`Invalid key in store: '${key}'. Expected format 'ControllerName.propertyName'.`);
-        }
-        const controllerName = key.slice(0, dotIndex);
-        const propertyName = key.slice(dotIndex + 1);
-        if (!controllerName || !propertyName) {
-            throw new Error(`Invalid key in store: '${key}'. Both controller name and property name must be non-empty.`);
-        }
-        if (!isPersisted(controllerMetadata[controllerName], propertyName)) {
-            continue;
-        }
-        if (!state[controllerName]) {
-            state[controllerName] = {};
-        }
-        state[controllerName][propertyName] = value;
-    }
-    return state;
-}
-/**
- * Subscribe to all controller `stateChanged` events and persist changes
- * to the key-value store.
- *
- * For each controller's metadata, this function determines which state
- * properties are persist-flagged. When a `stateChanged` event fires, it uses
- * the Immer patches to identify which top-level properties changed, filters
- * to only persist-flagged properties, and writes them to the store.
- *
- * @param messenger - The root messenger to subscribe on.
- * @param controllerMetadata - A map from controller name to its state metadata.
- * @param store - The key-value store to write to.
- * @param log - Optional logger for persistence-write failures. Defaults to
- * `console.error` when omitted. A daemon host should supply its own logger,
- * since a backgrounded daemon's stdio may be discarded.
- * @returns A function that unsubscribes all persistence handlers.
- */
-export function subscribeToChanges(messenger, controllerMetadata, store, log) {
-    const unsubscribers = [];
-    const logFn = log ??
-        ((message) => {
-            console.error(message);
-        });
-    for (const [controllerName, metadata] of Object.entries(controllerMetadata)) {
-        const persistedProperties = getPersistPropertyNames(metadata);
-        if (persistedProperties.size === 0) {
-            continue;
-        }
-        const eventType = `${controllerName}:stateChanged`;
-        const handler = (state, patches) => {
-            const changed = getChangedProperties(patches, persistedProperties);
-            for (const prop of changed) {
-                const key = storeKey(controllerName, prop);
-                const removed = !hasProperty(state, prop);
-                // Derive the value before the try/catch so a throwing `StateDeriver`
-                // surfaces as its own error instead of a misreported write failure.
-                const persistFlag = metadata[prop]?.persist;
-                const value = !removed && typeof persistFlag === 'function'
-                    ? persistFlag(state[prop])
-                    : state[prop];
-                try {
-                    if (removed) {
-                        store.delete(key);
-                    }
-                    else {
-                        store.set(key, value);
-                    }
-                }
-                catch (error) {
-                    // TODO: Surface persistence-write failures up the stack so callers
-                    // can decide to halt rather than continue with diverging in-memory
-                    // and on-disk state. For now, log and continue.
-                    logFn(`Failed to persist state for ${key}: ${String(error)}`);
-                }
-            }
-        };
-        unsubscribers.push(subscribeToStateChanged(messenger, eventType, handler));
-    }
-    const unsubscribeAll = () => {
-        while (unsubscribers.length > 0) {
-            unsubscribers.pop()?.();
-        }
-    };
-    return unsubscribeAll;
-}
-/**
- * Subscribe a handler to a controller's `stateChanged` event.
- *
- * The event name is built from a runtime controller name, so it widens to
- * `string` and cannot be proven to be a literal member of the messenger's event
- * union at compile time. This helper localizes that single unavoidable cast
- * behind a typed {@link StateChangedHandler}, so the `(state, patches)` payload
- * shape stays compile-checked at every call site instead of being erased by a
- * statement-level `@ts-expect-error`.
- *
- * @param messenger - The root messenger to subscribe on.
- * @param eventType - The `${controllerName}:stateChanged` event name.
- * @param handler - The state-change handler to register.
- * @returns A function that unsubscribes the handler.
- */
-function subscribeToStateChanged(messenger, eventType, handler) {
-    const subscriber = messenger;
-    subscriber.subscribe(eventType, handler);
-    return () => {
-        subscriber.unsubscribe(eventType, handler);
-    };
-}
-/**
- * Determine whether a property is currently persist-flagged.
- *
- * The `persist` flag is truthy when it is `true` or a `StateDeriver` function,
- * and falsy when it is `false` or when the controller or property is absent
- * from the metadata. `loadState` and `subscribeToChanges` share this predicate
- * so the read and write paths can never disagree on what counts as persisted.
- *
- * @param metadata - The controller's state metadata, or `undefined` when the
- * controller is absent from the metadata map.
- * @param propertyName - The property name to check.
- * @returns `true` if the property should be persisted.
- */
-function isPersisted(metadata, propertyName) {
-    return Boolean(metadata?.[propertyName]?.persist);
-}
-/**
- * Get the set of property names whose `persist` metadata is truthy
- * (either `true` or a `StateDeriver` function).
- *
- * @param metadata - The controller's state metadata.
- * @returns A set of property names that should be persisted.
- */
-function getPersistPropertyNames(metadata) {
-    const names = new Set();
-    for (const key of Object.keys(metadata)) {
-        if (isPersisted(metadata, key)) {
-            names.add(key);
-        }
-    }
-    return names;
-}
-/**
- * Extracts the set of persist-flagged top-level property names that changed
- * from an array of Immer patches.
- *
- * If any patch has an empty path (indicating a root state replacement),
- * all persist-flagged properties are returned.
- *
- * @param patches - Immer patches from a state update.
- * @param persistedProperties - The set of persist-flagged property names.
- * @returns A set of top-level property names that were modified.
- */
-function getChangedProperties(patches, persistedProperties) {
-    const changed = new Set();
-    for (const patch of patches) {
-        if (patch.path.length === 0) {
-            return persistedProperties;
-        }
-        const prop = String(patch.path[0]);
-        if (persistedProperties.has(prop)) {
-            changed.add(prop);
-        }
-    }
-    return changed;
-}
-//# sourceMappingURL=persistence.mjs.map

package/dist/persistence/persistence.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.mjs","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,wBAAwB;AAoB9C;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,cAAsB,EAAE,YAAoB;IAC5D,OAAO,GAAG,cAAc,IAAI,YAAY,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,SAAS,CACvB,KAAoB,EACpB,kBAEC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,KAAK,GAAyC,EAAE,CAAC;IAEvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,0BAA0B,GAAG,mDAAmD,CACjF,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAE7C,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,0BAA0B,GAAG,8DAA8D,CAC5F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC;YACnE,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAuD,EACvD,kBAEC,EACD,KAAoB,EACpB,GAA+B;IAE/B,MAAM,aAAa,GAAmB,EAAE,CAAC;IACzC,MAAM,KAAK,GACT,GAAG;QACH,CAAC,CAAC,OAAe,EAAQ,EAAE;YACzB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IAEL,KAAK,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5E,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,mBAAmB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,cAAc,eAAe,CAAC;QAEnD,MAAM,OAAO,GAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACtD,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;YAEnE,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAE1C,qEAAqE;gBACrE,oEAAoE;gBACpE,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAC5C,MAAM,KAAK,GACT,CAAC,OAAO,IAAI,OAAO,WAAW,KAAK,UAAU;oBAC3C,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAU,CAAC;oBACnC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAElB,IAAI,CAAC;oBACH,IAAI,OAAO,EAAE,CAAC;wBACZ,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACpB,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,mEAAmE;oBACnE,mEAAmE;oBACnE,gDAAgD;oBAChD,KAAK,CAAC,+BAA+B,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,aAAa,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,cAAc,GAAG,GAAS,EAAE;QAChC,OAAO,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,uBAAuB,CAC9B,SAAuD,EACvD,SAAiB,EACjB,OAA4B;IAE5B,MAAM,UAAU,GAAG,SAGlB,CAAC;IACF,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,EAAE;QACV,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,WAAW,CAClB,QAAuD,EACvD,YAAoB;IAEpB,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,uBAAuB,CAC9B,QAAiC;IAEjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,IAAI,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,oBAAoB,CAC3B,OAAgB,EAChB,mBAAwC;IAExC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { hasProperty } from '@metamask/utils';\nimport type { Json } from '@metamask/utils';\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from '@metamask/wallet';\nimport type { Patch } from 'immer';\n\nimport type { KeyValueStore } from './KeyValueStore';\n\n/**\n * Handler for a controller's `stateChanged` event: the new controller state and\n * the Immer patches describing what changed.\n */\ntype StateChangedHandler = (\n  state: Record<string, Json>,\n  patches: Patch[],\n) => void;\n\n/**\n * Construct a store key from a controller name and property name.\n *\n * @param controllerName - The controller name.\n * @param propertyName - The property name.\n * @returns The store key in the format `ControllerName.propertyName`.\n */\nfunction storeKey(controllerName: string, propertyName: string): string {\n  return `${controllerName}.${propertyName}`;\n}\n\n/**\n * Load persisted state from the key-value store and reconstruct it as\n * a record keyed by controller name.\n *\n * Keys in the store follow the format `ControllerName.propertyName`.\n * This function groups them into `{ [controllerName]: { [propertyName]: value } }`.\n *\n * Only properties that are currently persist-flagged in `controllerMetadata`\n * are rehydrated. Rows for controllers or properties that no longer exist — or\n * whose `persist` flag has since been disabled — are ignored. This keeps\n * loading symmetric with {@link subscribeToChanges}, which only ever writes\n * persist-flagged properties: without the filter, a migration that stops\n * persisting a property would leave its stale row on disk to be resurrected\n * into the `Wallet` constructor state on the next restart.\n *\n * @param store - The key-value store to read from.\n * @param controllerMetadata - A map from controller name to its state metadata,\n * used to filter out keys that are no longer persist-flagged.\n * @returns A record of controller states, keyed by controller name, suitable\n * for the `state` option of the `Wallet` constructor.\n */\nexport function loadState(\n  store: KeyValueStore,\n  controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >,\n): Record<string, Record<string, Json>> {\n  const allPairs = store.getAll();\n  const state: Record<string, Record<string, Json>> = {};\n\n  for (const [key, value] of Object.entries(allPairs)) {\n    const dotIndex = key.indexOf('.');\n    if (dotIndex === -1) {\n      throw new Error(\n        `Invalid key in store: '${key}'. Expected format 'ControllerName.propertyName'.`,\n      );\n    }\n    const controllerName = key.slice(0, dotIndex);\n    const propertyName = key.slice(dotIndex + 1);\n\n    if (!controllerName || !propertyName) {\n      throw new Error(\n        `Invalid key in store: '${key}'. Both controller name and property name must be non-empty.`,\n      );\n    }\n\n    if (!isPersisted(controllerMetadata[controllerName], propertyName)) {\n      continue;\n    }\n\n    if (!state[controllerName]) {\n      state[controllerName] = {};\n    }\n    state[controllerName][propertyName] = value;\n  }\n  return state;\n}\n\n/**\n * Subscribe to all controller `stateChanged` events and persist changes\n * to the key-value store.\n *\n * For each controller's metadata, this function determines which state\n * properties are persist-flagged. When a `stateChanged` event fires, it uses\n * the Immer patches to identify which top-level properties changed, filters\n * to only persist-flagged properties, and writes them to the store.\n *\n * @param messenger - The root messenger to subscribe on.\n * @param controllerMetadata - A map from controller name to its state metadata.\n * @param store - The key-value store to write to.\n * @param log - Optional logger for persistence-write failures. Defaults to\n * `console.error` when omitted. A daemon host should supply its own logger,\n * since a backgrounded daemon's stdio may be discarded.\n * @returns A function that unsubscribes all persistence handlers.\n */\nexport function subscribeToChanges(\n  messenger: RootMessenger<DefaultActions, DefaultEvents>,\n  controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >,\n  store: KeyValueStore,\n  log?: (message: string) => void,\n): () => void {\n  const unsubscribers: (() => void)[] = [];\n  const logFn =\n    log ??\n    ((message: string): void => {\n      console.error(message);\n    });\n\n  for (const [controllerName, metadata] of Object.entries(controllerMetadata)) {\n    const persistedProperties = getPersistPropertyNames(metadata);\n    if (persistedProperties.size === 0) {\n      continue;\n    }\n\n    const eventType = `${controllerName}:stateChanged`;\n\n    const handler: StateChangedHandler = (state, patches) => {\n      const changed = getChangedProperties(patches, persistedProperties);\n\n      for (const prop of changed) {\n        const key = storeKey(controllerName, prop);\n        const removed = !hasProperty(state, prop);\n\n        // Derive the value before the try/catch so a throwing `StateDeriver`\n        // surfaces as its own error instead of a misreported write failure.\n        const persistFlag = metadata[prop]?.persist;\n        const value =\n          !removed && typeof persistFlag === 'function'\n            ? persistFlag(state[prop] as never)\n            : state[prop];\n\n        try {\n          if (removed) {\n            store.delete(key);\n          } else {\n            store.set(key, value);\n          }\n        } catch (error) {\n          // TODO: Surface persistence-write failures up the stack so callers\n          // can decide to halt rather than continue with diverging in-memory\n          // and on-disk state. For now, log and continue.\n          logFn(`Failed to persist state for ${key}: ${String(error)}`);\n        }\n      }\n    };\n\n    unsubscribers.push(subscribeToStateChanged(messenger, eventType, handler));\n  }\n\n  const unsubscribeAll = (): void => {\n    while (unsubscribers.length > 0) {\n      unsubscribers.pop()?.();\n    }\n  };\n\n  return unsubscribeAll;\n}\n\n/**\n * Subscribe a handler to a controller's `stateChanged` event.\n *\n * The event name is built from a runtime controller name, so it widens to\n * `string` and cannot be proven to be a literal member of the messenger's event\n * union at compile time. This helper localizes that single unavoidable cast\n * behind a typed {@link StateChangedHandler}, so the `(state, patches)` payload\n * shape stays compile-checked at every call site instead of being erased by a\n * statement-level `@ts-expect-error`.\n *\n * @param messenger - The root messenger to subscribe on.\n * @param eventType - The `${controllerName}:stateChanged` event name.\n * @param handler - The state-change handler to register.\n * @returns A function that unsubscribes the handler.\n */\nfunction subscribeToStateChanged(\n  messenger: RootMessenger<DefaultActions, DefaultEvents>,\n  eventType: string,\n  handler: StateChangedHandler,\n): () => void {\n  const subscriber = messenger as unknown as {\n    subscribe: (eventType: string, handler: StateChangedHandler) => void;\n    unsubscribe: (eventType: string, handler: StateChangedHandler) => void;\n  };\n  subscriber.subscribe(eventType, handler);\n  return () => {\n    subscriber.unsubscribe(eventType, handler);\n  };\n}\n\n/**\n * Determine whether a property is currently persist-flagged.\n *\n * The `persist` flag is truthy when it is `true` or a `StateDeriver` function,\n * and falsy when it is `false` or when the controller or property is absent\n * from the metadata. `loadState` and `subscribeToChanges` share this predicate\n * so the read and write paths can never disagree on what counts as persisted.\n *\n * @param metadata - The controller's state metadata, or `undefined` when the\n * controller is absent from the metadata map.\n * @param propertyName - The property name to check.\n * @returns `true` if the property should be persisted.\n */\nfunction isPersisted(\n  metadata: Readonly<StateMetadataConstraint> | undefined,\n  propertyName: string,\n): boolean {\n  return Boolean(metadata?.[propertyName]?.persist);\n}\n\n/**\n * Get the set of property names whose `persist` metadata is truthy\n * (either `true` or a `StateDeriver` function).\n *\n * @param metadata - The controller's state metadata.\n * @returns A set of property names that should be persisted.\n */\nfunction getPersistPropertyNames(\n  metadata: StateMetadataConstraint,\n): ReadonlySet<string> {\n  const names = new Set<string>();\n  for (const key of Object.keys(metadata)) {\n    if (isPersisted(metadata, key)) {\n      names.add(key);\n    }\n  }\n  return names;\n}\n\n/**\n * Extracts the set of persist-flagged top-level property names that changed\n * from an array of Immer patches.\n *\n * If any patch has an empty path (indicating a root state replacement),\n * all persist-flagged properties are returned.\n *\n * @param patches - Immer patches from a state update.\n * @param persistedProperties - The set of persist-flagged property names.\n * @returns A set of top-level property names that were modified.\n */\nfunction getChangedProperties(\n  patches: Patch[],\n  persistedProperties: ReadonlySet<string>,\n): ReadonlySet<string> {\n  const changed = new Set<string>();\n  for (const patch of patches) {\n    if (patch.path.length === 0) {\n      return persistedProperties;\n    }\n\n    const prop = String(patch.path[0]);\n    if (persistedProperties.has(prop)) {\n      changed.add(prop);\n    }\n  }\n  return changed;\n}\n"]}