@metamask-previews/ramps-controller 15.0.0-preview-022b2ce8d → 15.0.0-preview-8980fa5

package/CHANGELOG.md

@@ -7,11 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add an optional `getProviderScope` callback to `RampsControllerOptions` and export the `ProviderScope` type (`'off' | 'in-app' | 'all'`); when it returns a non-`off` scope, `RampsController.getQuotes` widens its native-only auto-selection (the `autoSelectProvider` / `restrictToKnownOrNativeProviders` path) to every supporting provider and returns the best in-app quote at `success[0]`, excluding external-browser and custom-action quotes and enforcing per-provider fiat limits, while the default stays native-only and explicit-`providers` callers are unaffected ([#9353](https://github.com/MetaMask/core/pull/9353))
+- Add an optional `getDefaultRedirectUrl` callback to `RampsControllerOptions`; on the widened in-app auto-selection path, when the caller omits `redirectUrl`, `RampsController.getQuotes` now supplies this default so aggregator quotes carry the `buyURL`/`buyWidget` widget URL the app needs, while an explicit caller `redirectUrl` always wins and scope `off` never injects a default ([#9353](https://github.com/MetaMask/core/pull/9353))
+
 ### Changed
 
 - Refetch the countries catalog on every app startup via `init()` so region preset amounts (e.g. default amounts) stay current ([#9261](https://github.com/MetaMask/core/pull/9261))
 - Re-sync `userRegion` preset amounts from the countries catalog after each `getCountries()` call ([#9261](https://github.com/MetaMask/core/pull/9261))
 - On startup, `init()` now preserves an already-persisted `userRegion` when the refreshed countries catalog is momentarily empty or no longer lists that region, instead of clearing it ([#9261](https://github.com/MetaMask/core/pull/9261))
+- Bump `@metamask/messenger` from `^1.2.0` to `^2.0.0` ([#9392](https://github.com/MetaMask/core/pull/9392))
 
 ## [15.0.0]
 

package/dist/RampsController.cjs

@@ -10,7 +10,7 @@ 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_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_getSupportingProvidersForRegion, _RampsController_filterProviderIdsBySupport, _RampsController_resolveProviderIdsForQuote, _RampsController_getPreferredProviderIdsFromOrders, _RampsController_refreshOrder, _RampsController_pollPendingOrders, _RampsController_syncTransakAuthOnError, _RampsController_getNormalizedTransakError;
+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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RampsController = exports.getInternalOrderCode = exports.normalizeProviderCode = exports.getDefaultRampsControllerState = exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
@@ -441,8 +441,13 @@ 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
+     * `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, }) {
+    constructor({ messenger, state = {}, requestCacheTTL = RequestCache_1.DEFAULT_REQUEST_CACHE_TTL, requestCacheMaxSize = RequestCache_1.DEFAULT_REQUEST_CACHE_MAX_SIZE, getProviderScope, getDefaultRedirectUrl, }) {
         super({
             messenger,
             metadata: rampsControllerMetadata,
@@ -463,6 +468,17 @@ class RampsController extends base_controller_1.BaseController {
          * Maximum number of entries in the request cache.
          */
         _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
+         * the caller omits `redirectUrl`. Defaults to `() => undefined` when no
+         * callback is injected.
+         */
+        _RampsController_getDefaultRedirectUrl.set(this, void 0);
         /**
          * Map of pending requests for deduplication.
          * Key is the cache key, value is the pending request with abort controller.
@@ -484,6 +500,8 @@ 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);
     }
     /**
@@ -998,7 +1016,19 @@ 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
+        // `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 &&
+            (options.autoSelectProvider === true ||
+                options.restrictToKnownOrNativeProviders === true);
         let providersToUse;
+        let inAppProviderCatalog = this.state.providers.data;
         if (options.providers) {
             providersToUse = options.restrictToKnownOrNativeProviders
                 ? await __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_filterProviderIdsBySupport).call(this, {
@@ -1008,6 +1038,17 @@ class RampsController extends base_controller_1.BaseController {
                 })
                 : options.providers;
         }
+        else if (widenToInAppProviders) {
+            // `#getSupportingProvidersForRegion` also hydrates the provider catalog
+            // when controller state is empty, so all-provider quoting cannot silently
+            // return zero providers here.
+            const { supporting } = await __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_getSupportingProvidersForRegion).call(this, {
+                assetId: normalizedAssetIdForValidation,
+                region: regionToUse,
+            });
+            inAppProviderCatalog = supporting;
+            providersToUse = supporting.map((provider) => provider.id);
+        }
         else if (options.autoSelectProvider ||
             options.restrictToKnownOrNativeProviders) {
             // The restriction flag implies resolution: it must narrow the provider
@@ -1037,8 +1078,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.
-        if (options.restrictToKnownOrNativeProviders &&
+        // and would quote every provider. This also guards the widened in-app 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) &&
             providersToUse.length === 0) {
             return { success: [], sorted: [], error: [], customActions: [] };
         }
@@ -1046,6 +1091,12 @@ class RampsController extends base_controller_1.BaseController {
         const normalizedFiat = fiatToUse.toLowerCase().trim();
         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
+        // injected default so aggregator quotes carry a usable widget URL. An
+        // explicit caller `redirectUrl` always wins, and scope `off` never injects.
+        const effectiveRedirectUrl = options.redirectUrl ??
+            (widenToInAppProviders ? __classPrivateFieldGet(this, _RampsController_getDefaultRedirectUrl, "f").call(this) : undefined);
         const cacheKey = (0, RequestCache_1.createCacheKey)('getQuotes', [
             normalizedRegion,
             normalizedFiat,
@@ -1054,7 +1105,7 @@ class RampsController extends base_controller_1.BaseController {
             normalizedWalletAddress,
             [...paymentMethodsToUse].sort().join(','),
             [...providersToUse].sort().join(','),
-            options.redirectUrl,
+            effectiveRedirectUrl,
             action,
         ]);
         const params = {
@@ -1065,15 +1116,45 @@ class RampsController extends base_controller_1.BaseController {
             walletAddress: normalizedWalletAddress,
             paymentMethods: paymentMethodsToUse,
             providers: providersToUse,
-            redirectUrl: options.redirectUrl,
+            redirectUrl: effectiveRedirectUrl,
             action,
         };
-        return this.executeRequest(cacheKey, async () => {
+        const response = await this.executeRequest(cacheKey, async () => {
             return this.messenger.call('RampsService:getQuotes', params);
         }, {
             forceRefresh: options.forceRefresh,
             ttl: options.ttl ?? DEFAULT_QUOTES_TTL,
         });
+        if (!widenToInAppProviders) {
+            return response;
+        }
+        // Reduce the widened multi-provider result to the single best in-app 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,
+            amount: options.amount,
+            fiat: normalizedFiat,
+            providers: inAppProviderCatalog,
+        });
+        if (!selectedQuote) {
+            // No usable in-app quote: surface "no quote" rather than leaking an
+            // external/custom quote to the single-pick consumer.
+            return {
+                success: [],
+                sorted: response.sorted,
+                error: response.error,
+                customActions: response.customActions,
+            };
+        }
+        return {
+            ...response,
+            success: [
+                selectedQuote,
+                ...response.success.filter((quote) => quote !== selectedQuote),
+            ],
+        };
     }
     // === ORDER MANAGEMENT ===
     /**
@@ -1690,7 +1771,7 @@ class RampsController extends base_controller_1.BaseController {
     }
 }
 exports.RampsController = RampsController;
-_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = 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_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() {
     for (const resourceType of DEPENDENT_RESOURCE_KEYS) {
         __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").delete(resourceType);
         const generation = __classPrivateFieldGet(this, _RampsController_pendingResourceGeneration, "f").get(resourceType) ?? 0;
@@ -1816,6 +1897,63 @@ _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)));
+    const fitsProviderLimits = (quote) => {
+        const provider = providerByCode.get(normalizeProviderCode(quote.provider));
+        const limit = provider?.limits?.fiat?.[fiat]?.[quote.quote.paymentMethod];
+        if (!limit) {
+            // No published limits for this provider/payment method: treat as
+            // eligible and let the provider enforce limits at checkout.
+            return true;
+        }
+        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);
+    if (candidates.length === 0) {
+        return undefined;
+    }
+    const candidateByCode = new Map(candidates.map((quote) => [normalizeProviderCode(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));
+            if (match) {
+                return match;
+            }
+        }
+        return undefined;
+    };
+    // Reliability first, then price, then the first surviving candidate.
+    return (pickBySortOrder('reliability') ??
+        pickBySortOrder('price') ??
+        candidates[0]);
 }, _RampsController_getSupportingProvidersForRegion = 
 /**
  * Returns the region's providers that support the given asset, plus the full