@metamask-previews/ramps-controller 5.1.0-preview-40468f94 → 6.0.0-preview-fb7aa07ff

package/dist/RampsController.cjs

@@ -1,18 +1,18 @@
 "use strict";
+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 __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 _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_pendingRequests, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_updateRequestState;
+var _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_pendingRequests, _RampsController_pendingResourceCount, _RampsController_quotePollingInterval, _RampsController_quotePollingOptions, _RampsController_clearPendingResourceCountForDependentResources, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_fireAndForget, _RampsController_restartPollingIfActive, _RampsController_updateResourceField, _RampsController_setResourceLoading, _RampsController_setResourceError, _RampsController_updateRequestState;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RampsController = exports.getDefaultRampsControllerState = exports.controllerName = void 0;
+exports.RampsController = exports.getDefaultRampsControllerState = exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
 const RequestCache_1 = require("./RequestCache.cjs");
 // === GENERAL ===
@@ -22,6 +22,19 @@ const RequestCache_1 = require("./RequestCache.cjs");
  * when composed with other controllers.
  */
 exports.controllerName = 'RampsController';
+/**
+ * RampsService action types that RampsController calls via the messenger.
+ * Any host (e.g. mobile) that creates a RampsController messenger must delegate
+ * these actions from the root messenger so the controller can function.
+ */
+exports.RAMPS_CONTROLLER_REQUIRED_SERVICE_ACTIONS = [
+    'RampsService:getGeolocation',
+    'RampsService:getCountries',
+    'RampsService:getTokens',
+    'RampsService:getProviders',
+    'RampsService:getPaymentMethods',
+    'RampsService:getQuotes',
+];
 /**
  * Default TTL for quotes requests (15 seconds).
  * Quotes are time-sensitive and should have a shorter cache duration.
@@ -37,12 +50,6 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
-    selectedProvider: {
-        persist: false,
-        includeInDebugSnapshot: true,
-        includeInStateLogs: true,
-        usedInUi: true,
-    },
     countries: {
         persist: true,
         includeInDebugSnapshot: true,
@@ -61,24 +68,12 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
-    selectedToken: {
-        persist: false,
-        includeInDebugSnapshot: true,
-        includeInStateLogs: true,
-        usedInUi: true,
-    },
     paymentMethods: {
         persist: false,
         includeInDebugSnapshot: true,
         includeInStateLogs: true,
         usedInUi: true,
     },
-    selectedPaymentMethod: {
-        persist: false,
-        includeInDebugSnapshot: true,
-        includeInStateLogs: true,
-        usedInUi: true,
-    },
     quotes: {
         persist: false,
         includeInDebugSnapshot: true,
@@ -92,6 +87,23 @@ const rampsControllerMetadata = {
         usedInUi: true,
     },
 };
+/**
+ * Creates a default resource state object.
+ *
+ * @template TData - The type of the resource data.
+ * @template TSelected - The type of the selected item.
+ * @param data - The initial data value.
+ * @param selected - The initial selected value.
+ * @returns A ResourceState object with default loading and error values.
+ */
+function createDefaultResourceState(data, selected = null) {
+    return {
+        data,
+        selected,
+        isLoading: false,
+        error: null,
+    };
+}
 /**
  * Constructs the default {@link RampsController} state. This allows
  * consumers to provide a partial state object when initializing the controller
@@ -103,18 +115,44 @@ const rampsControllerMetadata = {
 function getDefaultRampsControllerState() {
     return {
         userRegion: null,
-        selectedProvider: null,
-        countries: [],
-        providers: [],
-        tokens: null,
-        selectedToken: null,
-        paymentMethods: [],
-        selectedPaymentMethod: null,
-        quotes: null,
+        countries: createDefaultResourceState([]),
+        providers: createDefaultResourceState([], null),
+        tokens: createDefaultResourceState(null, null),
+        paymentMethods: createDefaultResourceState([], null),
+        quotes: createDefaultResourceState(null, null),
         requests: {},
     };
 }
 exports.getDefaultRampsControllerState = getDefaultRampsControllerState;
+/**
+ * Resets region-dependent resources (userRegion, providers, tokens, paymentMethods, quotes).
+ * Mutates state in place; use from within controller update() for atomic updates.
+ *
+ * @param state - The state object to mutate.
+ * @param options - Options for the reset.
+ * @param options.clearUserRegionData - When true, sets userRegion to null (e.g. for full cleanup).
+ */
+function resetDependentResources(state, options) {
+    if (options?.clearUserRegionData) {
+        state.userRegion = null;
+    }
+    state.providers.selected = null;
+    state.providers.data = [];
+    state.providers.isLoading = false;
+    state.providers.error = null;
+    state.tokens.selected = null;
+    state.tokens.data = null;
+    state.tokens.isLoading = false;
+    state.tokens.error = null;
+    state.paymentMethods.data = [];
+    state.paymentMethods.selected = null;
+    state.paymentMethods.isLoading = false;
+    state.paymentMethods.error = null;
+    state.quotes.data = null;
+    state.quotes.selected = null;
+    state.quotes.isLoading = false;
+    state.quotes.error = null;
+}
 // === HELPER FUNCTIONS ===
 /**
  * Finds a country and state from a region code string.
@@ -173,6 +211,15 @@ function findRegionFromCode(regionCode, countries) {
  * Manages cryptocurrency on/off ramps functionality.
  */
 class RampsController extends base_controller_1.BaseController {
+    /**
+     * Clears the pending resource count map. Used only in tests to exercise the
+     * defensive path when get() returns undefined in the finally block.
+     *
+     * @internal
+     */
+    clearPendingResourceCountForTest() {
+        __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").clear();
+    }
     /**
      * Constructs a new {@link RampsController}.
      *
@@ -209,6 +256,21 @@ class RampsController extends base_controller_1.BaseController {
          * Key is the cache key, value is the pending request with abort controller.
          */
         _RampsController_pendingRequests.set(this, new Map());
+        /**
+         * Count of in-flight requests per resource type.
+         * Used so isLoading is only cleared when the last request for that resource finishes.
+         */
+        _RampsController_pendingResourceCount.set(this, new Map());
+        /**
+         * Interval ID for automatic quote polling.
+         * Set when startQuotePolling() is called, cleared when stopQuotePolling() is called.
+         */
+        _RampsController_quotePollingInterval.set(this, null);
+        /**
+         * Options used for quote polling (walletAddress, amount, redirectUrl).
+         * Stored so polling can be restarted when dependencies change.
+         */
+        _RampsController_quotePollingOptions.set(this, null);
         __classPrivateFieldSet(this, _RampsController_requestCacheTTL, requestCacheTTL, "f");
         __classPrivateFieldSet(this, _RampsController_requestCacheMaxSize, requestCacheMaxSize, "f");
     }
@@ -240,8 +302,18 @@ class RampsController extends base_controller_1.BaseController {
         // Create abort controller for this request
         const abortController = new AbortController();
         const lastFetchedAt = Date.now();
+        const { resourceType } = options ?? {};
         // Update state to loading
         __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_updateRequestState).call(this, cacheKey, (0, RequestCache_1.createLoadingState)());
+        // Set resource-level loading state (only on cache miss). Ref-count so concurrent
+        // requests for the same resource type (different cache keys) keep isLoading true.
+        if (resourceType) {
+            const count = __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").get(resourceType) ?? 0;
+            __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").set(resourceType, count + 1);
+            if (count === 0) {
+                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceLoading).call(this, resourceType, true);
+            }
+        }
         // Create the fetch promise
         const promise = (async () => {
             try {
@@ -251,6 +323,15 @@ class RampsController extends base_controller_1.BaseController {
                     throw new Error('Request was aborted');
                 }
                 __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_updateRequestState).call(this, cacheKey, (0, RequestCache_1.createSuccessState)(data, lastFetchedAt));
+                if (resourceType) {
+                    // We need the extra logic because there are two situations where we’re allowed to clear the error:
+                    // No callback → always clear
+                    // Callback present → clear only when isResultCurrent() returns true.
+                    const isCurrent = !options?.isResultCurrent || options.isResultCurrent();
+                    if (isCurrent) {
+                        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceError).call(this, resourceType, null);
+                    }
+                }
                 return data;
             }
             catch (error) {
@@ -258,8 +339,14 @@ class RampsController extends base_controller_1.BaseController {
                 if (abortController.signal.aborted) {
                     throw error;
                 }
-                const errorMessage = error?.message;
-                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_updateRequestState).call(this, cacheKey, (0, RequestCache_1.createErrorState)(errorMessage ?? 'Unknown error', lastFetchedAt));
+                const errorMessage = error?.message ?? 'Unknown error';
+                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_updateRequestState).call(this, cacheKey, (0, RequestCache_1.createErrorState)(errorMessage, lastFetchedAt));
+                if (resourceType) {
+                    const isCurrent = !options?.isResultCurrent || options.isResultCurrent();
+                    if (isCurrent) {
+                        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceError).call(this, resourceType, errorMessage);
+                    }
+                }
                 throw error;
             }
             finally {
@@ -268,6 +355,18 @@ class RampsController extends base_controller_1.BaseController {
                 if (currentPending?.abortController === abortController) {
                     __classPrivateFieldGet(this, _RampsController_pendingRequests, "f").delete(cacheKey);
                 }
+                // Clear resource-level loading state only when no requests for this resource remain
+                if (resourceType) {
+                    const count = __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").get(resourceType) ?? 0;
+                    const next = Math.max(0, count - 1);
+                    if (next === 0) {
+                        __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").delete(resourceType);
+                        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceLoading).call(this, resourceType, false);
+                    }
+                    else {
+                        __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").set(resourceType, next);
+                    }
+                }
             }
         })();
         // Store pending request for deduplication
@@ -310,37 +409,43 @@ class RampsController extends base_controller_1.BaseController {
     async setUserRegion(region, options) {
         const normalizedRegion = region.toLowerCase().trim();
         try {
-            const { countries } = this.state;
-            if (!countries || countries.length === 0) {
+            const countriesData = this.state.countries.data;
+            if (!countriesData || countriesData.length === 0) {
                 __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_cleanupState).call(this);
                 throw new Error('No countries found. Cannot set user region without valid country information.');
             }
-            const userRegion = findRegionFromCode(normalizedRegion, countries);
+            const userRegion = findRegionFromCode(normalizedRegion, countriesData);
             if (!userRegion) {
                 __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_cleanupState).call(this);
                 throw new Error(`Region "${normalizedRegion}" not found in countries data. Cannot set user region without valid country information.`);
             }
-            // Only cleanup state if region is actually changing
             const regionChanged = normalizedRegion !== this.state.userRegion?.regionCode;
-            // Set the new region atomically with cleanup to avoid intermediate null state
+            const needsRefetch = regionChanged ||
+                !this.state.tokens.data ||
+                this.state.providers.data.length === 0;
+            if (regionChanged) {
+                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_clearPendingResourceCountForDependentResources).call(this);
+            }
+            if (regionChanged) {
+                this.stopQuotePolling();
+            }
             this.update((state) => {
                 if (regionChanged) {
-                    state.selectedProvider = null;
-                    state.selectedToken = null;
-                    state.tokens = null;
-                    state.providers = [];
-                    state.paymentMethods = [];
-                    state.selectedPaymentMethod = null;
-                    state.quotes = null;
+                    resetDependentResources(state);
                 }
                 state.userRegion = userRegion;
             });
-            // Only trigger fetches if region changed or if data is missing
-            if (regionChanged || !this.state.tokens) {
-                this.triggerGetTokens(userRegion.regionCode, 'buy', options);
-            }
-            if (regionChanged || this.state.providers.length === 0) {
-                this.triggerGetProviders(userRegion.regionCode, options);
+            if (needsRefetch) {
+                const refetchPromises = [];
+                if (regionChanged || !this.state.tokens.data) {
+                    refetchPromises.push(this.getTokens(userRegion.regionCode, 'buy', options));
+                }
+                if (regionChanged || this.state.providers.data.length === 0) {
+                    refetchPromises.push(this.getProviders(userRegion.regionCode, options));
+                }
+                if (refetchPromises.length > 0) {
+                    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, Promise.all(refetchPromises));
+                }
             }
             return userRegion;
         }
@@ -359,10 +464,11 @@ class RampsController extends base_controller_1.BaseController {
      */
     setSelectedProvider(providerId) {
         if (providerId === null) {
+            this.stopQuotePolling();
             this.update((state) => {
-                state.selectedProvider = null;
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
+                state.providers.selected = null;
+                state.paymentMethods.data = [];
+                state.paymentMethods.selected = null;
             });
             return;
         }
@@ -370,7 +476,7 @@ class RampsController extends base_controller_1.BaseController {
         if (!regionCode) {
             throw new Error('Region is required. Cannot set selected provider without valid region information.');
         }
-        const { providers } = this.state;
+        const providers = this.state.providers.data;
         if (!providers || providers.length === 0) {
             throw new Error('Providers not loaded. Cannot set selected provider before providers are fetched.');
         }
@@ -379,16 +485,16 @@ class RampsController extends base_controller_1.BaseController {
             throw new Error(`Provider with ID "${providerId}" not found in available providers.`);
         }
         this.update((state) => {
-            state.selectedProvider = provider;
-            state.paymentMethods = [];
-            state.selectedPaymentMethod = null;
-        });
-        // fetch payment methods for the new provider
-        // this is needed because you can change providers without changing the token
-        // (getPaymentMethods will use state as its default)
-        this.triggerGetPaymentMethods(regionCode, {
-            provider: provider.id,
+            state.providers.selected = provider;
+            state.paymentMethods.data = [];
+            state.paymentMethods.selected = null;
+            state.quotes.selected = null;
         });
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { provider: provider.id }).then(() => {
+            // Restart quote polling after payment methods are fetched
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_restartPollingIfActive).call(this);
+            return undefined;
+        }));
     }
     /**
      * Initializes the controller by fetching the user's region from geolocation.
@@ -414,8 +520,8 @@ class RampsController extends base_controller_1.BaseController {
         if (!regionCode) {
             throw new Error('Region code is required. Cannot hydrate state without valid region information.');
         }
-        this.triggerGetTokens(regionCode, 'buy', options);
-        this.triggerGetProviders(regionCode, options);
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getTokens(regionCode, 'buy', options));
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getProviders(regionCode, options));
     }
     /**
      * Fetches the list of supported countries.
@@ -429,9 +535,9 @@ class RampsController extends base_controller_1.BaseController {
         const cacheKey = (0, RequestCache_1.createCacheKey)('getCountries', []);
         const countries = await this.executeRequest(cacheKey, async () => {
             return this.messenger.call('RampsService:getCountries');
-        }, options);
+        }, { ...options, resourceType: 'countries' });
         this.update((state) => {
-            state.countries = countries;
+            state.countries.data = countries;
         });
         return countries;
     }
@@ -460,11 +566,16 @@ class RampsController extends base_controller_1.BaseController {
             return this.messenger.call('RampsService:getTokens', normalizedRegion, action, {
                 provider: options?.provider,
             });
-        }, options);
+        }, {
+            ...options,
+            resourceType: 'tokens',
+            isResultCurrent: () => this.state.userRegion?.regionCode === undefined ||
+                this.state.userRegion?.regionCode === normalizedRegion,
+        });
         this.update((state) => {
             const userRegionCode = state.userRegion?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.tokens = tokens;
+                state.tokens.data = tokens;
             }
         });
         return tokens;
@@ -479,10 +590,11 @@ class RampsController extends base_controller_1.BaseController {
      */
     setSelectedToken(assetId) {
         if (!assetId) {
+            this.stopQuotePolling();
             this.update((state) => {
-                state.selectedToken = null;
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
+                state.tokens.selected = null;
+                state.paymentMethods.data = [];
+                state.paymentMethods.selected = null;
             });
             return;
         }
@@ -490,7 +602,7 @@ class RampsController extends base_controller_1.BaseController {
         if (!regionCode) {
             throw new Error('Region is required. Cannot set selected token without valid region information.');
         }
-        const { tokens } = this.state;
+        const tokens = this.state.tokens.data;
         if (!tokens) {
             throw new Error('Tokens not loaded. Cannot set selected token before tokens are fetched.');
         }
@@ -500,13 +612,16 @@ class RampsController extends base_controller_1.BaseController {
             throw new Error(`Token with asset ID "${assetId}" not found in available tokens.`);
         }
         this.update((state) => {
-            state.selectedToken = token;
-            state.paymentMethods = [];
-            state.selectedPaymentMethod = null;
-        });
-        this.triggerGetPaymentMethods(regionCode, {
-            assetId: token.assetId,
+            state.tokens.selected = token;
+            state.paymentMethods.data = [];
+            state.paymentMethods.selected = null;
+            state.quotes.selected = null;
         });
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { assetId: token.assetId }).then(() => {
+            // Restart quote polling after payment methods are fetched
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_restartPollingIfActive).call(this);
+            return undefined;
+        }));
     }
     /**
      * Fetches the list of providers for a given region.
@@ -540,11 +655,16 @@ class RampsController extends base_controller_1.BaseController {
                 fiat: options?.fiat,
                 payments: options?.payments,
             });
-        }, options);
+        }, {
+            ...options,
+            resourceType: 'providers',
+            isResultCurrent: () => this.state.userRegion?.regionCode === undefined ||
+                this.state.userRegion?.regionCode === normalizedRegion,
+        });
         this.update((state) => {
             const userRegionCode = state.userRegion?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.providers = providers;
+                state.providers.data = providers;
             }
         });
         return { providers };
@@ -563,8 +683,8 @@ class RampsController extends base_controller_1.BaseController {
     async getPaymentMethods(region, options) {
         const regionCode = region ?? this.state.userRegion?.regionCode ?? null;
         const fiatToUse = options?.fiat ?? this.state.userRegion?.country?.currency ?? null;
-        const assetIdToUse = options?.assetId ?? this.state.selectedToken?.assetId ?? '';
-        const providerToUse = options?.provider ?? this.state.selectedProvider?.id ?? '';
+        const assetIdToUse = options?.assetId ?? this.state.tokens.selected?.assetId ?? '';
+        const providerToUse = options?.provider ?? this.state.providers.selected?.id ?? '';
         if (!regionCode) {
             throw new Error('Region is required. Either provide a region parameter or ensure userRegion is set in controller state.');
         }
@@ -586,21 +706,31 @@ class RampsController extends base_controller_1.BaseController {
                 assetId: assetIdToUse,
                 provider: providerToUse,
             });
-        }, options);
+        }, {
+            ...options,
+            resourceType: 'paymentMethods',
+            isResultCurrent: () => {
+                const regionMatch = this.state.userRegion?.regionCode === undefined ||
+                    this.state.userRegion?.regionCode === normalizedRegion;
+                const tokenMatch = (this.state.tokens.selected?.assetId ?? '') === assetIdToUse;
+                const providerMatch = (this.state.providers.selected?.id ?? '') === providerToUse;
+                return regionMatch && tokenMatch && providerMatch;
+            },
+        });
         this.update((state) => {
-            const currentAssetId = state.selectedToken?.assetId ?? '';
-            const currentProviderId = state.selectedProvider?.id ?? '';
+            const currentAssetId = state.tokens.selected?.assetId ?? '';
+            const currentProviderId = state.providers.selected?.id ?? '';
             const tokenSelectionUnchanged = assetIdToUse === currentAssetId;
             const providerSelectionUnchanged = providerToUse === currentProviderId;
             // this is a race condition check to ensure that the selected token and provider in state are the same as the tokens we're requesting for
             // ex: if the user rapidly changes the token or provider, the in-flight payment methods might not be valid
             // so this check will ensure that the payment methods are still valid for the token and provider that were requested
             if (tokenSelectionUnchanged && providerSelectionUnchanged) {
-                state.paymentMethods = response.payments;
+                state.paymentMethods.data = response.payments;
                 // this will auto-select the first payment method if the selected payment method is not in the new payment methods
-                const currentSelectionStillValid = response.payments.some((pm) => pm.id === state.selectedPaymentMethod?.id);
+                const currentSelectionStillValid = response.payments.some((pm) => pm.id === state.paymentMethods.selected?.id);
                 if (!currentSelectionStillValid) {
-                    state.selectedPaymentMethod = response.payments[0] ?? null;
+                    state.paymentMethods.selected = response.payments[0] ?? null;
                 }
             }
         });
@@ -616,11 +746,11 @@ class RampsController extends base_controller_1.BaseController {
     setSelectedPaymentMethod(paymentMethodId) {
         if (!paymentMethodId) {
             this.update((state) => {
-                state.selectedPaymentMethod = null;
+                state.paymentMethods.selected = null;
             });
             return;
         }
-        const { paymentMethods } = this.state;
+        const paymentMethods = this.state.paymentMethods.data;
         if (!paymentMethods || paymentMethods.length === 0) {
             throw new Error('Payment methods not loaded. Cannot set selected payment method before payment methods are fetched.');
         }
@@ -629,8 +759,10 @@ class RampsController extends base_controller_1.BaseController {
             throw new Error(`Payment method with ID "${paymentMethodId}" not found in available payment methods.`);
         }
         this.update((state) => {
-            state.selectedPaymentMethod = paymentMethod;
+            state.paymentMethods.selected = paymentMethod;
         });
+        // Restart quote polling if active
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_restartPollingIfActive).call(this);
     }
     /**
      * Fetches quotes from all providers for a given set of parameters.
@@ -654,7 +786,7 @@ class RampsController extends base_controller_1.BaseController {
         const regionToUse = options.region ?? this.state.userRegion?.regionCode;
         const fiatToUse = options.fiat ?? this.state.userRegion?.country?.currency;
         const paymentMethodsToUse = options.paymentMethods ??
-            this.state.paymentMethods.map((pm) => pm.id);
+            this.state.paymentMethods.data.map((pm) => pm.id);
         const action = options.action ?? 'buy';
         if (!regionToUse) {
             throw new Error('Region is required. Either provide a region parameter or ensure userRegion is set in controller state.');
@@ -705,127 +837,171 @@ class RampsController extends base_controller_1.BaseController {
         }, {
             forceRefresh: options.forceRefresh,
             ttl: options.ttl ?? DEFAULT_QUOTES_TTL,
+            resourceType: 'quotes',
+            isResultCurrent: () => this.state.userRegion?.regionCode === undefined ||
+                this.state.userRegion?.regionCode === normalizedRegion,
         });
         this.update((state) => {
             const userRegionCode = state.userRegion?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.quotes = response;
+                state.quotes.data = response;
             }
         });
         return response;
     }
     /**
-     * Extracts the widget URL from a quote for redirect providers.
-     * Returns the widget URL if available, or null if the quote doesn't have one.
-     *
-     * @param quote - The quote to extract the widget URL from.
-     * @returns The widget URL string, or null if not available.
-     */
-    getWidgetUrl(quote) {
-        return quote.quote?.widgetUrl ?? null;
-    }
-    // ============================================================
-    // Sync Trigger Methods
-    // These fire-and-forget methods are for use in React effects.
-    // Errors are stored in state and available via selectors.
-    // ============================================================
-    /**
-     * Triggers setting the user region without throwing.
-     *
-     * @param region - The region code to set (e.g., "US-CA").
-     * @param options - Options for cache behavior.
-     */
-    triggerSetUserRegion(region, options) {
-        this.setUserRegion(region, options).catch(() => {
-            // Error stored in state
-        });
-    }
-    /**
-     * Triggers fetching countries without throwing.
+     * Starts automatic quote polling with a 15-second refresh interval.
+     * Fetches quotes immediately and then every 15 seconds.
+     * If the response contains exactly one quote, it is auto-selected.
+     * If multiple quotes are returned, the existing selection is preserved if still valid.
      *
-     * @param options - Options for cache behavior.
+     * @param options - Parameters for fetching quotes.
+     * @param options.walletAddress - The destination wallet address.
+     * @param options.amount - The amount (in fiat for buy, crypto for sell).
+     * @param options.redirectUrl - Optional redirect URL after order completion.
+     * @throws If required dependencies (region, token, payment method) are not set.
      */
-    triggerGetCountries(options) {
-        this.getCountries(options).catch(() => {
-            // Error stored in state
-        });
+    startQuotePolling(options) {
+        // Validate required dependencies
+        const regionCode = this.state.userRegion?.regionCode;
+        const token = this.state.tokens.selected;
+        const paymentMethod = this.state.paymentMethods.selected;
+        if (!regionCode) {
+            throw new Error('Region is required. Cannot start quote polling without valid region information.');
+        }
+        if (!token) {
+            throw new Error('Token is required. Cannot start quote polling without a selected token.');
+        }
+        if (!paymentMethod) {
+            throw new Error('Payment method is required. Cannot start quote polling without a selected payment method.');
+        }
+        // Stop any existing polling first
+        this.stopQuotePolling();
+        // Store options for restarts (must be after stop to avoid being cleared)
+        __classPrivateFieldSet(this, _RampsController_quotePollingOptions, options, "f");
+        // Define the fetch function
+        const fetchQuotes = () => {
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getQuotes({
+                assetId: token.assetId,
+                amount: options.amount,
+                walletAddress: options.walletAddress,
+                redirectUrl: options.redirectUrl,
+                paymentMethods: [paymentMethod.id],
+                forceRefresh: true,
+            }).then((response) => {
+                // Auto-select logic: only when exactly one quote is returned
+                this.update((state) => {
+                    if (response.success.length === 1) {
+                        state.quotes.selected = response.success[0];
+                    }
+                    else {
+                        // Keep existing selection if still valid, but update with fresh data
+                        const currentSelection = state.quotes.selected;
+                        if (currentSelection) {
+                            const freshQuote = response.success.find((quote) => quote.provider === currentSelection.provider &&
+                                quote.quote.paymentMethod ===
+                                    currentSelection.quote.paymentMethod);
+                            // Update with fresh quote data, or clear if no longer valid
+                            state.quotes.selected = freshQuote ?? null;
+                        }
+                    }
+                });
+                return undefined;
+            }));
+        };
+        // Fetch immediately
+        fetchQuotes();
+        // Set up 15-second polling
+        __classPrivateFieldSet(this, _RampsController_quotePollingInterval, setInterval(fetchQuotes, 15000), "f");
     }
     /**
-     * Triggers fetching tokens without throwing.
-     *
-     * @param region - The region code. If not provided, uses userRegion from state.
-     * @param action - The ramp action type ('buy' or 'sell').
-     * @param options - Options for cache behavior.
+     * Stops automatic quote polling.
+     * Does not clear quotes data or selection, only stops the interval.
      */
-    triggerGetTokens(region, action = 'buy', options) {
-        this.getTokens(region, action, options).catch(() => {
-            // Error stored in state
-        });
+    stopQuotePolling() {
+        if (__classPrivateFieldGet(this, _RampsController_quotePollingInterval, "f") !== null) {
+            clearInterval(__classPrivateFieldGet(this, _RampsController_quotePollingInterval, "f"));
+            __classPrivateFieldSet(this, _RampsController_quotePollingInterval, null, "f");
+        }
+        __classPrivateFieldSet(this, _RampsController_quotePollingOptions, null, "f");
     }
     /**
-     * Triggers fetching providers without throwing.
+     * Manually sets the selected quote.
      *
-     * @param region - The region code. If not provided, uses userRegion from state.
-     * @param options - Options for cache behavior and query filters.
+     * @param quote - The quote to select, or null to clear the selection.
      */
-    triggerGetProviders(region, options) {
-        this.getProviders(region, options).catch(() => {
-            // Error stored in state
+    setSelectedQuote(quote) {
+        this.update((state) => {
+            state.quotes.selected = quote;
         });
     }
     /**
-     * Triggers fetching payment methods without throwing.
-     *
-     * @param region - User's region code (e.g., "us", "fr", "us-ny").
-     * @param options - Query parameters for filtering payment methods.
-     * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.
-     * @param options.assetId - CAIP-19 cryptocurrency identifier.
-     * @param options.provider - Provider ID path.
+     * Cleans up controller resources.
+     * Stops any active quote polling to prevent memory leaks.
+     * Should be called when the controller is no longer needed.
      */
-    triggerGetPaymentMethods(region, options) {
-        this.getPaymentMethods(region, options).catch(() => {
-            // Error stored in state
-        });
+    destroy() {
+        this.stopQuotePolling();
+        super.destroy();
     }
     /**
-     * Triggers fetching quotes without throwing.
+     * Extracts the widget URL from a quote for redirect providers.
+     * Returns the widget URL if available, or null if the quote doesn't have one.
      *
-     * @param options - The parameters for fetching quotes.
-     * @param options.region - User's region code. If not provided, uses userRegion from state.
-     * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.
-     * @param options.assetId - CAIP-19 cryptocurrency identifier.
-     * @param options.amount - The amount (in fiat for buy, crypto for sell).
-     * @param options.walletAddress - The destination wallet address.
-     * @param options.paymentMethods - Array of payment method IDs. If not provided, uses paymentMethods from state.
-     * @param options.provider - Optional provider ID to filter quotes.
-     * @param options.redirectUrl - Optional redirect URL after order completion.
-     * @param options.action - The ramp action type. Defaults to 'buy'.
-     * @param options.forceRefresh - Whether to bypass cache.
-     * @param options.ttl - Custom TTL for this request.
+     * @param quote - The quote to extract the widget URL from.
+     * @returns The widget URL string, or null if not available.
      */
-    triggerGetQuotes(options) {
-        this.getQuotes(options).catch(() => {
-            // Error stored in state
-        });
+    getWidgetUrl(quote) {
+        return quote.quote?.widgetUrl ?? null;
     }
 }
 exports.RampsController = RampsController;
-_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = new WeakMap(), _RampsController_pendingRequests = new WeakMap(), _RampsController_instances = new WeakSet(), _RampsController_removeRequestState = function _RampsController_removeRequestState(cacheKey) {
+_RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheMaxSize = new WeakMap(), _RampsController_pendingRequests = new WeakMap(), _RampsController_pendingResourceCount = new WeakMap(), _RampsController_quotePollingInterval = new WeakMap(), _RampsController_quotePollingOptions = new WeakMap(), _RampsController_instances = new WeakSet(), _RampsController_clearPendingResourceCountForDependentResources = function _RampsController_clearPendingResourceCountForDependentResources() {
+    const types = [
+        'providers',
+        'tokens',
+        'paymentMethods',
+        'quotes',
+    ];
+    for (const resourceType of types) {
+        __classPrivateFieldGet(this, _RampsController_pendingResourceCount, "f").delete(resourceType);
+    }
+}, _RampsController_removeRequestState = function _RampsController_removeRequestState(cacheKey) {
     this.update((state) => {
         const requests = state.requests;
         delete requests[cacheKey];
     });
 }, _RampsController_cleanupState = function _RampsController_cleanupState() {
+    this.stopQuotePolling();
+    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_clearPendingResourceCountForDependentResources).call(this);
+    this.update((state) => resetDependentResources(state, {
+        clearUserRegionData: true,
+    }));
+}, _RampsController_fireAndForget = function _RampsController_fireAndForget(promise) {
+    promise.catch((_error) => undefined);
+}, _RampsController_restartPollingIfActive = function _RampsController_restartPollingIfActive() {
+    if (__classPrivateFieldGet(this, _RampsController_quotePollingInterval, "f") !== null && __classPrivateFieldGet(this, _RampsController_quotePollingOptions, "f")) {
+        const options = __classPrivateFieldGet(this, _RampsController_quotePollingOptions, "f");
+        this.stopQuotePolling();
+        try {
+            this.startQuotePolling(options);
+        }
+        catch {
+            // Dependencies not met yet, polling will need to be manually restarted
+            // when dependencies are available
+        }
+    }
+}, _RampsController_updateResourceField = function _RampsController_updateResourceField(resourceType, field, value) {
     this.update((state) => {
-        state.userRegion = null;
-        state.selectedProvider = null;
-        state.selectedToken = null;
-        state.tokens = null;
-        state.providers = [];
-        state.paymentMethods = [];
-        state.selectedPaymentMethod = null;
-        state.quotes = null;
+        const resource = state[resourceType];
+        if (resource) {
+            resource[field] = value;
+        }
     });
+}, _RampsController_setResourceLoading = function _RampsController_setResourceLoading(resourceType, loading) {
+    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_updateResourceField).call(this, resourceType, 'isLoading', loading);
+}, _RampsController_setResourceError = function _RampsController_setResourceError(resourceType, error) {
+    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_updateResourceField).call(this, resourceType, 'error', error);
 }, _RampsController_updateRequestState = function _RampsController_updateRequestState(cacheKey, requestState) {
     const maxSize = __classPrivateFieldGet(this, _RampsController_requestCacheMaxSize, "f");
     const ttl = __classPrivateFieldGet(this, _RampsController_requestCacheTTL, "f");