@metamask-previews/profile-sync-controller 20.0.0-preview-988fbb56 → 20.0.0-preview-92a09963

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

@@ -1 +1 @@
-{"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';\nimport { TraceName } from '../constants/traces';\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 * @returns Promise that resolves when contact synchronization is complete\n */\nexport async function syncContactsWithUserStorage(\n  config: SyncContactsWithUserStorageConfig,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { getMessenger, getUserStorageControllerInstance, trace } = options;\n  const {\n    onContactSyncErroneousSituation,\n    onContactUpdated,\n    onContactDeleted,\n  } = config;\n\n  // Cannot perform sync, conditions not met\n  if (!canPerformContactSyncing(options)) {\n    return;\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(\n        (contact) => contact.address && contact.chainId && contact.name?.trim(),\n      ) || [];\n\n  // Get remote contacts from user storage API\n  const remoteContacts = await getRemoteContacts(options);\n\n  // Filter remote contacts to exclude invalid ones (or empty array if no remote contacts)\n  const validRemoteContacts =\n    remoteContacts?.filter(\n      (contact) => contact.address && contact.chainId && contact.name?.trim(),\n    ) || [];\n\n  const performSync = async () => {\n    try {\n      // Activate sync semaphore to prevent event loops\n      await getUserStorageControllerInstance().setIsContactSyncingInProgress(\n        true,\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.deletedAt) {\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 1, 3 & 5: Process local contacts not in remote - handles first sync and new local contacts\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 or first sync - add to remote\n          contactsToUpdateRemotely.push(localContact);\n        }\n      }\n\n      // Apply local deletions\n      // Note: Individual errors are intentionally NOT caught here to ensure they reach Sentry\n      // for debugging. Previous versions silently suppressed these errors which made\n      // troubleshooting contact sync issues difficult.\n      for (const contact of contactsToDeleteLocally) {\n        getMessenger().call(\n          'AddressBookController:delete',\n          contact.chainId,\n          contact.address,\n        );\n\n        if (onContactDeleted) {\n          onContactDeleted();\n        }\n      }\n\n      // Apply local additions/updates\n      // Note: Individual errors are intentionally NOT caught here to ensure they reach Sentry\n      // for debugging. Previous versions silently suppressed these errors which made\n      // troubleshooting contact sync issues difficult.\n      for (const contact of contactsToAddOrUpdateLocally) {\n        if (!contact.deletedAt) {\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        }\n      }\n\n      // Apply changes to remote storage\n      if (contactsToUpdateRemotely.length > 0) {\n        const updatedRemoteContacts: Record<string, SyncAddressBookEntry> = {};\n        for (const localContact of contactsToUpdateRemotely) {\n          const key = createContactKey(localContact);\n          updatedRemoteContacts[key] = {\n            ...remoteContactsMap.get(key), // Start with an existing remote contact if it exists\n            ...localContact, // override with local changes\n            lastUpdatedAt: Date.now(), // mark as updated\n          };\n        }\n        // Save updated contacts to remote storage\n        await saveContactsToUserStorage(\n          Object.values(updatedRemoteContacts),\n          options,\n        );\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  if (trace) {\n    // Gather pre-sync metrics for performance analysis\n    const initialLocalContacts = localVisibleContacts;\n    const initialValidRemoteContacts = validRemoteContacts;\n\n    await trace(\n      {\n        name: TraceName.ContactSyncFull,\n        data: {\n          localContactCount: initialLocalContacts.length,\n          remoteContactCount: initialValidRemoteContacts.length,\n          isFirstSync:\n            initialValidRemoteContacts.length === 0 &&\n            initialLocalContacts.length > 0,\n          isNewDeviceSync:\n            initialLocalContacts.length === 0 &&\n            initialValidRemoteContacts.length > 0,\n          isRegularSync:\n            initialLocalContacts.length > 0 &&\n            initialValidRemoteContacts.length > 0,\n          hasDataToSync:\n            initialLocalContacts.length > 0 ||\n            initialValidRemoteContacts.length > 0,\n          expectedWorkload:\n            initialLocalContacts.length + initialValidRemoteContacts.length,\n        },\n      },\n      performSync,\n    );\n\n    return;\n  }\n\n  await performSync();\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 * @returns Promise that resolves when contacts are saved\n */\nasync function saveContactsToUserStorage(\n  contacts: AddressBookEntry[],\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { getUserStorageControllerInstance, trace } = options;\n\n  const saveContacts = async () => {\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  return trace\n    ? await trace(\n        {\n          name: TraceName.ContactSyncSaveBatch,\n          data: {\n            contactCount: contacts.length,\n            // Performance scaling indicators\n            hasBatchOperations: contacts.length > 1,\n            chainCount: new Set(contacts.map((c) => c.chainId)).size,\n            hasMemosCount: contacts.filter((c) => c.memo?.length).length,\n          },\n        },\n        saveContacts,\n      )\n    : await saveContacts();\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 * @returns Promise that resolves when the contact is updated\n */\nexport async function updateContactInRemoteStorage(\n  contact: AddressBookEntry,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { trace } = options;\n\n  const updateContact = async () => {\n    if (\n      !canPerformContactSyncing(options) ||\n      !contact.address ||\n      !contact.chainId ||\n      !contact.name?.trim()\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    } 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  if (trace) {\n    return await trace(\n      {\n        name: TraceName.ContactSyncUpdateRemote,\n        data: {\n          chainId: contact.chainId,\n          // Performance indicators\n          hasTimestamp: Boolean(contact.lastUpdatedAt),\n          hasMemo: Boolean(contact.memo?.length),\n          isUpdate: Boolean(contact.lastUpdatedAt), // vs new contact\n        },\n      },\n      updateContact,\n    );\n  }\n\n  return await updateContact();\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 * @returns Promise that resolves when the contact is marked as deleted\n */\nexport async function deleteContactInRemoteStorage(\n  contact: AddressBookEntry,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { trace } = options;\n  const deleteContact = async () => {\n    if (\n      !canPerformContactSyncing(options) ||\n      !contact.address ||\n      !contact.chainId ||\n      !contact.name?.trim()\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          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\n  return trace\n    ? await trace({ name: TraceName.ContactSyncDeleteRemote }, deleteContact)\n    : await deleteContact();\n}\n"]}
+{"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';\nimport { TraceName } from '../constants';\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 * @returns Promise that resolves when contact synchronization is complete\n */\nexport async function syncContactsWithUserStorage(\n  config: SyncContactsWithUserStorageConfig,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { getMessenger, getUserStorageControllerInstance, trace } = options;\n  const {\n    onContactSyncErroneousSituation,\n    onContactUpdated,\n    onContactDeleted,\n  } = config;\n\n  // Cannot perform sync, conditions not met\n  if (!canPerformContactSyncing(options)) {\n    return;\n  }\n\n  // NOTE: Pre-sync operations (canPerformContactSyncing, AddressBookController:list, getRemoteContacts)\n  // are intentionally outside try-catch to let errors bubble up to Sentry for better debugging.\n  // Only \"erroneous situation\" errors during sync logic itself should be caught.\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(\n        (contact) => contact.address && contact.chainId && contact.name?.trim(),\n      ) || [];\n\n  // Get remote contacts from user storage API\n  const remoteContacts = await getRemoteContacts(options);\n\n  // Filter remote contacts to exclude invalid ones (or empty array if no remote contacts)\n  const validRemoteContacts =\n    remoteContacts?.filter(\n      (contact) => contact.address && contact.chainId && contact.name?.trim(),\n    ) || [];\n\n  const performSync = async () => {\n    try {\n      // Activate sync semaphore to prevent event loops\n      await getUserStorageControllerInstance().setIsContactSyncingInProgress(\n        true,\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.deletedAt) {\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 1, 3 & 5: Process local contacts not in remote - handles first sync and new local contacts\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 or first sync - add to remote\n          contactsToUpdateRemotely.push(localContact);\n        }\n      }\n\n      // Apply local deletions\n      // Note: Individual errors are intentionally NOT caught here to ensure they reach Sentry\n      // for debugging. Previous versions silently suppressed these errors which made\n      // troubleshooting contact sync issues difficult.\n      for (const contact of contactsToDeleteLocally) {\n        getMessenger().call(\n          'AddressBookController:delete',\n          contact.chainId,\n          contact.address,\n        );\n\n        if (onContactDeleted) {\n          onContactDeleted();\n        }\n      }\n\n      // Apply local additions/updates\n      // Note: Individual errors are intentionally NOT caught here to ensure they reach Sentry\n      // for debugging. Previous versions silently suppressed these errors which made\n      // troubleshooting contact sync issues difficult.\n      for (const contact of contactsToAddOrUpdateLocally) {\n        if (!contact.deletedAt) {\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        }\n      }\n\n      // Apply changes to remote storage\n      if (contactsToUpdateRemotely.length > 0) {\n        const updatedRemoteContacts: Record<string, SyncAddressBookEntry> = {};\n        for (const localContact of contactsToUpdateRemotely) {\n          const key = createContactKey(localContact);\n          updatedRemoteContacts[key] = {\n            ...remoteContactsMap.get(key), // Start with an existing remote contact if it exists\n            ...localContact, // override with local changes\n            lastUpdatedAt: Date.now(), // mark as updated\n          };\n        }\n        // Save updated contacts to remote storage\n        await saveContactsToUserStorage(\n          Object.values(updatedRemoteContacts),\n          options,\n        );\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  if (trace) {\n    // Gather pre-sync metrics for performance analysis\n    const initialLocalContacts = localVisibleContacts;\n    const initialValidRemoteContacts = validRemoteContacts;\n\n    await trace(\n      {\n        name: TraceName.ContactSyncFull,\n        data: {\n          localContactCount: initialLocalContacts.length,\n          remoteContactCount: initialValidRemoteContacts.length,\n          isFirstSync:\n            initialValidRemoteContacts.length === 0 &&\n            initialLocalContacts.length > 0,\n          isNewDeviceSync:\n            initialLocalContacts.length === 0 &&\n            initialValidRemoteContacts.length > 0,\n          isRegularSync:\n            initialLocalContacts.length > 0 &&\n            initialValidRemoteContacts.length > 0,\n          hasDataToSync:\n            initialLocalContacts.length > 0 ||\n            initialValidRemoteContacts.length > 0,\n          expectedWorkload:\n            initialLocalContacts.length + initialValidRemoteContacts.length,\n        },\n      },\n      performSync,\n    );\n\n    return;\n  }\n\n  await performSync();\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 * @returns Promise that resolves when contacts are saved\n */\nasync function saveContactsToUserStorage(\n  contacts: AddressBookEntry[],\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { getUserStorageControllerInstance, trace } = options;\n\n  const saveContacts = async () => {\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  return trace\n    ? await trace(\n        {\n          name: TraceName.ContactSyncSaveBatch,\n          data: {\n            contactCount: contacts.length,\n            // Performance scaling indicators\n            hasBatchOperations: contacts.length > 1,\n            chainCount: new Set(contacts.map((c) => c.chainId)).size,\n            hasMemosCount: contacts.filter((c) => c.memo?.length).length,\n          },\n        },\n        saveContacts,\n      )\n    : await saveContacts();\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 * @returns Promise that resolves when the contact is updated\n */\nexport async function updateContactInRemoteStorage(\n  contact: AddressBookEntry,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { trace } = options;\n\n  const updateContact = async () => {\n    if (\n      !canPerformContactSyncing(options) ||\n      !contact.address ||\n      !contact.chainId ||\n      !contact.name?.trim()\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    } 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  if (trace) {\n    return await trace(\n      {\n        name: TraceName.ContactSyncUpdateRemote,\n        data: {\n          chainId: contact.chainId,\n          // Performance indicators\n          hasTimestamp: Boolean(contact.lastUpdatedAt),\n          hasMemo: Boolean(contact.memo?.length),\n          isUpdate: Boolean(contact.lastUpdatedAt), // vs new contact\n        },\n      },\n      updateContact,\n    );\n  }\n\n  return await updateContact();\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 * @returns Promise that resolves when the contact is marked as deleted\n */\nexport async function deleteContactInRemoteStorage(\n  contact: AddressBookEntry,\n  options: ContactSyncingOptions,\n): Promise<void> {\n  const { trace } = options;\n  const deleteContact = async () => {\n    if (\n      !canPerformContactSyncing(options) ||\n      !contact.address ||\n      !contact.chainId ||\n      !contact.name?.trim()\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          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\n  return trace\n    ? await trace({ name: TraceName.ContactSyncDeleteRemote }, deleteContact)\n    : await deleteContact();\n}\n"]}

package/dist/controllers/user-storage/index.cjs

@@ -36,7 +36,7 @@ const UserStorageController = UserStorageController_1.default;
 exports.default = UserStorageController;
 __exportStar(require("./UserStorageController.cjs"), exports);
 exports.Mocks = __importStar(require("./mocks/index.cjs"));
-__exportStar(require("./constants/index.cjs"), exports);
+__exportStar(require("./constants.cjs"), exports);
 __exportStar(require("../../shared/encryption/index.cjs"), exports);
 __exportStar(require("../../shared/storage-schema.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/controllers/user-storage/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wFAAiD;AAGxC,qBAHF,+BAAU,CAGE;AADnB,MAAM,qBAAqB,GAAG,+BAAU,CAAC;AAEzC,kBAAe,qBAAqB,CAAC;AACrC,8DAAwC;AACxC,2DAAiC;AACjC,wDAA4B;AAC5B,oEAAwC;AACxC,kEAA4C","sourcesContent":["import Controller from './UserStorageController';\n\nconst UserStorageController = Controller;\nexport { Controller };\nexport default UserStorageController;\nexport * from './UserStorageController';\nexport * as Mocks from './mocks';\nexport * from './constants';\nexport * from '../../shared/encryption';\nexport * from '../../shared/storage-schema';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wFAAiD;AAGxC,qBAHF,+BAAU,CAGE;AADnB,MAAM,qBAAqB,GAAG,+BAAU,CAAC;AAEzC,kBAAe,qBAAqB,CAAC;AACrC,8DAAwC;AACxC,2DAAiC;AACjC,kDAA4B;AAC5B,oEAAwC;AACxC,kEAA4C","sourcesContent":["import Controller from './UserStorageController';\n\nconst UserStorageController = Controller;\nexport { Controller };\nexport default UserStorageController;\nexport * from './UserStorageController';\nexport * as Mocks from './mocks';\nexport * from './constants';\nexport * from '../../shared/encryption';\nexport * from '../../shared/storage-schema';\n"]}

package/dist/controllers/user-storage/index.d.cts

@@ -4,7 +4,7 @@ export { Controller };
 export default UserStorageController;
 export * from "./UserStorageController.cjs";
 export * as Mocks from "./mocks/index.cjs";
-export * from "./constants/index.cjs";
+export * from "./constants.cjs";
 export * from "../../shared/encryption/index.cjs";
 export * from "../../shared/storage-schema.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/controllers/user-storage/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,oCAAgC;AAEjD,QAAA,MAAM,qBAAqB,mBAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,CAAC;AACrC,4CAAwC;AACxC,OAAO,KAAK,KAAK,0BAAgB;AACjC,sCAA4B;AAC5B,kDAAwC;AACxC,gDAA4C"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,oCAAgC;AAEjD,QAAA,MAAM,qBAAqB,mBAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,CAAC;AACrC,4CAAwC;AACxC,OAAO,KAAK,KAAK,0BAAgB;AACjC,gCAA4B;AAC5B,kDAAwC;AACxC,gDAA4C"}

package/dist/controllers/user-storage/index.d.mts

@@ -4,7 +4,7 @@ export { Controller };
 export default UserStorageController;
 export * from "./UserStorageController.mjs";
 export * as Mocks from "./mocks/index.mjs";
-export * from "./constants/index.mjs";
+export * from "./constants.mjs";
 export * from "../../shared/encryption/index.mjs";
 export * from "../../shared/storage-schema.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/controllers/user-storage/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,oCAAgC;AAEjD,QAAA,MAAM,qBAAqB,mBAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,CAAC;AACrC,4CAAwC;AACxC,OAAO,KAAK,KAAK,0BAAgB;AACjC,sCAA4B;AAC5B,kDAAwC;AACxC,gDAA4C"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,oCAAgC;AAEjD,QAAA,MAAM,qBAAqB,mBAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,CAAC;AACrC,4CAAwC;AACxC,OAAO,KAAK,KAAK,0BAAgB;AACjC,gCAA4B;AAC5B,kDAAwC;AACxC,gDAA4C"}

package/dist/controllers/user-storage/index.mjs

@@ -4,7 +4,7 @@ export { Controller };
 export default UserStorageController;
 export * from "./UserStorageController.mjs";
 export * as Mocks from "./mocks/index.mjs";
-export * from "./constants/index.mjs";
+export * from "./constants.mjs";
 export * from "../../shared/encryption/index.mjs";
 export * from "../../shared/storage-schema.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/controllers/user-storage/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,oCAAgC;AAEjD,MAAM,qBAAqB,GAAG,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,CAAC;AACrC,4CAAwC;AACxC,OAAO,KAAK,KAAK,0BAAgB;AACjC,sCAA4B;AAC5B,kDAAwC;AACxC,gDAA4C","sourcesContent":["import Controller from './UserStorageController';\n\nconst UserStorageController = Controller;\nexport { Controller };\nexport default UserStorageController;\nexport * from './UserStorageController';\nexport * as Mocks from './mocks';\nexport * from './constants';\nexport * from '../../shared/encryption';\nexport * from '../../shared/storage-schema';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/controllers/user-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,oCAAgC;AAEjD,MAAM,qBAAqB,GAAG,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,CAAC;AACrC,4CAAwC;AACxC,OAAO,KAAK,KAAK,0BAAgB;AACjC,gCAA4B;AAC5B,kDAAwC;AACxC,gDAA4C","sourcesContent":["import Controller from './UserStorageController';\n\nconst UserStorageController = Controller;\nexport { Controller };\nexport default UserStorageController;\nexport * from './UserStorageController';\nexport * as Mocks from './mocks';\nexport * from './constants';\nexport * from '../../shared/encryption';\nexport * from '../../shared/storage-schema';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/profile-sync-controller",
-  "version": "20.0.0-preview-988fbb56",
+  "version": "20.0.0-preview-92a09963",
   "description": "The profile sync helps developers synchronize data across multiple clients and devices in a privacy-preserving way. All data saved in the user storage database is encrypted client-side to preserve privacy. The user storage provides a modular design, giving developers the flexibility to construct and manage their storage spaces in a way that best suits their needs",
   "keywords": [
     "MetaMask",

package/dist/controllers/user-storage/constants/index.cjs

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./traces.cjs"), exports);
-//# sourceMappingURL=index.cjs.map

package/dist/controllers/user-storage/constants/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAAyB","sourcesContent":["export * from './traces';\n"]}

package/dist/controllers/user-storage/constants/index.d.cts

@@ -1,2 +0,0 @@
-export * from "./traces.cjs";
-//# sourceMappingURL=index.d.cts.map

package/dist/controllers/user-storage/constants/index.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/index.ts"],"names":[],"mappings":"AAAA,6BAAyB"}

package/dist/controllers/user-storage/constants/index.d.mts

@@ -1,2 +0,0 @@
-export * from "./traces.mjs";
-//# sourceMappingURL=index.d.mts.map

package/dist/controllers/user-storage/constants/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/index.ts"],"names":[],"mappings":"AAAA,6BAAyB"}

package/dist/controllers/user-storage/constants/index.mjs

@@ -1,2 +0,0 @@
-export * from "./traces.mjs";
-//# sourceMappingURL=index.mjs.map

package/dist/controllers/user-storage/constants/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/index.ts"],"names":[],"mappings":"AAAA,6BAAyB","sourcesContent":["export * from './traces';\n"]}

package/dist/controllers/user-storage/constants/traces.cjs

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TraceName = void 0;
-/**
- * Trace names for UserStorage syncing operations
- */
-exports.TraceName = {
-    // Contact syncing traces
-    ContactSyncFull: 'Contact Sync Full',
-    ContactSyncSaveBatch: 'Contact Sync Save Batch',
-    ContactSyncUpdateRemote: 'Contact Sync Update Remote',
-    ContactSyncDeleteRemote: 'Contact Sync Delete Remote',
-    // Account syncing traces
-    AccountSyncFull: 'Account Sync Full',
-    AccountSyncSaveIndividual: 'Account Sync Save Individual',
-};
-//# sourceMappingURL=traces.cjs.map

package/dist/controllers/user-storage/constants/traces.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"traces.cjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/traces.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,yBAAyB;IACzB,eAAe,EAAE,mBAAmB;IACpC,oBAAoB,EAAE,yBAAyB;IAC/C,uBAAuB,EAAE,4BAA4B;IACrD,uBAAuB,EAAE,4BAA4B;IAErD,yBAAyB;IACzB,eAAe,EAAE,mBAAmB;IACpC,yBAAyB,EAAE,8BAA8B;CACjD,CAAC","sourcesContent":["/**\n * Trace names for UserStorage syncing operations\n */\nexport const TraceName = {\n  // Contact syncing traces\n  ContactSyncFull: 'Contact Sync Full',\n  ContactSyncSaveBatch: 'Contact Sync Save Batch',\n  ContactSyncUpdateRemote: 'Contact Sync Update Remote',\n  ContactSyncDeleteRemote: 'Contact Sync Delete Remote',\n\n  // Account syncing traces\n  AccountSyncFull: 'Account Sync Full',\n  AccountSyncSaveIndividual: 'Account Sync Save Individual',\n} as const;\n"]}

package/dist/controllers/user-storage/constants/traces.d.cts

@@ -1,12 +0,0 @@
-/**
- * Trace names for UserStorage syncing operations
- */
-export declare const TraceName: {
-    readonly ContactSyncFull: "Contact Sync Full";
-    readonly ContactSyncSaveBatch: "Contact Sync Save Batch";
-    readonly ContactSyncUpdateRemote: "Contact Sync Update Remote";
-    readonly ContactSyncDeleteRemote: "Contact Sync Delete Remote";
-    readonly AccountSyncFull: "Account Sync Full";
-    readonly AccountSyncSaveIndividual: "Account Sync Save Individual";
-};
-//# sourceMappingURL=traces.d.cts.map

package/dist/controllers/user-storage/constants/traces.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"traces.d.cts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/traces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;CAUZ,CAAC"}

package/dist/controllers/user-storage/constants/traces.d.mts

@@ -1,12 +0,0 @@
-/**
- * Trace names for UserStorage syncing operations
- */
-export declare const TraceName: {
-    readonly ContactSyncFull: "Contact Sync Full";
-    readonly ContactSyncSaveBatch: "Contact Sync Save Batch";
-    readonly ContactSyncUpdateRemote: "Contact Sync Update Remote";
-    readonly ContactSyncDeleteRemote: "Contact Sync Delete Remote";
-    readonly AccountSyncFull: "Account Sync Full";
-    readonly AccountSyncSaveIndividual: "Account Sync Save Individual";
-};
-//# sourceMappingURL=traces.d.mts.map

package/dist/controllers/user-storage/constants/traces.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"traces.d.mts","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/traces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;CAUZ,CAAC"}

package/dist/controllers/user-storage/constants/traces.mjs

@@ -1,14 +0,0 @@
-/**
- * Trace names for UserStorage syncing operations
- */
-export const TraceName = {
-    // Contact syncing traces
-    ContactSyncFull: 'Contact Sync Full',
-    ContactSyncSaveBatch: 'Contact Sync Save Batch',
-    ContactSyncUpdateRemote: 'Contact Sync Update Remote',
-    ContactSyncDeleteRemote: 'Contact Sync Delete Remote',
-    // Account syncing traces
-    AccountSyncFull: 'Account Sync Full',
-    AccountSyncSaveIndividual: 'Account Sync Save Individual',
-};
-//# sourceMappingURL=traces.mjs.map

package/dist/controllers/user-storage/constants/traces.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"traces.mjs","sourceRoot":"","sources":["../../../../src/controllers/user-storage/constants/traces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,yBAAyB;IACzB,eAAe,EAAE,mBAAmB;IACpC,oBAAoB,EAAE,yBAAyB;IAC/C,uBAAuB,EAAE,4BAA4B;IACrD,uBAAuB,EAAE,4BAA4B;IAErD,yBAAyB;IACzB,eAAe,EAAE,mBAAmB;IACpC,yBAAyB,EAAE,8BAA8B;CACjD,CAAC","sourcesContent":["/**\n * Trace names for UserStorage syncing operations\n */\nexport const TraceName = {\n  // Contact syncing traces\n  ContactSyncFull: 'Contact Sync Full',\n  ContactSyncSaveBatch: 'Contact Sync Save Batch',\n  ContactSyncUpdateRemote: 'Contact Sync Update Remote',\n  ContactSyncDeleteRemote: 'Contact Sync Delete Remote',\n\n  // Account syncing traces\n  AccountSyncFull: 'Account Sync Full',\n  AccountSyncSaveIndividual: 'Account Sync Save Individual',\n} as const;\n"]}