Money

1// Money formatting for API amounts that carry no formatted string. Copy as-is.
2//
3// Catalog prices come with a ready `formattedAmount` — use that directly. But eCom Cart V2
4// amounts are ConvertedMoney `{ amount, convertedAmount }` with NO formatted string, and the
5// currency lives on the cart, not on the money object. Never hardcode "$" or assume USD.
6export interface ConvertedMoneyLike {
7  amount?: string | null;
8  convertedAmount?: string | null;
9}
10
11/** Format a ConvertedMoney in the given currency, using the visitor's locale. */
12export function formatMoney(
13  money: ConvertedMoneyLike | null | undefined,
14  currencyCode: string | null | undefined,
15): string {
16  const value = money?.convertedAmount ?? money?.amount;
17  if (value == null || value === "") return "";
18  const currency = currencyCode || "USD";
19  try {
20    return new Intl.NumberFormat(undefined, { style: "currency", currency }).format(Number(value));
21  } catch {
22    return `${value} ${currency}`;
23  }
24}