Getting Started

import { evaluateNaturalExpression, fetchExchangeRates, prettyPrint } from '@aliraslan/fx';

// any endpoint returning { data: { rates: { [code]: string } } } works —
// Coinbase's public, unauthenticated /v2/exchange-rates is one example
const rates = await fetchExchangeRates('https://api.coinbase.com/v2/exchange-rates', 'USD');
const { value } = evaluateNaturalExpression('100 eur + 20', 'USD', rates);

prettyPrint(value); // "$128.70"

import { prettyPrint } from '@aliraslan/fx';
import { useCurrency } from '@aliraslan/fx/react';

function Calculator() {
  const { evaluate, baseCurrency, setBaseCurrency } = useCurrency({
    endpoint: 'https://your-rate-provider.example/rates',
  });

  const result = evaluate('50k jpy');
  return <p>{prettyPrint(result.value)}</p>;
}