@metamask-previews/ramps-controller 5.1.0-preview-dcbbb24 → 5.1.0-preview-57408350

package/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- **BREAKING:** Restructure `RampsControllerState` to use nested `ResourceState` objects for each resource with `data`, `selected`, `isLoading`, and `error` ([#7779](https://github.com/MetaMask/core/pull/7779))
+
 ## [5.1.0]
 
 ### Added

package/dist/RampsController.cjs

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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_removeRequestState, _RampsController_cleanupState, _RampsController_fireAndForget, _RampsController_updateResourceField, _RampsController_setResourceLoading, _RampsController_setResourceError, _RampsController_updateRequestState;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RampsController = exports.getDefaultRampsControllerState = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
@@ -37,12 +37,6 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
-    selectedProvider: {
-        persist: false,
-        includeInDebugSnapshot: true,
-        includeInStateLogs: true,
-        usedInUi: true,
-    },
     countries: {
         persist: true,
         includeInDebugSnapshot: true,
@@ -61,24 +55,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 +74,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
@@ -102,15 +101,12 @@ const rampsControllerMetadata = {
  */
 function getDefaultRampsControllerState() {
     return {
-        userRegion: null,
-        selectedProvider: null,
-        countries: [],
-        providers: [],
-        tokens: null,
-        selectedToken: null,
-        paymentMethods: [],
-        selectedPaymentMethod: null,
-        quotes: null,
+        userRegion: createDefaultResourceState(null),
+        countries: createDefaultResourceState([]),
+        providers: createDefaultResourceState([], null),
+        tokens: createDefaultResourceState(null, null),
+        paymentMethods: createDefaultResourceState([], null),
+        quotes: createDefaultResourceState(null),
         requests: {},
     };
 }
@@ -240,8 +236,13 @@ 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)
+        if (resourceType) {
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceLoading).call(this, resourceType, true);
+        }
         // Create the fetch promise
         const promise = (async () => {
             try {
@@ -251,6 +252,10 @@ 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));
+                // Clear error on success
+                if (resourceType) {
+                    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceError).call(this, resourceType, null);
+                }
                 return data;
             }
             catch (error) {
@@ -258,8 +263,12 @@ 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));
+                // Set resource-level error
+                if (resourceType) {
+                    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceError).call(this, resourceType, errorMessage);
+                }
                 throw error;
             }
             finally {
@@ -268,6 +277,10 @@ class RampsController extends base_controller_1.BaseController {
                 if (currentPending?.abortController === abortController) {
                     __classPrivateFieldGet(this, _RampsController_pendingRequests, "f").delete(cacheKey);
                 }
+                // Clear resource-level loading state
+                if (resourceType) {
+                    __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceLoading).call(this, resourceType, false);
+                }
             }
         })();
         // Store pending request for deduplication
@@ -310,37 +323,36 @@ 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;
+            const regionChanged = normalizedRegion !== this.state.userRegion.data?.regionCode;
             // Set the new region atomically with cleanup to avoid intermediate null state
             this.update((state) => {
                 if (regionChanged) {
-                    state.selectedProvider = null;
-                    state.selectedToken = null;
-                    state.tokens = null;
-                    state.providers = [];
-                    state.paymentMethods = [];
-                    state.selectedPaymentMethod = null;
-                    state.quotes = null;
+                    state.providers.selected = null;
+                    state.tokens.selected = null;
+                    state.tokens.data = null;
+                    state.providers.data = [];
+                    state.paymentMethods.data = [];
+                    state.paymentMethods.selected = null;
+                    state.quotes.data = null;
                 }
-                state.userRegion = userRegion;
+                state.userRegion.data = 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.tokens.data) {
+                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getTokens(userRegion.regionCode, 'buy', options));
             }
-            if (regionChanged || this.state.providers.length === 0) {
-                this.triggerGetProviders(userRegion.regionCode, options);
+            if (regionChanged || this.state.providers.data.length === 0) {
+                __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getProviders(userRegion.regionCode, options));
             }
             return userRegion;
         }
@@ -360,17 +372,17 @@ class RampsController extends base_controller_1.BaseController {
     setSelectedProvider(providerId) {
         if (providerId === null) {
             this.update((state) => {
-                state.selectedProvider = null;
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
+                state.providers.selected = null;
+                state.paymentMethods.data = [];
+                state.paymentMethods.selected = null;
             });
             return;
         }
-        const regionCode = this.state.userRegion?.regionCode;
+        const regionCode = this.state.userRegion.data?.regionCode;
         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 +391,11 @@ 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;
         });
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { provider: provider.id }));
     }
     /**
      * Initializes the controller by fetching the user's region from geolocation.
@@ -401,21 +408,32 @@ class RampsController extends base_controller_1.BaseController {
      * @returns Promise that resolves when initialization is complete.
      */
     async init(options) {
-        await this.getCountries(options);
-        let regionCode = this.state.userRegion?.regionCode;
-        regionCode ?? (regionCode = await this.messenger.call('RampsService:getGeolocation'));
-        if (!regionCode) {
-            throw new Error('Failed to fetch geolocation. Cannot initialize controller without valid region information.');
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceLoading).call(this, 'userRegion', true);
+        try {
+            await this.getCountries(options);
+            let regionCode = this.state.userRegion.data?.regionCode;
+            regionCode ?? (regionCode = await this.messenger.call('RampsService:getGeolocation'));
+            if (!regionCode) {
+                throw new Error('Failed to fetch geolocation. Cannot initialize controller without valid region information.');
+            }
+            await this.setUserRegion(regionCode, options);
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceError).call(this, 'userRegion', null);
+        }
+        catch (error) {
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceError).call(this, 'userRegion', error?.message ?? 'Unknown error');
+            throw error;
+        }
+        finally {
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_setResourceLoading).call(this, 'userRegion', false);
         }
-        await this.setUserRegion(regionCode, options);
     }
     hydrateState(options) {
-        const regionCode = this.state.userRegion?.regionCode;
+        const regionCode = this.state.userRegion.data?.regionCode;
         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 +447,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;
     }
@@ -446,7 +464,7 @@ class RampsController extends base_controller_1.BaseController {
      * @returns The tokens response containing topTokens and allTokens.
      */
     async getTokens(region, action = 'buy', options) {
-        const regionToUse = region ?? this.state.userRegion?.regionCode;
+        const regionToUse = region ?? this.state.userRegion.data?.regionCode;
         if (!regionToUse) {
             throw new Error('Region is required. Either provide a region parameter or ensure userRegion is set in controller state.');
         }
@@ -460,11 +478,11 @@ class RampsController extends base_controller_1.BaseController {
             return this.messenger.call('RampsService:getTokens', normalizedRegion, action, {
                 provider: options?.provider,
             });
-        }, options);
+        }, { ...options, resourceType: 'tokens' });
         this.update((state) => {
-            const userRegionCode = state.userRegion?.regionCode;
+            const userRegionCode = state.userRegion.data?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.tokens = tokens;
+                state.tokens.data = tokens;
             }
         });
         return tokens;
@@ -480,17 +498,17 @@ class RampsController extends base_controller_1.BaseController {
     setSelectedToken(assetId) {
         if (!assetId) {
             this.update((state) => {
-                state.selectedToken = null;
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
+                state.tokens.selected = null;
+                state.paymentMethods.data = [];
+                state.paymentMethods.selected = null;
             });
             return;
         }
-        const regionCode = this.state.userRegion?.regionCode;
+        const regionCode = this.state.userRegion.data?.regionCode;
         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 +518,11 @@ 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;
         });
+        __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_fireAndForget).call(this, this.getPaymentMethods(regionCode, { assetId: token.assetId }));
     }
     /**
      * Fetches the list of providers for a given region.
@@ -521,7 +537,7 @@ class RampsController extends base_controller_1.BaseController {
      * @returns The providers response containing providers array.
      */
     async getProviders(region, options) {
-        const regionToUse = region ?? this.state.userRegion?.regionCode;
+        const regionToUse = region ?? this.state.userRegion.data?.regionCode;
         if (!regionToUse) {
             throw new Error('Region is required. Either provide a region parameter or ensure userRegion is set in controller state.');
         }
@@ -540,11 +556,11 @@ class RampsController extends base_controller_1.BaseController {
                 fiat: options?.fiat,
                 payments: options?.payments,
             });
-        }, options);
+        }, { ...options, resourceType: 'providers' });
         this.update((state) => {
-            const userRegionCode = state.userRegion?.regionCode;
+            const userRegionCode = state.userRegion.data?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.providers = providers;
+                state.providers.data = providers;
             }
         });
         return { providers };
@@ -561,10 +577,10 @@ class RampsController extends base_controller_1.BaseController {
      * @returns The payment methods response containing payments array.
      */
     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 regionCode = region ?? this.state.userRegion.data?.regionCode ?? null;
+        const fiatToUse = options?.fiat ?? this.state.userRegion.data?.country?.currency ?? null;
+        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 +602,21 @@ class RampsController extends base_controller_1.BaseController {
                 assetId: assetIdToUse,
                 provider: providerToUse,
             });
-        }, options);
+        }, { ...options, resourceType: 'paymentMethods' });
         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 +632,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,7 +645,7 @@ 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;
         });
     }
     /**
@@ -651,10 +667,10 @@ class RampsController extends base_controller_1.BaseController {
      * @returns The quotes response containing success, sorted, error, and customActions.
      */
     async getQuotes(options) {
-        const regionToUse = options.region ?? this.state.userRegion?.regionCode;
-        const fiatToUse = options.fiat ?? this.state.userRegion?.country?.currency;
+        const regionToUse = options.region ?? this.state.userRegion.data?.regionCode;
+        const fiatToUse = options.fiat ?? this.state.userRegion.data?.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,11 +721,12 @@ class RampsController extends base_controller_1.BaseController {
         }, {
             forceRefresh: options.forceRefresh,
             ttl: options.ttl ?? DEFAULT_QUOTES_TTL,
+            resourceType: 'quotes',
         });
         this.update((state) => {
-            const userRegionCode = state.userRegion?.regionCode;
+            const userRegionCode = state.userRegion.data?.regionCode;
             if (userRegionCode === undefined || userRegionCode === normalizedRegion) {
-                state.quotes = response;
+                state.quotes.data = response;
             }
         });
         return response;
@@ -724,90 +741,6 @@ class RampsController extends base_controller_1.BaseController {
     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.
-     *
-     * @param options - Options for cache behavior.
-     */
-    triggerGetCountries(options) {
-        this.getCountries(options).catch(() => {
-            // Error stored in state
-        });
-    }
-    /**
-     * 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.
-     */
-    triggerGetTokens(region, action = 'buy', options) {
-        this.getTokens(region, action, options).catch(() => {
-            // Error stored in state
-        });
-    }
-    /**
-     * Triggers fetching providers without throwing.
-     *
-     * @param region - The region code. If not provided, uses userRegion from state.
-     * @param options - Options for cache behavior and query filters.
-     */
-    triggerGetProviders(region, options) {
-        this.getProviders(region, options).catch(() => {
-            // Error stored in state
-        });
-    }
-    /**
-     * 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.
-     */
-    triggerGetPaymentMethods(region, options) {
-        this.getPaymentMethods(region, options).catch(() => {
-            // Error stored in state
-        });
-    }
-    /**
-     * Triggers fetching quotes without throwing.
-     *
-     * @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.
-     */
-    triggerGetQuotes(options) {
-        this.getQuotes(options).catch(() => {
-            // Error stored in state
-        });
-    }
 }
 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) {
@@ -817,15 +750,28 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
     });
 }, _RampsController_cleanupState = function _RampsController_cleanupState() {
     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;
+        state.userRegion.data = null;
+        state.providers.selected = null;
+        state.tokens.selected = null;
+        state.tokens.data = null;
+        state.providers.data = [];
+        state.paymentMethods.data = [];
+        state.paymentMethods.selected = null;
+        state.quotes.data = null;
+    });
+}, _RampsController_fireAndForget = function _RampsController_fireAndForget(promise) {
+    promise.catch((_error) => undefined);
+}, _RampsController_updateResourceField = function _RampsController_updateResourceField(resourceType, field, value) {
+    this.update((state) => {
+        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");