@metamask-previews/assets-controller 14.0.2-preview-3866c0ff1 → 14.0.2-preview-e3275932a

package/dist/middlewares/{CustomAssetGraduationMiddleware.js → CustomAssetGraduationMiddleware.mjs}

@@ -1,7 +1,19 @@
-import { KnownCaipNamespace } from '@metamask/utils';
-import { projectLogger, createModuleLogger } from '../logger.js';
-import { forDataTypes } from '../types.js';
-import { safeNormalizeAssetId } from '../utils/index.js';
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CustomAssetGraduationMiddleware_getSelectedAccountId, _CustomAssetGraduationMiddleware_removeCustomAsset;
+import { KnownCaipNamespace } from "@metamask/utils";
+import { projectLogger, createModuleLogger } from "../logger.mjs";
+import { forDataTypes } from "../types.mjs";
+import { safeNormalizeAssetId } from "../utils/index.mjs";
 const CONTROLLER_NAME = 'CustomAssetGraduationMiddleware';
 const log = createModuleLogger(projectLogger, CONTROLLER_NAME);
 /**
@@ -24,12 +36,12 @@ const log = createModuleLogger(projectLogger, CONTROLLER_NAME);
  *   incoming transfer is reflected promptly.
  */
 export class CustomAssetGraduationMiddleware {
-    name = CONTROLLER_NAME;
-    #getSelectedAccountId;
-    #removeCustomAsset;
     constructor(options) {
-        this.#getSelectedAccountId = options.getSelectedAccountId;
-        this.#removeCustomAsset = options.removeCustomAsset;
+        this.name = CONTROLLER_NAME;
+        _CustomAssetGraduationMiddleware_getSelectedAccountId.set(this, void 0);
+        _CustomAssetGraduationMiddleware_removeCustomAsset.set(this, void 0);
+        __classPrivateFieldSet(this, _CustomAssetGraduationMiddleware_getSelectedAccountId, options.getSelectedAccountId, "f");
+        __classPrivateFieldSet(this, _CustomAssetGraduationMiddleware_removeCustomAsset, options.removeCustomAsset, "f");
     }
     getName() {
         return this.name;
@@ -41,7 +53,7 @@ export class CustomAssetGraduationMiddleware {
             // Staked). This middleware is positioned in the pipeline before the
             // RPC fallback — RPC intentionally carries custom assets and must
             // never trigger graduation.
-            const accountId = this.#getSelectedAccountId();
+            const accountId = __classPrivateFieldGet(this, _CustomAssetGraduationMiddleware_getSelectedAccountId, "f").call(this);
             if (!accountId) {
                 return next(ctx);
             }
@@ -76,12 +88,13 @@ export class CustomAssetGraduationMiddleware {
                     accountId,
                     assetId: normalizedAssetId,
                 });
-                this.#removeCustomAsset(accountId, normalizedAssetId);
+                __classPrivateFieldGet(this, _CustomAssetGraduationMiddleware_removeCustomAsset, "f").call(this, accountId, normalizedAssetId);
             }
             return next(ctx);
         });
     }
 }
+_CustomAssetGraduationMiddleware_getSelectedAccountId = new WeakMap(), _CustomAssetGraduationMiddleware_removeCustomAsset = new WeakMap();
 /**
  * Check whether a CAIP-19 asset ID belongs to an EVM chain.
  *
@@ -112,4 +125,4 @@ function isEvmAssetId(assetId) {
 function hasPositiveBalance(balance) {
     return Number(balance?.amount) > 0;
 }
-//# sourceMappingURL=CustomAssetGraduationMiddleware.js.map
+//# sourceMappingURL=CustomAssetGraduationMiddleware.mjs.map

package/dist/middlewares/CustomAssetGraduationMiddleware.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomAssetGraduationMiddleware.mjs","sourceRoot":"","sources":["../../src/middlewares/CustomAssetGraduationMiddleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { KnownCaipNamespace } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger.js';\nimport { forDataTypes } from '../types.js';\nimport type {\n  AccountId,\n  AssetBalance,\n  Caip19AssetId,\n  Middleware,\n} from '../types.js';\nimport { safeNormalizeAssetId } from '../utils/index.js';\n\nconst CONTROLLER_NAME = 'CustomAssetGraduationMiddleware';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\nexport type CustomAssetGraduationMiddlewareOptions = {\n  getSelectedAccountId: () => AccountId | undefined;\n  removeCustomAsset: (accountId: AccountId, assetId: Caip19AssetId) => void;\n};\n\n/**\n * CustomAssetGraduationMiddleware removes EVM assets from `customAssets` when\n * an upstream balance source (AccountsAPI / Websocket) reports a non-zero\n * balance for them. Once a detector sees the asset with a real balance, it\n * no longer needs to be tracked as \"custom\" — the regular detection flow\n * will keep it fresh.\n *\n * Rules:\n * - Only the selected account's custom assets are considered. Switching the\n *   selected account triggers a fresh fetch, which re-runs graduation\n *   against the new account's balances.\n * - Only EVM (CAIP-2 namespace `eip155`) assets graduate. Non-EVM custom\n *   assets (Solana, BTC, Tron, etc. — served by Snap data sources) are left\n *   alone.\n * - Only positive balances graduate. A zero balance from AccountsAPI means\n *   the API knows about the token but the user does not currently hold it;\n *   keeping it in `customAssets` ensures RPC keeps polling so a future\n *   incoming transfer is reflected promptly.\n */\nexport class CustomAssetGraduationMiddleware {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #getSelectedAccountId: () => AccountId | undefined;\n\n  readonly #removeCustomAsset: (\n    accountId: AccountId,\n    assetId: Caip19AssetId,\n  ) => void;\n\n  constructor(options: CustomAssetGraduationMiddlewareOptions) {\n    this.#getSelectedAccountId = options.getSelectedAccountId;\n    this.#removeCustomAsset = options.removeCustomAsset;\n  }\n\n  getName(): string {\n    return this.name;\n  }\n\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['balance'], async (ctx, next) => {\n      // Inspect the response BEFORE calling next() so we only consider\n      // balances populated by upstream middleware (AccountsApi / Websocket /\n      // Staked). This middleware is positioned in the pipeline before the\n      // RPC fallback — RPC intentionally carries custom assets and must\n      // never trigger graduation.\n      const accountId = this.#getSelectedAccountId();\n      if (!accountId) {\n        return next(ctx);\n      }\n\n      const state = ctx.getAssetsState();\n      const customForAccount = state.customAssets?.[accountId] ?? [];\n      if (customForAccount.length === 0) {\n        return next(ctx);\n      }\n\n      const returnedBalances = ctx.response.assetsBalance?.[accountId] ?? {};\n      const returnedAssetIds = Object.keys(returnedBalances) as Caip19AssetId[];\n      if (returnedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      // customAssets state is stored with checksummed/normalized asset IDs.\n      // AccountsApiDataSource normalizes its response IDs, but\n      // AccountActivityDataSource does not — so we normalize the response\n      // side here to make the comparison robust to lower-case addresses\n      // delivered over the websocket.\n      const customSet = new Set(customForAccount);\n      for (const rawAssetId of returnedAssetIds) {\n        if (!isEvmAssetId(rawAssetId)) {\n          continue;\n        }\n        if (!hasPositiveBalance(returnedBalances[rawAssetId])) {\n          continue;\n        }\n        const normalizedAssetId = safeNormalizeAssetId(rawAssetId);\n        if (!customSet.has(normalizedAssetId)) {\n          continue;\n        }\n        log('Graduating custom asset', {\n          accountId,\n          assetId: normalizedAssetId,\n        });\n        this.#removeCustomAsset(accountId, normalizedAssetId);\n      }\n\n      return next(ctx);\n    });\n  }\n}\n\n/**\n * Check whether a CAIP-19 asset ID belongs to an EVM chain.\n *\n * @param assetId - The CAIP-19 asset ID to inspect.\n * @returns `true` when the asset's chain namespace is `eip155`.\n */\nfunction isEvmAssetId(assetId: Caip19AssetId): boolean {\n  // CAIP-19 format: <namespace>:<chainRef>/<assetNamespace>:<assetRef>\n  // The chain namespace is always the segment before the first colon.\n  const namespace = assetId.split(':')[0];\n  return namespace === KnownCaipNamespace.Eip155;\n}\n\n/**\n * Whether a balance entry reports a strictly positive amount. AccountsAPI\n * may return zero for tokens it indexes but the user no longer holds; we\n * treat those as non-graduating so RPC keeps polling and surfaces any\n * future incoming transfer immediately.\n *\n * `AssetBalance.amount` is already a human-readable decimal string from\n * both AccountsApi (e.g. \"0.283549083429656057\") and the websocket data\n * source (which divides by `decimals` before emitting), so a `Number()`\n * sign check is safe: `NaN`, `undefined`, empty strings, and zero all\n * fail the comparison.\n *\n * @param balance - The balance entry from the response.\n * @returns `true` when the balance amount represents a value greater than 0.\n */\nfunction hasPositiveBalance(balance: AssetBalance | undefined): boolean {\n  return Number(balance?.amount) > 0;\n}\n"]}

package/dist/middlewares/DetectionMiddleware.cjs

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DetectionMiddleware = void 0;
+const logger_js_1 = require("../logger.cjs");
+const types_js_1 = require("../types.cjs");
+const index_js_1 = require("../utils/index.cjs");
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const CONTROLLER_NAME = 'DetectionMiddleware';
+// Logger for debugging
+(0, logger_js_1.createModuleLogger)(logger_js_1.projectLogger, CONTROLLER_NAME);
+// ============================================================================
+// DETECTION MIDDLEWARE
+// ============================================================================
+/**
+ * DetectionMiddleware builds the set of assets that downstream sources use for
+ * metadata and price fetching.
+ *
+ * An asset is included in `detectedAssets` only when it is genuinely new:
+ * - Assets from `response.assetsBalance` are included only if they are absent
+ *   from BOTH `state.assetsBalance` (never tracked before) AND `state.assetsInfo`
+ *   (no metadata yet). Assets already present in either collection are considered
+ *   known and are intentionally excluded — PriceDataSource's own subscription
+ *   handles periodic refreshes for those.
+ * - Each account's custom assets from state are always included because they
+ *   may have no balance yet and are explicitly managed by the user.
+ *
+ * Usage:
+ * ```typescript
+ * const detectionMiddleware = new DetectionMiddleware();
+ * const middleware = detectionMiddleware.assetsMiddleware;
+ * ```
+ */
+class DetectionMiddleware {
+    constructor() {
+        this.name = CONTROLLER_NAME;
+    }
+    getName() {
+        return this.name;
+    }
+    /**
+     * Get the middleware that builds detectedAssets for metadata and price fetching.
+     *
+     * This middleware:
+     * 1. Includes assets from response.assetsBalance that are absent from both
+     *    state.assetsBalance and state.assetsInfo (brand-new assets only)
+     * 2. Always includes each account's custom assets from state
+     * 3. Fills response.detectedAssets with the resulting asset IDs per account
+     * 4. Queues detected assets that lack a price in state on
+     *    request.assetsForPriceUpdate so PriceDataSource fetches them in the same
+     *    pipeline pass (including the background RPC detection path)
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware() {
+        return (0, types_js_1.forDataTypes)(['balance'], async (ctx, next) => {
+            const { request, response } = ctx;
+            // Get state for custom assets, existing balances, and existing metadata
+            const state = ctx.getAssetsState();
+            const { customAssets: stateCustomAssets, assetsBalance: stateAssetsBalance, assetsInfo: stateAssetsInfo, assetsPrice: stateAssetsPrice, } = state;
+            const detectedAssets = {};
+            // 1. From balance response: only include assets that are genuinely new —
+            //    not already present in state.assetsBalance or state.assetsInfo.
+            if (response.assetsBalance) {
+                for (const [accountId, accountBalances] of Object.entries(response.assetsBalance)) {
+                    const detected = [];
+                    const stateAccountBalances = stateAssetsBalance[accountId] ?? {};
+                    for (const assetId of Object.keys(accountBalances)) {
+                        const caipAssetId = assetId;
+                        // Skip if already tracked in state balances or already has metadata
+                        if (stateAccountBalances[caipAssetId] !== undefined ||
+                            stateAssetsInfo[caipAssetId] !== undefined) {
+                            continue;
+                        }
+                        detected.push(caipAssetId);
+                    }
+                    // Merge custom assets for this account, applying the same filter:
+                    // skip if already in state balance or already has metadata.
+                    const customForAccount = stateCustomAssets?.[accountId] ?? [];
+                    for (const assetId of customForAccount) {
+                        if (detected.includes(assetId)) {
+                            continue;
+                        }
+                        if (stateAccountBalances[assetId] !== undefined ||
+                            stateAssetsInfo[assetId] !== undefined) {
+                            continue;
+                        }
+                        detected.push(assetId);
+                    }
+                    if (detected.length > 0) {
+                        detectedAssets[accountId] = detected;
+                    }
+                }
+            }
+            // 2. Accounts in request that weren't in balance response: include their
+            //    custom assets that are not yet in state.
+            for (const { account } of request.accountsWithSupportedChains) {
+                const accountId = account.id;
+                if (detectedAssets[accountId]) {
+                    continue;
+                }
+                const stateAccountBalances = stateAssetsBalance[accountId] ?? {};
+                const customForAccount = stateCustomAssets?.[accountId] ?? [];
+                const newCustomAssets = customForAccount.filter((assetId) => {
+                    const inBalance = stateAccountBalances[assetId] !== undefined;
+                    const inInfo = stateAssetsInfo[assetId] !== undefined;
+                    return !inBalance && !inInfo;
+                });
+                if (newCustomAssets.length > 0) {
+                    detectedAssets[accountId] = newCustomAssets;
+                }
+            }
+            if (Object.keys(detectedAssets).length > 0) {
+                response.detectedAssets = detectedAssets;
+            }
+            // Queue prices for:
+            // 1) newly detected assets missing a price, and
+            // 2) assets in this balance response that already exist in state but still
+            //    lack a price (e.g. natives seeded before the first price poll).
+            // PriceDataSource filters non-priceable IDs before calling the API.
+            const prices = stateAssetsPrice;
+            const missingPriceAssets = new Set();
+            const maybeQueue = (assetId) => {
+                const normalizedAssetId = (0, index_js_1.normalizeAssetId)(assetId);
+                if (prices[normalizedAssetId] === undefined &&
+                    prices[assetId] === undefined) {
+                    missingPriceAssets.add(normalizedAssetId);
+                }
+            };
+            for (const accountAssetIds of Object.values(detectedAssets)) {
+                for (const assetId of accountAssetIds) {
+                    maybeQueue(assetId);
+                }
+            }
+            if (response.assetsBalance) {
+                for (const accountBalances of Object.values(response.assetsBalance)) {
+                    for (const assetId of Object.keys(accountBalances)) {
+                        maybeQueue(assetId);
+                    }
+                }
+            }
+            if (missingPriceAssets.size > 0) {
+                request.assetsForPriceUpdate = [
+                    ...(request.assetsForPriceUpdate ?? []),
+                    ...missingPriceAssets,
+                ];
+            }
+            return next(ctx);
+        });
+    }
+}
+exports.DetectionMiddleware = DetectionMiddleware;
+//# sourceMappingURL=DetectionMiddleware.cjs.map

package/dist/middlewares/DetectionMiddleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.cjs","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { projectLogger, createModuleLogger } from '../logger.js';\nimport { forDataTypes } from '../types.js';\nimport type { AccountId, Caip19AssetId, Middleware } from '../types.js';\nimport { normalizeAssetId } from '../utils/index.js';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'DetectionMiddleware';\n\n// Logger for debugging\ncreateModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// DETECTION MIDDLEWARE\n// ============================================================================\n\n/**\n * DetectionMiddleware builds the set of assets that downstream sources use for\n * metadata and price fetching.\n *\n * An asset is included in `detectedAssets` only when it is genuinely new:\n * - Assets from `response.assetsBalance` are included only if they are absent\n *   from BOTH `state.assetsBalance` (never tracked before) AND `state.assetsInfo`\n *   (no metadata yet). Assets already present in either collection are considered\n *   known and are intentionally excluded — PriceDataSource's own subscription\n *   handles periodic refreshes for those.\n * - Each account's custom assets from state are always included because they\n *   may have no balance yet and are explicitly managed by the user.\n *\n * Usage:\n * ```typescript\n * const detectionMiddleware = new DetectionMiddleware();\n * const middleware = detectionMiddleware.assetsMiddleware;\n * ```\n */\nexport class DetectionMiddleware {\n  readonly name = CONTROLLER_NAME;\n\n  getName(): string {\n    return this.name;\n  }\n\n  /**\n   * Get the middleware that builds detectedAssets for metadata and price fetching.\n   *\n   * This middleware:\n   * 1. Includes assets from response.assetsBalance that are absent from both\n   *    state.assetsBalance and state.assetsInfo (brand-new assets only)\n   * 2. Always includes each account's custom assets from state\n   * 3. Fills response.detectedAssets with the resulting asset IDs per account\n   * 4. Queues detected assets that lack a price in state on\n   *    request.assetsForPriceUpdate so PriceDataSource fetches them in the same\n   *    pipeline pass (including the background RPC detection path)\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['balance'], async (ctx, next) => {\n      const { request, response } = ctx;\n\n      // Get state for custom assets, existing balances, and existing metadata\n      const state = ctx.getAssetsState();\n      const {\n        customAssets: stateCustomAssets,\n        assetsBalance: stateAssetsBalance,\n        assetsInfo: stateAssetsInfo,\n        assetsPrice: stateAssetsPrice,\n      } = state;\n\n      const detectedAssets: Record<AccountId, Caip19AssetId[]> = {};\n\n      // 1. From balance response: only include assets that are genuinely new —\n      //    not already present in state.assetsBalance or state.assetsInfo.\n      if (response.assetsBalance) {\n        for (const [accountId, accountBalances] of Object.entries(\n          response.assetsBalance,\n        )) {\n          const detected: Caip19AssetId[] = [];\n\n          const stateAccountBalances = stateAssetsBalance[accountId] ?? {};\n\n          for (const assetId of Object.keys(\n            accountBalances as Record<string, unknown>,\n          )) {\n            const caipAssetId = assetId as Caip19AssetId;\n            // Skip if already tracked in state balances or already has metadata\n            if (\n              stateAccountBalances[caipAssetId] !== undefined ||\n              stateAssetsInfo[caipAssetId] !== undefined\n            ) {\n              continue;\n            }\n            detected.push(caipAssetId);\n          }\n\n          // Merge custom assets for this account, applying the same filter:\n          // skip if already in state balance or already has metadata.\n          const customForAccount = stateCustomAssets?.[accountId] ?? [];\n          for (const assetId of customForAccount) {\n            if (detected.includes(assetId)) {\n              continue;\n            }\n            if (\n              stateAccountBalances[assetId] !== undefined ||\n              stateAssetsInfo[assetId] !== undefined\n            ) {\n              continue;\n            }\n            detected.push(assetId);\n          }\n\n          if (detected.length > 0) {\n            detectedAssets[accountId] = detected;\n          }\n        }\n      }\n\n      // 2. Accounts in request that weren't in balance response: include their\n      //    custom assets that are not yet in state.\n      for (const { account } of request.accountsWithSupportedChains) {\n        const accountId = account.id;\n        if (detectedAssets[accountId]) {\n          continue;\n        }\n        const stateAccountBalances = stateAssetsBalance[accountId] ?? {};\n        const customForAccount = stateCustomAssets?.[accountId] ?? [];\n        const newCustomAssets = customForAccount.filter((assetId) => {\n          const inBalance = stateAccountBalances[assetId] !== undefined;\n          const inInfo = stateAssetsInfo[assetId] !== undefined;\n          return !inBalance && !inInfo;\n        });\n        if (newCustomAssets.length > 0) {\n          detectedAssets[accountId] = newCustomAssets;\n        }\n      }\n\n      if (Object.keys(detectedAssets).length > 0) {\n        response.detectedAssets = detectedAssets;\n      }\n\n      // Queue prices for:\n      // 1) newly detected assets missing a price, and\n      // 2) assets in this balance response that already exist in state but still\n      //    lack a price (e.g. natives seeded before the first price poll).\n      // PriceDataSource filters non-priceable IDs before calling the API.\n      const prices = stateAssetsPrice as Record<string, unknown>;\n      const missingPriceAssets = new Set<Caip19AssetId>();\n\n      const maybeQueue = (assetId: Caip19AssetId): void => {\n        const normalizedAssetId = normalizeAssetId(assetId);\n        if (\n          prices[normalizedAssetId] === undefined &&\n          prices[assetId] === undefined\n        ) {\n          missingPriceAssets.add(normalizedAssetId);\n        }\n      };\n\n      for (const accountAssetIds of Object.values(detectedAssets)) {\n        for (const assetId of accountAssetIds) {\n          maybeQueue(assetId);\n        }\n      }\n\n      if (response.assetsBalance) {\n        for (const accountBalances of Object.values(response.assetsBalance)) {\n          for (const assetId of Object.keys(\n            accountBalances as Record<string, unknown>,\n          )) {\n            maybeQueue(assetId as Caip19AssetId);\n          }\n        }\n      }\n\n      if (missingPriceAssets.size > 0) {\n        request.assetsForPriceUpdate = [\n          ...(request.assetsForPriceUpdate ?? []),\n          ...missingPriceAssets,\n        ];\n      }\n\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/middlewares/{DetectionMiddleware.d.ts → DetectionMiddleware.d.cts}

@@ -1,4 +1,4 @@
-import type { Middleware } from '../types.js';
+import type { Middleware } from "../types.cjs";
 /**
  * DetectionMiddleware builds the set of assets that downstream sources use for
  * metadata and price fetching.
@@ -37,4 +37,4 @@ export declare class DetectionMiddleware {
      */
     get assetsMiddleware(): Middleware;
 }
-//# sourceMappingURL=DetectionMiddleware.d.ts.map
+//# sourceMappingURL=DetectionMiddleware.d.cts.map

package/dist/middlewares/DetectionMiddleware.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.d.cts","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA4B,UAAU,EAAE,qBAAoB;AAgBxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,yBAAmB;IAEhC,OAAO,IAAI,MAAM;IAIjB;;;;;;;;;;;;;OAaG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA+HjC;CACF"}

package/dist/middlewares/DetectionMiddleware.d.mts

@@ -0,0 +1,40 @@
+import type { Middleware } from "../types.mjs";
+/**
+ * DetectionMiddleware builds the set of assets that downstream sources use for
+ * metadata and price fetching.
+ *
+ * An asset is included in `detectedAssets` only when it is genuinely new:
+ * - Assets from `response.assetsBalance` are included only if they are absent
+ *   from BOTH `state.assetsBalance` (never tracked before) AND `state.assetsInfo`
+ *   (no metadata yet). Assets already present in either collection are considered
+ *   known and are intentionally excluded — PriceDataSource's own subscription
+ *   handles periodic refreshes for those.
+ * - Each account's custom assets from state are always included because they
+ *   may have no balance yet and are explicitly managed by the user.
+ *
+ * Usage:
+ * ```typescript
+ * const detectionMiddleware = new DetectionMiddleware();
+ * const middleware = detectionMiddleware.assetsMiddleware;
+ * ```
+ */
+export declare class DetectionMiddleware {
+    readonly name = "DetectionMiddleware";
+    getName(): string;
+    /**
+     * Get the middleware that builds detectedAssets for metadata and price fetching.
+     *
+     * This middleware:
+     * 1. Includes assets from response.assetsBalance that are absent from both
+     *    state.assetsBalance and state.assetsInfo (brand-new assets only)
+     * 2. Always includes each account's custom assets from state
+     * 3. Fills response.detectedAssets with the resulting asset IDs per account
+     * 4. Queues detected assets that lack a price in state on
+     *    request.assetsForPriceUpdate so PriceDataSource fetches them in the same
+     *    pipeline pass (including the background RPC detection path)
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware(): Middleware;
+}
+//# sourceMappingURL=DetectionMiddleware.d.mts.map

package/dist/middlewares/DetectionMiddleware.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.d.mts","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA4B,UAAU,EAAE,qBAAoB;AAgBxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,yBAAmB;IAEhC,OAAO,IAAI,MAAM;IAIjB;;;;;;;;;;;;;OAaG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA+HjC;CACF"}

package/dist/middlewares/{DetectionMiddleware.js → DetectionMiddleware.mjs}

@@ -1,6 +1,6 @@
-import { projectLogger, createModuleLogger } from '../logger.js';
-import { forDataTypes } from '../types.js';
-import { normalizeAssetId } from '../utils/index.js';
+import { projectLogger, createModuleLogger } from "../logger.mjs";
+import { forDataTypes } from "../types.mjs";
+import { normalizeAssetId } from "../utils/index.mjs";
 // ============================================================================
 // CONSTANTS
 // ============================================================================
@@ -30,7 +30,9 @@ createModuleLogger(projectLogger, CONTROLLER_NAME);
  * ```
  */
 export class DetectionMiddleware {
-    name = CONTROLLER_NAME;
+    constructor() {
+        this.name = CONTROLLER_NAME;
+    }
     getName() {
         return this.name;
     }
@@ -145,4 +147,4 @@ export class DetectionMiddleware {
         });
     }
 }
-//# sourceMappingURL=DetectionMiddleware.js.map
+//# sourceMappingURL=DetectionMiddleware.mjs.map

package/dist/middlewares/DetectionMiddleware.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.mjs","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { projectLogger, createModuleLogger } from '../logger.js';\nimport { forDataTypes } from '../types.js';\nimport type { AccountId, Caip19AssetId, Middleware } from '../types.js';\nimport { normalizeAssetId } from '../utils/index.js';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'DetectionMiddleware';\n\n// Logger for debugging\ncreateModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// DETECTION MIDDLEWARE\n// ============================================================================\n\n/**\n * DetectionMiddleware builds the set of assets that downstream sources use for\n * metadata and price fetching.\n *\n * An asset is included in `detectedAssets` only when it is genuinely new:\n * - Assets from `response.assetsBalance` are included only if they are absent\n *   from BOTH `state.assetsBalance` (never tracked before) AND `state.assetsInfo`\n *   (no metadata yet). Assets already present in either collection are considered\n *   known and are intentionally excluded — PriceDataSource's own subscription\n *   handles periodic refreshes for those.\n * - Each account's custom assets from state are always included because they\n *   may have no balance yet and are explicitly managed by the user.\n *\n * Usage:\n * ```typescript\n * const detectionMiddleware = new DetectionMiddleware();\n * const middleware = detectionMiddleware.assetsMiddleware;\n * ```\n */\nexport class DetectionMiddleware {\n  readonly name = CONTROLLER_NAME;\n\n  getName(): string {\n    return this.name;\n  }\n\n  /**\n   * Get the middleware that builds detectedAssets for metadata and price fetching.\n   *\n   * This middleware:\n   * 1. Includes assets from response.assetsBalance that are absent from both\n   *    state.assetsBalance and state.assetsInfo (brand-new assets only)\n   * 2. Always includes each account's custom assets from state\n   * 3. Fills response.detectedAssets with the resulting asset IDs per account\n   * 4. Queues detected assets that lack a price in state on\n   *    request.assetsForPriceUpdate so PriceDataSource fetches them in the same\n   *    pipeline pass (including the background RPC detection path)\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['balance'], async (ctx, next) => {\n      const { request, response } = ctx;\n\n      // Get state for custom assets, existing balances, and existing metadata\n      const state = ctx.getAssetsState();\n      const {\n        customAssets: stateCustomAssets,\n        assetsBalance: stateAssetsBalance,\n        assetsInfo: stateAssetsInfo,\n        assetsPrice: stateAssetsPrice,\n      } = state;\n\n      const detectedAssets: Record<AccountId, Caip19AssetId[]> = {};\n\n      // 1. From balance response: only include assets that are genuinely new —\n      //    not already present in state.assetsBalance or state.assetsInfo.\n      if (response.assetsBalance) {\n        for (const [accountId, accountBalances] of Object.entries(\n          response.assetsBalance,\n        )) {\n          const detected: Caip19AssetId[] = [];\n\n          const stateAccountBalances = stateAssetsBalance[accountId] ?? {};\n\n          for (const assetId of Object.keys(\n            accountBalances as Record<string, unknown>,\n          )) {\n            const caipAssetId = assetId as Caip19AssetId;\n            // Skip if already tracked in state balances or already has metadata\n            if (\n              stateAccountBalances[caipAssetId] !== undefined ||\n              stateAssetsInfo[caipAssetId] !== undefined\n            ) {\n              continue;\n            }\n            detected.push(caipAssetId);\n          }\n\n          // Merge custom assets for this account, applying the same filter:\n          // skip if already in state balance or already has metadata.\n          const customForAccount = stateCustomAssets?.[accountId] ?? [];\n          for (const assetId of customForAccount) {\n            if (detected.includes(assetId)) {\n              continue;\n            }\n            if (\n              stateAccountBalances[assetId] !== undefined ||\n              stateAssetsInfo[assetId] !== undefined\n            ) {\n              continue;\n            }\n            detected.push(assetId);\n          }\n\n          if (detected.length > 0) {\n            detectedAssets[accountId] = detected;\n          }\n        }\n      }\n\n      // 2. Accounts in request that weren't in balance response: include their\n      //    custom assets that are not yet in state.\n      for (const { account } of request.accountsWithSupportedChains) {\n        const accountId = account.id;\n        if (detectedAssets[accountId]) {\n          continue;\n        }\n        const stateAccountBalances = stateAssetsBalance[accountId] ?? {};\n        const customForAccount = stateCustomAssets?.[accountId] ?? [];\n        const newCustomAssets = customForAccount.filter((assetId) => {\n          const inBalance = stateAccountBalances[assetId] !== undefined;\n          const inInfo = stateAssetsInfo[assetId] !== undefined;\n          return !inBalance && !inInfo;\n        });\n        if (newCustomAssets.length > 0) {\n          detectedAssets[accountId] = newCustomAssets;\n        }\n      }\n\n      if (Object.keys(detectedAssets).length > 0) {\n        response.detectedAssets = detectedAssets;\n      }\n\n      // Queue prices for:\n      // 1) newly detected assets missing a price, and\n      // 2) assets in this balance response that already exist in state but still\n      //    lack a price (e.g. natives seeded before the first price poll).\n      // PriceDataSource filters non-priceable IDs before calling the API.\n      const prices = stateAssetsPrice as Record<string, unknown>;\n      const missingPriceAssets = new Set<Caip19AssetId>();\n\n      const maybeQueue = (assetId: Caip19AssetId): void => {\n        const normalizedAssetId = normalizeAssetId(assetId);\n        if (\n          prices[normalizedAssetId] === undefined &&\n          prices[assetId] === undefined\n        ) {\n          missingPriceAssets.add(normalizedAssetId);\n        }\n      };\n\n      for (const accountAssetIds of Object.values(detectedAssets)) {\n        for (const assetId of accountAssetIds) {\n          maybeQueue(assetId);\n        }\n      }\n\n      if (response.assetsBalance) {\n        for (const accountBalances of Object.values(response.assetsBalance)) {\n          for (const assetId of Object.keys(\n            accountBalances as Record<string, unknown>,\n          )) {\n            maybeQueue(assetId as Caip19AssetId);\n          }\n        }\n      }\n\n      if (missingPriceAssets.size > 0) {\n        request.assetsForPriceUpdate = [\n          ...(request.assetsForPriceUpdate ?? []),\n          ...missingPriceAssets,\n        ];\n      }\n\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/middlewares/ParallelMiddleware.cjs

@@ -0,0 +1,263 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createParallelMiddleware = exports.createParallelBalanceMiddleware = exports.mergeDataResponses = void 0;
+const p_limit_1 = __importDefault(require("p-limit/index.js"));
+// ============================================================================
+// MERGE HELPER
+// ============================================================================
+/**
+ * Deep-merge multiple DataResponses into one.
+ * Used when running balance data sources in parallel.
+ *
+ * @param responses - Array of DataResponse from each source.
+ * @returns Single merged DataResponse.
+ */
+function mergeDataResponses(responses) {
+    const merged = {};
+    for (const response of responses) {
+        if (response.assetsBalance) {
+            merged.assetsBalance ?? (merged.assetsBalance = {});
+            for (const [accountId, accountBalances] of Object.entries(response.assetsBalance)) {
+                merged.assetsBalance[accountId] = {
+                    ...(merged.assetsBalance[accountId] ?? {}),
+                    ...accountBalances,
+                };
+            }
+        }
+        if (response.assetsInfo) {
+            merged.assetsInfo = {
+                ...(merged.assetsInfo ?? {}),
+                ...response.assetsInfo,
+            };
+        }
+        if (response.assetsPrice) {
+            merged.assetsPrice = {
+                ...(merged.assetsPrice ?? {}),
+                ...response.assetsPrice,
+            };
+        }
+        if (response.errors) {
+            merged.errors = {
+                ...(merged.errors ?? {}),
+                ...response.errors,
+            };
+        }
+        if (response.detectedAssets) {
+            merged.detectedAssets = {
+                ...(merged.detectedAssets ?? {}),
+                ...response.detectedAssets,
+            };
+        }
+        if (response.updateMode === 'full') {
+            merged.updateMode = 'full';
+        }
+        else if (response.updateMode === 'merge' &&
+            merged.updateMode !== 'full') {
+            merged.updateMode = 'merge';
+        }
+        if (response.replaceCoveredChainBalances) {
+            merged.replaceCoveredChainBalances = true;
+        }
+    }
+    merged.updateMode ?? (merged.updateMode = 'merge');
+    return merged;
+}
+exports.mergeDataResponses = mergeDataResponses;
+// ============================================================================
+// PARALLEL BALANCE MIDDLEWARE
+// ============================================================================
+const PARALLEL_BALANCE_MIDDLEWARE_NAME = 'ParallelBalanceMiddleware';
+/** Max concurrent balance source calls (round 1 and fallback). */
+const BALANCE_CONCURRENCY = 3;
+/**
+ * Partition request.chainIds so each chain is assigned to exactly one source
+ * (by source order: first source that supports the chain gets it). Ensures no
+ * chain overlap across data source calls.
+ *
+ * @param request - The data request with chainIds to partition.
+ * @param sources - Balance sources in priority order (e.g. AccountsAPI, Snap, Rpc).
+ * @returns Array of requests, one per source, each with only that source's assigned chainIds.
+ */
+function partitionChainsBySource(request, sources) {
+    const { chainIds } = request;
+    const assigned = new Set();
+    return sources.map((source) => {
+        const supported = new Set(source.getActiveChainsSync());
+        const chainsForSource = chainIds.filter((id) => supported.has(id) && !assigned.has(id));
+        chainsForSource.forEach((id) => assigned.add(id));
+        return {
+            ...request,
+            chainIds: chainsForSource,
+        };
+    });
+}
+/**
+ * Collect chain IDs that failed in the first round (present in response.errors).
+ * Used to run a fallback round with remaining sources.
+ *
+ * @param requests - Partitioned requests, one per source (same order as results).
+ * @param results - Results from each source; chain IDs in requests[i] that have errors in results[i].response.errors are considered failed.
+ * @returns Set of chain IDs that had errors in the first round.
+ */
+function getFailedChainIds(requests, results) {
+    const failed = new Set();
+    for (let i = 0; i < results.length; i++) {
+        const errors = results[i].response.errors ?? {};
+        for (const chainId of requests[i].chainIds) {
+            if (errors[chainId]) {
+                failed.add(chainId);
+            }
+        }
+    }
+    return failed;
+}
+/**
+ * Middleware that runs multiple balance data source middlewares in parallel,
+ * with no chain overlap. Chains that fail (response.errors) are re-partitioned
+ * and fetched again in a fallback round so lower-priority sources can try them.
+ *
+ * @param sources - Array of balance sources in priority order (each with getName(), getActiveChainsSync(), assetsMiddleware).
+ * @returns A single middleware that runs all sources in parallel and merges responses.
+ */
+function createParallelBalanceMiddleware(sources) {
+    return {
+        getName() {
+            return PARALLEL_BALANCE_MIDDLEWARE_NAME;
+        },
+        assetsMiddleware: async (context, next) => {
+            if (sources.length === 0) {
+                return next(context);
+            }
+            const noopNext = async (ctx) => ctx;
+            const limit = (0, p_limit_1.default)(BALANCE_CONCURRENCY);
+            // Round 1: partition chains (no overlap), run with limited concurrency
+            const requests = partitionChainsBySource(context.request, sources);
+            const round1Timed = await Promise.all(sources.map((source, i) => limit(async () => {
+                const start = Date.now();
+                const result = await source.assetsMiddleware({
+                    request: requests[i],
+                    response: {},
+                    getAssetsState: context.getAssetsState,
+                }, noopNext);
+                const durationMs = Date.now() - start;
+                return { result, sourceName: source.getName(), durationMs };
+            })));
+            const results = round1Timed.map((entry) => entry.result);
+            const durationByDataSource = {
+                ...context.durationByDataSource,
+            };
+            for (const { sourceName, durationMs } of round1Timed) {
+                const key = `${PARALLEL_BALANCE_MIDDLEWARE_NAME}.${sourceName}`;
+                durationByDataSource[key] =
+                    (durationByDataSource[key] ?? 0) + durationMs;
+            }
+            let mergedResponse = mergeDataResponses(results.map((result) => result.response));
+            // Fallback: chains that failed (in errors) get re-partitioned and tried again
+            const failedChainIds = getFailedChainIds(requests, results);
+            if (failedChainIds.size > 0) {
+                const fallbackRequest = {
+                    ...context.request,
+                    chainIds: [...failedChainIds],
+                };
+                const fallbackRequests = partitionChainsBySource(fallbackRequest, sources);
+                const fallbackTimed = await Promise.all(sources.map((source, i) => limit(async () => {
+                    const start = Date.now();
+                    const result = await source.assetsMiddleware({
+                        request: fallbackRequests[i],
+                        response: {},
+                        getAssetsState: context.getAssetsState,
+                    }, noopNext);
+                    const durationMs = Date.now() - start;
+                    return { result, sourceName: source.getName(), durationMs };
+                })));
+                const fallbackResults = fallbackTimed.map((entry) => entry.result);
+                for (const { sourceName, durationMs } of fallbackTimed) {
+                    const key = `${PARALLEL_BALANCE_MIDDLEWARE_NAME}.${sourceName}`;
+                    durationByDataSource[key] =
+                        (durationByDataSource[key] ?? 0) + durationMs;
+                }
+                const fallbackMerged = mergeDataResponses(fallbackResults.map((result) => result.response));
+                mergedResponse = mergeDataResponses([mergedResponse, fallbackMerged]);
+                // Remove errors for chains we successfully got balance for in fallback
+                if (mergedResponse.errors && mergedResponse.assetsBalance) {
+                    const chainsWithBalance = new Set();
+                    for (const accountBalances of Object.values(mergedResponse.assetsBalance)) {
+                        for (const assetId of Object.keys(accountBalances)) {
+                            const chainId = assetId.split('/')[0];
+                            chainsWithBalance.add(chainId);
+                        }
+                    }
+                    for (const chainId of failedChainIds) {
+                        if (chainsWithBalance.has(chainId)) {
+                            delete mergedResponse.errors[chainId];
+                        }
+                    }
+                }
+            }
+            return next({
+                ...context,
+                response: mergeDataResponses([context.response, mergedResponse]),
+                durationByDataSource,
+            });
+        },
+    };
+}
+exports.createParallelBalanceMiddleware = createParallelBalanceMiddleware;
+// ============================================================================
+// PARALLEL TOKEN/PRICE MIDDLEWARE
+// ============================================================================
+const PARALLEL_MIDDLEWARE_NAME = 'ParallelMiddleware';
+/** Max concurrent token/price source calls. */
+const CONCURRENCY = 2;
+/**
+ * Middleware that runs multiple data source middlewares (e.g. TokenDataSource,
+ * PriceDataSource) in parallel with the same request. Responses are merged so
+ * that assetsInfo (token metadata) and assetsPrice are combined. Use this to
+ * fetch token and price data concurrently instead of sequentially.
+ *
+ * @param sources - Array of named middleware sources (getName + assetsMiddleware).
+ * @returns A single middleware that runs all sources in parallel and merges responses.
+ */
+function createParallelMiddleware(sources) {
+    return {
+        getName() {
+            return PARALLEL_MIDDLEWARE_NAME;
+        },
+        assetsMiddleware: async (context, next) => {
+            if (sources.length === 0) {
+                return next(context);
+            }
+            const noopNext = async (ctx) => ctx;
+            const limit = (0, p_limit_1.default)(CONCURRENCY);
+            const timedResults = await Promise.all(sources.map((source) => limit(async () => {
+                const start = Date.now();
+                const result = await source.assetsMiddleware({
+                    request: context.request,
+                    response: { ...context.response },
+                    getAssetsState: context.getAssetsState,
+                }, noopNext);
+                const durationMs = Date.now() - start;
+                return { result, sourceName: source.getName(), durationMs };
+            })));
+            const results = timedResults.map((entry) => entry.result);
+            const mergedResponse = mergeDataResponses(results.map((result) => result.response));
+            const durationByDataSource = {
+                ...context.durationByDataSource,
+            };
+            for (const { sourceName, durationMs } of timedResults) {
+                durationByDataSource[`${PARALLEL_MIDDLEWARE_NAME}.${sourceName}`] =
+                    durationMs;
+            }
+            return next({
+                ...context,
+                response: mergeDataResponses([context.response, mergedResponse]),
+                durationByDataSource,
+            });
+        },
+    };
+}
+exports.createParallelMiddleware = createParallelMiddleware;
+//# sourceMappingURL=ParallelMiddleware.cjs.map