@blocklet/payment-react 1.24.3 → 1.25.0

package/lib/hooks/dynamic-pricing.js

@@ -0,0 +1,390 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+exports.useDynamicPricing = useDynamicPricing;
+var _react = require("react");
+var _util = require("@ocap/util");
+var _util2 = require("../libs/util");
+function extractQuoteMeta(items) {
+  if (!items?.length) {
+    return null;
+  }
+  let exchangeRate = null;
+  let baseCurrency = null;
+  let expiresAt = null;
+  let providerName = null;
+  let providerId = null;
+  let rateTimestampMs = null;
+  let slippagePercent = null;
+  items.forEach(item => {
+    const price = item.upsell_price || item.price;
+    const rate = item?.exchange_rate;
+    if (!exchangeRate && rate) {
+      exchangeRate = rate;
+    }
+    const base = price?.base_currency;
+    if (!baseCurrency && base) {
+      baseCurrency = base;
+    }
+    const expires = item?.expires_at;
+    if (expires) {
+      expiresAt = expiresAt === null ? expires : Math.min(expiresAt, expires);
+    }
+    const itemProviderName = item?.rate_provider_name;
+    if (!providerName && itemProviderName) {
+      providerName = itemProviderName;
+    }
+    const itemProviderId = item?.rate_provider_id;
+    if (!providerId && itemProviderId) {
+      providerId = itemProviderId;
+    }
+    const itemRateTimestamp = item?.rate_timestamp_ms;
+    if (!rateTimestampMs && Number.isFinite(Number(itemRateTimestamp))) {
+      rateTimestampMs = Number(itemRateTimestamp);
+    }
+    const itemSlippage = item?.slippage_percent;
+    if (slippagePercent === null && Number.isFinite(Number(itemSlippage))) {
+      slippagePercent = Number(itemSlippage);
+    }
+  });
+  return {
+    exchangeRate,
+    baseCurrency: baseCurrency || "USD",
+    expiresAt,
+    providerName,
+    providerId,
+    rateTimestampMs,
+    slippagePercent
+  };
+}
+function calculateTokenAmount(items, rate, currencyDecimal, trialing = false) {
+  const usdTotal = items.reduce((acc, item) => {
+    const price = item.upsell_price || item.price;
+    if (trialing && price?.type === "recurring") {
+      return acc;
+    }
+    if (price?.type === "recurring" && price?.recurring?.usage_type === "metered") {
+      return acc;
+    }
+    const baseAmount = price?.base_amount;
+    if (baseAmount) {
+      const quantity = item.quantity || 1;
+      return acc + Number(baseAmount) * quantity;
+    }
+    return acc;
+  }, 0);
+  if (usdTotal <= 0) {
+    return null;
+  }
+  const rateNum = Number(rate);
+  if (rateNum <= 0) {
+    return null;
+  }
+  const tokenAmount = usdTotal / rateNum;
+  const tokenAmountUnit = (0, _util.fromTokenToUnit)(tokenAmount.toFixed(currencyDecimal || 8), currencyDecimal || 8);
+  return tokenAmountUnit.toString();
+}
+function extractQuoteLockedAt(paymentIntent, checkoutSession) {
+  if (paymentIntent?.quote_locked_at) {
+    const lockedAtMs = new Date(paymentIntent.quote_locked_at).getTime();
+    if (Number.isFinite(lockedAtMs)) {
+      return Math.floor(lockedAtMs / 1e3);
+    }
+  }
+  const metaLockedAt = checkoutSession?.metadata?.quote_locked_at;
+  if (typeof metaLockedAt === "number") {
+    return metaLockedAt;
+  }
+  if (typeof metaLockedAt === "string") {
+    const parsed = Number(metaLockedAt);
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return null;
+}
+function useDynamicPricing(options) {
+  const {
+    items,
+    currency,
+    liveRate,
+    liveQuoteSnapshot,
+    checkoutSession,
+    paymentIntent,
+    locale = "en",
+    isStripePayment = false,
+    isSubscription = checkoutSession?.mode === "subscription" || checkoutSession?.mode === "setup",
+    slippageConfig,
+    trialInDays = 0,
+    trialEnd = 0,
+    discounts
+  } = options;
+  const currentTime = Math.floor(Date.now() / 1e3);
+  const trialing = trialInDays > 0 || trialEnd > currentTime;
+  const hasDynamicPricing = (0, _react.useMemo)(() => items.some(item => (item.upsell_price || item.price)?.pricing_type === "dynamic"), [items]);
+  const quoteMeta = (0, _react.useMemo)(() => hasDynamicPricing ? extractQuoteMeta(items) : null, [items, hasDynamicPricing]);
+  const rateInfo = (0, _react.useMemo)(() => ({
+    exchangeRate: isStripePayment ? null : liveRate?.rate || quoteMeta?.exchangeRate || null,
+    baseCurrency: liveRate?.base_currency || quoteMeta?.baseCurrency || "USD",
+    providerName: isStripePayment ? null : liveRate?.provider_name || quoteMeta?.providerName || null,
+    providerId: isStripePayment ? null : liveRate?.provider_id || quoteMeta?.providerId || null,
+    timestampMs: isStripePayment ? null : liveRate?.timestamp_ms || quoteMeta?.rateTimestampMs || null,
+    fetchedAt: isStripePayment ? null : liveRate?.fetched_at || null
+    // When we fetched the data
+  }), [liveRate, quoteMeta, isStripePayment]);
+  const calculatedTokenAmount = (0, _react.useMemo)(() => {
+    if (isStripePayment || !hasDynamicPricing || !liveRate?.rate) {
+      return null;
+    }
+    return calculateTokenAmount(items, liveRate.rate, currency.decimal, trialing);
+  }, [hasDynamicPricing, liveRate?.rate, items, currency.decimal, isStripePayment, trialing]);
+  const calculatedDiscountAmount = (0, _react.useMemo)(() => {
+    if (!discounts?.length) {
+      return null;
+    }
+    const couponDetails = discounts[0]?.coupon_details;
+    if (!couponDetails) {
+      return null;
+    }
+    if (isStripePayment) {
+      const discountableSubtotalCents = items.reduce((sum, item) => {
+        if (!item.discountable) {
+          return sum;
+        }
+        const price = item.upsell_price || item.price;
+        if (trialing && price?.type === "recurring") {
+          return sum;
+        }
+        if (price?.type === "recurring" && price?.recurring?.usage_type === "metered") {
+          return sum;
+        }
+        const isDynamic = price?.pricing_type === "dynamic";
+        const baseAmount = price?.base_amount;
+        let amountCents;
+        if (isDynamic && baseAmount !== void 0 && baseAmount !== null) {
+          amountCents = Number(baseAmount) * 100;
+        } else {
+          const unitAmount = price?.unit_amount;
+          if (!unitAmount) {
+            return sum;
+          }
+          amountCents = Number(unitAmount);
+        }
+        const quantity = item.quantity || 1;
+        return sum + amountCents * quantity;
+      }, 0);
+      if (discountableSubtotalCents <= 0) {
+        return null;
+      }
+      if (couponDetails.percent_off && couponDetails.percent_off > 0) {
+        const discountCents = Math.round(discountableSubtotalCents * couponDetails.percent_off / 100);
+        return discountCents.toString();
+      }
+      if (couponDetails.amount_off) {
+        const amountOffCents = Number(couponDetails.amount_off);
+        if (Number.isFinite(amountOffCents) && amountOffCents > 0) {
+          return Math.min(amountOffCents, discountableSubtotalCents).toString();
+        }
+      }
+      return null;
+    }
+    if (!hasDynamicPricing || !liveRate?.rate) {
+      return null;
+    }
+    const rateNum = Number(liveRate.rate);
+    if (rateNum <= 0) {
+      return null;
+    }
+    const discountableSubtotal = items.reduce((sum, item) => {
+      if (!item.discountable) {
+        return sum;
+      }
+      const price = item.upsell_price || item.price;
+      if (trialing && price?.type === "recurring") {
+        return sum;
+      }
+      if (price?.type === "recurring" && price?.recurring?.usage_type === "metered") {
+        return sum;
+      }
+      const baseAmount = price?.base_amount;
+      if (!baseAmount) {
+        return sum;
+      }
+      const quantity = item.quantity || 1;
+      const tokenAmount = Number(baseAmount) * quantity / rateNum;
+      return sum + tokenAmount;
+    }, 0);
+    if (discountableSubtotal <= 0) {
+      return null;
+    }
+    if (couponDetails.percent_off && couponDetails.percent_off > 0) {
+      const discountAmount = discountableSubtotal * couponDetails.percent_off / 100;
+      const discountAmountUnit = (0, _util.fromTokenToUnit)(discountAmount.toFixed(currency.decimal || 8), currency.decimal || 8);
+      return discountAmountUnit.toString();
+    }
+    if (couponDetails.amount_off) {
+      const amountOff = couponDetails.currency_id === currency.id ? couponDetails.amount_off : couponDetails.currency_options?.[currency.id]?.amount_off;
+      if (!amountOff) {
+        return null;
+      }
+      const subtotalUnit = (0, _util.fromTokenToUnit)(discountableSubtotal.toFixed(currency.decimal || 8), currency.decimal || 8);
+      const amountOffBN = new _util.BN(amountOff);
+      const subtotalBN = new _util.BN(subtotalUnit);
+      return _util.BN.min(amountOffBN, subtotalBN).toString();
+    }
+    return null;
+  }, [isStripePayment, hasDynamicPricing, liveRate?.rate, discounts, items, trialing, currency.decimal, currency.id]);
+  const rateDisplay = (0, _react.useMemo)(() => {
+    if (!rateInfo.exchangeRate) {
+      return null;
+    }
+    const formattedRate = (0, _util2.formatExchangeRate)(rateInfo.exchangeRate);
+    if (!formattedRate) {
+      return null;
+    }
+    if (rateInfo.baseCurrency === "USD") {
+      return `$${formattedRate}`;
+    }
+    return `${formattedRate} ${rateInfo.baseCurrency}`;
+  }, [rateInfo]);
+  const quoteLockedAt = (0, _react.useMemo)(() => extractQuoteLockedAt(paymentIntent, checkoutSession), [paymentIntent, checkoutSession]);
+  const isPriceLocked = (0, _react.useMemo)(() => {
+    if (!quoteLockedAt) return false;
+    const now = Math.floor(Date.now() / 1e3);
+    const lockRemaining = quoteLockedAt + 180 - now;
+    return lockRemaining > 0;
+  }, [quoteLockedAt]);
+  const lockExpired = (0, _react.useMemo)(() => {
+    if (!quoteLockedAt) return false;
+    const now = Math.floor(Date.now() / 1e3);
+    const lockRemaining = quoteLockedAt + 180 - now;
+    return lockRemaining <= 0;
+  }, [quoteLockedAt]);
+  const currentSlippagePercent = (0, _react.useMemo)(() => {
+    let slippageValue = quoteMeta?.slippagePercent;
+    if (slippageValue === null || slippageValue === void 0) {
+      slippageValue = slippageConfig?.percent ?? checkoutSession?.metadata?.slippage?.percent ?? checkoutSession?.slippage_percent;
+    }
+    if (slippageValue === null || slippageValue === void 0) {
+      slippageValue = 0.5;
+    }
+    return slippageValue;
+  }, [quoteMeta?.slippagePercent, slippageConfig?.percent, checkoutSession]);
+  const providerDisplay = (0, _react.useMemo)(() => {
+    const fallback = "\u2014";
+    if (liveRate?.provider_display) {
+      return liveRate.provider_display;
+    }
+    if (!rateInfo.providerName && !rateInfo.providerId) {
+      return fallback;
+    }
+    return rateInfo.providerName || rateInfo.providerId || fallback;
+  }, [liveRate?.provider_display, rateInfo.providerName, rateInfo.providerId]);
+  const formatTotalDisplay = (totalAmountValue, fallback = "\u2014") => {
+    if (hasDynamicPricing && calculatedTokenAmount) {
+      const displayAmount = (0, _util.fromUnitToToken)(calculatedTokenAmount, currency.decimal);
+      const numericValue2 = Number(displayAmount);
+      if (Number.isFinite(numericValue2)) {
+        return (0, _util2.formatDynamicPrice)(displayAmount, true, 6);
+      }
+    }
+    if (hasDynamicPricing && liveQuoteSnapshot?.quoted_amount) {
+      const snapshotAmount = (0, _util.fromUnitToToken)(liveQuoteSnapshot.quoted_amount, currency.decimal);
+      const numericValue2 = Number(snapshotAmount);
+      if (Number.isFinite(numericValue2)) {
+        return (0, _util2.formatDynamicPrice)(snapshotAmount, true, 6);
+      }
+    }
+    if (totalAmountValue === null || totalAmountValue === void 0 || totalAmountValue === "") {
+      return fallback;
+    }
+    const numericValue = Number(totalAmountValue);
+    if (!Number.isFinite(numericValue)) {
+      return fallback;
+    }
+    return (0, _util2.formatDynamicPrice)(totalAmountValue, hasDynamicPricing, 6);
+  };
+  const calculateUsdDisplay = totalAmountValue => {
+    const fallback = "\u2014";
+    if (!hasDynamicPricing || !totalAmountValue || totalAmountValue === fallback) {
+      return null;
+    }
+    const numericValue = Number(totalAmountValue);
+    if (!Number.isFinite(numericValue) || numericValue < 0) {
+      return null;
+    }
+    if (numericValue === 0) {
+      return (0, _util2.formatUsdAmount)("0", locale);
+    }
+    const {
+      exchangeRate
+    } = rateInfo;
+    if (!exchangeRate) {
+      return null;
+    }
+    const totalAmountInUnits = (0, _util.fromTokenToUnit)(totalAmountValue, currency.decimal);
+    const totalUsd = (0, _util2.getUsdAmountFromTokenUnits)(new _util.BN(totalAmountInUnits), currency.decimal, exchangeRate);
+    if (!totalUsd) {
+      return null;
+    }
+    return (0, _util2.formatUsdAmount)(totalUsd, locale);
+  };
+  const buildQuoteDetailRows = t => {
+    if (!hasDynamicPricing) {
+      return [];
+    }
+    const rows = [];
+    const fallback = "\u2014";
+    if (rateDisplay) {
+      const displayTimestamp = rateInfo.fetchedAt || rateInfo.timestampMs;
+      const updatedAt = displayTimestamp ? (0, _util2.formatDateTime)(displayTimestamp) : fallback;
+      rows.push({
+        label: t("payment.checkout.quote.detailProvider"),
+        value: providerDisplay
+      }, {
+        label: t("payment.checkout.quote.detailUpdatedAt"),
+        value: updatedAt
+      });
+    }
+    if (isSubscription) {
+      let slippageDisplay = `${currentSlippagePercent}%`;
+      if (slippageConfig?.mode === "rate" && slippageConfig.min_acceptable_rate) {
+        const formattedRate = (0, _util2.formatExchangeRate)(slippageConfig.min_acceptable_rate);
+        const displayRate = formattedRate || slippageConfig.min_acceptable_rate;
+        const displayCurrency = slippageConfig.base_currency || rateInfo.baseCurrency || "USD";
+        const displayText = displayCurrency === "USD" ? `$${displayRate}` : `${displayRate} ${displayCurrency}`;
+        slippageDisplay = `${displayText}`;
+      }
+      rows.push({
+        label: t("payment.checkout.quote.detailSlippage"),
+        value: slippageDisplay,
+        isSlippage: true,
+        tooltip: t("payment.checkout.quote.slippage.tooltip")
+      });
+    }
+    return rows;
+  };
+  return {
+    // Flags
+    hasDynamicPricing,
+    isPriceLocked,
+    lockExpired,
+    // Data
+    quoteMeta,
+    rateInfo,
+    quoteLockedAt,
+    calculatedTokenAmount,
+    calculatedDiscountAmount,
+    currentSlippagePercent,
+    // Display helpers
+    rateDisplay,
+    providerDisplay,
+    formatTotalDisplay,
+    calculateUsdDisplay,
+    buildQuoteDetailRows
+  };
+}
+module.exports = useDynamicPricing;

package/lib/index.d.ts

@@ -26,6 +26,8 @@ import StripeForm from './payment/form/stripe';
 import Payment from './payment/index';
 import ProductSkeleton from './payment/product-skeleton';
 import PaymentSummary from './payment/summary';
+import PromotionSection from './payment/summary-section/promotion-section';
+import TotalSection from './payment/summary-section/total-section';
 import PricingItem from './components/pricing-item';
 import CountrySelect from './components/country-select';
 import TruncatedText from './components/truncated-text';
@@ -42,6 +44,8 @@ import AutoTopup from './components/auto-topup';
 import Collapse from './components/collapse';
 import PromotionCode from './components/promotion-code';
 import SourceDataViewer from './components/source-data-viewer';
+import SlippageConfig from './components/slippage-config';
+import DynamicPricingUnavailable from './components/dynamic-pricing-unavailable';
 export { PaymentThemeProvider } from './theme';
 export * from './libs/util';
 export * from './libs/connect';
@@ -56,6 +60,7 @@ export * from './hooks/scroll';
 export * from './hooks/keyboard';
 export * from './libs/validator';
 export { translations, createTranslator } from './locales';
-export { createLazyComponent, api, dayjs, FormInput, FormLabel, PhoneInput, AddressForm, StripeForm, Status, Livemode, Switch, ConfirmDialog, CheckoutForm, CheckoutTable, CheckoutDonate, CurrencySelector, Payment, PaymentSummary, PricingTable, ProductSkeleton, Amount, CustomerInvoiceList, CustomerPaymentList, TxLink, TxGas, SafeGuard, PricingItem, CountrySelect, Table, TruncatedText, Link, OverdueInvoicePayment, StripePaymentAction, PaymentBeneficiaries, LoadingButton, DonateDetails, ResumeSubscription, CreditGrantsList, CreditTransactionsList, DateRangePicker, CreditStatusChip, AutoTopupModal, AutoTopup, Collapse, PromotionCode, SourceDataViewer, };
+export { createLazyComponent, api, dayjs, FormInput, FormLabel, PhoneInput, AddressForm, StripeForm, Status, Livemode, Switch, ConfirmDialog, CheckoutForm, CheckoutTable, CheckoutDonate, CurrencySelector, Payment, PaymentSummary, PricingTable, ProductSkeleton, Amount, CustomerInvoiceList, CustomerPaymentList, TxLink, TxGas, SafeGuard, PricingItem, CountrySelect, Table, TruncatedText, Link, OverdueInvoicePayment, StripePaymentAction, PaymentBeneficiaries, LoadingButton, DonateDetails, ResumeSubscription, CreditGrantsList, CreditTransactionsList, DateRangePicker, CreditStatusChip, AutoTopupModal, AutoTopup, Collapse, PromotionCode, SourceDataViewer, SlippageConfig, DynamicPricingUnavailable, PromotionSection, TotalSection, };
 export type { CountrySelectProps } from './components/country-select';
 export type { StripePaymentActionProps } from './components/stripe-payment-action';
+export type { SlippageConfigValue, SlippageConfigProps } from './components/slippage-config';

package/lib/index.js

@@ -34,6 +34,8 @@ var _exportNames = {
   Payment: true,
   ProductSkeleton: true,
   PaymentSummary: true,
+  PromotionSection: true,
+  TotalSection: true,
   PricingItem: true,
   CountrySelect: true,
   TruncatedText: true,
@@ -50,6 +52,8 @@ var _exportNames = {
   Collapse: true,
   PromotionCode: true,
   SourceDataViewer: true,
+  SlippageConfig: true,
+  DynamicPricingUnavailable: true,
   PaymentThemeProvider: true,
   translations: true,
   createTranslator: true
@@ -162,6 +166,12 @@ Object.defineProperty(exports, "DonateDetails", {
     return _donate.DonateDetails;
   }
 });
+Object.defineProperty(exports, "DynamicPricingUnavailable", {
+  enumerable: true,
+  get: function () {
+    return _dynamicPricingUnavailable.default;
+  }
+});
 Object.defineProperty(exports, "FormInput", {
   enumerable: true,
   get: function () {
@@ -252,6 +262,12 @@ Object.defineProperty(exports, "PromotionCode", {
     return _promotionCode.default;
   }
 });
+Object.defineProperty(exports, "PromotionSection", {
+  enumerable: true,
+  get: function () {
+    return _promotionSection.default;
+  }
+});
 Object.defineProperty(exports, "ResumeSubscription", {
   enumerable: true,
   get: function () {
@@ -264,6 +280,12 @@ Object.defineProperty(exports, "SafeGuard", {
     return _safeGuard.default;
   }
 });
+Object.defineProperty(exports, "SlippageConfig", {
+  enumerable: true,
+  get: function () {
+    return _slippageConfig.default;
+  }
+});
 Object.defineProperty(exports, "SourceDataViewer", {
   enumerable: true,
   get: function () {
@@ -300,6 +322,12 @@ Object.defineProperty(exports, "Table", {
     return _table2.default;
   }
 });
+Object.defineProperty(exports, "TotalSection", {
+  enumerable: true,
+  get: function () {
+    return _totalSection.default;
+  }
+});
 Object.defineProperty(exports, "TruncatedText", {
   enumerable: true,
   get: function () {
@@ -376,6 +404,8 @@ var _stripe = _interopRequireDefault(require("./payment/form/stripe"));
 var _index = _interopRequireDefault(require("./payment/index"));
 var _productSkeleton = _interopRequireDefault(require("./payment/product-skeleton"));
 var _summary = _interopRequireDefault(require("./payment/summary"));
+var _promotionSection = _interopRequireDefault(require("./payment/summary-section/promotion-section"));
+var _totalSection = _interopRequireDefault(require("./payment/summary-section/total-section"));
 var _pricingItem = _interopRequireDefault(require("./components/pricing-item"));
 var _countrySelect = _interopRequireDefault(require("./components/country-select"));
 var _truncatedText = _interopRequireDefault(require("./components/truncated-text"));
@@ -392,6 +422,8 @@ var _autoTopup = _interopRequireDefault(require("./components/auto-topup"));
 var _collapse = _interopRequireDefault(require("./components/collapse"));
 var _promotionCode = _interopRequireDefault(require("./components/promotion-code"));
 var _sourceDataViewer = _interopRequireDefault(require("./components/source-data-viewer"));
+var _slippageConfig = _interopRequireDefault(require("./components/slippage-config"));
+var _dynamicPricingUnavailable = _interopRequireDefault(require("./components/dynamic-pricing-unavailable"));
 var _theme = require("./theme");
 var _util = require("./libs/util");
 Object.keys(_util).forEach(function (key) {

package/lib/libs/util.d.ts

@@ -1,4 +1,5 @@
 import type { PaymentDetails, PriceCurrency, PriceRecurring, TCoupon, TInvoiceExpanded, TLineItemExpanded, TPaymentCurrency, TPaymentCurrencyExpanded, TPaymentMethod, TPaymentMethodExpanded, TPrice, TProductExpanded, TSubscriptionExpanded, TSubscriptionItemExpanded } from '@blocklet/payment-types';
+import { BN } from '@ocap/util';
 import type { ActionProps, PricingRenderProps } from '../types';
 export declare const PAYMENT_KIT_DID = "z2qaCNvKMv5GjouKdcDWexv6WqtHbpNPQDnAk";
 /**
@@ -38,15 +39,45 @@ export declare function formatCreditAmount(formattedAmount: string, currencySymb
  */
 export declare function formatCreditForCheckout(formattedAmount: string, currencySymbol: string, locale?: string, showUnit?: boolean): string;
 export declare function formatNumber(n: number | string, precision?: number, trim?: boolean, thousandSeparated?: boolean): string;
+export declare function formatDynamicPrice(n: number | string, isDynamic: boolean, precision?: number, trim?: boolean, thousandSeparated?: boolean): string;
+export declare function getUsdAmountFromBaseAmount(amount: string | number | undefined, quantity: number, scale?: number): string | null;
+export declare function getUsdAmountFromTokenUnits(tokenAmount: BN | string, tokenDecimals: number, exchangeRate?: string | null): string | null;
+export declare function formatUsdAmount(amount: string | null, locale?: string): string | null;
+export declare function formatExchangeRate(amount: string | null): string | null;
+/**
+ * Format exchange rate with currency symbol for display
+ * @param rate - The exchange rate value
+ * @param currency - The currency code (default: 'USD')
+ * @param decimals - Number of decimal places (default: 2, use 4 for live exchange rates)
+ * @returns Formatted string like "$0.12" for USD, or "0.12 EUR" for other currencies
+ */
+export declare function formatExchangeRateDisplay(rate: string | number | null | undefined, currency?: string, decimals?: number): string | null;
 export declare const formatPrice: (price: TPrice, currency: TPaymentCurrency, unit_label?: string, quantity?: number, bn?: boolean, locale?: string) => string;
-export declare const formatPriceAmount: (price: TPrice, currency: TPaymentCurrency, unit_label?: string, quantity?: number, bn?: boolean) => string;
+export declare const formatPriceAmount: (price: TPrice, currency: TPaymentCurrency, unit_label?: string, quantity?: number, bn?: boolean, locale?: string) => string;
 export declare function getStatementDescriptor(items: any[]): any;
 export declare function formatRecurring(recurring: PriceRecurring, translate?: boolean, separator?: string, locale?: string): string;
 export declare function getPriceUintAmountByCurrency(price: TPrice, currency: TPaymentCurrency): string;
 export declare function getPriceCurrencyOptions(price: TPrice): PriceCurrency[];
-export declare function formatLineItemPricing(item: TLineItemExpanded, currency: TPaymentCurrency, { trialEnd, trialInDays }: {
+export declare function getLineItemAmounts(item: TLineItemExpanded, currency: TPaymentCurrency, { useUpsell, exchangeRate }?: {
+    useUpsell?: boolean;
+    exchangeRate?: string | null;
+}): {
+    unitAmount: BN;
+    totalAmount: BN;
+    isDynamicQuote: boolean;
+};
+export type QuoteLockInfo = {
+    baseAmount: string;
+    baseCurrency: string;
+    tokenAmount: string;
+    tokenSymbol: string;
+    expiresAt: number | null;
+};
+export declare function getQuoteLockInfo(items: TLineItemExpanded[], currency?: TPaymentCurrency | null): QuoteLockInfo | null;
+export declare function formatLineItemPricing(item: TLineItemExpanded, currency: TPaymentCurrency, { trialEnd, trialInDays, exchangeRate, }: {
     trialEnd: number;
     trialInDays: number;
+    exchangeRate?: string | null;
 }, locale?: string): {
     primary: string;
     secondary?: string;
@@ -58,7 +89,9 @@ export declare function getRefundStatusColor(status: string): "default" | "succe
 export declare function getPayoutStatusColor(status: string): "default" | "success" | "warning";
 export declare function getInvoiceStatusColor(status: string): "default" | "success" | "warning" | "secondary";
 export declare function getWebhookStatusColor(status: string): "default" | "success";
-export declare function getCheckoutAmount(items: TLineItemExpanded[], currency: TPaymentCurrency, trialing?: boolean, upsell?: boolean): {
+export declare function getCheckoutAmount(items: TLineItemExpanded[], currency: TPaymentCurrency, trialing?: boolean, upsell?: boolean, { exchangeRate }?: {
+    exchangeRate?: string | null;
+}): {
     subtotal: any;
     total: any;
     renew: string;
@@ -69,6 +102,7 @@ export declare function getCheckoutAmount(items: TLineItemExpanded[], currency:
 export declare function getRecurringPeriod(recurring: PriceRecurring): number;
 export declare function formatUpsellSaving(items: TLineItemExpanded[], currency: TPaymentCurrency): string;
 export declare function formatMeteredThen(subscription: string, recurring: string, hasMetered: boolean, locale?: string): string;
+export declare function formatThenValue(subscription: string, recurring: string, hasMetered: boolean, locale?: string): string;
 export declare function formatPriceDisplay({ amount, then, actualAmount, showThen }: {
     amount: string;
     then?: string;
@@ -86,16 +120,19 @@ export declare function getFreeTrialTime({ trialInDays, trialEnd }: {
 export declare function formatCheckoutHeadlines(items: TLineItemExpanded[], currency: TPaymentCurrency, { trialInDays, trialEnd }: {
     trialInDays: number;
     trialEnd: number;
-}, locale?: string): {
+}, locale?: string, { exchangeRate }?: {
+    exchangeRate?: string | null;
+}): {
     action: string;
     amount: string;
     then?: string;
+    thenValue?: string;
     secondary?: string;
     showThen?: boolean;
     actualAmount: string;
     priceDisplay: string;
 };
-export declare function formatAmount(amount: string, decimals: number): string;
+export declare function formatAmount(amount: string, decimals: number, precision?: number): string;
 export declare function findCurrency(methods: TPaymentMethodExpanded[], currencyId: string): TPaymentCurrencyExpanded | null;
 export declare function isValidCountry(code: string): boolean;
 export declare function stopEvent(e: React.SyntheticEvent<any>): void;