@metamask-previews/profile-sync-controller 15.0.0-preview-ef2405f → 15.0.0-preview-e7141654

package/dist/controllers/user-storage/contact-syncing/controller-integration.cjs

@@ -0,0 +1,376 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteContactInRemoteStorage = exports.updateContactInRemoteStorage = exports.syncContactsWithUserStorage = exports.ADDRESS_BOOK_CONTACTS_KEY = void 0;
+const sync_utils_1 = require("./sync-utils.cjs");
+const utils_1 = require("./utils.cjs");
+const storage_schema_1 = require("../../../shared/storage-schema.cjs");
+// Define a constant to use as the key for storing all contacts
+exports.ADDRESS_BOOK_CONTACTS_KEY = 'contacts';
+/**
+ * Creates a unique key for a contact based on chainId and address
+ *
+ * @param contact - The contact to create a key for
+ * @returns A unique string key
+ */
+function createContactKey(contact) {
+    return `${contact.chainId}:${contact.address.toLowerCase()}`;
+}
+/**
+ * Syncs contacts between local storage and user storage (remote).
+ *
+ * Handles the following syncing scenarios:
+ * 1. First Sync: When local contacts exist but there are no remote contacts, uploads all local contacts.
+ * 2. New Device Sync: Downloads remote contacts that don't exist locally (empty local address book).
+ * 3. Simple Merge: Ensures both sides (local & remote) have all contacts.
+ * 4. Contact Naming Conflicts: When same contact has different names, uses most recent by timestamp.
+ * 5. Local Updates: When a contact was updated locally, syncs changes to remote if local is newer.
+ * 6. Remote Updates: When a contact was updated remotely, applies changes locally if remote is newer.
+ * 7. Local Deletions: When a contact was deleted locally, marks it as deleted in remote storage.
+ * 8. Remote Deletions: When a contact was deleted remotely, applies deletion locally.
+ * 9. Concurrent Updates: Resolves conflicts using timestamps to determine the winner.
+ * 10. Restore After Delete: If a contact is modified after being deleted, restores it.
+ * 11. ChainId Differences: Treats same address on different chains as separate contacts.
+ *
+ * @param config - Parameters used for syncing callbacks
+ * @param options - Parameters used for syncing operations
+ */
+async function syncContactsWithUserStorage(config, options) {
+    const { getMessenger, getUserStorageControllerInstance } = options;
+    const { onContactSyncErroneousSituation, onContactUpdated, onContactDeleted, } = config;
+    try {
+        if (!(0, sync_utils_1.canPerformContactSyncing)(options)) {
+            console.log('🔄 Contacts Sync: Cannot perform sync, conditions not met');
+            return;
+        }
+        console.log('🔄 Contacts Sync: Starting sync process');
+        // Activate sync semaphore to prevent event loops
+        await getUserStorageControllerInstance().setIsContactSyncingInProgress(true);
+        // Get all local contacts from AddressBookController (exclude chain "*" contacts)
+        const localVisibleContacts = getMessenger()
+            .call('AddressBookController:list')
+            .filter((contact) => String(contact.chainId) !== '*') || [];
+        console.log('🔄 Contacts Sync: Local contacts', localVisibleContacts);
+        // Get remote contacts from user storage API
+        const remoteContacts = await getRemoteContacts(options);
+        console.log('🔄 Contacts Sync: Remote contacts', remoteContacts);
+        // SCENARIO 1: First Sync - No remote contacts but local contacts exist
+        if (!remoteContacts || remoteContacts.length === 0) {
+            if (localVisibleContacts.length > 0) {
+                console.log('🔄 Contacts Sync: First sync - uploading local contacts to remote');
+                await saveContactsToUserStorage(localVisibleContacts, options);
+            }
+            return;
+        }
+        // Prepare maps for efficient lookup
+        const localContactsMap = new Map();
+        const remoteContactsMap = new Map();
+        localVisibleContacts.forEach((contact) => {
+            const key = createContactKey(contact);
+            localContactsMap.set(key, contact);
+        });
+        remoteContacts.forEach((contact) => {
+            const key = createContactKey(contact);
+            remoteContactsMap.set(key, contact);
+        });
+        // Lists to track contacts that need to be synced
+        const contactsToAddOrUpdateLocally = [];
+        const contactsToDeleteLocally = [];
+        const contactsToUpdateRemotely = [];
+        // SCENARIO 2 & 6: Process remote contacts - handle new device sync and remote updates
+        for (const remoteContact of remoteContacts) {
+            const key = createContactKey(remoteContact);
+            const localContact = localContactsMap.get(key);
+            // Handle remote contact based on its status and local existence
+            if (remoteContact.deleted) {
+                // SCENARIO 8: Remote deletion - should be applied locally if contact exists locally
+                if (localContact) {
+                    console.log('🔄 Contacts Sync: Applying remote deletion locally', remoteContact);
+                    contactsToDeleteLocally.push(remoteContact);
+                    // Invoke deletion callback if needed
+                    if (onContactDeleted) {
+                        onContactDeleted();
+                    }
+                }
+            }
+            else if (!localContact) {
+                // SCENARIO 2: New contact from remote - import to local
+                console.log('🔄 Contacts Sync: Importing new remote contact', remoteContact);
+                contactsToAddOrUpdateLocally.push(remoteContact);
+                // Invoke update callback if needed
+                if (onContactUpdated) {
+                    onContactUpdated();
+                }
+            }
+            else {
+                // SCENARIO 4 & 6: Contact exists on both sides - check for conflicts
+                const hasContentDifference = localContact.name !== remoteContact.name ||
+                    localContact.memo !== remoteContact.memo;
+                if (hasContentDifference) {
+                    // Check timestamps to determine which version to keep
+                    const localTimestamp = localContact.lastUpdatedAt || 0;
+                    const remoteTimestamp = remoteContact.lastUpdatedAt || 0;
+                    if (localTimestamp >= remoteTimestamp) {
+                        // Local is newer (or same age) - use local version
+                        console.log('🔄 Contacts Sync: Local wins by timestamp', {
+                            local: localContact,
+                            remote: remoteContact,
+                            localTimestamp,
+                            remoteTimestamp,
+                        });
+                        contactsToUpdateRemotely.push(localContact);
+                    }
+                    else {
+                        // Remote is newer - use remote version
+                        console.log('🔄 Contacts Sync: Remote wins by timestamp', {
+                            local: localContact,
+                            remote: remoteContact,
+                            localTimestamp,
+                            remoteTimestamp,
+                        });
+                        contactsToAddOrUpdateLocally.push(remoteContact);
+                        // Invoke update callback if needed
+                        if (onContactUpdated) {
+                            onContactUpdated();
+                        }
+                    }
+                }
+                else {
+                    // Content is identical, no action needed
+                    console.log('🔄 Contacts Sync: Content identical, no action needed', {
+                        local: localContact,
+                        remote: remoteContact,
+                    });
+                }
+            }
+        }
+        // SCENARIO 3 & 5: Process local contacts not in remote
+        for (const localContact of localVisibleContacts) {
+            const key = createContactKey(localContact);
+            const remoteContact = remoteContactsMap.get(key);
+            if (!remoteContact) {
+                // New local contact - add to remote
+                console.log('🔄 Contacts Sync: New local contact - adding to remote', localContact);
+                contactsToUpdateRemotely.push(localContact);
+            }
+        }
+        // SCENARIO 7: Detect local deletions
+        // Skip for new device scenario (no local contacts but remote has contacts)
+        const isNewDeviceScenario = localVisibleContacts.length === 0 && remoteContacts.length > 0;
+        if (!isNewDeviceScenario) {
+            // Find contacts that exist in remote but not locally (they were deleted locally)
+            const contactsToDeleteRemotely = [];
+            for (const remoteContact of remoteContacts) {
+                if (!remoteContact.deleted) {
+                    const key = createContactKey(remoteContact);
+                    if (!localContactsMap.has(key)) {
+                        console.log('🔄 Contacts Sync: Contact deleted locally, marking as deleted in remote', remoteContact);
+                        contactsToDeleteRemotely.push(remoteContact);
+                        // Invoke deletion callback if needed
+                        if (onContactDeleted) {
+                            onContactDeleted();
+                        }
+                    }
+                }
+            }
+            // Mark contacts as deleted in remote
+            if (contactsToDeleteRemotely.length > 0) {
+                const remoteContactsWithDeletions = [...remoteContacts];
+                for (const contactToDelete of contactsToDeleteRemotely) {
+                    const key = createContactKey(contactToDelete);
+                    const indexToDelete = remoteContactsWithDeletions.findIndex((c) => createContactKey(c) === key);
+                    if (indexToDelete !== -1) {
+                        const now = Date.now();
+                        remoteContactsWithDeletions[indexToDelete] = {
+                            ...remoteContactsWithDeletions[indexToDelete],
+                            deleted: true,
+                            deletedAt: now,
+                            lastUpdatedAt: now,
+                        };
+                    }
+                }
+                // Save updated remote contacts with deletions
+                await saveContactsToUserStorage(remoteContactsWithDeletions, options);
+            }
+        }
+        else {
+            console.log('🔄 Contacts Sync: Skipping local deletion detection - this is a new device');
+        }
+        // Apply local deletions
+        for (const contact of contactsToDeleteLocally) {
+            try {
+                console.log('🔄 Contacts Sync: Deleting contact locally', contact);
+                await getMessenger().call('AddressBookController:delete', contact.chainId, contact.address);
+            }
+            catch (error) {
+                console.error('Error deleting contact:', error);
+            }
+        }
+        // Apply local additions/updates
+        for (const contact of contactsToAddOrUpdateLocally) {
+            if (!contact.deleted) {
+                try {
+                    console.log('🔄 Contacts Sync: Adding/updating contact locally', contact);
+                    await getMessenger().call('AddressBookController:set', contact.address, contact.name || '', contact.chainId, contact.memo || '', contact.addressType);
+                }
+                catch (error) {
+                    console.error('Error updating contact:', error);
+                }
+            }
+        }
+        // Apply changes to remote storage
+        if (contactsToUpdateRemotely.length > 0) {
+            console.log('🔄 Contacts Sync: Updating contacts in remote storage', contactsToUpdateRemotely);
+            // Update existing remote contacts with new contacts
+            const updatedRemoteContacts = [...remoteContacts];
+            for (const localContact of contactsToUpdateRemotely) {
+                const key = createContactKey(localContact);
+                const existingIndex = updatedRemoteContacts.findIndex((c) => createContactKey(c) === key);
+                const now = Date.now();
+                const updatedEntry = {
+                    ...localContact,
+                    lastUpdatedAt: now,
+                    deleted: false, // Ensure it's not deleted
+                };
+                if (existingIndex !== -1) {
+                    // Update existing contact
+                    updatedRemoteContacts[existingIndex] = updatedEntry;
+                }
+                else {
+                    // Add new contact
+                    updatedRemoteContacts.push(updatedEntry);
+                }
+            }
+            // Save updated contacts to remote storage
+            await saveContactsToUserStorage(updatedRemoteContacts, options);
+        }
+        console.log('🔄 Contacts Sync: Sync completed successfully');
+    }
+    catch (error) {
+        console.error('🔄 Contacts Sync: Error during sync', error);
+        if (onContactSyncErroneousSituation) {
+            onContactSyncErroneousSituation('Error synchronizing contacts', {
+                error,
+            });
+        }
+    }
+    finally {
+        await getUserStorageControllerInstance().setIsContactSyncingInProgress(false);
+    }
+}
+exports.syncContactsWithUserStorage = syncContactsWithUserStorage;
+/**
+ * Retrieves remote contacts from user storage API
+ *
+ * @param options - Parameters used for retrieving remote contacts
+ * @returns Array of contacts from remote storage, or null if none found
+ */
+async function getRemoteContacts(options) {
+    const { getUserStorageControllerInstance } = options;
+    try {
+        const remoteContactsJson = await getUserStorageControllerInstance().performGetStorage(`${storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook}.${exports.ADDRESS_BOOK_CONTACTS_KEY}`);
+        if (!remoteContactsJson) {
+            return null;
+        }
+        // Parse the JSON and convert each entry from UserStorageContactEntry to AddressBookEntry
+        const remoteStorageEntries = JSON.parse(remoteContactsJson);
+        return remoteStorageEntries.map((entry) => (0, utils_1.mapUserStorageEntryToAddressBookEntry)(entry));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Saves local contacts to user storage
+ *
+ * @param contacts - The contacts to save to user storage
+ * @param options - Parameters used for saving contacts
+ */
+async function saveContactsToUserStorage(contacts, options) {
+    const { getUserStorageControllerInstance } = options;
+    if (!contacts || contacts.length === 0) {
+        return;
+    }
+    // Convert each AddressBookEntry to UserStorageContactEntry format before saving
+    const storageEntries = contacts.map((contact) => (0, utils_1.mapAddressBookEntryToUserStorageEntry)(contact));
+    await getUserStorageControllerInstance().performSetStorage(`${storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook}.${exports.ADDRESS_BOOK_CONTACTS_KEY}`, JSON.stringify(storageEntries));
+}
+/**
+ * Updates a single contact in remote storage without performing a full sync
+ * This is used when a contact is updated locally to efficiently push changes to remote
+ *
+ * @param contact - The contact that was updated locally
+ * @param options - Parameters used for syncing operations
+ */
+async function updateContactInRemoteStorage(contact, options) {
+    if (!(0, sync_utils_1.canPerformContactSyncing)(options)) {
+        return;
+    }
+    console.log('🔄 Contacts Sync: Updating single contact in remote storage', contact);
+    try {
+        // Get current remote contacts or initialize empty array
+        const remoteContacts = (await getRemoteContacts(options)) || [];
+        // Find if this contact already exists in remote
+        const key = createContactKey(contact);
+        const existingIndex = remoteContacts.findIndex((c) => createContactKey(c) === key);
+        const updatedRemoteContacts = [...remoteContacts];
+        // Create an updated entry with timestamp
+        const updatedEntry = {
+            ...contact,
+            lastUpdatedAt: contact.lastUpdatedAt || Date.now(),
+            deleted: false, // Explicitly set to false in case this was previously deleted
+        };
+        if (existingIndex !== -1) {
+            // Update existing contact
+            updatedRemoteContacts[existingIndex] = updatedEntry;
+        }
+        else {
+            // Add as new contact
+            updatedRemoteContacts.push(updatedEntry);
+        }
+        // Save to remote storage
+        await saveContactsToUserStorage(updatedRemoteContacts, options);
+    }
+    catch (error) {
+        console.error('🔄 Contacts Sync: Error updating contact in remote storage', error);
+    }
+}
+exports.updateContactInRemoteStorage = updateContactInRemoteStorage;
+/**
+ * Marks a single contact as deleted in remote storage without performing a full sync
+ * This is used when a contact is deleted locally to efficiently push the deletion to remote
+ *
+ * @param contact - The contact that was deleted locally (contains at least address and chainId)
+ * @param options - Parameters used for syncing operations
+ */
+async function deleteContactInRemoteStorage(contact, options) {
+    if (!(0, sync_utils_1.canPerformContactSyncing)(options)) {
+        return;
+    }
+    console.log('🔄 Contacts Sync: Marking contact as deleted in remote storage', contact);
+    try {
+        // Get current remote contacts
+        const remoteContacts = (await getRemoteContacts(options)) || [];
+        // Find the contact in remote storage
+        const key = createContactKey(contact);
+        const existingIndex = remoteContacts.findIndex((c) => createContactKey(c) === key);
+        // If the contact exists in remote storage
+        if (existingIndex !== -1) {
+            const updatedRemoteContacts = [...remoteContacts];
+            const now = Date.now();
+            // Mark the contact as deleted
+            updatedRemoteContacts[existingIndex] = {
+                ...updatedRemoteContacts[existingIndex],
+                deleted: true,
+                deletedAt: now,
+                lastUpdatedAt: now,
+            };
+            // Save to remote storage
+            await saveContactsToUserStorage(updatedRemoteContacts, options);
+        }
+    }
+    catch (error) {
+        console.error('🔄 Contacts Sync: Error marking contact as deleted in remote storage', error);
+    }
+}
+exports.deleteContactInRemoteStorage = deleteContactInRemoteStorage;
+//# sourceMappingURL=controller-integration.cjs.map

package/dist/controllers/user-storage/contact-syncing/controller-integration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-integration.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/controller-integration.ts"],"names":[],"mappings":";;;AAEA,iDAAwD;AAGxD,uCAIiB;AACjB,uEAA4E;AAE5E,+DAA+D;AAClD,QAAA,yBAAyB,GAAG,UAAU,CAAC;AAWpD;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAAyB;IACjD,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACI,KAAK,UAAU,2BAA2B,CAC/C,MAAyC,EACzC,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,gCAAgC,EAAE,GAAG,OAAO,CAAC;IACnE,MAAM,EACJ,+BAA+B,EAC/B,gBAAgB,EAChB,gBAAgB,GACjB,GAAG,MAAM,CAAC;IAEX,IAAI;QACF,IAAI,CAAC,IAAA,qCAAwB,EAAC,OAAO,CAAC,EAAE;YACtC,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;YACzE,OAAO;SACR;QAED,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAEvD,iDAAiD;QACjD,MAAM,gCAAgC,EAAE,CAAC,6BAA6B,CACpE,IAAI,CACL,CAAC;QAEF,iFAAiF;QACjF,MAAM,oBAAoB,GACxB,YAAY,EAAE;aACX,IAAI,CAAC,4BAA4B,CAAC;aAClC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QAEhE,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,oBAAoB,CAAC,CAAC;QAEtE,4CAA4C;QAC5C,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,mCAAmC,EAAE,cAAc,CAAC,CAAC;QAEjE,uEAAuE;QACvE,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE;YAClD,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE;gBACnC,OAAO,CAAC,GAAG,CACT,mEAAmE,CACpE,CAAC;gBACF,MAAM,yBAAyB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;aAChE;YACD,OAAO;SACR;QAED,oCAAoC;QACpC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAC;QAC7D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAgC,CAAC;QAElE,oBAAoB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACtC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACjC,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACtC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,4BAA4B,GAA2B,EAAE,CAAC;QAChE,MAAM,uBAAuB,GAA2B,EAAE,CAAC;QAC3D,MAAM,wBAAwB,GAAuB,EAAE,CAAC;QAExD,sFAAsF;QACtF,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;YAC1C,MAAM,GAAG,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE/C,gEAAgE;YAChE,IAAI,aAAa,CAAC,OAAO,EAAE;gBACzB,oFAAoF;gBACpF,IAAI,YAAY,EAAE;oBAChB,OAAO,CAAC,GAAG,CACT,oDAAoD,EACpD,aAAa,CACd,CAAC;oBACF,uBAAuB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBAE5C,qCAAqC;oBACrC,IAAI,gBAAgB,EAAE;wBACpB,gBAAgB,EAAE,CAAC;qBACpB;iBACF;aACF;iBAAM,IAAI,CAAC,YAAY,EAAE;gBACxB,wDAAwD;gBACxD,OAAO,CAAC,GAAG,CACT,gDAAgD,EAChD,aAAa,CACd,CAAC;gBACF,4BAA4B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBAEjD,mCAAmC;gBACnC,IAAI,gBAAgB,EAAE;oBACpB,gBAAgB,EAAE,CAAC;iBACpB;aACF;iBAAM;gBACL,qEAAqE;gBACrE,MAAM,oBAAoB,GACxB,YAAY,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI;oBACxC,YAAY,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,CAAC;gBAE3C,IAAI,oBAAoB,EAAE;oBACxB,sDAAsD;oBACtD,MAAM,cAAc,GAAG,YAAY,CAAC,aAAa,IAAI,CAAC,CAAC;oBACvD,MAAM,eAAe,GAAG,aAAa,CAAC,aAAa,IAAI,CAAC,CAAC;oBAEzD,IAAI,cAAc,IAAI,eAAe,EAAE;wBACrC,mDAAmD;wBACnD,OAAO,CAAC,GAAG,CAAC,2CAA2C,EAAE;4BACvD,KAAK,EAAE,YAAY;4BACnB,MAAM,EAAE,aAAa;4BACrB,cAAc;4BACd,eAAe;yBAChB,CAAC,CAAC;wBACH,wBAAwB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;qBAC7C;yBAAM;wBACL,uCAAuC;wBACvC,OAAO,CAAC,GAAG,CAAC,4CAA4C,EAAE;4BACxD,KAAK,EAAE,YAAY;4BACnB,MAAM,EAAE,aAAa;4BACrB,cAAc;4BACd,eAAe;yBAChB,CAAC,CAAC;wBACH,4BAA4B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;wBAEjD,mCAAmC;wBACnC,IAAI,gBAAgB,EAAE;4BACpB,gBAAgB,EAAE,CAAC;yBACpB;qBACF;iBACF;qBAAM;oBACL,yCAAyC;oBACzC,OAAO,CAAC,GAAG,CAAC,uDAAuD,EAAE;wBACnE,KAAK,EAAE,YAAY;wBACnB,MAAM,EAAE,aAAa;qBACtB,CAAC,CAAC;iBACJ;aACF;SACF;QAED,uDAAuD;QACvD,KAAK,MAAM,YAAY,IAAI,oBAAoB,EAAE;YAC/C,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEjD,IAAI,CAAC,aAAa,EAAE;gBAClB,oCAAoC;gBACpC,OAAO,CAAC,GAAG,CACT,wDAAwD,EACxD,YAAY,CACb,CAAC;gBACF,wBAAwB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;aAC7C;SACF;QAED,qCAAqC;QACrC,2EAA2E;QAC3E,MAAM,mBAAmB,GACvB,oBAAoB,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAEjE,IAAI,CAAC,mBAAmB,EAAE;YACxB,iFAAiF;YACjF,MAAM,wBAAwB,GAA2B,EAAE,CAAC;YAE5D,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;gBAC1C,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;oBAC1B,MAAM,GAAG,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;oBAC5C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;wBAC9B,OAAO,CAAC,GAAG,CACT,yEAAyE,EACzE,aAAa,CACd,CAAC;wBACF,wBAAwB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;wBAE7C,qCAAqC;wBACrC,IAAI,gBAAgB,EAAE;4BACpB,gBAAgB,EAAE,CAAC;yBACpB;qBACF;iBACF;aACF;YAED,qCAAqC;YACrC,IAAI,wBAAwB,CAAC,MAAM,GAAG,CAAC,EAAE;gBACvC,MAAM,2BAA2B,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;gBAExD,KAAK,MAAM,eAAe,IAAI,wBAAwB,EAAE;oBACtD,MAAM,GAAG,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;oBAC9C,MAAM,aAAa,GAAG,2BAA2B,CAAC,SAAS,CACzD,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,GAAG,CACnC,CAAC;oBAEF,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;wBACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBACvB,2BAA2B,CAAC,aAAa,CAAC,GAAG;4BAC3C,GAAG,2BAA2B,CAAC,aAAa,CAAC;4BAC7C,OAAO,EAAE,IAAI;4BACb,SAAS,EAAE,GAAG;4BACd,aAAa,EAAE,GAAG;yBACnB,CAAC;qBACH;iBACF;gBAED,8CAA8C;gBAC9C,MAAM,yBAAyB,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;aACvE;SACF;aAAM;YACL,OAAO,CAAC,GAAG,CACT,4EAA4E,CAC7E,CAAC;SACH;QAED,wBAAwB;QACxB,KAAK,MAAM,OAAO,IAAI,uBAAuB,EAAE;YAC7C,IAAI;gBACF,OAAO,CAAC,GAAG,CAAC,4CAA4C,EAAE,OAAO,CAAC,CAAC;gBACnE,MAAM,YAAY,EAAE,CAAC,IAAI,CACvB,8BAA8B,EAC9B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,OAAO,CAChB,CAAC;aACH;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;aACjD;SACF;QAED,gCAAgC;QAChC,KAAK,MAAM,OAAO,IAAI,4BAA4B,EAAE;YAClD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;gBACpB,IAAI;oBACF,OAAO,CAAC,GAAG,CACT,mDAAmD,EACnD,OAAO,CACR,CAAC;oBACF,MAAM,YAAY,EAAE,CAAC,IAAI,CACvB,2BAA2B,EAC3B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,IAAI,IAAI,EAAE,EAClB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,IAAI,IAAI,EAAE,EAClB,OAAO,CAAC,WAAW,CACpB,CAAC;iBACH;gBAAC,OAAO,KAAK,EAAE;oBACd,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;iBACjD;aACF;SACF;QAED,kCAAkC;QAClC,IAAI,wBAAwB,CAAC,MAAM,GAAG,CAAC,EAAE;YACvC,OAAO,CAAC,GAAG,CACT,uDAAuD,EACvD,wBAAwB,CACzB,CAAC;YAEF,oDAAoD;YACpD,MAAM,qBAAqB,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;YAElD,KAAK,MAAM,YAAY,IAAI,wBAAwB,EAAE;gBACnD,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAC3C,MAAM,aAAa,GAAG,qBAAqB,CAAC,SAAS,CACnD,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,GAAG,CACnC,CAAC;gBAEF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,MAAM,YAAY,GAAG;oBACnB,GAAG,YAAY;oBACf,aAAa,EAAE,GAAG;oBAClB,OAAO,EAAE,KAAK,EAAE,0BAA0B;iBACnB,CAAC;gBAE1B,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;oBACxB,0BAA0B;oBAC1B,qBAAqB,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC;iBACrD;qBAAM;oBACL,kBAAkB;oBAClB,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;iBAC1C;aACF;YAED,0CAA0C;YAC1C,MAAM,yBAAyB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;SACjE;QAED,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;KAC9D;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC5D,IAAI,+BAA+B,EAAE;YACnC,+BAA+B,CAAC,8BAA8B,EAAE;gBAC9D,KAAK;aACN,CAAC,CAAC;SACJ;KACF;YAAS;QACR,MAAM,gCAAgC,EAAE,CAAC,6BAA6B,CACpE,KAAK,CACN,CAAC;KACH;AACH,CAAC;AA5SD,kEA4SC;AAED;;;;;GAKG;AACH,KAAK,UAAU,iBAAiB,CAC9B,OAA8B;IAE9B,MAAM,EAAE,gCAAgC,EAAE,GAAG,OAAO,CAAC;IAErD,IAAI;QACF,MAAM,kBAAkB,GACtB,MAAM,gCAAgC,EAAE,CAAC,iBAAiB,CACxD,GAAG,2CAA0B,CAAC,WAAW,IAAI,iCAAyB,EAAE,CACzE,CAAC;QAEJ,IAAI,CAAC,kBAAkB,EAAE;YACvB,OAAO,IAAI,CAAC;SACb;QAED,yFAAyF;QACzF,MAAM,oBAAoB,GAAG,IAAI,CAAC,KAAK,CACrC,kBAAkB,CACU,CAAC;QAC/B,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACxC,IAAA,6CAAqC,EAAC,KAAK,CAAC,CAC7C,CAAC;KACH;IAAC,MAAM;QACN,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,yBAAyB,CACtC,QAA4B,EAC5B,OAA8B;IAE9B,MAAM,EAAE,gCAAgC,EAAE,GAAG,OAAO,CAAC;IAErD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;QACtC,OAAO;KACR;IAED,gFAAgF;IAChF,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC9C,IAAA,6CAAqC,EAAC,OAAO,CAAC,CAC/C,CAAC;IAEF,MAAM,gCAAgC,EAAE,CAAC,iBAAiB,CACxD,GAAG,2CAA0B,CAAC,WAAW,IAAI,iCAAyB,EAAE,EACxE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,4BAA4B,CAChD,OAAyB,EACzB,OAA8B;IAE9B,IAAI,CAAC,IAAA,qCAAwB,EAAC,OAAO,CAAC,EAAE;QACtC,OAAO;KACR;IAED,OAAO,CAAC,GAAG,CACT,6DAA6D,EAC7D,OAAO,CACR,CAAC;IAEF,IAAI;QACF,wDAAwD;QACxD,MAAM,cAAc,GAAG,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhE,gDAAgD;QAChD,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,cAAc,CAAC,SAAS,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,GAAG,CACnC,CAAC;QAEF,MAAM,qBAAqB,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;QAElD,yCAAyC;QACzC,MAAM,YAAY,GAAG;YACnB,GAAG,OAAO;YACV,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,EAAE;YAClD,OAAO,EAAE,KAAK,EAAE,8DAA8D;SACvD,CAAC;QAE1B,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;YACxB,0BAA0B;YAC1B,qBAAqB,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC;SACrD;aAAM;YACL,qBAAqB;YACrB,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SAC1C;QAED,yBAAyB;QACzB,MAAM,yBAAyB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;KACjE;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CACX,4DAA4D,EAC5D,KAAK,CACN,CAAC;KACH;AACH,CAAC;AAhDD,oEAgDC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,4BAA4B,CAChD,OAAyB,EACzB,OAA8B;IAE9B,IAAI,CAAC,IAAA,qCAAwB,EAAC,OAAO,CAAC,EAAE;QACtC,OAAO;KACR;IAED,OAAO,CAAC,GAAG,CACT,gEAAgE,EAChE,OAAO,CACR,CAAC;IAEF,IAAI;QACF,8BAA8B;QAC9B,MAAM,cAAc,GAAG,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhE,qCAAqC;QACrC,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,cAAc,CAAC,SAAS,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,GAAG,CACnC,CAAC;QAEF,0CAA0C;QAC1C,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;YACxB,MAAM,qBAAqB,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEvB,8BAA8B;YAC9B,qBAAqB,CAAC,aAAa,CAAC,GAAG;gBACrC,GAAG,qBAAqB,CAAC,aAAa,CAAC;gBACvC,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,GAAG;gBACd,aAAa,EAAE,GAAG;aACnB,CAAC;YAEF,yBAAyB;YACzB,MAAM,yBAAyB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;SACjE;KACF;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CACX,sEAAsE,EACtE,KAAK,CACN,CAAC;KACH;AACH,CAAC;AA7CD,oEA6CC","sourcesContent":["import type { AddressBookEntry } from '@metamask/address-book-controller';\n\nimport { canPerformContactSyncing } from './sync-utils';\nimport type { ContactSyncingOptions } from './types';\nimport type { UserStorageContactEntry } from './types';\nimport {\n  mapAddressBookEntryToUserStorageEntry,\n  mapUserStorageEntryToAddressBookEntry,\n  type SyncAddressBookEntry,\n} from './utils';\nimport { USER_STORAGE_FEATURE_NAMES } from '../../../shared/storage-schema';\n\n// Define a constant to use as the key for storing all contacts\nexport const ADDRESS_BOOK_CONTACTS_KEY = 'contacts';\n\nexport type SyncContactsWithUserStorageConfig = {\n  onContactSyncErroneousSituation?: (\n    errorMessage: string,\n    sentryContext?: Record<string, unknown>,\n  ) => void;\n  onContactUpdated?: () => void;\n  onContactDeleted?: () => void;\n};\n\n/**\n * Creates a unique key for a contact based on chainId and address\n *\n * @param contact - The contact to create a key for\n * @returns A unique string key\n */\nfunction createContactKey(contact: AddressBookEntry): string {\n  return `${contact.chainId}:${contact.address.toLowerCase()}`;\n}\n\n/**\n * Syncs contacts between local storage and user storage (remote).\n *\n * Handles the following syncing scenarios:\n * 1. First Sync: When local contacts exist but there are no remote contacts, uploads all local contacts.\n * 2. New Device Sync: Downloads remote contacts that don't exist locally (empty local address book).\n * 3. Simple Merge: Ensures both sides (local & remote) have all contacts.\n * 4. Contact Naming Conflicts: When same contact has different names, uses most recent by timestamp.\n * 5. Local Updates: When a contact was updated locally, syncs changes to remote if local is newer.\n * 6. Remote Updates: When a contact was updated remotely, applies changes locally if remote is newer.\n * 7. Local Deletions: When a contact was deleted locally, marks it as deleted in remote storage.\n * 8. Remote Deletions: When a contact was deleted remotely, applies deletion locally.\n * 9. Concurrent Updates: Resolves conflicts using timestamps to determine the winner.\n * 10. Restore After Delete: If a contact is modified after being deleted, restores it.\n * 11. ChainId Differences: Treats same address on different chains as separate contacts.\n *\n * @param config - Parameters used for syncing callbacks\n * @param options - Parameters used for syncing operations\n */\nexport async function syncContactsWithUserStorage(\n  config: SyncContactsWithUserStorageConfig,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { getMessenger, getUserStorageControllerInstance } = options;\n  const {\n    onContactSyncErroneousSituation,\n    onContactUpdated,\n    onContactDeleted,\n  } = config;\n\n  try {\n    if (!canPerformContactSyncing(options)) {\n      console.log('🔄 Contacts Sync: Cannot perform sync, conditions not met');\n      return;\n    }\n\n    console.log('🔄 Contacts Sync: Starting sync process');\n\n    // Activate sync semaphore to prevent event loops\n    await getUserStorageControllerInstance().setIsContactSyncingInProgress(\n      true,\n    );\n\n    // Get all local contacts from AddressBookController (exclude chain \"*\" contacts)\n    const localVisibleContacts =\n      getMessenger()\n        .call('AddressBookController:list')\n        .filter((contact) => String(contact.chainId) !== '*') || [];\n\n    console.log('🔄 Contacts Sync: Local contacts', localVisibleContacts);\n\n    // Get remote contacts from user storage API\n    const remoteContacts = await getRemoteContacts(options);\n    console.log('🔄 Contacts Sync: Remote contacts', remoteContacts);\n\n    // SCENARIO 1: First Sync - No remote contacts but local contacts exist\n    if (!remoteContacts || remoteContacts.length === 0) {\n      if (localVisibleContacts.length > 0) {\n        console.log(\n          '🔄 Contacts Sync: First sync - uploading local contacts to remote',\n        );\n        await saveContactsToUserStorage(localVisibleContacts, options);\n      }\n      return;\n    }\n\n    // Prepare maps for efficient lookup\n    const localContactsMap = new Map<string, AddressBookEntry>();\n    const remoteContactsMap = new Map<string, SyncAddressBookEntry>();\n\n    localVisibleContacts.forEach((contact) => {\n      const key = createContactKey(contact);\n      localContactsMap.set(key, contact);\n    });\n\n    remoteContacts.forEach((contact) => {\n      const key = createContactKey(contact);\n      remoteContactsMap.set(key, contact);\n    });\n\n    // Lists to track contacts that need to be synced\n    const contactsToAddOrUpdateLocally: SyncAddressBookEntry[] = [];\n    const contactsToDeleteLocally: SyncAddressBookEntry[] = [];\n    const contactsToUpdateRemotely: AddressBookEntry[] = [];\n\n    // SCENARIO 2 & 6: Process remote contacts - handle new device sync and remote updates\n    for (const remoteContact of remoteContacts) {\n      const key = createContactKey(remoteContact);\n      const localContact = localContactsMap.get(key);\n\n      // Handle remote contact based on its status and local existence\n      if (remoteContact.deleted) {\n        // SCENARIO 8: Remote deletion - should be applied locally if contact exists locally\n        if (localContact) {\n          console.log(\n            '🔄 Contacts Sync: Applying remote deletion locally',\n            remoteContact,\n          );\n          contactsToDeleteLocally.push(remoteContact);\n\n          // Invoke deletion callback if needed\n          if (onContactDeleted) {\n            onContactDeleted();\n          }\n        }\n      } else if (!localContact) {\n        // SCENARIO 2: New contact from remote - import to local\n        console.log(\n          '🔄 Contacts Sync: Importing new remote contact',\n          remoteContact,\n        );\n        contactsToAddOrUpdateLocally.push(remoteContact);\n\n        // Invoke update callback if needed\n        if (onContactUpdated) {\n          onContactUpdated();\n        }\n      } else {\n        // SCENARIO 4 & 6: Contact exists on both sides - check for conflicts\n        const hasContentDifference =\n          localContact.name !== remoteContact.name ||\n          localContact.memo !== remoteContact.memo;\n\n        if (hasContentDifference) {\n          // Check timestamps to determine which version to keep\n          const localTimestamp = localContact.lastUpdatedAt || 0;\n          const remoteTimestamp = remoteContact.lastUpdatedAt || 0;\n\n          if (localTimestamp >= remoteTimestamp) {\n            // Local is newer (or same age) - use local version\n            console.log('🔄 Contacts Sync: Local wins by timestamp', {\n              local: localContact,\n              remote: remoteContact,\n              localTimestamp,\n              remoteTimestamp,\n            });\n            contactsToUpdateRemotely.push(localContact);\n          } else {\n            // Remote is newer - use remote version\n            console.log('🔄 Contacts Sync: Remote wins by timestamp', {\n              local: localContact,\n              remote: remoteContact,\n              localTimestamp,\n              remoteTimestamp,\n            });\n            contactsToAddOrUpdateLocally.push(remoteContact);\n\n            // Invoke update callback if needed\n            if (onContactUpdated) {\n              onContactUpdated();\n            }\n          }\n        } else {\n          // Content is identical, no action needed\n          console.log('🔄 Contacts Sync: Content identical, no action needed', {\n            local: localContact,\n            remote: remoteContact,\n          });\n        }\n      }\n    }\n\n    // SCENARIO 3 & 5: Process local contacts not in remote\n    for (const localContact of localVisibleContacts) {\n      const key = createContactKey(localContact);\n      const remoteContact = remoteContactsMap.get(key);\n\n      if (!remoteContact) {\n        // New local contact - add to remote\n        console.log(\n          '🔄 Contacts Sync: New local contact - adding to remote',\n          localContact,\n        );\n        contactsToUpdateRemotely.push(localContact);\n      }\n    }\n\n    // SCENARIO 7: Detect local deletions\n    // Skip for new device scenario (no local contacts but remote has contacts)\n    const isNewDeviceScenario =\n      localVisibleContacts.length === 0 && remoteContacts.length > 0;\n\n    if (!isNewDeviceScenario) {\n      // Find contacts that exist in remote but not locally (they were deleted locally)\n      const contactsToDeleteRemotely: SyncAddressBookEntry[] = [];\n\n      for (const remoteContact of remoteContacts) {\n        if (!remoteContact.deleted) {\n          const key = createContactKey(remoteContact);\n          if (!localContactsMap.has(key)) {\n            console.log(\n              '🔄 Contacts Sync: Contact deleted locally, marking as deleted in remote',\n              remoteContact,\n            );\n            contactsToDeleteRemotely.push(remoteContact);\n\n            // Invoke deletion callback if needed\n            if (onContactDeleted) {\n              onContactDeleted();\n            }\n          }\n        }\n      }\n\n      // Mark contacts as deleted in remote\n      if (contactsToDeleteRemotely.length > 0) {\n        const remoteContactsWithDeletions = [...remoteContacts];\n\n        for (const contactToDelete of contactsToDeleteRemotely) {\n          const key = createContactKey(contactToDelete);\n          const indexToDelete = remoteContactsWithDeletions.findIndex(\n            (c) => createContactKey(c) === key,\n          );\n\n          if (indexToDelete !== -1) {\n            const now = Date.now();\n            remoteContactsWithDeletions[indexToDelete] = {\n              ...remoteContactsWithDeletions[indexToDelete],\n              deleted: true,\n              deletedAt: now,\n              lastUpdatedAt: now,\n            };\n          }\n        }\n\n        // Save updated remote contacts with deletions\n        await saveContactsToUserStorage(remoteContactsWithDeletions, options);\n      }\n    } else {\n      console.log(\n        '🔄 Contacts Sync: Skipping local deletion detection - this is a new device',\n      );\n    }\n\n    // Apply local deletions\n    for (const contact of contactsToDeleteLocally) {\n      try {\n        console.log('🔄 Contacts Sync: Deleting contact locally', contact);\n        await getMessenger().call(\n          'AddressBookController:delete',\n          contact.chainId,\n          contact.address,\n        );\n      } catch (error) {\n        console.error('Error deleting contact:', error);\n      }\n    }\n\n    // Apply local additions/updates\n    for (const contact of contactsToAddOrUpdateLocally) {\n      if (!contact.deleted) {\n        try {\n          console.log(\n            '🔄 Contacts Sync: Adding/updating contact locally',\n            contact,\n          );\n          await getMessenger().call(\n            'AddressBookController:set',\n            contact.address,\n            contact.name || '',\n            contact.chainId,\n            contact.memo || '',\n            contact.addressType,\n          );\n        } catch (error) {\n          console.error('Error updating contact:', error);\n        }\n      }\n    }\n\n    // Apply changes to remote storage\n    if (contactsToUpdateRemotely.length > 0) {\n      console.log(\n        '🔄 Contacts Sync: Updating contacts in remote storage',\n        contactsToUpdateRemotely,\n      );\n\n      // Update existing remote contacts with new contacts\n      const updatedRemoteContacts = [...remoteContacts];\n\n      for (const localContact of contactsToUpdateRemotely) {\n        const key = createContactKey(localContact);\n        const existingIndex = updatedRemoteContacts.findIndex(\n          (c) => createContactKey(c) === key,\n        );\n\n        const now = Date.now();\n        const updatedEntry = {\n          ...localContact,\n          lastUpdatedAt: now,\n          deleted: false, // Ensure it's not deleted\n        } as SyncAddressBookEntry;\n\n        if (existingIndex !== -1) {\n          // Update existing contact\n          updatedRemoteContacts[existingIndex] = updatedEntry;\n        } else {\n          // Add new contact\n          updatedRemoteContacts.push(updatedEntry);\n        }\n      }\n\n      // Save updated contacts to remote storage\n      await saveContactsToUserStorage(updatedRemoteContacts, options);\n    }\n\n    console.log('🔄 Contacts Sync: Sync completed successfully');\n  } catch (error) {\n    console.error('🔄 Contacts Sync: Error during sync', error);\n    if (onContactSyncErroneousSituation) {\n      onContactSyncErroneousSituation('Error synchronizing contacts', {\n        error,\n      });\n    }\n  } finally {\n    await getUserStorageControllerInstance().setIsContactSyncingInProgress(\n      false,\n    );\n  }\n}\n\n/**\n * Retrieves remote contacts from user storage API\n *\n * @param options - Parameters used for retrieving remote contacts\n * @returns Array of contacts from remote storage, or null if none found\n */\nasync function getRemoteContacts(\n  options: ContactSyncingOptions,\n): Promise<SyncAddressBookEntry[] | null> {\n  const { getUserStorageControllerInstance } = options;\n\n  try {\n    const remoteContactsJson =\n      await getUserStorageControllerInstance().performGetStorage(\n        `${USER_STORAGE_FEATURE_NAMES.addressBook}.${ADDRESS_BOOK_CONTACTS_KEY}`,\n      );\n\n    if (!remoteContactsJson) {\n      return null;\n    }\n\n    // Parse the JSON and convert each entry from UserStorageContactEntry to AddressBookEntry\n    const remoteStorageEntries = JSON.parse(\n      remoteContactsJson,\n    ) as UserStorageContactEntry[];\n    return remoteStorageEntries.map((entry) =>\n      mapUserStorageEntryToAddressBookEntry(entry),\n    );\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Saves local contacts to user storage\n *\n * @param contacts - The contacts to save to user storage\n * @param options - Parameters used for saving contacts\n */\nasync function saveContactsToUserStorage(\n  contacts: AddressBookEntry[],\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { getUserStorageControllerInstance } = options;\n\n  if (!contacts || contacts.length === 0) {\n    return;\n  }\n\n  // Convert each AddressBookEntry to UserStorageContactEntry format before saving\n  const storageEntries = contacts.map((contact) =>\n    mapAddressBookEntryToUserStorageEntry(contact),\n  );\n\n  await getUserStorageControllerInstance().performSetStorage(\n    `${USER_STORAGE_FEATURE_NAMES.addressBook}.${ADDRESS_BOOK_CONTACTS_KEY}`,\n    JSON.stringify(storageEntries),\n  );\n}\n\n/**\n * Updates a single contact in remote storage without performing a full sync\n * This is used when a contact is updated locally to efficiently push changes to remote\n *\n * @param contact - The contact that was updated locally\n * @param options - Parameters used for syncing operations\n */\nexport async function updateContactInRemoteStorage(\n  contact: AddressBookEntry,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  if (!canPerformContactSyncing(options)) {\n    return;\n  }\n\n  console.log(\n    '🔄 Contacts Sync: Updating single contact in remote storage',\n    contact,\n  );\n\n  try {\n    // Get current remote contacts or initialize empty array\n    const remoteContacts = (await getRemoteContacts(options)) || [];\n\n    // Find if this contact already exists in remote\n    const key = createContactKey(contact);\n    const existingIndex = remoteContacts.findIndex(\n      (c) => createContactKey(c) === key,\n    );\n\n    const updatedRemoteContacts = [...remoteContacts];\n\n    // Create an updated entry with timestamp\n    const updatedEntry = {\n      ...contact,\n      lastUpdatedAt: contact.lastUpdatedAt || Date.now(),\n      deleted: false, // Explicitly set to false in case this was previously deleted\n    } as SyncAddressBookEntry;\n\n    if (existingIndex !== -1) {\n      // Update existing contact\n      updatedRemoteContacts[existingIndex] = updatedEntry;\n    } else {\n      // Add as new contact\n      updatedRemoteContacts.push(updatedEntry);\n    }\n\n    // Save to remote storage\n    await saveContactsToUserStorage(updatedRemoteContacts, options);\n  } catch (error) {\n    console.error(\n      '🔄 Contacts Sync: Error updating contact in remote storage',\n      error,\n    );\n  }\n}\n\n/**\n * Marks a single contact as deleted in remote storage without performing a full sync\n * This is used when a contact is deleted locally to efficiently push the deletion to remote\n *\n * @param contact - The contact that was deleted locally (contains at least address and chainId)\n * @param options - Parameters used for syncing operations\n */\nexport async function deleteContactInRemoteStorage(\n  contact: AddressBookEntry,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  if (!canPerformContactSyncing(options)) {\n    return;\n  }\n\n  console.log(\n    '🔄 Contacts Sync: Marking contact as deleted in remote storage',\n    contact,\n  );\n\n  try {\n    // Get current remote contacts\n    const remoteContacts = (await getRemoteContacts(options)) || [];\n\n    // Find the contact in remote storage\n    const key = createContactKey(contact);\n    const existingIndex = remoteContacts.findIndex(\n      (c) => createContactKey(c) === key,\n    );\n\n    // If the contact exists in remote storage\n    if (existingIndex !== -1) {\n      const updatedRemoteContacts = [...remoteContacts];\n      const now = Date.now();\n\n      // Mark the contact as deleted\n      updatedRemoteContacts[existingIndex] = {\n        ...updatedRemoteContacts[existingIndex],\n        deleted: true,\n        deletedAt: now,\n        lastUpdatedAt: now,\n      };\n\n      // Save to remote storage\n      await saveContactsToUserStorage(updatedRemoteContacts, options);\n    }\n  } catch (error) {\n    console.error(\n      '🔄 Contacts Sync: Error marking contact as deleted in remote storage',\n      error,\n    );\n  }\n}\n"]}

package/dist/controllers/user-storage/contact-syncing/controller-integration.d.cts

@@ -0,0 +1,45 @@
+import type { AddressBookEntry } from "@metamask/address-book-controller";
+import type { ContactSyncingOptions } from "./types.cjs";
+export declare const ADDRESS_BOOK_CONTACTS_KEY = "contacts";
+export type SyncContactsWithUserStorageConfig = {
+    onContactSyncErroneousSituation?: (errorMessage: string, sentryContext?: Record<string, unknown>) => void;
+    onContactUpdated?: () => void;
+    onContactDeleted?: () => void;
+};
+/**
+ * Syncs contacts between local storage and user storage (remote).
+ *
+ * Handles the following syncing scenarios:
+ * 1. First Sync: When local contacts exist but there are no remote contacts, uploads all local contacts.
+ * 2. New Device Sync: Downloads remote contacts that don't exist locally (empty local address book).
+ * 3. Simple Merge: Ensures both sides (local & remote) have all contacts.
+ * 4. Contact Naming Conflicts: When same contact has different names, uses most recent by timestamp.
+ * 5. Local Updates: When a contact was updated locally, syncs changes to remote if local is newer.
+ * 6. Remote Updates: When a contact was updated remotely, applies changes locally if remote is newer.
+ * 7. Local Deletions: When a contact was deleted locally, marks it as deleted in remote storage.
+ * 8. Remote Deletions: When a contact was deleted remotely, applies deletion locally.
+ * 9. Concurrent Updates: Resolves conflicts using timestamps to determine the winner.
+ * 10. Restore After Delete: If a contact is modified after being deleted, restores it.
+ * 11. ChainId Differences: Treats same address on different chains as separate contacts.
+ *
+ * @param config - Parameters used for syncing callbacks
+ * @param options - Parameters used for syncing operations
+ */
+export declare function syncContactsWithUserStorage(config: SyncContactsWithUserStorageConfig, options: ContactSyncingOptions): Promise<void>;
+/**
+ * Updates a single contact in remote storage without performing a full sync
+ * This is used when a contact is updated locally to efficiently push changes to remote
+ *
+ * @param contact - The contact that was updated locally
+ * @param options - Parameters used for syncing operations
+ */
+export declare function updateContactInRemoteStorage(contact: AddressBookEntry, options: ContactSyncingOptions): Promise<void>;
+/**
+ * Marks a single contact as deleted in remote storage without performing a full sync
+ * This is used when a contact is deleted locally to efficiently push the deletion to remote
+ *
+ * @param contact - The contact that was deleted locally (contains at least address and chainId)
+ * @param options - Parameters used for syncing operations
+ */
+export declare function deleteContactInRemoteStorage(contact: AddressBookEntry, options: ContactSyncingOptions): Promise<void>;
+//# sourceMappingURL=controller-integration.d.cts.map

package/dist/controllers/user-storage/contact-syncing/controller-integration.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-integration.d.cts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/controller-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,0CAA0C;AAG1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAgB;AAUrD,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAEpD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,+BAA+B,CAAC,EAAE,CAChC,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACpC,IAAI,CAAC;IACV,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAYF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,EACzC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAySf;AA8DD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/controllers/user-storage/contact-syncing/controller-integration.d.mts

@@ -0,0 +1,45 @@
+import type { AddressBookEntry } from "@metamask/address-book-controller";
+import type { ContactSyncingOptions } from "./types.mjs";
+export declare const ADDRESS_BOOK_CONTACTS_KEY = "contacts";
+export type SyncContactsWithUserStorageConfig = {
+    onContactSyncErroneousSituation?: (errorMessage: string, sentryContext?: Record<string, unknown>) => void;
+    onContactUpdated?: () => void;
+    onContactDeleted?: () => void;
+};
+/**
+ * Syncs contacts between local storage and user storage (remote).
+ *
+ * Handles the following syncing scenarios:
+ * 1. First Sync: When local contacts exist but there are no remote contacts, uploads all local contacts.
+ * 2. New Device Sync: Downloads remote contacts that don't exist locally (empty local address book).
+ * 3. Simple Merge: Ensures both sides (local & remote) have all contacts.
+ * 4. Contact Naming Conflicts: When same contact has different names, uses most recent by timestamp.
+ * 5. Local Updates: When a contact was updated locally, syncs changes to remote if local is newer.
+ * 6. Remote Updates: When a contact was updated remotely, applies changes locally if remote is newer.
+ * 7. Local Deletions: When a contact was deleted locally, marks it as deleted in remote storage.
+ * 8. Remote Deletions: When a contact was deleted remotely, applies deletion locally.
+ * 9. Concurrent Updates: Resolves conflicts using timestamps to determine the winner.
+ * 10. Restore After Delete: If a contact is modified after being deleted, restores it.
+ * 11. ChainId Differences: Treats same address on different chains as separate contacts.
+ *
+ * @param config - Parameters used for syncing callbacks
+ * @param options - Parameters used for syncing operations
+ */
+export declare function syncContactsWithUserStorage(config: SyncContactsWithUserStorageConfig, options: ContactSyncingOptions): Promise<void>;
+/**
+ * Updates a single contact in remote storage without performing a full sync
+ * This is used when a contact is updated locally to efficiently push changes to remote
+ *
+ * @param contact - The contact that was updated locally
+ * @param options - Parameters used for syncing operations
+ */
+export declare function updateContactInRemoteStorage(contact: AddressBookEntry, options: ContactSyncingOptions): Promise<void>;
+/**
+ * Marks a single contact as deleted in remote storage without performing a full sync
+ * This is used when a contact is deleted locally to efficiently push the deletion to remote
+ *
+ * @param contact - The contact that was deleted locally (contains at least address and chainId)
+ * @param options - Parameters used for syncing operations
+ */
+export declare function deleteContactInRemoteStorage(contact: AddressBookEntry, options: ContactSyncingOptions): Promise<void>;
+//# sourceMappingURL=controller-integration.d.mts.map

package/dist/controllers/user-storage/contact-syncing/controller-integration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-integration.d.mts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/controller-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,0CAA0C;AAG1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAgB;AAUrD,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAEpD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,+BAA+B,CAAC,EAAE,CAChC,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACpC,IAAI,CAAC;IACV,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAYF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,EACzC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAySf;AA8DD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}