Currencies

bun add @talosjs/currencies

import { CURRENCIES } from "@talosjs/currencies";
import type { CurrencyCodeType } from "@talosjs/currencies";

const usd = CURRENCIES.find((c) => c.code === "USD");
// { code: "USD", name: "US Dollar", icon: "🇺🇸", symbol: "$" }

const code: CurrencyCodeType = "EUR"; // typed against the dataset

import { CurrencyConverter } from "@talosjs/currencies";

const converter = new CurrencyConverter("USD", {
  EUR: 0.92,
  GBP: 0.79,
});

// Add or update rates later (chainable)
converter.setRate("JPY", 157.3).setRates({ CAD: 1.36 });

const conversion = converter.convert(100, "USD", "EUR");
// { from: "USD", to: "EUR", amount: 100, result: 92, rate: 0.92 }

const rate = converter.getRate("GBP"); // 0.79
const supported = converter.getSupportedCurrencies(); // ["USD", "EUR", "GBP", "JPY", "CAD"]

import { CurrencyConverter } from "@talosjs/currencies";

const converter = new CurrencyConverter("USD", { EUR: 0.92 });

converter.format(1234.5, "USD");                  // "$1234.50"
converter.convertAndFormat(100, "USD", "EUR");    // "€92.00"
converter.convertAndFormat(100, "USD", "EUR", 0); // "€92"