@metamask/ramps-controller 20.2.0 → 20.3.0

package/dist/NeoBankService.d.mts

@@ -0,0 +1,191 @@
+import type { CreateServicePolicyOptions, ServicePolicy } from "@metamask/controller-utils";
+import type { Messenger } from "@metamask/messenger";
+import type { AuthenticationController } from "@metamask/profile-sync-controller";
+import type { AutorampRemoteSnapshot } from "./autoramp-types.mjs";
+import type { NeoBankServiceMethodActions } from "./NeoBankService-method-action-types.mjs";
+import { RampsEnvironment } from "./RampsService.mjs";
+import type { RegistrationOutcome, RegistrationStatus } from "./wallet-registration-service.mjs";
+/**
+ * Name of the NeoBankService messenger namespace.
+ */
+export declare const serviceName = "NeoBankService";
+/**
+ * Raw autoramp payload from the MetaMask Ramp API neo-bank proxy.
+ * Shape mirrors MoonPay Enterprise `GET /api/autoramps/{autoramp_id}`.
+ * The Ramp API handles partner auth / headers; the client only sends the
+ * MetaMask bearer token.
+ */
+export type NeoBankAutorampResponse = {
+    id: string;
+    customer_id?: string;
+    status: string;
+    /**
+     * Destination wallet when present on the proxy response.
+     * Field name may evolve with the Ramp API contract.
+     */
+    wallet_address?: string;
+    recipient_account?: {
+        address?: string;
+    };
+    deposit_rails?: unknown[];
+};
+/**
+ * Optional headers for neo-bank mutating requests.
+ */
+export type NeoBankRequestOptions = {
+    /**
+     * Forwarded as `Idempotency-Key` when set (MoonPay requires it on some POSTs;
+     * neobank-proxy generates one when omitted).
+     */
+    idempotencyKey?: string;
+};
+/**
+ * Query string values accepted by neo-bank GET helpers.
+ */
+export type NeoBankQueryParams = Record<string, string | number | boolean | undefined | null>;
+export type GetWalletRegistrationStatusParams = {
+    customerId: string;
+    address: string;
+};
+export type RegisterSelfHostedWalletParams = {
+    customerId: string;
+    address: string;
+    message: string;
+    signature: string;
+    /**
+     * Forwarded as `Idempotency-Key` on the neobank-proxy POST. Prefer a stable
+     * key across retries of the same ownership body.
+     */
+    idempotencyKey?: string;
+};
+/**
+ * Actions that {@link NeoBankService} exposes to other consumers.
+ */
+export type NeoBankServiceActions = NeoBankServiceMethodActions;
+type AllowedActions = AuthenticationController.AuthenticationControllerGetBearerTokenAction | AuthenticationController.AuthenticationControllerGetSessionProfileAction;
+export type NeoBankServiceEvents = never;
+type AllowedEvents = never;
+/**
+ * The messenger restricted to actions and events accessed by
+ * {@link NeoBankService}.
+ */
+export type NeoBankServiceMessenger = Messenger<typeof serviceName, NeoBankServiceActions | AllowedActions, NeoBankServiceEvents | AllowedEvents>;
+/**
+ * Maps a Ramp API / MoonPay-shaped autoramp response into the local remote snapshot.
+ *
+ * @param response - Proxy response body.
+ * @returns Snapshot for the controller last-seen cursor.
+ */
+export declare function mapNeoBankAutorampToRemoteSnapshot(response: NeoBankAutorampResponse): AutorampRemoteSnapshot;
+/**
+ * Client for MetaMask Ramp API neo-bank endpoints (MoonPay Enterprise proxy).
+ *
+ * Lives alongside {@link RampsService} and {@link TransakService}. Authentication
+ * and MoonPay partner headers are handled by the Ramp API; this service only
+ * attaches the MetaMask user bearer token.
+ *
+ * Paths use the neobank-proxy `/neobank` prefix on the on-ramp.api host.
+ */
+export declare class NeoBankService {
+    #private;
+    readonly name: typeof serviceName;
+    constructor({ messenger, environment, context, fetch: fetchFunction, policyOptions, baseUrlOverride, }: {
+        messenger: NeoBankServiceMessenger;
+        environment?: RampsEnvironment;
+        context: string;
+        fetch: typeof fetch;
+        policyOptions?: CreateServicePolicyOptions;
+        baseUrlOverride?: string;
+    });
+    /**
+     * Fetches an autoramp account via neobank-proxy
+     * `GET /neobank/autoramps/{autoramp_id}` (MoonPay
+     * `GET /api/autoramps/{autoramp_id}`).
+     *
+     * @param autorampId - MoonPay / Ramp API autoramp id.
+     * @returns Remote snapshot for controller apply/refresh.
+     */
+    getAutoramp(autorampId: string): Promise<AutorampRemoteSnapshot>;
+    /**
+     * Registers a Pix address via neobank-proxy `POST /neobank/addresses/pix`.
+     * Body is forwarded as opaque JSON (MoonPay address schema).
+     *
+     * @param body - Pix address registration payload.
+     * @param options - Optional idempotency key.
+     * @returns Parsed proxy JSON response.
+     */
+    registerPixAddress(body: Record<string, unknown>, options?: NeoBankRequestOptions): Promise<unknown>;
+    /**
+     * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.
+     *
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    getAutorampQuote(query?: NeoBankQueryParams): Promise<unknown>;
+    /**
+     * Creates an autoramp from a signed quote via neobank-proxy
+     * `POST /neobank/autoramps` (MoonPay `POST /api/autoramps`).
+     *
+     * @param body - CreateAutoramp / signed-quote payload (forwarded as-is).
+     * @param options - Optional idempotency key.
+     * @returns Remote snapshot for controller apply/refresh.
+     */
+    createAutoramp(body: Record<string, unknown>, options?: NeoBankRequestOptions): Promise<AutorampRemoteSnapshot>;
+    /**
+     * Fetches a quote for an existing autoramp via neobank-proxy
+     * `GET /neobank/autoramps/{autoramp_id}/quote`.
+     *
+     * @param autorampId - Autoramp id.
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    getAutorampQuoteForAutoramp(autorampId: string, query?: NeoBankQueryParams): Promise<unknown>;
+    /**
+     * Attaches a signed quote to an autoramp via neobank-proxy
+     * `POST /neobank/autoramps/{autoramp_id}/quotes`.
+     *
+     * @param autorampId - Autoramp id.
+     * @param body - Quote attachment payload (forwarded as-is).
+     * @param options - Optional idempotency key.
+     * @returns Parsed proxy JSON response.
+     */
+    attachAutorampQuote(autorampId: string, body: Record<string, unknown>, options?: NeoBankRequestOptions): Promise<unknown>;
+    /**
+     * Fetches a customer by partner external id via neobank-proxy
+     * `GET /neobank/customers/{external_id}/external`.
+     *
+     * @param externalId - Partner-assigned external customer id.
+     * @returns Parsed proxy JSON response.
+     */
+    getCustomerByExternalId(externalId: string): Promise<unknown>;
+    /**
+     * Resolves Iron's internal customer id via neobank-proxy customer lookup,
+     * using the MetaMask canonical profile id as the partner `external_id`.
+     *
+     * @returns Iron's internal customer id.
+     */
+    getMoonpayCustomerId(): Promise<string>;
+    /**
+     * Checks whether a Monad Money Account address is already registered for the
+     * given Iron customer.
+     *
+     * @param params - Customer id and address to check.
+     * @param params.customerId - Iron / MoonPay customer UUID.
+     * @param params.address - Money Account address.
+     * @returns Active, disabled, or absent registration status.
+     */
+    getWalletRegistrationStatus({ customerId, address, }: GetWalletRegistrationStatusParams): Promise<RegistrationStatus>;
+    /**
+     * Submits a signed Monad Money Account ownership proof via neobank-proxy
+     * `POST /neobank/addresses/crypto/selfhosted`.
+     *
+     * @param params - Signed ownership proof.
+     * @returns Registered wallet record.
+     */
+    registerSelfHostedWallet(params: RegisterSelfHostedWalletParams): Promise<RegistrationOutcome>;
+    onRetry(listener: Parameters<ServicePolicy['onRetry']>[0]): ReturnType<ServicePolicy['onRetry']>;
+    onBreak(listener: Parameters<ServicePolicy['onBreak']>[0]): ReturnType<ServicePolicy['onBreak']>;
+    onDegraded(listener: Parameters<ServicePolicy['onDegraded']>[0]): ReturnType<ServicePolicy['onDegraded']>;
+}
+export {};
+//# sourceMappingURL=NeoBankService.d.mts.map

package/dist/NeoBankService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeoBankService.d.mts","sourceRoot":"","sources":["../src/NeoBankService.ts"],"names":[],"mappings":"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"}

package/dist/NeoBankService.mjs

@@ -0,0 +1,379 @@
+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 _NeoBankService_instances, _NeoBankService_messenger, _NeoBankService_fetch, _NeoBankService_policy, _NeoBankService_noRetryPolicy, _NeoBankService_environment, _NeoBankService_context, _NeoBankService_baseUrlOverride, _NeoBankService_walletRegistrationService, _NeoBankService_getBaseUrl, _NeoBankService_getWalletRegistrationService, _NeoBankService_getRequestHeaders, _NeoBankService_buildUrl, _NeoBankService_throwHttpError, _NeoBankService_getJson, _NeoBankService_postJson, _NeoBankService_mapAutorampResponse, _NeoBankService_getCanonicalExternalId;
+import { createServicePolicy, handleWhen, HttpError } from "@metamask/controller-utils";
+import packageJson from "../package.json" with { type: "json" };
+import { RAMPS_SDK_VERSION, RampsEnvironment } from "./RampsService.mjs";
+import { WalletRegistrationService } from "./wallet-registration-service.mjs";
+/**
+ * Name of the NeoBankService messenger namespace.
+ */
+export const serviceName = 'NeoBankService';
+/**
+ * Determines whether a failed neo-bank request is worth re-issuing.
+ *
+ * 4xx responses describe the request or the account's state (e.g. 403
+ * "Customer is not active", 422 validation), so repeating them only multiplies
+ * the same rejection. 429 stays retryable alongside 5xx and non-HTTP
+ * network/timeout errors.
+ *
+ * @param error - Error thrown while performing the request.
+ * @returns `true` when the error is worth retrying.
+ */
+function isRetryableError(error) {
+    if (error instanceof HttpError) {
+        if (error.httpStatus === 429) {
+            return true;
+        }
+        return error.httpStatus < 400 || error.httpStatus >= 500;
+    }
+    return true;
+}
+const MESSENGER_EXPOSED_METHODS = [
+    'getAutoramp',
+    'registerPixAddress',
+    'getAutorampQuote',
+    'createAutoramp',
+    'getAutorampQuoteForAutoramp',
+    'attachAutorampQuote',
+    'getCustomerByExternalId',
+    'getMoonpayCustomerId',
+    'getWalletRegistrationStatus',
+    'registerSelfHostedWallet',
+];
+/**
+ * Builds a path under the neobank-proxy global prefix.
+ *
+ * Live neobank-proxy (#1124) mounts routes at `/neobank` on the on-ramp.api
+ * host (ALB path routing, no rewrite). Prefer this over `/api/v2/...` so Core
+ * matches the proxy that ships.
+ *
+ * @param path - Path under `/neobank` (no leading slash).
+ * @returns Absolute path segment for URL join against the Ramp API host.
+ */
+function getNeoBankPath(path) {
+    return `neobank/${path.replace(/^\//u, '')}`;
+}
+/**
+ * Resolves the Ramp API host for neo-bank calls (same hosts as {@link RampsService}).
+ *
+ * @param environment - Ramp environment.
+ * @returns Base URL.
+ */
+function getBaseUrl(environment) {
+    switch (environment) {
+        case RampsEnvironment.Production:
+            return 'https://on-ramp.api.cx.metamask.io';
+        case RampsEnvironment.Staging:
+            return 'https://on-ramp.uat-api.cx.metamask.io';
+        case RampsEnvironment.Development:
+            return 'https://on-ramp.dev-api.cx.metamask.io';
+        case RampsEnvironment.Local:
+            return 'http://localhost:3000';
+        default:
+            throw new Error(`Invalid environment: ${String(environment)}`);
+    }
+}
+/**
+ * Maps a Ramp API / MoonPay-shaped autoramp response into the local remote snapshot.
+ *
+ * @param response - Proxy response body.
+ * @returns Snapshot for the controller last-seen cursor.
+ */
+export function mapNeoBankAutorampToRemoteSnapshot(response) {
+    const depositRails = response.deposit_rails;
+    const hasDepositRails = Array.isArray(depositRails) && depositRails.length > 0;
+    const depositRailsSummary = hasDepositRails || response.status === 'Approved'
+        ? {
+            ready: response.status === 'Approved' && hasDepositRails,
+        }
+        : undefined;
+    return {
+        id: response.id,
+        customerId: response.customer_id,
+        walletAddress: response.wallet_address !== undefined &&
+            response.wallet_address.length > 0
+            ? response.wallet_address
+            : response.recipient_account?.address,
+        status: response.status,
+        depositRailsSummary,
+    };
+}
+/**
+ * Client for MetaMask Ramp API neo-bank endpoints (MoonPay Enterprise proxy).
+ *
+ * Lives alongside {@link RampsService} and {@link TransakService}. Authentication
+ * and MoonPay partner headers are handled by the Ramp API; this service only
+ * attaches the MetaMask user bearer token.
+ *
+ * Paths use the neobank-proxy `/neobank` prefix on the on-ramp.api host.
+ */
+export class NeoBankService {
+    constructor({ messenger, environment = RampsEnvironment.Staging, context, fetch: fetchFunction, policyOptions = {}, baseUrlOverride, }) {
+        _NeoBankService_instances.add(this);
+        _NeoBankService_messenger.set(this, void 0);
+        _NeoBankService_fetch.set(this, void 0);
+        _NeoBankService_policy.set(this, void 0);
+        _NeoBankService_noRetryPolicy.set(this, void 0);
+        _NeoBankService_environment.set(this, void 0);
+        _NeoBankService_context.set(this, void 0);
+        _NeoBankService_baseUrlOverride.set(this, void 0);
+        _NeoBankService_walletRegistrationService.set(this, void 0);
+        this.name = serviceName;
+        __classPrivateFieldSet(this, _NeoBankService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _NeoBankService_fetch, fetchFunction, "f");
+        __classPrivateFieldSet(this, _NeoBankService_policy, createServicePolicy({
+            retryFilterPolicy: handleWhen(isRetryableError),
+            ...policyOptions,
+        }), "f");
+        __classPrivateFieldSet(this, _NeoBankService_noRetryPolicy, createServicePolicy({
+            retryFilterPolicy: handleWhen(isRetryableError),
+            ...policyOptions,
+            maxRetries: 0,
+        }), "f");
+        __classPrivateFieldSet(this, _NeoBankService_environment, environment, "f");
+        __classPrivateFieldSet(this, _NeoBankService_context, context, "f");
+        __classPrivateFieldSet(this, _NeoBankService_baseUrlOverride, baseUrlOverride, "f");
+        __classPrivateFieldGet(this, _NeoBankService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Fetches an autoramp account via neobank-proxy
+     * `GET /neobank/autoramps/{autoramp_id}` (MoonPay
+     * `GET /api/autoramps/{autoramp_id}`).
+     *
+     * @param autorampId - MoonPay / Ramp API autoramp id.
+     * @returns Remote snapshot for controller apply/refresh.
+     */
+    async getAutoramp(autorampId) {
+        const response = await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getJson).call(this, `autoramps/${encodeURIComponent(autorampId)}`);
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_mapAutorampResponse).call(this, response);
+    }
+    /**
+     * Registers a Pix address via neobank-proxy `POST /neobank/addresses/pix`.
+     * Body is forwarded as opaque JSON (MoonPay address schema).
+     *
+     * @param body - Pix address registration payload.
+     * @param options - Optional idempotency key.
+     * @returns Parsed proxy JSON response.
+     */
+    async registerPixAddress(body, options = {}) {
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_postJson).call(this, 'addresses/pix', body, options);
+    }
+    /**
+     * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.
+     *
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    async getAutorampQuote(query = {}) {
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getJson).call(this, 'autoramps/quote', query);
+    }
+    /**
+     * Creates an autoramp from a signed quote via neobank-proxy
+     * `POST /neobank/autoramps` (MoonPay `POST /api/autoramps`).
+     *
+     * @param body - CreateAutoramp / signed-quote payload (forwarded as-is).
+     * @param options - Optional idempotency key.
+     * @returns Remote snapshot for controller apply/refresh.
+     */
+    async createAutoramp(body, options = {}) {
+        const response = await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_postJson).call(this, 'autoramps', body, options);
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_mapAutorampResponse).call(this, response);
+    }
+    /**
+     * Fetches a quote for an existing autoramp via neobank-proxy
+     * `GET /neobank/autoramps/{autoramp_id}/quote`.
+     *
+     * @param autorampId - Autoramp id.
+     * @param query - Quote query params (forwarded as-is).
+     * @returns Parsed proxy JSON response.
+     */
+    async getAutorampQuoteForAutoramp(autorampId, query = {}) {
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getJson).call(this, `autoramps/${encodeURIComponent(autorampId)}/quote`, query);
+    }
+    /**
+     * Attaches a signed quote to an autoramp via neobank-proxy
+     * `POST /neobank/autoramps/{autoramp_id}/quotes`.
+     *
+     * @param autorampId - Autoramp id.
+     * @param body - Quote attachment payload (forwarded as-is).
+     * @param options - Optional idempotency key.
+     * @returns Parsed proxy JSON response.
+     */
+    async attachAutorampQuote(autorampId, body, options = {}) {
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_postJson).call(this, `autoramps/${encodeURIComponent(autorampId)}/quotes`, body, options);
+    }
+    /**
+     * Fetches a customer by partner external id via neobank-proxy
+     * `GET /neobank/customers/{external_id}/external`.
+     *
+     * @param externalId - Partner-assigned external customer id.
+     * @returns Parsed proxy JSON response.
+     */
+    async getCustomerByExternalId(externalId) {
+        return __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getJson).call(this, `customers/${encodeURIComponent(externalId)}/external`);
+    }
+    /**
+     * Resolves Iron's internal customer id via neobank-proxy customer lookup,
+     * using the MetaMask canonical profile id as the partner `external_id`.
+     *
+     * @returns Iron's internal customer id.
+     */
+    async getMoonpayCustomerId() {
+        return await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getWalletRegistrationService).call(this).getMoonpayCustomerId();
+    }
+    /**
+     * Checks whether a Monad Money Account address is already registered for the
+     * given Iron customer.
+     *
+     * @param params - Customer id and address to check.
+     * @param params.customerId - Iron / MoonPay customer UUID.
+     * @param params.address - Money Account address.
+     * @returns Active, disabled, or absent registration status.
+     */
+    async getWalletRegistrationStatus({ customerId, address, }) {
+        return await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getWalletRegistrationService).call(this).getRegistrationStatus({
+            customerId,
+            address,
+            blockchain: 'Monad',
+        });
+    }
+    /**
+     * Submits a signed Monad Money Account ownership proof via neobank-proxy
+     * `POST /neobank/addresses/crypto/selfhosted`.
+     *
+     * @param params - Signed ownership proof.
+     * @returns Registered wallet record.
+     */
+    async registerSelfHostedWallet(params) {
+        return await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getWalletRegistrationService).call(this).registerSelfHostedWallet({
+            ...params,
+            blockchain: 'Monad',
+        });
+    }
+    onRetry(listener) {
+        return __classPrivateFieldGet(this, _NeoBankService_policy, "f").onRetry(listener);
+    }
+    onBreak(listener) {
+        return __classPrivateFieldGet(this, _NeoBankService_policy, "f").onBreak(listener);
+    }
+    onDegraded(listener) {
+        return __classPrivateFieldGet(this, _NeoBankService_policy, "f").onDegraded(listener);
+    }
+}
+_NeoBankService_messenger = new WeakMap(), _NeoBankService_fetch = new WeakMap(), _NeoBankService_policy = new WeakMap(), _NeoBankService_noRetryPolicy = new WeakMap(), _NeoBankService_environment = new WeakMap(), _NeoBankService_context = new WeakMap(), _NeoBankService_baseUrlOverride = new WeakMap(), _NeoBankService_walletRegistrationService = new WeakMap(), _NeoBankService_instances = new WeakSet(), _NeoBankService_getBaseUrl = function _NeoBankService_getBaseUrl() {
+    if (__classPrivateFieldGet(this, _NeoBankService_baseUrlOverride, "f")) {
+        return __classPrivateFieldGet(this, _NeoBankService_baseUrlOverride, "f");
+    }
+    return getBaseUrl(__classPrivateFieldGet(this, _NeoBankService_environment, "f"));
+}, _NeoBankService_getWalletRegistrationService = function _NeoBankService_getWalletRegistrationService() {
+    __classPrivateFieldSet(this, _NeoBankService_walletRegistrationService, __classPrivateFieldGet(this, _NeoBankService_walletRegistrationService, "f") ?? new WalletRegistrationService({
+        fetch: __classPrivateFieldGet(this, _NeoBankService_fetch, "f"),
+        baseUrl: __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getBaseUrl).call(this),
+        getAuthToken: async () => __classPrivateFieldGet(this, _NeoBankService_messenger, "f").call('AuthenticationController:getBearerToken'),
+        getExternalId: async () => __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getCanonicalExternalId).call(this),
+    }), "f");
+    return __classPrivateFieldGet(this, _NeoBankService_walletRegistrationService, "f");
+}, _NeoBankService_getRequestHeaders = async function _NeoBankService_getRequestHeaders(options = {}) {
+    const bearerToken = await __classPrivateFieldGet(this, _NeoBankService_messenger, "f").call('AuthenticationController:getBearerToken');
+    const headers = {
+        Authorization: `Bearer ${bearerToken}`,
+    };
+    if (options.idempotencyKey) {
+        headers['Idempotency-Key'] = options.idempotencyKey;
+    }
+    return headers;
+}, _NeoBankService_buildUrl = function _NeoBankService_buildUrl(path, query) {
+    const url = new URL(getNeoBankPath(path), __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getBaseUrl).call(this));
+    url.searchParams.set('sdk', RAMPS_SDK_VERSION);
+    url.searchParams.set('controller', packageJson.version);
+    url.searchParams.set('context', __classPrivateFieldGet(this, _NeoBankService_context, "f"));
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    return url;
+}, _NeoBankService_throwHttpError = 
+/**
+ * Throws an {@link HttpError} that carries the upstream response body.
+ *
+ * The neobank-proxy mirrors MoonPay's status *and* body verbatim, so the
+ * body is usually the only place that explains a 4xx (e.g. which field or
+ * permission was rejected). Dropping it makes failures undiagnosable.
+ *
+ * @param url - Request URL, for context in the message.
+ * @param response - Non-OK fetch response.
+ */
+async function _NeoBankService_throwHttpError(url, response) {
+    let detail = '';
+    try {
+        const body = (await response.text()).trim();
+        if (body) {
+            detail = ` - ${body.slice(0, 500)}`;
+        }
+    }
+    catch {
+        // Body already consumed or unreadable; the status alone still helps.
+    }
+    throw new HttpError(response.status, `Fetching '${url.toString()}' failed with status '${response.status}'${detail}`);
+}, _NeoBankService_getJson = async function _NeoBankService_getJson(path, query) {
+    const url = __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_buildUrl).call(this, path, query);
+    return __classPrivateFieldGet(this, _NeoBankService_policy, "f").execute(async () => {
+        const headers = await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getRequestHeaders).call(this);
+        const fetchResponse = await __classPrivateFieldGet(this, _NeoBankService_fetch, "f").call(this, url, { headers });
+        if (!fetchResponse.ok) {
+            await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_throwHttpError).call(this, url, fetchResponse);
+        }
+        return fetchResponse.json();
+    });
+}, _NeoBankService_postJson = async function _NeoBankService_postJson(path, body, options) {
+    const url = __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_buildUrl).call(this, path);
+    return __classPrivateFieldGet(this, _NeoBankService_noRetryPolicy, "f").execute(async () => {
+        const headers = await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_getRequestHeaders).call(this, options);
+        headers['Content-Type'] = 'application/json';
+        const fetchResponse = await __classPrivateFieldGet(this, _NeoBankService_fetch, "f").call(this, url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!fetchResponse.ok) {
+            await __classPrivateFieldGet(this, _NeoBankService_instances, "m", _NeoBankService_throwHttpError).call(this, url, fetchResponse);
+        }
+        return fetchResponse.json();
+    });
+}, _NeoBankService_mapAutorampResponse = function _NeoBankService_mapAutorampResponse(response) {
+    if (!response || typeof response !== 'object' || !response.id) {
+        throw new Error('Malformed response received from neo-bank autoramp API');
+    }
+    return mapNeoBankAutorampToRemoteSnapshot(response);
+}, _NeoBankService_getCanonicalExternalId = 
+/**
+ * Resolves the MetaMask canonical profile id used as MoonPay's partner
+ * `external_id` for neobank customer lookup.
+ *
+ * @returns Canonical profile id.
+ */
+async function _NeoBankService_getCanonicalExternalId() {
+    const profile = await __classPrivateFieldGet(this, _NeoBankService_messenger, "f").call('AuthenticationController:getSessionProfile');
+    const canonical = profile?.canonicalProfileId;
+    const externalId = typeof canonical === 'string' && canonical.length > 0
+        ? canonical
+        : profile?.profileId;
+    if (typeof externalId !== 'string' || externalId.length === 0) {
+        throw new Error('Unable to resolve MetaMask canonical profile id for MoonPay customer lookup');
+    }
+    return externalId;
+};
+//# sourceMappingURL=NeoBankService.mjs.map

package/dist/NeoBankService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeoBankService.mjs","sourceRoot":"","sources":["../src/NeoBankService.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,SAAS,EACV,mCAAmC;AAIpC,OAAO,WAAW,8CAAwB;AAM1C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,2BAA0B;AACxE,OAAO,EAAE,yBAAyB,EAAE,0CAAyC;AAM7E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,UAAU,GAAG,GAAG,IAAI,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AA+DD,MAAM,yBAAyB,GAAG;IAChC,aAAa;IACb,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;IAChB,6BAA6B;IAC7B,qBAAqB;IACrB,yBAAyB;IACzB,sBAAsB;IACtB,6BAA6B;IAC7B,0BAA0B;CAClB,CAAC;AAyBX;;;;;;;;;GASG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,WAA6B;IAC/C,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,gBAAgB,CAAC,UAAU;YAC9B,OAAO,oCAAoC,CAAC;QAC9C,KAAK,gBAAgB,CAAC,OAAO;YAC3B,OAAO,wCAAwC,CAAC;QAClD,KAAK,gBAAgB,CAAC,WAAW;YAC/B,OAAO,wCAAwC,CAAC;QAClD,KAAK,gBAAgB,CAAC,KAAK;YACzB,OAAO,uBAAuB,CAAC;QACjC;YACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAiC;IAEjC,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC;IAC5C,MAAM,eAAe,GACnB,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACzD,MAAM,mBAAmB,GACvB,eAAe,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;QAC/C,CAAC,CAAC;YACE,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,eAAe;SACzD;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,UAAU,EAAE,QAAQ,CAAC,WAAW;QAChC,aAAa,EACX,QAAQ,CAAC,cAAc,KAAK,SAAS;YACrC,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YAChC,CAAC,CAAC,QAAQ,CAAC,cAAc;YACzB,CAAC,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO;QACzC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAmBzB,YAAY,EACV,SAAS,EACT,WAAW,GAAG,gBAAgB,CAAC,OAAO,EACtC,OAAO,EACP,KAAK,EAAE,aAAa,EACpB,aAAa,GAAG,EAAE,EAClB,eAAe,GAQhB;;QA9BQ,4CAAoC;QAEpC,wCAAqB;QAErB,yCAAuB;QAEvB,gDAA8B;QAE9B,8CAA+B;QAE/B,0CAAiB;QAEjB,kDAA0B;QAEnC,4DAAkE;QAiBhE,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,uBAAA,IAAI,6BAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,yBAAU,aAAa,MAAA,CAAC;QAC5B,uBAAA,IAAI,0BAAW,mBAAmB,CAAC;YACjC,iBAAiB,EAAE,UAAU,CAAC,gBAAgB,CAAC;YAC/C,GAAG,aAAa;SACjB,CAAC,MAAA,CAAC;QACH,uBAAA,IAAI,iCAAkB,mBAAmB,CAAC;YACxC,iBAAiB,EAAE,UAAU,CAAC,gBAAgB,CAAC;YAC/C,GAAG,aAAa;YAChB,UAAU,EAAE,CAAC;SACd,CAAC,MAAA,CAAC;QACH,uBAAA,IAAI,+BAAgB,WAAW,MAAA,CAAC;QAChC,uBAAA,IAAI,2BAAY,OAAO,MAAA,CAAC;QACxB,uBAAA,IAAI,mCAAoB,eAAe,MAAA,CAAC;QAExC,uBAAA,IAAI,iCAAW,CAAC,4BAA4B,CAC1C,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAiID;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,0DAAS,MAAb,IAAI,EACzB,aAAa,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAC9C,CAAC;QACF,OAAO,uBAAA,IAAI,sEAAqB,MAAzB,IAAI,EAAsB,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,kBAAkB,CACtB,IAA6B,EAC7B,UAAiC,EAAE;QAEnC,OAAO,uBAAA,IAAI,2DAAU,MAAd,IAAI,EAAW,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAA4B,EAAE;QACnD,OAAO,uBAAA,IAAI,0DAAS,MAAb,IAAI,EAAU,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,IAA6B,EAC7B,UAAiC,EAAE;QAEnC,MAAM,QAAQ,GAAG,MAAM,uBAAA,IAAI,2DAAU,MAAd,IAAI,EACzB,WAAW,EACX,IAAI,EACJ,OAAO,CACR,CAAC;QACF,OAAO,uBAAA,IAAI,sEAAqB,MAAzB,IAAI,EAAsB,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,2BAA2B,CAC/B,UAAkB,EAClB,QAA4B,EAAE;QAE9B,OAAO,uBAAA,IAAI,0DAAS,MAAb,IAAI,EACT,aAAa,kBAAkB,CAAC,UAAU,CAAC,QAAQ,EACnD,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CACvB,UAAkB,EAClB,IAA6B,EAC7B,UAAiC,EAAE;QAEnC,OAAO,uBAAA,IAAI,2DAAU,MAAd,IAAI,EACT,aAAa,kBAAkB,CAAC,UAAU,CAAC,SAAS,EACpD,IAAI,EACJ,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,uBAAuB,CAAC,UAAkB;QAC9C,OAAO,uBAAA,IAAI,0DAAS,MAAb,IAAI,EACT,aAAa,kBAAkB,CAAC,UAAU,CAAC,WAAW,CACvD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB;QACxB,OAAO,MAAM,uBAAA,IAAI,+EAA8B,MAAlC,IAAI,CAAgC,CAAC,oBAAoB,EAAE,CAAC;IAC3E,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,2BAA2B,CAAC,EAChC,UAAU,EACV,OAAO,GAC2B;QAClC,OAAO,MAAM,uBAAA,IAAI,+EAA8B,MAAlC,IAAI,CAAgC,CAAC,qBAAqB,CAAC;YACtE,UAAU;YACV,OAAO;YACP,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,wBAAwB,CAC5B,MAAsC;QAEtC,OAAO,MAAM,uBAAA,IAAI,+EAA8B,MAAlC,IAAI,CAAgC,CAAC,wBAAwB,CAAC;YACzE,GAAG,MAAM;YACT,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAyBD,OAAO,CACL,QAAiD;QAEjD,OAAO,uBAAA,IAAI,8BAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,CACL,QAAiD;QAEjD,OAAO,uBAAA,IAAI,8BAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CACR,QAAoD;QAEpD,OAAO,uBAAA,IAAI,8BAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;CACF;;IApUG,IAAI,uBAAA,IAAI,uCAAiB,EAAE,CAAC;QAC1B,OAAO,uBAAA,IAAI,uCAAiB,CAAC;IAC/B,CAAC;IACD,OAAO,UAAU,CAAC,uBAAA,IAAI,mCAAa,CAAC,CAAC;AACvC,CAAC;IAUC,wJAAoC,IAAI,yBAAyB,CAAC;QAChE,KAAK,EAAE,uBAAA,IAAI,6BAAO;QAClB,OAAO,EAAE,uBAAA,IAAI,6DAAY,MAAhB,IAAI,CAAc;QAC3B,YAAY,EAAE,KAAK,IAAqB,EAAE,CACxC,uBAAA,IAAI,iCAAW,CAAC,IAAI,CAAC,yCAAyC,CAAC;QACjE,aAAa,EAAE,KAAK,IAAqB,EAAE,CACzC,uBAAA,IAAI,yEAAwB,MAA5B,IAAI,CAA0B;KACjC,CAAC,MAAA,CAAC;IACH,OAAO,uBAAA,IAAI,iDAA2B,CAAC;AACzC,CAAC,sCAED,KAAK,4CACH,UAAiC,EAAE;IAEnC,MAAM,WAAW,GAAG,MAAM,uBAAA,IAAI,iCAAW,CAAC,IAAI,CAC5C,yCAAyC,CAC1C,CAAC;IACF,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,WAAW,EAAE;KACvC,CAAC;IACF,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IACtD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,+DAES,IAAY,EAAE,KAA0B;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,uBAAA,IAAI,6DAAY,MAAhB,IAAI,CAAc,CAAC,CAAC;IAC9D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACxD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,uBAAA,IAAI,+BAAS,CAAC,CAAC;IAC/C,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,yCAAiB,GAAQ,EAAE,QAAkB;IAChD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;IACD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,MAAM,EACf,aAAa,GAAG,CAAC,QAAQ,EAAE,yBAAyB,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE,CAChF,CAAC;AACJ,CAAC,4BAED,KAAK,kCACH,IAAY,EACZ,KAA0B;IAE1B,MAAM,GAAG,GAAG,uBAAA,IAAI,2DAAU,MAAd,IAAI,EAAW,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,uBAAA,IAAI,8BAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QACrC,MAAM,OAAO,GAAG,MAAM,uBAAA,IAAI,oEAAmB,MAAvB,IAAI,CAAqB,CAAC;QAChD,MAAM,aAAa,GAAG,MAAM,uBAAA,IAAI,6BAAO,MAAX,IAAI,EAAQ,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;YACtB,MAAM,uBAAA,IAAI,iEAAgB,MAApB,IAAI,EAAiB,GAAG,EAAE,aAAa,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,aAAa,CAAC,IAAI,EAA2B,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,6BAED,KAAK,mCACH,IAAY,EACZ,IAA6B,EAC7B,OAA8B;IAE9B,MAAM,GAAG,GAAG,uBAAA,IAAI,2DAAU,MAAd,IAAI,EAAW,IAAI,CAAC,CAAC;IACjC,OAAO,uBAAA,IAAI,qCAAe,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QAC5C,MAAM,OAAO,GAAG,MAAM,uBAAA,IAAI,oEAAmB,MAAvB,IAAI,EAAoB,OAAO,CAAC,CAAC;QACvD,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC7C,MAAM,aAAa,GAAG,MAAM,uBAAA,IAAI,6BAAO,MAAX,IAAI,EAAQ,GAAG,EAAE;YAC3C,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;YACtB,MAAM,uBAAA,IAAI,iEAAgB,MAApB,IAAI,EAAiB,GAAG,EAAE,aAAa,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,aAAa,CAAC,IAAI,EAA2B,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,qFAGC,QAAiC;IAEjC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,kCAAkC,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAgKD;;;;;GAKG;AACH,KAAK;IACH,MAAM,OAAO,GAAG,MAAM,uBAAA,IAAI,iCAAW,CAAC,IAAI,CACxC,4CAA4C,CAC7C,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,EAAE,kBAAkB,CAAC;IAC9C,MAAM,UAAU,GACd,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QACnD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC;IACzB,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from '@metamask/controller-utils';\nimport {\n  createServicePolicy,\n  handleWhen,\n  HttpError,\n} from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationController } from '@metamask/profile-sync-controller';\n\nimport packageJson from '../package.json';\nimport type {\n  AutorampDepositRailsSummary,\n  AutorampRemoteSnapshot,\n} from './autoramp-types.js';\nimport type { NeoBankServiceMethodActions } from './NeoBankService-method-action-types.js';\nimport { RAMPS_SDK_VERSION, RampsEnvironment } from './RampsService.js';\nimport { WalletRegistrationService } from './wallet-registration-service.js';\nimport type {\n  RegistrationOutcome,\n  RegistrationStatus,\n} from './wallet-registration-service.js';\n\n/**\n * Name of the NeoBankService messenger namespace.\n */\nexport const serviceName = 'NeoBankService';\n\n/**\n * Determines whether a failed neo-bank request is worth re-issuing.\n *\n * 4xx responses describe the request or the account's state (e.g. 403\n * \"Customer is not active\", 422 validation), so repeating them only multiplies\n * the same rejection. 429 stays retryable alongside 5xx and non-HTTP\n * network/timeout errors.\n *\n * @param error - Error thrown while performing the request.\n * @returns `true` when the error is worth retrying.\n */\nfunction isRetryableError(error: unknown): boolean {\n  if (error instanceof HttpError) {\n    if (error.httpStatus === 429) {\n      return true;\n    }\n    return error.httpStatus < 400 || error.httpStatus >= 500;\n  }\n  return true;\n}\n\n/**\n * Raw autoramp payload from the MetaMask Ramp API neo-bank proxy.\n * Shape mirrors MoonPay Enterprise `GET /api/autoramps/{autoramp_id}`.\n * The Ramp API handles partner auth / headers; the client only sends the\n * MetaMask bearer token.\n */\nexport type NeoBankAutorampResponse = {\n  id: string;\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  customer_id?: string;\n  status: string;\n  /**\n   * Destination wallet when present on the proxy response.\n   * Field name may evolve with the Ramp API contract.\n   */\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  wallet_address?: string;\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  recipient_account?: {\n    address?: string;\n  };\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- MoonPay API field\n  deposit_rails?: unknown[];\n};\n\n/**\n * Optional headers for neo-bank mutating requests.\n */\nexport type NeoBankRequestOptions = {\n  /**\n   * Forwarded as `Idempotency-Key` when set (MoonPay requires it on some POSTs;\n   * neobank-proxy generates one when omitted).\n   */\n  idempotencyKey?: string;\n};\n\n/**\n * Query string values accepted by neo-bank GET helpers.\n */\nexport type NeoBankQueryParams = Record<\n  string,\n  string | number | boolean | undefined | null\n>;\n\nexport type GetWalletRegistrationStatusParams = {\n  customerId: string;\n  address: string;\n};\n\nexport type RegisterSelfHostedWalletParams = {\n  customerId: string;\n  address: string;\n  message: string;\n  signature: string;\n  /**\n   * Forwarded as `Idempotency-Key` on the neobank-proxy POST. Prefer a stable\n   * key across retries of the same ownership body.\n   */\n  idempotencyKey?: string;\n};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getAutoramp',\n  'registerPixAddress',\n  'getAutorampQuote',\n  'createAutoramp',\n  'getAutorampQuoteForAutoramp',\n  'attachAutorampQuote',\n  'getCustomerByExternalId',\n  'getMoonpayCustomerId',\n  'getWalletRegistrationStatus',\n  'registerSelfHostedWallet',\n] as const;\n\n/**\n * Actions that {@link NeoBankService} exposes to other consumers.\n */\nexport type NeoBankServiceActions = NeoBankServiceMethodActions;\n\ntype AllowedActions =\n  | AuthenticationController.AuthenticationControllerGetBearerTokenAction\n  | AuthenticationController.AuthenticationControllerGetSessionProfileAction;\n\nexport type NeoBankServiceEvents = never;\n\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link NeoBankService}.\n */\nexport type NeoBankServiceMessenger = Messenger<\n  typeof serviceName,\n  NeoBankServiceActions | AllowedActions,\n  NeoBankServiceEvents | AllowedEvents\n>;\n\n/**\n * Builds a path under the neobank-proxy global prefix.\n *\n * Live neobank-proxy (#1124) mounts routes at `/neobank` on the on-ramp.api\n * host (ALB path routing, no rewrite). Prefer this over `/api/v2/...` so Core\n * matches the proxy that ships.\n *\n * @param path - Path under `/neobank` (no leading slash).\n * @returns Absolute path segment for URL join against the Ramp API host.\n */\nfunction getNeoBankPath(path: string): string {\n  return `neobank/${path.replace(/^\\//u, '')}`;\n}\n\n/**\n * Resolves the Ramp API host for neo-bank calls (same hosts as {@link RampsService}).\n *\n * @param environment - Ramp environment.\n * @returns Base URL.\n */\nfunction getBaseUrl(environment: RampsEnvironment): string {\n  switch (environment) {\n    case RampsEnvironment.Production:\n      return 'https://on-ramp.api.cx.metamask.io';\n    case RampsEnvironment.Staging:\n      return 'https://on-ramp.uat-api.cx.metamask.io';\n    case RampsEnvironment.Development:\n      return 'https://on-ramp.dev-api.cx.metamask.io';\n    case RampsEnvironment.Local:\n      return 'http://localhost:3000';\n    default:\n      throw new Error(`Invalid environment: ${String(environment)}`);\n  }\n}\n\n/**\n * Maps a Ramp API / MoonPay-shaped autoramp response into the local remote snapshot.\n *\n * @param response - Proxy response body.\n * @returns Snapshot for the controller last-seen cursor.\n */\nexport function mapNeoBankAutorampToRemoteSnapshot(\n  response: NeoBankAutorampResponse,\n): AutorampRemoteSnapshot {\n  const depositRails = response.deposit_rails;\n  const hasDepositRails =\n    Array.isArray(depositRails) && depositRails.length > 0;\n  const depositRailsSummary: AutorampDepositRailsSummary | undefined =\n    hasDepositRails || response.status === 'Approved'\n      ? {\n          ready: response.status === 'Approved' && hasDepositRails,\n        }\n      : undefined;\n\n  return {\n    id: response.id,\n    customerId: response.customer_id,\n    walletAddress:\n      response.wallet_address !== undefined &&\n      response.wallet_address.length > 0\n        ? response.wallet_address\n        : response.recipient_account?.address,\n    status: response.status,\n    depositRailsSummary,\n  };\n}\n\n/**\n * Client for MetaMask Ramp API neo-bank endpoints (MoonPay Enterprise proxy).\n *\n * Lives alongside {@link RampsService} and {@link TransakService}. Authentication\n * and MoonPay partner headers are handled by the Ramp API; this service only\n * attaches the MetaMask user bearer token.\n *\n * Paths use the neobank-proxy `/neobank` prefix on the on-ramp.api host.\n */\nexport class NeoBankService {\n  readonly name: typeof serviceName;\n\n  readonly #messenger: NeoBankServiceMessenger;\n\n  readonly #fetch: typeof fetch;\n\n  readonly #policy: ServicePolicy;\n\n  readonly #noRetryPolicy: ServicePolicy;\n\n  readonly #environment: RampsEnvironment;\n\n  readonly #context: string;\n\n  readonly #baseUrlOverride?: string;\n\n  #walletRegistrationService: WalletRegistrationService | undefined;\n\n  constructor({\n    messenger,\n    environment = RampsEnvironment.Staging,\n    context,\n    fetch: fetchFunction,\n    policyOptions = {},\n    baseUrlOverride,\n  }: {\n    messenger: NeoBankServiceMessenger;\n    environment?: RampsEnvironment;\n    context: string;\n    fetch: typeof fetch;\n    policyOptions?: CreateServicePolicyOptions;\n    baseUrlOverride?: string;\n  }) {\n    this.name = serviceName;\n    this.#messenger = messenger;\n    this.#fetch = fetchFunction;\n    this.#policy = createServicePolicy({\n      retryFilterPolicy: handleWhen(isRetryableError),\n      ...policyOptions,\n    });\n    this.#noRetryPolicy = createServicePolicy({\n      retryFilterPolicy: handleWhen(isRetryableError),\n      ...policyOptions,\n      maxRetries: 0,\n    });\n    this.#environment = environment;\n    this.#context = context;\n    this.#baseUrlOverride = baseUrlOverride;\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  #getBaseUrl(): string {\n    if (this.#baseUrlOverride) {\n      return this.#baseUrlOverride;\n    }\n    return getBaseUrl(this.#environment);\n  }\n\n  /**\n   * Lazily builds the wallet registration client. Deferred so constructing the\n   * service never resolves the base URL eagerly (an invalid environment only\n   * throws when a request is made, matching the other neo-bank methods).\n   *\n   * @returns The wallet registration client.\n   */\n  #getWalletRegistrationService(): WalletRegistrationService {\n    this.#walletRegistrationService ??= new WalletRegistrationService({\n      fetch: this.#fetch,\n      baseUrl: this.#getBaseUrl(),\n      getAuthToken: async (): Promise<string> =>\n        this.#messenger.call('AuthenticationController:getBearerToken'),\n      getExternalId: async (): Promise<string> =>\n        this.#getCanonicalExternalId(),\n    });\n    return this.#walletRegistrationService;\n  }\n\n  async #getRequestHeaders(\n    options: NeoBankRequestOptions = {},\n  ): Promise<Record<string, string>> {\n    const bearerToken = await this.#messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${bearerToken}`,\n    };\n    if (options.idempotencyKey) {\n      headers['Idempotency-Key'] = options.idempotencyKey;\n    }\n    return headers;\n  }\n\n  #buildUrl(path: string, query?: NeoBankQueryParams): URL {\n    const url = new URL(getNeoBankPath(path), this.#getBaseUrl());\n    url.searchParams.set('sdk', RAMPS_SDK_VERSION);\n    url.searchParams.set('controller', packageJson.version);\n    url.searchParams.set('context', this.#context);\n    if (query) {\n      for (const [key, value] of Object.entries(query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n    return url;\n  }\n\n  /**\n   * Throws an {@link HttpError} that carries the upstream response body.\n   *\n   * The neobank-proxy mirrors MoonPay's status *and* body verbatim, so the\n   * body is usually the only place that explains a 4xx (e.g. which field or\n   * permission was rejected). Dropping it makes failures undiagnosable.\n   *\n   * @param url - Request URL, for context in the message.\n   * @param response - Non-OK fetch response.\n   */\n  async #throwHttpError(url: URL, response: Response): Promise<never> {\n    let detail = '';\n    try {\n      const body = (await response.text()).trim();\n      if (body) {\n        detail = ` - ${body.slice(0, 500)}`;\n      }\n    } catch {\n      // Body already consumed or unreadable; the status alone still helps.\n    }\n    throw new HttpError(\n      response.status,\n      `Fetching '${url.toString()}' failed with status '${response.status}'${detail}`,\n    );\n  }\n\n  async #getJson<ResponseBody>(\n    path: string,\n    query?: NeoBankQueryParams,\n  ): Promise<ResponseBody> {\n    const url = this.#buildUrl(path, query);\n    return this.#policy.execute(async () => {\n      const headers = await this.#getRequestHeaders();\n      const fetchResponse = await this.#fetch(url, { headers });\n      if (!fetchResponse.ok) {\n        await this.#throwHttpError(url, fetchResponse);\n      }\n      return fetchResponse.json() as Promise<ResponseBody>;\n    });\n  }\n\n  async #postJson<ResponseBody>(\n    path: string,\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions,\n  ): Promise<ResponseBody> {\n    const url = this.#buildUrl(path);\n    return this.#noRetryPolicy.execute(async () => {\n      const headers = await this.#getRequestHeaders(options);\n      headers['Content-Type'] = 'application/json';\n      const fetchResponse = await this.#fetch(url, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(body),\n      });\n      if (!fetchResponse.ok) {\n        await this.#throwHttpError(url, fetchResponse);\n      }\n      return fetchResponse.json() as Promise<ResponseBody>;\n    });\n  }\n\n  #mapAutorampResponse(\n    response: NeoBankAutorampResponse,\n  ): AutorampRemoteSnapshot {\n    if (!response || typeof response !== 'object' || !response.id) {\n      throw new Error('Malformed response received from neo-bank autoramp API');\n    }\n    return mapNeoBankAutorampToRemoteSnapshot(response);\n  }\n\n  /**\n   * Fetches an autoramp account via neobank-proxy\n   * `GET /neobank/autoramps/{autoramp_id}` (MoonPay\n   * `GET /api/autoramps/{autoramp_id}`).\n   *\n   * @param autorampId - MoonPay / Ramp API autoramp id.\n   * @returns Remote snapshot for controller apply/refresh.\n   */\n  async getAutoramp(autorampId: string): Promise<AutorampRemoteSnapshot> {\n    const response = await this.#getJson<NeoBankAutorampResponse>(\n      `autoramps/${encodeURIComponent(autorampId)}`,\n    );\n    return this.#mapAutorampResponse(response);\n  }\n\n  /**\n   * Registers a Pix address via neobank-proxy `POST /neobank/addresses/pix`.\n   * Body is forwarded as opaque JSON (MoonPay address schema).\n   *\n   * @param body - Pix address registration payload.\n   * @param options - Optional idempotency key.\n   * @returns Parsed proxy JSON response.\n   */\n  async registerPixAddress(\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions = {},\n  ): Promise<unknown> {\n    return this.#postJson('addresses/pix', body, options);\n  }\n\n  /**\n   * Fetches an autoramp quote via neobank-proxy `GET /neobank/autoramps/quote`.\n   *\n   * @param query - Quote query params (forwarded as-is).\n   * @returns Parsed proxy JSON response.\n   */\n  async getAutorampQuote(query: NeoBankQueryParams = {}): Promise<unknown> {\n    return this.#getJson('autoramps/quote', query);\n  }\n\n  /**\n   * Creates an autoramp from a signed quote via neobank-proxy\n   * `POST /neobank/autoramps` (MoonPay `POST /api/autoramps`).\n   *\n   * @param body - CreateAutoramp / signed-quote payload (forwarded as-is).\n   * @param options - Optional idempotency key.\n   * @returns Remote snapshot for controller apply/refresh.\n   */\n  async createAutoramp(\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions = {},\n  ): Promise<AutorampRemoteSnapshot> {\n    const response = await this.#postJson<NeoBankAutorampResponse>(\n      'autoramps',\n      body,\n      options,\n    );\n    return this.#mapAutorampResponse(response);\n  }\n\n  /**\n   * Fetches a quote for an existing autoramp via neobank-proxy\n   * `GET /neobank/autoramps/{autoramp_id}/quote`.\n   *\n   * @param autorampId - Autoramp id.\n   * @param query - Quote query params (forwarded as-is).\n   * @returns Parsed proxy JSON response.\n   */\n  async getAutorampQuoteForAutoramp(\n    autorampId: string,\n    query: NeoBankQueryParams = {},\n  ): Promise<unknown> {\n    return this.#getJson(\n      `autoramps/${encodeURIComponent(autorampId)}/quote`,\n      query,\n    );\n  }\n\n  /**\n   * Attaches a signed quote to an autoramp via neobank-proxy\n   * `POST /neobank/autoramps/{autoramp_id}/quotes`.\n   *\n   * @param autorampId - Autoramp id.\n   * @param body - Quote attachment payload (forwarded as-is).\n   * @param options - Optional idempotency key.\n   * @returns Parsed proxy JSON response.\n   */\n  async attachAutorampQuote(\n    autorampId: string,\n    body: Record<string, unknown>,\n    options: NeoBankRequestOptions = {},\n  ): Promise<unknown> {\n    return this.#postJson(\n      `autoramps/${encodeURIComponent(autorampId)}/quotes`,\n      body,\n      options,\n    );\n  }\n\n  /**\n   * Fetches a customer by partner external id via neobank-proxy\n   * `GET /neobank/customers/{external_id}/external`.\n   *\n   * @param externalId - Partner-assigned external customer id.\n   * @returns Parsed proxy JSON response.\n   */\n  async getCustomerByExternalId(externalId: string): Promise<unknown> {\n    return this.#getJson(\n      `customers/${encodeURIComponent(externalId)}/external`,\n    );\n  }\n\n  /**\n   * Resolves Iron's internal customer id via neobank-proxy customer lookup,\n   * using the MetaMask canonical profile id as the partner `external_id`.\n   *\n   * @returns Iron's internal customer id.\n   */\n  async getMoonpayCustomerId(): Promise<string> {\n    return await this.#getWalletRegistrationService().getMoonpayCustomerId();\n  }\n\n  /**\n   * Checks whether a Monad Money Account address is already registered for the\n   * given Iron customer.\n   *\n   * @param params - Customer id and address to check.\n   * @param params.customerId - Iron / MoonPay customer UUID.\n   * @param params.address - Money Account address.\n   * @returns Active, disabled, or absent registration status.\n   */\n  async getWalletRegistrationStatus({\n    customerId,\n    address,\n  }: GetWalletRegistrationStatusParams): Promise<RegistrationStatus> {\n    return await this.#getWalletRegistrationService().getRegistrationStatus({\n      customerId,\n      address,\n      blockchain: 'Monad',\n    });\n  }\n\n  /**\n   * Submits a signed Monad Money Account ownership proof via neobank-proxy\n   * `POST /neobank/addresses/crypto/selfhosted`.\n   *\n   * @param params - Signed ownership proof.\n   * @returns Registered wallet record.\n   */\n  async registerSelfHostedWallet(\n    params: RegisterSelfHostedWalletParams,\n  ): Promise<RegistrationOutcome> {\n    return await this.#getWalletRegistrationService().registerSelfHostedWallet({\n      ...params,\n      blockchain: 'Monad',\n    });\n  }\n\n  /**\n   * Resolves the MetaMask canonical profile id used as MoonPay's partner\n   * `external_id` for neobank customer lookup.\n   *\n   * @returns Canonical profile id.\n   */\n  async #getCanonicalExternalId(): Promise<string> {\n    const profile = await this.#messenger.call(\n      'AuthenticationController:getSessionProfile',\n    );\n    const canonical = profile?.canonicalProfileId;\n    const externalId =\n      typeof canonical === 'string' && canonical.length > 0\n        ? canonical\n        : profile?.profileId;\n    if (typeof externalId !== 'string' || externalId.length === 0) {\n      throw new Error(\n        'Unable to resolve MetaMask canonical profile id for MoonPay customer lookup',\n      );\n    }\n    return externalId;\n  }\n\n  onRetry(\n    listener: Parameters<ServicePolicy['onRetry']>[0],\n  ): ReturnType<ServicePolicy['onRetry']> {\n    return this.#policy.onRetry(listener);\n  }\n\n  onBreak(\n    listener: Parameters<ServicePolicy['onBreak']>[0],\n  ): ReturnType<ServicePolicy['onBreak']> {\n    return this.#policy.onBreak(listener);\n  }\n\n  onDegraded(\n    listener: Parameters<ServicePolicy['onDegraded']>[0],\n  ): ReturnType<ServicePolicy['onDegraded']> {\n    return this.#policy.onDegraded(listener);\n  }\n}\n"]}