@metamask/ramps-controller 20.3.0 → 21.0.0

package/dist/RampsService.cjs

@@ -1,708 +0,0 @@
-"use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-var _RampsService_instances, _a, _RampsService_messenger, _RampsService_fetch, _RampsService_policy, _RampsService_environment, _RampsService_context, _RampsService_baseUrlOverride, _RampsService_clientIdentity, _RampsService_getBaseUrl, _RampsService_getRequestHeaders, _RampsService_addCommonParams, _RampsService_request, _RampsService_toProviderSegment;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RampsService = exports.getDefaultRedirectCallbackUrl = exports.RampsApiService = exports.RampsEnvironment = exports.serviceName = exports.RAMPS_SDK_VERSION = exports.RampsOrderStatus = void 0;
-const controller_utils_1 = require("@metamask/controller-utils");
-const package_json_1 = __importDefault(require("../package.json"));
-const client_identity_js_1 = require("./client-identity.cjs");
-// === ORDER TYPES ===
-/**
- * Possible statuses for a ramps order.
- */
-var RampsOrderStatus;
-(function (RampsOrderStatus) {
-    RampsOrderStatus["Unknown"] = "UNKNOWN";
-    RampsOrderStatus["Precreated"] = "PRECREATED";
-    RampsOrderStatus["Created"] = "CREATED";
-    RampsOrderStatus["Pending"] = "PENDING";
-    RampsOrderStatus["Failed"] = "FAILED";
-    RampsOrderStatus["Completed"] = "COMPLETED";
-    RampsOrderStatus["Cancelled"] = "CANCELLED";
-    RampsOrderStatus["IdExpired"] = "ID_EXPIRED";
-})(RampsOrderStatus || (exports.RampsOrderStatus = RampsOrderStatus = {}));
-/**
- * The SDK version to send with API requests. (backwards-compatibility)
- */
-exports.RAMPS_SDK_VERSION = '2.1.6';
-// === GENERAL ===
-/**
- * The name of the {@link RampsService}, used to namespace the
- * service's actions and events.
- */
-exports.serviceName = 'RampsService';
-/**
- * The environment to use for API requests.
- */
-var RampsEnvironment;
-(function (RampsEnvironment) {
-    RampsEnvironment["Production"] = "production";
-    RampsEnvironment["Staging"] = "staging";
-    RampsEnvironment["Development"] = "development";
-    RampsEnvironment["Local"] = "local";
-})(RampsEnvironment || (exports.RampsEnvironment = RampsEnvironment = {}));
-/**
- * The type of ramps API service.
- * Determines which base URL to use (cache vs standard).
- */
-var RampsApiService;
-(function (RampsApiService) {
-    RampsApiService["Regions"] = "regions";
-    RampsApiService["Orders"] = "orders";
-})(RampsApiService || (exports.RampsApiService = RampsApiService = {}));
-// === MESSENGER ===
-const MESSENGER_EXPOSED_METHODS = [
-    'getDefaultRedirectCallbackUrl',
-    'getGeolocation',
-    'getCountries',
-    'getTokens',
-    'getProviders',
-    'getPaymentMethods',
-    'getQuotes',
-    'getBuyWidgetUrl',
-    'getOrder',
-    'getOrderFromCallback',
-];
-// === SERVICE DEFINITION ===
-/**
- * Gets the base URL for API requests based on the environment and service type.
- * The Regions service uses a cache hostname in production and staging only;
- * development serves regions from the same `on-ramp.dev-api` host (no `-cache`).
- *
- * @param environment - The environment to use.
- * @param service - The API service type (determines if cache URL is used).
- * @returns The base URL for API requests.
- */
-function getBaseUrl(environment, service) {
-    const cache = service === RampsApiService.Regions &&
-        environment !== RampsEnvironment.Development
-        ? '-cache'
-        : '';
-    switch (environment) {
-        case RampsEnvironment.Production:
-            return `https://on-ramp${cache}.api.cx.metamask.io`;
-        case RampsEnvironment.Staging:
-            return `https://on-ramp${cache}.uat-api.cx.metamask.io`;
-        case RampsEnvironment.Development:
-            return `https://on-ramp${cache}.dev-api.cx.metamask.io`;
-        case RampsEnvironment.Local:
-            return 'http://localhost:3000';
-        default:
-            throw new Error(`Invalid environment: ${String(environment)}`);
-    }
-}
-/**
- * The path served by the ramps content host that redirects back into the
- * client once a non-native provider's widget flow completes.
- */
-const FAKE_CALLBACK_PATH = '/regions/fake-callback';
-/**
- * Derives the default redirect ("fake callback") URL for the widened Headless
- * Buy quote fetch from the ramps environment.
- *
- * The quotes API only embeds a `buyURL`/`buyWidget` (the WebView page a
- * non-native provider needs) when a `redirectUrl` is present, so the widened
- * aggregator path supplies this default when the caller omits one. Production
- * and staging serve the callback from the `on-ramp-content` CDN hosts;
- * development has no `on-ramp-content.dev-api` deployment, so it uses the
- * `on-ramp.dev-api` host (which serves `/regions/fake-callback` and returns
- * 200). This intentionally does not reuse {@link getBaseUrl}, whose Regions
- * host is `on-ramp{-cache}`, not `on-ramp-content`.
- *
- * This is the canonical environment-to-callback map for the whole package.
- * Prefer the `RampsService:getDefaultRedirectCallbackUrl` messenger action at
- * runtime so the value always follows the environment the service is actually
- * configured with. Call this function directly only where a synchronous,
- * messenger-free value is needed (for example client UI that matches the
- * callback URL in a WebView), and pass the same environment the service was
- * constructed with.
- *
- * @param environment - The environment to derive the callback URL for.
- * @returns The default redirect callback URL for that environment.
- */
-function getDefaultRedirectCallbackUrl(environment) {
-    switch (environment) {
-        case RampsEnvironment.Production:
-            return `https://on-ramp-content.api.cx.metamask.io${FAKE_CALLBACK_PATH}`;
-        case RampsEnvironment.Staging:
-            return `https://on-ramp-content.uat-api.cx.metamask.io${FAKE_CALLBACK_PATH}`;
-        case RampsEnvironment.Development:
-            return `https://on-ramp.dev-api.cx.metamask.io${FAKE_CALLBACK_PATH}`;
-        case RampsEnvironment.Local:
-            return `http://localhost:3000${FAKE_CALLBACK_PATH}`;
-        default:
-            throw new Error(`Invalid environment: ${String(environment)}`);
-    }
-}
-exports.getDefaultRedirectCallbackUrl = getDefaultRedirectCallbackUrl;
-/**
- * Constructs an API path with a version prefix.
- *
- * @param path - The API endpoint path.
- * @param version - The API version prefix. Defaults to 'v2'.
- * @returns The versioned API path.
- */
-function getApiPath(path, version = 'v2') {
-    return `${version}/${path}`;
-}
-/**
- * This service object is responsible for interacting with the Ramps API.
- *
- * @example
- *
- * ``` ts
- * import { Messenger } from '@metamask/messenger';
- * import type {
- *   RampsServiceActions,
- *   RampsServiceEvents,
- * } from '@metamask/ramps-controller';
- *
- * const rootMessenger = new Messenger<
- *   'Root',
- *   RampsServiceActions
- *   RampsServiceEvents
- * >({ namespace: 'Root' });
- * const rampsServiceMessenger = new Messenger<
- *   'RampsService',
- *   RampsServiceActions,
- *   RampsServiceEvents,
- *   typeof rootMessenger,
- * >({
- *   namespace: 'RampsService',
- *   parent: rootMessenger,
- * });
- * // Instantiate the service to register its actions on the messenger
- * new RampsService({
- *   messenger: rampsServiceMessenger,
- *   environment: RampsEnvironment.Production,
- *   context: 'mobile-ios',
- *   fetch,
- * });
- *
- * // Later...
- * // Get the user's geolocation
- * const geolocation = await rootMessenger.call(
- *   'RampsService:getGeolocation',
- * );
- * // ... Do something with the geolocation ...
- * ```
- */
-class RampsService {
-    /**
-     * Constructs a new RampsService object.
-     *
-     * @param args - The constructor arguments.
-     * @param args.messenger - The messenger suited for this service.
-     * @param args.environment - The environment to use for API requests.
-     * @param args.context - The context for API requests (e.g., 'mobile-ios', 'mobile-android').
-     * @param args.fetch - A function that can be used to make an HTTP request. If
-     * your JavaScript environment supports `fetch` natively, you'll probably want
-     * to pass that; otherwise you can pass an equivalent (such as `fetch` via
-     * `node-fetch`).
-     * @param args.policyOptions - Options to pass to `createServicePolicy`, which
-     * is used to wrap each request. See {@link CreateServicePolicyOptions}.
-     * @param args.baseUrlOverride - Optional base URL override for local development.
-     * @param args.clientProduct - Optional MetaMask product id (`metamask-mobile`).
-     * @param args.clientVersion - Optional app SemVer (not the ramps-controller package version).
-     */
-    constructor({ messenger, environment = RampsEnvironment.Staging, context, fetch: fetchFunction, policyOptions = {}, baseUrlOverride, clientProduct, clientVersion, }) {
-        _RampsService_instances.add(this);
-        /**
-         * The messenger suited for this service.
-         */
-        _RampsService_messenger.set(this, void 0);
-        /**
-         * A function that can be used to make an HTTP request.
-         */
-        _RampsService_fetch.set(this, void 0);
-        /**
-         * The policy that wraps the request.
-         *
-         * @see {@link createServicePolicy}
-         */
-        _RampsService_policy.set(this, void 0);
-        /**
-         * The environment used for API requests.
-         */
-        _RampsService_environment.set(this, void 0);
-        /**
-         * The context for API requests (e.g., 'mobile-ios', 'mobile-android').
-         */
-        _RampsService_context.set(this, void 0);
-        /**
-         * Optional base URL override for local development.
-         */
-        _RampsService_baseUrlOverride.set(this, void 0);
-        _RampsService_clientIdentity.set(this, void 0);
-        this.name = exports.serviceName;
-        __classPrivateFieldSet(this, _RampsService_messenger, messenger, "f");
-        __classPrivateFieldSet(this, _RampsService_fetch, fetchFunction, "f");
-        __classPrivateFieldSet(this, _RampsService_policy, (0, controller_utils_1.createServicePolicy)(policyOptions), "f");
-        __classPrivateFieldSet(this, _RampsService_environment, environment, "f");
-        __classPrivateFieldSet(this, _RampsService_context, context, "f");
-        __classPrivateFieldSet(this, _RampsService_baseUrlOverride, baseUrlOverride, "f");
-        __classPrivateFieldSet(this, _RampsService_clientIdentity, {
-            clientProduct,
-            clientVersion,
-        }, "f");
-        __classPrivateFieldGet(this, _RampsService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
-    }
-    /**
-     * Returns the default redirect ("fake callback") URL for this service's
-     * environment.
-     *
-     * The quotes API only embeds a `buyURL`/`buyWidget` (the WebView page a
-     * non-native provider needs) when a `redirectUrl` is present, so callers
-     * that omit one (MM Pay's widened Headless Buy fetch) use this value.
-     * Exposing it here makes the service's environment the single runtime source
-     * of truth, so the callback can never point at a different environment than
-     * the one the quotes themselves came from.
-     *
-     * `baseUrlOverride` deliberately does not apply. That option overrides the
-     * ramps API base URL for local development. In production and staging the
-     * callback lives on a different host (`on-ramp-content` versus
-     * `on-ramp{-cache}`), so an API override says nothing about where
-     * `/regions/fake-callback` lives. In development the callback already shares
-     * the API host family (`on-ramp.dev-api`). The redirect URL is also handed
-     * to the provider and matched by client UI to detect flow completion, so
-     * returning an unrelated local API origin here would break completion
-     * detection rather than help it. Point `environment` at
-     * {@link RampsEnvironment.Local} for a localhost callback, noting that URL
-     * is pinned to `http://localhost:3000` and does not follow a non-3000
-     * `baseUrlOverride`.
-     *
-     * @returns The default redirect callback URL for the configured environment.
-     */
-    getDefaultRedirectCallbackUrl() {
-        return getDefaultRedirectCallbackUrl(__classPrivateFieldGet(this, _RampsService_environment, "f"));
-    }
-    /**
-     * Registers a handler that will be called after a request returns a non-500
-     * response, causing a retry. Primarily useful in tests where timers are being
-     * mocked.
-     *
-     * @param listener - The handler to be called.
-     * @returns An object that can be used to unregister the handler. See
-     * {@link CockatielEvent}.
-     * @see {@link createServicePolicy}
-     */
-    onRetry(listener) {
-        return __classPrivateFieldGet(this, _RampsService_policy, "f").onRetry(listener);
-    }
-    /**
-     * Registers a handler that will be called after a set number of retry rounds
-     * prove that requests to the API endpoint consistently return a 5xx response.
-     *
-     * @param listener - The handler to be called.
-     * @returns An object that can be used to unregister the handler. See
-     * {@link CockatielEvent}.
-     * @see {@link createServicePolicy}
-     */
-    onBreak(listener) {
-        return __classPrivateFieldGet(this, _RampsService_policy, "f").onBreak(listener);
-    }
-    /**
-     * Registers a handler that will be called under one of two circumstances:
-     *
-     * 1. After a set number of retries prove that requests to the API
-     * consistently result in one of the following failures:
-     *    1. A connection initiation error
-     *    2. A connection reset error
-     *    3. A timeout error
-     *    4. A non-JSON response
-     *    5. A 502, 503, or 504 response
-     * 2. After a successful request is made to the API, but the response takes
-     * longer than a set duration to return.
-     *
-     * @param listener - The handler to be called.
-     * @returns An object that can be used to unregister the handler. See
-     * {@link CockatielEvent}.
-     */
-    onDegraded(listener) {
-        return __classPrivateFieldGet(this, _RampsService_policy, "f").onDegraded(listener);
-    }
-    /**
-     * Makes a request to the API in order to retrieve the user's geolocation
-     * based on their IP address.
-     *
-     * @returns The user's country/region code (e.g., "US-UT" for Utah, USA).
-     */
-    async getGeolocation() {
-        const textResponse = await __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_request).call(this, RampsApiService.Orders, 'geolocation', { responseType: 'text' });
-        const trimmedResponse = textResponse.trim();
-        if (trimmedResponse.length > 0) {
-            return trimmedResponse;
-        }
-        throw new Error('Malformed response received from geolocation API');
-    }
-    /**
-     * Makes a request to the cached API to retrieve the list of supported countries.
-     * The API returns countries with support information for both buy and sell actions.
-     * Filters countries based on aggregator support (preserves OnRampSDK logic).
-     *
-     * @returns An array of countries filtered by aggregator support.
-     */
-    async getCountries() {
-        const countries = await __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_request).call(this, RampsApiService.Regions, getApiPath('regions/countries'), { responseType: 'json' });
-        if (!Array.isArray(countries)) {
-            throw new Error('Malformed response received from countries API');
-        }
-        return countries.filter((country) => {
-            const isCountrySupported = country.supported.buy || country.supported.sell;
-            if (country.states && country.states.length > 0) {
-                const hasSupportedState = country.states.some(
-                // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentionally using || to treat false as unsupported
-                (state) => state.supported?.buy || state.supported?.sell);
-                return isCountrySupported || hasSupportedState;
-            }
-            return isCountrySupported;
-        });
-    }
-    /**
-     * Fetches the list of available tokens for a given region and action.
-     * Supports optional provider filter.
-     *
-     * @param region - The region code (e.g., "us", "fr", "us-ny").
-     * @param action - The ramp action type ('buy' or 'sell').
-     * @param options - Optional query parameters for filtering tokens.
-     * @param options.provider - Provider ID(s) to filter by.
-     * @returns The tokens response containing topTokens and allTokens.
-     */
-    async getTokens(region, action = 'buy', options) {
-        const normalizedRegion = region.toLowerCase().trim();
-        const url = new URL(getApiPath(`regions/${normalizedRegion}/topTokens`), __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getBaseUrl).call(this, RampsApiService.Regions));
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url, action);
-        if (options?.provider) {
-            const providerIds = Array.isArray(options.provider)
-                ? options.provider
-                : [options.provider];
-            providerIds.forEach((id) => url.searchParams.append('provider', id));
-        }
-        const response = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url);
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${url.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        if (!response || typeof response !== 'object') {
-            throw new Error('Malformed response received from tokens API');
-        }
-        if (!Array.isArray(response.topTokens) ||
-            !Array.isArray(response.allTokens)) {
-            throw new Error('Malformed response received from tokens API');
-        }
-        return response;
-    }
-    /**
-     * Fetches the list of providers for a given region.
-     * Supports optional query filters: provider, crypto, payments.
-     * Region local fiat filtering is applied server-side when `fiat` is omitted.
-     *
-     * @param regionCode - The region code (e.g., "us", "fr", "us-ny").
-     * @param options - Optional query parameters for filtering providers.
-     * @param options.provider - Provider ID(s) to filter by.
-     * @param options.crypto - Crypto currency ID(s) to filter by.
-     * @param options.payments - Payment method ID(s) to filter by.
-     * @returns The providers response containing providers array.
-     */
-    async getProviders(regionCode, options) {
-        const normalizedRegion = regionCode.toLowerCase().trim();
-        const url = new URL(getApiPath(`regions/${normalizedRegion}/providers`), __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getBaseUrl).call(this, RampsApiService.Regions));
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url);
-        if (options?.provider) {
-            const providerIds = Array.isArray(options.provider)
-                ? options.provider
-                : [options.provider];
-            providerIds.forEach((id) => url.searchParams.append('provider', id));
-        }
-        if (options?.crypto) {
-            const cryptoIds = Array.isArray(options.crypto)
-                ? options.crypto
-                : [options.crypto];
-            cryptoIds.forEach((id) => url.searchParams.append('crypto', id));
-        }
-        if (options?.payments) {
-            const paymentIds = Array.isArray(options.payments)
-                ? options.payments
-                : [options.payments];
-            paymentIds.forEach((id) => url.searchParams.append('payments', id));
-        }
-        const response = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url);
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${url.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        if (!response || typeof response !== 'object') {
-            throw new Error('Malformed response received from providers API');
-        }
-        if (!Array.isArray(response.providers)) {
-            throw new Error('Malformed response received from providers API');
-        }
-        return {
-            providers: response.providers,
-            sorted: Array.isArray(response.sorted) ? response.sorted : [],
-        };
-    }
-    /**
-     * Fetches the list of payment methods for a given region, asset, and provider.
-     *
-     * Region local fiat filtering is applied server-side when `fiat` is omitted.
-     *
-     * @param options - Query parameters for filtering payment methods.
-     * @param options.region - User's region code (e.g., "us-al").
-     * @param options.assetId - CAIP-19 cryptocurrency identifier.
-     * @param options.provider - Provider ID path.
-     * @returns The payment methods response containing payments array.
-     */
-    async getPaymentMethods(options) {
-        const normalizedRegion = options.region.toLowerCase().trim();
-        const url = new URL(getApiPath(`regions/${normalizedRegion}/payments`), __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getBaseUrl).call(this, RampsApiService.Regions));
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url);
-        url.searchParams.set('region', options.region.toLowerCase().trim());
-        url.searchParams.set('crypto', options.assetId);
-        url.searchParams.set('provider', options.provider);
-        const response = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url);
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${url.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        if (!response || typeof response !== 'object') {
-            throw new Error('Malformed response received from paymentMethods API');
-        }
-        if (!Array.isArray(response.payments)) {
-            throw new Error('Malformed response received from paymentMethods API');
-        }
-        return response;
-    }
-    /**
-     * Fetches quotes from all providers for a given set of parameters.
-     * Uses the V2 orders API to get quotes for multiple payment methods at once.
-     *
-     * @param params - The parameters for fetching quotes.
-     * @param params.region - User's region code (e.g., "us", "us-ca").
-     * @param params.paymentMethods - Array of payment method IDs.
-     * @param params.assetId - CAIP-19 cryptocurrency identifier.
-     * @param params.fiat - Fiat currency code (e.g., "usd").
-     * @param params.amount - The amount (in fiat for buy, crypto for sell).
-     * @param params.walletAddress - The destination wallet address.
-     * @param params.redirectUrl - Optional redirect URL after order completion.
-     * @param params.providers - Optional provider IDs to filter quotes.
-     * @param params.action - The ramp action type. Defaults to 'buy'.
-     * @returns The quotes response containing success, sorted, error, and customActions.
-     */
-    async getQuotes(params) {
-        const normalizedRegion = params.region.toLowerCase().trim();
-        const normalizedFiat = params.fiat.toLowerCase().trim();
-        const action = params.action ?? 'buy';
-        const url = new URL(getApiPath('quotes'), getBaseUrl(__classPrivateFieldGet(this, _RampsService_environment, "f"), RampsApiService.Orders));
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url, action);
-        // Build region ID in the format expected by the API
-        url.searchParams.set('region', normalizedRegion);
-        url.searchParams.set('fiat', normalizedFiat);
-        url.searchParams.set('crypto', params.assetId);
-        url.searchParams.set('amount', String(params.amount));
-        url.searchParams.set('walletAddress', params.walletAddress);
-        const headers = await __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getRequestHeaders).call(this);
-        // Add payment methods as array parameters
-        params.paymentMethods.forEach((paymentMethod) => {
-            url.searchParams.append('payments', paymentMethod);
-        });
-        // Add provider filter if specified
-        params.providers?.forEach((provider) => {
-            url.searchParams.append('providers', provider);
-        });
-        // Add redirect URL if specified
-        if (params.redirectUrl) {
-            url.searchParams.set('redirectUrl', params.redirectUrl);
-        }
-        const response = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url, { headers });
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${url.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        if (!response || typeof response !== 'object') {
-            throw new Error('Malformed response received from quotes API');
-        }
-        if (!Array.isArray(response.success) ||
-            !Array.isArray(response.sorted) ||
-            !Array.isArray(response.error) ||
-            !Array.isArray(response.customActions)) {
-            throw new Error('Malformed response received from quotes API');
-        }
-        return response;
-    }
-    /**
-     * Fetches the buy widget data from a buy URL endpoint.
-     * Makes a request to the buyURL (as provided in a quote) to get the actual
-     * provider widget URL, browser type, and order ID.
-     *
-     * @param buyUrl - The full buy URL endpoint to fetch from.
-     * @returns The buy widget data containing the provider widget URL.
-     */
-    async getBuyWidgetUrl(buyUrl) {
-        const url = new URL(buyUrl);
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url);
-        const headers = await __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getRequestHeaders).call(this);
-        const response = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url, { headers });
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${url.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        if (!response || typeof response !== 'object' || !response.url) {
-            throw new Error('Malformed response received from buy widget URL API');
-        }
-        return response;
-    }
-    /**
-     * Fetches an order from the unified V2 API endpoint.
-     * This endpoint returns a normalized `RampsOrder` (DepositOrder shape)
-     * for all provider types, including both aggregator and native providers.
-     *
-     * @param providerCode - The provider code (e.g., "transak", "transak-native", "moonpay"),
-     *   with or without the `/providers/` prefix.
-     * @param orderCode - The order identifier.
-     * @param wallet - The wallet address associated with the order.
-     * @returns The unified order data.
-     */
-    async getOrder(providerCode, orderCode, wallet) {
-        const segment = __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_toProviderSegment).call(this, providerCode);
-        const url = new URL(getApiPath(`providers/${segment}/orders/${orderCode}`), __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getBaseUrl).call(this, RampsApiService.Orders));
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url);
-        if (wallet) {
-            url.searchParams.set('wallet', wallet);
-        }
-        const response = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url);
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${url.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        if (!response || typeof response !== 'object') {
-            throw new Error('Malformed response received from order API');
-        }
-        return response;
-    }
-    /**
-     * Extracts an order from a provider callback URL.
-     * Sends the callback URL to the V2 API backend, which knows how to parse
-     * each provider's callback format and extract the order ID. Then fetches
-     * the full order using that ID.
-     *
-     * This is the V2 equivalent of the aggregator SDK's `getOrderFromCallback`.
-     *
-     * @param providerCode - The provider code (e.g., "transak", "moonpay"),
-     *   with or without the `/providers/` prefix.
-     * @param callbackUrl - The full callback URL the provider redirected to.
-     * @param wallet - The wallet address associated with the order.
-     * @returns The unified order data.
-     */
-    async getOrderFromCallback(providerCode, callbackUrl, wallet) {
-        const segment = __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_toProviderSegment).call(this, providerCode);
-        // Step 1: Send the callback URL to the backend to extract the order ID.
-        // The backend parses it using provider-specific logic.
-        const callbackApiUrl = new URL(getApiPath(`providers/${segment}/callback`), __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getBaseUrl).call(this, RampsApiService.Orders));
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, callbackApiUrl);
-        callbackApiUrl.searchParams.set('url', callbackUrl);
-        const callbackResponse = await __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-            const fetchResponse = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, callbackApiUrl);
-            if (!fetchResponse.ok) {
-                throw new controller_utils_1.HttpError(fetchResponse.status, `Fetching '${callbackApiUrl.toString()}' failed with status '${fetchResponse.status}'`);
-            }
-            return fetchResponse.json();
-        });
-        const rawOrderId = callbackResponse?.id;
-        if (!rawOrderId) {
-            throw new Error('Could not extract order ID from callback URL via provider');
-        }
-        // The callback response id may be a full resource path like
-        // "/providers/transak-staging/orders/3ec2e8ac-...".
-        // Extract just the order code (last segment) so getOrder doesn't
-        // build a doubled path.
-        const lastSlash = rawOrderId.lastIndexOf('/');
-        const orderCode = lastSlash >= 0 ? rawOrderId.slice(lastSlash + 1) : rawOrderId;
-        // Step 2: Fetch the full order using the extracted order code.
-        return this.getOrder(providerCode, orderCode, wallet);
-    }
-}
-exports.RampsService = RampsService;
-_a = RampsService, _RampsService_messenger = new WeakMap(), _RampsService_fetch = new WeakMap(), _RampsService_policy = new WeakMap(), _RampsService_environment = new WeakMap(), _RampsService_context = new WeakMap(), _RampsService_baseUrlOverride = new WeakMap(), _RampsService_clientIdentity = new WeakMap(), _RampsService_instances = new WeakSet(), _RampsService_getBaseUrl = function _RampsService_getBaseUrl(service) {
-    if (__classPrivateFieldGet(this, _RampsService_baseUrlOverride, "f")) {
-        return __classPrivateFieldGet(this, _RampsService_baseUrlOverride, "f");
-    }
-    return getBaseUrl(__classPrivateFieldGet(this, _RampsService_environment, "f"), service);
-}, _RampsService_getRequestHeaders = 
-/**
- * Builds the request headers for authenticated ramps API calls.
- *
- * Fetches a bearer token from `AuthenticationController` and returns it as
- * an `Authorization` header. Throws if the token is unavailable (e.g. the
- * wallet is locked or the user is signed out).
- *
- * @returns Headers containing the `Authorization: Bearer <token>` entry.
- */
-async function _RampsService_getRequestHeaders() {
-    const bearerToken = await __classPrivateFieldGet(this, _RampsService_messenger, "f").call('AuthenticationController:getBearerToken');
-    return {
-        Authorization: `Bearer ${bearerToken}`,
-    };
-}, _RampsService_addCommonParams = function _RampsService_addCommonParams(url, action) {
-    if (action) {
-        url.searchParams.set('action', action);
-    }
-    url.searchParams.set('sdk', exports.RAMPS_SDK_VERSION);
-    url.searchParams.set('controller', package_json_1.default.version);
-    url.searchParams.set('context', __classPrivateFieldGet(this, _RampsService_context, "f"));
-    // In the query string (not headers) so CDN-cached responses vary per
-    // client product / version.
-    (0, client_identity_js_1.addRampsClientIdentityParams)(url, __classPrivateFieldGet(this, _RampsService_clientIdentity, "f"));
-}, _RampsService_request = 
-/**
- * Makes an API request with retry policy and error handling.
- *
- * @param service - The API service type (determines base URL).
- * @param path - The endpoint path.
- * @param options - Request options.
- * @param options.action - The ramp action type (optional).
- * @param options.responseType - How to parse the response ('json' or 'text').
- * @returns The parsed response data.
- */
-async function _RampsService_request(service, path, options) {
-    return __classPrivateFieldGet(this, _RampsService_policy, "f").execute(async () => {
-        const baseUrl = __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_getBaseUrl).call(this, service);
-        const url = new URL(path, baseUrl);
-        __classPrivateFieldGet(this, _RampsService_instances, "m", _RampsService_addCommonParams).call(this, url, options.action);
-        const response = await __classPrivateFieldGet(this, _RampsService_fetch, "f").call(this, url);
-        if (!response.ok) {
-            throw new controller_utils_1.HttpError(response.status, `Fetching '${url.toString()}' failed with status '${response.status}'`);
-        }
-        return options.responseType === 'json'
-            ? response.json()
-            : response.text();
-    });
-}, _RampsService_toProviderSegment = function _RampsService_toProviderSegment(providerId) {
-    return providerId.replace(/^\/providers\//u, '');
-};
-//# sourceMappingURL=RampsService.cjs.map