@metamask-previews/account-tree-controller 7.6.1-preview-e57e5c3dc → 7.6.1-preview-c449b8da8

package/dist/state/snapshot.d.mts

@@ -0,0 +1,120 @@
+import type { IdMap } from "./id-map.mjs";
+import type { AccountGroupPayloadId, AccountTreePayload, AccountTreeSnapshotGroup, AccountTreeSnapshotWallet, AccountTreeWalletEntry, AccountWalletPayloadId } from "./payload.mjs";
+/**
+ * Immutable value object returned by {@link AccountTreeController.exportState}.
+ *
+ * Construct with {@link AccountTreeController.exportState},
+ * {@link AccountTreeSnapshot.deserialize}, or `new AccountTreeSnapshot(...)`
+ * for tests and advanced use.
+ *
+ * Wallet and group entries are deep-cloned and deep-frozen once in the
+ * constructor. Filtering predicates receive those read-only views directly;
+ * each filter method returns a new snapshot that repeats the process for its
+ * result.
+ *
+ * An optional ID map (local ↔ payload) may be supplied when bridging between
+ * internal controller IDs and the stable cross-device IDs in the serialized
+ * payload. The map covers the original export and is preserved unchanged
+ * through filtering until {@link serialize}. Omit it when deterministic IDs
+ * make {@link toLocalId} / {@link toPayloadId} unnecessary.
+ */
+export declare class AccountTreeSnapshot {
+    #private;
+    /**
+     * @param entries - Wallet entries in the snapshot.
+     * @param idMap - Optional local ↔ payload ID map from export.
+     */
+    constructor(entries: AccountTreeWalletEntry[], idMap?: IdMap);
+    /**
+     * Returns a new snapshot containing only the wallets for which
+     * `predicate` returns `true`.
+     *
+     * When filtering by wallet ID, compare against stable payload IDs from
+     * {@link serialize} or convert local IDs with {@link toPayloadId} first.
+     *
+     * @param predicate - Function called with each deeply read-only wallet entry.
+     * @returns A filtered snapshot.
+     */
+    filterWallets(predicate: (wallet: AccountTreeSnapshotWallet) => boolean): AccountTreeSnapshot;
+    /**
+     * Filters groups within one wallet. Other wallets are left unchanged.
+     *
+     * Throws if `walletId` does not identify a wallet in the snapshot.
+     * Removes the wallet if no groups remain after filtering — this prevents a
+     * mnemonic wallet with zero selected groups from still transferring its secret.
+     *
+     * **Mnemonic wallets:** group indices must remain contiguous starting at 0
+     * after filtering, because the payload schema enforces this invariant.
+     * Predicates that produce gaps (e.g. keeping only index 1, or 0 and 2) will
+     * cause {@link AccountTreeSnapshot.deserialize} to reject the payload on the
+     * receiving end.
+     *
+     * @param walletId - Stable payload wallet ID to filter groups within.
+     * @param predicate - Function called with each deeply read-only group entry.
+     * @returns A filtered snapshot.
+     * @throws If `walletId` is not present in the snapshot.
+     */
+    filterGroups(walletId: AccountWalletPayloadId, predicate: (group: AccountTreeSnapshotGroup) => boolean): AccountTreeSnapshot;
+    /**
+     * Filters groups across every wallet.
+     *
+     * The parent wallet is provided as context to the predicate. Removes any
+     * wallet with no remaining groups after filtering.
+     *
+     * **Mnemonic wallets:** see {@link filterGroups} for the contiguous-index
+     * constraint that applies here as well.
+     *
+     * @param predicate - Function called with each group and its parent wallet.
+     * @returns A filtered snapshot.
+     */
+    filterAllGroups(predicate: (group: AccountTreeSnapshotGroup, wallet: AccountTreeSnapshotWallet) => boolean): AccountTreeSnapshot;
+    /**
+     * Converts a payload ID (wallet or group) to the corresponding local
+     * `AccountTreeController` ID.
+     *
+     * The map reflects the original export, not the wallets/groups currently
+     * retained in this snapshot after filtering.
+     *
+     * @param payloadId - Stable cross-device wallet or group payload ID.
+     * @returns The local controller ID, or `undefined` if not found or no ID map is present.
+     */
+    toLocalId(payloadId: AccountWalletPayloadId | AccountGroupPayloadId): ReturnType<IdMap['getLocalId']>;
+    /**
+     * Converts a local `AccountTreeController` ID (wallet or group) to its
+     * stable cross-device payload ID.
+     *
+     * The map reflects the original export, not the wallets/groups currently
+     * retained in this snapshot after filtering.
+     *
+     * @param localId - Local controller wallet or group ID.
+     * @returns The payload ID, or `undefined` if not found or no ID map is present.
+     */
+    toPayloadId(localId: Parameters<IdMap['add']>[0]): ReturnType<IdMap['getPayloadId']>;
+    /**
+     * Serializes the snapshot to a flat {@link AccountTreePayload} with `version` inlined
+     * alongside the wallet entries.
+     *
+     * Returns the constructor-frozen wallet tree without copying it again.
+     *
+     * @returns The versioned flat payload.
+     */
+    serialize(): AccountTreePayload;
+    /**
+     * Validates a raw value as an {@link AccountTreePayload}, running any
+     * necessary version migrations, and returns an immutable snapshot.
+     *
+     * This is the entry point for untrusted serialized data. Unsupported schema
+     * versions and wallet types fail closed with an error instead of returning a
+     * partial snapshot.
+     *
+     * The returned snapshot has no ID map — {@link toLocalId} / {@link toPayloadId}
+     * return `undefined`. Pass an {@link IdMap} to the constructor when you need
+     * the map.
+     *
+     * @param raw - Unknown value to parse.
+     * @returns A validated snapshot.
+     * @throws If `raw` is not a valid payload or its version is unsupported.
+     */
+    static deserialize(raw: unknown): Promise<AccountTreeSnapshot>;
+}
+//# sourceMappingURL=snapshot.d.mts.map

package/dist/state/snapshot.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.mts","sourceRoot":"","sources":["../../src/state/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAoB;AACzC,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EAEtB,sBAAsB,EAEvB,sBAAqB;AAQtB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAmB;;IAK9B;;;OAGG;gBACS,OAAO,EAAE,sBAAsB,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK;IAK5D;;;;;;;;;OASG;IACH,aAAa,CACX,SAAS,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,OAAO,GACxD,mBAAmB;IAQtB;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CACV,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,GACtD,mBAAmB;IAkCtB;;;;;;;;;;;OAWG;IACH,eAAe,CACb,SAAS,EAAE,CACT,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE,yBAAyB,KAC9B,OAAO,GACX,mBAAmB;IA+BtB;;;;;;;;;OASG;IACH,SAAS,CACP,SAAS,EAAE,sBAAsB,GAAG,qBAAqB,GACxD,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAIlC;;;;;;;;;OASG;IACH,WAAW,CACT,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GACnC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAIpC;;;;;;;OAOG;IACH,SAAS,IAAI,kBAAkB;IAO/B;;;;;;;;;;;;;;;OAeG;WACU,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAKrE"}

package/dist/state/snapshot.mjs

@@ -0,0 +1,198 @@
+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 _AccountTreeSnapshot_entries, _AccountTreeSnapshot_idMap;
+import { AccountWalletPayloadType, assertAccountTreePayload, ACCOUNT_TREE_PAYLOAD_CURRENT_VERSION } from "./payload.mjs";
+import { deepFreeze } from "./utils.mjs";
+/**
+ * Immutable value object returned by {@link AccountTreeController.exportState}.
+ *
+ * Construct with {@link AccountTreeController.exportState},
+ * {@link AccountTreeSnapshot.deserialize}, or `new AccountTreeSnapshot(...)`
+ * for tests and advanced use.
+ *
+ * Wallet and group entries are deep-cloned and deep-frozen once in the
+ * constructor. Filtering predicates receive those read-only views directly;
+ * each filter method returns a new snapshot that repeats the process for its
+ * result.
+ *
+ * An optional ID map (local ↔ payload) may be supplied when bridging between
+ * internal controller IDs and the stable cross-device IDs in the serialized
+ * payload. The map covers the original export and is preserved unchanged
+ * through filtering until {@link serialize}. Omit it when deterministic IDs
+ * make {@link toLocalId} / {@link toPayloadId} unnecessary.
+ */
+export class AccountTreeSnapshot {
+    /**
+     * @param entries - Wallet entries in the snapshot.
+     * @param idMap - Optional local ↔ payload ID map from export.
+     */
+    constructor(entries, idMap) {
+        _AccountTreeSnapshot_entries.set(this, void 0);
+        _AccountTreeSnapshot_idMap.set(this, void 0);
+        __classPrivateFieldSet(this, _AccountTreeSnapshot_entries, deepFreeze(structuredClone(entries)), "f");
+        __classPrivateFieldSet(this, _AccountTreeSnapshot_idMap, idMap, "f");
+    }
+    /**
+     * Returns a new snapshot containing only the wallets for which
+     * `predicate` returns `true`.
+     *
+     * When filtering by wallet ID, compare against stable payload IDs from
+     * {@link serialize} or convert local IDs with {@link toPayloadId} first.
+     *
+     * @param predicate - Function called with each deeply read-only wallet entry.
+     * @returns A filtered snapshot.
+     */
+    filterWallets(predicate) {
+        const filteredEntries = __classPrivateFieldGet(this, _AccountTreeSnapshot_entries, "f").filter((entry) => predicate(entry));
+        return new AccountTreeSnapshot(filteredEntries, __classPrivateFieldGet(this, _AccountTreeSnapshot_idMap, "f"));
+    }
+    /**
+     * Filters groups within one wallet. Other wallets are left unchanged.
+     *
+     * Throws if `walletId` does not identify a wallet in the snapshot.
+     * Removes the wallet if no groups remain after filtering — this prevents a
+     * mnemonic wallet with zero selected groups from still transferring its secret.
+     *
+     * **Mnemonic wallets:** group indices must remain contiguous starting at 0
+     * after filtering, because the payload schema enforces this invariant.
+     * Predicates that produce gaps (e.g. keeping only index 1, or 0 and 2) will
+     * cause {@link AccountTreeSnapshot.deserialize} to reject the payload on the
+     * receiving end.
+     *
+     * @param walletId - Stable payload wallet ID to filter groups within.
+     * @param predicate - Function called with each deeply read-only group entry.
+     * @returns A filtered snapshot.
+     * @throws If `walletId` is not present in the snapshot.
+     */
+    filterGroups(walletId, predicate) {
+        const walletIndex = __classPrivateFieldGet(this, _AccountTreeSnapshot_entries, "f").findIndex((entry) => entry.id === walletId);
+        if (walletIndex === -1) {
+            throw new Error(`Cannot filter groups: wallet "${walletId}" not found in snapshot`);
+        }
+        const wallet = __classPrivateFieldGet(this, _AccountTreeSnapshot_entries, "f")[walletIndex];
+        const filteredGroups = wallet.groups.filter((group) => predicate(group));
+        const filteredEntries = [...__classPrivateFieldGet(this, _AccountTreeSnapshot_entries, "f")];
+        if (filteredGroups.length === 0) {
+            filteredEntries.splice(walletIndex, 1);
+        }
+        else if (wallet.type === AccountWalletPayloadType.Mnemonic) {
+            filteredEntries[walletIndex] = {
+                ...wallet,
+                groups: filteredGroups,
+            };
+        }
+        else {
+            filteredEntries[walletIndex] = {
+                ...wallet,
+                groups: filteredGroups,
+            };
+        }
+        return new AccountTreeSnapshot(filteredEntries, __classPrivateFieldGet(this, _AccountTreeSnapshot_idMap, "f"));
+    }
+    /**
+     * Filters groups across every wallet.
+     *
+     * The parent wallet is provided as context to the predicate. Removes any
+     * wallet with no remaining groups after filtering.
+     *
+     * **Mnemonic wallets:** see {@link filterGroups} for the contiguous-index
+     * constraint that applies here as well.
+     *
+     * @param predicate - Function called with each group and its parent wallet.
+     * @returns A filtered snapshot.
+     */
+    filterAllGroups(predicate) {
+        const filteredEntries = [];
+        for (const wallet of __classPrivateFieldGet(this, _AccountTreeSnapshot_entries, "f")) {
+            const filteredGroups = wallet.groups.filter((group) => predicate(group, wallet));
+            if (filteredGroups.length === 0) {
+                continue;
+            }
+            if (wallet.type === AccountWalletPayloadType.Mnemonic) {
+                filteredEntries.push({
+                    ...wallet,
+                    groups: filteredGroups,
+                });
+            }
+            else {
+                filteredEntries.push({
+                    ...wallet,
+                    groups: filteredGroups,
+                });
+            }
+        }
+        return new AccountTreeSnapshot(filteredEntries, __classPrivateFieldGet(this, _AccountTreeSnapshot_idMap, "f"));
+    }
+    /**
+     * Converts a payload ID (wallet or group) to the corresponding local
+     * `AccountTreeController` ID.
+     *
+     * The map reflects the original export, not the wallets/groups currently
+     * retained in this snapshot after filtering.
+     *
+     * @param payloadId - Stable cross-device wallet or group payload ID.
+     * @returns The local controller ID, or `undefined` if not found or no ID map is present.
+     */
+    toLocalId(payloadId) {
+        return __classPrivateFieldGet(this, _AccountTreeSnapshot_idMap, "f")?.getLocalId(payloadId);
+    }
+    /**
+     * Converts a local `AccountTreeController` ID (wallet or group) to its
+     * stable cross-device payload ID.
+     *
+     * The map reflects the original export, not the wallets/groups currently
+     * retained in this snapshot after filtering.
+     *
+     * @param localId - Local controller wallet or group ID.
+     * @returns The payload ID, or `undefined` if not found or no ID map is present.
+     */
+    toPayloadId(localId) {
+        return __classPrivateFieldGet(this, _AccountTreeSnapshot_idMap, "f")?.getPayloadId(localId);
+    }
+    /**
+     * Serializes the snapshot to a flat {@link AccountTreePayload} with `version` inlined
+     * alongside the wallet entries.
+     *
+     * Returns the constructor-frozen wallet tree without copying it again.
+     *
+     * @returns The versioned flat payload.
+     */
+    serialize() {
+        return {
+            version: ACCOUNT_TREE_PAYLOAD_CURRENT_VERSION,
+            wallets: __classPrivateFieldGet(this, _AccountTreeSnapshot_entries, "f"),
+        };
+    }
+    /**
+     * Validates a raw value as an {@link AccountTreePayload}, running any
+     * necessary version migrations, and returns an immutable snapshot.
+     *
+     * This is the entry point for untrusted serialized data. Unsupported schema
+     * versions and wallet types fail closed with an error instead of returning a
+     * partial snapshot.
+     *
+     * The returned snapshot has no ID map — {@link toLocalId} / {@link toPayloadId}
+     * return `undefined`. Pass an {@link IdMap} to the constructor when you need
+     * the map.
+     *
+     * @param raw - Unknown value to parse.
+     * @returns A validated snapshot.
+     * @throws If `raw` is not a valid payload or its version is unsupported.
+     */
+    static async deserialize(raw) {
+        // TODO: Use migration framework here.
+        assertAccountTreePayload(raw);
+        return new AccountTreeSnapshot(raw.wallets);
+    }
+}
+_AccountTreeSnapshot_entries = new WeakMap(), _AccountTreeSnapshot_idMap = new WeakMap();
+//# sourceMappingURL=snapshot.mjs.map

package/dist/state/snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.mjs","sourceRoot":"","sources":["../../src/state/snapshot.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IdMap } from './id-map.js';\nimport type {\n  AccountGroupPayloadId,\n  AccountTreePayload,\n  AccountTreeSnapshotGroup,\n  AccountTreeSnapshotWallet,\n  AccountTreeWalletEntry,\n  AccountWalletMnemonicGroupEntry,\n  AccountWalletPayloadId,\n  AccountWalletPrivateKeyGroupEntry,\n} from './payload.js';\nimport {\n  AccountWalletPayloadType,\n  assertAccountTreePayload,\n  ACCOUNT_TREE_PAYLOAD_CURRENT_VERSION,\n} from './payload.js';\nimport { deepFreeze } from './utils.js';\n\n/**\n * Immutable value object returned by {@link AccountTreeController.exportState}.\n *\n * Construct with {@link AccountTreeController.exportState},\n * {@link AccountTreeSnapshot.deserialize}, or `new AccountTreeSnapshot(...)`\n * for tests and advanced use.\n *\n * Wallet and group entries are deep-cloned and deep-frozen once in the\n * constructor. Filtering predicates receive those read-only views directly;\n * each filter method returns a new snapshot that repeats the process for its\n * result.\n *\n * An optional ID map (local ↔ payload) may be supplied when bridging between\n * internal controller IDs and the stable cross-device IDs in the serialized\n * payload. The map covers the original export and is preserved unchanged\n * through filtering until {@link serialize}. Omit it when deterministic IDs\n * make {@link toLocalId} / {@link toPayloadId} unnecessary.\n */\nexport class AccountTreeSnapshot {\n  readonly #entries: AccountTreeWalletEntry[];\n\n  readonly #idMap: IdMap | undefined;\n\n  /**\n   * @param entries - Wallet entries in the snapshot.\n   * @param idMap - Optional local ↔ payload ID map from export.\n   */\n  constructor(entries: AccountTreeWalletEntry[], idMap?: IdMap) {\n    this.#entries = deepFreeze(structuredClone(entries));\n    this.#idMap = idMap;\n  }\n\n  /**\n   * Returns a new snapshot containing only the wallets for which\n   * `predicate` returns `true`.\n   *\n   * When filtering by wallet ID, compare against stable payload IDs from\n   * {@link serialize} or convert local IDs with {@link toPayloadId} first.\n   *\n   * @param predicate - Function called with each deeply read-only wallet entry.\n   * @returns A filtered snapshot.\n   */\n  filterWallets(\n    predicate: (wallet: AccountTreeSnapshotWallet) => boolean,\n  ): AccountTreeSnapshot {\n    const filteredEntries = this.#entries.filter((entry) =>\n      predicate(entry as AccountTreeSnapshotWallet),\n    );\n\n    return new AccountTreeSnapshot(filteredEntries, this.#idMap);\n  }\n\n  /**\n   * Filters groups within one wallet. Other wallets are left unchanged.\n   *\n   * Throws if `walletId` does not identify a wallet in the snapshot.\n   * Removes the wallet if no groups remain after filtering — this prevents a\n   * mnemonic wallet with zero selected groups from still transferring its secret.\n   *\n   * **Mnemonic wallets:** group indices must remain contiguous starting at 0\n   * after filtering, because the payload schema enforces this invariant.\n   * Predicates that produce gaps (e.g. keeping only index 1, or 0 and 2) will\n   * cause {@link AccountTreeSnapshot.deserialize} to reject the payload on the\n   * receiving end.\n   *\n   * @param walletId - Stable payload wallet ID to filter groups within.\n   * @param predicate - Function called with each deeply read-only group entry.\n   * @returns A filtered snapshot.\n   * @throws If `walletId` is not present in the snapshot.\n   */\n  filterGroups(\n    walletId: AccountWalletPayloadId,\n    predicate: (group: AccountTreeSnapshotGroup) => boolean,\n  ): AccountTreeSnapshot {\n    const walletIndex = this.#entries.findIndex(\n      (entry) => entry.id === walletId,\n    );\n    if (walletIndex === -1) {\n      throw new Error(\n        `Cannot filter groups: wallet \"${walletId}\" not found in snapshot`,\n      );\n    }\n\n    const wallet = this.#entries[walletIndex];\n\n    const filteredGroups = wallet.groups.filter((group) =>\n      predicate(group as AccountTreeSnapshotGroup),\n    );\n\n    const filteredEntries = [...this.#entries];\n    if (filteredGroups.length === 0) {\n      filteredEntries.splice(walletIndex, 1);\n    } else if (wallet.type === AccountWalletPayloadType.Mnemonic) {\n      filteredEntries[walletIndex] = {\n        ...wallet,\n        groups: filteredGroups as AccountWalletMnemonicGroupEntry[],\n      };\n    } else {\n      filteredEntries[walletIndex] = {\n        ...wallet,\n        groups: filteredGroups as AccountWalletPrivateKeyGroupEntry[],\n      };\n    }\n\n    return new AccountTreeSnapshot(filteredEntries, this.#idMap);\n  }\n\n  /**\n   * Filters groups across every wallet.\n   *\n   * The parent wallet is provided as context to the predicate. Removes any\n   * wallet with no remaining groups after filtering.\n   *\n   * **Mnemonic wallets:** see {@link filterGroups} for the contiguous-index\n   * constraint that applies here as well.\n   *\n   * @param predicate - Function called with each group and its parent wallet.\n   * @returns A filtered snapshot.\n   */\n  filterAllGroups(\n    predicate: (\n      group: AccountTreeSnapshotGroup,\n      wallet: AccountTreeSnapshotWallet,\n    ) => boolean,\n  ): AccountTreeSnapshot {\n    const filteredEntries: AccountTreeWalletEntry[] = [];\n\n    for (const wallet of this.#entries) {\n      const filteredGroups = wallet.groups.filter((group) =>\n        predicate(\n          group as AccountTreeSnapshotGroup,\n          wallet as AccountTreeSnapshotWallet,\n        ),\n      );\n\n      if (filteredGroups.length === 0) {\n        continue;\n      }\n\n      if (wallet.type === AccountWalletPayloadType.Mnemonic) {\n        filteredEntries.push({\n          ...wallet,\n          groups: filteredGroups as AccountWalletMnemonicGroupEntry[],\n        });\n      } else {\n        filteredEntries.push({\n          ...wallet,\n          groups: filteredGroups as AccountWalletPrivateKeyGroupEntry[],\n        });\n      }\n    }\n\n    return new AccountTreeSnapshot(filteredEntries, this.#idMap);\n  }\n\n  /**\n   * Converts a payload ID (wallet or group) to the corresponding local\n   * `AccountTreeController` ID.\n   *\n   * The map reflects the original export, not the wallets/groups currently\n   * retained in this snapshot after filtering.\n   *\n   * @param payloadId - Stable cross-device wallet or group payload ID.\n   * @returns The local controller ID, or `undefined` if not found or no ID map is present.\n   */\n  toLocalId(\n    payloadId: AccountWalletPayloadId | AccountGroupPayloadId,\n  ): ReturnType<IdMap['getLocalId']> {\n    return this.#idMap?.getLocalId(payloadId);\n  }\n\n  /**\n   * Converts a local `AccountTreeController` ID (wallet or group) to its\n   * stable cross-device payload ID.\n   *\n   * The map reflects the original export, not the wallets/groups currently\n   * retained in this snapshot after filtering.\n   *\n   * @param localId - Local controller wallet or group ID.\n   * @returns The payload ID, or `undefined` if not found or no ID map is present.\n   */\n  toPayloadId(\n    localId: Parameters<IdMap['add']>[0],\n  ): ReturnType<IdMap['getPayloadId']> {\n    return this.#idMap?.getPayloadId(localId);\n  }\n\n  /**\n   * Serializes the snapshot to a flat {@link AccountTreePayload} with `version` inlined\n   * alongside the wallet entries.\n   *\n   * Returns the constructor-frozen wallet tree without copying it again.\n   *\n   * @returns The versioned flat payload.\n   */\n  serialize(): AccountTreePayload {\n    return {\n      version: ACCOUNT_TREE_PAYLOAD_CURRENT_VERSION,\n      wallets: this.#entries,\n    };\n  }\n\n  /**\n   * Validates a raw value as an {@link AccountTreePayload}, running any\n   * necessary version migrations, and returns an immutable snapshot.\n   *\n   * This is the entry point for untrusted serialized data. Unsupported schema\n   * versions and wallet types fail closed with an error instead of returning a\n   * partial snapshot.\n   *\n   * The returned snapshot has no ID map — {@link toLocalId} / {@link toPayloadId}\n   * return `undefined`. Pass an {@link IdMap} to the constructor when you need\n   * the map.\n   *\n   * @param raw - Unknown value to parse.\n   * @returns A validated snapshot.\n   * @throws If `raw` is not a valid payload or its version is unsupported.\n   */\n  static async deserialize(raw: unknown): Promise<AccountTreeSnapshot> {\n    // TODO: Use migration framework here.\n    assertAccountTreePayload(raw);\n    return new AccountTreeSnapshot(raw.wallets);\n  }\n}\n"]}

package/dist/state/utils.cjs

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatValidationErrorMessages = exports.deepFreeze = exports.decodeBytes = exports.encodeBytes = exports.BytesStruct = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+/**
+ * Superstruct struct that validates an {@link EncodedBytes} value.
+ */
+exports.BytesStruct = (0, superstruct_1.refine)((0, superstruct_1.array)((0, superstruct_1.integer)()), 'bytes', (value) => {
+    const invalid = value.find((b) => b < 0 || b > 255);
+    return invalid === undefined
+        ? true
+        : `each byte must be in [0, 255]; got ${invalid}`;
+});
+/**
+ * Encodes a `Uint8Array` as a JSON-compatible {@link EncodedBytes}.
+ *
+ * @param bytes - The bytes to encode.
+ * @returns An array of integers in [0, 255].
+ */
+function encodeBytes(bytes) {
+    return Array.from(bytes);
+}
+exports.encodeBytes = encodeBytes;
+/**
+ * Decodes an {@link EncodedBytes} produced by {@link encodeBytes} back into a `Uint8Array`.
+ * The caller is responsible for zeroing the result when the data is no longer needed.
+ *
+ * @param encoded - The encoded byte array.
+ * @returns The decoded `Uint8Array`.
+ */
+function decodeBytes(encoded) {
+    return new Uint8Array(encoded);
+}
+exports.decodeBytes = decodeBytes;
+/**
+ * Recursively freezes a value and its nested properties.
+ *
+ * @param value - Value to freeze.
+ * @returns The frozen value.
+ */
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    Object.freeze(value);
+    for (const nested of Object.values(value)) {
+        deepFreeze(nested);
+    }
+    return value;
+}
+exports.deepFreeze = deepFreeze;
+/**
+ * Formats Superstruct validation failures into a single error message string.
+ *
+ * @param error - The StructError thrown during validation.
+ * @returns A comma-separated list of `[path] expected: <type>` entries.
+ */
+function formatValidationErrorMessages(error) {
+    return error
+        .failures()
+        .map(({ path, type, refinement }) => {
+        const location = path.length > 0 ? path.join('.') : '<root>';
+        return `[${location}] expected: ${refinement ?? type}`;
+    })
+        .join(', ');
+}
+exports.formatValidationErrorMessages = formatValidationErrorMessages;
+//# sourceMappingURL=utils.cjs.map

package/dist/state/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":";;;AACA,uDAA4E;AAQ5E;;GAEG;AACU,QAAA,WAAW,GAAyB,IAAA,oBAAM,EACrD,IAAA,mBAAK,EAAC,IAAA,qBAAO,GAAE,CAAC,EAChB,OAAO,EACP,CAAC,KAAK,EAAE,EAAE;IACR,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACpD,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,sCAAsC,OAAO,EAAE,CAAC;AACtD,CAAC,CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAiB;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAFD,kCAEC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,OAAqB;IAC/C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAFD,kCAEC;AAaD;;;;;GAKG;AACH,SAAgB,UAAU,CAAQ,KAAY;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAZD,gCAYC;AAED;;;;;GAKG;AACH,SAAgB,6BAA6B,CAAC,KAAkB;IAC9D,OAAO,KAAK;SACT,QAAQ,EAAE;SACV,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7D,OAAO,IAAI,QAAQ,eAAe,UAAU,IAAI,IAAI,EAAE,CAAC;IACzD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AARD,sEAQC","sourcesContent":["import type { Struct } from '@metamask/superstruct';\nimport { array, integer, refine, StructError } from '@metamask/superstruct';\n\n/**\n * A JSON-compatible representation of a `Uint8Array` as an array of integers\n * in [0, 255]. Use {@link encodeBytes} and {@link decodeBytes} to convert.\n */\nexport type EncodedBytes = number[];\n\n/**\n * Superstruct struct that validates an {@link EncodedBytes} value.\n */\nexport const BytesStruct: Struct<EncodedBytes> = refine(\n  array(integer()),\n  'bytes',\n  (value) => {\n    const invalid = value.find((b) => b < 0 || b > 255);\n    return invalid === undefined\n      ? true\n      : `each byte must be in [0, 255]; got ${invalid}`;\n  },\n);\n\n/**\n * Encodes a `Uint8Array` as a JSON-compatible {@link EncodedBytes}.\n *\n * @param bytes - The bytes to encode.\n * @returns An array of integers in [0, 255].\n */\nexport function encodeBytes(bytes: Uint8Array): EncodedBytes {\n  return Array.from(bytes);\n}\n\n/**\n * Decodes an {@link EncodedBytes} produced by {@link encodeBytes} back into a `Uint8Array`.\n * The caller is responsible for zeroing the result when the data is no longer needed.\n *\n * @param encoded - The encoded byte array.\n * @returns The decoded `Uint8Array`.\n */\nexport function decodeBytes(encoded: EncodedBytes): Uint8Array {\n  return new Uint8Array(encoded);\n}\n\n/**\n * Recursively readonly view of `Value` used by snapshot filtering predicate types.\n *\n * @typeParam T - The mutable source type to expose as deeply read-only.\n */\nexport type DeepReadonly<Value> = Value extends readonly (infer Item)[]\n  ? readonly DeepReadonly<Item>[]\n  : Value extends object\n    ? { readonly [Key in keyof Value]: DeepReadonly<Value[Key]> }\n    : Value;\n\n/**\n * Recursively freezes a value and its nested properties.\n *\n * @param value - Value to freeze.\n * @returns The frozen value.\n */\nexport function deepFreeze<Value>(value: Value): Value {\n  if (value === null || typeof value !== 'object') {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const nested of Object.values(value)) {\n    deepFreeze(nested);\n  }\n\n  return value;\n}\n\n/**\n * Formats Superstruct validation failures into a single error message string.\n *\n * @param error - The StructError thrown during validation.\n * @returns A comma-separated list of `[path] expected: <type>` entries.\n */\nexport function formatValidationErrorMessages(error: StructError): string {\n  return error\n    .failures()\n    .map(({ path, type, refinement }) => {\n      const location = path.length > 0 ? path.join('.') : '<root>';\n      return `[${location}] expected: ${refinement ?? type}`;\n    })\n    .join(', ');\n}\n"]}

package/dist/state/utils.d.cts

@@ -0,0 +1,49 @@
+import type { Struct } from "@metamask/superstruct";
+import { StructError } from "@metamask/superstruct";
+/**
+ * A JSON-compatible representation of a `Uint8Array` as an array of integers
+ * in [0, 255]. Use {@link encodeBytes} and {@link decodeBytes} to convert.
+ */
+export type EncodedBytes = number[];
+/**
+ * Superstruct struct that validates an {@link EncodedBytes} value.
+ */
+export declare const BytesStruct: Struct<EncodedBytes>;
+/**
+ * Encodes a `Uint8Array` as a JSON-compatible {@link EncodedBytes}.
+ *
+ * @param bytes - The bytes to encode.
+ * @returns An array of integers in [0, 255].
+ */
+export declare function encodeBytes(bytes: Uint8Array): EncodedBytes;
+/**
+ * Decodes an {@link EncodedBytes} produced by {@link encodeBytes} back into a `Uint8Array`.
+ * The caller is responsible for zeroing the result when the data is no longer needed.
+ *
+ * @param encoded - The encoded byte array.
+ * @returns The decoded `Uint8Array`.
+ */
+export declare function decodeBytes(encoded: EncodedBytes): Uint8Array;
+/**
+ * Recursively readonly view of `Value` used by snapshot filtering predicate types.
+ *
+ * @typeParam T - The mutable source type to expose as deeply read-only.
+ */
+export type DeepReadonly<Value> = Value extends readonly (infer Item)[] ? readonly DeepReadonly<Item>[] : Value extends object ? {
+    readonly [Key in keyof Value]: DeepReadonly<Value[Key]>;
+} : Value;
+/**
+ * Recursively freezes a value and its nested properties.
+ *
+ * @param value - Value to freeze.
+ * @returns The frozen value.
+ */
+export declare function deepFreeze<Value>(value: Value): Value;
+/**
+ * Formats Superstruct validation failures into a single error message string.
+ *
+ * @param error - The StructError thrown during validation.
+ * @returns A comma-separated list of `[path] expected: <type>` entries.
+ */
+export declare function formatValidationErrorMessages(error: StructError): string;
+//# sourceMappingURL=utils.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,8BAA8B;AACpD,OAAO,EAA0B,WAAW,EAAE,8BAA8B;AAE5E;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,CAS5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAE7D;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,KAAK,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACnE,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B,KAAK,SAAS,MAAM,GAClB;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAAE,GAC3D,KAAK,CAAC;AAEZ;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAYrD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQxE"}

package/dist/state/utils.d.mts

@@ -0,0 +1,49 @@
+import type { Struct } from "@metamask/superstruct";
+import { StructError } from "@metamask/superstruct";
+/**
+ * A JSON-compatible representation of a `Uint8Array` as an array of integers
+ * in [0, 255]. Use {@link encodeBytes} and {@link decodeBytes} to convert.
+ */
+export type EncodedBytes = number[];
+/**
+ * Superstruct struct that validates an {@link EncodedBytes} value.
+ */
+export declare const BytesStruct: Struct<EncodedBytes>;
+/**
+ * Encodes a `Uint8Array` as a JSON-compatible {@link EncodedBytes}.
+ *
+ * @param bytes - The bytes to encode.
+ * @returns An array of integers in [0, 255].
+ */
+export declare function encodeBytes(bytes: Uint8Array): EncodedBytes;
+/**
+ * Decodes an {@link EncodedBytes} produced by {@link encodeBytes} back into a `Uint8Array`.
+ * The caller is responsible for zeroing the result when the data is no longer needed.
+ *
+ * @param encoded - The encoded byte array.
+ * @returns The decoded `Uint8Array`.
+ */
+export declare function decodeBytes(encoded: EncodedBytes): Uint8Array;
+/**
+ * Recursively readonly view of `Value` used by snapshot filtering predicate types.
+ *
+ * @typeParam T - The mutable source type to expose as deeply read-only.
+ */
+export type DeepReadonly<Value> = Value extends readonly (infer Item)[] ? readonly DeepReadonly<Item>[] : Value extends object ? {
+    readonly [Key in keyof Value]: DeepReadonly<Value[Key]>;
+} : Value;
+/**
+ * Recursively freezes a value and its nested properties.
+ *
+ * @param value - Value to freeze.
+ * @returns The frozen value.
+ */
+export declare function deepFreeze<Value>(value: Value): Value;
+/**
+ * Formats Superstruct validation failures into a single error message string.
+ *
+ * @param error - The StructError thrown during validation.
+ * @returns A comma-separated list of `[path] expected: <type>` entries.
+ */
+export declare function formatValidationErrorMessages(error: StructError): string;
+//# sourceMappingURL=utils.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,8BAA8B;AACpD,OAAO,EAA0B,WAAW,EAAE,8BAA8B;AAE5E;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,CAS5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAE7D;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,KAAK,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACnE,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B,KAAK,SAAS,MAAM,GAClB;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAAE,GAC3D,KAAK,CAAC;AAEZ;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAYrD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQxE"}

package/dist/state/utils.mjs

@@ -0,0 +1,61 @@
+import { array, integer, refine, StructError } from "@metamask/superstruct";
+/**
+ * Superstruct struct that validates an {@link EncodedBytes} value.
+ */
+export const BytesStruct = refine(array(integer()), 'bytes', (value) => {
+    const invalid = value.find((b) => b < 0 || b > 255);
+    return invalid === undefined
+        ? true
+        : `each byte must be in [0, 255]; got ${invalid}`;
+});
+/**
+ * Encodes a `Uint8Array` as a JSON-compatible {@link EncodedBytes}.
+ *
+ * @param bytes - The bytes to encode.
+ * @returns An array of integers in [0, 255].
+ */
+export function encodeBytes(bytes) {
+    return Array.from(bytes);
+}
+/**
+ * Decodes an {@link EncodedBytes} produced by {@link encodeBytes} back into a `Uint8Array`.
+ * The caller is responsible for zeroing the result when the data is no longer needed.
+ *
+ * @param encoded - The encoded byte array.
+ * @returns The decoded `Uint8Array`.
+ */
+export function decodeBytes(encoded) {
+    return new Uint8Array(encoded);
+}
+/**
+ * Recursively freezes a value and its nested properties.
+ *
+ * @param value - Value to freeze.
+ * @returns The frozen value.
+ */
+export function deepFreeze(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    Object.freeze(value);
+    for (const nested of Object.values(value)) {
+        deepFreeze(nested);
+    }
+    return value;
+}
+/**
+ * Formats Superstruct validation failures into a single error message string.
+ *
+ * @param error - The StructError thrown during validation.
+ * @returns A comma-separated list of `[path] expected: <type>` entries.
+ */
+export function formatValidationErrorMessages(error) {
+    return error
+        .failures()
+        .map(({ path, type, refinement }) => {
+        const location = path.length > 0 ? path.join('.') : '<root>';
+        return `[${location}] expected: ${refinement ?? type}`;
+    })
+        .join(', ');
+}
+//# sourceMappingURL=utils.mjs.map

package/dist/state/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/state/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B;AAQ5E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB,MAAM,CACrD,KAAK,CAAC,OAAO,EAAE,CAAC,EAChB,OAAO,EACP,CAAC,KAAK,EAAE,EAAE;IACR,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACpD,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,sCAAsC,OAAO,EAAE,CAAC;AACtD,CAAC,CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAQ,KAAY;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAkB;IAC9D,OAAO,KAAK;SACT,QAAQ,EAAE;SACV,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7D,OAAO,IAAI,QAAQ,eAAe,UAAU,IAAI,IAAI,EAAE,CAAC;IACzD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC","sourcesContent":["import type { Struct } from '@metamask/superstruct';\nimport { array, integer, refine, StructError } from '@metamask/superstruct';\n\n/**\n * A JSON-compatible representation of a `Uint8Array` as an array of integers\n * in [0, 255]. Use {@link encodeBytes} and {@link decodeBytes} to convert.\n */\nexport type EncodedBytes = number[];\n\n/**\n * Superstruct struct that validates an {@link EncodedBytes} value.\n */\nexport const BytesStruct: Struct<EncodedBytes> = refine(\n  array(integer()),\n  'bytes',\n  (value) => {\n    const invalid = value.find((b) => b < 0 || b > 255);\n    return invalid === undefined\n      ? true\n      : `each byte must be in [0, 255]; got ${invalid}`;\n  },\n);\n\n/**\n * Encodes a `Uint8Array` as a JSON-compatible {@link EncodedBytes}.\n *\n * @param bytes - The bytes to encode.\n * @returns An array of integers in [0, 255].\n */\nexport function encodeBytes(bytes: Uint8Array): EncodedBytes {\n  return Array.from(bytes);\n}\n\n/**\n * Decodes an {@link EncodedBytes} produced by {@link encodeBytes} back into a `Uint8Array`.\n * The caller is responsible for zeroing the result when the data is no longer needed.\n *\n * @param encoded - The encoded byte array.\n * @returns The decoded `Uint8Array`.\n */\nexport function decodeBytes(encoded: EncodedBytes): Uint8Array {\n  return new Uint8Array(encoded);\n}\n\n/**\n * Recursively readonly view of `Value` used by snapshot filtering predicate types.\n *\n * @typeParam T - The mutable source type to expose as deeply read-only.\n */\nexport type DeepReadonly<Value> = Value extends readonly (infer Item)[]\n  ? readonly DeepReadonly<Item>[]\n  : Value extends object\n    ? { readonly [Key in keyof Value]: DeepReadonly<Value[Key]> }\n    : Value;\n\n/**\n * Recursively freezes a value and its nested properties.\n *\n * @param value - Value to freeze.\n * @returns The frozen value.\n */\nexport function deepFreeze<Value>(value: Value): Value {\n  if (value === null || typeof value !== 'object') {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const nested of Object.values(value)) {\n    deepFreeze(nested);\n  }\n\n  return value;\n}\n\n/**\n * Formats Superstruct validation failures into a single error message string.\n *\n * @param error - The StructError thrown during validation.\n * @returns A comma-separated list of `[path] expected: <type>` entries.\n */\nexport function formatValidationErrorMessages(error: StructError): string {\n  return error\n    .failures()\n    .map(({ path, type, refinement }) => {\n      const location = path.length > 0 ? path.join('.') : '<root>';\n      return `[${location}] expected: ${refinement ?? type}`;\n    })\n    .join(', ');\n}\n"]}

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\nimport type {\n  AccountId,\n  AccountsControllerAccountsAddedEvent,\n  AccountsControllerAccountsRemovedEvent,\n  AccountsControllerGetAccountAction,\n  AccountsControllerGetSelectedMultichainAccountAction,\n  AccountsControllerListMultichainAccountsAction,\n  AccountsControllerSelectedAccountChangeEvent,\n  AccountsControllerSetSelectedAccountAction,\n} from '@metamask/accounts-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport type { KeyringControllerGetStateAction } from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  MultichainAccountServiceCreateMultichainAccountGroupAction,\n  MultichainAccountServiceCreateMultichainAccountGroupsAction,\n} from '@metamask/multichain-account-service';\nimport type { MultichainAccountServiceWalletStatusChangeEvent } from '@metamask/multichain-account-service';\nimport type {\n  AuthenticationController,\n  UserStorageController,\n} from '@metamask/profile-sync-controller';\nimport type { SnapControllerGetSnapAction } from '@metamask/snaps-controllers';\n\nimport type { AccountTreeControllerMethodActions } from './AccountTreeController-method-action-types.js';\nimport type { controllerName } from './AccountTreeController.js';\nimport type {\n  BackupAndSyncAnalyticsEventPayload,\n  BackupAndSyncEmitAnalyticsEventParams,\n} from './backup-and-sync/analytics/index.js';\nimport type {\n  AccountGroupObject,\n  AccountTreeGroupPersistedMetadata,\n} from './group.js';\nimport type {\n  AccountWalletObject,\n  AccountTreeWalletPersistedMetadata,\n} from './wallet.js';\n\n// Backward compatibility aliases using indexed access types\n/**\n * @deprecated Use AccountTreeGroupMetadata for tree objects or AccountTreeGroupPersistedMetadata for controller state\n */\nexport type AccountGroupMetadata = AccountGroupObject['metadata'];\n\n/**\n * @deprecated Use AccountTreeWalletMetadata for tree objects or AccountTreeWalletPersistedMetadata for controller state\n */\nexport type AccountWalletMetadata = AccountWalletObject['metadata'];\n\nexport type AccountTreeControllerState = {\n  accountTree: {\n    wallets: {\n      // Wallets:\n      [walletId: AccountWalletId]: AccountWalletObject;\n    };\n  };\n  selectedAccountGroup: AccountGroupId | '';\n  isAccountTreeSyncingInProgress: boolean;\n  hasAccountTreeSyncingSyncedAtLeastOnce: boolean;\n  /** Persistent metadata for account groups (names, pinning, hiding, sync timestamps) */\n  accountGroupsMetadata: Record<\n    AccountGroupId,\n    AccountTreeGroupPersistedMetadata\n  >;\n  /** Persistent metadata for account wallets (names, sync timestamps) */\n  accountWalletsMetadata: Record<\n    AccountWalletId,\n    AccountTreeWalletPersistedMetadata\n  >;\n};\n\nexport type AccountTreeControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AccountTreeControllerState\n>;\n\nexport type AllowedActions =\n  | AccountsControllerGetAccountAction\n  | AccountsControllerGetSelectedMultichainAccountAction\n  | AccountsControllerListMultichainAccountsAction\n  | AccountsControllerSetSelectedAccountAction\n  | KeyringControllerGetStateAction\n  | SnapControllerGetSnapAction\n  | UserStorageController.UserStorageControllerGetStateAction\n  | UserStorageController.UserStorageControllerPerformGetStorageAction\n  | UserStorageController.UserStorageControllerPerformGetStorageAllFeatureEntriesAction\n  | UserStorageController.UserStorageControllerPerformSetStorageAction\n  | UserStorageController.UserStorageControllerPerformBatchSetStorageAction\n  | AuthenticationController.AuthenticationControllerGetSessionProfileAction\n  | MultichainAccountServiceCreateMultichainAccountGroupAction\n  | MultichainAccountServiceCreateMultichainAccountGroupsAction;\n\nexport type AccountTreeControllerActions =\n  | AccountTreeControllerGetStateAction\n  | AccountTreeControllerMethodActions;\n\nexport type AccountTreeControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AccountTreeControllerState\n>;\n\n/**\n * Represents the `AccountTreeController:accountTreeChange` event.\n * This event is emitted when nodes (wallets, groups, or accounts) are added or removed.\n */\nexport type AccountTreeControllerAccountTreeChangeEvent = {\n  type: `${typeof controllerName}:accountTreeChange`;\n  payload: [AccountTreeControllerState['accountTree']];\n};\n\n/**\n * Represents the `AccountTreeController:selectedAccountGroupChange` event.\n * This event is emitted when the selected account group changes.\n */\nexport type AccountTreeControllerSelectedAccountGroupChangeEvent = {\n  type: `${typeof controllerName}:selectedAccountGroupChange`;\n  payload: [AccountGroupId | '', AccountGroupId | ''];\n};\n\n/**\n * Represents the `AccountTreeController:accountGroupCreated` event.\n * This event is emitted when a new account group is added to the tree\n * after the controller has been initialized.\n */\nexport type AccountTreeControllerAccountGroupCreatedEvent = {\n  type: `${typeof controllerName}:accountGroupCreated`;\n  payload: [AccountGroupObject];\n};\n\n/**\n * Represents the `AccountTreeController:accountGroupUpdated` event.\n * This event is emitted when an existing account group's metadata or\n * membership changes after the controller has been initialized.\n */\nexport type AccountTreeControllerAccountGroupUpdatedEvent = {\n  type: `${typeof controllerName}:accountGroupUpdated`;\n  payload: [AccountGroupObject];\n};\n\n/**\n * Represents the `AccountTreeController:accountGroupRemoved` event.\n * This event is emitted when an account group is pruned from the tree\n * (its last account was removed) after the controller has been initialized.\n */\nexport type AccountTreeControllerAccountGroupRemovedEvent = {\n  type: `${typeof controllerName}:accountGroupRemoved`;\n  payload: [AccountGroupId];\n};\n\nexport type AllowedEvents =\n  | AccountsControllerAccountsAddedEvent\n  | AccountsControllerAccountsRemovedEvent\n  | AccountsControllerSelectedAccountChangeEvent\n  | UserStorageController.UserStorageControllerStateChangeEvent\n  | MultichainAccountServiceWalletStatusChangeEvent;\n\nexport type AccountTreeControllerEvents =\n  | AccountTreeControllerStateChangeEvent\n  | AccountTreeControllerAccountTreeChangeEvent\n  | AccountTreeControllerSelectedAccountGroupChangeEvent\n  | AccountTreeControllerAccountGroupCreatedEvent\n  | AccountTreeControllerAccountGroupUpdatedEvent\n  | AccountTreeControllerAccountGroupRemovedEvent;\n\nexport type AccountTreeControllerMessenger = Messenger<\n  typeof controllerName,\n  AccountTreeControllerActions | AllowedActions,\n  AccountTreeControllerEvents | AllowedEvents\n>;\n\nexport type AccountTreeControllerConfig = {\n  trace?: TraceCallback;\n  backupAndSync?: {\n    onBackupAndSyncEvent?: (event: BackupAndSyncAnalyticsEventPayload) => void;\n  };\n  accountOrderCallbacks?: {\n    isHiddenAccount?: (accountId: AccountId) => boolean;\n    isPinnedAccount?: (accountId: AccountId) => boolean;\n  };\n};\n\nexport type AccountTreeControllerInternalBackupAndSyncConfig = {\n  emitAnalyticsEventFn: (event: BackupAndSyncEmitAnalyticsEventParams) => void;\n};\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\nimport type {\n  AccountId,\n  AccountsControllerAccountsAddedEvent,\n  AccountsControllerAccountsRemovedEvent,\n  AccountsControllerGetAccountAction,\n  AccountsControllerGetSelectedMultichainAccountAction,\n  AccountsControllerListMultichainAccountsAction,\n  AccountsControllerSelectedAccountChangeEvent,\n  AccountsControllerSetSelectedAccountAction,\n} from '@metamask/accounts-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport type {\n  KeyringControllerGetStateAction,\n  KeyringControllerWithControllerAction,\n  KeyringControllerWithKeyringV2Action,\n  KeyringControllerWithKeyringV2UnsafeAction,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  MultichainAccountServiceCreateMultichainAccountGroupAction,\n  MultichainAccountServiceCreateMultichainAccountGroupsAction,\n  MultichainAccountServiceCreateMultichainAccountWalletAction,\n} from '@metamask/multichain-account-service';\nimport type { MultichainAccountServiceWalletStatusChangeEvent } from '@metamask/multichain-account-service';\nimport type {\n  AuthenticationController,\n  UserStorageController,\n} from '@metamask/profile-sync-controller';\nimport type { SnapControllerGetSnapAction } from '@metamask/snaps-controllers';\n\nimport type { AccountTreeControllerMethodActions } from './AccountTreeController-method-action-types.js';\nimport type { controllerName } from './AccountTreeController.js';\nimport type {\n  BackupAndSyncAnalyticsEventPayload,\n  BackupAndSyncEmitAnalyticsEventParams,\n} from './backup-and-sync/analytics/index.js';\nimport type {\n  AccountGroupObject,\n  AccountTreeGroupPersistedMetadata,\n} from './group.js';\nimport type {\n  AccountWalletObject,\n  AccountTreeWalletPersistedMetadata,\n} from './wallet.js';\n\n// Backward compatibility aliases using indexed access types\n/**\n * @deprecated Use AccountTreeGroupMetadata for tree objects or AccountTreeGroupPersistedMetadata for controller state\n */\nexport type AccountGroupMetadata = AccountGroupObject['metadata'];\n\n/**\n * @deprecated Use AccountTreeWalletMetadata for tree objects or AccountTreeWalletPersistedMetadata for controller state\n */\nexport type AccountWalletMetadata = AccountWalletObject['metadata'];\n\nexport type AccountTreeControllerState = {\n  accountTree: {\n    wallets: {\n      // Wallets:\n      [walletId: AccountWalletId]: AccountWalletObject;\n    };\n  };\n  selectedAccountGroup: AccountGroupId | '';\n  isAccountTreeSyncingInProgress: boolean;\n  hasAccountTreeSyncingSyncedAtLeastOnce: boolean;\n  /** Persistent metadata for account groups (names, pinning, hiding, sync timestamps) */\n  accountGroupsMetadata: Record<\n    AccountGroupId,\n    AccountTreeGroupPersistedMetadata\n  >;\n  /** Persistent metadata for account wallets (names, sync timestamps) */\n  accountWalletsMetadata: Record<\n    AccountWalletId,\n    AccountTreeWalletPersistedMetadata\n  >;\n};\n\nexport type AccountTreeControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AccountTreeControllerState\n>;\n\nexport type AllowedActions =\n  | AccountsControllerGetAccountAction\n  | AccountsControllerGetSelectedMultichainAccountAction\n  | AccountsControllerListMultichainAccountsAction\n  | AccountsControllerSetSelectedAccountAction\n  | KeyringControllerGetStateAction\n  | SnapControllerGetSnapAction\n  | UserStorageController.UserStorageControllerGetStateAction\n  | UserStorageController.UserStorageControllerPerformGetStorageAction\n  | UserStorageController.UserStorageControllerPerformGetStorageAllFeatureEntriesAction\n  | UserStorageController.UserStorageControllerPerformSetStorageAction\n  | UserStorageController.UserStorageControllerPerformBatchSetStorageAction\n  | AuthenticationController.AuthenticationControllerGetSessionProfileAction\n  | MultichainAccountServiceCreateMultichainAccountGroupAction\n  | MultichainAccountServiceCreateMultichainAccountGroupsAction\n  | MultichainAccountServiceCreateMultichainAccountWalletAction\n  | KeyringControllerWithControllerAction\n  | KeyringControllerWithKeyringV2Action\n  | KeyringControllerWithKeyringV2UnsafeAction;\n\nexport type AccountTreeControllerActions =\n  | AccountTreeControllerGetStateAction\n  | AccountTreeControllerMethodActions;\n\nexport type AccountTreeControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AccountTreeControllerState\n>;\n\n/**\n * Represents the `AccountTreeController:accountTreeChange` event.\n * This event is emitted when nodes (wallets, groups, or accounts) are added or removed.\n */\nexport type AccountTreeControllerAccountTreeChangeEvent = {\n  type: `${typeof controllerName}:accountTreeChange`;\n  payload: [AccountTreeControllerState['accountTree']];\n};\n\n/**\n * Represents the `AccountTreeController:selectedAccountGroupChange` event.\n * This event is emitted when the selected account group changes.\n */\nexport type AccountTreeControllerSelectedAccountGroupChangeEvent = {\n  type: `${typeof controllerName}:selectedAccountGroupChange`;\n  payload: [AccountGroupId | '', AccountGroupId | ''];\n};\n\n/**\n * Represents the `AccountTreeController:accountGroupCreated` event.\n * This event is emitted when a new account group is added to the tree\n * after the controller has been initialized.\n */\nexport type AccountTreeControllerAccountGroupCreatedEvent = {\n  type: `${typeof controllerName}:accountGroupCreated`;\n  payload: [AccountGroupObject];\n};\n\n/**\n * Represents the `AccountTreeController:accountGroupUpdated` event.\n * This event is emitted when an existing account group's metadata or\n * membership changes after the controller has been initialized.\n */\nexport type AccountTreeControllerAccountGroupUpdatedEvent = {\n  type: `${typeof controllerName}:accountGroupUpdated`;\n  payload: [AccountGroupObject];\n};\n\n/**\n * Represents the `AccountTreeController:accountGroupRemoved` event.\n * This event is emitted when an account group is pruned from the tree\n * (its last account was removed) after the controller has been initialized.\n */\nexport type AccountTreeControllerAccountGroupRemovedEvent = {\n  type: `${typeof controllerName}:accountGroupRemoved`;\n  payload: [AccountGroupId];\n};\n\nexport type AllowedEvents =\n  | AccountsControllerAccountsAddedEvent\n  | AccountsControllerAccountsRemovedEvent\n  | AccountsControllerSelectedAccountChangeEvent\n  | UserStorageController.UserStorageControllerStateChangeEvent\n  | MultichainAccountServiceWalletStatusChangeEvent;\n\nexport type AccountTreeControllerEvents =\n  | AccountTreeControllerStateChangeEvent\n  | AccountTreeControllerAccountTreeChangeEvent\n  | AccountTreeControllerSelectedAccountGroupChangeEvent\n  | AccountTreeControllerAccountGroupCreatedEvent\n  | AccountTreeControllerAccountGroupUpdatedEvent\n  | AccountTreeControllerAccountGroupRemovedEvent;\n\nexport type AccountTreeControllerMessenger = Messenger<\n  typeof controllerName,\n  AccountTreeControllerActions | AllowedActions,\n  AccountTreeControllerEvents | AllowedEvents\n>;\n\nexport type AccountTreeControllerConfig = {\n  trace?: TraceCallback;\n  backupAndSync?: {\n    onBackupAndSyncEvent?: (event: BackupAndSyncAnalyticsEventPayload) => void;\n  };\n  accountOrderCallbacks?: {\n    isHiddenAccount?: (accountId: AccountId) => boolean;\n    isPinnedAccount?: (accountId: AccountId) => boolean;\n  };\n};\n\nexport type AccountTreeControllerInternalBackupAndSyncConfig = {\n  emitAnalyticsEventFn: (event: BackupAndSyncEmitAnalyticsEventParams) => void;\n};\n"]}