@metamask-previews/account-tree-controller 5.0.1-preview-afe010990 → 5.0.1-preview-3ce0062c4

package/dist/AccountTreeController-method-action-types.cjs

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * This file is auto generated.
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
  * Do not edit manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/AccountTreeController-method-action-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AccountTreeController-method-action-types.cjs","sourceRoot":"","sources":["../src/AccountTreeController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AccountTreeController } from './AccountTreeController';\n\n/**\n * Gets the account wallet object from its ID.\n *\n * @param walletId - Account wallet ID.\n * @returns The account wallet object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountWalletObjectAction = {\n  type: `AccountTreeController:getAccountWalletObject`;\n  handler: AccountTreeController['getAccountWalletObject'];\n};\n\n/**\n * Gets all account wallet objects.\n *\n * @returns All account wallet objects.\n */\nexport type AccountTreeControllerGetAccountWalletObjectsAction = {\n  type: `AccountTreeController:getAccountWalletObjects`;\n  handler: AccountTreeController['getAccountWalletObjects'];\n};\n\n/**\n * Gets all underlying accounts from the currently selected account\n * group.\n *\n * It also support account selector, which allows to filter specific\n * accounts given some criterias (account type, address, scopes, etc...).\n *\n * @param selector - Optional account selector.\n * @returns Underlying accounts for the currently selected account (filtered\n * by the selector if provided).\n */\nexport type AccountTreeControllerGetAccountsFromSelectedAccountGroupAction = {\n  type: `AccountTreeController:getAccountsFromSelectedAccountGroup`;\n  handler: AccountTreeController['getAccountsFromSelectedAccountGroup'];\n};\n\n/**\n * Gets the account group object from its ID.\n *\n * @param groupId - Account group ID.\n * @returns The account group object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountGroupObjectAction = {\n  type: `AccountTreeController:getAccountGroupObject`;\n  handler: AccountTreeController['getAccountGroupObject'];\n};\n\n/**\n * Gets the account's context which contains its wallet ID, group ID, and sort order.\n *\n * @param accountId - Account ID.\n * @returns The account context if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountContextAction = {\n  type: `AccountTreeController:getAccountContext`;\n  handler: AccountTreeController['getAccountContext'];\n};\n\n/**\n * Gets the currently selected account group ID.\n *\n * @returns The selected account group ID or empty string if none selected.\n */\nexport type AccountTreeControllerGetSelectedAccountGroupAction = {\n  type: `AccountTreeController:getSelectedAccountGroup`;\n  handler: AccountTreeController['getSelectedAccountGroup'];\n};\n\n/**\n * Sets the selected account group and updates the AccountsController selectedAccount accordingly.\n *\n * @param groupId - The account group ID to select.\n */\nexport type AccountTreeControllerSetSelectedAccountGroupAction = {\n  type: `AccountTreeController:setSelectedAccountGroup`;\n  handler: AccountTreeController['setSelectedAccountGroup'];\n};\n\n/**\n * Sets a custom name for an account group.\n *\n * @param groupId - The account group ID.\n * @param name - The custom name to set.\n * @param autoHandleConflict - If true, automatically resolves name conflicts by adding a suffix. If false, throws on conflicts.\n * @throws If the account group ID is not found in the current tree.\n * @throws If the account group name already exists and autoHandleConflict is false.\n */\nexport type AccountTreeControllerSetAccountGroupNameAction = {\n  type: `AccountTreeController:setAccountGroupName`;\n  handler: AccountTreeController['setAccountGroupName'];\n};\n\n/**\n * Sets a custom name for an account wallet.\n *\n * @param walletId - The account wallet ID.\n * @param name - The custom name to set.\n * @throws If the account wallet ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountWalletNameAction = {\n  type: `AccountTreeController:setAccountWalletName`;\n  handler: AccountTreeController['setAccountWalletName'];\n};\n\n/**\n * Toggles the pinned state of an account group.\n *\n * @param groupId - The account group ID.\n * @param pinned - Whether the group should be pinned.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupPinnedAction = {\n  type: `AccountTreeController:setAccountGroupPinned`;\n  handler: AccountTreeController['setAccountGroupPinned'];\n};\n\n/**\n * Toggles the hidden state of an account group.\n *\n * @param groupId - The account group ID.\n * @param hidden - Whether the group should be hidden.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupHiddenAction = {\n  type: `AccountTreeController:setAccountGroupHidden`;\n  handler: AccountTreeController['setAccountGroupHidden'];\n};\n\n/**\n * Clears the controller state and resets to default values.\n * Also clears the backup and sync service state.\n */\nexport type AccountTreeControllerClearStateAction = {\n  type: `AccountTreeController:clearState`;\n  handler: AccountTreeController['clearState'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will perform a full sync, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If a full sync is already in progress, it will return the ongoing promise.\n *\n * @returns A promise that resolves when the sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAction = {\n  type: `AccountTreeController:syncWithUserStorage`;\n  handler: AccountTreeController['syncWithUserStorage'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will ensure at least one full sync is ran, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If the first ever full sync is already in progress, it will return the ongoing promise.\n * If the first ever full sync was previously completed, it will NOT start a new sync, and will resolve immediately.\n *\n * @returns A promise that resolves when the first ever full sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAtLeastOnceAction = {\n  type: `AccountTreeController:syncWithUserStorageAtLeastOnce`;\n  handler: AccountTreeController['syncWithUserStorageAtLeastOnce'];\n};\n\n/**\n * Union of all AccountTreeController action types.\n */\nexport type AccountTreeControllerMethodActions =\n  | AccountTreeControllerGetAccountWalletObjectAction\n  | AccountTreeControllerGetAccountWalletObjectsAction\n  | AccountTreeControllerGetAccountsFromSelectedAccountGroupAction\n  | AccountTreeControllerGetAccountGroupObjectAction\n  | AccountTreeControllerGetAccountContextAction\n  | AccountTreeControllerGetSelectedAccountGroupAction\n  | AccountTreeControllerSetSelectedAccountGroupAction\n  | AccountTreeControllerSetAccountGroupNameAction\n  | AccountTreeControllerSetAccountWalletNameAction\n  | AccountTreeControllerSetAccountGroupPinnedAction\n  | AccountTreeControllerSetAccountGroupHiddenAction\n  | AccountTreeControllerClearStateAction\n  | AccountTreeControllerSyncWithUserStorageAction\n  | AccountTreeControllerSyncWithUserStorageAtLeastOnceAction;\n"]}
+{"version":3,"file":"AccountTreeController-method-action-types.cjs","sourceRoot":"","sources":["../src/AccountTreeController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated by `scripts/generate-method-action-types.ts`.\n * Do not edit manually.\n */\n\nimport type { AccountTreeController } from './AccountTreeController';\n\n/**\n * Gets the account wallet object from its ID.\n *\n * @param walletId - Account wallet ID.\n * @returns The account wallet object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountWalletObjectAction = {\n  type: `AccountTreeController:getAccountWalletObject`;\n  handler: AccountTreeController['getAccountWalletObject'];\n};\n\n/**\n * Gets all account wallet objects.\n *\n * @returns All account wallet objects.\n */\nexport type AccountTreeControllerGetAccountWalletObjectsAction = {\n  type: `AccountTreeController:getAccountWalletObjects`;\n  handler: AccountTreeController['getAccountWalletObjects'];\n};\n\n/**\n * Gets all underlying accounts from the currently selected account\n * group.\n *\n * It also support account selector, which allows to filter specific\n * accounts given some criterias (account type, address, scopes, etc...).\n *\n * @param selector - Optional account selector.\n * @returns Underlying accounts for the currently selected account (filtered\n * by the selector if provided).\n */\nexport type AccountTreeControllerGetAccountsFromSelectedAccountGroupAction = {\n  type: `AccountTreeController:getAccountsFromSelectedAccountGroup`;\n  handler: AccountTreeController['getAccountsFromSelectedAccountGroup'];\n};\n\n/**\n * Gets the account group object from its ID.\n *\n * @param groupId - Account group ID.\n * @returns The account group object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountGroupObjectAction = {\n  type: `AccountTreeController:getAccountGroupObject`;\n  handler: AccountTreeController['getAccountGroupObject'];\n};\n\n/**\n * Gets the account's context which contains its wallet ID, group ID, and sort order.\n *\n * @param accountId - Account ID.\n * @returns The account context if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountContextAction = {\n  type: `AccountTreeController:getAccountContext`;\n  handler: AccountTreeController['getAccountContext'];\n};\n\n/**\n * Gets the currently selected account group ID.\n *\n * @returns The selected account group ID or empty string if none selected.\n */\nexport type AccountTreeControllerGetSelectedAccountGroupAction = {\n  type: `AccountTreeController:getSelectedAccountGroup`;\n  handler: AccountTreeController['getSelectedAccountGroup'];\n};\n\n/**\n * Sets the selected account group and updates the AccountsController selectedAccount accordingly.\n *\n * @param groupId - The account group ID to select.\n */\nexport type AccountTreeControllerSetSelectedAccountGroupAction = {\n  type: `AccountTreeController:setSelectedAccountGroup`;\n  handler: AccountTreeController['setSelectedAccountGroup'];\n};\n\n/**\n * Sets a custom name for an account group.\n *\n * @param groupId - The account group ID.\n * @param name - The custom name to set.\n * @param autoHandleConflict - If true, automatically resolves name conflicts by adding a suffix. If false, throws on conflicts.\n * @throws If the account group ID is not found in the current tree.\n * @throws If the account group name already exists and autoHandleConflict is false.\n */\nexport type AccountTreeControllerSetAccountGroupNameAction = {\n  type: `AccountTreeController:setAccountGroupName`;\n  handler: AccountTreeController['setAccountGroupName'];\n};\n\n/**\n * Sets a custom name for an account wallet.\n *\n * @param walletId - The account wallet ID.\n * @param name - The custom name to set.\n * @throws If the account wallet ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountWalletNameAction = {\n  type: `AccountTreeController:setAccountWalletName`;\n  handler: AccountTreeController['setAccountWalletName'];\n};\n\n/**\n * Toggles the pinned state of an account group.\n *\n * @param groupId - The account group ID.\n * @param pinned - Whether the group should be pinned.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupPinnedAction = {\n  type: `AccountTreeController:setAccountGroupPinned`;\n  handler: AccountTreeController['setAccountGroupPinned'];\n};\n\n/**\n * Toggles the hidden state of an account group.\n *\n * @param groupId - The account group ID.\n * @param hidden - Whether the group should be hidden.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupHiddenAction = {\n  type: `AccountTreeController:setAccountGroupHidden`;\n  handler: AccountTreeController['setAccountGroupHidden'];\n};\n\n/**\n * Clears the controller state and resets to default values.\n * Also clears the backup and sync service state.\n */\nexport type AccountTreeControllerClearStateAction = {\n  type: `AccountTreeController:clearState`;\n  handler: AccountTreeController['clearState'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will perform a full sync, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If a full sync is already in progress, it will return the ongoing promise.\n *\n * @returns A promise that resolves when the sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAction = {\n  type: `AccountTreeController:syncWithUserStorage`;\n  handler: AccountTreeController['syncWithUserStorage'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will ensure at least one full sync is ran, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If the first ever full sync is already in progress, it will return the ongoing promise.\n * If the first ever full sync was previously completed, it will NOT start a new sync, and will resolve immediately.\n *\n * @returns A promise that resolves when the first ever full sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAtLeastOnceAction = {\n  type: `AccountTreeController:syncWithUserStorageAtLeastOnce`;\n  handler: AccountTreeController['syncWithUserStorageAtLeastOnce'];\n};\n\n/**\n * Union of all AccountTreeController action types.\n */\nexport type AccountTreeControllerMethodActions =\n  | AccountTreeControllerGetAccountWalletObjectAction\n  | AccountTreeControllerGetAccountWalletObjectsAction\n  | AccountTreeControllerGetAccountsFromSelectedAccountGroupAction\n  | AccountTreeControllerGetAccountGroupObjectAction\n  | AccountTreeControllerGetAccountContextAction\n  | AccountTreeControllerGetSelectedAccountGroupAction\n  | AccountTreeControllerSetSelectedAccountGroupAction\n  | AccountTreeControllerSetAccountGroupNameAction\n  | AccountTreeControllerSetAccountWalletNameAction\n  | AccountTreeControllerSetAccountGroupPinnedAction\n  | AccountTreeControllerSetAccountGroupHiddenAction\n  | AccountTreeControllerClearStateAction\n  | AccountTreeControllerSyncWithUserStorageAction\n  | AccountTreeControllerSyncWithUserStorageAtLeastOnceAction;\n"]}

package/dist/AccountTreeController-method-action-types.d.cts

@@ -1,5 +1,5 @@
 /**
- * This file is auto generated.
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
  * Do not edit manually.
  */
 import type { AccountTreeController } from "./AccountTreeController.cjs";

package/dist/AccountTreeController-method-action-types.d.mts

@@ -1,5 +1,5 @@
 /**
- * This file is auto generated.
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
  * Do not edit manually.
  */
 import type { AccountTreeController } from "./AccountTreeController.mjs";

package/dist/AccountTreeController-method-action-types.mjs

@@ -1,5 +1,5 @@
 /**
- * This file is auto generated.
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
  * Do not edit manually.
  */
 export {};

package/dist/AccountTreeController-method-action-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AccountTreeController-method-action-types.mjs","sourceRoot":"","sources":["../src/AccountTreeController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AccountTreeController } from './AccountTreeController';\n\n/**\n * Gets the account wallet object from its ID.\n *\n * @param walletId - Account wallet ID.\n * @returns The account wallet object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountWalletObjectAction = {\n  type: `AccountTreeController:getAccountWalletObject`;\n  handler: AccountTreeController['getAccountWalletObject'];\n};\n\n/**\n * Gets all account wallet objects.\n *\n * @returns All account wallet objects.\n */\nexport type AccountTreeControllerGetAccountWalletObjectsAction = {\n  type: `AccountTreeController:getAccountWalletObjects`;\n  handler: AccountTreeController['getAccountWalletObjects'];\n};\n\n/**\n * Gets all underlying accounts from the currently selected account\n * group.\n *\n * It also support account selector, which allows to filter specific\n * accounts given some criterias (account type, address, scopes, etc...).\n *\n * @param selector - Optional account selector.\n * @returns Underlying accounts for the currently selected account (filtered\n * by the selector if provided).\n */\nexport type AccountTreeControllerGetAccountsFromSelectedAccountGroupAction = {\n  type: `AccountTreeController:getAccountsFromSelectedAccountGroup`;\n  handler: AccountTreeController['getAccountsFromSelectedAccountGroup'];\n};\n\n/**\n * Gets the account group object from its ID.\n *\n * @param groupId - Account group ID.\n * @returns The account group object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountGroupObjectAction = {\n  type: `AccountTreeController:getAccountGroupObject`;\n  handler: AccountTreeController['getAccountGroupObject'];\n};\n\n/**\n * Gets the account's context which contains its wallet ID, group ID, and sort order.\n *\n * @param accountId - Account ID.\n * @returns The account context if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountContextAction = {\n  type: `AccountTreeController:getAccountContext`;\n  handler: AccountTreeController['getAccountContext'];\n};\n\n/**\n * Gets the currently selected account group ID.\n *\n * @returns The selected account group ID or empty string if none selected.\n */\nexport type AccountTreeControllerGetSelectedAccountGroupAction = {\n  type: `AccountTreeController:getSelectedAccountGroup`;\n  handler: AccountTreeController['getSelectedAccountGroup'];\n};\n\n/**\n * Sets the selected account group and updates the AccountsController selectedAccount accordingly.\n *\n * @param groupId - The account group ID to select.\n */\nexport type AccountTreeControllerSetSelectedAccountGroupAction = {\n  type: `AccountTreeController:setSelectedAccountGroup`;\n  handler: AccountTreeController['setSelectedAccountGroup'];\n};\n\n/**\n * Sets a custom name for an account group.\n *\n * @param groupId - The account group ID.\n * @param name - The custom name to set.\n * @param autoHandleConflict - If true, automatically resolves name conflicts by adding a suffix. If false, throws on conflicts.\n * @throws If the account group ID is not found in the current tree.\n * @throws If the account group name already exists and autoHandleConflict is false.\n */\nexport type AccountTreeControllerSetAccountGroupNameAction = {\n  type: `AccountTreeController:setAccountGroupName`;\n  handler: AccountTreeController['setAccountGroupName'];\n};\n\n/**\n * Sets a custom name for an account wallet.\n *\n * @param walletId - The account wallet ID.\n * @param name - The custom name to set.\n * @throws If the account wallet ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountWalletNameAction = {\n  type: `AccountTreeController:setAccountWalletName`;\n  handler: AccountTreeController['setAccountWalletName'];\n};\n\n/**\n * Toggles the pinned state of an account group.\n *\n * @param groupId - The account group ID.\n * @param pinned - Whether the group should be pinned.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupPinnedAction = {\n  type: `AccountTreeController:setAccountGroupPinned`;\n  handler: AccountTreeController['setAccountGroupPinned'];\n};\n\n/**\n * Toggles the hidden state of an account group.\n *\n * @param groupId - The account group ID.\n * @param hidden - Whether the group should be hidden.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupHiddenAction = {\n  type: `AccountTreeController:setAccountGroupHidden`;\n  handler: AccountTreeController['setAccountGroupHidden'];\n};\n\n/**\n * Clears the controller state and resets to default values.\n * Also clears the backup and sync service state.\n */\nexport type AccountTreeControllerClearStateAction = {\n  type: `AccountTreeController:clearState`;\n  handler: AccountTreeController['clearState'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will perform a full sync, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If a full sync is already in progress, it will return the ongoing promise.\n *\n * @returns A promise that resolves when the sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAction = {\n  type: `AccountTreeController:syncWithUserStorage`;\n  handler: AccountTreeController['syncWithUserStorage'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will ensure at least one full sync is ran, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If the first ever full sync is already in progress, it will return the ongoing promise.\n * If the first ever full sync was previously completed, it will NOT start a new sync, and will resolve immediately.\n *\n * @returns A promise that resolves when the first ever full sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAtLeastOnceAction = {\n  type: `AccountTreeController:syncWithUserStorageAtLeastOnce`;\n  handler: AccountTreeController['syncWithUserStorageAtLeastOnce'];\n};\n\n/**\n * Union of all AccountTreeController action types.\n */\nexport type AccountTreeControllerMethodActions =\n  | AccountTreeControllerGetAccountWalletObjectAction\n  | AccountTreeControllerGetAccountWalletObjectsAction\n  | AccountTreeControllerGetAccountsFromSelectedAccountGroupAction\n  | AccountTreeControllerGetAccountGroupObjectAction\n  | AccountTreeControllerGetAccountContextAction\n  | AccountTreeControllerGetSelectedAccountGroupAction\n  | AccountTreeControllerSetSelectedAccountGroupAction\n  | AccountTreeControllerSetAccountGroupNameAction\n  | AccountTreeControllerSetAccountWalletNameAction\n  | AccountTreeControllerSetAccountGroupPinnedAction\n  | AccountTreeControllerSetAccountGroupHiddenAction\n  | AccountTreeControllerClearStateAction\n  | AccountTreeControllerSyncWithUserStorageAction\n  | AccountTreeControllerSyncWithUserStorageAtLeastOnceAction;\n"]}
+{"version":3,"file":"AccountTreeController-method-action-types.mjs","sourceRoot":"","sources":["../src/AccountTreeController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated by `scripts/generate-method-action-types.ts`.\n * Do not edit manually.\n */\n\nimport type { AccountTreeController } from './AccountTreeController';\n\n/**\n * Gets the account wallet object from its ID.\n *\n * @param walletId - Account wallet ID.\n * @returns The account wallet object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountWalletObjectAction = {\n  type: `AccountTreeController:getAccountWalletObject`;\n  handler: AccountTreeController['getAccountWalletObject'];\n};\n\n/**\n * Gets all account wallet objects.\n *\n * @returns All account wallet objects.\n */\nexport type AccountTreeControllerGetAccountWalletObjectsAction = {\n  type: `AccountTreeController:getAccountWalletObjects`;\n  handler: AccountTreeController['getAccountWalletObjects'];\n};\n\n/**\n * Gets all underlying accounts from the currently selected account\n * group.\n *\n * It also support account selector, which allows to filter specific\n * accounts given some criterias (account type, address, scopes, etc...).\n *\n * @param selector - Optional account selector.\n * @returns Underlying accounts for the currently selected account (filtered\n * by the selector if provided).\n */\nexport type AccountTreeControllerGetAccountsFromSelectedAccountGroupAction = {\n  type: `AccountTreeController:getAccountsFromSelectedAccountGroup`;\n  handler: AccountTreeController['getAccountsFromSelectedAccountGroup'];\n};\n\n/**\n * Gets the account group object from its ID.\n *\n * @param groupId - Account group ID.\n * @returns The account group object if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountGroupObjectAction = {\n  type: `AccountTreeController:getAccountGroupObject`;\n  handler: AccountTreeController['getAccountGroupObject'];\n};\n\n/**\n * Gets the account's context which contains its wallet ID, group ID, and sort order.\n *\n * @param accountId - Account ID.\n * @returns The account context if found, undefined otherwise.\n */\nexport type AccountTreeControllerGetAccountContextAction = {\n  type: `AccountTreeController:getAccountContext`;\n  handler: AccountTreeController['getAccountContext'];\n};\n\n/**\n * Gets the currently selected account group ID.\n *\n * @returns The selected account group ID or empty string if none selected.\n */\nexport type AccountTreeControllerGetSelectedAccountGroupAction = {\n  type: `AccountTreeController:getSelectedAccountGroup`;\n  handler: AccountTreeController['getSelectedAccountGroup'];\n};\n\n/**\n * Sets the selected account group and updates the AccountsController selectedAccount accordingly.\n *\n * @param groupId - The account group ID to select.\n */\nexport type AccountTreeControllerSetSelectedAccountGroupAction = {\n  type: `AccountTreeController:setSelectedAccountGroup`;\n  handler: AccountTreeController['setSelectedAccountGroup'];\n};\n\n/**\n * Sets a custom name for an account group.\n *\n * @param groupId - The account group ID.\n * @param name - The custom name to set.\n * @param autoHandleConflict - If true, automatically resolves name conflicts by adding a suffix. If false, throws on conflicts.\n * @throws If the account group ID is not found in the current tree.\n * @throws If the account group name already exists and autoHandleConflict is false.\n */\nexport type AccountTreeControllerSetAccountGroupNameAction = {\n  type: `AccountTreeController:setAccountGroupName`;\n  handler: AccountTreeController['setAccountGroupName'];\n};\n\n/**\n * Sets a custom name for an account wallet.\n *\n * @param walletId - The account wallet ID.\n * @param name - The custom name to set.\n * @throws If the account wallet ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountWalletNameAction = {\n  type: `AccountTreeController:setAccountWalletName`;\n  handler: AccountTreeController['setAccountWalletName'];\n};\n\n/**\n * Toggles the pinned state of an account group.\n *\n * @param groupId - The account group ID.\n * @param pinned - Whether the group should be pinned.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupPinnedAction = {\n  type: `AccountTreeController:setAccountGroupPinned`;\n  handler: AccountTreeController['setAccountGroupPinned'];\n};\n\n/**\n * Toggles the hidden state of an account group.\n *\n * @param groupId - The account group ID.\n * @param hidden - Whether the group should be hidden.\n * @throws If the account group ID is not found in the current tree.\n */\nexport type AccountTreeControllerSetAccountGroupHiddenAction = {\n  type: `AccountTreeController:setAccountGroupHidden`;\n  handler: AccountTreeController['setAccountGroupHidden'];\n};\n\n/**\n * Clears the controller state and resets to default values.\n * Also clears the backup and sync service state.\n */\nexport type AccountTreeControllerClearStateAction = {\n  type: `AccountTreeController:clearState`;\n  handler: AccountTreeController['clearState'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will perform a full sync, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If a full sync is already in progress, it will return the ongoing promise.\n *\n * @returns A promise that resolves when the sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAction = {\n  type: `AccountTreeController:syncWithUserStorage`;\n  handler: AccountTreeController['syncWithUserStorage'];\n};\n\n/**\n * Bi-directionally syncs the account tree with user storage.\n * This will ensure at least one full sync is ran, including both pulling updates\n * from user storage and pushing local changes to user storage.\n * This also performs legacy account syncing if needed.\n *\n * IMPORTANT:\n * If the first ever full sync is already in progress, it will return the ongoing promise.\n * If the first ever full sync was previously completed, it will NOT start a new sync, and will resolve immediately.\n *\n * @returns A promise that resolves when the first ever full sync is complete.\n */\nexport type AccountTreeControllerSyncWithUserStorageAtLeastOnceAction = {\n  type: `AccountTreeController:syncWithUserStorageAtLeastOnce`;\n  handler: AccountTreeController['syncWithUserStorageAtLeastOnce'];\n};\n\n/**\n * Union of all AccountTreeController action types.\n */\nexport type AccountTreeControllerMethodActions =\n  | AccountTreeControllerGetAccountWalletObjectAction\n  | AccountTreeControllerGetAccountWalletObjectsAction\n  | AccountTreeControllerGetAccountsFromSelectedAccountGroupAction\n  | AccountTreeControllerGetAccountGroupObjectAction\n  | AccountTreeControllerGetAccountContextAction\n  | AccountTreeControllerGetSelectedAccountGroupAction\n  | AccountTreeControllerSetSelectedAccountGroupAction\n  | AccountTreeControllerSetAccountGroupNameAction\n  | AccountTreeControllerSetAccountWalletNameAction\n  | AccountTreeControllerSetAccountGroupPinnedAction\n  | AccountTreeControllerSetAccountGroupHiddenAction\n  | AccountTreeControllerClearStateAction\n  | AccountTreeControllerSyncWithUserStorageAction\n  | AccountTreeControllerSyncWithUserStorageAtLeastOnceAction;\n"]}

package/dist/backup-and-sync/service/index.cjs

@@ -261,7 +261,7 @@ async function _BackupAndSyncService_performFullSyncInner() {
                     }
                 }
                 catch (error) {
-                    const errorMessage = (0, utils_1.toErrorMessage)(error);
+                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const errorString = `Legacy syncing failed for wallet ${wallet.id}: ${errorMessage}`;
                     (0, logger_1.backupAndSyncLogger)(errorString);
                     throw new Error(errorString);
@@ -288,7 +288,7 @@ async function _BackupAndSyncService_performFullSyncInner() {
                     await (0, syncing_1.syncGroupsMetadata)(__classPrivateFieldGet(this, _BackupAndSyncService_context, "f"), wallet, groupsFromUserStorage, entropySourceId, walletProfileId);
                 }
                 catch (error) {
-                    const errorMessage = (0, utils_1.toErrorMessage)(error);
+                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const errorString = `Error during multichain account syncing for wallet ${wallet.id}: ${errorMessage}`;
                     (0, logger_1.backupAndSyncLogger)(errorString);
                     // Attempt to rollback state changes for this wallet

package/dist/backup-and-sync/service/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,uDAA0D;AAG1D,+DAAsD;AACtD,6CAAmD;AAGnD,sDAAyC;AAEzC,gEAAiD;AACjD,kDAMoB;AAMpB,4DAKyB;AACzB,8CAMkB;AAGlB;;;;;;;;GAQG;AACH,MAAa,oBAAoB;IAoB/B,YAAY,OAA6B;;QAnBhC,gDAA+B;QAExC;;WAEG;QACM,wDAAkC;QAE3C;;;WAGG;QACH,uDAAgD,IAAI,EAAC;QAErD;;;WAGG;QACH,4DAAqD,IAAI,EAAC;QAGxD,uBAAA,IAAI,iCAAY,OAAO,MAAA,CAAC;QACxB,uBAAA,IAAI,yCAAoB,IAAI,mCAAe,EAAE,MAAA,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,IAAI,YAAY;QACd,OAAO,uBAAA,IAAI,qCAAS,CAAC,UAAU,CAAC,KAAK,CAAC,8BAA8B,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,IAAI,oBAAoB;QACtB,OAAO,uBAAA,IAAI,qCAAS,CAAC,UAAU,CAAC,KAAK;aAClC,sCAAsC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,IAAI,sBAAsB;QACxB,MAAM,0BAA0B,GAAG,uBAAA,IAAI,qCAAS,CAAC,SAAS,CAAC,IAAI,CAC7D,gCAAgC,CACjC,CAAC;QACF,MAAM,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,GACvD,0BAA0B,CAAC;QAE7B,OAAO,sBAAsB,IAAI,uBAAuB,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,UAAU;QACR,uBAAA,IAAI,6CAAiB,CAAC,KAAK,EAAE,CAAC;QAC9B,uBAAA,IAAI,gDAA2B,IAAI,MAAA,CAAC;QACpC,uBAAA,IAAI,qDAAgC,IAAI,MAAA,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,4BAA4B,CAC1B,KAAuD;QAEvD,IAAI,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC;YACpE,8DAA8D;YAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAmCD;;;;;OAKG;IACH,uBAAuB,CAAC,QAAyB;QAC/C,IAAI,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,KAAK,uBAAA,IAAI,6CAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CACtC,uBAAA,IAAI,2FAA8B,MAAlC,IAAI,EAA+B,QAAQ,CAAC,CAC7C,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,OAAuB;QAC5C,IACE,CAAC,IAAI,CAAC,sBAAsB;YAC5B,CAAC,IAAI,CAAC,oBAAoB;YAC1B,iFAAiF;YACjF,gFAAgF;YAChF,yFAAyF;YACzF,2FAA2F;YAC3F,0BAA0B;YAC1B,IAAI,CAAC,YAAY,EACjB,CAAC;YACD,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,KAAK,uBAAA,IAAI,6CAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CACtC,uBAAA,IAAI,0FAA6B,MAAjC,IAAI,EAA8B,OAAO,CAAC,CAC3C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,+DAA+D;QAC/D,IAAI,uBAAA,IAAI,oDAAwB,EAAE,CAAC;YACjC,OAAO,uBAAA,IAAI,oDAAwB,CAAC;QACtC,CAAC;QAED,wEAAwE;QACxE,MAAM,cAAc,GAAG,uBAAA,IAAI,6CAAiB,CAAC,eAAe,CAAC,GAAG,EAAE,CAChE,uBAAA,IAAI,mFAAsB,MAA1B,IAAI,CAAwB,CAC7B,CAAC;QAEF,6DAA6D;QAC7D,IAAI,CAAC,uBAAA,IAAI,yDAA6B,EAAE,CAAC;YACvC,uBAAA,IAAI,qDAAgC,cAAc,MAAA,CAAC;QACrD,CAAC;QAED,OAAO,uBAAA,IAAI,yFAA4B,MAAhC,IAAI,EAA6B,cAAc,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,0BAA0B;QAC9B,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,uBAAA,IAAI,yDAA6B,EAAE,CAAC;YACvC,uBAAA,IAAI,qDAAgC,uBAAA,IAAI,6CAAiB,CAAC,eAAe,CACvE,GAAG,EAAE,CAAC,uBAAA,IAAI,mFAAsB,MAA1B,IAAI,CAAwB,CACnC,MAAA,CAAC;YACF,mCAAmC;YACnC,KAAK,uBAAA,IAAI,yFAA4B,MAAhC,IAAI,EAA6B,uBAAA,IAAI,yDAA6B,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,uBAAA,IAAI,yDAA6B,CAAC;IAC3C,CAAC;CAwRF;AAlfD,oDAkfC;iXAxZG,QAAyB;IAEzB,MAAM,MAAM,GAAG,uBAAA,IAAI,qCAAS,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5E,OAAO,MAAM,EAAE,IAAI,KAAK,+BAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzE,CAAC,+GAQ2B,OAAsB;IAChD,uBAAA,IAAI,gDAA2B,OAAO,MAAA,CAAC;IACvC,wDAAwD;IACxD,OAAO;SACJ,OAAO,CAAC,GAAG,EAAE;QACZ,uBAAA,IAAI,gDAA2B,IAAI,MAAA,CAAC;IACtC,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,uDAAuD;QACvD,8DAA8D;IAChE,CAAC,CAAC,CAAC;IACL,OAAO,OAAO,CAAC;AACjB,CAAC;AA0GD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,KAAK;IACH,wDAAwD;IACxD,gFAAgF;IAChF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,4EAA4E;IAC5E,uBAAA,IAAI,qCAAS,CAAC,uBAAuB,CACnC,CAAC,KAAiC,EAAE,EAAE;QACpC,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC;IAC9C,CAAC,CACF,CAAC;IAEF,4DAA4D;IAC5D,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE;QAC3B,IAAI,CAAC;YACH,mEAAmE;YACnE,MAAM,oBAAoB,GAAG,IAAA,8BAAsB,EAAC,uBAAA,IAAI,qCAAS,CAAC,CAAC;YAEnE,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC;gBACjC,0DAA0D;gBAC1D,OAAO;YACT,CAAC;YAED,oCAAoC;YACpC,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;gBAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAEnD,IAAI,eAA0B,CAAC;gBAC/B,IAAI,qBAAqD,CAAC;gBAC1D,IAAI,qBAAqD,CAAC;gBAE1D,IAAI,CAAC;oBACH,eAAe,GAAG,MAAM,IAAA,6BAAY,EAClC,uBAAA,IAAI,qCAAS,EACb,eAAe,CAChB,CAAC;oBAEF,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;wBACjE,IAAA,uCAAwB,EAAC,uBAAA,IAAI,qCAAS,EAAE,eAAe,CAAC;wBACxD,IAAA,0CAA2B,EAAC,uBAAA,IAAI,qCAAS,EAAE,eAAe,CAAC;qBAC5D,CAAC,CAAC;oBAEH,0DAA0D;oBAC1D,IACE,CAAC,qBAAqB;wBACtB,CAAC,qBAAqB,CAAC,8BAA8B,EACrD,CAAC;wBACD,qCAAqC;wBACrC,8DAA8D;wBAC9D,8CAA8C;wBAC9C,MAAM,IAAA,qCAA2B,EAC/B,uBAAA,IAAI,qCAAS,EACb,eAAe,EACf,eAAe,CAChB,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,YAAY,GAAG,IAAA,sBAAc,EAAC,KAAK,CAAC,CAAC;oBAC3C,MAAM,WAAW,GAAG,oCAAoC,MAAM,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;oBAErF,IAAA,4BAAmB,EAAC,WAAW,CAAC,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC/B,CAAC;gBAED,wCAAwC;gBACxC,IAAI,aAAwC,CAAC;gBAE7C,IAAI,CAAC;oBACH,qBAAqB;oBACrB,+EAA+E;oBAC/E,aAAa,GAAG,IAAA,2BAAmB,EAAC,uBAAA,IAAI,qCAAS,CAAC,CAAC;oBAEnD,uCAAuC;oBACvC,MAAM,IAAA,4BAAkB,EACtB,uBAAA,IAAI,qCAAS,EACb,MAAM,EACN,qBAAqB,EACrB,eAAe,CAChB,CAAC;oBAEF,qBAAqB;oBACrB,+DAA+D;oBAC/D,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,CAAC;wBAClC,0GAA0G;wBAC1G,MAAM,IAAA,0CAA2B,EAC/B,uBAAA,IAAI,qCAAS,EACb,IAAA,sCAA8B,EAAC,uBAAA,IAAI,qCAAS,EAAE,MAAM,CAAC,EAAE,CAAC,EACxD,eAAe,CAChB,CAAC;wBAEF,SAAS,CAAC,gEAAgE;oBAC5E,CAAC;oBAED,4EAA4E;oBAC5E,qFAAqF;oBACrF,MAAM,IAAA,0CAAgC,EACpC,uBAAA,IAAI,qCAAS,EACb,qBAAqB,EACrB,eAAe,EACf,eAAe,CAChB,CAAC;oBAEF,sCAAsC;oBACtC,MAAM,IAAA,4BAAkB,EACtB,uBAAA,IAAI,qCAAS,EACb,MAAM,EACN,qBAAqB,EACrB,eAAe,EACf,eAAe,CAChB,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,YAAY,GAAG,IAAA,sBAAc,EAAC,KAAK,CAAC,CAAC;oBAC3C,MAAM,WAAW,GAAG,sDAAsD,MAAM,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;oBAEvG,IAAA,4BAAmB,EAAC,WAAW,CAAC,CAAC;oBAEjC,oDAAoD;oBACpD,IAAI,CAAC;wBACH,IAAI,CAAC,aAAa,EAAE,CAAC;4BACnB,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,EAAE,EAAE,CACpD,CAAC;wBACJ,CAAC;wBACD,IAAA,gCAAwB,EAAC,uBAAA,IAAI,qCAAS,EAAE,aAAa,CAAC,CAAC;wBACvD,IAAA,4BAAmB,EACjB,wCAAwC,MAAM,CAAC,EAAE,EAAE,CACpD,CAAC;oBACJ,CAAC;oBAAC,OAAO,aAAa,EAAE,CAAC;wBACvB,IAAA,4BAAmB,EACjB,uCAAuC,MAAM,CAAC,EAAE,GAAG,EACnD,aAAa,YAAY,KAAK;4BAC5B,CAAC,CAAC,aAAa,CAAC,OAAO;4BACvB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAC1B,CAAC;oBACJ,CAAC;oBAED,+DAA+D;oBAC/D,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,4BAAmB,EAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;YACvE,MAAM,KAAK,CAAC;QACd,CAAC;QAED,uBAAA,IAAI,qCAAS,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9C,KAAK,CAAC,sCAAsC,GAAG,IAAI,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,sEAAsE;IACtE,IAAI,CAAC;QACH,MAAM,uBAAA,IAAI,qCAAS,CAAC,OAAO,CACzB;YACE,IAAI,EAAE,qBAAS,CAAC,eAAe;SAChC,EACD,SAAS,CACV,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,uDAAuD;QACvD,uBAAA,IAAI,qCAAS,CAAC,uBAAuB,CACnC,CAAC,KAAiC,EAAE,EAAE;YACpC,KAAK,CAAC,8BAA8B,GAAG,KAAK,CAAC;QAC/C,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,6DACH,QAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAA,IAAI,+EAAkB,MAAtB,IAAI,EAAmB,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,4BAA4B;QACtC,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,eAAe,GAAG,MAAM,IAAA,6BAAY,EACxC,uBAAA,IAAI,qCAAS,EACb,eAAe,CAChB,CAAC;QACF,MAAM,qBAAqB,GAAG,MAAM,IAAA,uCAAwB,EAC1D,uBAAA,IAAI,qCAAS,EACb,eAAe,CAChB,CAAC;QAEF,MAAM,IAAA,4BAAkB,EACtB,uBAAA,IAAI,qCAAS,EACb,MAAM,EACN,qBAAqB,EACrB,eAAe,CAChB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,4BAAmB,EACjB,mCAAmC,QAAQ,GAAG,EAC9C,KAAK,CACN,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,4DAA8B,OAAuB;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,uBAAA,IAAI,qCAAS,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,uBAAA,IAAI,+EAAkB,MAAtB,IAAI,EAAmB,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,4BAA4B;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,eAAe,GAAG,MAAM,IAAA,6BAAY,EACxC,uBAAA,IAAI,qCAAS,EACb,eAAe,CAChB,CAAC;QAEF,2CAA2C;QAC3C,MAAM,oBAAoB,GAAG,MAAM,IAAA,sCAAuB,EACxD,uBAAA,IAAI,qCAAS,EACb,eAAe,EACf,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAClC,CAAC;QAEF,MAAM,IAAA,2BAAiB,EACrB,uBAAA,IAAI,qCAAS,EACb,KAAK,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,CAChB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,4BAAmB,EAAC,kCAAkC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\nimport { AccountWalletType } from '@metamask/account-api';\nimport type { UserStorageController } from '@metamask/profile-sync-controller';\n\nimport { AtomicSyncQueue } from './atomic-sync-queue';\nimport { backupAndSyncLogger } from '../../logger';\nimport type { AccountTreeControllerState } from '../../types';\nimport type { AccountWalletEntropyObject } from '../../wallet';\nimport { TraceName } from '../analytics';\nimport type { ProfileId } from '../authentication';\nimport { getProfileId } from '../authentication';\nimport {\n  createLocalGroupsFromUserStorage,\n  performLegacyAccountSyncing,\n  syncGroupsMetadata,\n  syncGroupMetadata,\n  syncWalletMetadata,\n} from '../syncing';\nimport type {\n  BackupAndSyncContext,\n  UserStorageSyncedWallet,\n  UserStorageSyncedWalletGroup,\n} from '../types';\nimport {\n  getAllGroupsFromUserStorage,\n  getGroupFromUserStorage,\n  getWalletFromUserStorage,\n  pushGroupToUserStorageBatch,\n} from '../user-storage';\nimport {\n  createStateSnapshot,\n  restoreStateFromSnapshot,\n  getLocalEntropyWallets,\n  getLocalGroupsForEntropyWallet,\n  toErrorMessage,\n} from '../utils';\nimport type { StateSnapshot } from '../utils';\n\n/**\n * Service responsible for managing all backup and sync operations.\n *\n * This service handles:\n * - Full sync operations\n * - Single item sync operations\n * - Sync queue management\n * - Sync state management\n */\nexport class BackupAndSyncService {\n  readonly #context: BackupAndSyncContext;\n\n  /**\n   * Queue manager for atomic sync operations.\n   */\n  readonly #atomicSyncQueue: AtomicSyncQueue;\n\n  /**\n   * Cached promise for ongoing full sync operations.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #ongoingFullSyncPromise: Promise<void> | null = null;\n\n  /**\n   * Cached promise for the first ongoing full sync operation.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #firstOngoingFullSyncPromise: Promise<void> | null = null;\n\n  constructor(context: BackupAndSyncContext) {\n    this.#context = context;\n    this.#atomicSyncQueue = new AtomicSyncQueue();\n  }\n\n  /**\n   * Checks if syncing is currently in progress.\n   *\n   * @returns True if syncing is in progress.\n   */\n  get isInProgress(): boolean {\n    return this.#context.controller.state.isAccountTreeSyncingInProgress;\n  }\n\n  /**\n   * Checks if the account tree has been synced at least once.\n   *\n   * @returns True if the account tree has been synced at least once.\n   */\n  get hasSyncedAtLeastOnce(): boolean {\n    return this.#context.controller.state\n      .hasAccountTreeSyncingSyncedAtLeastOnce;\n  }\n\n  /**\n   * Checks if backup and sync is enabled by checking UserStorageController state.\n   *\n   * @returns True if backup and sync + account syncing is enabled.\n   */\n  get isBackupAndSyncEnabled(): boolean {\n    const userStorageControllerState = this.#context.messenger.call(\n      'UserStorageController:getState',\n    );\n    const { isAccountSyncingEnabled, isBackupAndSyncEnabled } =\n      userStorageControllerState;\n\n    return isBackupAndSyncEnabled && isAccountSyncingEnabled;\n  }\n\n  /**\n   * Clears the atomic queue and resets ongoing operations.\n   */\n  clearState(): void {\n    this.#atomicSyncQueue.clear();\n    this.#ongoingFullSyncPromise = null;\n    this.#firstOngoingFullSyncPromise = null;\n  }\n\n  /**\n   * Handles changes to the user storage state.\n   * Used to clear the backup and sync service state.\n   *\n   * @param state - The new user storage state.\n   */\n  handleUserStorageStateChange(\n    state: UserStorageController.UserStorageControllerState,\n  ): void {\n    if (!state.isAccountSyncingEnabled || !state.isBackupAndSyncEnabled) {\n      // If either syncing is disabled, clear the account tree state\n      this.clearState();\n    }\n  }\n\n  /**\n   * Gets the entropy wallet associated with the given wallet ID.\n   *\n   * @param walletId - The wallet ID to look up.\n   * @returns The associated entropy wallet, or undefined if not found.\n   */\n  #getEntropyWallet(\n    walletId: AccountWalletId,\n  ): AccountWalletEntropyObject | undefined {\n    const wallet = this.#context.controller.state.accountTree.wallets[walletId];\n    return wallet?.type === AccountWalletType.Entropy ? wallet : undefined;\n  }\n\n  /**\n   * Sets up cleanup for ongoing sync promise tracking without affecting error propagation.\n   *\n   * @param promise - The promise to track and clean up\n   * @returns The same promise (for chaining)\n   */\n  #setupOngoingPromiseCleanup(promise: Promise<void>): Promise<void> {\n    this.#ongoingFullSyncPromise = promise;\n    // Set up cleanup without affecting the returned promise\n    promise\n      .finally(() => {\n        this.#ongoingFullSyncPromise = null;\n      })\n      .catch(() => {\n        // Only ignore errors from the cleanup operation itself\n        // The original promise errors are still propagated to callers\n      });\n    return promise;\n  }\n\n  /**\n   * Enqueues a single wallet sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  enqueueSingleWalletSync(walletId: AccountWalletId): void {\n    if (!this.isBackupAndSyncEnabled || !this.hasSyncedAtLeastOnce) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleWalletSyncInner(walletId),\n    );\n  }\n\n  /**\n   * Enqueues a single group sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  enqueueSingleGroupSync(groupId: AccountGroupId): void {\n    if (\n      !this.isBackupAndSyncEnabled ||\n      !this.hasSyncedAtLeastOnce ||\n      // This prevents rate limiting scenarios where full syncs trigger group creations\n      // that in turn enqueue the same single group syncs that the full sync just did.\n      // This can very rarely lead to inconsistencies, but will be fixed on the next full sync.\n      // TODO: let's improve this in the future by tracking the updates done in the full sync and\n      // comparing against that.\n      this.isInProgress\n    ) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleGroupSyncInner(groupId),\n    );\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   * If a full sync is already in progress, it will return the ongoing promise.\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * NOTE: in some very edge cases, this can be ran concurrently if triggered quickly after\n   * toggling back and forth the backup and sync feature from the UI.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSync(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    // If there's an ongoing sync (including first sync), return it\n    if (this.#ongoingFullSyncPromise) {\n      return this.#ongoingFullSyncPromise;\n    }\n\n    // Create a new ongoing sync (sequential calls after previous completed)\n    const newSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(() =>\n      this.#performFullSyncInner(),\n    );\n\n    // First sync setup - create and cache the first sync promise\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = newSyncPromise;\n    }\n\n    return this.#setupOngoingPromiseCleanup(newSyncPromise);\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * If the first ever full sync is already in progress, it will return the ongoing promise.\n   * If the first ever full sync has already completed, it will resolve and NOT start a new sync.\n   *\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSyncAtLeastOnce(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(\n        () => this.#performFullSyncInner(),\n      );\n      // eslint-disable-next-line no-void\n      void this.#setupOngoingPromiseCleanup(this.#firstOngoingFullSyncPromise);\n    }\n\n    return this.#firstOngoingFullSyncPromise;\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * This method performs a comprehensive sync operation that:\n   * 1. Identifies all local entropy wallets that can be synchronized\n   * 2. Performs legacy account syncing if needed (for backwards compatibility)\n   * - Disables subsequent legacy syncing by setting a flag in user storage\n   * - Exits early if multichain account syncing is disabled after legacy sync\n   * 3. Executes multichain account syncing for each wallet:\n   * - Syncs wallet metadata bidirectionally\n   * - Creates missing local groups from user storage data (or pushes local groups if none exist remotely)\n   * - Refreshes local state to reflect newly created groups\n   * - Syncs group metadata bidirectionally\n   *\n   * The sync is atomic per wallet with rollback on errors, but continues processing other wallets\n   * if individual wallet sync fails. A global lock prevents concurrent sync operations.\n   *\n   * During this process, all other atomic multichain related user storage updates are blocked.\n   *\n   * @throws Will throw if the sync operation encounters unrecoverable errors\n   */\n  async #performFullSyncInner(): Promise<void> {\n    // Prevent multiple syncs from running at the same time.\n    // Also prevents atomic updates from being applied while syncing is in progress.\n    if (this.isInProgress) {\n      return;\n    }\n\n    // Set isAccountTreeSyncingInProgress immediately to prevent race conditions\n    this.#context.controllerStateUpdateFn(\n      (state: AccountTreeControllerState) => {\n        state.isAccountTreeSyncingInProgress = true;\n      },\n    );\n\n    // Encapsulate the sync logic in a function to allow tracing\n    const bigSyncFn = async () => {\n      try {\n        // 1. Identifies all local entropy wallets that can be synchronized\n        const localSyncableWallets = getLocalEntropyWallets(this.#context);\n\n        if (!localSyncableWallets.length) {\n          // No wallets to sync, just return. This shouldn't happen.\n          return;\n        }\n\n        // 2. Iterate over each local wallet\n        for (const wallet of localSyncableWallets) {\n          const entropySourceId = wallet.metadata.entropy.id;\n\n          let walletProfileId: ProfileId;\n          let walletFromUserStorage: UserStorageSyncedWallet | null;\n          let groupsFromUserStorage: UserStorageSyncedWalletGroup[];\n\n          try {\n            walletProfileId = await getProfileId(\n              this.#context,\n              entropySourceId,\n            );\n\n            [walletFromUserStorage, groupsFromUserStorage] = await Promise.all([\n              getWalletFromUserStorage(this.#context, entropySourceId),\n              getAllGroupsFromUserStorage(this.#context, entropySourceId),\n            ]);\n\n            // 2.1 Decide if we need to perform legacy account syncing\n            if (\n              !walletFromUserStorage ||\n              !walletFromUserStorage.isLegacyAccountSyncingDisabled\n            ) {\n              // 2.2 Perform legacy account syncing\n              // This will migrate legacy account data to the new structure.\n              // This operation will only be performed once.\n              await performLegacyAccountSyncing(\n                this.#context,\n                entropySourceId,\n                walletProfileId,\n              );\n            }\n          } catch (error) {\n            const errorMessage = toErrorMessage(error);\n            const errorString = `Legacy syncing failed for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n            throw new Error(errorString);\n          }\n\n          // 3. Execute multichain account syncing\n          let stateSnapshot: StateSnapshot | undefined;\n\n          try {\n            // 3.1 Wallet syncing\n            // Create a state snapshot before processing each wallet for potential rollback\n            stateSnapshot = createStateSnapshot(this.#context);\n\n            // Sync wallet metadata bidirectionally\n            await syncWalletMetadata(\n              this.#context,\n              wallet,\n              walletFromUserStorage,\n              walletProfileId,\n            );\n\n            // 3.2 Groups syncing\n            // If groups data does not exist in user storage yet, create it\n            if (!groupsFromUserStorage.length) {\n              // If no groups exist in user storage, we can push all groups from the wallet to the user storage and exit\n              await pushGroupToUserStorageBatch(\n                this.#context,\n                getLocalGroupsForEntropyWallet(this.#context, wallet.id),\n                entropySourceId,\n              );\n\n              continue; // No need to proceed with metadata comparison if groups are new\n            }\n\n            // Create local groups for each group from user storage if they do not exist\n            // This will ensure that we have all groups available locally before syncing metadata\n            await createLocalGroupsFromUserStorage(\n              this.#context,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n\n            // Sync group metadata bidirectionally\n            await syncGroupsMetadata(\n              this.#context,\n              wallet,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n          } catch (error) {\n            const errorMessage = toErrorMessage(error);\n            const errorString = `Error during multichain account syncing for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n\n            // Attempt to rollback state changes for this wallet\n            try {\n              if (!stateSnapshot) {\n                throw new Error(\n                  `State snapshot is missing for wallet ${wallet.id}`,\n                );\n              }\n              restoreStateFromSnapshot(this.#context, stateSnapshot);\n              backupAndSyncLogger(\n                `Rolled back state changes for wallet ${wallet.id}`,\n              );\n            } catch (rollbackError) {\n              backupAndSyncLogger(\n                `Failed to rollback state for wallet ${wallet.id}:`,\n                rollbackError instanceof Error\n                  ? rollbackError.message\n                  : String(rollbackError),\n              );\n            }\n\n            // Continue with next wallet instead of failing the entire sync\n            continue;\n          }\n        }\n      } catch (error) {\n        backupAndSyncLogger('Error during multichain account syncing:', error);\n        throw error;\n      }\n\n      this.#context.controllerStateUpdateFn((state) => {\n        state.hasAccountTreeSyncingSyncedAtLeastOnce = true;\n      });\n    };\n\n    // Execute the big sync function with tracing and ensure state cleanup\n    try {\n      await this.#context.traceFn(\n        {\n          name: TraceName.AccountSyncFull,\n        },\n        bigSyncFn,\n      );\n    } finally {\n      // Always reset state, regardless of success or failure\n      this.#context.controllerStateUpdateFn(\n        (state: AccountTreeControllerState) => {\n          state.isAccountTreeSyncingInProgress = false;\n        },\n      );\n    }\n  }\n\n  /**\n   * Performs a single wallet's bidirectional metadata sync with user storage.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  async #performSingleWalletSyncInner(\n    walletId: AccountWalletId,\n  ): Promise<void> {\n    try {\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n      const walletFromUserStorage = await getWalletFromUserStorage(\n        this.#context,\n        entropySourceId,\n      );\n\n      await syncWalletMetadata(\n        this.#context,\n        wallet,\n        walletFromUserStorage,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(\n        `Error in single wallet sync for ${walletId}:`,\n        error,\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Performs a single group's bidirectional metadata sync with user storage.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  async #performSingleGroupSyncInner(groupId: AccountGroupId): Promise<void> {\n    try {\n      const walletId = this.#context.groupIdToWalletId.get(groupId);\n      if (!walletId) {\n        return;\n      }\n\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const group = wallet.groups[groupId];\n      if (!group) {\n        return;\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n\n      // Get the specific group from user storage\n      const groupFromUserStorage = await getGroupFromUserStorage(\n        this.#context,\n        entropySourceId,\n        group.metadata.entropy.groupIndex,\n      );\n\n      await syncGroupMetadata(\n        this.#context,\n        group,\n        groupFromUserStorage,\n        entropySourceId,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(`Error in single group sync for ${groupId}:`, error);\n      throw error;\n    }\n  }\n}\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\nimport { AccountWalletType } from '@metamask/account-api';\nimport type { UserStorageController } from '@metamask/profile-sync-controller';\n\nimport { AtomicSyncQueue } from './atomic-sync-queue';\nimport { backupAndSyncLogger } from '../../logger';\nimport type { AccountTreeControllerState } from '../../types';\nimport type { AccountWalletEntropyObject } from '../../wallet';\nimport { TraceName } from '../analytics';\nimport type { ProfileId } from '../authentication';\nimport { getProfileId } from '../authentication';\nimport {\n  createLocalGroupsFromUserStorage,\n  performLegacyAccountSyncing,\n  syncGroupsMetadata,\n  syncGroupMetadata,\n  syncWalletMetadata,\n} from '../syncing';\nimport type {\n  BackupAndSyncContext,\n  UserStorageSyncedWallet,\n  UserStorageSyncedWalletGroup,\n} from '../types';\nimport {\n  getAllGroupsFromUserStorage,\n  getGroupFromUserStorage,\n  getWalletFromUserStorage,\n  pushGroupToUserStorageBatch,\n} from '../user-storage';\nimport {\n  createStateSnapshot,\n  restoreStateFromSnapshot,\n  getLocalEntropyWallets,\n  getLocalGroupsForEntropyWallet,\n} from '../utils';\nimport type { StateSnapshot } from '../utils';\n\n/**\n * Service responsible for managing all backup and sync operations.\n *\n * This service handles:\n * - Full sync operations\n * - Single item sync operations\n * - Sync queue management\n * - Sync state management\n */\nexport class BackupAndSyncService {\n  readonly #context: BackupAndSyncContext;\n\n  /**\n   * Queue manager for atomic sync operations.\n   */\n  readonly #atomicSyncQueue: AtomicSyncQueue;\n\n  /**\n   * Cached promise for ongoing full sync operations.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #ongoingFullSyncPromise: Promise<void> | null = null;\n\n  /**\n   * Cached promise for the first ongoing full sync operation.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #firstOngoingFullSyncPromise: Promise<void> | null = null;\n\n  constructor(context: BackupAndSyncContext) {\n    this.#context = context;\n    this.#atomicSyncQueue = new AtomicSyncQueue();\n  }\n\n  /**\n   * Checks if syncing is currently in progress.\n   *\n   * @returns True if syncing is in progress.\n   */\n  get isInProgress(): boolean {\n    return this.#context.controller.state.isAccountTreeSyncingInProgress;\n  }\n\n  /**\n   * Checks if the account tree has been synced at least once.\n   *\n   * @returns True if the account tree has been synced at least once.\n   */\n  get hasSyncedAtLeastOnce(): boolean {\n    return this.#context.controller.state\n      .hasAccountTreeSyncingSyncedAtLeastOnce;\n  }\n\n  /**\n   * Checks if backup and sync is enabled by checking UserStorageController state.\n   *\n   * @returns True if backup and sync + account syncing is enabled.\n   */\n  get isBackupAndSyncEnabled(): boolean {\n    const userStorageControllerState = this.#context.messenger.call(\n      'UserStorageController:getState',\n    );\n    const { isAccountSyncingEnabled, isBackupAndSyncEnabled } =\n      userStorageControllerState;\n\n    return isBackupAndSyncEnabled && isAccountSyncingEnabled;\n  }\n\n  /**\n   * Clears the atomic queue and resets ongoing operations.\n   */\n  clearState(): void {\n    this.#atomicSyncQueue.clear();\n    this.#ongoingFullSyncPromise = null;\n    this.#firstOngoingFullSyncPromise = null;\n  }\n\n  /**\n   * Handles changes to the user storage state.\n   * Used to clear the backup and sync service state.\n   *\n   * @param state - The new user storage state.\n   */\n  handleUserStorageStateChange(\n    state: UserStorageController.UserStorageControllerState,\n  ): void {\n    if (!state.isAccountSyncingEnabled || !state.isBackupAndSyncEnabled) {\n      // If either syncing is disabled, clear the account tree state\n      this.clearState();\n    }\n  }\n\n  /**\n   * Gets the entropy wallet associated with the given wallet ID.\n   *\n   * @param walletId - The wallet ID to look up.\n   * @returns The associated entropy wallet, or undefined if not found.\n   */\n  #getEntropyWallet(\n    walletId: AccountWalletId,\n  ): AccountWalletEntropyObject | undefined {\n    const wallet = this.#context.controller.state.accountTree.wallets[walletId];\n    return wallet?.type === AccountWalletType.Entropy ? wallet : undefined;\n  }\n\n  /**\n   * Sets up cleanup for ongoing sync promise tracking without affecting error propagation.\n   *\n   * @param promise - The promise to track and clean up\n   * @returns The same promise (for chaining)\n   */\n  #setupOngoingPromiseCleanup(promise: Promise<void>): Promise<void> {\n    this.#ongoingFullSyncPromise = promise;\n    // Set up cleanup without affecting the returned promise\n    promise\n      .finally(() => {\n        this.#ongoingFullSyncPromise = null;\n      })\n      .catch(() => {\n        // Only ignore errors from the cleanup operation itself\n        // The original promise errors are still propagated to callers\n      });\n    return promise;\n  }\n\n  /**\n   * Enqueues a single wallet sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  enqueueSingleWalletSync(walletId: AccountWalletId): void {\n    if (!this.isBackupAndSyncEnabled || !this.hasSyncedAtLeastOnce) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleWalletSyncInner(walletId),\n    );\n  }\n\n  /**\n   * Enqueues a single group sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  enqueueSingleGroupSync(groupId: AccountGroupId): void {\n    if (\n      !this.isBackupAndSyncEnabled ||\n      !this.hasSyncedAtLeastOnce ||\n      // This prevents rate limiting scenarios where full syncs trigger group creations\n      // that in turn enqueue the same single group syncs that the full sync just did.\n      // This can very rarely lead to inconsistencies, but will be fixed on the next full sync.\n      // TODO: let's improve this in the future by tracking the updates done in the full sync and\n      // comparing against that.\n      this.isInProgress\n    ) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleGroupSyncInner(groupId),\n    );\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   * If a full sync is already in progress, it will return the ongoing promise.\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * NOTE: in some very edge cases, this can be ran concurrently if triggered quickly after\n   * toggling back and forth the backup and sync feature from the UI.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSync(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    // If there's an ongoing sync (including first sync), return it\n    if (this.#ongoingFullSyncPromise) {\n      return this.#ongoingFullSyncPromise;\n    }\n\n    // Create a new ongoing sync (sequential calls after previous completed)\n    const newSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(() =>\n      this.#performFullSyncInner(),\n    );\n\n    // First sync setup - create and cache the first sync promise\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = newSyncPromise;\n    }\n\n    return this.#setupOngoingPromiseCleanup(newSyncPromise);\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * If the first ever full sync is already in progress, it will return the ongoing promise.\n   * If the first ever full sync has already completed, it will resolve and NOT start a new sync.\n   *\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSyncAtLeastOnce(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(\n        () => this.#performFullSyncInner(),\n      );\n      // eslint-disable-next-line no-void\n      void this.#setupOngoingPromiseCleanup(this.#firstOngoingFullSyncPromise);\n    }\n\n    return this.#firstOngoingFullSyncPromise;\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * This method performs a comprehensive sync operation that:\n   * 1. Identifies all local entropy wallets that can be synchronized\n   * 2. Performs legacy account syncing if needed (for backwards compatibility)\n   * - Disables subsequent legacy syncing by setting a flag in user storage\n   * - Exits early if multichain account syncing is disabled after legacy sync\n   * 3. Executes multichain account syncing for each wallet:\n   * - Syncs wallet metadata bidirectionally\n   * - Creates missing local groups from user storage data (or pushes local groups if none exist remotely)\n   * - Refreshes local state to reflect newly created groups\n   * - Syncs group metadata bidirectionally\n   *\n   * The sync is atomic per wallet with rollback on errors, but continues processing other wallets\n   * if individual wallet sync fails. A global lock prevents concurrent sync operations.\n   *\n   * During this process, all other atomic multichain related user storage updates are blocked.\n   *\n   * @throws Will throw if the sync operation encounters unrecoverable errors\n   */\n  async #performFullSyncInner(): Promise<void> {\n    // Prevent multiple syncs from running at the same time.\n    // Also prevents atomic updates from being applied while syncing is in progress.\n    if (this.isInProgress) {\n      return;\n    }\n\n    // Set isAccountTreeSyncingInProgress immediately to prevent race conditions\n    this.#context.controllerStateUpdateFn(\n      (state: AccountTreeControllerState) => {\n        state.isAccountTreeSyncingInProgress = true;\n      },\n    );\n\n    // Encapsulate the sync logic in a function to allow tracing\n    const bigSyncFn = async () => {\n      try {\n        // 1. Identifies all local entropy wallets that can be synchronized\n        const localSyncableWallets = getLocalEntropyWallets(this.#context);\n\n        if (!localSyncableWallets.length) {\n          // No wallets to sync, just return. This shouldn't happen.\n          return;\n        }\n\n        // 2. Iterate over each local wallet\n        for (const wallet of localSyncableWallets) {\n          const entropySourceId = wallet.metadata.entropy.id;\n\n          let walletProfileId: ProfileId;\n          let walletFromUserStorage: UserStorageSyncedWallet | null;\n          let groupsFromUserStorage: UserStorageSyncedWalletGroup[];\n\n          try {\n            walletProfileId = await getProfileId(\n              this.#context,\n              entropySourceId,\n            );\n\n            [walletFromUserStorage, groupsFromUserStorage] = await Promise.all([\n              getWalletFromUserStorage(this.#context, entropySourceId),\n              getAllGroupsFromUserStorage(this.#context, entropySourceId),\n            ]);\n\n            // 2.1 Decide if we need to perform legacy account syncing\n            if (\n              !walletFromUserStorage ||\n              !walletFromUserStorage.isLegacyAccountSyncingDisabled\n            ) {\n              // 2.2 Perform legacy account syncing\n              // This will migrate legacy account data to the new structure.\n              // This operation will only be performed once.\n              await performLegacyAccountSyncing(\n                this.#context,\n                entropySourceId,\n                walletProfileId,\n              );\n            }\n          } catch (error) {\n            const errorMessage =\n              error instanceof Error ? error.message : String(error);\n            const errorString = `Legacy syncing failed for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n            throw new Error(errorString);\n          }\n\n          // 3. Execute multichain account syncing\n          let stateSnapshot: StateSnapshot | undefined;\n\n          try {\n            // 3.1 Wallet syncing\n            // Create a state snapshot before processing each wallet for potential rollback\n            stateSnapshot = createStateSnapshot(this.#context);\n\n            // Sync wallet metadata bidirectionally\n            await syncWalletMetadata(\n              this.#context,\n              wallet,\n              walletFromUserStorage,\n              walletProfileId,\n            );\n\n            // 3.2 Groups syncing\n            // If groups data does not exist in user storage yet, create it\n            if (!groupsFromUserStorage.length) {\n              // If no groups exist in user storage, we can push all groups from the wallet to the user storage and exit\n              await pushGroupToUserStorageBatch(\n                this.#context,\n                getLocalGroupsForEntropyWallet(this.#context, wallet.id),\n                entropySourceId,\n              );\n\n              continue; // No need to proceed with metadata comparison if groups are new\n            }\n\n            // Create local groups for each group from user storage if they do not exist\n            // This will ensure that we have all groups available locally before syncing metadata\n            await createLocalGroupsFromUserStorage(\n              this.#context,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n\n            // Sync group metadata bidirectionally\n            await syncGroupsMetadata(\n              this.#context,\n              wallet,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n          } catch (error) {\n            const errorMessage =\n              error instanceof Error ? error.message : String(error);\n            const errorString = `Error during multichain account syncing for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n\n            // Attempt to rollback state changes for this wallet\n            try {\n              if (!stateSnapshot) {\n                throw new Error(\n                  `State snapshot is missing for wallet ${wallet.id}`,\n                );\n              }\n              restoreStateFromSnapshot(this.#context, stateSnapshot);\n              backupAndSyncLogger(\n                `Rolled back state changes for wallet ${wallet.id}`,\n              );\n            } catch (rollbackError) {\n              backupAndSyncLogger(\n                `Failed to rollback state for wallet ${wallet.id}:`,\n                rollbackError instanceof Error\n                  ? rollbackError.message\n                  : String(rollbackError),\n              );\n            }\n\n            // Continue with next wallet instead of failing the entire sync\n            continue;\n          }\n        }\n      } catch (error) {\n        backupAndSyncLogger('Error during multichain account syncing:', error);\n        throw error;\n      }\n\n      this.#context.controllerStateUpdateFn((state) => {\n        state.hasAccountTreeSyncingSyncedAtLeastOnce = true;\n      });\n    };\n\n    // Execute the big sync function with tracing and ensure state cleanup\n    try {\n      await this.#context.traceFn(\n        {\n          name: TraceName.AccountSyncFull,\n        },\n        bigSyncFn,\n      );\n    } finally {\n      // Always reset state, regardless of success or failure\n      this.#context.controllerStateUpdateFn(\n        (state: AccountTreeControllerState) => {\n          state.isAccountTreeSyncingInProgress = false;\n        },\n      );\n    }\n  }\n\n  /**\n   * Performs a single wallet's bidirectional metadata sync with user storage.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  async #performSingleWalletSyncInner(\n    walletId: AccountWalletId,\n  ): Promise<void> {\n    try {\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n      const walletFromUserStorage = await getWalletFromUserStorage(\n        this.#context,\n        entropySourceId,\n      );\n\n      await syncWalletMetadata(\n        this.#context,\n        wallet,\n        walletFromUserStorage,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(\n        `Error in single wallet sync for ${walletId}:`,\n        error,\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Performs a single group's bidirectional metadata sync with user storage.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  async #performSingleGroupSyncInner(groupId: AccountGroupId): Promise<void> {\n    try {\n      const walletId = this.#context.groupIdToWalletId.get(groupId);\n      if (!walletId) {\n        return;\n      }\n\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const group = wallet.groups[groupId];\n      if (!group) {\n        return;\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n\n      // Get the specific group from user storage\n      const groupFromUserStorage = await getGroupFromUserStorage(\n        this.#context,\n        entropySourceId,\n        group.metadata.entropy.groupIndex,\n      );\n\n      await syncGroupMetadata(\n        this.#context,\n        group,\n        groupFromUserStorage,\n        entropySourceId,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(`Error in single group sync for ${groupId}:`, error);\n      throw error;\n    }\n  }\n}\n"]}

package/dist/backup-and-sync/service/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,8BAA8B;AAE7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,0CAA0C;AAgB/E,OAAO,KAAK,EACV,oBAAoB,EAGrB,qBAAiB;AAgBlB;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAoBnB,OAAO,EAAE,oBAAoB;IAKzC;;;;OAIG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAGlC;IAED;;;;OAIG;IACH,IAAI,sBAAsB,IAAI,OAAO,CAQpC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;OAKG;IACH,4BAA4B,CAC1B,KAAK,EAAE,qBAAqB,CAAC,0BAA0B,GACtD,IAAI;IAwCP;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAWxD;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAoBrD;;;;;;;;;;OAUG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtC;;;;;;;;;;OAUG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CAsSlD"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,8BAA8B;AAE7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,0CAA0C;AAgB/E,OAAO,KAAK,EACV,oBAAoB,EAGrB,qBAAiB;AAelB;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAoBnB,OAAO,EAAE,oBAAoB;IAKzC;;;;OAIG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAGlC;IAED;;;;OAIG;IACH,IAAI,sBAAsB,IAAI,OAAO,CAQpC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;OAKG;IACH,4BAA4B,CAC1B,KAAK,EAAE,qBAAqB,CAAC,0BAA0B,GACtD,IAAI;IAwCP;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAWxD;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAoBrD;;;;;;;;;;OAUG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtC;;;;;;;;;;OAUG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CAwSlD"}

package/dist/backup-and-sync/service/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,8BAA8B;AAE7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,0CAA0C;AAgB/E,OAAO,KAAK,EACV,oBAAoB,EAGrB,qBAAiB;AAgBlB;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAoBnB,OAAO,EAAE,oBAAoB;IAKzC;;;;OAIG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAGlC;IAED;;;;OAIG;IACH,IAAI,sBAAsB,IAAI,OAAO,CAQpC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;OAKG;IACH,4BAA4B,CAC1B,KAAK,EAAE,qBAAqB,CAAC,0BAA0B,GACtD,IAAI;IAwCP;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAWxD;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAoBrD;;;;;;;;;;OAUG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtC;;;;;;;;;;OAUG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CAsSlD"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,8BAA8B;AAE7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,0CAA0C;AAgB/E,OAAO,KAAK,EACV,oBAAoB,EAGrB,qBAAiB;AAelB;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAoBnB,OAAO,EAAE,oBAAoB;IAKzC;;;;OAIG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAGlC;IAED;;;;OAIG;IACH,IAAI,sBAAsB,IAAI,OAAO,CAQpC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;OAKG;IACH,4BAA4B,CAC1B,KAAK,EAAE,qBAAqB,CAAC,0BAA0B,GACtD,IAAI;IAwCP;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAWxD;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAoBrD;;;;;;;;;;OAUG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtC;;;;;;;;;;OAUG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CAwSlD"}

package/dist/backup-and-sync/service/index.mjs

@@ -17,7 +17,7 @@ import { TraceName } from "../analytics/index.mjs";
 import { getProfileId } from "../authentication/index.mjs";
 import { createLocalGroupsFromUserStorage, performLegacyAccountSyncing, syncGroupsMetadata, syncGroupMetadata, syncWalletMetadata } from "../syncing/index.mjs";
 import { getAllGroupsFromUserStorage, getGroupFromUserStorage, getWalletFromUserStorage, pushGroupToUserStorageBatch } from "../user-storage/index.mjs";
-import { createStateSnapshot, restoreStateFromSnapshot, getLocalEntropyWallets, getLocalGroupsForEntropyWallet, toErrorMessage } from "../utils/index.mjs";
+import { createStateSnapshot, restoreStateFromSnapshot, getLocalEntropyWallets, getLocalGroupsForEntropyWallet } from "../utils/index.mjs";
 /**
  * Service responsible for managing all backup and sync operations.
  *
@@ -257,7 +257,7 @@ async function _BackupAndSyncService_performFullSyncInner() {
                     }
                 }
                 catch (error) {
-                    const errorMessage = toErrorMessage(error);
+                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const errorString = `Legacy syncing failed for wallet ${wallet.id}: ${errorMessage}`;
                     backupAndSyncLogger(errorString);
                     throw new Error(errorString);
@@ -284,7 +284,7 @@ async function _BackupAndSyncService_performFullSyncInner() {
                     await syncGroupsMetadata(__classPrivateFieldGet(this, _BackupAndSyncService_context, "f"), wallet, groupsFromUserStorage, entropySourceId, walletProfileId);
                 }
                 catch (error) {
-                    const errorMessage = toErrorMessage(error);
+                    const errorMessage = error instanceof Error ? error.message : String(error);
                     const errorString = `Error during multichain account syncing for wallet ${wallet.id}: ${errorMessage}`;
                     backupAndSyncLogger(errorString);
                     // Attempt to rollback state changes for this wallet

package/dist/backup-and-sync/service/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\nimport { AccountWalletType } from '@metamask/account-api';\nimport type { UserStorageController } from '@metamask/profile-sync-controller';\n\nimport { AtomicSyncQueue } from './atomic-sync-queue';\nimport { backupAndSyncLogger } from '../../logger';\nimport type { AccountTreeControllerState } from '../../types';\nimport type { AccountWalletEntropyObject } from '../../wallet';\nimport { TraceName } from '../analytics';\nimport type { ProfileId } from '../authentication';\nimport { getProfileId } from '../authentication';\nimport {\n  createLocalGroupsFromUserStorage,\n  performLegacyAccountSyncing,\n  syncGroupsMetadata,\n  syncGroupMetadata,\n  syncWalletMetadata,\n} from '../syncing';\nimport type {\n  BackupAndSyncContext,\n  UserStorageSyncedWallet,\n  UserStorageSyncedWalletGroup,\n} from '../types';\nimport {\n  getAllGroupsFromUserStorage,\n  getGroupFromUserStorage,\n  getWalletFromUserStorage,\n  pushGroupToUserStorageBatch,\n} from '../user-storage';\nimport {\n  createStateSnapshot,\n  restoreStateFromSnapshot,\n  getLocalEntropyWallets,\n  getLocalGroupsForEntropyWallet,\n  toErrorMessage,\n} from '../utils';\nimport type { StateSnapshot } from '../utils';\n\n/**\n * Service responsible for managing all backup and sync operations.\n *\n * This service handles:\n * - Full sync operations\n * - Single item sync operations\n * - Sync queue management\n * - Sync state management\n */\nexport class BackupAndSyncService {\n  readonly #context: BackupAndSyncContext;\n\n  /**\n   * Queue manager for atomic sync operations.\n   */\n  readonly #atomicSyncQueue: AtomicSyncQueue;\n\n  /**\n   * Cached promise for ongoing full sync operations.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #ongoingFullSyncPromise: Promise<void> | null = null;\n\n  /**\n   * Cached promise for the first ongoing full sync operation.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #firstOngoingFullSyncPromise: Promise<void> | null = null;\n\n  constructor(context: BackupAndSyncContext) {\n    this.#context = context;\n    this.#atomicSyncQueue = new AtomicSyncQueue();\n  }\n\n  /**\n   * Checks if syncing is currently in progress.\n   *\n   * @returns True if syncing is in progress.\n   */\n  get isInProgress(): boolean {\n    return this.#context.controller.state.isAccountTreeSyncingInProgress;\n  }\n\n  /**\n   * Checks if the account tree has been synced at least once.\n   *\n   * @returns True if the account tree has been synced at least once.\n   */\n  get hasSyncedAtLeastOnce(): boolean {\n    return this.#context.controller.state\n      .hasAccountTreeSyncingSyncedAtLeastOnce;\n  }\n\n  /**\n   * Checks if backup and sync is enabled by checking UserStorageController state.\n   *\n   * @returns True if backup and sync + account syncing is enabled.\n   */\n  get isBackupAndSyncEnabled(): boolean {\n    const userStorageControllerState = this.#context.messenger.call(\n      'UserStorageController:getState',\n    );\n    const { isAccountSyncingEnabled, isBackupAndSyncEnabled } =\n      userStorageControllerState;\n\n    return isBackupAndSyncEnabled && isAccountSyncingEnabled;\n  }\n\n  /**\n   * Clears the atomic queue and resets ongoing operations.\n   */\n  clearState(): void {\n    this.#atomicSyncQueue.clear();\n    this.#ongoingFullSyncPromise = null;\n    this.#firstOngoingFullSyncPromise = null;\n  }\n\n  /**\n   * Handles changes to the user storage state.\n   * Used to clear the backup and sync service state.\n   *\n   * @param state - The new user storage state.\n   */\n  handleUserStorageStateChange(\n    state: UserStorageController.UserStorageControllerState,\n  ): void {\n    if (!state.isAccountSyncingEnabled || !state.isBackupAndSyncEnabled) {\n      // If either syncing is disabled, clear the account tree state\n      this.clearState();\n    }\n  }\n\n  /**\n   * Gets the entropy wallet associated with the given wallet ID.\n   *\n   * @param walletId - The wallet ID to look up.\n   * @returns The associated entropy wallet, or undefined if not found.\n   */\n  #getEntropyWallet(\n    walletId: AccountWalletId,\n  ): AccountWalletEntropyObject | undefined {\n    const wallet = this.#context.controller.state.accountTree.wallets[walletId];\n    return wallet?.type === AccountWalletType.Entropy ? wallet : undefined;\n  }\n\n  /**\n   * Sets up cleanup for ongoing sync promise tracking without affecting error propagation.\n   *\n   * @param promise - The promise to track and clean up\n   * @returns The same promise (for chaining)\n   */\n  #setupOngoingPromiseCleanup(promise: Promise<void>): Promise<void> {\n    this.#ongoingFullSyncPromise = promise;\n    // Set up cleanup without affecting the returned promise\n    promise\n      .finally(() => {\n        this.#ongoingFullSyncPromise = null;\n      })\n      .catch(() => {\n        // Only ignore errors from the cleanup operation itself\n        // The original promise errors are still propagated to callers\n      });\n    return promise;\n  }\n\n  /**\n   * Enqueues a single wallet sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  enqueueSingleWalletSync(walletId: AccountWalletId): void {\n    if (!this.isBackupAndSyncEnabled || !this.hasSyncedAtLeastOnce) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleWalletSyncInner(walletId),\n    );\n  }\n\n  /**\n   * Enqueues a single group sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  enqueueSingleGroupSync(groupId: AccountGroupId): void {\n    if (\n      !this.isBackupAndSyncEnabled ||\n      !this.hasSyncedAtLeastOnce ||\n      // This prevents rate limiting scenarios where full syncs trigger group creations\n      // that in turn enqueue the same single group syncs that the full sync just did.\n      // This can very rarely lead to inconsistencies, but will be fixed on the next full sync.\n      // TODO: let's improve this in the future by tracking the updates done in the full sync and\n      // comparing against that.\n      this.isInProgress\n    ) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleGroupSyncInner(groupId),\n    );\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   * If a full sync is already in progress, it will return the ongoing promise.\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * NOTE: in some very edge cases, this can be ran concurrently if triggered quickly after\n   * toggling back and forth the backup and sync feature from the UI.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSync(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    // If there's an ongoing sync (including first sync), return it\n    if (this.#ongoingFullSyncPromise) {\n      return this.#ongoingFullSyncPromise;\n    }\n\n    // Create a new ongoing sync (sequential calls after previous completed)\n    const newSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(() =>\n      this.#performFullSyncInner(),\n    );\n\n    // First sync setup - create and cache the first sync promise\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = newSyncPromise;\n    }\n\n    return this.#setupOngoingPromiseCleanup(newSyncPromise);\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * If the first ever full sync is already in progress, it will return the ongoing promise.\n   * If the first ever full sync has already completed, it will resolve and NOT start a new sync.\n   *\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSyncAtLeastOnce(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(\n        () => this.#performFullSyncInner(),\n      );\n      // eslint-disable-next-line no-void\n      void this.#setupOngoingPromiseCleanup(this.#firstOngoingFullSyncPromise);\n    }\n\n    return this.#firstOngoingFullSyncPromise;\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * This method performs a comprehensive sync operation that:\n   * 1. Identifies all local entropy wallets that can be synchronized\n   * 2. Performs legacy account syncing if needed (for backwards compatibility)\n   * - Disables subsequent legacy syncing by setting a flag in user storage\n   * - Exits early if multichain account syncing is disabled after legacy sync\n   * 3. Executes multichain account syncing for each wallet:\n   * - Syncs wallet metadata bidirectionally\n   * - Creates missing local groups from user storage data (or pushes local groups if none exist remotely)\n   * - Refreshes local state to reflect newly created groups\n   * - Syncs group metadata bidirectionally\n   *\n   * The sync is atomic per wallet with rollback on errors, but continues processing other wallets\n   * if individual wallet sync fails. A global lock prevents concurrent sync operations.\n   *\n   * During this process, all other atomic multichain related user storage updates are blocked.\n   *\n   * @throws Will throw if the sync operation encounters unrecoverable errors\n   */\n  async #performFullSyncInner(): Promise<void> {\n    // Prevent multiple syncs from running at the same time.\n    // Also prevents atomic updates from being applied while syncing is in progress.\n    if (this.isInProgress) {\n      return;\n    }\n\n    // Set isAccountTreeSyncingInProgress immediately to prevent race conditions\n    this.#context.controllerStateUpdateFn(\n      (state: AccountTreeControllerState) => {\n        state.isAccountTreeSyncingInProgress = true;\n      },\n    );\n\n    // Encapsulate the sync logic in a function to allow tracing\n    const bigSyncFn = async () => {\n      try {\n        // 1. Identifies all local entropy wallets that can be synchronized\n        const localSyncableWallets = getLocalEntropyWallets(this.#context);\n\n        if (!localSyncableWallets.length) {\n          // No wallets to sync, just return. This shouldn't happen.\n          return;\n        }\n\n        // 2. Iterate over each local wallet\n        for (const wallet of localSyncableWallets) {\n          const entropySourceId = wallet.metadata.entropy.id;\n\n          let walletProfileId: ProfileId;\n          let walletFromUserStorage: UserStorageSyncedWallet | null;\n          let groupsFromUserStorage: UserStorageSyncedWalletGroup[];\n\n          try {\n            walletProfileId = await getProfileId(\n              this.#context,\n              entropySourceId,\n            );\n\n            [walletFromUserStorage, groupsFromUserStorage] = await Promise.all([\n              getWalletFromUserStorage(this.#context, entropySourceId),\n              getAllGroupsFromUserStorage(this.#context, entropySourceId),\n            ]);\n\n            // 2.1 Decide if we need to perform legacy account syncing\n            if (\n              !walletFromUserStorage ||\n              !walletFromUserStorage.isLegacyAccountSyncingDisabled\n            ) {\n              // 2.2 Perform legacy account syncing\n              // This will migrate legacy account data to the new structure.\n              // This operation will only be performed once.\n              await performLegacyAccountSyncing(\n                this.#context,\n                entropySourceId,\n                walletProfileId,\n              );\n            }\n          } catch (error) {\n            const errorMessage = toErrorMessage(error);\n            const errorString = `Legacy syncing failed for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n            throw new Error(errorString);\n          }\n\n          // 3. Execute multichain account syncing\n          let stateSnapshot: StateSnapshot | undefined;\n\n          try {\n            // 3.1 Wallet syncing\n            // Create a state snapshot before processing each wallet for potential rollback\n            stateSnapshot = createStateSnapshot(this.#context);\n\n            // Sync wallet metadata bidirectionally\n            await syncWalletMetadata(\n              this.#context,\n              wallet,\n              walletFromUserStorage,\n              walletProfileId,\n            );\n\n            // 3.2 Groups syncing\n            // If groups data does not exist in user storage yet, create it\n            if (!groupsFromUserStorage.length) {\n              // If no groups exist in user storage, we can push all groups from the wallet to the user storage and exit\n              await pushGroupToUserStorageBatch(\n                this.#context,\n                getLocalGroupsForEntropyWallet(this.#context, wallet.id),\n                entropySourceId,\n              );\n\n              continue; // No need to proceed with metadata comparison if groups are new\n            }\n\n            // Create local groups for each group from user storage if they do not exist\n            // This will ensure that we have all groups available locally before syncing metadata\n            await createLocalGroupsFromUserStorage(\n              this.#context,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n\n            // Sync group metadata bidirectionally\n            await syncGroupsMetadata(\n              this.#context,\n              wallet,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n          } catch (error) {\n            const errorMessage = toErrorMessage(error);\n            const errorString = `Error during multichain account syncing for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n\n            // Attempt to rollback state changes for this wallet\n            try {\n              if (!stateSnapshot) {\n                throw new Error(\n                  `State snapshot is missing for wallet ${wallet.id}`,\n                );\n              }\n              restoreStateFromSnapshot(this.#context, stateSnapshot);\n              backupAndSyncLogger(\n                `Rolled back state changes for wallet ${wallet.id}`,\n              );\n            } catch (rollbackError) {\n              backupAndSyncLogger(\n                `Failed to rollback state for wallet ${wallet.id}:`,\n                rollbackError instanceof Error\n                  ? rollbackError.message\n                  : String(rollbackError),\n              );\n            }\n\n            // Continue with next wallet instead of failing the entire sync\n            continue;\n          }\n        }\n      } catch (error) {\n        backupAndSyncLogger('Error during multichain account syncing:', error);\n        throw error;\n      }\n\n      this.#context.controllerStateUpdateFn((state) => {\n        state.hasAccountTreeSyncingSyncedAtLeastOnce = true;\n      });\n    };\n\n    // Execute the big sync function with tracing and ensure state cleanup\n    try {\n      await this.#context.traceFn(\n        {\n          name: TraceName.AccountSyncFull,\n        },\n        bigSyncFn,\n      );\n    } finally {\n      // Always reset state, regardless of success or failure\n      this.#context.controllerStateUpdateFn(\n        (state: AccountTreeControllerState) => {\n          state.isAccountTreeSyncingInProgress = false;\n        },\n      );\n    }\n  }\n\n  /**\n   * Performs a single wallet's bidirectional metadata sync with user storage.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  async #performSingleWalletSyncInner(\n    walletId: AccountWalletId,\n  ): Promise<void> {\n    try {\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n      const walletFromUserStorage = await getWalletFromUserStorage(\n        this.#context,\n        entropySourceId,\n      );\n\n      await syncWalletMetadata(\n        this.#context,\n        wallet,\n        walletFromUserStorage,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(\n        `Error in single wallet sync for ${walletId}:`,\n        error,\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Performs a single group's bidirectional metadata sync with user storage.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  async #performSingleGroupSyncInner(groupId: AccountGroupId): Promise<void> {\n    try {\n      const walletId = this.#context.groupIdToWalletId.get(groupId);\n      if (!walletId) {\n        return;\n      }\n\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const group = wallet.groups[groupId];\n      if (!group) {\n        return;\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n\n      // Get the specific group from user storage\n      const groupFromUserStorage = await getGroupFromUserStorage(\n        this.#context,\n        entropySourceId,\n        group.metadata.entropy.groupIndex,\n      );\n\n      await syncGroupMetadata(\n        this.#context,\n        group,\n        groupFromUserStorage,\n        entropySourceId,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(`Error in single group sync for ${groupId}:`, error);\n      throw error;\n    }\n  }\n}\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/backup-and-sync/service/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AccountGroupId, AccountWalletId } from '@metamask/account-api';\nimport { AccountWalletType } from '@metamask/account-api';\nimport type { UserStorageController } from '@metamask/profile-sync-controller';\n\nimport { AtomicSyncQueue } from './atomic-sync-queue';\nimport { backupAndSyncLogger } from '../../logger';\nimport type { AccountTreeControllerState } from '../../types';\nimport type { AccountWalletEntropyObject } from '../../wallet';\nimport { TraceName } from '../analytics';\nimport type { ProfileId } from '../authentication';\nimport { getProfileId } from '../authentication';\nimport {\n  createLocalGroupsFromUserStorage,\n  performLegacyAccountSyncing,\n  syncGroupsMetadata,\n  syncGroupMetadata,\n  syncWalletMetadata,\n} from '../syncing';\nimport type {\n  BackupAndSyncContext,\n  UserStorageSyncedWallet,\n  UserStorageSyncedWalletGroup,\n} from '../types';\nimport {\n  getAllGroupsFromUserStorage,\n  getGroupFromUserStorage,\n  getWalletFromUserStorage,\n  pushGroupToUserStorageBatch,\n} from '../user-storage';\nimport {\n  createStateSnapshot,\n  restoreStateFromSnapshot,\n  getLocalEntropyWallets,\n  getLocalGroupsForEntropyWallet,\n} from '../utils';\nimport type { StateSnapshot } from '../utils';\n\n/**\n * Service responsible for managing all backup and sync operations.\n *\n * This service handles:\n * - Full sync operations\n * - Single item sync operations\n * - Sync queue management\n * - Sync state management\n */\nexport class BackupAndSyncService {\n  readonly #context: BackupAndSyncContext;\n\n  /**\n   * Queue manager for atomic sync operations.\n   */\n  readonly #atomicSyncQueue: AtomicSyncQueue;\n\n  /**\n   * Cached promise for ongoing full sync operations.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #ongoingFullSyncPromise: Promise<void> | null = null;\n\n  /**\n   * Cached promise for the first ongoing full sync operation.\n   * Ensures multiple callers await the same sync operation.\n   */\n  #firstOngoingFullSyncPromise: Promise<void> | null = null;\n\n  constructor(context: BackupAndSyncContext) {\n    this.#context = context;\n    this.#atomicSyncQueue = new AtomicSyncQueue();\n  }\n\n  /**\n   * Checks if syncing is currently in progress.\n   *\n   * @returns True if syncing is in progress.\n   */\n  get isInProgress(): boolean {\n    return this.#context.controller.state.isAccountTreeSyncingInProgress;\n  }\n\n  /**\n   * Checks if the account tree has been synced at least once.\n   *\n   * @returns True if the account tree has been synced at least once.\n   */\n  get hasSyncedAtLeastOnce(): boolean {\n    return this.#context.controller.state\n      .hasAccountTreeSyncingSyncedAtLeastOnce;\n  }\n\n  /**\n   * Checks if backup and sync is enabled by checking UserStorageController state.\n   *\n   * @returns True if backup and sync + account syncing is enabled.\n   */\n  get isBackupAndSyncEnabled(): boolean {\n    const userStorageControllerState = this.#context.messenger.call(\n      'UserStorageController:getState',\n    );\n    const { isAccountSyncingEnabled, isBackupAndSyncEnabled } =\n      userStorageControllerState;\n\n    return isBackupAndSyncEnabled && isAccountSyncingEnabled;\n  }\n\n  /**\n   * Clears the atomic queue and resets ongoing operations.\n   */\n  clearState(): void {\n    this.#atomicSyncQueue.clear();\n    this.#ongoingFullSyncPromise = null;\n    this.#firstOngoingFullSyncPromise = null;\n  }\n\n  /**\n   * Handles changes to the user storage state.\n   * Used to clear the backup and sync service state.\n   *\n   * @param state - The new user storage state.\n   */\n  handleUserStorageStateChange(\n    state: UserStorageController.UserStorageControllerState,\n  ): void {\n    if (!state.isAccountSyncingEnabled || !state.isBackupAndSyncEnabled) {\n      // If either syncing is disabled, clear the account tree state\n      this.clearState();\n    }\n  }\n\n  /**\n   * Gets the entropy wallet associated with the given wallet ID.\n   *\n   * @param walletId - The wallet ID to look up.\n   * @returns The associated entropy wallet, or undefined if not found.\n   */\n  #getEntropyWallet(\n    walletId: AccountWalletId,\n  ): AccountWalletEntropyObject | undefined {\n    const wallet = this.#context.controller.state.accountTree.wallets[walletId];\n    return wallet?.type === AccountWalletType.Entropy ? wallet : undefined;\n  }\n\n  /**\n   * Sets up cleanup for ongoing sync promise tracking without affecting error propagation.\n   *\n   * @param promise - The promise to track and clean up\n   * @returns The same promise (for chaining)\n   */\n  #setupOngoingPromiseCleanup(promise: Promise<void>): Promise<void> {\n    this.#ongoingFullSyncPromise = promise;\n    // Set up cleanup without affecting the returned promise\n    promise\n      .finally(() => {\n        this.#ongoingFullSyncPromise = null;\n      })\n      .catch(() => {\n        // Only ignore errors from the cleanup operation itself\n        // The original promise errors are still propagated to callers\n      });\n    return promise;\n  }\n\n  /**\n   * Enqueues a single wallet sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  enqueueSingleWalletSync(walletId: AccountWalletId): void {\n    if (!this.isBackupAndSyncEnabled || !this.hasSyncedAtLeastOnce) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleWalletSyncInner(walletId),\n    );\n  }\n\n  /**\n   * Enqueues a single group sync operation (fire-and-forget).\n   * If the first full sync has not yet occurred, it does nothing.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  enqueueSingleGroupSync(groupId: AccountGroupId): void {\n    if (\n      !this.isBackupAndSyncEnabled ||\n      !this.hasSyncedAtLeastOnce ||\n      // This prevents rate limiting scenarios where full syncs trigger group creations\n      // that in turn enqueue the same single group syncs that the full sync just did.\n      // This can very rarely lead to inconsistencies, but will be fixed on the next full sync.\n      // TODO: let's improve this in the future by tracking the updates done in the full sync and\n      // comparing against that.\n      this.isInProgress\n    ) {\n      return;\n    }\n\n    // eslint-disable-next-line no-void\n    void this.#atomicSyncQueue.enqueue(() =>\n      this.#performSingleGroupSyncInner(groupId),\n    );\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   * If a full sync is already in progress, it will return the ongoing promise.\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * NOTE: in some very edge cases, this can be ran concurrently if triggered quickly after\n   * toggling back and forth the backup and sync feature from the UI.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSync(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    // If there's an ongoing sync (including first sync), return it\n    if (this.#ongoingFullSyncPromise) {\n      return this.#ongoingFullSyncPromise;\n    }\n\n    // Create a new ongoing sync (sequential calls after previous completed)\n    const newSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(() =>\n      this.#performFullSyncInner(),\n    );\n\n    // First sync setup - create and cache the first sync promise\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = newSyncPromise;\n    }\n\n    return this.#setupOngoingPromiseCleanup(newSyncPromise);\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * If the first ever full sync is already in progress, it will return the ongoing promise.\n   * If the first ever full sync has already completed, it will resolve and NOT start a new sync.\n   *\n   * This clears the atomic sync queue before starting the full sync.\n   *\n   * @returns A promise that resolves when the sync is complete.\n   */\n  async performFullSyncAtLeastOnce(): Promise<void> {\n    if (!this.isBackupAndSyncEnabled) {\n      return undefined;\n    }\n\n    if (!this.#firstOngoingFullSyncPromise) {\n      this.#firstOngoingFullSyncPromise = this.#atomicSyncQueue.clearAndEnqueue(\n        () => this.#performFullSyncInner(),\n      );\n      // eslint-disable-next-line no-void\n      void this.#setupOngoingPromiseCleanup(this.#firstOngoingFullSyncPromise);\n    }\n\n    return this.#firstOngoingFullSyncPromise;\n  }\n\n  /**\n   * Performs a full synchronization of the local account tree with user storage, ensuring consistency\n   * between local state and cloud-stored account data.\n   *\n   * This method performs a comprehensive sync operation that:\n   * 1. Identifies all local entropy wallets that can be synchronized\n   * 2. Performs legacy account syncing if needed (for backwards compatibility)\n   * - Disables subsequent legacy syncing by setting a flag in user storage\n   * - Exits early if multichain account syncing is disabled after legacy sync\n   * 3. Executes multichain account syncing for each wallet:\n   * - Syncs wallet metadata bidirectionally\n   * - Creates missing local groups from user storage data (or pushes local groups if none exist remotely)\n   * - Refreshes local state to reflect newly created groups\n   * - Syncs group metadata bidirectionally\n   *\n   * The sync is atomic per wallet with rollback on errors, but continues processing other wallets\n   * if individual wallet sync fails. A global lock prevents concurrent sync operations.\n   *\n   * During this process, all other atomic multichain related user storage updates are blocked.\n   *\n   * @throws Will throw if the sync operation encounters unrecoverable errors\n   */\n  async #performFullSyncInner(): Promise<void> {\n    // Prevent multiple syncs from running at the same time.\n    // Also prevents atomic updates from being applied while syncing is in progress.\n    if (this.isInProgress) {\n      return;\n    }\n\n    // Set isAccountTreeSyncingInProgress immediately to prevent race conditions\n    this.#context.controllerStateUpdateFn(\n      (state: AccountTreeControllerState) => {\n        state.isAccountTreeSyncingInProgress = true;\n      },\n    );\n\n    // Encapsulate the sync logic in a function to allow tracing\n    const bigSyncFn = async () => {\n      try {\n        // 1. Identifies all local entropy wallets that can be synchronized\n        const localSyncableWallets = getLocalEntropyWallets(this.#context);\n\n        if (!localSyncableWallets.length) {\n          // No wallets to sync, just return. This shouldn't happen.\n          return;\n        }\n\n        // 2. Iterate over each local wallet\n        for (const wallet of localSyncableWallets) {\n          const entropySourceId = wallet.metadata.entropy.id;\n\n          let walletProfileId: ProfileId;\n          let walletFromUserStorage: UserStorageSyncedWallet | null;\n          let groupsFromUserStorage: UserStorageSyncedWalletGroup[];\n\n          try {\n            walletProfileId = await getProfileId(\n              this.#context,\n              entropySourceId,\n            );\n\n            [walletFromUserStorage, groupsFromUserStorage] = await Promise.all([\n              getWalletFromUserStorage(this.#context, entropySourceId),\n              getAllGroupsFromUserStorage(this.#context, entropySourceId),\n            ]);\n\n            // 2.1 Decide if we need to perform legacy account syncing\n            if (\n              !walletFromUserStorage ||\n              !walletFromUserStorage.isLegacyAccountSyncingDisabled\n            ) {\n              // 2.2 Perform legacy account syncing\n              // This will migrate legacy account data to the new structure.\n              // This operation will only be performed once.\n              await performLegacyAccountSyncing(\n                this.#context,\n                entropySourceId,\n                walletProfileId,\n              );\n            }\n          } catch (error) {\n            const errorMessage =\n              error instanceof Error ? error.message : String(error);\n            const errorString = `Legacy syncing failed for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n            throw new Error(errorString);\n          }\n\n          // 3. Execute multichain account syncing\n          let stateSnapshot: StateSnapshot | undefined;\n\n          try {\n            // 3.1 Wallet syncing\n            // Create a state snapshot before processing each wallet for potential rollback\n            stateSnapshot = createStateSnapshot(this.#context);\n\n            // Sync wallet metadata bidirectionally\n            await syncWalletMetadata(\n              this.#context,\n              wallet,\n              walletFromUserStorage,\n              walletProfileId,\n            );\n\n            // 3.2 Groups syncing\n            // If groups data does not exist in user storage yet, create it\n            if (!groupsFromUserStorage.length) {\n              // If no groups exist in user storage, we can push all groups from the wallet to the user storage and exit\n              await pushGroupToUserStorageBatch(\n                this.#context,\n                getLocalGroupsForEntropyWallet(this.#context, wallet.id),\n                entropySourceId,\n              );\n\n              continue; // No need to proceed with metadata comparison if groups are new\n            }\n\n            // Create local groups for each group from user storage if they do not exist\n            // This will ensure that we have all groups available locally before syncing metadata\n            await createLocalGroupsFromUserStorage(\n              this.#context,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n\n            // Sync group metadata bidirectionally\n            await syncGroupsMetadata(\n              this.#context,\n              wallet,\n              groupsFromUserStorage,\n              entropySourceId,\n              walletProfileId,\n            );\n          } catch (error) {\n            const errorMessage =\n              error instanceof Error ? error.message : String(error);\n            const errorString = `Error during multichain account syncing for wallet ${wallet.id}: ${errorMessage}`;\n\n            backupAndSyncLogger(errorString);\n\n            // Attempt to rollback state changes for this wallet\n            try {\n              if (!stateSnapshot) {\n                throw new Error(\n                  `State snapshot is missing for wallet ${wallet.id}`,\n                );\n              }\n              restoreStateFromSnapshot(this.#context, stateSnapshot);\n              backupAndSyncLogger(\n                `Rolled back state changes for wallet ${wallet.id}`,\n              );\n            } catch (rollbackError) {\n              backupAndSyncLogger(\n                `Failed to rollback state for wallet ${wallet.id}:`,\n                rollbackError instanceof Error\n                  ? rollbackError.message\n                  : String(rollbackError),\n              );\n            }\n\n            // Continue with next wallet instead of failing the entire sync\n            continue;\n          }\n        }\n      } catch (error) {\n        backupAndSyncLogger('Error during multichain account syncing:', error);\n        throw error;\n      }\n\n      this.#context.controllerStateUpdateFn((state) => {\n        state.hasAccountTreeSyncingSyncedAtLeastOnce = true;\n      });\n    };\n\n    // Execute the big sync function with tracing and ensure state cleanup\n    try {\n      await this.#context.traceFn(\n        {\n          name: TraceName.AccountSyncFull,\n        },\n        bigSyncFn,\n      );\n    } finally {\n      // Always reset state, regardless of success or failure\n      this.#context.controllerStateUpdateFn(\n        (state: AccountTreeControllerState) => {\n          state.isAccountTreeSyncingInProgress = false;\n        },\n      );\n    }\n  }\n\n  /**\n   * Performs a single wallet's bidirectional metadata sync with user storage.\n   *\n   * @param walletId - The wallet ID to sync.\n   */\n  async #performSingleWalletSyncInner(\n    walletId: AccountWalletId,\n  ): Promise<void> {\n    try {\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n      const walletFromUserStorage = await getWalletFromUserStorage(\n        this.#context,\n        entropySourceId,\n      );\n\n      await syncWalletMetadata(\n        this.#context,\n        wallet,\n        walletFromUserStorage,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(\n        `Error in single wallet sync for ${walletId}:`,\n        error,\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Performs a single group's bidirectional metadata sync with user storage.\n   *\n   * @param groupId - The group ID to sync.\n   */\n  async #performSingleGroupSyncInner(groupId: AccountGroupId): Promise<void> {\n    try {\n      const walletId = this.#context.groupIdToWalletId.get(groupId);\n      if (!walletId) {\n        return;\n      }\n\n      const wallet = this.#getEntropyWallet(walletId);\n      if (!wallet) {\n        return; // Only sync entropy wallets\n      }\n\n      const group = wallet.groups[groupId];\n      if (!group) {\n        return;\n      }\n\n      const entropySourceId = wallet.metadata.entropy.id;\n      const walletProfileId = await getProfileId(\n        this.#context,\n        entropySourceId,\n      );\n\n      // Get the specific group from user storage\n      const groupFromUserStorage = await getGroupFromUserStorage(\n        this.#context,\n        entropySourceId,\n        group.metadata.entropy.groupIndex,\n      );\n\n      await syncGroupMetadata(\n        this.#context,\n        group,\n        groupFromUserStorage,\n        entropySourceId,\n        walletProfileId,\n      );\n    } catch (error) {\n      backupAndSyncLogger(`Error in single group sync for ${groupId}:`, error);\n      throw error;\n    }\n  }\n}\n"]}

package/dist/backup-and-sync/syncing/group.cjs

@@ -8,7 +8,6 @@ const analytics_1 = require("../analytics/index.cjs");
 const types_1 = require("../types.cjs");
 const network_operations_1 = require("../user-storage/network-operations.cjs");
 const utils_1 = require("../utils/index.cjs");
-const errors_1 = require("../utils/errors.cjs");
 /**
  * Creates multiple multichain account groups in batch (from 0 to maxGroupIndex).
  * This is an optimized version that creates all groups in one operation instead of
@@ -60,7 +59,7 @@ const createMultichainAccountGroupsBatch = async (context, entropySourceId, maxG
         // Any missing Snap accounts will be added later with alignment.
         (0, logger_1.backupAndSyncLogger)(`Failed to create account groups batch:`, 
         // istanbul ignore next
-        (0, errors_1.toErrorMessage)(error));
+        error instanceof Error ? error.message : String(error));
     }
 };
 exports.createMultichainAccountGroupsBatch = createMultichainAccountGroupsBatch;

package/dist/backup-and-sync/syncing/group.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"group.cjs","sourceRoot":"","sources":["../../../src/backup-and-sync/syncing/group.ts"],"names":[],"mappings":"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","sourcesContent":["import { toMultichainAccountWalletId } from '@metamask/account-api';\n\nimport { compareAndSyncMetadata } from './metadata';\nimport type { AccountGroupMultichainAccountObject } from '../../group';\nimport { backupAndSyncLogger } from '../../logger';\nimport type { AccountWalletEntropyObject } from '../../wallet';\nimport type { BackupAndSyncAnalyticsAction } from '../analytics';\nimport { BackupAndSyncAnalyticsEvent } from '../analytics';\nimport type { ProfileId } from '../authentication';\nimport { UserStorageSyncedWalletGroupSchema } from '../types';\nimport type {\n  BackupAndSyncContext,\n  UserStorageSyncedWalletGroup,\n} from '../types';\nimport {\n  pushGroupToUserStorage,\n  pushGroupToUserStorageBatch,\n} from '../user-storage/network-operations';\nimport { getLocalGroupsForEntropyWallet } from '../utils';\nimport { toErrorMessage } from '../utils/errors';\n\n/**\n * Creates multiple multichain account groups in batch (from 0 to maxGroupIndex).\n * This is an optimized version that creates all groups in one operation instead of\n * creating them sequentially.\n *\n * @param context - The sync context containing controller and messenger.\n * @param entropySourceId - The entropy source ID.\n * @param maxGroupIndex - Number of account groups to create in batch.\n * @param profileId - The profile ID for analytics.\n * @param analyticsAction - The analytics action to log for each created group.\n * @returns Array of created group IDs.\n */\nexport const createMultichainAccountGroupsBatch = async (\n  context: BackupAndSyncContext,\n  entropySourceId: string,\n  maxGroupIndex: number,\n  profileId: ProfileId,\n  analyticsAction: BackupAndSyncAnalyticsAction,\n): Promise<void> => {\n  const numberOfAccountGroupsToCreate = maxGroupIndex + 1; // maxGroupIndex is zero-based, so we add 1 to get the count.\n  backupAndSyncLogger(\n    `Creating ${numberOfAccountGroupsToCreate} account groups (batch) for entropy source: ${entropySourceId}`,\n  );\n\n  // Capture the set of group indices that already exist before the batch call,\n  // so we can correctly identify newly created groups after the call completes.\n  const walletId = toMultichainAccountWalletId(entropySourceId);\n  const existingGroupIndices = new Set(\n    getLocalGroupsForEntropyWallet(context, walletId).map(\n      (group) => group.metadata.entropy.groupIndex,\n    ),\n  );\n\n  try {\n    // Call the batched creation method (this is idempotent).\n    const groups = await context.messenger.call(\n      'MultichainAccountService:createMultichainAccountGroups',\n      {\n        entropySource: entropySourceId,\n        fromGroupIndex: 0,\n        toGroupIndex: maxGroupIndex,\n      },\n    );\n\n    // Contains all groups (existing + newly created).\n    for (const group of groups) {\n      // TODO: A group should not be null here, but EVM provider might fail to create some groups sometimes, which means\n      // we can end up having an \"empty group\" for some time.\n      if (group) {\n        const didGroupAlreadyExist = existingGroupIndices.has(group.groupIndex);\n\n        if (!didGroupAlreadyExist) {\n          context.emitAnalyticsEventFn({\n            action: analyticsAction,\n            profileId,\n          });\n        }\n      }\n    }\n\n    backupAndSyncLogger(`Successfully created ${groups.length} groups (batch)`);\n  } catch (error) {\n    // This can happen if the Snap Keyring is not ready yet when invoking\n    // `MultichainAccountService:createMultichainAccountGroups`.\n    // Since `MultichainAccountService:createMultichainAccountGroups` will at\n    // least create the EVM account and the account group before throwing, we can safely\n    // ignore this error and swallow it.\n    // Any missing Snap accounts will be added later with alignment.\n\n    backupAndSyncLogger(\n      `Failed to create account groups batch:`,\n      // istanbul ignore next\n      toErrorMessage(error),\n    );\n  }\n};\n\n/**\n * Creates local groups from user storage groups.\n *\n * @param context - The sync context containing controller and messenger.\n * @param groupsFromUserStorage - Array of groups from user storage.\n * @param entropySourceId - The entropy source ID.\n * @param profileId - The profile ID for analytics.\n */\nexport async function createLocalGroupsFromUserStorage(\n  context: BackupAndSyncContext,\n  groupsFromUserStorage: UserStorageSyncedWalletGroup[],\n  entropySourceId: string,\n  profileId: ProfileId,\n): Promise<void> {\n  const maxGroupIndex = Math.max(\n    ...groupsFromUserStorage.map((group) => group.groupIndex),\n  );\n\n  // Creating multichain account group is idempotent, so we can safely\n  // re-create every groups starting from 0.\n  // Use batch creation for better performance.\n  await createMultichainAccountGroupsBatch(\n    context,\n    entropySourceId,\n    maxGroupIndex,\n    profileId,\n    BackupAndSyncAnalyticsEvent.GroupAdded,\n  );\n}\n\n/**\n * Syncs group metadata fields and determines if the group needs to be pushed to user storage.\n *\n * @param context - The sync context containing controller and messenger.\n * @param localGroup - The local group to sync.\n * @param groupFromUserStorage - The group from user storage to compare against.\n * @param profileId - The profile ID for analytics.\n * @returns A promise that resolves to true if the group needs to be pushed to user storage.\n */\nasync function syncGroupMetadataAndCheckIfPushNeeded(\n  context: BackupAndSyncContext,\n  localGroup: AccountGroupMultichainAccountObject,\n  groupFromUserStorage: UserStorageSyncedWalletGroup | null | undefined,\n  profileId: ProfileId,\n): Promise<boolean> {\n  const groupPersistedMetadata =\n    context.controller.state.accountGroupsMetadata[localGroup.id];\n\n  if (!groupFromUserStorage) {\n    backupAndSyncLogger(\n      `Group ${localGroup.id} did not exist in user storage, pushing to user storage...`,\n    );\n\n    return true;\n  }\n\n  // Track if we need to push this group to user storage\n  let shouldPushGroup = false;\n\n  // Compare and sync name metadata\n  const shouldPushForName = await compareAndSyncMetadata({\n    context,\n    localMetadata: groupPersistedMetadata?.name,\n    userStorageMetadata: groupFromUserStorage.name,\n    validateUserStorageValue: (value) =>\n      UserStorageSyncedWalletGroupSchema.schema.name.schema.value.is(value),\n    applyLocalUpdate: (name: string) => {\n      context.controller.setAccountGroupName(localGroup.id, name, true);\n    },\n    analytics: {\n      action: BackupAndSyncAnalyticsEvent.GroupRenamed,\n      profileId,\n    },\n  });\n\n  shouldPushGroup ||= shouldPushForName;\n\n  // Compare and sync pinned metadata\n  const shouldPushForPinned = await compareAndSyncMetadata({\n    context,\n    localMetadata: groupPersistedMetadata?.pinned,\n    userStorageMetadata: groupFromUserStorage.pinned,\n    validateUserStorageValue: (value) =>\n      UserStorageSyncedWalletGroupSchema.schema.pinned.schema.value.is(value),\n    applyLocalUpdate: (pinned: boolean) => {\n      context.controller.setAccountGroupPinned(localGroup.id, pinned);\n    },\n    analytics: {\n      action: BackupAndSyncAnalyticsEvent.GroupPinnedStatusChanged,\n      profileId,\n    },\n  });\n\n  shouldPushGroup ||= shouldPushForPinned;\n\n  // Compare and sync hidden metadata\n  const shouldPushForHidden = await compareAndSyncMetadata({\n    context,\n    localMetadata: groupPersistedMetadata?.hidden,\n    userStorageMetadata: groupFromUserStorage.hidden,\n    validateUserStorageValue: (value) =>\n      UserStorageSyncedWalletGroupSchema.schema.hidden.schema.value.is(value),\n    applyLocalUpdate: (hidden: boolean) => {\n      context.controller.setAccountGroupHidden(localGroup.id, hidden);\n    },\n    analytics: {\n      action: BackupAndSyncAnalyticsEvent.GroupHiddenStatusChanged,\n      profileId,\n    },\n  });\n\n  shouldPushGroup ||= shouldPushForHidden;\n\n  return shouldPushGroup;\n}\n\n/**\n * Syncs a single group's metadata between local and user storage.\n *\n * @param context - The sync context containing controller and messenger.\n * @param localGroup - The local group to sync.\n * @param groupFromUserStorage - The group from user storage to compare against (or null if it doesn't exist).\n * @param entropySourceId - The entropy source ID.\n * @param profileId - The profile ID for analytics.\n */\nexport async function syncGroupMetadata(\n  context: BackupAndSyncContext,\n  localGroup: AccountGroupMultichainAccountObject,\n  groupFromUserStorage: UserStorageSyncedWalletGroup | null,\n  entropySourceId: string,\n  profileId: ProfileId,\n): Promise<void> {\n  const shouldPushGroup = await syncGroupMetadataAndCheckIfPushNeeded(\n    context,\n    localGroup,\n    groupFromUserStorage,\n    profileId,\n  );\n\n  if (shouldPushGroup) {\n    await pushGroupToUserStorage(context, localGroup, entropySourceId);\n  }\n}\n\n/**\n * Syncs group metadata between local and user storage.\n *\n * @param context - The sync context containing controller and messenger.\n * @param wallet - The local wallet containing the groups.\n * @param groupsFromUserStorage - Array of groups from user storage.\n * @param entropySourceId - The entropy source ID.\n * @param profileId - The profile ID for analytics.\n */\nexport async function syncGroupsMetadata(\n  context: BackupAndSyncContext,\n  wallet: AccountWalletEntropyObject,\n  groupsFromUserStorage: UserStorageSyncedWalletGroup[],\n  entropySourceId: string,\n  profileId: ProfileId,\n): Promise<void> {\n  const localSyncableGroupsToBePushedToUserStorage: AccountGroupMultichainAccountObject[] =\n    [];\n\n  const localSyncableGroups = getLocalGroupsForEntropyWallet(\n    context,\n    wallet.id,\n  );\n\n  for (const localSyncableGroup of localSyncableGroups) {\n    const groupFromUserStorage = groupsFromUserStorage.find(\n      (group) =>\n        group.groupIndex === localSyncableGroup.metadata.entropy.groupIndex,\n    );\n\n    const shouldPushGroup = await syncGroupMetadataAndCheckIfPushNeeded(\n      context,\n      localSyncableGroup,\n      groupFromUserStorage,\n      profileId,\n    );\n\n    // Add to push list if any metadata needs to be updated in user storage\n    if (shouldPushGroup) {\n      localSyncableGroupsToBePushedToUserStorage.push(localSyncableGroup);\n    }\n  }\n\n  // Push all groups that need to be updated to user storage\n  if (localSyncableGroupsToBePushedToUserStorage.length > 0) {\n    await pushGroupToUserStorageBatch(\n      context,\n      localSyncableGroupsToBePushedToUserStorage,\n      entropySourceId,\n    );\n  }\n}\n"]}
+{"version":3,"file":"group.cjs","sourceRoot":"","sources":["../../../src/backup-and-sync/syncing/group.ts"],"names":[],"mappings":"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","sourcesContent":["import { toMultichainAccountWalletId } from '@metamask/account-api';\n\nimport { compareAndSyncMetadata } from './metadata';\nimport type { AccountGroupMultichainAccountObject } from '../../group';\nimport { backupAndSyncLogger } from '../../logger';\nimport type { AccountWalletEntropyObject } from '../../wallet';\nimport type { BackupAndSyncAnalyticsAction } from '../analytics';\nimport { BackupAndSyncAnalyticsEvent } from '../analytics';\nimport type { ProfileId } from '../authentication';\nimport { UserStorageSyncedWalletGroupSchema } from '../types';\nimport type {\n  BackupAndSyncContext,\n  UserStorageSyncedWalletGroup,\n} from '../types';\nimport {\n  pushGroupToUserStorage,\n  pushGroupToUserStorageBatch,\n} from '../user-storage/network-operations';\nimport { getLocalGroupsForEntropyWallet } from '../utils';\n\n/**\n * Creates multiple multichain account groups in batch (from 0 to maxGroupIndex).\n * This is an optimized version that creates all groups in one operation instead of\n * creating them sequentially.\n *\n * @param context - The sync context containing controller and messenger.\n * @param entropySourceId - The entropy source ID.\n * @param maxGroupIndex - Number of account groups to create in batch.\n * @param profileId - The profile ID for analytics.\n * @param analyticsAction - The analytics action to log for each created group.\n * @returns Array of created group IDs.\n */\nexport const createMultichainAccountGroupsBatch = async (\n  context: BackupAndSyncContext,\n  entropySourceId: string,\n  maxGroupIndex: number,\n  profileId: ProfileId,\n  analyticsAction: BackupAndSyncAnalyticsAction,\n): Promise<void> => {\n  const numberOfAccountGroupsToCreate = maxGroupIndex + 1; // maxGroupIndex is zero-based, so we add 1 to get the count.\n  backupAndSyncLogger(\n    `Creating ${numberOfAccountGroupsToCreate} account groups (batch) for entropy source: ${entropySourceId}`,\n  );\n\n  // Capture the set of group indices that already exist before the batch call,\n  // so we can correctly identify newly created groups after the call completes.\n  const walletId = toMultichainAccountWalletId(entropySourceId);\n  const existingGroupIndices = new Set(\n    getLocalGroupsForEntropyWallet(context, walletId).map(\n      (group) => group.metadata.entropy.groupIndex,\n    ),\n  );\n\n  try {\n    // Call the batched creation method (this is idempotent).\n    const groups = await context.messenger.call(\n      'MultichainAccountService:createMultichainAccountGroups',\n      {\n        entropySource: entropySourceId,\n        fromGroupIndex: 0,\n        toGroupIndex: maxGroupIndex,\n      },\n    );\n\n    // Contains all groups (existing + newly created).\n    for (const group of groups) {\n      // TODO: A group should not be null here, but EVM provider might fail to create some groups sometimes, which means\n      // we can end up having an \"empty group\" for some time.\n      if (group) {\n        const didGroupAlreadyExist = existingGroupIndices.has(group.groupIndex);\n\n        if (!didGroupAlreadyExist) {\n          context.emitAnalyticsEventFn({\n            action: analyticsAction,\n            profileId,\n          });\n        }\n      }\n    }\n\n    backupAndSyncLogger(`Successfully created ${groups.length} groups (batch)`);\n  } catch (error) {\n    // This can happen if the Snap Keyring is not ready yet when invoking\n    // `MultichainAccountService:createMultichainAccountGroups`.\n    // Since `MultichainAccountService:createMultichainAccountGroups` will at\n    // least create the EVM account and the account group before throwing, we can safely\n    // ignore this error and swallow it.\n    // Any missing Snap accounts will be added later with alignment.\n\n    backupAndSyncLogger(\n      `Failed to create account groups batch:`,\n      // istanbul ignore next\n      error instanceof Error ? error.message : String(error),\n    );\n  }\n};\n\n/**\n * Creates local groups from user storage groups.\n *\n * @param context - The sync context containing controller and messenger.\n * @param groupsFromUserStorage - Array of groups from user storage.\n * @param entropySourceId - The entropy source ID.\n * @param profileId - The profile ID for analytics.\n */\nexport async function createLocalGroupsFromUserStorage(\n  context: BackupAndSyncContext,\n  groupsFromUserStorage: UserStorageSyncedWalletGroup[],\n  entropySourceId: string,\n  profileId: ProfileId,\n): Promise<void> {\n  const maxGroupIndex = Math.max(\n    ...groupsFromUserStorage.map((group) => group.groupIndex),\n  );\n\n  // Creating multichain account group is idempotent, so we can safely\n  // re-create every groups starting from 0.\n  // Use batch creation for better performance.\n  await createMultichainAccountGroupsBatch(\n    context,\n    entropySourceId,\n    maxGroupIndex,\n    profileId,\n    BackupAndSyncAnalyticsEvent.GroupAdded,\n  );\n}\n\n/**\n * Syncs group metadata fields and determines if the group needs to be pushed to user storage.\n *\n * @param context - The sync context containing controller and messenger.\n * @param localGroup - The local group to sync.\n * @param groupFromUserStorage - The group from user storage to compare against.\n * @param profileId - The profile ID for analytics.\n * @returns A promise that resolves to true if the group needs to be pushed to user storage.\n */\nasync function syncGroupMetadataAndCheckIfPushNeeded(\n  context: BackupAndSyncContext,\n  localGroup: AccountGroupMultichainAccountObject,\n  groupFromUserStorage: UserStorageSyncedWalletGroup | null | undefined,\n  profileId: ProfileId,\n): Promise<boolean> {\n  const groupPersistedMetadata =\n    context.controller.state.accountGroupsMetadata[localGroup.id];\n\n  if (!groupFromUserStorage) {\n    backupAndSyncLogger(\n      `Group ${localGroup.id} did not exist in user storage, pushing to user storage...`,\n    );\n\n    return true;\n  }\n\n  // Track if we need to push this group to user storage\n  let shouldPushGroup = false;\n\n  // Compare and sync name metadata\n  const shouldPushForName = await compareAndSyncMetadata({\n    context,\n    localMetadata: groupPersistedMetadata?.name,\n    userStorageMetadata: groupFromUserStorage.name,\n    validateUserStorageValue: (value) =>\n      UserStorageSyncedWalletGroupSchema.schema.name.schema.value.is(value),\n    applyLocalUpdate: (name: string) => {\n      context.controller.setAccountGroupName(localGroup.id, name, true);\n    },\n    analytics: {\n      action: BackupAndSyncAnalyticsEvent.GroupRenamed,\n      profileId,\n    },\n  });\n\n  shouldPushGroup ||= shouldPushForName;\n\n  // Compare and sync pinned metadata\n  const shouldPushForPinned = await compareAndSyncMetadata({\n    context,\n    localMetadata: groupPersistedMetadata?.pinned,\n    userStorageMetadata: groupFromUserStorage.pinned,\n    validateUserStorageValue: (value) =>\n      UserStorageSyncedWalletGroupSchema.schema.pinned.schema.value.is(value),\n    applyLocalUpdate: (pinned: boolean) => {\n      context.controller.setAccountGroupPinned(localGroup.id, pinned);\n    },\n    analytics: {\n      action: BackupAndSyncAnalyticsEvent.GroupPinnedStatusChanged,\n      profileId,\n    },\n  });\n\n  shouldPushGroup ||= shouldPushForPinned;\n\n  // Compare and sync hidden metadata\n  const shouldPushForHidden = await compareAndSyncMetadata({\n    context,\n    localMetadata: groupPersistedMetadata?.hidden,\n    userStorageMetadata: groupFromUserStorage.hidden,\n    validateUserStorageValue: (value) =>\n      UserStorageSyncedWalletGroupSchema.schema.hidden.schema.value.is(value),\n    applyLocalUpdate: (hidden: boolean) => {\n      context.controller.setAccountGroupHidden(localGroup.id, hidden);\n    },\n    analytics: {\n      action: BackupAndSyncAnalyticsEvent.GroupHiddenStatusChanged,\n      profileId,\n    },\n  });\n\n  shouldPushGroup ||= shouldPushForHidden;\n\n  return shouldPushGroup;\n}\n\n/**\n * Syncs a single group's metadata between local and user storage.\n *\n * @param context - The sync context containing controller and messenger.\n * @param localGroup - The local group to sync.\n * @param groupFromUserStorage - The group from user storage to compare against (or null if it doesn't exist).\n * @param entropySourceId - The entropy source ID.\n * @param profileId - The profile ID for analytics.\n */\nexport async function syncGroupMetadata(\n  context: BackupAndSyncContext,\n  localGroup: AccountGroupMultichainAccountObject,\n  groupFromUserStorage: UserStorageSyncedWalletGroup | null,\n  entropySourceId: string,\n  profileId: ProfileId,\n): Promise<void> {\n  const shouldPushGroup = await syncGroupMetadataAndCheckIfPushNeeded(\n    context,\n    localGroup,\n    groupFromUserStorage,\n    profileId,\n  );\n\n  if (shouldPushGroup) {\n    await pushGroupToUserStorage(context, localGroup, entropySourceId);\n  }\n}\n\n/**\n * Syncs group metadata between local and user storage.\n *\n * @param context - The sync context containing controller and messenger.\n * @param wallet - The local wallet containing the groups.\n * @param groupsFromUserStorage - Array of groups from user storage.\n * @param entropySourceId - The entropy source ID.\n * @param profileId - The profile ID for analytics.\n */\nexport async function syncGroupsMetadata(\n  context: BackupAndSyncContext,\n  wallet: AccountWalletEntropyObject,\n  groupsFromUserStorage: UserStorageSyncedWalletGroup[],\n  entropySourceId: string,\n  profileId: ProfileId,\n): Promise<void> {\n  const localSyncableGroupsToBePushedToUserStorage: AccountGroupMultichainAccountObject[] =\n    [];\n\n  const localSyncableGroups = getLocalGroupsForEntropyWallet(\n    context,\n    wallet.id,\n  );\n\n  for (const localSyncableGroup of localSyncableGroups) {\n    const groupFromUserStorage = groupsFromUserStorage.find(\n      (group) =>\n        group.groupIndex === localSyncableGroup.metadata.entropy.groupIndex,\n    );\n\n    const shouldPushGroup = await syncGroupMetadataAndCheckIfPushNeeded(\n      context,\n      localSyncableGroup,\n      groupFromUserStorage,\n      profileId,\n    );\n\n    // Add to push list if any metadata needs to be updated in user storage\n    if (shouldPushGroup) {\n      localSyncableGroupsToBePushedToUserStorage.push(localSyncableGroup);\n    }\n  }\n\n  // Push all groups that need to be updated to user storage\n  if (localSyncableGroupsToBePushedToUserStorage.length > 0) {\n    await pushGroupToUserStorageBatch(\n      context,\n      localSyncableGroupsToBePushedToUserStorage,\n      entropySourceId,\n    );\n  }\n}\n"]}

package/dist/backup-and-sync/syncing/group.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.cts","sourceRoot":"","sources":["../../../src/backup-and-sync/syncing/group.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAE,wBAAoB;AAEvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAqB;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,+BAAqB;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,oCAA0B;AAEnD,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAC7B,qBAAiB;AAQlB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,YACpC,oBAAoB,mBACZ,MAAM,iBACR,MAAM,aACV,SAAS,mBACH,4BAA4B,KAC5C,QAAQ,IAAI,CAyDd,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAef;AAwFD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,mCAAmC,EAC/C,oBAAoB,EAAE,4BAA4B,GAAG,IAAI,EACzD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,0BAA0B,EAClC,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAoCf"}
+{"version":3,"file":"group.d.cts","sourceRoot":"","sources":["../../../src/backup-and-sync/syncing/group.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAE,wBAAoB;AAEvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAqB;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,+BAAqB;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,oCAA0B;AAEnD,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAC7B,qBAAiB;AAOlB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,YACpC,oBAAoB,mBACZ,MAAM,iBACR,MAAM,aACV,SAAS,mBACH,4BAA4B,KAC5C,QAAQ,IAAI,CAyDd,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAef;AAwFD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,mCAAmC,EAC/C,oBAAoB,EAAE,4BAA4B,GAAG,IAAI,EACzD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,0BAA0B,EAClC,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/backup-and-sync/syncing/group.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.mts","sourceRoot":"","sources":["../../../src/backup-and-sync/syncing/group.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAE,wBAAoB;AAEvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAqB;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,+BAAqB;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,oCAA0B;AAEnD,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAC7B,qBAAiB;AAQlB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,YACpC,oBAAoB,mBACZ,MAAM,iBACR,MAAM,aACV,SAAS,mBACH,4BAA4B,KAC5C,QAAQ,IAAI,CAyDd,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAef;AAwFD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,mCAAmC,EAC/C,oBAAoB,EAAE,4BAA4B,GAAG,IAAI,EACzD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,0BAA0B,EAClC,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAoCf"}
+{"version":3,"file":"group.d.mts","sourceRoot":"","sources":["../../../src/backup-and-sync/syncing/group.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAE,wBAAoB;AAEvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAqB;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,+BAAqB;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,oCAA0B;AAEnD,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAC7B,qBAAiB;AAOlB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,YACpC,oBAAoB,mBACZ,MAAM,iBACR,MAAM,aACV,SAAS,mBACH,4BAA4B,KAC5C,QAAQ,IAAI,CAyDd,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,oBAAoB,EAC7B,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAef;AAwFD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,mCAAmC,EAC/C,oBAAoB,EAAE,4BAA4B,GAAG,IAAI,EACzD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,0BAA0B,EAClC,qBAAqB,EAAE,4BAA4B,EAAE,EACrD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/backup-and-sync/syncing/group.mjs

@@ -5,7 +5,6 @@ import { BackupAndSyncAnalyticsEvent } from "../analytics/index.mjs";
 import { UserStorageSyncedWalletGroupSchema } from "../types.mjs";
 import { pushGroupToUserStorage, pushGroupToUserStorageBatch } from "../user-storage/network-operations.mjs";
 import { getLocalGroupsForEntropyWallet } from "../utils/index.mjs";
-import { toErrorMessage } from "../utils/errors.mjs";
 /**
  * Creates multiple multichain account groups in batch (from 0 to maxGroupIndex).
  * This is an optimized version that creates all groups in one operation instead of
@@ -57,7 +56,7 @@ export const createMultichainAccountGroupsBatch = async (context, entropySourceI
         // Any missing Snap accounts will be added later with alignment.
         backupAndSyncLogger(`Failed to create account groups batch:`, 
         // istanbul ignore next
-        toErrorMessage(error));
+        error instanceof Error ? error.message : String(error));
     }
 };
 /**