@metamask-previews/profile-sync-controller 16.0.0-preview-510657d5 → 17.0.0-preview-d2bf8ff

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

@@ -1,299 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteContactInRemoteStorage = exports.updateContactInRemoteStorage = exports.syncContactsWithUserStorage = void 0;
-const sync_utils_1 = require("./sync-utils.cjs");
-const utils_1 = require("./utils.cjs");
-const utils_2 = require("./utils.cjs");
-const storage_schema_1 = require("../../../shared/storage-schema.cjs");
-/**
- * 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) {
-    if (!contact.address) {
-        throw new Error('Contact address is required to create storage key');
-    }
-    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: Handled by real-time event handlers (deleteContactInRemoteStorage) to prevent false positives.
- * 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 {
-        // Cannot perform sync, conditions not met
-        if (!(0, sync_utils_1.canPerformContactSyncing)(options)) {
-            return;
-        }
-        // 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) => !(0, utils_2.isContactBridgedFromAccounts)(contact))
-            .filter((contact) => contact.address && contact.chainId) || [];
-        // Get remote contacts from user storage API
-        const remoteContacts = await getRemoteContacts(options);
-        // SCENARIO 1: First Sync - No remote contacts but local contacts exist
-        if (!remoteContacts || remoteContacts.length === 0) {
-            if (localVisibleContacts.length > 0) {
-                await saveContactsToUserStorage(localVisibleContacts, options);
-            }
-            return;
-        }
-        // Filter remote contacts to exclude invalid ones
-        const validRemoteContacts = remoteContacts.filter((contact) => contact.address && contact.chainId);
-        // Prepare maps for efficient lookup
-        const localContactsMap = new Map();
-        const remoteContactsMap = new Map();
-        localVisibleContacts.forEach((contact) => {
-            const key = createContactKey(contact);
-            localContactsMap.set(key, contact);
-        });
-        validRemoteContacts.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 validRemoteContacts) {
-            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) {
-                    contactsToDeleteLocally.push(remoteContact);
-                }
-            }
-            else if (!localContact) {
-                // SCENARIO 2: New contact from remote - import to local
-                contactsToAddOrUpdateLocally.push(remoteContact);
-            }
-            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
-                        contactsToUpdateRemotely.push(localContact);
-                    }
-                    else {
-                        // Remote is newer - use remote version
-                        contactsToAddOrUpdateLocally.push(remoteContact);
-                    }
-                }
-                // Else: content is identical, no action needed
-            }
-        }
-        // 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
-                contactsToUpdateRemotely.push(localContact);
-            }
-        }
-        // Apply local deletions
-        for (const contact of contactsToDeleteLocally) {
-            try {
-                getMessenger().call('AddressBookController:delete', contact.chainId, contact.address);
-                if (onContactDeleted) {
-                    onContactDeleted();
-                }
-            }
-            catch (error) {
-                console.error('Error deleting contact:', error);
-            }
-        }
-        // Apply local additions/updates
-        for (const contact of contactsToAddOrUpdateLocally) {
-            if (!contact.deleted) {
-                try {
-                    getMessenger().call('AddressBookController:set', contact.address, contact.name || '', contact.chainId, contact.memo || '', contact.addressType);
-                    if (onContactUpdated) {
-                        onContactUpdated();
-                    }
-                }
-                catch (error) {
-                    console.error('Error updating contact:', error);
-                }
-            }
-        }
-        // Apply changes to remote storage
-        if (contactsToUpdateRemotely.length > 0) {
-            // Update existing remote contacts with new contacts
-            const updatedRemoteContacts = [...validRemoteContacts];
-            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);
-        }
-    }
-    catch (error) {
-        if (onContactSyncErroneousSituation) {
-            onContactSyncErroneousSituation('Error synchronizing contacts', {
-                error,
-            });
-            // Re-throw the error to be handled by the caller
-            throw 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 remoteContactsJsonArray = await getUserStorageControllerInstance().performGetStorageAllFeatureEntries(storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook);
-        if (!remoteContactsJsonArray || remoteContactsJsonArray.length === 0) {
-            return null;
-        }
-        // Parse each JSON entry and convert from UserStorageContactEntry to AddressBookEntry
-        const remoteStorageEntries = remoteContactsJsonArray.map((contactJson) => {
-            const entry = JSON.parse(contactJson);
-            return (0, utils_1.mapUserStorageEntryToAddressBookEntry)(entry);
-        });
-        return remoteStorageEntries;
-    }
-    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 and create key-value pairs
-    const storageEntries = contacts.map((contact) => {
-        const key = createContactKey(contact);
-        const storageEntry = (0, utils_1.mapAddressBookEntryToUserStorageEntry)(contact);
-        return [key, JSON.stringify(storageEntry)];
-    });
-    await getUserStorageControllerInstance().performBatchSetStorage(storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook, 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) ||
-        !contact.address ||
-        !contact.chainId) {
-        return;
-    }
-    const { getUserStorageControllerInstance } = options;
-    // 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
-    };
-    const key = createContactKey(contact);
-    const storageEntry = (0, utils_1.mapAddressBookEntryToUserStorageEntry)(updatedEntry);
-    // Save individual contact to remote storage
-    await getUserStorageControllerInstance().performSetStorage(`${storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`, JSON.stringify(storageEntry));
-}
-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) ||
-        !contact.address ||
-        !contact.chainId) {
-        return;
-    }
-    const { getUserStorageControllerInstance } = options;
-    const key = createContactKey(contact);
-    try {
-        // Try to get the existing contact first
-        const existingContactJson = await getUserStorageControllerInstance().performGetStorage(`${storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`);
-        if (existingContactJson) {
-            // Mark the existing contact as deleted
-            const existingStorageEntry = JSON.parse(existingContactJson);
-            const existingContact = (0, utils_1.mapUserStorageEntryToAddressBookEntry)(existingStorageEntry);
-            const now = Date.now();
-            const deletedContact = {
-                ...existingContact,
-                deleted: true,
-                deletedAt: now,
-                lastUpdatedAt: now,
-            };
-            const deletedStorageEntry = (0, utils_1.mapAddressBookEntryToUserStorageEntry)(deletedContact);
-            // Save the deleted contact back to storage
-            await getUserStorageControllerInstance().performSetStorage(`${storage_schema_1.USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`, JSON.stringify(deletedStorageEntry));
-        }
-    }
-    catch {
-        // If contact doesn't exist in remote storage, no need to mark as deleted
-        console.warn('Contact not found in remote storage for deletion:', key);
-    }
-}
-exports.deleteContactInRemoteStorage = deleteContactInRemoteStorage;
-//# sourceMappingURL=controller-integration.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"controller-integration.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/controller-integration.ts"],"names":[],"mappings":"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","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 { isContactBridgedFromAccounts } from './utils';\nimport { USER_STORAGE_FEATURE_NAMES } from '../../../shared/storage-schema';\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  if (!contact.address) {\n    throw new Error('Contact address is required to create storage key');\n  }\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: Handled by real-time event handlers (deleteContactInRemoteStorage) to prevent false positives.\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    // Cannot perform sync, conditions not met\n    if (!canPerformContactSyncing(options)) {\n      return;\n    }\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) => !isContactBridgedFromAccounts(contact))\n        .filter((contact) => contact.address && contact.chainId) || [];\n\n    // Get remote contacts from user storage API\n    const remoteContacts = await getRemoteContacts(options);\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        await saveContactsToUserStorage(localVisibleContacts, options);\n      }\n      return;\n    }\n\n    // Filter remote contacts to exclude invalid ones\n    const validRemoteContacts = remoteContacts.filter(\n      (contact) => contact.address && contact.chainId,\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    validRemoteContacts.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 validRemoteContacts) {\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          contactsToDeleteLocally.push(remoteContact);\n        }\n      } else if (!localContact) {\n        // SCENARIO 2: New contact from remote - import to local\n        contactsToAddOrUpdateLocally.push(remoteContact);\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            contactsToUpdateRemotely.push(localContact);\n          } else {\n            // Remote is newer - use remote version\n            contactsToAddOrUpdateLocally.push(remoteContact);\n          }\n        }\n\n        // Else: content is identical, no action needed\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        contactsToUpdateRemotely.push(localContact);\n      }\n    }\n\n    // Apply local deletions\n    for (const contact of contactsToDeleteLocally) {\n      try {\n        getMessenger().call(\n          'AddressBookController:delete',\n          contact.chainId,\n          contact.address,\n        );\n\n        if (onContactDeleted) {\n          onContactDeleted();\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          getMessenger().call(\n            'AddressBookController:set',\n            contact.address,\n            contact.name || '',\n            contact.chainId,\n            contact.memo || '',\n            contact.addressType,\n          );\n\n          if (onContactUpdated) {\n            onContactUpdated();\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      // Update existing remote contacts with new contacts\n      const updatedRemoteContacts = [...validRemoteContacts];\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  } catch (error) {\n    if (onContactSyncErroneousSituation) {\n      onContactSyncErroneousSituation('Error synchronizing contacts', {\n        error,\n      });\n\n      // Re-throw the error to be handled by the caller\n      throw error;\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 remoteContactsJsonArray =\n      await getUserStorageControllerInstance().performGetStorageAllFeatureEntries(\n        USER_STORAGE_FEATURE_NAMES.addressBook,\n      );\n\n    if (!remoteContactsJsonArray || remoteContactsJsonArray.length === 0) {\n      return null;\n    }\n\n    // Parse each JSON entry and convert from UserStorageContactEntry to AddressBookEntry\n    const remoteStorageEntries = remoteContactsJsonArray.map((contactJson) => {\n      const entry = JSON.parse(contactJson) as UserStorageContactEntry;\n      return mapUserStorageEntryToAddressBookEntry(entry);\n    });\n\n    return remoteStorageEntries;\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 and create key-value pairs\n  const storageEntries: [string, string][] = contacts.map((contact) => {\n    const key = createContactKey(contact);\n    const storageEntry = mapAddressBookEntryToUserStorageEntry(contact);\n    return [key, JSON.stringify(storageEntry)];\n  });\n\n  await getUserStorageControllerInstance().performBatchSetStorage(\n    USER_STORAGE_FEATURE_NAMES.addressBook,\n    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 (\n    !canPerformContactSyncing(options) ||\n    !contact.address ||\n    !contact.chainId\n  ) {\n    return;\n  }\n\n  const { getUserStorageControllerInstance } = options;\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  const key = createContactKey(contact);\n  const storageEntry = mapAddressBookEntryToUserStorageEntry(updatedEntry);\n\n  // Save individual contact to remote storage\n  await getUserStorageControllerInstance().performSetStorage(\n    `${USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`,\n    JSON.stringify(storageEntry),\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 (\n    !canPerformContactSyncing(options) ||\n    !contact.address ||\n    !contact.chainId\n  ) {\n    return;\n  }\n\n  const { getUserStorageControllerInstance } = options;\n  const key = createContactKey(contact);\n\n  try {\n    // Try to get the existing contact first\n    const existingContactJson =\n      await getUserStorageControllerInstance().performGetStorage(\n        `${USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`,\n      );\n\n    if (existingContactJson) {\n      // Mark the existing contact as deleted\n      const existingStorageEntry = JSON.parse(\n        existingContactJson,\n      ) as UserStorageContactEntry;\n      const existingContact =\n        mapUserStorageEntryToAddressBookEntry(existingStorageEntry);\n\n      const now = Date.now();\n      const deletedContact = {\n        ...existingContact,\n        deleted: true,\n        deletedAt: now,\n        lastUpdatedAt: now,\n      } as SyncAddressBookEntry;\n\n      const deletedStorageEntry =\n        mapAddressBookEntryToUserStorageEntry(deletedContact);\n\n      // Save the deleted contact back to storage\n      await getUserStorageControllerInstance().performSetStorage(\n        `${USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`,\n        JSON.stringify(deletedStorageEntry),\n      );\n    }\n  } catch {\n    // If contact doesn't exist in remote storage, no need to mark as deleted\n    console.warn('Contact not found in remote storage for deletion:', key);\n  }\n}\n"]}

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

@@ -1,44 +0,0 @@
-import type { AddressBookEntry } from "@metamask/address-book-controller";
-import type { ContactSyncingOptions } from "./types.cjs";
-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: Handled by real-time event handlers (deleteContactInRemoteStorage) to prevent false positives.
- * 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

@@ -1 +0,0 @@
-{"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,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;AAeF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,EACzC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiMf;AAgED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

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

@@ -1,44 +0,0 @@
-import type { AddressBookEntry } from "@metamask/address-book-controller";
-import type { ContactSyncingOptions } from "./types.mjs";
-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: Handled by real-time event handlers (deleteContactInRemoteStorage) to prevent false positives.
- * 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

@@ -1 +0,0 @@
-{"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,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;AAeF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,EACzC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiMf;AAgED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgDf"}