@metamask-previews/notification-services-controller 10.0.0-preview-5dcecbb7 → 10.0.0-preview-8dfa2801

package/dist/NotificationServicesController/utils/utils.cjs

@@ -1,355 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeApiCall = exports.toggleUserStorageTriggerStatus = exports.upsertTriggerTypeTriggers = exports.upsertAddressTriggers = exports.getUUIDsForAccountByKinds = exports.getUUIDsForKinds = exports.getAllUUIDs = exports.getUUIDsForAccount = exports.inferEnabledKinds = exports.checkAccountsPresence = exports.traverseUserStorageTriggers = exports.cleanUserStorage = exports.initializeUserStorage = void 0;
-const controller_utils_1 = require("@metamask/controller-utils");
-const uuid_1 = require("uuid");
-const constants_1 = require("../constants/constants.cjs");
-const notification_schema_1 = require("../constants/notification-schema.cjs");
-/**
- * Extracts and returns the ID from a notification trigger.
- * This utility function is primarily used as a mapping function in `traverseUserStorageTriggers`
- * to convert a full trigger object into its ID string.
- *
- * @param trigger - The notification trigger from which the ID is extracted.
- * @returns The ID of the provided notification trigger.
- */
-const triggerToId = (trigger) => trigger.id;
-/**
- * A utility function that returns the input trigger without any transformation.
- * This function is used as the default mapping function in `traverseUserStorageTriggers`
- * when no custom mapping function is provided.
- *
- * @param trigger - The notification trigger to be returned as is.
- * @returns The same notification trigger that was passed in.
- */
-const triggerIdentity = (trigger) => trigger;
-/**
- * Create a completely new user storage object with the given accounts and state.
- * This method initializes the user storage with a version key and iterates over each account to populate it with triggers.
- * Each trigger is associated with supported chains, and for each chain, a unique identifier (UUID) is generated.
- * The trigger object contains a kind (`k`) indicating the type of trigger and an enabled state (`e`).
- * The kind and enabled state are stored with abbreviated keys to reduce the JSON size.
- *
- * This is used primarily for creating a new user storage (e.g. when first signing in/enabling notification profile syncing),
- * caution is needed in case you need to remove triggers that you don't want (due to notification setting filters)
- *
- * @param accounts - An array of account objects, each optionally containing an address.
- * @param state - A boolean indicating the initial enabled state for all triggers in the user storage.
- * @param shouldClean - prop to clean the initialized UserStorage (removing any invalid addresses). Only false for testing purposes.
- * @returns A `UserStorage` object populated with triggers for each account and chain.
- */
-function initializeUserStorage(accounts, state, shouldClean = true) {
-    const userStorage = {
-        [constants_1.USER_STORAGE_VERSION_KEY]: constants_1.USER_STORAGE_VERSION,
-    };
-    accounts.forEach((account) => {
-        const address = account.address?.toLowerCase();
-        if (!address) {
-            return;
-        }
-        if (!userStorage[address]) {
-            userStorage[address] = {};
-        }
-        Object.entries(notification_schema_1.TRIGGERS).forEach(([trigger, { supported_chains: supportedChains }]) => {
-            supportedChains.forEach((chain) => {
-                if (!userStorage[address]?.[chain]) {
-                    userStorage[address][chain] = {};
-                }
-                userStorage[address][chain][(0, uuid_1.v4)()] = {
-                    k: trigger,
-                    e: state, // use 'e' instead of 'enabled' to reduce the json weight
-                };
-            });
-        });
-    });
-    if (shouldClean) {
-        cleanUserStorage(userStorage);
-    }
-    return userStorage;
-}
-exports.initializeUserStorage = initializeUserStorage;
-/**
- * This is a fallback to ensure that we are not adding non-hex addresses, and the shape is valid.
- * Any invalid shapes will be removed.
- * NOTE - this method mutates and returns the cleaned User Storage.
- *
- * @param userStorage - notification user storage field we are to clean.
- * @returns a cleaned version of user storage.
- */
-function cleanUserStorage(userStorage) {
-    const addresses = new Set();
-    traverseUserStorageTriggers(userStorage, {
-        mapTrigger: (t) => addresses.add(t.address),
-    });
-    addresses.forEach((addr) => {
-        if (!(0, controller_utils_1.isValidHexAddress)(addr)) {
-            delete userStorage[addr];
-        }
-    });
-    return userStorage;
-}
-exports.cleanUserStorage = cleanUserStorage;
-/**
- * Iterates over user storage to find and optionally transform notification triggers.
- * This method allows for flexible retrieval and transformation of triggers based on provided options.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param options - Optional parameters to filter and map triggers:
- * - `address`: If provided, only triggers for this address are considered.
- * - `mapTrigger`: A function to transform each trigger. If not provided, triggers are returned as is.
- * @returns An array of triggers, potentially transformed by the `mapTrigger` function.
- */
-function traverseUserStorageTriggers(userStorage, options) {
-    const triggers = [];
-    const mapTrigger = options?.mapTrigger ?? triggerIdentity;
-    for (const address in userStorage) {
-        if (address === constants_1.USER_STORAGE_VERSION_KEY) {
-            continue;
-        }
-        if (options?.address && address !== options.address) {
-            continue;
-        }
-        for (const chainId in userStorage[address]) {
-            if (chainId in userStorage[address]) {
-                for (const uuid in userStorage[address][chainId]) {
-                    if (uuid) {
-                        const mappedTrigger = mapTrigger({
-                            id: uuid,
-                            kind: userStorage[address]?.[chainId]?.[uuid]?.k,
-                            chainId,
-                            address,
-                            enabled: userStorage[address]?.[chainId]?.[uuid]?.e ?? false,
-                        });
-                        if (mappedTrigger) {
-                            triggers.push(mappedTrigger);
-                        }
-                    }
-                }
-            }
-        }
-    }
-    return triggers;
-}
-exports.traverseUserStorageTriggers = traverseUserStorageTriggers;
-/**
- * Verifies the presence of specified accounts and their chains in the user storage.
- * This method checks if each provided account exists in the user storage and if all its supported chains are present.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param accounts - An array of account addresses to check for presence.
- * @returns A record where each key is an account address and each value is a boolean indicating whether the account and all its supported chains are present in the user storage.
- */
-function checkAccountsPresence(userStorage, accounts) {
-    const presenceRecord = {};
-    // Initialize presence record for all accounts as false
-    accounts.forEach((account) => {
-        presenceRecord[account.toLowerCase()] = isAccountEnabled(account, userStorage);
-    });
-    return presenceRecord;
-}
-exports.checkAccountsPresence = checkAccountsPresence;
-/**
- * Internal method to check if a given account should be marked as enabled by introspecting user storage
- * Introspection: check if account exists; and also see if has all triggers in schema enabled
- *
- * @param accountAddress - address to check in user storage
- * @param userStorage - user storage object to traverse/introspect
- * @returns boolean if the account is enabled or disabled
- */
-function isAccountEnabled(accountAddress, userStorage) {
-    const accountObject = userStorage[accountAddress?.toLowerCase()];
-    // If the account address is not present in the userStorage, return true
-    if (!accountObject) {
-        return false;
-    }
-    // Check if all available chains are present
-    for (const [triggerKind, triggerConfig] of Object.entries(notification_schema_1.TRIGGERS)) {
-        for (const chain of triggerConfig.supported_chains) {
-            if (!accountObject[chain]) {
-                return false;
-            }
-            const triggerExists = Object.values(accountObject[chain]).some((obj) => obj.k === triggerKind);
-            if (!triggerExists) {
-                return false;
-            }
-            // Check if any trigger is disabled
-            for (const uuid in accountObject[chain]) {
-                if (!accountObject[chain][uuid].e) {
-                    return false;
-                }
-            }
-        }
-    }
-    return true;
-}
-/**
- * Infers and returns an array of enabled notification trigger kinds from the user storage.
- * This method counts the occurrences of each kind of trigger and returns the kinds that are present.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @returns An array of trigger kinds (`TRIGGER_TYPES`) that are enabled in the user storage.
- */
-function inferEnabledKinds(userStorage) {
-    const allSupportedKinds = new Set();
-    traverseUserStorageTriggers(userStorage, {
-        mapTrigger: (t) => {
-            allSupportedKinds.add(t.kind);
-        },
-    });
-    return Array.from(allSupportedKinds);
-}
-exports.inferEnabledKinds = inferEnabledKinds;
-/**
- * Retrieves all UUIDs associated with a specific account address from the user storage.
- * This function utilizes `traverseUserStorageTriggers` with a mapping function to extract
- * just the UUIDs of the notification triggers for the given address.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param address - The specific account address to retrieve UUIDs for.
- * @returns An array of UUID strings associated with the given account address.
- */
-function getUUIDsForAccount(userStorage, address) {
-    return traverseUserStorageTriggers(userStorage, {
-        address,
-        mapTrigger: triggerToId,
-    });
-}
-exports.getUUIDsForAccount = getUUIDsForAccount;
-/**
- * Retrieves all UUIDs from the user storage, regardless of the account address or chain ID.
- * This method leverages `traverseUserStorageTriggers` with a specific mapping function (`triggerToId`)
- * to extract only the UUIDs from all notification triggers present in the user storage.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @returns An array of UUID strings from all notification triggers in the user storage.
- */
-function getAllUUIDs(userStorage) {
-    return traverseUserStorageTriggers(userStorage, {
-        mapTrigger: triggerToId,
-    });
-}
-exports.getAllUUIDs = getAllUUIDs;
-/**
- * Retrieves UUIDs for notification triggers that match any of the specified kinds.
- * This method filters triggers based on their kind and returns an array of UUIDs for those that match the allowed kinds.
- * It utilizes `traverseUserStorageTriggers` with a custom mapping function that checks if a trigger's kind is in the allowed list.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param allowedKinds - An array of kinds (as strings) to filter the triggers by.
- * @returns An array of UUID strings for triggers that match the allowed kinds.
- */
-function getUUIDsForKinds(userStorage, allowedKinds) {
-    const kindsSet = new Set(allowedKinds);
-    return traverseUserStorageTriggers(userStorage, {
-        mapTrigger: (t) => (kindsSet.has(t.kind) ? t.id : undefined),
-    });
-}
-exports.getUUIDsForKinds = getUUIDsForKinds;
-/**
- * Retrieves notification triggers for a specific account address that match any of the specified kinds.
- * This method filters triggers both by the account address and their kind, returning triggers that match the allowed kinds for the specified address.
- * It leverages `traverseUserStorageTriggers` with a custom mapping function to filter and return only the relevant triggers.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param address - The specific account address for which to retrieve triggers.
- * @param allowedKinds - An array of trigger kinds (`TRIGGER_TYPES`) to filter the triggers by.
- * @returns An array of `NotificationTrigger` objects that match the allowed kinds for the specified account address.
- */
-function getUUIDsForAccountByKinds(userStorage, address, allowedKinds) {
-    const allowedKindsSet = new Set(allowedKinds);
-    return traverseUserStorageTriggers(userStorage, {
-        address,
-        mapTrigger: (trigger) => {
-            if (allowedKindsSet.has(trigger.kind)) {
-                return trigger;
-            }
-            return undefined;
-        },
-    });
-}
-exports.getUUIDsForAccountByKinds = getUUIDsForAccountByKinds;
-/**
- * Upserts (updates or inserts) notification triggers for a given account across all supported chains.
- * This method ensures that each supported trigger type exists for each chain associated with the account.
- * If a trigger type does not exist for a chain, it creates a new trigger with a unique UUID.
- *
- * @param _account - The account address for which to upsert triggers. The address is normalized to lowercase.
- * @param userStorage - The user storage object to be updated with new or existing triggers.
- * @returns The updated user storage object with upserted triggers for the specified account.
- */
-function upsertAddressTriggers(_account, userStorage) {
-    // Ensure the account exists in userStorage
-    const account = _account.toLowerCase();
-    userStorage[account] = userStorage[account] || {};
-    // Iterate over each trigger and its supported chains
-    for (const [trigger, { supported_chains: supportedChains }] of Object.entries(notification_schema_1.TRIGGERS)) {
-        for (const chain of supportedChains) {
-            // Ensure the chain exists for the account
-            userStorage[account][chain] = userStorage[account][chain] || {};
-            // Check if the trigger exists for the chain
-            const existingTrigger = Object.values(userStorage[account][chain]).find((obj) => obj.k === trigger);
-            if (!existingTrigger) {
-                // If the trigger doesn't exist, create a new one with a new UUID
-                const uuid = (0, uuid_1.v4)();
-                userStorage[account][chain][uuid] = {
-                    k: trigger,
-                    e: false,
-                };
-            }
-        }
-    }
-    return userStorage;
-}
-exports.upsertAddressTriggers = upsertAddressTriggers;
-/**
- * Upserts (updates or inserts) notification triggers of a specific type across all accounts and chains in user storage.
- * This method ensures that a trigger of the specified type exists for each account and chain. If a trigger of the specified type
- * does not exist for an account and chain, it creates a new trigger with a unique UUID.
- *
- * @param triggerType - The type of trigger to upsert across all accounts and chains.
- * @param userStorage - The user storage object to be updated with new or existing triggers of the specified type.
- * @returns The updated user storage object with upserted triggers of the specified type for all accounts and chains.
- */
-function upsertTriggerTypeTriggers(triggerType, userStorage) {
-    // Iterate over each account in userStorage
-    Object.entries(userStorage).forEach(([account, chains]) => {
-        if (account === constants_1.USER_STORAGE_VERSION_KEY) {
-            return;
-        }
-        // Iterate over each chain for the account
-        Object.entries(chains).forEach(([chain, triggers]) => {
-            // Check if the trigger type exists for the chain
-            const existingTrigger = Object.values(triggers).find((obj) => obj.k === triggerType);
-            if (!existingTrigger) {
-                // If the trigger type doesn't exist, create a new one with a new UUID
-                const uuid = (0, uuid_1.v4)();
-                userStorage[account][chain][uuid] = {
-                    k: triggerType,
-                    e: false,
-                };
-            }
-        });
-    });
-    return userStorage;
-}
-exports.upsertTriggerTypeTriggers = upsertTriggerTypeTriggers;
-/**
- * Toggles the enabled status of a user storage trigger.
- *
- * @param userStorage - The user storage object.
- * @param address - The user's address.
- * @param chainId - The chain ID.
- * @param uuid - The unique identifier for the trigger.
- * @param enabled - The new enabled status.
- * @returns The updated user storage object.
- */
-function toggleUserStorageTriggerStatus(userStorage, address, chainId, uuid, enabled) {
-    if (userStorage?.[address]?.[chainId]?.[uuid]) {
-        userStorage[address][chainId][uuid].e = enabled;
-    }
-    return userStorage;
-}
-exports.toggleUserStorageTriggerStatus = toggleUserStorageTriggerStatus;
+exports.makeApiCall = void 0;
 /**
  * Performs an API call with automatic retries on failure.
  *

package/dist/NotificationServicesController/utils/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../../src/NotificationServicesController/utils/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { isValidHexAddress } from '@metamask/controller-utils';\nimport { v4 as uuidv4 } from 'uuid';\n\nimport {\n  USER_STORAGE_VERSION_KEY,\n  USER_STORAGE_VERSION,\n} from '../constants/constants';\nimport type { TRIGGER_TYPES } from '../constants/notification-schema';\nimport { TRIGGERS } from '../constants/notification-schema';\nimport type { UserStorage } from '../types/user-storage/user-storage';\n\nexport type NotificationTrigger = {\n  id: string;\n  chainId: string;\n  kind: string;\n  address: string;\n  enabled: boolean;\n};\n\ntype MapTriggerFn<Result> = (\n  trigger: NotificationTrigger,\n) => Result | undefined;\n\ntype TraverseTriggerOpts<Result> = {\n  address?: string;\n  mapTrigger?: MapTriggerFn<Result>;\n};\n\n/**\n * Extracts and returns the ID from a notification trigger.\n * This utility function is primarily used as a mapping function in `traverseUserStorageTriggers`\n * to convert a full trigger object into its ID string.\n *\n * @param trigger - The notification trigger from which the ID is extracted.\n * @returns The ID of the provided notification trigger.\n */\nconst triggerToId = (trigger: NotificationTrigger): string => trigger.id;\n\n/**\n * A utility function that returns the input trigger without any transformation.\n * This function is used as the default mapping function in `traverseUserStorageTriggers`\n * when no custom mapping function is provided.\n *\n * @param trigger - The notification trigger to be returned as is.\n * @returns The same notification trigger that was passed in.\n */\nconst triggerIdentity = (trigger: NotificationTrigger): NotificationTrigger =>\n  trigger;\n\n/**\n * Create a completely new user storage object with the given accounts and state.\n * This method initializes the user storage with a version key and iterates over each account to populate it with triggers.\n * Each trigger is associated with supported chains, and for each chain, a unique identifier (UUID) is generated.\n * The trigger object contains a kind (`k`) indicating the type of trigger and an enabled state (`e`).\n * The kind and enabled state are stored with abbreviated keys to reduce the JSON size.\n *\n * This is used primarily for creating a new user storage (e.g. when first signing in/enabling notification profile syncing),\n * caution is needed in case you need to remove triggers that you don't want (due to notification setting filters)\n *\n * @param accounts - An array of account objects, each optionally containing an address.\n * @param state - A boolean indicating the initial enabled state for all triggers in the user storage.\n * @param shouldClean - prop to clean the initialized UserStorage (removing any invalid addresses). Only false for testing purposes.\n * @returns A `UserStorage` object populated with triggers for each account and chain.\n */\nexport function initializeUserStorage(\n  accounts: { address?: string }[],\n  state: boolean,\n  shouldClean = true,\n): UserStorage {\n  const userStorage: UserStorage = {\n    [USER_STORAGE_VERSION_KEY]: USER_STORAGE_VERSION,\n  };\n\n  accounts.forEach((account) => {\n    const address = account.address?.toLowerCase();\n    if (!address) {\n      return;\n    }\n    if (!userStorage[address]) {\n      userStorage[address] = {};\n    }\n\n    Object.entries(TRIGGERS).forEach(\n      ([trigger, { supported_chains: supportedChains }]) => {\n        supportedChains.forEach((chain) => {\n          if (!userStorage[address]?.[chain]) {\n            userStorage[address][chain] = {};\n          }\n\n          userStorage[address][chain][uuidv4()] = {\n            k: trigger as TRIGGER_TYPES, // use 'k' instead of 'kind' to reduce the json weight\n            e: state, // use 'e' instead of 'enabled' to reduce the json weight\n          };\n        });\n      },\n    );\n  });\n\n  if (shouldClean) {\n    cleanUserStorage(userStorage);\n  }\n  return userStorage;\n}\n\n/**\n * This is a fallback to ensure that we are not adding non-hex addresses, and the shape is valid.\n * Any invalid shapes will be removed.\n * NOTE - this method mutates and returns the cleaned User Storage.\n *\n * @param userStorage - notification user storage field we are to clean.\n * @returns a cleaned version of user storage.\n */\nexport function cleanUserStorage(userStorage: UserStorage) {\n  const addresses = new Set<string>();\n  traverseUserStorageTriggers(userStorage, {\n    mapTrigger: (t) => addresses.add(t.address),\n  });\n\n  addresses.forEach((addr) => {\n    if (!isValidHexAddress(addr)) {\n      delete userStorage[addr];\n    }\n  });\n\n  return userStorage;\n}\n\n/**\n * Iterates over user storage to find and optionally transform notification triggers.\n * This method allows for flexible retrieval and transformation of triggers based on provided options.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @param options - Optional parameters to filter and map triggers:\n * - `address`: If provided, only triggers for this address are considered.\n * - `mapTrigger`: A function to transform each trigger. If not provided, triggers are returned as is.\n * @returns An array of triggers, potentially transformed by the `mapTrigger` function.\n */\nexport function traverseUserStorageTriggers<\n  ResultTriggers = NotificationTrigger,\n>(\n  userStorage: UserStorage,\n  options?: TraverseTriggerOpts<ResultTriggers>,\n): ResultTriggers[] {\n  const triggers: ResultTriggers[] = [];\n  const mapTrigger =\n    options?.mapTrigger ?? (triggerIdentity as MapTriggerFn<ResultTriggers>);\n\n  for (const address in userStorage) {\n    if (address === (USER_STORAGE_VERSION_KEY as unknown as string)) {\n      continue;\n    }\n    if (options?.address && address !== options.address) {\n      continue;\n    }\n\n    for (const chainId in userStorage[address]) {\n      if (chainId in userStorage[address]) {\n        for (const uuid in userStorage[address][chainId]) {\n          if (uuid) {\n            const mappedTrigger = mapTrigger({\n              id: uuid,\n              kind: userStorage[address]?.[chainId]?.[uuid]?.k,\n              chainId,\n              address,\n              enabled: userStorage[address]?.[chainId]?.[uuid]?.e ?? false,\n            });\n            if (mappedTrigger) {\n              triggers.push(mappedTrigger);\n            }\n          }\n        }\n      }\n    }\n  }\n\n  return triggers;\n}\n\n/**\n * Verifies the presence of specified accounts and their chains in the user storage.\n * This method checks if each provided account exists in the user storage and if all its supported chains are present.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @param accounts - An array of account addresses to check for presence.\n * @returns A record where each key is an account address and each value is a boolean indicating whether the account and all its supported chains are present in the user storage.\n */\nexport function checkAccountsPresence(\n  userStorage: UserStorage,\n  accounts: string[],\n): Record<string, boolean> {\n  const presenceRecord: Record<string, boolean> = {};\n\n  // Initialize presence record for all accounts as false\n  accounts.forEach((account) => {\n    presenceRecord[account.toLowerCase()] = isAccountEnabled(\n      account,\n      userStorage,\n    );\n  });\n\n  return presenceRecord;\n}\n\n/**\n * Internal method to check if a given account should be marked as enabled by introspecting user storage\n * Introspection: check if account exists; and also see if has all triggers in schema enabled\n *\n * @param accountAddress - address to check in user storage\n * @param userStorage - user storage object to traverse/introspect\n * @returns boolean if the account is enabled or disabled\n */\nfunction isAccountEnabled(\n  accountAddress: string,\n  userStorage: UserStorage,\n): boolean {\n  const accountObject = userStorage[accountAddress?.toLowerCase()];\n\n  // If the account address is not present in the userStorage, return true\n  if (!accountObject) {\n    return false;\n  }\n\n  // Check if all available chains are present\n  for (const [triggerKind, triggerConfig] of Object.entries(TRIGGERS)) {\n    for (const chain of triggerConfig.supported_chains) {\n      if (!accountObject[chain]) {\n        return false;\n      }\n\n      const triggerExists = Object.values(accountObject[chain]).some(\n        (obj) => obj.k === (triggerKind as TRIGGER_TYPES),\n      );\n      if (!triggerExists) {\n        return false;\n      }\n\n      // Check if any trigger is disabled\n      for (const uuid in accountObject[chain]) {\n        if (!accountObject[chain][uuid].e) {\n          return false;\n        }\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Infers and returns an array of enabled notification trigger kinds from the user storage.\n * This method counts the occurrences of each kind of trigger and returns the kinds that are present.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @returns An array of trigger kinds (`TRIGGER_TYPES`) that are enabled in the user storage.\n */\nexport function inferEnabledKinds(userStorage: UserStorage): TRIGGER_TYPES[] {\n  const allSupportedKinds = new Set<TRIGGER_TYPES>();\n\n  traverseUserStorageTriggers(userStorage, {\n    mapTrigger: (t) => {\n      allSupportedKinds.add(t.kind as TRIGGER_TYPES);\n    },\n  });\n\n  return Array.from(allSupportedKinds);\n}\n\n/**\n * Retrieves all UUIDs associated with a specific account address from the user storage.\n * This function utilizes `traverseUserStorageTriggers` with a mapping function to extract\n * just the UUIDs of the notification triggers for the given address.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @param address - The specific account address to retrieve UUIDs for.\n * @returns An array of UUID strings associated with the given account address.\n */\nexport function getUUIDsForAccount(\n  userStorage: UserStorage,\n  address: string,\n): string[] {\n  return traverseUserStorageTriggers(userStorage, {\n    address,\n    mapTrigger: triggerToId,\n  });\n}\n\n/**\n * Retrieves all UUIDs from the user storage, regardless of the account address or chain ID.\n * This method leverages `traverseUserStorageTriggers` with a specific mapping function (`triggerToId`)\n * to extract only the UUIDs from all notification triggers present in the user storage.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @returns An array of UUID strings from all notification triggers in the user storage.\n */\nexport function getAllUUIDs(userStorage: UserStorage): string[] {\n  return traverseUserStorageTriggers(userStorage, {\n    mapTrigger: triggerToId,\n  });\n}\n\n/**\n * Retrieves UUIDs for notification triggers that match any of the specified kinds.\n * This method filters triggers based on their kind and returns an array of UUIDs for those that match the allowed kinds.\n * It utilizes `traverseUserStorageTriggers` with a custom mapping function that checks if a trigger's kind is in the allowed list.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @param allowedKinds - An array of kinds (as strings) to filter the triggers by.\n * @returns An array of UUID strings for triggers that match the allowed kinds.\n */\nexport function getUUIDsForKinds(\n  userStorage: UserStorage,\n  allowedKinds: string[],\n): string[] {\n  const kindsSet = new Set(allowedKinds);\n\n  return traverseUserStorageTriggers(userStorage, {\n    mapTrigger: (t) => (kindsSet.has(t.kind) ? t.id : undefined),\n  });\n}\n\n/**\n * Retrieves notification triggers for a specific account address that match any of the specified kinds.\n * This method filters triggers both by the account address and their kind, returning triggers that match the allowed kinds for the specified address.\n * It leverages `traverseUserStorageTriggers` with a custom mapping function to filter and return only the relevant triggers.\n *\n * @param userStorage - The user storage object containing notification triggers.\n * @param address - The specific account address for which to retrieve triggers.\n * @param allowedKinds - An array of trigger kinds (`TRIGGER_TYPES`) to filter the triggers by.\n * @returns An array of `NotificationTrigger` objects that match the allowed kinds for the specified account address.\n */\nexport function getUUIDsForAccountByKinds(\n  userStorage: UserStorage,\n  address: string,\n  allowedKinds: TRIGGER_TYPES[],\n): NotificationTrigger[] {\n  const allowedKindsSet = new Set(allowedKinds);\n  return traverseUserStorageTriggers(userStorage, {\n    address,\n    mapTrigger: (trigger) => {\n      if (allowedKindsSet.has(trigger.kind as TRIGGER_TYPES)) {\n        return trigger;\n      }\n      return undefined;\n    },\n  });\n}\n\n/**\n * Upserts (updates or inserts) notification triggers for a given account across all supported chains.\n * This method ensures that each supported trigger type exists for each chain associated with the account.\n * If a trigger type does not exist for a chain, it creates a new trigger with a unique UUID.\n *\n * @param _account - The account address for which to upsert triggers. The address is normalized to lowercase.\n * @param userStorage - The user storage object to be updated with new or existing triggers.\n * @returns The updated user storage object with upserted triggers for the specified account.\n */\nexport function upsertAddressTriggers(\n  _account: string,\n  userStorage: UserStorage,\n): UserStorage {\n  // Ensure the account exists in userStorage\n  const account = _account.toLowerCase();\n  userStorage[account] = userStorage[account] || {};\n\n  // Iterate over each trigger and its supported chains\n  for (const [trigger, { supported_chains: supportedChains }] of Object.entries(\n    TRIGGERS,\n  )) {\n    for (const chain of supportedChains) {\n      // Ensure the chain exists for the account\n      userStorage[account][chain] = userStorage[account][chain] || {};\n\n      // Check if the trigger exists for the chain\n      const existingTrigger = Object.values(userStorage[account][chain]).find(\n        (obj) => obj.k === (trigger as TRIGGER_TYPES),\n      );\n\n      if (!existingTrigger) {\n        // If the trigger doesn't exist, create a new one with a new UUID\n        const uuid = uuidv4();\n        userStorage[account][chain][uuid] = {\n          k: trigger as TRIGGER_TYPES,\n          e: false,\n        };\n      }\n    }\n  }\n\n  return userStorage;\n}\n\n/**\n * Upserts (updates or inserts) notification triggers of a specific type across all accounts and chains in user storage.\n * This method ensures that a trigger of the specified type exists for each account and chain. If a trigger of the specified type\n * does not exist for an account and chain, it creates a new trigger with a unique UUID.\n *\n * @param triggerType - The type of trigger to upsert across all accounts and chains.\n * @param userStorage - The user storage object to be updated with new or existing triggers of the specified type.\n * @returns The updated user storage object with upserted triggers of the specified type for all accounts and chains.\n */\nexport function upsertTriggerTypeTriggers(\n  triggerType: TRIGGER_TYPES,\n  userStorage: UserStorage,\n): UserStorage {\n  // Iterate over each account in userStorage\n  Object.entries(userStorage).forEach(([account, chains]) => {\n    if (account === (USER_STORAGE_VERSION_KEY as unknown as string)) {\n      return;\n    }\n\n    // Iterate over each chain for the account\n    Object.entries(chains).forEach(([chain, triggers]) => {\n      // Check if the trigger type exists for the chain\n      const existingTrigger = Object.values(triggers).find(\n        (obj) => obj.k === triggerType,\n      );\n\n      if (!existingTrigger) {\n        // If the trigger type doesn't exist, create a new one with a new UUID\n        const uuid = uuidv4();\n        userStorage[account][chain][uuid] = {\n          k: triggerType,\n          e: false,\n        };\n      }\n    });\n  });\n\n  return userStorage;\n}\n\n/**\n * Toggles the enabled status of a user storage trigger.\n *\n * @param userStorage - The user storage object.\n * @param address - The user's address.\n * @param chainId - The chain ID.\n * @param uuid - The unique identifier for the trigger.\n * @param enabled - The new enabled status.\n * @returns The updated user storage object.\n */\nexport function toggleUserStorageTriggerStatus(\n  userStorage: UserStorage,\n  address: string,\n  chainId: string,\n  uuid: string,\n  enabled: boolean,\n): UserStorage {\n  if (userStorage?.[address]?.[chainId]?.[uuid]) {\n    userStorage[address][chainId][uuid].e = enabled;\n  }\n\n  return userStorage;\n}\n\n/**\n * Performs an API call with automatic retries on failure.\n *\n * @param bearerToken - The JSON Web Token for authorization.\n * @param endpoint - The URL of the API endpoint to call.\n * @param method - The HTTP method ('POST' or 'DELETE').\n * @param body - The body of the request. It should be an object that can be serialized to JSON.\n * @returns A Promise that resolves to the response of the fetch request.\n */\nexport async function makeApiCall<Body>(\n  bearerToken: string,\n  endpoint: string,\n  method: 'POST' | 'DELETE',\n  body: Body,\n): Promise<Response> {\n  const options: RequestInit = {\n    method,\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${bearerToken}`,\n    },\n    body: JSON.stringify(body),\n  };\n\n  return await fetch(endpoint, options);\n}\n"]}
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../../src/NotificationServicesController/utils/utils.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACI,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,QAAgB,EAChB,MAAyB,EACzB,IAAU;IAEV,MAAM,OAAO,GAAgB;QAC3B,MAAM;QACN,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,WAAW,EAAE;SACvC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC;IAEF,OAAO,MAAM,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAhBD,kCAgBC","sourcesContent":["/**\n * Performs an API call with automatic retries on failure.\n *\n * @param bearerToken - The JSON Web Token for authorization.\n * @param endpoint - The URL of the API endpoint to call.\n * @param method - The HTTP method ('POST' or 'DELETE').\n * @param body - The body of the request. It should be an object that can be serialized to JSON.\n * @returns A Promise that resolves to the response of the fetch request.\n */\nexport async function makeApiCall<Body>(\n  bearerToken: string,\n  endpoint: string,\n  method: 'POST' | 'DELETE',\n  body: Body,\n): Promise<Response> {\n  const options: RequestInit = {\n    method,\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${bearerToken}`,\n    },\n    body: JSON.stringify(body),\n  };\n\n  return await fetch(endpoint, options);\n}\n"]}

package/dist/NotificationServicesController/utils/utils.d.cts

@@ -1,143 +1,3 @@
-import type { TRIGGER_TYPES } from "../constants/notification-schema.cjs";
-import type { UserStorage } from "../types/user-storage/user-storage.cjs";
-export type NotificationTrigger = {
-    id: string;
-    chainId: string;
-    kind: string;
-    address: string;
-    enabled: boolean;
-};
-type MapTriggerFn<Result> = (trigger: NotificationTrigger) => Result | undefined;
-type TraverseTriggerOpts<Result> = {
-    address?: string;
-    mapTrigger?: MapTriggerFn<Result>;
-};
-/**
- * Create a completely new user storage object with the given accounts and state.
- * This method initializes the user storage with a version key and iterates over each account to populate it with triggers.
- * Each trigger is associated with supported chains, and for each chain, a unique identifier (UUID) is generated.
- * The trigger object contains a kind (`k`) indicating the type of trigger and an enabled state (`e`).
- * The kind and enabled state are stored with abbreviated keys to reduce the JSON size.
- *
- * This is used primarily for creating a new user storage (e.g. when first signing in/enabling notification profile syncing),
- * caution is needed in case you need to remove triggers that you don't want (due to notification setting filters)
- *
- * @param accounts - An array of account objects, each optionally containing an address.
- * @param state - A boolean indicating the initial enabled state for all triggers in the user storage.
- * @param shouldClean - prop to clean the initialized UserStorage (removing any invalid addresses). Only false for testing purposes.
- * @returns A `UserStorage` object populated with triggers for each account and chain.
- */
-export declare function initializeUserStorage(accounts: {
-    address?: string;
-}[], state: boolean, shouldClean?: boolean): UserStorage;
-/**
- * This is a fallback to ensure that we are not adding non-hex addresses, and the shape is valid.
- * Any invalid shapes will be removed.
- * NOTE - this method mutates and returns the cleaned User Storage.
- *
- * @param userStorage - notification user storage field we are to clean.
- * @returns a cleaned version of user storage.
- */
-export declare function cleanUserStorage(userStorage: UserStorage): UserStorage;
-/**
- * Iterates over user storage to find and optionally transform notification triggers.
- * This method allows for flexible retrieval and transformation of triggers based on provided options.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param options - Optional parameters to filter and map triggers:
- * - `address`: If provided, only triggers for this address are considered.
- * - `mapTrigger`: A function to transform each trigger. If not provided, triggers are returned as is.
- * @returns An array of triggers, potentially transformed by the `mapTrigger` function.
- */
-export declare function traverseUserStorageTriggers<ResultTriggers = NotificationTrigger>(userStorage: UserStorage, options?: TraverseTriggerOpts<ResultTriggers>): ResultTriggers[];
-/**
- * Verifies the presence of specified accounts and their chains in the user storage.
- * This method checks if each provided account exists in the user storage and if all its supported chains are present.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param accounts - An array of account addresses to check for presence.
- * @returns A record where each key is an account address and each value is a boolean indicating whether the account and all its supported chains are present in the user storage.
- */
-export declare function checkAccountsPresence(userStorage: UserStorage, accounts: string[]): Record<string, boolean>;
-/**
- * Infers and returns an array of enabled notification trigger kinds from the user storage.
- * This method counts the occurrences of each kind of trigger and returns the kinds that are present.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @returns An array of trigger kinds (`TRIGGER_TYPES`) that are enabled in the user storage.
- */
-export declare function inferEnabledKinds(userStorage: UserStorage): TRIGGER_TYPES[];
-/**
- * Retrieves all UUIDs associated with a specific account address from the user storage.
- * This function utilizes `traverseUserStorageTriggers` with a mapping function to extract
- * just the UUIDs of the notification triggers for the given address.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param address - The specific account address to retrieve UUIDs for.
- * @returns An array of UUID strings associated with the given account address.
- */
-export declare function getUUIDsForAccount(userStorage: UserStorage, address: string): string[];
-/**
- * Retrieves all UUIDs from the user storage, regardless of the account address or chain ID.
- * This method leverages `traverseUserStorageTriggers` with a specific mapping function (`triggerToId`)
- * to extract only the UUIDs from all notification triggers present in the user storage.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @returns An array of UUID strings from all notification triggers in the user storage.
- */
-export declare function getAllUUIDs(userStorage: UserStorage): string[];
-/**
- * Retrieves UUIDs for notification triggers that match any of the specified kinds.
- * This method filters triggers based on their kind and returns an array of UUIDs for those that match the allowed kinds.
- * It utilizes `traverseUserStorageTriggers` with a custom mapping function that checks if a trigger's kind is in the allowed list.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param allowedKinds - An array of kinds (as strings) to filter the triggers by.
- * @returns An array of UUID strings for triggers that match the allowed kinds.
- */
-export declare function getUUIDsForKinds(userStorage: UserStorage, allowedKinds: string[]): string[];
-/**
- * Retrieves notification triggers for a specific account address that match any of the specified kinds.
- * This method filters triggers both by the account address and their kind, returning triggers that match the allowed kinds for the specified address.
- * It leverages `traverseUserStorageTriggers` with a custom mapping function to filter and return only the relevant triggers.
- *
- * @param userStorage - The user storage object containing notification triggers.
- * @param address - The specific account address for which to retrieve triggers.
- * @param allowedKinds - An array of trigger kinds (`TRIGGER_TYPES`) to filter the triggers by.
- * @returns An array of `NotificationTrigger` objects that match the allowed kinds for the specified account address.
- */
-export declare function getUUIDsForAccountByKinds(userStorage: UserStorage, address: string, allowedKinds: TRIGGER_TYPES[]): NotificationTrigger[];
-/**
- * Upserts (updates or inserts) notification triggers for a given account across all supported chains.
- * This method ensures that each supported trigger type exists for each chain associated with the account.
- * If a trigger type does not exist for a chain, it creates a new trigger with a unique UUID.
- *
- * @param _account - The account address for which to upsert triggers. The address is normalized to lowercase.
- * @param userStorage - The user storage object to be updated with new or existing triggers.
- * @returns The updated user storage object with upserted triggers for the specified account.
- */
-export declare function upsertAddressTriggers(_account: string, userStorage: UserStorage): UserStorage;
-/**
- * Upserts (updates or inserts) notification triggers of a specific type across all accounts and chains in user storage.
- * This method ensures that a trigger of the specified type exists for each account and chain. If a trigger of the specified type
- * does not exist for an account and chain, it creates a new trigger with a unique UUID.
- *
- * @param triggerType - The type of trigger to upsert across all accounts and chains.
- * @param userStorage - The user storage object to be updated with new or existing triggers of the specified type.
- * @returns The updated user storage object with upserted triggers of the specified type for all accounts and chains.
- */
-export declare function upsertTriggerTypeTriggers(triggerType: TRIGGER_TYPES, userStorage: UserStorage): UserStorage;
-/**
- * Toggles the enabled status of a user storage trigger.
- *
- * @param userStorage - The user storage object.
- * @param address - The user's address.
- * @param chainId - The chain ID.
- * @param uuid - The unique identifier for the trigger.
- * @param enabled - The new enabled status.
- * @returns The updated user storage object.
- */
-export declare function toggleUserStorageTriggerStatus(userStorage: UserStorage, address: string, chainId: string, uuid: string, enabled: boolean): UserStorage;
 /**
  * Performs an API call with automatic retries on failure.
  *
@@ -148,5 +8,4 @@ export declare function toggleUserStorageTriggerStatus(userStorage: UserStorage,
  * @returns A Promise that resolves to the response of the fetch request.
  */
 export declare function makeApiCall<Body>(bearerToken: string, endpoint: string, method: 'POST' | 'DELETE', body: Body): Promise<Response>;
-export {};
 //# sourceMappingURL=utils.d.cts.map

package/dist/NotificationServicesController/utils/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../../src/NotificationServicesController/utils/utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,6CAAyC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,+CAA2C;AAEtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,YAAY,CAAC,MAAM,IAAI,CAC1B,OAAO,EAAE,mBAAmB,KACzB,MAAM,GAAG,SAAS,CAAC;AAExB,KAAK,mBAAmB,CAAC,MAAM,IAAI;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CACnC,CAAC;AAuBF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAChC,KAAK,EAAE,OAAO,EACd,WAAW,UAAO,GACjB,WAAW,CAkCb;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,eAaxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,GAAG,mBAAmB,EAEpC,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAC5C,cAAc,EAAE,CAkClB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AA+CD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,EAAE,CAU3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAKV;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAI9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,EAAE,CAMV;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,aAAa,EAAE,GAC5B,mBAAmB,EAAE,CAWvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,GACvB,WAAW,CA8Bb;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,aAAa,EAC1B,WAAW,EAAE,WAAW,GACvB,WAAW,CA0Bb;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,WAAW,CAMb;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,QAAQ,EACzB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,QAAQ,CAAC,CAWnB"}
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../../src/NotificationServicesController/utils/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,QAAQ,EACzB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,QAAQ,CAAC,CAWnB"}