@blocklet/payment-react 1.24.4 → 1.25.0

package/es/history/invoice/list.js

@@ -8,21 +8,26 @@ import { useInfiniteScroll, useRequest, useSetState } from "ahooks";
 import React, { useEffect, useRef, useState } from "react";
 import { useNavigate } from "react-router-dom";
 import debounce from "lodash/debounce";
+import { BN } from "@ocap/util";
 import Status from "../../components/status.js";
 import { usePaymentContext } from "../../contexts/payment.js";
 import { useSubscription } from "../../hooks/subscription.js";
 import api from "../../libs/api.js";
 import StripePaymentAction from "../../components/stripe-payment-action.js";
 import {
-  formatBNStr,
   formatCreditAmount,
   formatError,
   formatToDate,
   formatToDatetime,
+  formatTime,
+  formatExchangeRate,
   getInvoiceDescriptionAndReason,
   getInvoiceStatusColor,
   getTxLink,
-  isCrossOrigin
+  isCrossOrigin,
+  getUsdAmountFromTokenUnits,
+  formatUsdAmount,
+  formatAmount
 } from "../../libs/util.js";
 import Table from "../../components/table.js";
 import { createLink, handleNavigation } from "../../libs/navigation.js";
@@ -39,13 +44,24 @@ const groupByDate = (items) => {
 };
 const fetchData = (params = {}) => {
   const search = new URLSearchParams();
-  Object.keys(params).forEach((key) => {
-    if (params[key]) {
-      search.set(key, String(params[key]));
+  const mergedParams = { include_quote: true, ...params };
+  Object.keys(mergedParams).forEach((key) => {
+    if (mergedParams[key]) {
+      search.set(key, String(mergedParams[key]));
     }
   });
   return api.get(`/api/invoices?${search.toString()}`).then((res) => res.data);
 };
+const getInvoiceQuoteInfo = (invoice) => {
+  const lines = invoice.lines || [];
+  for (const line of lines) {
+    const quote = line.metadata?.quote;
+    if (quote?.exchange_rate) {
+      return quote;
+    }
+  }
+  return null;
+};
 const getInvoiceLink = (invoice, action) => {
   if (invoice.id.startsWith("in_")) {
     const path = `/customer/invoice/${invoice.id}${invoice.status === "uncollectible" && action ? `?action=${action}` : ""}`;
@@ -155,10 +171,98 @@ const InvoiceTable = React.memo((props) => {
         customBodyRenderLite: (_, index) => {
           const invoice = data?.list[index];
           const isVoid = invoice.status === "void";
-          return /* @__PURE__ */ jsx(Box, { onClick: (e) => handleLinkClick(e, invoice), sx: linkStyle, children: /* @__PURE__ */ jsxs(Typography, { sx: isVoid ? { textDecoration: "line-through" } : {}, children: [
-            formatBNStr(invoice.total, invoice.paymentCurrency.decimal),
-            "\xA0",
-            invoice.paymentCurrency.symbol
+          const quoteInfo = getInvoiceQuoteInfo(invoice);
+          const providers = quoteInfo?.providers || [];
+          const providerNames = providers.map((provider) => provider.provider_name).filter(Boolean);
+          const providerDisplay = providerNames.length > 0 ? providerNames.join(", ") : quoteInfo?.rate_provider_name || quoteInfo?.rate_provider_id || "\u2014";
+          const providerRates = quoteInfo?.providers?.map((provider) => {
+            const name = provider.provider_name || provider.provider_id || "\u2014";
+            return provider.rate ? `${name}` : name;
+          }).filter(Boolean) || [];
+          const rateTimestamp = quoteInfo?.rate_timestamp_ms ? formatTime(quoteInfo.rate_timestamp_ms) : "\u2014";
+          const formattedRate = formatExchangeRate(quoteInfo?.exchange_rate || null);
+          const rateLine = formattedRate ? (() => {
+            const currencyMap = {
+              USD: "$",
+              CNY: "\xA5"
+            };
+            const currencySymbol = currencyMap[quoteInfo?.base_currency];
+            return `1 ${invoice.paymentCurrency.symbol} \u2248 ${currencySymbol ? `${currencySymbol}${formattedRate}` : `${formattedRate} ${quoteInfo?.base_currency || "USD"}`}`;
+          })() : null;
+          let usdAmount = null;
+          if (quoteInfo?.base_amount) {
+            usdAmount = formatUsdAmount(quoteInfo.base_amount, locale);
+          } else if (quoteInfo?.exchange_rate && invoice.total) {
+            const calculatedUsd = getUsdAmountFromTokenUnits(
+              new BN(invoice.total),
+              invoice.paymentCurrency.decimal,
+              quoteInfo.exchange_rate
+            );
+            if (calculatedUsd) {
+              usdAmount = formatUsdAmount(calculatedUsd, locale);
+            }
+          }
+          const tooltipContent = quoteInfo ? /* @__PURE__ */ jsxs(Stack, { spacing: 0.5, sx: { p: 1 }, children: [
+            /* @__PURE__ */ jsxs(Stack, { direction: "row", justifyContent: "space-between", spacing: 2, children: [
+              /* @__PURE__ */ jsxs(Typography, { variant: "caption", sx: { color: "text.secondary" }, children: [
+                t("payment.customer.invoice.quote.providers"),
+                ":"
+              ] }),
+              /* @__PURE__ */ jsx(Typography, { variant: "caption", sx: { color: "text.primary" }, children: (providerRates.length > 0 ? providerRates.join(", ") : providerDisplay) || "\u2014" })
+            ] }),
+            rateLine && /* @__PURE__ */ jsxs(Stack, { direction: "row", justifyContent: "space-between", spacing: 2, children: [
+              /* @__PURE__ */ jsxs(Typography, { variant: "caption", sx: { color: "text.secondary" }, children: [
+                t("payment.customer.invoice.quote.exchangeRate"),
+                ":"
+              ] }),
+              /* @__PURE__ */ jsx(Typography, { variant: "caption", sx: { color: "text.primary" }, children: rateLine })
+            ] }),
+            /* @__PURE__ */ jsxs(Stack, { direction: "row", justifyContent: "space-between", spacing: 2, children: [
+              /* @__PURE__ */ jsxs(Typography, { variant: "caption", sx: { color: "text.secondary" }, children: [
+                t("payment.customer.invoice.quote.rateTimestamp"),
+                ":"
+              ] }),
+              /* @__PURE__ */ jsx(Typography, { variant: "caption", sx: { color: "text.primary" }, children: rateTimestamp })
+            ] })
+          ] }) : null;
+          return /* @__PURE__ */ jsx(Box, { onClick: (e) => handleLinkClick(e, invoice), sx: linkStyle, children: /* @__PURE__ */ jsxs(Stack, { spacing: 0.25, alignItems: "flex-end", children: [
+            /* @__PURE__ */ jsxs(Typography, { sx: isVoid ? { textDecoration: "line-through" } : {}, children: [
+              formatAmount(invoice.total, invoice.paymentCurrency.decimal),
+              "\xA0",
+              invoice.paymentCurrency.symbol
+            ] }),
+            (usdAmount || rateLine) && /* @__PURE__ */ jsx(
+              Tooltip,
+              {
+                title: tooltipContent,
+                placement: "top",
+                arrow: true,
+                slotProps: {
+                  tooltip: {
+                    sx: {
+                      backgroundColor: "background.paper",
+                      boxShadow: 1
+                    }
+                  }
+                },
+                children: /* @__PURE__ */ jsx(Stack, { spacing: 0.25, alignItems: "flex-end", children: usdAmount && /* @__PURE__ */ jsxs(
+                  Typography,
+                  {
+                    variant: "caption",
+                    sx: {
+                      color: "text.secondary",
+                      fontSize: "0.75rem",
+                      fontWeight: 400,
+                      lineHeight: 1.2
+                    },
+                    children: [
+                      "\u2248 $",
+                      usdAmount
+                    ]
+                  }
+                ) })
+              }
+            )
           ] }) });
         }
       }
@@ -520,6 +624,9 @@ const InvoiceList = React.memo((props) => {
       invoices.map((invoice) => {
         const { link, connect } = getInvoiceLink(invoice, action);
         const isVoid = invoice.status === "void";
+        const quoteInfo = getInvoiceQuoteInfo(invoice);
+        const formattedRate = formatExchangeRate(quoteInfo?.exchange_rate || null);
+        const rateLine = formattedRate ? `1 ${invoice.paymentCurrency.symbol} \u2248 ${formattedRate} ${quoteInfo?.base_currency || "USD"}` : null;
         return /* @__PURE__ */ jsxs(
           Stack,
           {
@@ -575,18 +682,21 @@ const InvoiceList = React.memo((props) => {
                   )
                 }
               ),
-              /* @__PURE__ */ jsx(
+              /* @__PURE__ */ jsxs(
                 Box,
                 {
                   sx: {
                     flex: 1,
                     textAlign: "right"
                   },
-                  children: /* @__PURE__ */ jsxs(Typography, { sx: isVoid ? { textDecoration: "line-through" } : {}, children: [
-                    formatBNStr(invoice.total, invoice.paymentCurrency.decimal),
-                    "\xA0",
-                    invoice.paymentCurrency.symbol
-                  ] })
+                  children: [
+                    /* @__PURE__ */ jsxs(Typography, { sx: isVoid ? { textDecoration: "line-through" } : {}, children: [
+                      formatAmount(invoice.total, invoice.paymentCurrency.decimal),
+                      "\xA0",
+                      invoice.paymentCurrency.symbol
+                    ] }),
+                    rateLine && /* @__PURE__ */ jsx(Typography, { variant: "caption", sx: { color: "text.secondary", display: "block" }, children: rateLine })
+                  ]
                 }
               ),
               /* @__PURE__ */ jsx(

package/es/hooks/dynamic-pricing.d.ts

@@ -0,0 +1,102 @@
+/**
+ * useDynamicPricing Hook
+ *
+ * Extracts and centralizes all dynamic pricing related calculations
+ * for the checkout summary component.
+ *
+ * Final Freeze Architecture: Quotes are created at Submit time only.
+ * This hook handles preview-time display calculations.
+ */
+import type { TCheckoutSession, TLineItemExpanded, TPaymentCurrency, TPaymentIntent } from '@blocklet/payment-types';
+export interface LiveRateInfo {
+    rate?: string;
+    provider_id?: string;
+    provider_name?: string;
+    provider_display?: string;
+    base_currency?: string;
+    timestamp_ms?: number;
+    fetched_at?: number;
+}
+export interface LiveQuoteSnapshot {
+    id: string;
+    quoted_amount: string;
+    exchange_rate: string;
+    expires_at: number;
+    rate_timestamp_ms?: number | null;
+    renewed?: boolean;
+}
+export interface DiscountInfo {
+    promotion_code?: string;
+    coupon?: string;
+    discount_amount?: string;
+    coupon_details?: {
+        percent_off?: number;
+        amount_off?: string;
+        currency_id?: string;
+        currency_options?: Record<string, {
+            amount_off?: string;
+        }>;
+    };
+}
+export interface DynamicPricingOptions {
+    items: TLineItemExpanded[];
+    currency: TPaymentCurrency;
+    liveRate?: LiveRateInfo;
+    liveQuoteSnapshot?: LiveQuoteSnapshot;
+    checkoutSession?: TCheckoutSession;
+    paymentIntent?: TPaymentIntent | null;
+    locale?: string;
+    isStripePayment?: boolean;
+    isSubscription?: boolean;
+    slippageConfig?: {
+        mode?: 'percent' | 'rate';
+        percent?: number | null;
+        min_acceptable_rate?: string;
+        base_currency?: string;
+    };
+    trialInDays?: number;
+    trialEnd?: number;
+    discounts?: DiscountInfo[];
+}
+export interface RateInfo {
+    exchangeRate: string | null;
+    baseCurrency: string;
+    providerName: string | null;
+    providerId: string | null;
+    timestampMs: number | null;
+    fetchedAt: number | null;
+}
+export interface QuoteMeta {
+    exchangeRate: string | null;
+    baseCurrency: string;
+    expiresAt: number | null;
+    providerName: string | null;
+    providerId: string | null;
+    rateTimestampMs: number | null;
+    slippagePercent: number | null;
+}
+/**
+ * Custom hook for dynamic pricing calculations
+ */
+export declare function useDynamicPricing(options: DynamicPricingOptions): {
+    hasDynamicPricing: boolean;
+    isPriceLocked: boolean;
+    lockExpired: boolean;
+    quoteMeta: QuoteMeta | null;
+    rateInfo: RateInfo;
+    quoteLockedAt: number | null;
+    calculatedTokenAmount: string | null;
+    calculatedDiscountAmount: any;
+    currentSlippagePercent: number;
+    rateDisplay: string | null;
+    providerDisplay: string;
+    formatTotalDisplay: (totalAmountValue: string, fallback?: string) => string;
+    calculateUsdDisplay: (totalAmountValue: string) => string | null;
+    buildQuoteDetailRows: (t: (key: string) => string) => {
+        label: string;
+        value: string | React.ReactNode;
+        isSlippage?: boolean;
+        tooltip?: string;
+    }[];
+};
+export default useDynamicPricing;

package/es/hooks/dynamic-pricing.js

@@ -0,0 +1,393 @@
+import { useMemo } from "react";
+import { BN, fromTokenToUnit, fromUnitToToken } from "@ocap/util";
+import {
+  formatDateTime,
+  formatDynamicPrice,
+  formatExchangeRate,
+  formatUsdAmount,
+  getUsdAmountFromTokenUnits
+} from "../libs/util.js";
+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 = 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;
+}
+export 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 = useMemo(
+    () => items.some((item) => (item.upsell_price || item.price)?.pricing_type === "dynamic"),
+    [items]
+  );
+  const quoteMeta = useMemo(() => hasDynamicPricing ? extractQuoteMeta(items) : null, [items, hasDynamicPricing]);
+  const rateInfo = 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 = 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 = 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 = 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 = fromTokenToUnit(discountableSubtotal.toFixed(currency.decimal || 8), currency.decimal || 8);
+      const amountOffBN = new BN(amountOff);
+      const subtotalBN = new BN(subtotalUnit);
+      return BN.min(amountOffBN, subtotalBN).toString();
+    }
+    return null;
+  }, [isStripePayment, hasDynamicPricing, liveRate?.rate, discounts, items, trialing, currency.decimal, currency.id]);
+  const rateDisplay = useMemo(() => {
+    if (!rateInfo.exchangeRate) {
+      return null;
+    }
+    const formattedRate = formatExchangeRate(rateInfo.exchangeRate);
+    if (!formattedRate) {
+      return null;
+    }
+    if (rateInfo.baseCurrency === "USD") {
+      return `$${formattedRate}`;
+    }
+    return `${formattedRate} ${rateInfo.baseCurrency}`;
+  }, [rateInfo]);
+  const quoteLockedAt = useMemo(
+    () => extractQuoteLockedAt(paymentIntent, checkoutSession),
+    [paymentIntent, checkoutSession]
+  );
+  const isPriceLocked = useMemo(() => {
+    if (!quoteLockedAt) return false;
+    const now = Math.floor(Date.now() / 1e3);
+    const lockRemaining = quoteLockedAt + 180 - now;
+    return lockRemaining > 0;
+  }, [quoteLockedAt]);
+  const lockExpired = useMemo(() => {
+    if (!quoteLockedAt) return false;
+    const now = Math.floor(Date.now() / 1e3);
+    const lockRemaining = quoteLockedAt + 180 - now;
+    return lockRemaining <= 0;
+  }, [quoteLockedAt]);
+  const currentSlippagePercent = 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 = 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 = fromUnitToToken(calculatedTokenAmount, currency.decimal);
+      const numericValue2 = Number(displayAmount);
+      if (Number.isFinite(numericValue2)) {
+        return formatDynamicPrice(displayAmount, true, 6);
+      }
+    }
+    if (hasDynamicPricing && liveQuoteSnapshot?.quoted_amount) {
+      const snapshotAmount = fromUnitToToken(liveQuoteSnapshot.quoted_amount, currency.decimal);
+      const numericValue2 = Number(snapshotAmount);
+      if (Number.isFinite(numericValue2)) {
+        return formatDynamicPrice(snapshotAmount, true, 6);
+      }
+    }
+    if (totalAmountValue === null || totalAmountValue === void 0 || totalAmountValue === "") {
+      return fallback;
+    }
+    const numericValue = Number(totalAmountValue);
+    if (!Number.isFinite(numericValue)) {
+      return fallback;
+    }
+    return 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 formatUsdAmount("0", locale);
+    }
+    const { exchangeRate } = rateInfo;
+    if (!exchangeRate) {
+      return null;
+    }
+    const totalAmountInUnits = fromTokenToUnit(totalAmountValue, currency.decimal);
+    const totalUsd = getUsdAmountFromTokenUnits(new BN(totalAmountInUnits), currency.decimal, exchangeRate);
+    if (!totalUsd) {
+      return null;
+    }
+    return 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 ? 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 = 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
+  };
+}
+export default useDynamicPricing;