@metamask/ramps-controller 15.1.0 → 17.0.0

package/dist/RampsController.cjs

@@ -10,11 +10,13 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     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 _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_getProviderScope, _RampsController_getDefaultRedirectUrl, _RampsController_pendingRequests, _RampsController_pendingResourceCount, _RampsController_pendingResourceGeneration, _RampsController_orderPollingMeta, _RampsController_orderPollingTimer, _RampsController_isPolling, _RampsController_initPromise, _RampsController_clearPendingResourceCountForDependentResources, _RampsController_abortDependentRequests, _RampsController_mutateRequests, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_requireRegion, _RampsController_isRegionCurrent, _RampsController_isTokenCurrent, _RampsController_isProviderCurrent, _RampsController_updateResourceField, _RampsController_setResourceLoading, _RampsController_setResourceError, _RampsController_updateRequestState, _RampsController_runInit, _RampsController_syncUserRegionFromCountriesCatalog, _RampsController_pickInAppQuote, _RampsController_getSupportingProvidersForRegion, _RampsController_filterProviderIdsBySupport, _RampsController_resolveProviderIdsForQuote, _RampsController_getPreferredProviderIdsFromOrders, _RampsController_refreshOrder, _RampsController_pollPendingOrders, _RampsController_syncTransakAuthOnError, _RampsController_getNormalizedTransakError;
+var _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_getDefaultRedirectUrl, _RampsController_pendingRequests, _RampsController_pendingResourceCount, _RampsController_pendingResourceGeneration, _RampsController_orderPollingMeta, _RampsController_orderPollingTimer, _RampsController_isPolling, _RampsController_initPromise, _RampsController_clearPendingResourceCountForDependentResources, _RampsController_abortDependentRequests, _RampsController_isAllProvidersEnabled, _RampsController_mutateRequests, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_requireRegion, _RampsController_isRegionCurrent, _RampsController_isTokenCurrent, _RampsController_isProviderCurrent, _RampsController_updateResourceField, _RampsController_setResourceLoading, _RampsController_setResourceError, _RampsController_updateRequestState, _RampsController_runInit, _RampsController_syncUserRegionFromCountriesCatalog, _RampsController_pickWidenedQuote, _RampsController_getSupportingProvidersForRegion, _RampsController_filterProviderIdsBySupport, _RampsController_resolveProviderIdsForQuote, _RampsController_getPreferredProviderIdsFromOrders, _RampsController_refreshOrder, _RampsController_pollPendingOrders, _RampsController_syncTransakAuthOnError, _RampsController_getNormalizedTransakError;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RampsController = exports.getInternalOrderCode = exports.normalizeProviderCode = exports.getDefaultRampsControllerState = exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = exports.controllerName = void 0;
+exports.RampsController = exports.getInternalOrderCode = exports.getDefaultRampsControllerState = exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
 const controller_utils_1 = require("@metamask/controller-utils");
+const featureFlags_1 = require("./featureFlags.cjs");
+const providerAvailability_1 = require("./providerAvailability.cjs");
 const rampsErrorCodes_1 = require("./rampsErrorCodes.cjs");
 const RampsService_1 = require("./RampsService.cjs");
 const RequestCache_1 = require("./RequestCache.cjs");
@@ -329,10 +331,6 @@ function findRegionFromCode(regionCode, countries) {
         regionCode: normalizedCode,
     };
 }
-function normalizeProviderCode(providerCode) {
-    return providerCode.replace(/^\/providers\//u, '');
-}
-exports.normalizeProviderCode = normalizeProviderCode;
 /**
  * Returns the internal MetaMask order code used for state lookups and polling.
  * Prefers the code embedded in the canonical order `id` path over `providerOrderId`,
@@ -441,13 +439,11 @@ class RampsController extends base_controller_1.BaseController {
      * controller. Missing properties will be filled in with defaults.
      * @param args.requestCacheTTL - Time to live for cached requests in milliseconds.
      * @param args.requestCacheMaxSize - Maximum number of entries in the request cache.
-     * @param args.getProviderScope - Optional callback returning the current
-     * provider-class scope for fiat quote widening. Defaults to `off`.
      * @param args.getDefaultRedirectUrl - Optional callback returning the default
-     * redirect URL used for the widened in-app quote fetch when the caller omits
+     * redirect URL used for the widened quote fetch when the caller omits
      * `redirectUrl`. Defaults to a callback returning `undefined`.
      */
-    constructor({ messenger, state = {}, requestCacheTTL = RequestCache_1.DEFAULT_REQUEST_CACHE_TTL, requestCacheMaxSize = RequestCache_1.DEFAULT_REQUEST_CACHE_MAX_SIZE, getProviderScope, getDefaultRedirectUrl, }) {
+    constructor({ messenger, state = {}, requestCacheTTL = RequestCache_1.DEFAULT_REQUEST_CACHE_TTL, requestCacheMaxSize = RequestCache_1.DEFAULT_REQUEST_CACHE_MAX_SIZE, getDefaultRedirectUrl, }) {
         super({
             messenger,
             metadata: rampsControllerMetadata,
@@ -469,12 +465,7 @@ class RampsController extends base_controller_1.BaseController {
          */
         _RampsController_requestCacheMaxSize.set(this, void 0);
         /**
-         * Resolves the current provider-class scope for fiat quote widening. Defaults
-         * to `() => 'off'` (native-only) when no callback is injected.
-         */
-        _RampsController_getProviderScope.set(this, void 0);
-        /**
-         * Resolves the default redirect URL for the widened in-app quote fetch when
+         * Resolves the default redirect URL for the widened quote fetch when
          * the caller omits `redirectUrl`. Defaults to `() => undefined` when no
          * callback is injected.
          */
@@ -500,7 +491,6 @@ class RampsController extends base_controller_1.BaseController {
         _RampsController_initPromise.set(this, null);
         __classPrivateFieldSet(this, _RampsController_requestCacheTTL, requestCacheTTL, "f");
         __classPrivateFieldSet(this, _RampsController_requestCacheMaxSize, requestCacheMaxSize, "f");
-        __classPrivateFieldSet(this, _RampsController_getProviderScope, getProviderScope ?? (() => 'off'), "f");
         __classPrivateFieldSet(this, _RampsController_getDefaultRedirectUrl, getDefaultRedirectUrl ?? (() => undefined), "f");
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
     }
@@ -1016,19 +1006,17 @@ class RampsController extends base_controller_1.BaseController {
         if (normalizedAssetIdForValidation === '') {
             throw new Error('assetId is required.');
         }
-        // When a non-`off` provider scope is active, widen the native-only
-        // auto-selection path to every supporting provider and pick the best in-app
-        // quote from the results (in-app vs external is only knowable per-quote via
-        // `buyWidget.browser`). Only the auto-select/restrict path that MM Pay's
+        // When the all-providers feature flag is enabled, widen the native-only
+        // auto-selection path to every supporting provider and pick the best
+        // quote from the results. Only the auto-select/restrict path that MM Pay's
         // `getRampsQuote` uses is affected; explicit-`providers` callers and the
-        // plain all-provider path are untouched.
-        const providerScope = __classPrivateFieldGet(this, _RampsController_getProviderScope, "f").call(this);
-        const widenToInAppProviders = providerScope !== 'off' &&
-            !options.providers &&
+        // plain all-provider path are untouched (and never read the flag).
+        const wantsAutoSelection = !options.providers &&
             (options.autoSelectProvider === true ||
                 options.restrictToKnownOrNativeProviders === true);
+        const widenToAllProviders = wantsAutoSelection && __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_isAllProvidersEnabled).call(this);
         let providersToUse;
-        let inAppProviderCatalog = this.state.providers.data;
+        let widenedProviderCatalog = this.state.providers.data;
         if (options.providers) {
             providersToUse = options.restrictToKnownOrNativeProviders
                 ? await __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_filterProviderIdsBySupport).call(this, {
@@ -1038,7 +1026,7 @@ class RampsController extends base_controller_1.BaseController {
                 })
                 : options.providers;
         }
-        else if (widenToInAppProviders) {
+        else if (widenToAllProviders) {
             // `#getSupportingProvidersForRegion` also hydrates the provider catalog
             // when controller state is empty, so all-provider quoting cannot silently
             // return zero providers here.
@@ -1046,7 +1034,7 @@ class RampsController extends base_controller_1.BaseController {
                 assetId: normalizedAssetIdForValidation,
                 region: regionToUse,
             });
-            inAppProviderCatalog = supporting;
+            widenedProviderCatalog = supporting;
             providersToUse = supporting.map((provider) => provider.id);
         }
         else if (options.autoSelectProvider ||
@@ -1078,12 +1066,12 @@ class RampsController extends base_controller_1.BaseController {
         // Under headless-buy gating, an empty resolved provider list means no
         // eligible (native/supporting) provider exists. Return an empty response
         // rather than passing `[]` to the service, which omits the provider filter
-        // and would quote every provider. This also guards the widened in-app path:
+        // and would quote every provider. This also guards the widened path:
         // a caller may trigger widening with `autoSelectProvider` alone (no
         // `restrictToKnownOrNativeProviders`), and an empty supporting set must not
         // fall through to unfiltered quotes from providers that do not support the
         // asset.
-        if ((options.restrictToKnownOrNativeProviders || widenToInAppProviders) &&
+        if ((options.restrictToKnownOrNativeProviders || widenToAllProviders) &&
             providersToUse.length === 0) {
             return { success: [], sorted: [], error: [], customActions: [] };
         }
@@ -1092,11 +1080,12 @@ class RampsController extends base_controller_1.BaseController {
         const normalizedAssetId = normalizedAssetIdForValidation;
         const normalizedWalletAddress = options.walletAddress.trim();
         // The quotes API only embeds a `buyURL`/`buyWidget` when a `redirectUrl` is
-        // present, so on the widened in-app path (where MM Pay omits one) supply the
+        // present, so on the widened path (where MM Pay omits one) supply the
         // injected default so aggregator quotes carry a usable widget URL. An
-        // explicit caller `redirectUrl` always wins, and scope `off` never injects.
+        // explicit caller `redirectUrl` always wins, and the native-only path
+        // (flag off) never injects.
         const effectiveRedirectUrl = options.redirectUrl ??
-            (widenToInAppProviders ? __classPrivateFieldGet(this, _RampsController_getDefaultRedirectUrl, "f").call(this) : undefined);
+            (widenToAllProviders ? __classPrivateFieldGet(this, _RampsController_getDefaultRedirectUrl, "f").call(this) : undefined);
         const cacheKey = (0, RequestCache_1.createCacheKey)('getQuotes', [
             normalizedRegion,
             normalizedFiat,
@@ -1125,22 +1114,21 @@ class RampsController extends base_controller_1.BaseController {
             forceRefresh: options.forceRefresh,
             ttl: options.ttl ?? DEFAULT_QUOTES_TTL,
         });
-        if (!widenToInAppProviders) {
+        if (!widenToAllProviders) {
             return response;
         }
-        // Reduce the widened multi-provider result to the single best in-app quote
+        // Reduce the widened multi-provider result to the single best quote
         // and place it at `success[0]`, since single-pick consumers
         // (`getRampsQuote` -> `success?.[0]`) rely on index 0 while `success[]`
         // order is server-defined rather than ranked.
-        const selectedQuote = __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_pickInAppQuote).call(this, response, {
-            scope: providerScope,
+        const selectedQuote = __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_pickWidenedQuote).call(this, response, {
             amount: options.amount,
             fiat: normalizedFiat,
-            providers: inAppProviderCatalog,
+            providers: widenedProviderCatalog,
         });
         if (!selectedQuote) {
-            // No usable in-app quote: surface "no quote" rather than leaking an
-            // external/custom quote to the single-pick consumer.
+            // No quote fits the published provider limits: surface "no quote"
+            // rather than handing the single-pick consumer an out-of-limits quote.
             return {
                 success: [],
                 sorted: response.sorted,
@@ -1253,7 +1241,7 @@ class RampsController extends base_controller_1.BaseController {
      *
      * @param params - Object containing order identifiers and wallet info.
      * @param params.orderId - Full order ID (e.g. "/providers/paypal/orders/abc123") or order code.
-     * @param params.providerCode - Provider code (e.g. "paypal", "transak"), with or without /providers/ prefix.
+     * @param params.providerCode - Canonical provider code (e.g. "paypal", "transak").
      * @param params.walletAddress - Wallet address for the order.
      * @param params.chainId - Optional chain ID for the order.
      */
@@ -1263,11 +1251,10 @@ class RampsController extends base_controller_1.BaseController {
         if (!orderCode?.trim()) {
             return;
         }
-        const normalizedProviderCode = normalizeProviderCode(providerCode);
         const stubOrder = {
             providerOrderId: orderCode,
             provider: {
-                id: `/providers/${normalizedProviderCode}`,
+                id: providerCode,
                 name: '',
                 environmentType: '',
                 description: '',
@@ -1771,7 +1758,7 @@ class RampsController extends base_controller_1.BaseController {
     }
 }
 exports.RampsController = RampsController;
-_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = new WeakMap(), _RampsController_getProviderScope = new WeakMap(), _RampsController_getDefaultRedirectUrl = new WeakMap(), _RampsController_pendingRequests = new WeakMap(), _RampsController_pendingResourceCount = new WeakMap(), _RampsController_pendingResourceGeneration = new WeakMap(), _RampsController_orderPollingMeta = new WeakMap(), _RampsController_orderPollingTimer = new WeakMap(), _RampsController_isPolling = new WeakMap(), _RampsController_initPromise = new WeakMap(), _RampsController_instances = new WeakSet(), _RampsController_clearPendingResourceCountForDependentResources = function _RampsController_clearPendingResourceCountForDependentResources() {
+_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = new WeakMap(), _RampsController_getDefaultRedirectUrl = new WeakMap(), _RampsController_pendingRequests = new WeakMap(), _RampsController_pendingResourceCount = new WeakMap(), _RampsController_pendingResourceGeneration = new WeakMap(), _RampsController_orderPollingMeta = new WeakMap(), _RampsController_orderPollingTimer = new WeakMap(), _RampsController_isPolling = new WeakMap(), _RampsController_initPromise = new WeakMap(), _RampsController_instances = new WeakSet(), _RampsController_clearPendingResourceCountForDependentResources = function _RampsController_clearPendingResourceCountForDependentResources() {
     for (const resourceType of DEPENDENT_RESOURCE_KEYS) {
         __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").delete(resourceType);
         const generation = __classPrivateFieldGet(this, _RampsController_pendingResourceGeneration, "f").get(resourceType) ?? 0;
@@ -1786,6 +1773,14 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
             __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_removeRequestState).call(this, cacheKey);
         }
     }
+}, _RampsController_isAllProvidersEnabled = function _RampsController_isAllProvidersEnabled() {
+    try {
+        const remoteFeatureFlagState = this.messenger.call('RemoteFeatureFlagController:getState');
+        return (0, featureFlags_1.isHeadlessAllProvidersEnabled)(remoteFeatureFlagState);
+    }
+    catch {
+        return false;
+    }
 }, _RampsController_mutateRequests = function _RampsController_mutateRequests(fn) {
     this.update((state) => {
         const requests = state.requests;
@@ -1897,14 +1892,10 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
     this.update((state) => {
         state.userRegion = userRegion;
     });
-}, _RampsController_pickInAppQuote = function _RampsController_pickInAppQuote(response, { scope, amount, fiat, providers, }) {
-    const providerByCode = new Map(providers.map((provider) => [
-        normalizeProviderCode(provider.id),
-        provider,
-    ]));
-    const customActionProviderCodes = new Set(response.customActions.map((action) => normalizeProviderCode(action.buy.providerId)));
+}, _RampsController_pickWidenedQuote = function _RampsController_pickWidenedQuote(response, { amount, fiat, providers, }) {
+    const providerByCode = new Map(providers.map((provider) => [provider.id, provider]));
     const fitsProviderLimits = (quote) => {
-        const provider = providerByCode.get(normalizeProviderCode(quote.provider));
+        const provider = providerByCode.get(quote.provider);
         const limit = provider?.limits?.fiat?.[fiat]?.[quote.quote.paymentMethod];
         if (!limit) {
             // No published limits for this provider/payment method: treat as
@@ -1913,37 +1904,18 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
         }
         return amount >= limit.minAmount && amount <= limit.maxAmount;
     };
-    const isEligible = (quote) => {
-        // `all` (Phase 2) skips the in-app-only exclusions; both scopes still
-        // enforce provider limits up front.
-        if (scope !== 'all') {
-            const providerCode = normalizeProviderCode(quote.provider);
-            if (customActionProviderCodes.has(providerCode)) {
-                return false;
-            }
-            // Defensive: the wire may carry an inline `isCustomAction` flag that is
-            // absent from the published `Quote` type.
-            if (quote.quote.isCustomAction === true) {
-                return false;
-            }
-            if (quote.quote.buyWidget?.browser === 'IN_APP_OS_BROWSER') {
-                return false;
-            }
-        }
-        return fitsProviderLimits(quote);
-    };
-    const candidates = response.success.filter(isEligible);
+    const candidates = response.success.filter(fitsProviderLimits);
     if (candidates.length === 0) {
         return undefined;
     }
-    const candidateByCode = new Map(candidates.map((quote) => [normalizeProviderCode(quote.provider), quote]));
+    const candidateByCode = new Map(candidates.map((quote) => [quote.provider, quote]));
     const pickBySortOrder = (sortBy) => {
         const order = response.sorted.find((entry) => entry.sortBy === sortBy)?.ids;
         if (!order) {
             return undefined;
         }
         for (const providerId of order) {
-            const match = candidateByCode.get(normalizeProviderCode(providerId));
+            const match = candidateByCode.get(providerId);
             if (match) {
                 return match;
             }
@@ -1977,18 +1949,10 @@ async function _RampsController_getSupportingProvidersForRegion({ assetId, regio
     else {
         ({ providers } = await this.getProviders(normalizedRegion));
     }
-    // EVM CAIP-19 asset IDs may arrive checksummed or lowercased, and the
-    // providers API returns both forms, so match case-insensitively on both
-    // sides. Only the lowercased forms are compared (the original IDs are never
-    // returned), so case-sensitive non-EVM asset IDs are not corrupted.
-    const normalizedAssetId = assetId.toLowerCase();
-    const supporting = providers.filter((provider) => {
-        const map = provider?.supportedCryptoCurrencies;
-        if (!map) {
-            return false;
-        }
-        return Object.keys(map).some((key) => key.toLowerCase() === normalizedAssetId);
-    });
+    // Case-insensitive CAIP-19 matching is shared with headless-buy consumers
+    // via `getProvidersServingAsset`, so the controller and the UI region gate
+    // cannot disagree about which providers serve the asset.
+    const supporting = (0, providerAvailability_1.getProvidersServingAsset)(providers, assetId);
     return { supporting, all: providers };
 }, _RampsController_filterProviderIdsBySupport = 
 /**