@portal-hq/web 3.17.0 → 3.18.0-alpha.0

package/src/integrations/ramps/meld/index.test.ts

@@ -0,0 +1,189 @@
+import Meld from '.'
+import Mpc from '../../../mpc'
+
+const mockMeldCreateCustomerResponse = {
+  data: { id: 'cust-1', accountId: 'acc-1', externalId: 'ext-1' },
+}
+const mockMeldSearchCustomerResponse = {
+  data: { customers: [], count: 0, remaining: 0 },
+}
+const mockMeldGetRetailQuoteResponse = {
+  data: { quotes: [] },
+}
+const mockMeldCreateRetailWidgetResponse = {
+  data: { id: 'sess-1', token: 'tok-1', customerId: 'cust-1', externalCustomerId: 'ext-1', externalSessionId: 'ses-1', widgetUrl: 'https://widget.meld.io' },
+}
+const mockMeldSearchRetailTransactionsResponse = {
+  data: { transactions: [], count: 0, remaining: 0, totalCount: 0 },
+}
+const mockMeldGetRetailTransactionResponse = {
+  data: { transaction: { id: 'tx-1', sessionId: 'ses-1', status: 'COMPLETED', transactionType: 'BUY', serviceProvider: 'STRIPE', createdAt: '2024-01-01', updatedAt: '2024-01-01' } },
+}
+const mockMeldDiscoveryResponse = { data: [] }
+
+const buildMpcMock = () =>
+  ({
+    meldCreateCustomer: jest.fn().mockResolvedValue(mockMeldCreateCustomerResponse),
+    meldSearchCustomer: jest.fn().mockResolvedValue(mockMeldSearchCustomerResponse),
+    meldGetRetailQuote: jest.fn().mockResolvedValue(mockMeldGetRetailQuoteResponse),
+    meldCreateRetailWidget: jest.fn().mockResolvedValue(mockMeldCreateRetailWidgetResponse),
+    meldSearchRetailTransactions: jest.fn().mockResolvedValue(mockMeldSearchRetailTransactionsResponse),
+    meldGetRetailTransactionBySession: jest.fn().mockResolvedValue(mockMeldGetRetailTransactionResponse),
+    meldGetRetailTransaction: jest.fn().mockResolvedValue(mockMeldGetRetailTransactionResponse),
+    meldGetServiceProviders: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetCountries: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetFiatCurrencies: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetCryptoCurrencies: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetPaymentMethods: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetDefaults: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetBuyLimits: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetSellLimits: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+    meldGetKycLimits: jest.fn().mockResolvedValue(mockMeldDiscoveryResponse),
+  }) as unknown as Mpc
+
+describe('Meld', () => {
+  let mpcMock: Mpc
+  let meld: Meld
+
+  beforeEach(() => {
+    mpcMock = buildMpcMock()
+    meld = new Meld({ mpc: mpcMock })
+  })
+
+  it('createCustomer delegates to mpc.meldCreateCustomer', async () => {
+    const req = { email: 'user@example.com', type: 'INDIVIDUAL' as const }
+    const result = await meld.createCustomer(req)
+
+    expect(mpcMock.meldCreateCustomer).toHaveBeenCalledWith(req)
+    expect(result).toEqual(mockMeldCreateCustomerResponse)
+  })
+
+  it('searchCustomer delegates to mpc.meldSearchCustomer', async () => {
+    const result = await meld.searchCustomer()
+
+    expect(mpcMock.meldSearchCustomer).toHaveBeenCalled()
+    expect(result).toEqual(mockMeldSearchCustomerResponse)
+  })
+
+  it('getRetailQuote delegates to mpc.meldGetRetailQuote', async () => {
+    const req = { countryCode: 'US', sourceCurrencyCode: 'USD', destinationCurrencyCode: 'ETH', sourceAmount: 100 }
+    const result = await meld.getRetailQuote(req)
+
+    expect(mpcMock.meldGetRetailQuote).toHaveBeenCalledWith(req)
+    expect(result).toEqual(mockMeldGetRetailQuoteResponse)
+  })
+
+  it('createRetailWidget delegates to mpc.meldCreateRetailWidget', async () => {
+    const req = {
+      sessionType: 'BUY' as const,
+      sessionData: {
+        countryCode: 'US',
+        serviceProvider: 'STRIPE',
+        sourceCurrencyCode: 'USD',
+        sourceAmount: '100',
+        destinationCurrencyCode: 'ETH',
+      },
+    }
+    const result = await meld.createRetailWidget(req)
+
+    expect(mpcMock.meldCreateRetailWidget).toHaveBeenCalledWith(req)
+    expect(result).toEqual(mockMeldCreateRetailWidgetResponse)
+  })
+
+  it('searchRetailTransactions delegates to mpc.meldSearchRetailTransactions without params', async () => {
+    const result = await meld.searchRetailTransactions()
+
+    expect(mpcMock.meldSearchRetailTransactions).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldSearchRetailTransactionsResponse)
+  })
+
+  it('searchRetailTransactions delegates with params when provided', async () => {
+    const params = { status: 'COMPLETED' }
+    await meld.searchRetailTransactions(params)
+
+    expect(mpcMock.meldSearchRetailTransactions).toHaveBeenCalledWith(params)
+  })
+
+  it('getRetailTransactionBySession delegates to mpc.meldGetRetailTransactionBySession', async () => {
+    const result = await meld.getRetailTransactionBySession('ses-1')
+
+    expect(mpcMock.meldGetRetailTransactionBySession).toHaveBeenCalledWith('ses-1')
+    expect(result).toEqual(mockMeldGetRetailTransactionResponse)
+  })
+
+  it('getRetailTransaction delegates to mpc.meldGetRetailTransaction', async () => {
+    const result = await meld.getRetailTransaction('tx-1')
+
+    expect(mpcMock.meldGetRetailTransaction).toHaveBeenCalledWith('tx-1')
+    expect(result).toEqual(mockMeldGetRetailTransactionResponse)
+  })
+
+  it('getServiceProviders delegates to mpc.meldGetServiceProviders', async () => {
+    const params = { countries: 'US' }
+    const result = await meld.getServiceProviders(params)
+
+    expect(mpcMock.meldGetServiceProviders).toHaveBeenCalledWith(params)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getServiceProviders without params delegates undefined', async () => {
+    await meld.getServiceProviders()
+    expect(mpcMock.meldGetServiceProviders).toHaveBeenCalledWith(undefined)
+  })
+
+  it('getCountries delegates to mpc.meldGetCountries', async () => {
+    const result = await meld.getCountries()
+
+    expect(mpcMock.meldGetCountries).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getFiatCurrencies delegates to mpc.meldGetFiatCurrencies', async () => {
+    const result = await meld.getFiatCurrencies()
+
+    expect(mpcMock.meldGetFiatCurrencies).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getCryptoCurrencies delegates to mpc.meldGetCryptoCurrencies', async () => {
+    const result = await meld.getCryptoCurrencies()
+
+    expect(mpcMock.meldGetCryptoCurrencies).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getPaymentMethods delegates to mpc.meldGetPaymentMethods', async () => {
+    const result = await meld.getPaymentMethods()
+
+    expect(mpcMock.meldGetPaymentMethods).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getDefaults delegates to mpc.meldGetDefaults', async () => {
+    const result = await meld.getDefaults()
+
+    expect(mpcMock.meldGetDefaults).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getBuyLimits delegates to mpc.meldGetBuyLimits', async () => {
+    const result = await meld.getBuyLimits()
+
+    expect(mpcMock.meldGetBuyLimits).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getSellLimits delegates to mpc.meldGetSellLimits', async () => {
+    const result = await meld.getSellLimits()
+
+    expect(mpcMock.meldGetSellLimits).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+
+  it('getKycLimits delegates to mpc.meldGetKycLimits', async () => {
+    const result = await meld.getKycLimits()
+
+    expect(mpcMock.meldGetKycLimits).toHaveBeenCalledWith(undefined)
+    expect(result).toEqual(mockMeldDiscoveryResponse)
+  })
+})

package/src/integrations/ramps/meld/index.ts

@@ -0,0 +1,149 @@
+import Mpc from '../../../mpc'
+import type {
+  MeldCreateCustomerRequest,
+  MeldCreateCustomerResponse,
+  MeldSearchCustomerResponse,
+  MeldGetRetailQuoteRequest,
+  MeldGetRetailQuoteResponse,
+  MeldCreateRetailWidgetRequest,
+  MeldCreateRetailWidgetResponse,
+  MeldSearchRetailTransactionsParams,
+  MeldSearchRetailTransactionsResponse,
+  MeldGetRetailTransactionResponse,
+  MeldDiscoveryParams,
+  MeldGetServiceProvidersResponse,
+  MeldGetCountriesResponse,
+  MeldGetFiatCurrenciesResponse,
+  MeldGetCryptoCurrenciesResponse,
+  MeldGetPaymentMethodsResponse,
+  MeldGetDefaultsResponse,
+  MeldGetBuyLimitsResponse,
+  MeldGetSellLimitsResponse,
+  MeldGetKycLimitsResponse,
+} from '../../../shared/types'
+
+/**
+ * Meld fiat on-ramp API on `portal.ramps.meld`.
+ * Each method forwards to the embedded Portal iframe, which calls connect-api.
+ */
+export default class Meld {
+  private mpc: Mpc
+
+  constructor({ mpc }: { mpc: Mpc }) {
+    this.mpc = mpc
+  }
+
+  /** Register a new Meld customer for the authenticated client. */
+  public async createCustomer(
+    data: MeldCreateCustomerRequest,
+  ): Promise<MeldCreateCustomerResponse> {
+    return this.mpc.meldCreateCustomer(data)
+  }
+
+  /** Retrieve the Meld customer record for the authenticated client. */
+  public async searchCustomer(): Promise<MeldSearchCustomerResponse> {
+    return this.mpc.meldSearchCustomer()
+  }
+
+  /** Get fiat-to-crypto purchase quotes from Meld service providers. */
+  public async getRetailQuote(
+    data: MeldGetRetailQuoteRequest,
+  ): Promise<MeldGetRetailQuoteResponse> {
+    return this.mpc.meldGetRetailQuote(data)
+  }
+
+  /**
+   * Create a Meld-hosted retail widget session.
+   * The response contains `data.widgetUrl` — open this URL in a new browser tab
+   * to let the user complete the purchase or KYC flow on the Meld-hosted page.
+   */
+  public async createRetailWidget(
+    data: MeldCreateRetailWidgetRequest,
+  ): Promise<MeldCreateRetailWidgetResponse> {
+    return this.mpc.meldCreateRetailWidget(data)
+  }
+
+  /** Search retail transactions for the authenticated client. */
+  public async searchRetailTransactions(
+    data?: MeldSearchRetailTransactionsParams,
+  ): Promise<MeldSearchRetailTransactionsResponse> {
+    return this.mpc.meldSearchRetailTransactions(data)
+  }
+
+  /** Get a single retail transaction by session ID. */
+  public async getRetailTransactionBySession(
+    sessionId: string,
+  ): Promise<MeldGetRetailTransactionResponse> {
+    return this.mpc.meldGetRetailTransactionBySession(sessionId)
+  }
+
+  /** Get a single retail transaction by transaction ID. */
+  public async getRetailTransaction(
+    id: string,
+  ): Promise<MeldGetRetailTransactionResponse> {
+    return this.mpc.meldGetRetailTransaction(id)
+  }
+
+  /** Discover available Meld service providers. */
+  public async getServiceProviders(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetServiceProvidersResponse> {
+    return this.mpc.meldGetServiceProviders(params)
+  }
+
+  /** Discover supported countries. */
+  public async getCountries(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetCountriesResponse> {
+    return this.mpc.meldGetCountries(params)
+  }
+
+  /** Discover supported fiat currencies. */
+  public async getFiatCurrencies(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetFiatCurrenciesResponse> {
+    return this.mpc.meldGetFiatCurrencies(params)
+  }
+
+  /** Discover supported crypto currencies. */
+  public async getCryptoCurrencies(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetCryptoCurrenciesResponse> {
+    return this.mpc.meldGetCryptoCurrencies(params)
+  }
+
+  /** Discover supported payment methods. */
+  public async getPaymentMethods(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetPaymentMethodsResponse> {
+    return this.mpc.meldGetPaymentMethods(params)
+  }
+
+  /** Discover default currency and payment method settings by country. */
+  public async getDefaults(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetDefaultsResponse> {
+    return this.mpc.meldGetDefaults(params)
+  }
+
+  /** Discover fiat currency purchase limits. */
+  public async getBuyLimits(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetBuyLimitsResponse> {
+    return this.mpc.meldGetBuyLimits(params)
+  }
+
+  /** Discover crypto currency sell limits. */
+  public async getSellLimits(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetSellLimitsResponse> {
+    return this.mpc.meldGetSellLimits(params)
+  }
+
+  /** Discover KYC fiat level limits. */
+  public async getKycLimits(
+    params?: MeldDiscoveryParams,
+  ): Promise<MeldGetKycLimitsResponse> {
+    return this.mpc.meldGetKycLimits(params)
+  }
+}

package/src/integrations/ramps/noah/index.test.ts

@@ -65,11 +65,15 @@ describe('Noah', () => {
     const spy = jest.spyOn(mpc, 'initiatePayin').mockResolvedValue({
       data: {
         payinId: 'p1',
+        cryptoCurrency: 'USDC_TEST',
+        fee: { fiatCurrencyCode: 'USD', totalFeePct: '0', totalFeeBase: '0', totalFeeMin: '0' },
         bankDetails: {
           paymentMethodId: 'pm-123',
-          paymentMethodType: 'bank_account',
+          paymentMethodType: 'BankLocal',
           accountNumber: '1234567890',
+          cryptoCurrency: 'USDC_TEST',
           network: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
+          fee: { fiatCurrencyCode: 'USD', totalFeePct: '0', totalFeeBase: '0', totalFeeMin: '0' },
         },
       },
     })
@@ -136,6 +140,7 @@ describe('Noah', () => {
         payoutId: 'out-1',
         formSessionId: 'fs-1',
         cryptoAmountEstimate: '10',
+        cryptoAuthorizedAmount: '10',
         totalFee: '0.01',
       },
     })
@@ -166,7 +171,11 @@ describe('Noah', () => {
     const spy = jest.spyOn(mpc, 'getPaymentMethods').mockResolvedValue({
       data: { paymentMethods: [] },
     })
-    await noah.getPaymentMethods()
+    await noah.getPaymentMethods({
+        pageSize: 50,
+        pageToken: 'token-123',
+        capability: 'PayoutFrom',
+      })
     expect(spy).toHaveBeenCalled()
   })
 })

package/src/integrations/ramps/noah/index.ts

@@ -15,6 +15,7 @@ import type {
   NoahInitiatePayoutResponse,
   NoahSimulatePayinRequest,
   NoahSimulatePayinResponse,
+  NoahGetPaymentMethodsRequest,
 } from '../../../shared/types'
 
 /**
@@ -83,7 +84,9 @@ export default class Noah {
   }
 
   /** Pay-in payment methods available to the customer. */
-  public async getPaymentMethods(): Promise<NoahGetPaymentMethodsResponse> {
-    return this.mpc.getPaymentMethods()
+  public async getPaymentMethods(
+    data?: NoahGetPaymentMethodsRequest,
+  ): Promise<NoahGetPaymentMethodsResponse> {
+    return this.mpc.getPaymentMethods(data)
   }
 }