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

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

@@ -1,293 +0,0 @@
-import { canPerformContactSyncing } from "./sync-utils.mjs";
-import { mapAddressBookEntryToUserStorageEntry, mapUserStorageEntryToAddressBookEntry } from "./utils.mjs";
-import { isContactBridgedFromAccounts } from "./utils.mjs";
-import { USER_STORAGE_FEATURE_NAMES } from "../../../shared/storage-schema.mjs";
-/**
- * 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
- */
-export async function syncContactsWithUserStorage(config, options) {
-    const { getMessenger, getUserStorageControllerInstance } = options;
-    const { onContactSyncErroneousSituation, onContactUpdated, onContactDeleted, } = config;
-    try {
-        // Cannot perform sync, conditions not met
-        if (!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) => !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);
-    }
-}
-/**
- * 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(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 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 = mapAddressBookEntryToUserStorageEntry(contact);
-        return [key, JSON.stringify(storageEntry)];
-    });
-    await getUserStorageControllerInstance().performBatchSetStorage(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
- */
-export async function updateContactInRemoteStorage(contact, options) {
-    if (!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 = mapAddressBookEntryToUserStorageEntry(updatedEntry);
-    // Save individual contact to remote storage
-    await getUserStorageControllerInstance().performSetStorage(`${USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`, JSON.stringify(storageEntry));
-}
-/**
- * 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 async function deleteContactInRemoteStorage(contact, options) {
-    if (!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(`${USER_STORAGE_FEATURE_NAMES.addressBook}.${key}`);
-        if (existingContactJson) {
-            // Mark the existing contact as deleted
-            const existingStorageEntry = JSON.parse(existingContactJson);
-            const existingContact = mapUserStorageEntryToAddressBookEntry(existingStorageEntry);
-            const now = Date.now();
-            const deletedContact = {
-                ...existingContact,
-                deleted: true,
-                deletedAt: now,
-                lastUpdatedAt: now,
-            };
-            const deletedStorageEntry = mapAddressBookEntryToUserStorageEntry(deletedContact);
-            // Save the deleted contact back to storage
-            await getUserStorageControllerInstance().performSetStorage(`${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);
-    }
-}
-//# sourceMappingURL=controller-integration.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"controller-integration.mjs","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/setup-subscriptions.cjs

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupContactSyncingSubscriptions = void 0;
-const controller_integration_1 = require("./controller-integration.cjs");
-const sync_utils_1 = require("./sync-utils.cjs");
-const utils_1 = require("./utils.cjs");
-/**
- * Initialize and setup events to listen to for contact syncing
- *
- * @param options - parameters used for initializing and enabling contact syncing
- */
-function setupContactSyncingSubscriptions(options) {
-    const { getMessenger } = options;
-    // Listen for contact updates and immediately sync the individual contact
-    getMessenger().subscribe('AddressBookController:contactUpdated', (contactEntry) => {
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        (async () => {
-            if (!(0, sync_utils_1.canPerformContactSyncing)(options) ||
-                (0, utils_1.isContactBridgedFromAccounts)(contactEntry)) {
-                return;
-            }
-            try {
-                // Use the targeted method to update just this contact
-                await (0, controller_integration_1.updateContactInRemoteStorage)(contactEntry, options);
-            }
-            catch (error) {
-                console.error('Error updating contact in remote storage:', error);
-            }
-        })();
-    });
-    // Listen for contact deletions and immediately sync the individual deletion
-    getMessenger().subscribe('AddressBookController:contactDeleted', (contactEntry) => {
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        (async () => {
-            if (!(0, sync_utils_1.canPerformContactSyncing)(options) ||
-                (0, utils_1.isContactBridgedFromAccounts)(contactEntry)) {
-                return;
-            }
-            try {
-                // Use the targeted method to delete just this contact
-                await (0, controller_integration_1.deleteContactInRemoteStorage)(contactEntry, options);
-            }
-            catch (error) {
-                console.error('Error deleting contact from remote storage:', error);
-            }
-        })();
-    });
-}
-exports.setupContactSyncingSubscriptions = setupContactSyncingSubscriptions;
-//# sourceMappingURL=setup-subscriptions.cjs.map

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-subscriptions.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/setup-subscriptions.ts"],"names":[],"mappings":";;;AAEA,yEAGkC;AAClC,iDAAwD;AAExD,uCAAuD;AAEvD;;;;GAIG;AACH,SAAgB,gCAAgC,CAC9C,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjC,yEAAyE;IACzE,YAAY,EAAE,CAAC,SAAS,CACtB,sCAAsC,EACtC,CAAC,YAA8B,EAAE,EAAE;QACjC,mEAAmE;QACnE,CAAC,KAAK,IAAI,EAAE;YACV,IACE,CAAC,IAAA,qCAAwB,EAAC,OAAO,CAAC;gBAClC,IAAA,oCAA4B,EAAC,YAAY,CAAC,EAC1C;gBACA,OAAO;aACR;YAED,IAAI;gBACF,sDAAsD;gBACtD,MAAM,IAAA,qDAA4B,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;aAC3D;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;aACnE;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,YAAY,EAAE,CAAC,SAAS,CACtB,sCAAsC,EACtC,CAAC,YAA8B,EAAE,EAAE;QACjC,mEAAmE;QACnE,CAAC,KAAK,IAAI,EAAE;YACV,IACE,CAAC,IAAA,qCAAwB,EAAC,OAAO,CAAC;gBAClC,IAAA,oCAA4B,EAAC,YAAY,CAAC,EAC1C;gBACA,OAAO;aACR;YAED,IAAI;gBACF,sDAAsD;gBACtD,MAAM,IAAA,qDAA4B,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;aAC3D;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;aACrE;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CACF,CAAC;AACJ,CAAC;AAlDD,4EAkDC","sourcesContent":["import type { AddressBookEntry } from '@metamask/address-book-controller';\n\nimport {\n  updateContactInRemoteStorage,\n  deleteContactInRemoteStorage,\n} from './controller-integration';\nimport { canPerformContactSyncing } from './sync-utils';\nimport type { ContactSyncingOptions } from './types';\nimport { isContactBridgedFromAccounts } from './utils';\n\n/**\n * Initialize and setup events to listen to for contact syncing\n *\n * @param options - parameters used for initializing and enabling contact syncing\n */\nexport function setupContactSyncingSubscriptions(\n  options: ContactSyncingOptions,\n): void {\n  const { getMessenger } = options;\n\n  // Listen for contact updates and immediately sync the individual contact\n  getMessenger().subscribe(\n    'AddressBookController:contactUpdated',\n    (contactEntry: AddressBookEntry) => {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      (async () => {\n        if (\n          !canPerformContactSyncing(options) ||\n          isContactBridgedFromAccounts(contactEntry)\n        ) {\n          return;\n        }\n\n        try {\n          // Use the targeted method to update just this contact\n          await updateContactInRemoteStorage(contactEntry, options);\n        } catch (error) {\n          console.error('Error updating contact in remote storage:', error);\n        }\n      })();\n    },\n  );\n\n  // Listen for contact deletions and immediately sync the individual deletion\n  getMessenger().subscribe(\n    'AddressBookController:contactDeleted',\n    (contactEntry: AddressBookEntry) => {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      (async () => {\n        if (\n          !canPerformContactSyncing(options) ||\n          isContactBridgedFromAccounts(contactEntry)\n        ) {\n          return;\n        }\n\n        try {\n          // Use the targeted method to delete just this contact\n          await deleteContactInRemoteStorage(contactEntry, options);\n        } catch (error) {\n          console.error('Error deleting contact from remote storage:', error);\n        }\n      })();\n    },\n  );\n}\n"]}

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.d.cts

@@ -1,8 +0,0 @@
-import type { ContactSyncingOptions } from "./types.cjs";
-/**
- * Initialize and setup events to listen to for contact syncing
- *
- * @param options - parameters used for initializing and enabling contact syncing
- */
-export declare function setupContactSyncingSubscriptions(options: ContactSyncingOptions): void;
-//# sourceMappingURL=setup-subscriptions.d.cts.map

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-subscriptions.d.cts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/setup-subscriptions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAgB;AAGrD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAgDN"}

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.d.mts

@@ -1,8 +0,0 @@
-import type { ContactSyncingOptions } from "./types.mjs";
-/**
- * Initialize and setup events to listen to for contact syncing
- *
- * @param options - parameters used for initializing and enabling contact syncing
- */
-export declare function setupContactSyncingSubscriptions(options: ContactSyncingOptions): void;
-//# sourceMappingURL=setup-subscriptions.d.mts.map

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-subscriptions.d.mts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/setup-subscriptions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAgB;AAGrD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAgDN"}

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.mjs

@@ -1,46 +0,0 @@
-import { updateContactInRemoteStorage, deleteContactInRemoteStorage } from "./controller-integration.mjs";
-import { canPerformContactSyncing } from "./sync-utils.mjs";
-import { isContactBridgedFromAccounts } from "./utils.mjs";
-/**
- * Initialize and setup events to listen to for contact syncing
- *
- * @param options - parameters used for initializing and enabling contact syncing
- */
-export function setupContactSyncingSubscriptions(options) {
-    const { getMessenger } = options;
-    // Listen for contact updates and immediately sync the individual contact
-    getMessenger().subscribe('AddressBookController:contactUpdated', (contactEntry) => {
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        (async () => {
-            if (!canPerformContactSyncing(options) ||
-                isContactBridgedFromAccounts(contactEntry)) {
-                return;
-            }
-            try {
-                // Use the targeted method to update just this contact
-                await updateContactInRemoteStorage(contactEntry, options);
-            }
-            catch (error) {
-                console.error('Error updating contact in remote storage:', error);
-            }
-        })();
-    });
-    // Listen for contact deletions and immediately sync the individual deletion
-    getMessenger().subscribe('AddressBookController:contactDeleted', (contactEntry) => {
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        (async () => {
-            if (!canPerformContactSyncing(options) ||
-                isContactBridgedFromAccounts(contactEntry)) {
-                return;
-            }
-            try {
-                // Use the targeted method to delete just this contact
-                await deleteContactInRemoteStorage(contactEntry, options);
-            }
-            catch (error) {
-                console.error('Error deleting contact from remote storage:', error);
-            }
-        })();
-    });
-}
-//# sourceMappingURL=setup-subscriptions.mjs.map

package/dist/controllers/user-storage/contact-syncing/setup-subscriptions.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-subscriptions.mjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/setup-subscriptions.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC7B,qCAAiC;AAClC,OAAO,EAAE,wBAAwB,EAAE,yBAAqB;AAExD,OAAO,EAAE,4BAA4B,EAAE,oBAAgB;AAEvD;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjC,yEAAyE;IACzE,YAAY,EAAE,CAAC,SAAS,CACtB,sCAAsC,EACtC,CAAC,YAA8B,EAAE,EAAE;QACjC,mEAAmE;QACnE,CAAC,KAAK,IAAI,EAAE;YACV,IACE,CAAC,wBAAwB,CAAC,OAAO,CAAC;gBAClC,4BAA4B,CAAC,YAAY,CAAC,EAC1C;gBACA,OAAO;aACR;YAED,IAAI;gBACF,sDAAsD;gBACtD,MAAM,4BAA4B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;aAC3D;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;aACnE;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CACF,CAAC;IAEF,4EAA4E;IAC5E,YAAY,EAAE,CAAC,SAAS,CACtB,sCAAsC,EACtC,CAAC,YAA8B,EAAE,EAAE;QACjC,mEAAmE;QACnE,CAAC,KAAK,IAAI,EAAE;YACV,IACE,CAAC,wBAAwB,CAAC,OAAO,CAAC;gBAClC,4BAA4B,CAAC,YAAY,CAAC,EAC1C;gBACA,OAAO;aACR;YAED,IAAI;gBACF,sDAAsD;gBACtD,MAAM,4BAA4B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;aAC3D;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;aACrE;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AddressBookEntry } from '@metamask/address-book-controller';\n\nimport {\n  updateContactInRemoteStorage,\n  deleteContactInRemoteStorage,\n} from './controller-integration';\nimport { canPerformContactSyncing } from './sync-utils';\nimport type { ContactSyncingOptions } from './types';\nimport { isContactBridgedFromAccounts } from './utils';\n\n/**\n * Initialize and setup events to listen to for contact syncing\n *\n * @param options - parameters used for initializing and enabling contact syncing\n */\nexport function setupContactSyncingSubscriptions(\n  options: ContactSyncingOptions,\n): void {\n  const { getMessenger } = options;\n\n  // Listen for contact updates and immediately sync the individual contact\n  getMessenger().subscribe(\n    'AddressBookController:contactUpdated',\n    (contactEntry: AddressBookEntry) => {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      (async () => {\n        if (\n          !canPerformContactSyncing(options) ||\n          isContactBridgedFromAccounts(contactEntry)\n        ) {\n          return;\n        }\n\n        try {\n          // Use the targeted method to update just this contact\n          await updateContactInRemoteStorage(contactEntry, options);\n        } catch (error) {\n          console.error('Error updating contact in remote storage:', error);\n        }\n      })();\n    },\n  );\n\n  // Listen for contact deletions and immediately sync the individual deletion\n  getMessenger().subscribe(\n    'AddressBookController:contactDeleted',\n    (contactEntry: AddressBookEntry) => {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      (async () => {\n        if (\n          !canPerformContactSyncing(options) ||\n          isContactBridgedFromAccounts(contactEntry)\n        ) {\n          return;\n        }\n\n        try {\n          // Use the targeted method to delete just this contact\n          await deleteContactInRemoteStorage(contactEntry, options);\n        } catch (error) {\n          console.error('Error deleting contact from remote storage:', error);\n        }\n      })();\n    },\n  );\n}\n"]}

package/dist/controllers/user-storage/contact-syncing/sync-utils.cjs

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.canPerformContactSyncing = void 0;
-/**
- * Check if we can perform contact syncing
- *
- * @param options - parameters used for checking if we can perform contact syncing
- * @returns whether we can perform contact syncing
- */
-function canPerformContactSyncing(options) {
-    const { getMessenger, getUserStorageControllerInstance } = options;
-    const { isBackupAndSyncEnabled, isContactSyncingEnabled, isContactSyncingInProgress, } = getUserStorageControllerInstance().state;
-    const isAuthEnabled = getMessenger().call('AuthenticationController:isSignedIn');
-    if (!isBackupAndSyncEnabled ||
-        !isContactSyncingEnabled ||
-        isContactSyncingInProgress ||
-        !isAuthEnabled) {
-        return false;
-    }
-    return true;
-}
-exports.canPerformContactSyncing = canPerformContactSyncing;
-//# sourceMappingURL=sync-utils.cjs.map

package/dist/controllers/user-storage/contact-syncing/sync-utils.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-utils.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/sync-utils.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,gCAAgC,EAAE,GAAG,OAAO,CAAC;IAEnE,MAAM,EACJ,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,GAAG,gCAAgC,EAAE,CAAC,KAAK,CAAC;IAC7C,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC,IAAI,CACvC,qCAAqC,CACtC,CAAC;IAEF,IACE,CAAC,sBAAsB;QACvB,CAAC,uBAAuB;QACxB,0BAA0B;QAC1B,CAAC,aAAa,EACd;QACA,OAAO,KAAK,CAAC;KACd;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAxBD,4DAwBC","sourcesContent":["import type { ContactSyncingOptions } from './types';\n\n/**\n * Check if we can perform contact syncing\n *\n * @param options - parameters used for checking if we can perform contact syncing\n * @returns whether we can perform contact syncing\n */\nexport function canPerformContactSyncing(\n  options: ContactSyncingOptions,\n): boolean {\n  const { getMessenger, getUserStorageControllerInstance } = options;\n\n  const {\n    isBackupAndSyncEnabled,\n    isContactSyncingEnabled,\n    isContactSyncingInProgress,\n  } = getUserStorageControllerInstance().state;\n  const isAuthEnabled = getMessenger().call(\n    'AuthenticationController:isSignedIn',\n  );\n\n  if (\n    !isBackupAndSyncEnabled ||\n    !isContactSyncingEnabled ||\n    isContactSyncingInProgress ||\n    !isAuthEnabled\n  ) {\n    return false;\n  }\n\n  return true;\n}\n"]}

package/dist/controllers/user-storage/contact-syncing/sync-utils.d.cts

@@ -1,9 +0,0 @@
-import type { ContactSyncingOptions } from "./types.cjs";
-/**
- * Check if we can perform contact syncing
- *
- * @param options - parameters used for checking if we can perform contact syncing
- * @returns whether we can perform contact syncing
- */
-export declare function canPerformContactSyncing(options: ContactSyncingOptions): boolean;
-//# sourceMappingURL=sync-utils.d.cts.map

package/dist/controllers/user-storage/contact-syncing/sync-utils.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-utils.d.cts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/sync-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAgB;AAErD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAsBT"}

package/dist/controllers/user-storage/contact-syncing/sync-utils.d.mts

@@ -1,9 +0,0 @@
-import type { ContactSyncingOptions } from "./types.mjs";
-/**
- * Check if we can perform contact syncing
- *
- * @param options - parameters used for checking if we can perform contact syncing
- * @returns whether we can perform contact syncing
- */
-export declare function canPerformContactSyncing(options: ContactSyncingOptions): boolean;
-//# sourceMappingURL=sync-utils.d.mts.map

package/dist/controllers/user-storage/contact-syncing/sync-utils.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-utils.d.mts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/sync-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAgB;AAErD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAsBT"}

package/dist/controllers/user-storage/contact-syncing/sync-utils.mjs

@@ -1,19 +0,0 @@
-/**
- * Check if we can perform contact syncing
- *
- * @param options - parameters used for checking if we can perform contact syncing
- * @returns whether we can perform contact syncing
- */
-export function canPerformContactSyncing(options) {
-    const { getMessenger, getUserStorageControllerInstance } = options;
-    const { isBackupAndSyncEnabled, isContactSyncingEnabled, isContactSyncingInProgress, } = getUserStorageControllerInstance().state;
-    const isAuthEnabled = getMessenger().call('AuthenticationController:isSignedIn');
-    if (!isBackupAndSyncEnabled ||
-        !isContactSyncingEnabled ||
-        isContactSyncingInProgress ||
-        !isAuthEnabled) {
-        return false;
-    }
-    return true;
-}
-//# sourceMappingURL=sync-utils.mjs.map

package/dist/controllers/user-storage/contact-syncing/sync-utils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-utils.mjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/sync-utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,gCAAgC,EAAE,GAAG,OAAO,CAAC;IAEnE,MAAM,EACJ,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,GAAG,gCAAgC,EAAE,CAAC,KAAK,CAAC;IAC7C,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC,IAAI,CACvC,qCAAqC,CACtC,CAAC;IAEF,IACE,CAAC,sBAAsB;QACvB,CAAC,uBAAuB;QACxB,0BAA0B;QAC1B,CAAC,aAAa,EACd;QACA,OAAO,KAAK,CAAC;KACd;IAED,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { ContactSyncingOptions } from './types';\n\n/**\n * Check if we can perform contact syncing\n *\n * @param options - parameters used for checking if we can perform contact syncing\n * @returns whether we can perform contact syncing\n */\nexport function canPerformContactSyncing(\n  options: ContactSyncingOptions,\n): boolean {\n  const { getMessenger, getUserStorageControllerInstance } = options;\n\n  const {\n    isBackupAndSyncEnabled,\n    isContactSyncingEnabled,\n    isContactSyncingInProgress,\n  } = getUserStorageControllerInstance().state;\n  const isAuthEnabled = getMessenger().call(\n    'AuthenticationController:isSignedIn',\n  );\n\n  if (\n    !isBackupAndSyncEnabled ||\n    !isContactSyncingEnabled ||\n    isContactSyncingInProgress ||\n    !isAuthEnabled\n  ) {\n    return false;\n  }\n\n  return true;\n}\n"]}

package/dist/controllers/user-storage/contact-syncing/types.cjs

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Hex } from '@metamask/utils';\n\nimport type {\n  USER_STORAGE_VERSION_KEY,\n  USER_STORAGE_VERSION,\n} from './constants';\nimport type { UserStorageControllerMessenger } from '../UserStorageController';\nimport type UserStorageController from '../UserStorageController';\n\nexport type UserStorageContactEntry = {\n  /**\n   * The Version 'v' of the User Storage.\n   * NOTE - will allow us to support upgrade/downgrades in the future\n   */\n  [USER_STORAGE_VERSION_KEY]: typeof USER_STORAGE_VERSION;\n  /** the address 'a' of the contact */\n  a: string;\n  /** the name 'n' of the contact */\n  n: string;\n  /** the chainId 'c' of the contact */\n  c: Hex;\n  /** the memo 'm' of the contact (optional) */\n  m?: string;\n  /** the addressType 't' of the contact (optional) */\n  t?: string;\n  /** the lastUpdatedAt timestamp 'lu' of the contact */\n  lu?: number;\n  /** the deleted flag 'd' of the contact (optional) */\n  d?: boolean;\n  /** the deletedAt timestamp 'dt' of the contact (optional) */\n  dt?: number;\n};\n\n/**\n * Options for contact syncing operations\n */\nexport type ContactSyncingOptions = {\n  getUserStorageControllerInstance: () => UserStorageController;\n  getMessenger: () => UserStorageControllerMessenger;\n};\n"]}

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

@@ -1,35 +0,0 @@
-import type { Hex } from "@metamask/utils";
-import type { USER_STORAGE_VERSION_KEY, USER_STORAGE_VERSION } from "./constants.cjs";
-import type { UserStorageControllerMessenger } from "../UserStorageController.cjs";
-import type UserStorageController from "../UserStorageController.cjs";
-export type UserStorageContactEntry = {
-    /**
-     * The Version 'v' of the User Storage.
-     * NOTE - will allow us to support upgrade/downgrades in the future
-     */
-    [USER_STORAGE_VERSION_KEY]: typeof USER_STORAGE_VERSION;
-    /** the address 'a' of the contact */
-    a: string;
-    /** the name 'n' of the contact */
-    n: string;
-    /** the chainId 'c' of the contact */
-    c: Hex;
-    /** the memo 'm' of the contact (optional) */
-    m?: string;
-    /** the addressType 't' of the contact (optional) */
-    t?: string;
-    /** the lastUpdatedAt timestamp 'lu' of the contact */
-    lu?: number;
-    /** the deleted flag 'd' of the contact (optional) */
-    d?: boolean;
-    /** the deletedAt timestamp 'dt' of the contact (optional) */
-    dt?: number;
-};
-/**
- * Options for contact syncing operations
- */
-export type ContactSyncingOptions = {
-    getUserStorageControllerInstance: () => UserStorageController;
-    getMessenger: () => UserStorageControllerMessenger;
-};
-//# sourceMappingURL=types.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/contact-syncing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACrB,wBAAoB;AACrB,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAiC;AAC/E,OAAO,KAAK,qBAAqB,qCAAiC;AAElE,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,CAAC,wBAAwB,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACxD,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,kCAAkC;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,CAAC,EAAE,GAAG,CAAC;IACP,6CAA6C;IAC7C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,6DAA6D;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;IAC9D,YAAY,EAAE,MAAM,8BAA8B,CAAC;CACpD,CAAC"}