@metamask-previews/ramps-controller 4.1.0-preview-3ec2a74 → 4.1.0-preview-6ae8a59c

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `hydrateState()` method to fetch providers and tokens for user region ([#7707](https://github.com/MetaMask/core/pull/7707))
+- Add `countries` state to RampsController with 24 hour TTL caching ([#7707](https://github.com/MetaMask/core/pull/7707))
+- Add `SupportedActions` type for `{ buy: boolean; sell: boolean }` support info
+
+### Changed
+
+- Reorganize `init()` to only fetch geolocation and countries; remove token and provider fetching ([#7707](https://github.com/MetaMask/core/pull/7707))
+- **BREAKING:** Change `Country.supported` and `State.supported` from `boolean` to `SupportedActions` object. The API now returns buy/sell support info in a single call.
+- **BREAKING:** Remove `action` parameter from `getCountries()`. Countries are no longer fetched separately for buy/sell actions.
+
 ## [4.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_updateRequestState;
+var _RampsController_instances, _RampsController_requestCacheTTL, _RampsController_requestCacheMaxSize, _RampsController_pendingRequests, _RampsController_removeRequestState, _RampsController_cleanupState, _RampsController_updateRequestState;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RampsController = exports.getDefaultRampsControllerState = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
@@ -38,6 +38,12 @@ const rampsControllerMetadata = {
         includeInStateLogs: true,
         usedInUi: true,
     },
+    countries: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: true,
+    },
     providers: {
         persist: true,
         includeInDebugSnapshot: true,
@@ -81,6 +87,7 @@ function getDefaultRampsControllerState() {
     return {
         userRegion: null,
         preferredProvider: null,
+        countries: [],
         providers: [],
         tokens: null,
         paymentMethods: [],
@@ -274,96 +281,6 @@ class RampsController extends base_controller_1.BaseController {
     getRequestState(cacheKey) {
         return this.state.requests[cacheKey];
     }
-    /**
-     * Updates the user's region by fetching geolocation.
-     * This method calls the RampsService to get the geolocation.
-     *
-     * @param options - Options for cache behavior.
-     * @returns The user region object.
-     */
-    async updateUserRegion(options) {
-        // If a userRegion already exists and forceRefresh is not requested,
-        // return it immediately without fetching geolocation.
-        // This ensures that once a region is set (either via geolocation or manual selection),
-        // it will not be overwritten by subsequent geolocation fetches.
-        if (this.state.userRegion && !options?.forceRefresh) {
-            return this.state.userRegion;
-        }
-        // When forceRefresh is true, clear the existing region and region-dependent state before fetching
-        if (options?.forceRefresh) {
-            this.update((state) => {
-                state.userRegion = null;
-                state.tokens = null;
-                state.providers = [];
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
-            });
-        }
-        const cacheKey = (0, RequestCache_1.createCacheKey)('updateUserRegion', []);
-        const regionCode = await this.executeRequest(cacheKey, async () => {
-            const result = await this.messenger.call('RampsService:getGeolocation');
-            return result;
-        }, options);
-        if (!regionCode) {
-            this.update((state) => {
-                state.userRegion = null;
-                state.tokens = null;
-                state.providers = [];
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
-            });
-            return null;
-        }
-        const normalizedRegion = regionCode.toLowerCase().trim();
-        try {
-            const countries = await this.getCountries('buy', options);
-            const userRegion = findRegionFromCode(normalizedRegion, countries);
-            if (userRegion) {
-                this.update((state) => {
-                    const regionChanged = state.userRegion?.regionCode !== userRegion.regionCode;
-                    state.userRegion = userRegion;
-                    // Clear region-dependent state when region changes
-                    if (regionChanged) {
-                        state.tokens = null;
-                        state.providers = [];
-                        state.paymentMethods = [];
-                        state.selectedPaymentMethod = null;
-                    }
-                });
-                // Fetch providers for the new region
-                if (userRegion.regionCode) {
-                    try {
-                        await this.getProviders(userRegion.regionCode, options);
-                    }
-                    catch {
-                        // Provider fetch failed - error state will be available via selectors
-                    }
-                }
-                return userRegion;
-            }
-            // Region not found in countries data
-            this.update((state) => {
-                state.userRegion = null;
-                state.tokens = null;
-                state.providers = [];
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
-            });
-            return null;
-        }
-        catch {
-            // If countries fetch fails, we can't create a valid UserRegion
-            // Return null to indicate we don't have valid country data
-            this.update((state) => {
-                state.userRegion = null;
-                state.tokens = null;
-                state.providers = [];
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
-            });
-            return null;
-        }
-    }
     /**
      * Sets the user's region manually (without fetching geolocation).
      * This allows users to override the detected region.
@@ -375,50 +292,41 @@ class RampsController extends base_controller_1.BaseController {
     async setUserRegion(region, options) {
         const normalizedRegion = region.toLowerCase().trim();
         try {
-            const countries = await this.getCountries('buy', options);
+            const { countries } = this.state;
+            if (!countries || countries.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);
-            if (userRegion) {
-                this.update((state) => {
-                    state.userRegion = userRegion;
+            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
+            this.update((state) => {
+                if (regionChanged) {
+                    state.preferredProvider = null;
                     state.tokens = null;
                     state.providers = [];
                     state.paymentMethods = [];
                     state.selectedPaymentMethod = null;
-                });
-                // Fetch providers for the new region
-                try {
-                    await this.getProviders(userRegion.regionCode, options);
-                }
-                catch {
-                    // Provider fetch failed - error state will be available via selectors
                 }
-                return userRegion;
-            }
-            // Region not found in countries data
-            this.update((state) => {
-                state.userRegion = null;
-                state.tokens = null;
-                state.providers = [];
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
+                state.userRegion = userRegion;
             });
-            throw new Error(`Region "${normalizedRegion}" not found in countries data. Cannot set user region without valid country information.`);
+            // 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);
+            }
+            return userRegion;
         }
         catch (error) {
-            // If the error is "not found", re-throw it
-            // Otherwise, it's from countries fetch failure
-            if (error instanceof Error && error.message.includes('not found')) {
-                throw error;
-            }
-            // Countries fetch failed
-            this.update((state) => {
-                state.userRegion = null;
-                state.tokens = null;
-                state.providers = [];
-                state.paymentMethods = [];
-                state.selectedPaymentMethod = null;
-            });
-            throw new Error('Failed to fetch countries data. Cannot set user region without valid country information.');
+            __classPrivateFieldGet(this, _RampsController_instances, "m", _RampsController_cleanupState).call(this);
+            throw error;
         }
     }
     /**
@@ -435,46 +343,47 @@ class RampsController extends base_controller_1.BaseController {
     /**
      * Initializes the controller by fetching the user's region from geolocation.
      * This should be called once at app startup to set up the initial region.
-     * After the region is set, tokens are fetched and saved to state.
      *
      * If a userRegion already exists (from persistence or manual selection),
-     * this method will skip geolocation fetch and only fetch tokens if needed.
+     * this method will skip geolocation fetch and use the existing region.
      *
      * @param options - Options for cache behavior.
      * @returns Promise that resolves when initialization is complete.
      */
     async init(options) {
-        const userRegion = await this.updateUserRegion(options).catch(() => {
-            // User region fetch failed - error state will be available via selectors
-            return null;
-        });
-        if (userRegion) {
-            try {
-                await this.getTokens(userRegion.regionCode, 'buy', options);
-            }
-            catch {
-                // Token fetch failed - error state will be available via selectors
-            }
-            try {
-                await this.getProviders(userRegion.regionCode, options);
-            }
-            catch {
-                // Provider fetch failed - error state will be available via selectors
-            }
+        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.');
+        }
+        await this.setUserRegion(regionCode, options);
+    }
+    hydrateState(options) {
+        const regionCode = this.state.userRegion?.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);
     }
     /**
-     * Fetches the list of supported countries for a given ramp action.
+     * Fetches the list of supported countries.
+     * The API returns countries with support information for both buy and sell actions.
+     * The countries are saved in the controller state once fetched.
      *
-     * @param action - The ramp action type ('buy' or 'sell').
      * @param options - Options for cache behavior.
      * @returns An array of countries.
      */
-    async getCountries(action = 'buy', options) {
-        const cacheKey = (0, RequestCache_1.createCacheKey)('getCountries', [action]);
-        return this.executeRequest(cacheKey, async () => {
-            return this.messenger.call('RampsService:getCountries', action);
+    async getCountries(options) {
+        const cacheKey = (0, RequestCache_1.createCacheKey)('getCountries', []);
+        const countries = await this.executeRequest(cacheKey, async () => {
+            return this.messenger.call('RampsService:getCountries');
         }, options);
+        this.update((state) => {
+            state.countries = countries;
+        });
+        return countries;
     }
     /**
      * Fetches the list of available tokens for a given region and action.
@@ -615,16 +524,6 @@ class RampsController extends base_controller_1.BaseController {
     // These fire-and-forget methods are for use in React effects.
     // Errors are stored in state and available via selectors.
     // ============================================================
-    /**
-     * Triggers a user region update without throwing.
-     *
-     * @param options - Options for cache behavior.
-     */
-    triggerUpdateUserRegion(options) {
-        this.updateUserRegion(options).catch(() => {
-            // Error stored in state
-        });
-    }
     /**
      * Triggers setting the user region without throwing.
      *
@@ -639,11 +538,10 @@ class RampsController extends base_controller_1.BaseController {
     /**
      * Triggers fetching countries without throwing.
      *
-     * @param action - The ramp action type ('buy' or 'sell').
      * @param options - Options for cache behavior.
      */
-    triggerGetCountries(action = 'buy', options) {
-        this.getCountries(action, options).catch(() => {
+    triggerGetCountries(options) {
+        this.getCountries(options).catch(() => {
             // Error stored in state
         });
     }
@@ -693,6 +591,15 @@ _RampsController_requestCacheTTL = new WeakMap(), _RampsController_requestCacheM
         const requests = state.requests;
         delete requests[cacheKey];
     });
+}, _RampsController_cleanupState = function _RampsController_cleanupState() {
+    this.update((state) => {
+        state.userRegion = null;
+        state.preferredProvider = null;
+        state.tokens = null;
+        state.providers = [];
+        state.paymentMethods = [];
+        state.selectedPaymentMethod = null;
+    });
 }, _RampsController_updateRequestState = function _RampsController_updateRequestState(cacheKey, requestState) {
     const maxSize = __classPrivateFieldGet(this, _RampsController_requestCacheMaxSize, "f");
     const ttl = __classPrivateFieldGet(this, _RampsController_requestCacheTTL, "f");

package/dist/RampsController.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"RampsController.cjs","sourceRoot":"","sources":["../src/RampsController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { Json } from '@metamask/utils';\n\nimport type {\n  Country,\n  TokensResponse,\n  Provider,\n  State,\n  RampAction,\n  PaymentMethod,\n  PaymentMethodsResponse,\n} from './RampsService';\nimport type {\n  RampsServiceGetGeolocationAction,\n  RampsServiceGetCountriesAction,\n  RampsServiceGetTokensAction,\n  RampsServiceGetProvidersAction,\n  RampsServiceGetPaymentMethodsAction,\n} from './RampsService-method-action-types';\nimport type {\n  RequestCache as RequestCacheType,\n  RequestState,\n  ExecuteRequestOptions,\n  PendingRequest,\n} from './RequestCache';\nimport {\n  DEFAULT_REQUEST_CACHE_TTL,\n  DEFAULT_REQUEST_CACHE_MAX_SIZE,\n  createCacheKey,\n  isCacheExpired,\n  createLoadingState,\n  createSuccessState,\n  createErrorState,\n  RequestStatus,\n} from './RequestCache';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link RampsController}, used to namespace the\n * controller's actions and events and to namespace the controller's state data\n * when composed with other controllers.\n */\nexport const controllerName = 'RampsController';\n\n// === STATE ===\n\n/**\n * Represents the user's selected region with full country and state objects.\n */\nexport type UserRegion = {\n  /**\n   * The country object for the selected region.\n   */\n  country: Country;\n  /**\n   * The state object if a state was selected, null if only country was selected.\n   */\n  state: State | null;\n  /**\n   * The region code string (e.g., \"us-ut\" or \"fr\") used for API calls.\n   */\n  regionCode: string;\n};\n\n/**\n * Describes the shape of the state object for {@link RampsController}.\n */\nexport type RampsControllerState = {\n  /**\n   * The user's selected region with full country and state objects.\n   * Initially set via geolocation fetch, but can be manually changed by the user.\n   * Once set (either via geolocation or manual selection), it will not be overwritten\n   * by subsequent geolocation fetches.\n   */\n  userRegion: UserRegion | null;\n  /**\n   * The user's preferred provider.\n   * Can be manually set by the user.\n   */\n  preferredProvider: Provider | null;\n  /**\n   * List of providers available for the current region.\n   */\n  providers: Provider[];\n  /**\n   * Tokens fetched for the current region and action.\n   * Contains topTokens and allTokens arrays.\n   */\n  tokens: TokensResponse | null;\n  /**\n   * Payment methods available for the current context.\n   * Filtered by region, fiat, asset, and provider.\n   */\n  paymentMethods: PaymentMethod[];\n  /**\n   * The user's selected payment method.\n   * Can be manually set by the user.\n   */\n  selectedPaymentMethod: PaymentMethod | null;\n  /**\n   * Cache of request states, keyed by cache key.\n   * This stores loading, success, and error states for API requests.\n   */\n  requests: RequestCacheType;\n};\n\n/**\n * The metadata for each property in {@link RampsControllerState}.\n */\nconst rampsControllerMetadata = {\n  userRegion: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  preferredProvider: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  providers: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  tokens: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  paymentMethods: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  selectedPaymentMethod: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  requests: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: false,\n    usedInUi: true,\n  },\n} satisfies StateMetadata<RampsControllerState>;\n\n/**\n * Constructs the default {@link RampsController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link RampsController} state.\n */\nexport function getDefaultRampsControllerState(): RampsControllerState {\n  return {\n    userRegion: null,\n    preferredProvider: null,\n    providers: [],\n    tokens: null,\n    paymentMethods: [],\n    selectedPaymentMethod: null,\n    requests: {},\n  };\n}\n\n// === MESSENGER ===\n\n/**\n * Retrieves the state of the {@link RampsController}.\n */\nexport type RampsControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  RampsControllerState\n>;\n\n/**\n * Actions that {@link RampsControllerMessenger} exposes to other consumers.\n */\nexport type RampsControllerActions = RampsControllerGetStateAction;\n\n/**\n * Actions from other messengers that {@link RampsController} calls.\n */\ntype AllowedActions =\n  | RampsServiceGetGeolocationAction\n  | RampsServiceGetCountriesAction\n  | RampsServiceGetTokensAction\n  | RampsServiceGetProvidersAction\n  | RampsServiceGetPaymentMethodsAction;\n\n/**\n * Published when the state of {@link RampsController} changes.\n */\nexport type RampsControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  RampsControllerState\n>;\n\n/**\n * Events that {@link RampsControllerMessenger} exposes to other consumers.\n */\nexport type RampsControllerEvents = RampsControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link RampsController} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link RampsController}.\n */\nexport type RampsControllerMessenger = Messenger<\n  typeof controllerName,\n  RampsControllerActions | AllowedActions,\n  RampsControllerEvents | AllowedEvents\n>;\n\n/**\n * Configuration options for the RampsController.\n */\nexport type RampsControllerOptions = {\n  /** The messenger suited for this controller. */\n  messenger: RampsControllerMessenger;\n  /** The desired state with which to initialize this controller. */\n  state?: Partial<RampsControllerState>;\n  /** Time to live for cached requests in milliseconds. Defaults to 15 minutes. */\n  requestCacheTTL?: number;\n  /** Maximum number of entries in the request cache. Defaults to 250. */\n  requestCacheMaxSize?: number;\n};\n\n// === HELPER FUNCTIONS ===\n\n/**\n * Finds a country and state from a region code string.\n *\n * @param regionCode - The region code (e.g., \"us-ca\" or \"us\").\n * @param countries - Array of countries to search.\n * @returns UserRegion object with country and state, or null if not found.\n */\nfunction findRegionFromCode(\n  regionCode: string,\n  countries: Country[],\n): UserRegion | null {\n  const normalizedCode = regionCode.toLowerCase().trim();\n  const parts = normalizedCode.split('-');\n  const countryCode = parts[0];\n  const stateCode = parts[1];\n\n  const country = countries.find((countryItem) => {\n    if (countryItem.isoCode?.toLowerCase() === countryCode) {\n      return true;\n    }\n    if (countryItem.id) {\n      const id = countryItem.id.toLowerCase();\n      if (id.startsWith('/regions/')) {\n        const extractedCode = id.replace('/regions/', '').split('/')[0];\n        return extractedCode === countryCode;\n      }\n      return id === countryCode || id.endsWith(`/${countryCode}`);\n    }\n    return false;\n  });\n\n  if (!country) {\n    return null;\n  }\n\n  let state: State | null = null;\n  if (stateCode && country.states) {\n    state =\n      country.states.find((stateItem) => {\n        if (stateItem.stateId?.toLowerCase() === stateCode) {\n          return true;\n        }\n        if (stateItem.id) {\n          const stateId = stateItem.id.toLowerCase();\n          if (\n            stateId.includes(`-${stateCode}`) ||\n            stateId.endsWith(`/${stateCode}`)\n          ) {\n            return true;\n          }\n        }\n        return false;\n      }) ?? null;\n  }\n\n  return {\n    country,\n    state,\n    regionCode: normalizedCode,\n  };\n}\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * Manages cryptocurrency on/off ramps functionality.\n */\nexport class RampsController extends BaseController<\n  typeof controllerName,\n  RampsControllerState,\n  RampsControllerMessenger\n> {\n  /**\n   * Default TTL for cached requests.\n   */\n  readonly #requestCacheTTL: number;\n\n  /**\n   * Maximum number of entries in the request cache.\n   */\n  readonly #requestCacheMaxSize: number;\n\n  /**\n   * Map of pending requests for deduplication.\n   * Key is the cache key, value is the pending request with abort controller.\n   */\n  readonly #pendingRequests: Map<string, PendingRequest> = new Map();\n\n  /**\n   * Constructs a new {@link RampsController}.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this controller.\n   * @param args.state - The desired state with which to initialize this\n   * controller. Missing properties will be filled in with defaults.\n   * @param args.requestCacheTTL - Time to live for cached requests in milliseconds.\n   * @param args.requestCacheMaxSize - Maximum number of entries in the request cache.\n   */\n  constructor({\n    messenger,\n    state = {},\n    requestCacheTTL = DEFAULT_REQUEST_CACHE_TTL,\n    requestCacheMaxSize = DEFAULT_REQUEST_CACHE_MAX_SIZE,\n  }: RampsControllerOptions) {\n    super({\n      messenger,\n      metadata: rampsControllerMetadata,\n      name: controllerName,\n      state: {\n        ...getDefaultRampsControllerState(),\n        ...state,\n        // Always reset requests cache on initialization (non-persisted)\n        requests: {},\n      },\n    });\n\n    this.#requestCacheTTL = requestCacheTTL;\n    this.#requestCacheMaxSize = requestCacheMaxSize;\n  }\n\n  /**\n   * Executes a request with caching and deduplication.\n   *\n   * If a request with the same cache key is already in flight, returns the\n   * existing promise. If valid cached data exists, returns it without making\n   * a new request.\n   *\n   * @param cacheKey - Unique identifier for this request.\n   * @param fetcher - Function that performs the actual fetch. Receives an AbortSignal.\n   * @param options - Options for cache behavior.\n   * @returns The result of the request.\n   */\n  async executeRequest<TResult>(\n    cacheKey: string,\n    fetcher: (signal: AbortSignal) => Promise<TResult>,\n    options?: ExecuteRequestOptions,\n  ): Promise<TResult> {\n    const ttl = options?.ttl ?? this.#requestCacheTTL;\n\n    // Check for existing pending request - join it instead of making a duplicate\n    const pending = this.#pendingRequests.get(cacheKey);\n    if (pending) {\n      return pending.promise as Promise<TResult>;\n    }\n\n    // Check cache validity (unless force refresh)\n    if (!options?.forceRefresh) {\n      const cached = this.state.requests[cacheKey];\n      if (cached && !isCacheExpired(cached, ttl)) {\n        return cached.data as TResult;\n      }\n    }\n\n    // Create abort controller for this request\n    const abortController = new AbortController();\n    const lastFetchedAt = Date.now();\n\n    // Update state to loading\n    this.#updateRequestState(cacheKey, createLoadingState());\n\n    // Create the fetch promise\n    const promise = (async (): Promise<TResult> => {\n      try {\n        const data = await fetcher(abortController.signal);\n\n        // Don't update state if aborted\n        if (abortController.signal.aborted) {\n          throw new Error('Request was aborted');\n        }\n\n        this.#updateRequestState(\n          cacheKey,\n          createSuccessState(data as Json, lastFetchedAt),\n        );\n        return data;\n      } catch (error) {\n        // Don't update state if aborted\n        if (abortController.signal.aborted) {\n          throw error;\n        }\n\n        const errorMessage = (error as Error)?.message;\n\n        this.#updateRequestState(\n          cacheKey,\n          createErrorState(errorMessage ?? 'Unknown error', lastFetchedAt),\n        );\n        throw error;\n      } finally {\n        // Only delete if this is still our entry (not replaced by a new request)\n        const currentPending = this.#pendingRequests.get(cacheKey);\n        if (currentPending?.abortController === abortController) {\n          this.#pendingRequests.delete(cacheKey);\n        }\n      }\n    })();\n\n    // Store pending request for deduplication\n    this.#pendingRequests.set(cacheKey, { promise, abortController });\n\n    return promise;\n  }\n\n  /**\n   * Aborts a pending request if one exists.\n   *\n   * @param cacheKey - The cache key of the request to abort.\n   * @returns True if a request was aborted.\n   */\n  abortRequest(cacheKey: string): boolean {\n    const pending = this.#pendingRequests.get(cacheKey);\n    if (pending) {\n      pending.abortController.abort();\n      this.#pendingRequests.delete(cacheKey);\n      this.#removeRequestState(cacheKey);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Removes a request state from the cache.\n   *\n   * @param cacheKey - The cache key to remove.\n   */\n  #removeRequestState(cacheKey: string): void {\n    this.update((state) => {\n      const requests = state.requests as unknown as Record<\n        string,\n        RequestState | undefined\n      >;\n      delete requests[cacheKey];\n    });\n  }\n\n  /**\n   * Gets the state of a specific cached request.\n   *\n   * @param cacheKey - The cache key to look up.\n   * @returns The request state, or undefined if not cached.\n   */\n  getRequestState(cacheKey: string): RequestState | undefined {\n    return this.state.requests[cacheKey];\n  }\n\n  /**\n   * Updates the state for a specific request.\n   *\n   * @param cacheKey - The cache key.\n   * @param requestState - The new state for the request.\n   */\n  #updateRequestState(cacheKey: string, requestState: RequestState): void {\n    const maxSize = this.#requestCacheMaxSize;\n    const ttl = this.#requestCacheTTL;\n\n    this.update((state) => {\n      const requests = state.requests as unknown as Record<\n        string,\n        RequestState | undefined\n      >;\n      requests[cacheKey] = requestState;\n\n      // Evict expired entries based on TTL\n      // Only evict SUCCESS states that have exceeded their TTL\n      const keys = Object.keys(requests);\n      for (const key of keys) {\n        const entry = requests[key];\n        if (\n          entry &&\n          entry.status === RequestStatus.SUCCESS &&\n          isCacheExpired(entry, ttl)\n        ) {\n          delete requests[key];\n        }\n      }\n\n      // Evict oldest entries if cache still exceeds max size\n      const remainingKeys = Object.keys(requests);\n      if (remainingKeys.length > maxSize) {\n        // Sort by timestamp (oldest first)\n        const sortedKeys = remainingKeys.sort((a, b) => {\n          const aTime = requests[a]?.timestamp ?? 0;\n          const bTime = requests[b]?.timestamp ?? 0;\n          return aTime - bTime;\n        });\n\n        // Remove oldest entries until we're under the limit\n        const entriesToRemove = remainingKeys.length - maxSize;\n        for (let i = 0; i < entriesToRemove; i++) {\n          const keyToRemove = sortedKeys[i];\n          if (keyToRemove) {\n            delete requests[keyToRemove];\n          }\n        }\n      }\n    });\n  }\n\n  /**\n   * Updates the user's region by fetching geolocation.\n   * This method calls the RampsService to get the geolocation.\n   *\n   * @param options - Options for cache behavior.\n   * @returns The user region object.\n   */\n  async updateUserRegion(\n    options?: ExecuteRequestOptions,\n  ): Promise<UserRegion | null> {\n    // If a userRegion already exists and forceRefresh is not requested,\n    // return it immediately without fetching geolocation.\n    // This ensures that once a region is set (either via geolocation or manual selection),\n    // it will not be overwritten by subsequent geolocation fetches.\n    if (this.state.userRegion && !options?.forceRefresh) {\n      return this.state.userRegion;\n    }\n\n    // When forceRefresh is true, clear the existing region and region-dependent state before fetching\n    if (options?.forceRefresh) {\n      this.update((state) => {\n        state.userRegion = null;\n        state.tokens = null;\n        state.providers = [];\n        state.paymentMethods = [];\n        state.selectedPaymentMethod = null;\n      });\n    }\n\n    const cacheKey = createCacheKey('updateUserRegion', []);\n\n    const regionCode = await this.executeRequest(\n      cacheKey,\n      async () => {\n        const result = await this.messenger.call('RampsService:getGeolocation');\n        return result;\n      },\n      options,\n    );\n\n    if (!regionCode) {\n      this.update((state) => {\n        state.userRegion = null;\n        state.tokens = null;\n        state.providers = [];\n        state.paymentMethods = [];\n        state.selectedPaymentMethod = null;\n      });\n      return null;\n    }\n\n    const normalizedRegion = regionCode.toLowerCase().trim();\n\n    try {\n      const countries = await this.getCountries('buy', options);\n      const userRegion = findRegionFromCode(normalizedRegion, countries);\n\n      if (userRegion) {\n        this.update((state) => {\n          const regionChanged =\n            state.userRegion?.regionCode !== userRegion.regionCode;\n          state.userRegion = userRegion;\n          // Clear region-dependent state when region changes\n          if (regionChanged) {\n            state.tokens = null;\n            state.providers = [];\n            state.paymentMethods = [];\n            state.selectedPaymentMethod = null;\n          }\n        });\n\n        // Fetch providers for the new region\n        if (userRegion.regionCode) {\n          try {\n            await this.getProviders(userRegion.regionCode, options);\n          } catch {\n            // Provider fetch failed - error state will be available via selectors\n          }\n        }\n\n        return userRegion;\n      }\n\n      // Region not found in countries data\n      this.update((state) => {\n        state.userRegion = null;\n        state.tokens = null;\n        state.providers = [];\n        state.paymentMethods = [];\n        state.selectedPaymentMethod = null;\n      });\n\n      return null;\n    } catch {\n      // If countries fetch fails, we can't create a valid UserRegion\n      // Return null to indicate we don't have valid country data\n      this.update((state) => {\n        state.userRegion = null;\n        state.tokens = null;\n        state.providers = [];\n        state.paymentMethods = [];\n        state.selectedPaymentMethod = null;\n      });\n\n      return null;\n    }\n  }\n\n  /**\n   * Sets the user's region manually (without fetching geolocation).\n   * This allows users to override the detected region.\n   *\n   * @param region - The region code to set (e.g., \"US-CA\").\n   * @param options - Options for cache behavior.\n   * @returns The user region object.\n   */\n  async setUserRegion(\n    region: string,\n    options?: ExecuteRequestOptions,\n  ): Promise<UserRegion> {\n    const normalizedRegion = region.toLowerCase().trim();\n\n    try {\n      const countries = await this.getCountries('buy', options);\n      const userRegion = findRegionFromCode(normalizedRegion, countries);\n\n      if (userRegion) {\n        this.update((state) => {\n          state.userRegion = userRegion;\n          state.tokens = null;\n          state.providers = [];\n          state.paymentMethods = [];\n          state.selectedPaymentMethod = null;\n        });\n\n        // Fetch providers for the new region\n        try {\n          await this.getProviders(userRegion.regionCode, options);\n        } catch {\n          // Provider fetch failed - error state will be available via selectors\n        }\n\n        return userRegion;\n      }\n\n      // Region not found in countries data\n      this.update((state) => {\n        state.userRegion = null;\n        state.tokens = null;\n        state.providers = [];\n        state.paymentMethods = [];\n        state.selectedPaymentMethod = null;\n      });\n      throw new Error(\n        `Region \"${normalizedRegion}\" not found in countries data. Cannot set user region without valid country information.`,\n      );\n    } catch (error) {\n      // If the error is \"not found\", re-throw it\n      // Otherwise, it's from countries fetch failure\n      if (error instanceof Error && error.message.includes('not found')) {\n        throw error;\n      }\n      // Countries fetch failed\n      this.update((state) => {\n        state.userRegion = null;\n        state.tokens = null;\n        state.providers = [];\n        state.paymentMethods = [];\n        state.selectedPaymentMethod = null;\n      });\n      throw new Error(\n        'Failed to fetch countries data. Cannot set user region without valid country information.',\n      );\n    }\n  }\n\n  /**\n   * Sets the user's preferred provider.\n   * This allows users to set their preferred ramp provider.\n   *\n   * @param provider - The provider object to set.\n   */\n  setPreferredProvider(provider: Provider | null): void {\n    this.update((state) => {\n      state.preferredProvider = provider;\n    });\n  }\n\n  /**\n   * Initializes the controller by fetching the user's region from geolocation.\n   * This should be called once at app startup to set up the initial region.\n   * After the region is set, tokens are fetched and saved to state.\n   *\n   * If a userRegion already exists (from persistence or manual selection),\n   * this method will skip geolocation fetch and only fetch tokens if needed.\n   *\n   * @param options - Options for cache behavior.\n   * @returns Promise that resolves when initialization is complete.\n   */\n  async init(options?: ExecuteRequestOptions): Promise<void> {\n    const userRegion = await this.updateUserRegion(options).catch(() => {\n      // User region fetch failed - error state will be available via selectors\n      return null;\n    });\n\n    if (userRegion) {\n      try {\n        await this.getTokens(userRegion.regionCode, 'buy', options);\n      } catch {\n        // Token fetch failed - error state will be available via selectors\n      }\n\n      try {\n        await this.getProviders(userRegion.regionCode, options);\n      } catch {\n        // Provider fetch failed - error state will be available via selectors\n      }\n    }\n  }\n\n  /**\n   * Fetches the list of supported countries for a given ramp action.\n   *\n   * @param action - The ramp action type ('buy' or 'sell').\n   * @param options - Options for cache behavior.\n   * @returns An array of countries.\n   */\n  async getCountries(\n    action: RampAction = 'buy',\n    options?: ExecuteRequestOptions,\n  ): Promise<Country[]> {\n    const cacheKey = createCacheKey('getCountries', [action]);\n\n    return this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call('RampsService:getCountries', action);\n      },\n      options,\n    );\n  }\n\n  /**\n   * Fetches the list of available tokens for a given region and action.\n   * The tokens are saved in the controller state once fetched.\n   *\n   * @param region - The region code (e.g., \"us\", \"fr\", \"us-ny\"). If not provided, uses the user's region from controller state.\n   * @param action - The ramp action type ('buy' or 'sell').\n   * @param options - Options for cache behavior and query filters.\n   * @param options.provider - Provider ID(s) to filter by.\n   * @returns The tokens response containing topTokens and allTokens.\n   */\n  async getTokens(\n    region?: string,\n    action: RampAction = 'buy',\n    options?: ExecuteRequestOptions & {\n      provider?: string | string[];\n    },\n  ): Promise<TokensResponse> {\n    const regionToUse = region ?? this.state.userRegion?.regionCode;\n\n    if (!regionToUse) {\n      throw new Error(\n        'Region is required. Either provide a region parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    const normalizedRegion = regionToUse.toLowerCase().trim();\n    const cacheKey = createCacheKey('getTokens', [\n      normalizedRegion,\n      action,\n      options?.provider,\n    ]);\n\n    const tokens = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call(\n          'RampsService:getTokens',\n          normalizedRegion,\n          action,\n          {\n            provider: options?.provider,\n          },\n        );\n      },\n      options,\n    );\n\n    this.update((state) => {\n      const userRegionCode = state.userRegion?.regionCode;\n\n      if (userRegionCode === undefined || userRegionCode === normalizedRegion) {\n        state.tokens = tokens;\n      }\n    });\n\n    return tokens;\n  }\n\n  /**\n   * Fetches the list of providers for a given region.\n   * The providers are saved in the controller state once fetched.\n   *\n   * @param region - The region code (e.g., \"us\", \"fr\", \"us-ny\"). If not provided, uses the user's region from controller state.\n   * @param options - Options for cache behavior and query filters.\n   * @param options.provider - Provider ID(s) to filter by.\n   * @param options.crypto - Crypto currency ID(s) to filter by.\n   * @param options.fiat - Fiat currency ID(s) to filter by.\n   * @param options.payments - Payment method ID(s) to filter by.\n   * @returns The providers response containing providers array.\n   */\n  async getProviders(\n    region?: string,\n    options?: ExecuteRequestOptions & {\n      provider?: string | string[];\n      crypto?: string | string[];\n      fiat?: string | string[];\n      payments?: string | string[];\n    },\n  ): Promise<{ providers: Provider[] }> {\n    const regionToUse = region ?? this.state.userRegion?.regionCode;\n\n    if (!regionToUse) {\n      throw new Error(\n        'Region is required. Either provide a region parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    const normalizedRegion = regionToUse.toLowerCase().trim();\n    const cacheKey = createCacheKey('getProviders', [\n      normalizedRegion,\n      options?.provider,\n      options?.crypto,\n      options?.fiat,\n      options?.payments,\n    ]);\n\n    const { providers } = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call(\n          'RampsService:getProviders',\n          normalizedRegion,\n          {\n            provider: options?.provider,\n            crypto: options?.crypto,\n            fiat: options?.fiat,\n            payments: options?.payments,\n          },\n        );\n      },\n      options,\n    );\n\n    this.update((state) => {\n      const userRegionCode = state.userRegion?.regionCode;\n\n      if (userRegionCode === undefined || userRegionCode === normalizedRegion) {\n        state.providers = providers;\n      }\n    });\n\n    return { providers };\n  }\n\n  /**\n   * Fetches the list of payment methods for a given context.\n   * The payment methods are saved in the controller state once fetched.\n   *\n   * @param options - Query parameters for filtering payment methods.\n   * @param options.region - User's region code. If not provided, uses the user's region from controller state.\n   * @param options.fiat - Fiat currency code (e.g., \"usd\"). If not provided, uses the user's region currency.\n   * @param options.assetId - CAIP-19 cryptocurrency identifier.\n   * @param options.provider - Provider ID path.\n   * @param options.forceRefresh - Whether to bypass cache.\n   * @param options.ttl - Custom TTL for this request.\n   * @returns The payment methods response containing payments array.\n   */\n  async getPaymentMethods(options: {\n    region?: string;\n    fiat?: string;\n    assetId: string;\n    provider: string;\n    forceRefresh?: boolean;\n    ttl?: number;\n  }): Promise<PaymentMethodsResponse> {\n    const regionToUse = options.region ?? this.state.userRegion?.regionCode;\n    const fiatToUse = options.fiat ?? this.state.userRegion?.country?.currency;\n\n    if (!regionToUse) {\n      throw new Error(\n        'Region is required. Either provide a region parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    if (!fiatToUse) {\n      throw new Error(\n        'Fiat currency is required. Either provide a fiat parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    const normalizedRegion = regionToUse.toLowerCase().trim();\n    const normalizedFiat = fiatToUse.toLowerCase().trim();\n    const cacheKey = createCacheKey('getPaymentMethods', [\n      normalizedRegion,\n      normalizedFiat,\n      options.assetId,\n      options.provider,\n    ]);\n\n    const response = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call('RampsService:getPaymentMethods', {\n          region: normalizedRegion,\n          fiat: normalizedFiat,\n          assetId: options.assetId,\n          provider: options.provider,\n        });\n      },\n      { forceRefresh: options.forceRefresh, ttl: options.ttl },\n    );\n\n    this.update((state) => {\n      state.paymentMethods = response.payments;\n      // Only clear selected payment method if it's no longer in the new list\n      // This preserves the selection when cached data is returned (same context)\n      if (\n        state.selectedPaymentMethod &&\n        !response.payments.some(\n          (pm) => pm.id === state.selectedPaymentMethod?.id,\n        )\n      ) {\n        state.selectedPaymentMethod = null;\n      }\n    });\n\n    return response;\n  }\n\n  /**\n   * Sets the user's selected payment method.\n   *\n   * @param paymentMethod - The payment method to select, or null to clear.\n   */\n  setSelectedPaymentMethod(paymentMethod: PaymentMethod | null): void {\n    this.update((state) => {\n      state.selectedPaymentMethod = paymentMethod;\n    });\n  }\n\n  // ============================================================\n  // Sync Trigger Methods\n  // These fire-and-forget methods are for use in React effects.\n  // Errors are stored in state and available via selectors.\n  // ============================================================\n\n  /**\n   * Triggers a user region update without throwing.\n   *\n   * @param options - Options for cache behavior.\n   */\n  triggerUpdateUserRegion(options?: ExecuteRequestOptions): void {\n    this.updateUserRegion(options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers setting the user region without throwing.\n   *\n   * @param region - The region code to set (e.g., \"US-CA\").\n   * @param options - Options for cache behavior.\n   */\n  triggerSetUserRegion(region: string, options?: ExecuteRequestOptions): void {\n    this.setUserRegion(region, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching countries without throwing.\n   *\n   * @param action - The ramp action type ('buy' or 'sell').\n   * @param options - Options for cache behavior.\n   */\n  triggerGetCountries(\n    action: 'buy' | 'sell' = 'buy',\n    options?: ExecuteRequestOptions,\n  ): void {\n    this.getCountries(action, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching tokens without throwing.\n   *\n   * @param region - The region code. If not provided, uses userRegion from state.\n   * @param action - The ramp action type ('buy' or 'sell').\n   * @param options - Options for cache behavior.\n   */\n  triggerGetTokens(\n    region?: string,\n    action: 'buy' | 'sell' = 'buy',\n    options?: ExecuteRequestOptions,\n  ): void {\n    this.getTokens(region, action, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching providers without throwing.\n   *\n   * @param region - The region code. If not provided, uses userRegion from state.\n   * @param options - Options for cache behavior and query filters.\n   */\n  triggerGetProviders(\n    region?: string,\n    options?: ExecuteRequestOptions & {\n      provider?: string | string[];\n      crypto?: string | string[];\n      fiat?: string | string[];\n      payments?: string | string[];\n    },\n  ): void {\n    this.getProviders(region, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching payment methods without throwing.\n   *\n   * @param options - Query parameters for filtering payment methods.\n   * @param options.region - User's region code. If not provided, uses userRegion from state.\n   * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.\n   * @param options.assetId - CAIP-19 cryptocurrency identifier.\n   * @param options.provider - Provider ID path.\n   * @param options.forceRefresh - Whether to bypass cache.\n   * @param options.ttl - Custom TTL for this request.\n   */\n  triggerGetPaymentMethods(options: {\n    region?: string;\n    fiat?: string;\n    assetId: string;\n    provider: string;\n    forceRefresh?: boolean;\n    ttl?: number;\n  }): void {\n    this.getPaymentMethods(options).catch(() => {\n      // Error stored in state\n    });\n  }\n}\n"]}
+{"version":3,"file":"RampsController.cjs","sourceRoot":"","sources":["../src/RampsController.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAKA,+DAA2D;AA0B3D,qDASwB;AAExB,kBAAkB;AAElB;;;;GAIG;AACU,QAAA,cAAc,GAAG,iBAAiB,CAAC;AAoEhD;;GAEG;AACH,MAAM,uBAAuB,GAAG;IAC9B,UAAU,EAAE;QACV,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,MAAM,EAAE;QACN,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,cAAc,EAAE;QACd,OAAO,EAAE,KAAK;QACd,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,KAAK;QACd,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;KACf;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,KAAK;QACd,sBAAsB,EAAE,IAAI;QAC5B,kBAAkB,EAAE,KAAK;QACzB,QAAQ,EAAE,IAAI;KACf;CAC4C,CAAC;AAEhD;;;;;;;GAOG;AACH,SAAgB,8BAA8B;IAC5C,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,IAAI;QACZ,cAAc,EAAE,EAAE;QAClB,qBAAqB,EAAE,IAAI;QAC3B,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAXD,wEAWC;AAqED,2BAA2B;AAE3B;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,UAAkB,EAClB,SAAoB;IAEpB,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;QAC7C,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,WAAW,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChE,OAAO,aAAa,KAAK,WAAW,CAAC;YACvC,CAAC;YACD,OAAO,EAAE,KAAK,WAAW,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAiB,IAAI,CAAC;IAC/B,IAAI,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,KAAK;YACH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;gBAChC,IAAI,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;oBACnD,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC3C,IACE,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;wBACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC,EACjC,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,IAAI,IAAI,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO;QACP,KAAK;QACL,UAAU,EAAE,cAAc;KAC3B,CAAC;AACJ,CAAC;AAED,gCAAgC;AAEhC;;GAEG;AACH,MAAa,eAAgB,SAAQ,gCAIpC;IAiBC;;;;;;;;;OASG;IACH,YAAY,EACV,SAAS,EACT,KAAK,GAAG,EAAE,EACV,eAAe,GAAG,wCAAyB,EAC3C,mBAAmB,GAAG,6CAA8B,GAC7B;QACvB,KAAK,CAAC;YACJ,SAAS;YACT,QAAQ,EAAE,uBAAuB;YACjC,IAAI,EAAE,sBAAc;YACpB,KAAK,EAAE;gBACL,GAAG,8BAA8B,EAAE;gBACnC,GAAG,KAAK;gBACR,gEAAgE;gBAChE,QAAQ,EAAE,EAAE;aACb;SACF,CAAC,CAAC;;QA1CL;;WAEG;QACM,mDAAyB;QAElC;;WAEG;QACM,uDAA6B;QAEtC;;;WAGG;QACM,2CAAgD,IAAI,GAAG,EAAE,EAAC;QA8BjE,uBAAA,IAAI,oCAAoB,eAAe,MAAA,CAAC;QACxC,uBAAA,IAAI,wCAAwB,mBAAmB,MAAA,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,OAAkD,EAClD,OAA+B;QAE/B,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,uBAAA,IAAI,wCAAiB,CAAC;QAElD,6EAA6E;QAC7E,MAAM,OAAO,GAAG,uBAAA,IAAI,wCAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,OAA2B,CAAC;QAC7C,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,MAAM,IAAI,CAAC,IAAA,6BAAc,EAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC3C,OAAO,MAAM,CAAC,IAAe,CAAC;YAChC,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEjC,0BAA0B;QAC1B,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EAAqB,QAAQ,EAAE,IAAA,iCAAkB,GAAE,CAAC,CAAC;QAEzD,2BAA2B;QAC3B,MAAM,OAAO,GAAG,CAAC,KAAK,IAAsB,EAAE;YAC5C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBAEnD,gCAAgC;gBAChC,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACzC,CAAC;gBAED,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EACF,QAAQ,EACR,IAAA,iCAAkB,EAAC,IAAY,EAAE,aAAa,CAAC,CAChD,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,gCAAgC;gBAChC,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnC,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,MAAM,YAAY,GAAI,KAAe,EAAE,OAAO,CAAC;gBAE/C,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EACF,QAAQ,EACR,IAAA,+BAAgB,EAAC,YAAY,IAAI,eAAe,EAAE,aAAa,CAAC,CACjE,CAAC;gBACF,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,yEAAyE;gBACzE,MAAM,cAAc,GAAG,uBAAA,IAAI,wCAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC3D,IAAI,cAAc,EAAE,eAAe,KAAK,eAAe,EAAE,CAAC;oBACxD,uBAAA,IAAI,wCAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,0CAA0C;QAC1C,uBAAA,IAAI,wCAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;QAElE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,QAAgB;QAC3B,MAAM,OAAO,GAAG,uBAAA,IAAI,wCAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAChC,uBAAA,IAAI,wCAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvC,uBAAA,IAAI,uEAAoB,MAAxB,IAAI,EAAqB,QAAQ,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IA4BD;;;;;OAKG;IACH,eAAe,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAuDD;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,OAA+B;QAE/B,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAErD,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YACjC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzC,uBAAA,IAAI,iEAAc,MAAlB,IAAI,CAAgB,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;YAEnE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,uBAAA,IAAI,iEAAc,MAAlB,IAAI,CAAgB,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,WAAW,gBAAgB,0FAA0F,CACtH,CAAC;YACJ,CAAC;YAED,oDAAoD;YACpD,MAAM,aAAa,GACjB,gBAAgB,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;YAEzD,8EAA8E;YAC9E,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBACpB,IAAI,aAAa,EAAE,CAAC;oBAClB,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;oBAC/B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;oBACpB,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;oBACrB,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC;oBAC1B,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC;gBACrC,CAAC;gBACD,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,+DAA+D;YAC/D,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uBAAA,IAAI,iEAAc,MAAlB,IAAI,CAAgB,CAAC;YACrB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,QAAyB;QAC5C,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,iBAAiB,GAAG,QAAQ,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAC,OAA+B;QACxC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEjC,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;QACnD,UAAU,KAAV,UAAU,GAAK,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,6BAA6B,CAAC,EAAC;QAExE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,YAAY,CAAC,OAA+B;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,YAAY,CAAC,OAA+B;QAChD,MAAM,QAAQ,GAAG,IAAA,6BAAc,EAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAEpD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CACzC,QAAQ,EACR,KAAK,IAAI,EAAE;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1D,CAAC,EACD,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,SAAS,CACb,MAAe,EACf,SAAqB,KAAK,EAC1B,OAEC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;QAEhE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAA,6BAAc,EAAC,WAAW,EAAE;YAC3C,gBAAgB;YAChB,MAAM;YACN,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CACtC,QAAQ,EACR,KAAK,IAAI,EAAE;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CACxB,wBAAwB,EACxB,gBAAgB,EAChB,MAAM,EACN;gBACE,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC5B,CACF,CAAC;QACJ,CAAC,EACD,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;YAEpD,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,gBAAgB,EAAE,CAAC;gBACxE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,YAAY,CAChB,MAAe,EACf,OAKC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;QAEhE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAA,6BAAc,EAAC,cAAc,EAAE;YAC9C,gBAAgB;YAChB,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAC7C,QAAQ,EACR,KAAK,IAAI,EAAE;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CACxB,2BAA2B,EAC3B,gBAAgB,EAChB;gBACE,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC5B,CACF,CAAC;QACJ,CAAC,EACD,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;YAEpD,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,gBAAgB,EAAE,CAAC;gBACxE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAOvB;QACC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;QACxE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC;QAE3E,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAA,6BAAc,EAAC,mBAAmB,EAAE;YACnD,gBAAgB;YAChB,cAAc;YACd,OAAO,CAAC,OAAO;YACf,OAAO,CAAC,QAAQ;SACjB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CACxC,QAAQ,EACR,KAAK,IAAI,EAAE;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gCAAgC,EAAE;gBAC3D,MAAM,EAAE,gBAAgB;gBACxB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;QACL,CAAC,EACD,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CACzD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC;YACzC,uEAAuE;YACvE,2EAA2E;YAC3E,IACE,KAAK,CAAC,qBAAqB;gBAC3B,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC,EAAiB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,qBAAqB,EAAE,EAAE,CACjE,EACD,CAAC;gBACD,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC;YACrC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,wBAAwB,CAAC,aAAmC;QAC1D,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,qBAAqB,GAAG,aAAa,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,uBAAuB;IACvB,8DAA8D;IAC9D,0DAA0D;IAC1D,+DAA+D;IAE/D;;;;;OAKG;IACH,oBAAoB,CAAC,MAAc,EAAE,OAA+B;QAClE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC7C,wBAAwB;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,OAA+B;QACjD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACpC,wBAAwB;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CACd,MAAe,EACf,SAAyB,KAAK,EAC9B,OAA+B;QAE/B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACjD,wBAAwB;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CACjB,MAAe,EACf,OAKC;QAED,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC5C,wBAAwB;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,OAOxB;QACC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACzC,wBAAwB;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAvqBD,0CAuqBC;yRAzgBqB,QAAgB;IAClC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAGtB,CAAC;QACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;IAGC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC/B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;QACrB,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC;QAC1B,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,qFAkBmB,QAAgB,EAAE,YAA0B;IAC9D,MAAM,OAAO,GAAG,uBAAA,IAAI,4CAAqB,CAAC;IAC1C,MAAM,GAAG,GAAG,uBAAA,IAAI,wCAAiB,CAAC;IAElC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAGtB,CAAC;QACF,QAAQ,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;QAElC,qCAAqC;QACrC,yDAAyD;QACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC5B,IACE,KAAK;gBACL,KAAK,CAAC,MAAM,KAAK,4BAAa,CAAC,OAAO;gBACtC,IAAA,6BAAc,EAAC,KAAK,EAAE,GAAG,CAAC,EAC1B,CAAC;gBACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,uDAAuD;QACvD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;YACnC,mCAAmC;YACnC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC;gBAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC;gBAC1C,OAAO,KAAK,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,oDAAoD;YACpD,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC;YACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,WAAW,EAAE,CAAC;oBAChB,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { Json } from '@metamask/utils';\n\nimport type {\n  Country,\n  TokensResponse,\n  Provider,\n  State,\n  RampAction,\n  PaymentMethod,\n  PaymentMethodsResponse,\n} from './RampsService';\nimport type {\n  RampsServiceGetGeolocationAction,\n  RampsServiceGetCountriesAction,\n  RampsServiceGetTokensAction,\n  RampsServiceGetProvidersAction,\n  RampsServiceGetPaymentMethodsAction,\n} from './RampsService-method-action-types';\nimport type {\n  RequestCache as RequestCacheType,\n  RequestState,\n  ExecuteRequestOptions,\n  PendingRequest,\n} from './RequestCache';\nimport {\n  DEFAULT_REQUEST_CACHE_TTL,\n  DEFAULT_REQUEST_CACHE_MAX_SIZE,\n  createCacheKey,\n  isCacheExpired,\n  createLoadingState,\n  createSuccessState,\n  createErrorState,\n  RequestStatus,\n} from './RequestCache';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link RampsController}, used to namespace the\n * controller's actions and events and to namespace the controller's state data\n * when composed with other controllers.\n */\nexport const controllerName = 'RampsController';\n\n// === STATE ===\n\n/**\n * Represents the user's selected region with full country and state objects.\n */\nexport type UserRegion = {\n  /**\n   * The country object for the selected region.\n   */\n  country: Country;\n  /**\n   * The state object if a state was selected, null if only country was selected.\n   */\n  state: State | null;\n  /**\n   * The region code string (e.g., \"us-ut\" or \"fr\") used for API calls.\n   */\n  regionCode: string;\n};\n\n/**\n * Describes the shape of the state object for {@link RampsController}.\n */\nexport type RampsControllerState = {\n  /**\n   * The user's selected region with full country and state objects.\n   * Initially set via geolocation fetch, but can be manually changed by the user.\n   * Once set (either via geolocation or manual selection), it will not be overwritten\n   * by subsequent geolocation fetches.\n   */\n  userRegion: UserRegion | null;\n  /**\n   * The user's preferred provider.\n   * Can be manually set by the user.\n   */\n  preferredProvider: Provider | null;\n  /**\n   * List of countries available for ramp actions.\n   */\n  countries: Country[];\n  /**\n   * List of providers available for the current region.\n   */\n  providers: Provider[];\n  /**\n   * Tokens fetched for the current region and action.\n   * Contains topTokens and allTokens arrays.\n   */\n  tokens: TokensResponse | null;\n  /**\n   * Payment methods available for the current context.\n   * Filtered by region, fiat, asset, and provider.\n   */\n  paymentMethods: PaymentMethod[];\n  /**\n   * The user's selected payment method.\n   * Can be manually set by the user.\n   */\n  selectedPaymentMethod: PaymentMethod | null;\n  /**\n   * Cache of request states, keyed by cache key.\n   * This stores loading, success, and error states for API requests.\n   */\n  requests: RequestCacheType;\n};\n\n/**\n * The metadata for each property in {@link RampsControllerState}.\n */\nconst rampsControllerMetadata = {\n  userRegion: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  preferredProvider: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  countries: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  providers: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  tokens: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  paymentMethods: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  selectedPaymentMethod: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  requests: {\n    persist: false,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: false,\n    usedInUi: true,\n  },\n} satisfies StateMetadata<RampsControllerState>;\n\n/**\n * Constructs the default {@link RampsController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link RampsController} state.\n */\nexport function getDefaultRampsControllerState(): RampsControllerState {\n  return {\n    userRegion: null,\n    preferredProvider: null,\n    countries: [],\n    providers: [],\n    tokens: null,\n    paymentMethods: [],\n    selectedPaymentMethod: null,\n    requests: {},\n  };\n}\n\n// === MESSENGER ===\n\n/**\n * Retrieves the state of the {@link RampsController}.\n */\nexport type RampsControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  RampsControllerState\n>;\n\n/**\n * Actions that {@link RampsControllerMessenger} exposes to other consumers.\n */\nexport type RampsControllerActions = RampsControllerGetStateAction;\n\n/**\n * Actions from other messengers that {@link RampsController} calls.\n */\ntype AllowedActions =\n  | RampsServiceGetGeolocationAction\n  | RampsServiceGetCountriesAction\n  | RampsServiceGetTokensAction\n  | RampsServiceGetProvidersAction\n  | RampsServiceGetPaymentMethodsAction;\n\n/**\n * Published when the state of {@link RampsController} changes.\n */\nexport type RampsControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  RampsControllerState\n>;\n\n/**\n * Events that {@link RampsControllerMessenger} exposes to other consumers.\n */\nexport type RampsControllerEvents = RampsControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link RampsController} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link RampsController}.\n */\nexport type RampsControllerMessenger = Messenger<\n  typeof controllerName,\n  RampsControllerActions | AllowedActions,\n  RampsControllerEvents | AllowedEvents\n>;\n\n/**\n * Configuration options for the RampsController.\n */\nexport type RampsControllerOptions = {\n  /** The messenger suited for this controller. */\n  messenger: RampsControllerMessenger;\n  /** The desired state with which to initialize this controller. */\n  state?: Partial<RampsControllerState>;\n  /** Time to live for cached requests in milliseconds. Defaults to 15 minutes. */\n  requestCacheTTL?: number;\n  /** Maximum number of entries in the request cache. Defaults to 250. */\n  requestCacheMaxSize?: number;\n};\n\n// === HELPER FUNCTIONS ===\n\n/**\n * Finds a country and state from a region code string.\n *\n * @param regionCode - The region code (e.g., \"us-ca\" or \"us\").\n * @param countries - Array of countries to search.\n * @returns UserRegion object with country and state, or null if not found.\n */\nfunction findRegionFromCode(\n  regionCode: string,\n  countries: Country[],\n): UserRegion | null {\n  const normalizedCode = regionCode.toLowerCase().trim();\n  const parts = normalizedCode.split('-');\n  const countryCode = parts[0];\n  const stateCode = parts[1];\n\n  const country = countries.find((countryItem) => {\n    if (countryItem.isoCode?.toLowerCase() === countryCode) {\n      return true;\n    }\n    if (countryItem.id) {\n      const id = countryItem.id.toLowerCase();\n      if (id.startsWith('/regions/')) {\n        const extractedCode = id.replace('/regions/', '').split('/')[0];\n        return extractedCode === countryCode;\n      }\n      return id === countryCode || id.endsWith(`/${countryCode}`);\n    }\n    return false;\n  });\n\n  if (!country) {\n    return null;\n  }\n\n  let state: State | null = null;\n  if (stateCode && country.states) {\n    state =\n      country.states.find((stateItem) => {\n        if (stateItem.stateId?.toLowerCase() === stateCode) {\n          return true;\n        }\n        if (stateItem.id) {\n          const stateId = stateItem.id.toLowerCase();\n          if (\n            stateId.includes(`-${stateCode}`) ||\n            stateId.endsWith(`/${stateCode}`)\n          ) {\n            return true;\n          }\n        }\n        return false;\n      }) ?? null;\n  }\n\n  return {\n    country,\n    state,\n    regionCode: normalizedCode,\n  };\n}\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * Manages cryptocurrency on/off ramps functionality.\n */\nexport class RampsController extends BaseController<\n  typeof controllerName,\n  RampsControllerState,\n  RampsControllerMessenger\n> {\n  /**\n   * Default TTL for cached requests.\n   */\n  readonly #requestCacheTTL: number;\n\n  /**\n   * Maximum number of entries in the request cache.\n   */\n  readonly #requestCacheMaxSize: number;\n\n  /**\n   * Map of pending requests for deduplication.\n   * Key is the cache key, value is the pending request with abort controller.\n   */\n  readonly #pendingRequests: Map<string, PendingRequest> = new Map();\n\n  /**\n   * Constructs a new {@link RampsController}.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this controller.\n   * @param args.state - The desired state with which to initialize this\n   * controller. Missing properties will be filled in with defaults.\n   * @param args.requestCacheTTL - Time to live for cached requests in milliseconds.\n   * @param args.requestCacheMaxSize - Maximum number of entries in the request cache.\n   */\n  constructor({\n    messenger,\n    state = {},\n    requestCacheTTL = DEFAULT_REQUEST_CACHE_TTL,\n    requestCacheMaxSize = DEFAULT_REQUEST_CACHE_MAX_SIZE,\n  }: RampsControllerOptions) {\n    super({\n      messenger,\n      metadata: rampsControllerMetadata,\n      name: controllerName,\n      state: {\n        ...getDefaultRampsControllerState(),\n        ...state,\n        // Always reset requests cache on initialization (non-persisted)\n        requests: {},\n      },\n    });\n\n    this.#requestCacheTTL = requestCacheTTL;\n    this.#requestCacheMaxSize = requestCacheMaxSize;\n  }\n\n  /**\n   * Executes a request with caching and deduplication.\n   *\n   * If a request with the same cache key is already in flight, returns the\n   * existing promise. If valid cached data exists, returns it without making\n   * a new request.\n   *\n   * @param cacheKey - Unique identifier for this request.\n   * @param fetcher - Function that performs the actual fetch. Receives an AbortSignal.\n   * @param options - Options for cache behavior.\n   * @returns The result of the request.\n   */\n  async executeRequest<TResult>(\n    cacheKey: string,\n    fetcher: (signal: AbortSignal) => Promise<TResult>,\n    options?: ExecuteRequestOptions,\n  ): Promise<TResult> {\n    const ttl = options?.ttl ?? this.#requestCacheTTL;\n\n    // Check for existing pending request - join it instead of making a duplicate\n    const pending = this.#pendingRequests.get(cacheKey);\n    if (pending) {\n      return pending.promise as Promise<TResult>;\n    }\n\n    // Check cache validity (unless force refresh)\n    if (!options?.forceRefresh) {\n      const cached = this.state.requests[cacheKey];\n      if (cached && !isCacheExpired(cached, ttl)) {\n        return cached.data as TResult;\n      }\n    }\n\n    // Create abort controller for this request\n    const abortController = new AbortController();\n    const lastFetchedAt = Date.now();\n\n    // Update state to loading\n    this.#updateRequestState(cacheKey, createLoadingState());\n\n    // Create the fetch promise\n    const promise = (async (): Promise<TResult> => {\n      try {\n        const data = await fetcher(abortController.signal);\n\n        // Don't update state if aborted\n        if (abortController.signal.aborted) {\n          throw new Error('Request was aborted');\n        }\n\n        this.#updateRequestState(\n          cacheKey,\n          createSuccessState(data as Json, lastFetchedAt),\n        );\n        return data;\n      } catch (error) {\n        // Don't update state if aborted\n        if (abortController.signal.aborted) {\n          throw error;\n        }\n\n        const errorMessage = (error as Error)?.message;\n\n        this.#updateRequestState(\n          cacheKey,\n          createErrorState(errorMessage ?? 'Unknown error', lastFetchedAt),\n        );\n        throw error;\n      } finally {\n        // Only delete if this is still our entry (not replaced by a new request)\n        const currentPending = this.#pendingRequests.get(cacheKey);\n        if (currentPending?.abortController === abortController) {\n          this.#pendingRequests.delete(cacheKey);\n        }\n      }\n    })();\n\n    // Store pending request for deduplication\n    this.#pendingRequests.set(cacheKey, { promise, abortController });\n\n    return promise;\n  }\n\n  /**\n   * Aborts a pending request if one exists.\n   *\n   * @param cacheKey - The cache key of the request to abort.\n   * @returns True if a request was aborted.\n   */\n  abortRequest(cacheKey: string): boolean {\n    const pending = this.#pendingRequests.get(cacheKey);\n    if (pending) {\n      pending.abortController.abort();\n      this.#pendingRequests.delete(cacheKey);\n      this.#removeRequestState(cacheKey);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Removes a request state from the cache.\n   *\n   * @param cacheKey - The cache key to remove.\n   */\n  #removeRequestState(cacheKey: string): void {\n    this.update((state) => {\n      const requests = state.requests as unknown as Record<\n        string,\n        RequestState | undefined\n      >;\n      delete requests[cacheKey];\n    });\n  }\n\n  #cleanupState(): void {\n    this.update((state) => {\n      state.userRegion = null;\n      state.preferredProvider = null;\n      state.tokens = null;\n      state.providers = [];\n      state.paymentMethods = [];\n      state.selectedPaymentMethod = null;\n    });\n  }\n\n  /**\n   * Gets the state of a specific cached request.\n   *\n   * @param cacheKey - The cache key to look up.\n   * @returns The request state, or undefined if not cached.\n   */\n  getRequestState(cacheKey: string): RequestState | undefined {\n    return this.state.requests[cacheKey];\n  }\n\n  /**\n   * Updates the state for a specific request.\n   *\n   * @param cacheKey - The cache key.\n   * @param requestState - The new state for the request.\n   */\n  #updateRequestState(cacheKey: string, requestState: RequestState): void {\n    const maxSize = this.#requestCacheMaxSize;\n    const ttl = this.#requestCacheTTL;\n\n    this.update((state) => {\n      const requests = state.requests as unknown as Record<\n        string,\n        RequestState | undefined\n      >;\n      requests[cacheKey] = requestState;\n\n      // Evict expired entries based on TTL\n      // Only evict SUCCESS states that have exceeded their TTL\n      const keys = Object.keys(requests);\n      for (const key of keys) {\n        const entry = requests[key];\n        if (\n          entry &&\n          entry.status === RequestStatus.SUCCESS &&\n          isCacheExpired(entry, ttl)\n        ) {\n          delete requests[key];\n        }\n      }\n\n      // Evict oldest entries if cache still exceeds max size\n      const remainingKeys = Object.keys(requests);\n      if (remainingKeys.length > maxSize) {\n        // Sort by timestamp (oldest first)\n        const sortedKeys = remainingKeys.sort((a, b) => {\n          const aTime = requests[a]?.timestamp ?? 0;\n          const bTime = requests[b]?.timestamp ?? 0;\n          return aTime - bTime;\n        });\n\n        // Remove oldest entries until we're under the limit\n        const entriesToRemove = remainingKeys.length - maxSize;\n        for (let i = 0; i < entriesToRemove; i++) {\n          const keyToRemove = sortedKeys[i];\n          if (keyToRemove) {\n            delete requests[keyToRemove];\n          }\n        }\n      }\n    });\n  }\n\n  /**\n   * Sets the user's region manually (without fetching geolocation).\n   * This allows users to override the detected region.\n   *\n   * @param region - The region code to set (e.g., \"US-CA\").\n   * @param options - Options for cache behavior.\n   * @returns The user region object.\n   */\n  async setUserRegion(\n    region: string,\n    options?: ExecuteRequestOptions,\n  ): Promise<UserRegion> {\n    const normalizedRegion = region.toLowerCase().trim();\n\n    try {\n      const { countries } = this.state;\n      if (!countries || countries.length === 0) {\n        this.#cleanupState();\n        throw new Error(\n          'No countries found. Cannot set user region without valid country information.',\n        );\n      }\n\n      const userRegion = findRegionFromCode(normalizedRegion, countries);\n\n      if (!userRegion) {\n        this.#cleanupState();\n        throw new Error(\n          `Region \"${normalizedRegion}\" not found in countries data. Cannot set user region without valid country information.`,\n        );\n      }\n\n      // Only cleanup state if region is actually changing\n      const regionChanged =\n        normalizedRegion !== this.state.userRegion?.regionCode;\n\n      // Set the new region atomically with cleanup to avoid intermediate null state\n      this.update((state) => {\n        if (regionChanged) {\n          state.preferredProvider = null;\n          state.tokens = null;\n          state.providers = [];\n          state.paymentMethods = [];\n          state.selectedPaymentMethod = null;\n        }\n        state.userRegion = userRegion;\n      });\n\n      // Only trigger fetches if region changed or if data is missing\n      if (regionChanged || !this.state.tokens) {\n        this.triggerGetTokens(userRegion.regionCode, 'buy', options);\n      }\n      if (regionChanged || this.state.providers.length === 0) {\n        this.triggerGetProviders(userRegion.regionCode, options);\n      }\n\n      return userRegion;\n    } catch (error) {\n      this.#cleanupState();\n      throw error;\n    }\n  }\n\n  /**\n   * Sets the user's preferred provider.\n   * This allows users to set their preferred ramp provider.\n   *\n   * @param provider - The provider object to set.\n   */\n  setPreferredProvider(provider: Provider | null): void {\n    this.update((state) => {\n      state.preferredProvider = provider;\n    });\n  }\n\n  /**\n   * Initializes the controller by fetching the user's region from geolocation.\n   * This should be called once at app startup to set up the initial region.\n   *\n   * If a userRegion already exists (from persistence or manual selection),\n   * this method will skip geolocation fetch and use the existing region.\n   *\n   * @param options - Options for cache behavior.\n   * @returns Promise that resolves when initialization is complete.\n   */\n  async init(options?: ExecuteRequestOptions): Promise<void> {\n    await this.getCountries(options);\n\n    let regionCode = this.state.userRegion?.regionCode;\n    regionCode ??= await this.messenger.call('RampsService:getGeolocation');\n\n    if (!regionCode) {\n      throw new Error(\n        'Failed to fetch geolocation. Cannot initialize controller without valid region information.',\n      );\n    }\n\n    await this.setUserRegion(regionCode, options);\n  }\n\n  hydrateState(options?: ExecuteRequestOptions): void {\n    const regionCode = this.state.userRegion?.regionCode;\n    if (!regionCode) {\n      throw new Error(\n        'Region code is required. Cannot hydrate state without valid region information.',\n      );\n    }\n\n    this.triggerGetTokens(regionCode, 'buy', options);\n    this.triggerGetProviders(regionCode, options);\n  }\n\n  /**\n   * Fetches the list of supported countries.\n   * The API returns countries with support information for both buy and sell actions.\n   * The countries are saved in the controller state once fetched.\n   *\n   * @param options - Options for cache behavior.\n   * @returns An array of countries.\n   */\n  async getCountries(options?: ExecuteRequestOptions): Promise<Country[]> {\n    const cacheKey = createCacheKey('getCountries', []);\n\n    const countries = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call('RampsService:getCountries');\n      },\n      options,\n    );\n\n    this.update((state) => {\n      state.countries = countries;\n    });\n\n    return countries;\n  }\n\n  /**\n   * Fetches the list of available tokens for a given region and action.\n   * The tokens are saved in the controller state once fetched.\n   *\n   * @param region - The region code (e.g., \"us\", \"fr\", \"us-ny\"). If not provided, uses the user's region from controller state.\n   * @param action - The ramp action type ('buy' or 'sell').\n   * @param options - Options for cache behavior and query filters.\n   * @param options.provider - Provider ID(s) to filter by.\n   * @returns The tokens response containing topTokens and allTokens.\n   */\n  async getTokens(\n    region?: string,\n    action: RampAction = 'buy',\n    options?: ExecuteRequestOptions & {\n      provider?: string | string[];\n    },\n  ): Promise<TokensResponse> {\n    const regionToUse = region ?? this.state.userRegion?.regionCode;\n\n    if (!regionToUse) {\n      throw new Error(\n        'Region is required. Either provide a region parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    const normalizedRegion = regionToUse.toLowerCase().trim();\n    const cacheKey = createCacheKey('getTokens', [\n      normalizedRegion,\n      action,\n      options?.provider,\n    ]);\n\n    const tokens = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call(\n          'RampsService:getTokens',\n          normalizedRegion,\n          action,\n          {\n            provider: options?.provider,\n          },\n        );\n      },\n      options,\n    );\n\n    this.update((state) => {\n      const userRegionCode = state.userRegion?.regionCode;\n\n      if (userRegionCode === undefined || userRegionCode === normalizedRegion) {\n        state.tokens = tokens;\n      }\n    });\n\n    return tokens;\n  }\n\n  /**\n   * Fetches the list of providers for a given region.\n   * The providers are saved in the controller state once fetched.\n   *\n   * @param region - The region code (e.g., \"us\", \"fr\", \"us-ny\"). If not provided, uses the user's region from controller state.\n   * @param options - Options for cache behavior and query filters.\n   * @param options.provider - Provider ID(s) to filter by.\n   * @param options.crypto - Crypto currency ID(s) to filter by.\n   * @param options.fiat - Fiat currency ID(s) to filter by.\n   * @param options.payments - Payment method ID(s) to filter by.\n   * @returns The providers response containing providers array.\n   */\n  async getProviders(\n    region?: string,\n    options?: ExecuteRequestOptions & {\n      provider?: string | string[];\n      crypto?: string | string[];\n      fiat?: string | string[];\n      payments?: string | string[];\n    },\n  ): Promise<{ providers: Provider[] }> {\n    const regionToUse = region ?? this.state.userRegion?.regionCode;\n\n    if (!regionToUse) {\n      throw new Error(\n        'Region is required. Either provide a region parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    const normalizedRegion = regionToUse.toLowerCase().trim();\n    const cacheKey = createCacheKey('getProviders', [\n      normalizedRegion,\n      options?.provider,\n      options?.crypto,\n      options?.fiat,\n      options?.payments,\n    ]);\n\n    const { providers } = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call(\n          'RampsService:getProviders',\n          normalizedRegion,\n          {\n            provider: options?.provider,\n            crypto: options?.crypto,\n            fiat: options?.fiat,\n            payments: options?.payments,\n          },\n        );\n      },\n      options,\n    );\n\n    this.update((state) => {\n      const userRegionCode = state.userRegion?.regionCode;\n\n      if (userRegionCode === undefined || userRegionCode === normalizedRegion) {\n        state.providers = providers;\n      }\n    });\n\n    return { providers };\n  }\n\n  /**\n   * Fetches the list of payment methods for a given context.\n   * The payment methods are saved in the controller state once fetched.\n   *\n   * @param options - Query parameters for filtering payment methods.\n   * @param options.region - User's region code. If not provided, uses the user's region from controller state.\n   * @param options.fiat - Fiat currency code (e.g., \"usd\"). If not provided, uses the user's region currency.\n   * @param options.assetId - CAIP-19 cryptocurrency identifier.\n   * @param options.provider - Provider ID path.\n   * @param options.forceRefresh - Whether to bypass cache.\n   * @param options.ttl - Custom TTL for this request.\n   * @returns The payment methods response containing payments array.\n   */\n  async getPaymentMethods(options: {\n    region?: string;\n    fiat?: string;\n    assetId: string;\n    provider: string;\n    forceRefresh?: boolean;\n    ttl?: number;\n  }): Promise<PaymentMethodsResponse> {\n    const regionToUse = options.region ?? this.state.userRegion?.regionCode;\n    const fiatToUse = options.fiat ?? this.state.userRegion?.country?.currency;\n\n    if (!regionToUse) {\n      throw new Error(\n        'Region is required. Either provide a region parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    if (!fiatToUse) {\n      throw new Error(\n        'Fiat currency is required. Either provide a fiat parameter or ensure userRegion is set in controller state.',\n      );\n    }\n\n    const normalizedRegion = regionToUse.toLowerCase().trim();\n    const normalizedFiat = fiatToUse.toLowerCase().trim();\n    const cacheKey = createCacheKey('getPaymentMethods', [\n      normalizedRegion,\n      normalizedFiat,\n      options.assetId,\n      options.provider,\n    ]);\n\n    const response = await this.executeRequest(\n      cacheKey,\n      async () => {\n        return this.messenger.call('RampsService:getPaymentMethods', {\n          region: normalizedRegion,\n          fiat: normalizedFiat,\n          assetId: options.assetId,\n          provider: options.provider,\n        });\n      },\n      { forceRefresh: options.forceRefresh, ttl: options.ttl },\n    );\n\n    this.update((state) => {\n      state.paymentMethods = response.payments;\n      // Only clear selected payment method if it's no longer in the new list\n      // This preserves the selection when cached data is returned (same context)\n      if (\n        state.selectedPaymentMethod &&\n        !response.payments.some(\n          (pm: PaymentMethod) => pm.id === state.selectedPaymentMethod?.id,\n        )\n      ) {\n        state.selectedPaymentMethod = null;\n      }\n    });\n\n    return response;\n  }\n\n  /**\n   * Sets the user's selected payment method.\n   *\n   * @param paymentMethod - The payment method to select, or null to clear.\n   */\n  setSelectedPaymentMethod(paymentMethod: PaymentMethod | null): void {\n    this.update((state) => {\n      state.selectedPaymentMethod = paymentMethod;\n    });\n  }\n\n  // ============================================================\n  // Sync Trigger Methods\n  // These fire-and-forget methods are for use in React effects.\n  // Errors are stored in state and available via selectors.\n  // ============================================================\n\n  /**\n   * Triggers setting the user region without throwing.\n   *\n   * @param region - The region code to set (e.g., \"US-CA\").\n   * @param options - Options for cache behavior.\n   */\n  triggerSetUserRegion(region: string, options?: ExecuteRequestOptions): void {\n    this.setUserRegion(region, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching countries without throwing.\n   *\n   * @param options - Options for cache behavior.\n   */\n  triggerGetCountries(options?: ExecuteRequestOptions): void {\n    this.getCountries(options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching tokens without throwing.\n   *\n   * @param region - The region code. If not provided, uses userRegion from state.\n   * @param action - The ramp action type ('buy' or 'sell').\n   * @param options - Options for cache behavior.\n   */\n  triggerGetTokens(\n    region?: string,\n    action: 'buy' | 'sell' = 'buy',\n    options?: ExecuteRequestOptions,\n  ): void {\n    this.getTokens(region, action, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching providers without throwing.\n   *\n   * @param region - The region code. If not provided, uses userRegion from state.\n   * @param options - Options for cache behavior and query filters.\n   */\n  triggerGetProviders(\n    region?: string,\n    options?: ExecuteRequestOptions & {\n      provider?: string | string[];\n      crypto?: string | string[];\n      fiat?: string | string[];\n      payments?: string | string[];\n    },\n  ): void {\n    this.getProviders(region, options).catch(() => {\n      // Error stored in state\n    });\n  }\n\n  /**\n   * Triggers fetching payment methods without throwing.\n   *\n   * @param options - Query parameters for filtering payment methods.\n   * @param options.region - User's region code. If not provided, uses userRegion from state.\n   * @param options.fiat - Fiat currency code. If not provided, uses userRegion currency.\n   * @param options.assetId - CAIP-19 cryptocurrency identifier.\n   * @param options.provider - Provider ID path.\n   * @param options.forceRefresh - Whether to bypass cache.\n   * @param options.ttl - Custom TTL for this request.\n   */\n  triggerGetPaymentMethods(options: {\n    region?: string;\n    fiat?: string;\n    assetId: string;\n    provider: string;\n    forceRefresh?: boolean;\n    ttl?: number;\n  }): void {\n    this.getPaymentMethods(options).catch(() => {\n      // Error stored in state\n    });\n  }\n}\n"]}