@ducatjs/money 0.0.0 → 0.2.0

package/dist/cash.js

@@ -0,0 +1,134 @@
+import { CASH_RULES } from './generated/cash.js';
+import { CurrencyMismatchError, make, scaleUp, toScale, } from './money.js';
+import { roundingPolicy } from './policy.js';
+import { divideAndRound, divideAndRoundBigint } from './rounding.js';
+import { currencyExponent } from './currency.js';
+/**
+ * Rounds to a multiple of `increment` (same currency): roundToIncrement(CHF 10.03, CHF 0.05) = CHF
+ * 10.05. Default rounding 'halfExpand' (nearest, ties away from zero), which is what the statutory
+ * cash-rounding rules (SE, NO, DK, HU, CZ, FI, BE ...) prescribe.
+ */
+export function roundToIncrement(money, increment, rounding = 'halfExpand') {
+    if (money.currency !== increment.currency) {
+        throw new CurrencyMismatchError(money.currency, increment.currency);
+    }
+    if (!(increment.minor > 0)) {
+        throw new RangeError('increment must be positive');
+    }
+    const scale = Math.max(money.scale, increment.scale);
+    const minor = scaleUp(money.minor, scale - money.scale);
+    const step = scaleUp(increment.minor, scale - increment.scale);
+    if (typeof minor === 'number' && typeof step === 'number') {
+        const steps = divideAndRound(minor, step, rounding);
+        const rounded = steps * step;
+        if (Number.isSafeInteger(rounded)) {
+            return toScale(make(money.currency, rounded, scale), money.scale > scale ? money.scale : scale);
+        }
+    }
+    return make(money.currency, divideAndRoundBigint(BigInt(minor), BigInt(step), rounding) * BigInt(step), scale);
+}
+/**
+ * The cash-rounding rule for a currency, optionally narrowed by country (ISO 3166 alpha-2).
+ * EUR has no euro-wide rule: pass the country (BE, NL, FI, IE, IT, SK, EE, LT).
+ */
+export function cashRule(currency, country) {
+    const rules = cashRulesFor(currency);
+    if (rules === undefined) {
+        return undefined;
+    }
+    if (country !== undefined) {
+        for (let i = 0; i < rules.length; i++) {
+            if (rules[i].countries.includes(country)) {
+                return rules[i];
+            }
+        }
+        return undefined;
+    }
+    // EUR has no euro-wide rule, so it needs a country
+    if (currency === 'EUR') {
+        return undefined;
+    }
+    return rules[0];
+}
+// CASH_RULES grouped by currency, in table order. Built on first use, not at import, so the module
+// stays free of side effects; cashRound calls cashRule on every amount, and a scan of the whole table
+// was most of its cost.
+let rulesByCurrency;
+function cashRulesFor(currency) {
+    if (rulesByCurrency === undefined) {
+        rulesByCurrency = new Map();
+        for (let i = 0; i < CASH_RULES.length; i++) {
+            const rule = CASH_RULES[i];
+            const forCurrency = rulesByCurrency.get(rule.currency);
+            if (forCurrency === undefined) {
+                rulesByCurrency.set(rule.currency, [rule]);
+            }
+            else {
+                forCurrency.push(rule);
+            }
+        }
+    }
+    return rulesByCurrency.get(currency);
+}
+/**
+ * Rounds a cash total to the smallest legal/practical cash step (CHF 0.05, SEK 1, DKK 0.50, CAD
+ * 0.05, HUF 5, EUR 0.05 in BE/NL/FI/IE/...). Card and other electronic payments are NOT rounded:
+ * only call this for cash tenders. Returns m unchanged when no rule applies.
+ */
+export function cashRound(money, options) {
+    const rule = cashRule(money.currency, options?.country);
+    if (!rule || (options?.includeUnverified === false && !rule.verified)) {
+        return money;
+    }
+    const inc = make(money.currency, rule.increment, currencyExponent(money.currency));
+    return roundToIncrement(money, inc, options?.rounding ?? rule.rounding ?? 'halfExpand');
+}
+/**
+ * The cash-rounding rule for a currency as a `RoundingPolicy`, to pass wherever a rounding mode
+ * goes: `m.multiply('1.075', cashPolicy('CHF'))` rounds once, straight to CHF 0.05. The policy only
+ * accepts amounts in `currency`. Throws a RangeError when no rule applies (EUR needs a country);
+ * use `isoPolicy` for currencies without cash rounding.
+ */
+export function cashPolicy(currency, options) {
+    const rule = cashRule(currency, options?.country);
+    if (!rule || (options?.includeUnverified === false && !rule.verified)) {
+        const where = options?.country === undefined ? '' : ` in ${options.country}`;
+        throw new RangeError(`No cash-rounding rule for ${currency}${where}`);
+    }
+    return roundingPolicy({
+        scale: currencyExponent(currency),
+        increment: rule.increment,
+        rounding: options?.rounding ?? rule.rounding ?? 'halfExpand',
+        currency,
+    });
+}
+/**
+ * The number of decimals a currency's amounts are shown with: its ISO 4217 exponent, or with
+ * `{ usage: 'cash' }`, the decimals of a cash amount (what CLDR calls `cashDigits`): none when cash
+ * is rounded to whole units, the exponent otherwise.
+ *
+ *     currencyDigits('SEK')                       // 2
+ *     currencyDigits('SEK', { usage: 'cash' })    // 0: cash is rounded to whole kronor
+ *     currencyDigits('CHF', { usage: 'cash' })    // 2: CHF 0.05 still needs two decimals
+ *
+ * A currency without a cash rule (or EUR without a country that has one) takes its exponent.
+ * Throws for unknown codes, like `currencyExponent`.
+ */
+export function currencyDigits(currency, options) {
+    const exponent = currencyExponent(currency);
+    if (options?.usage !== 'cash') {
+        return exponent;
+    }
+    const rule = cashRule(currency, options.country);
+    if (!rule || (options.includeUnverified === false && !rule.verified)) {
+        return exponent;
+    }
+    // Cash amounts show no decimals once the step is whole units (SEK 1, HUF 5, UZS 50), and the
+    // currency's usual decimals otherwise: DKK 0.50 is shown as 10.50, not 10.5, as in CLDR.
+    if (rule.increment % 10 ** exponent === 0) {
+        return 0;
+    }
+    return exponent;
+}
+export { CASH_RULES };
+//# sourceMappingURL=cash.js.map

package/dist/cash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cash.js","sourceRoot":"","sources":["../src/cash.ts"],"names":[],"mappings":"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"}

package/dist/checkout.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Checkout.com's amount view (https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value,
+ * encoded in data/checkout.json). `amount` is an integer:
+ * - the full amount: BIF DJF GNF ISK JPY KMF KRW PYG RWF UGX VUV VND XAF XOF XPF
+ * - divided by 1000, last digit 0: BHD IQD JOD KWD LYD OMR TND
+ * - divided by 100 for every other currency. CLP is here too (ISO says 0 decimals), and for payment
+ *   requests its last two digits must be 00 (5000 CLP -> 500000). Standalone authentication is
+ *   exempt.
+ */
+import { CHECKOUT_RULES } from './generated/checkout.js';
+import { type CurrencyInput, type Money } from './money.js';
+import type { RoundingMode } from './rounding.js';
+export { CHECKOUT_RULES };
+/** Whether Checkout.com lists the currency (case-insensitive). */
+export declare function isCheckoutCurrency(currency: string): boolean;
+/** The exponent Checkout.com's API uses for a currency (CLP 2, JPY 0, BHD 3). */
+export declare function checkoutExponent(currency: string): number;
+/** Options for the Checkout.com amount: how to round when Checkout.com needs a coarser amount. */
+export interface CheckoutAmountOptions {
+    /** How to round when Checkout.com needs a coarser amount (default 'unnecessary': throw). */
+    readonly rounding?: RoundingMode;
+    /**
+     * An authentication request to the Standalone API, where CLP's "last two digits 00" rule does not
+     * apply.
+     */
+    readonly standalone?: boolean;
+}
+/**
+ * The integer `amount` to send, e.g. toCheckoutAmount(money('5000', 'CLP')) === 500000.
+ * Throws a RangeError for negative amounts (refunds are sent as positive amounts).
+ * SLL and XDR are on Checkout.com's list but not in ISO 4217's active list: call
+ * `defineCurrency('SLL', 2)` or `defineCurrency('XDR', 2)` before using them.
+ */
+export declare function toCheckoutAmount(money: Money, options?: CheckoutAmountOptions): number;
+/** `{ amount, currency }` for a payment request. */
+export declare function toCheckout(money: Money, options?: CheckoutAmountOptions): {
+    amount: number;
+    currency: string;
+};
+/** Reads a Checkout.com amount: fromCheckout(500000, 'CLP') is 5000 CLP. */
+export declare function fromCheckout<C extends CurrencyInput>(amount: number | bigint, currency: C): Money<Uppercase<C>>;
+//# sourceMappingURL=checkout.d.ts.map

package/dist/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../src/checkout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,CAAC;AAW1B,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,kGAAkG;AAClG,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAOtF;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,qBAAqB,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEtC;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EAClD,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,CAAC,GACV,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAGrB"}

package/dist/checkout.js

@@ -0,0 +1,52 @@
+/**
+ * Checkout.com's amount view (https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value,
+ * encoded in data/checkout.json). `amount` is an integer:
+ * - the full amount: BIF DJF GNF ISK JPY KMF KRW PYG RWF UGX VUV VND XAF XOF XPF
+ * - divided by 1000, last digit 0: BHD IQD JOD KWD LYD OMR TND
+ * - divided by 100 for every other currency. CLP is here too (ISO says 0 decimals), and for payment
+ *   requests its last two digits must be 00 (5000 CLP -> 500000). Standalone authentication is
+ *   exempt.
+ */
+import { CHECKOUT_RULES } from './generated/checkout.js';
+import {} from './money.js';
+import { fromProcessorAmount, toProcessorAmount } from './processor.js';
+export { CHECKOUT_RULES };
+/** Checkout.com's [exponent, payment multiple, Standalone API multiple] for a currency. */
+function rulesFor(currency) {
+    const rules = CHECKOUT_RULES[currency.toUpperCase()];
+    if (!rules) {
+        throw new RangeError(`${currency} is not a Checkout.com currency`);
+    }
+    return rules;
+}
+/** Whether Checkout.com lists the currency (case-insensitive). */
+export function isCheckoutCurrency(currency) {
+    return CHECKOUT_RULES[currency.toUpperCase()] !== undefined;
+}
+/** The exponent Checkout.com's API uses for a currency (CLP 2, JPY 0, BHD 3). */
+export function checkoutExponent(currency) {
+    return rulesFor(currency)[0];
+}
+/**
+ * The integer `amount` to send, e.g. toCheckoutAmount(money('5000', 'CLP')) === 500000.
+ * Throws a RangeError for negative amounts (refunds are sent as positive amounts).
+ * SLL and XDR are on Checkout.com's list but not in ISO 4217's active list: call
+ * `defineCurrency('SLL', 2)` or `defineCurrency('XDR', 2)` before using them.
+ */
+export function toCheckoutAmount(money, options) {
+    const [exponent, paymentMultiple, standaloneMultiple] = rulesFor(money.currency);
+    const multiple = options?.standalone ? standaloneMultiple : paymentMultiple;
+    const rounding = options?.rounding ?? 'unnecessary';
+    // "Be greater than zero", except 0 for a card verification (API reference); refunds are positive.
+    return toProcessorAmount('Checkout.com', money, exponent, multiple, rounding, 'nonNegative');
+}
+/** `{ amount, currency }` for a payment request. */
+export function toCheckout(money, options) {
+    return { amount: toCheckoutAmount(money, options), currency: money.currency.toUpperCase() };
+}
+/** Reads a Checkout.com amount: fromCheckout(500000, 'CLP') is 5000 CLP. */
+export function fromCheckout(amount, currency) {
+    const code = currency.toUpperCase();
+    return fromProcessorAmount('Checkout.com', amount, code, checkoutExponent(code));
+}
+//# sourceMappingURL=checkout.js.map

package/dist/checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../src/checkout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAkC,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,2FAA2F;AAC3F,SAAS,QAAQ,CAAC,QAAgB;IAChC,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,iCAAiC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,cAAc,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,CAAC;AAC9D,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,OAA+B;IAC5E,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC;IAC5E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,aAAa,CAAC;IAEpD,kGAAkG;IAClG,OAAO,iBAAiB,CAAC,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC/F,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,UAAU,CACxB,KAAY,EACZ,OAA+B;IAE/B,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;AAC9F,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAC1B,MAAuB,EACvB,QAAW;IAEX,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAkB,CAAC;IACpD,OAAO,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/convert.d.ts

@@ -0,0 +1,52 @@
+import { type Rounded } from './exact.js';
+import { type Factor } from './decimal.js';
+import { type CurrencyInput, type Money, type RoundingInput } from './money.js';
+import { type RateProvider } from './provider.js';
+import { type ConvertOptions, type Rate } from './rate.js';
+export { exchangeRate, impliedRate, isRate, multiplyByRatioAtScale, Rate, RateExpiredError, rateFromJSON, type ConvertOptions, type RateInfo, type RateJSON, type RateQuote, type RateType, } from './rate.js';
+export { bag, comparator, MoneyBag, sortByValue, sumByCurrency, type ComparatorOptions, type TotalOptions, } from './bag.js';
+export { chain, identity, rateOf, rateTable, RateUnavailableError, reversed, snapshots, snapshotsFrom, via, type RateProvider, type RateQuery, type RateTable, type RateTableSpec, type SnapshotOptions, type Snapshots, } from './provider.js';
+/** Options for converting through a provider. */
+export interface ProviderConvertOptions extends ConvertOptions {
+    /** The time the rate is wanted for (an ISO-8601 date or instant, or a Date). */
+    readonly asOf?: string | Date;
+}
+/**
+ * Converts `money` at a Rate, rounding once to the target currency's exponent (or `options.scale`),
+ * or with a rounding policy to its scale and increment (`@ducatjs/money/policy`).
+ * The rate's pair is checked, at compile time for literal currencies and at run time otherwise.
+ *
+ *     convert(money('100', 'EUR'), eurUsd, 'halfEven')               // 111.65 USD
+ *     convert(money('100', 'USD'), eurUsd.inverse().andThen(eurJpy))  // composed exactly, rounded once
+ */
+export declare function convert<From extends string, To extends string>(money: Money<From>, rate: Rate<NoInfer<From>, To>, rounding?: RoundingInput, options?: ConvertOptions): Money<To>;
+/**
+ * Converts at a bare rate: units of `to` per unit of money's currency, as a decimal string so that
+ * no float is involved ('1.0832', every digit kept). Rounds once.
+ *
+ *     convert(money('100', 'EUR'), 'JPY', '162.457', 'halfEven')   // 16246 JPY
+ */
+export declare function convert<To extends CurrencyInput>(money: Money, to: To, rate: Factor, rounding?: RoundingInput, options?: ConvertOptions): Money<To>;
+/**
+ * Converts through a provider: looks up money's currency → `to` (as of `options.asOf`) and rounds
+ * once. Throws RateUnavailableError when the provider has no rate.
+ *
+ *     convert(money('100', 'USD'), 'JPY', via('EUR', ecb), 'halfEven')
+ */
+export declare function convert<To extends CurrencyInput>(money: Money, to: To, provider: RateProvider, rounding?: RoundingInput, options?: ProviderConvertOptions): Money<To>;
+/**
+ * A conversion's rounded value, what rounding left out, and the rate used (for the audit trail).
+ */
+export interface DetailedConversion<From extends string, To extends string> extends Rounded<To> {
+    readonly rate: Rate<From, To>;
+}
+/**
+ * Converts at `rate` like convert(), and also reports the residual: `value + residual` is exactly
+ * money × rate, so a ledger can book the rounding difference. With a rounding policy, the value
+ * is on the policy's scale and increment, and the residual is still the exact difference.
+ *
+ *     const { value, residual } = convertDetailed(money('0.07', 'EUR'), eurUsd, 'halfEven');
+ *     // value 0.08 USD, residual -0.001845 USD (as an exact ExactMoney)
+ */
+export declare function convertDetailed<From extends string, To extends string>(money: Money<From>, rate: Rate<NoInfer<From>, To>, rounding?: RoundingInput, options?: ConvertOptions): DetailedConversion<From, To>;
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAS,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,IAAI,EACV,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,sBAAsB,EACtB,IAAI,EACJ,gBAAgB,EAChB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,GAAG,EACH,UAAU,EACV,QAAQ,EACR,WAAW,EACX,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,SAAS,EACT,oBAAoB,EACpB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,GAAG,EACH,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AAEvB,iDAAiD;AACjD,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAMD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAC5D,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAC7B,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,KAAK,CAAC,EAAE,CAAC,CAAC;AACb;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,SAAS,aAAa,EAC9C,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,KAAK,CAAC,EAAE,CAAC,CAAC;AACb;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,SAAS,aAAa,EAC9C,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,KAAK,CAAC,EAAE,CAAC,CAAC;AA0Cb;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,CAAE,SAAQ,OAAO,CAAC,EAAE,CAAC;IAC7F,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EACpE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAC7B,QAAQ,GAAE,aAAgC,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAS9B"}

package/dist/convert.js

@@ -0,0 +1,65 @@
+// `ducat/convert` free functions: exact exchange rates and conversion that rounds once.
+import { currencyExponent } from './currency.js';
+import { exact } from './exact.js';
+import { ratio } from './decimal.js';
+import { make } from './money.js';
+import { rateOf } from './provider.js';
+import { convertWithPolicy, isRate, multiplyByRatioAtScale, } from './rate.js';
+import { DEFAULT_ROUNDING } from './rounding.js';
+export { exchangeRate, impliedRate, isRate, multiplyByRatioAtScale, Rate, RateExpiredError, rateFromJSON, } from './rate.js';
+export { bag, comparator, MoneyBag, sortByValue, sumByCurrency, } from './bag.js';
+export { chain, identity, rateOf, rateTable, RateUnavailableError, reversed, snapshots, snapshotsFrom, via, } from './provider.js';
+function isProvider(value) {
+    return typeof value?.rate === 'function';
+}
+export function convert(money, rateOrTarget, roundingOrRate, optionsOrRounding, maybeOptions) {
+    if (isRate(rateOrTarget)) {
+        const rounding = roundingOrRate;
+        return rateOrTarget.convert(money, rounding, optionsOrRounding);
+    }
+    const to = rateOrTarget;
+    if (isProvider(roundingOrRate)) {
+        let query;
+        if (maybeOptions?.asOf !== undefined) {
+            query = { asOf: maybeOptions.asOf };
+        }
+        const rate = rateOf(roundingOrRate, money.currency, to, query);
+        return rate.convert(money, optionsOrRounding, maybeOptions);
+    }
+    // The bare-rate form converts directly, without building a Rate, to keep it allocation-light.
+    let rate = ratio(roundingOrRate);
+    if (typeof roundingOrRate === 'object') {
+        // A hand-made Ratio object is passed through by ratio(); rebuild it so it is reduced and its
+        // number fields match its bigints. Strings and numbers are already normalised (and cached).
+        rate = ratio(rate.num, rate.den);
+    }
+    if (rate.num <= 0n) {
+        throw new RangeError('Exchange rate must be positive');
+    }
+    const rounding = optionsOrRounding ?? DEFAULT_ROUNDING;
+    if (typeof rounding === 'function') {
+        return convertWithPolicy(money, to, rate, rounding, maybeOptions);
+    }
+    const scale = maybeOptions?.scale ?? currencyExponent(to);
+    const minor = multiplyByRatioAtScale(money.minor, rate, scale - money.scale, rounding);
+    return make(to, minor, scale);
+}
+/**
+ * Converts at `rate` like convert(), and also reports the residual: `value + residual` is exactly
+ * money × rate, so a ledger can book the rounding difference. With a rounding policy, the value
+ * is on the policy's scale and increment, and the residual is still the exact difference.
+ *
+ *     const { value, residual } = convertDetailed(money('0.07', 'EUR'), eurUsd, 'halfEven');
+ *     // value 0.08 USD, residual -0.001845 USD (as an exact ExactMoney)
+ */
+export function convertDetailed(money, rate, rounding = DEFAULT_ROUNDING, options) {
+    const converted = exact(money).convert(rate);
+    if (typeof rounding === 'function') {
+        // The policy rounds; the residual is still exactly what it left out.
+        const value = rate.convert(money, rounding, options);
+        return { value, residual: converted.subtract(exact(value)), rate };
+    }
+    const rounded = converted.roundWithResidual(rounding, options?.scale);
+    return { value: rounded.value, residual: rounded.residual, rate };
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"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"}

package/dist/currency.d.ts

@@ -0,0 +1,22 @@
+import { type IsoCurrencyCode } from './generated/iso4217.js';
+/**
+ * Augment this interface to add non-ISO currencies to the `CurrencyCode` type:
+ *
+ *     declare module '@ducatjs/money' { interface CustomCurrencies { BTC: true; USDC: true } }
+ *     defineCurrency('BTC', 8);
+ */
+export interface CustomCurrencies {
+}
+/** A known currency code: ISO 4217, or one added to `CustomCurrencies`. */
+export type CurrencyCode = IsoCurrencyCode | (keyof CustomCurrencies & string);
+/**
+ * Registers a currency that is not in ISO 4217 (crypto, loyalty points, withdrawn codes you still
+ * hold balances in). ISO codes cannot be redefined: use an explicit `scale` for extra precision.
+ */
+export declare function defineCurrency(code: string, exponent: number): void;
+/** The minor-unit exponent of a currency (EUR 2, JPY 0, KWD 3). Throws for unknown codes. */
+export declare function currencyExponent(code: string): number;
+/** Whether the code is an ISO 4217 currency or one registered with `defineCurrency`. */
+export declare function isCurrency(code: string): code is CurrencyCode;
+export { ISO_EXPONENTS, ISO_4217_PUBLISHED, ISO_NON_MONETARY, type IsoCurrencyCode, } from './generated/iso4217.js';
+//# sourceMappingURL=currency.d.ts.map

package/dist/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../src/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE7E;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;CAAG;AAEpC,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC;AAK/E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAYnE;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAE7D;AAED,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}

package/dist/currency.js

@@ -0,0 +1,38 @@
+import { ISO_EXPONENTS } from './generated/iso4217.js';
+const custom = new Map();
+const iso = ISO_EXPONENTS;
+/**
+ * Registers a currency that is not in ISO 4217 (crypto, loyalty points, withdrawn codes you still
+ * hold balances in). ISO codes cannot be redefined: use an explicit `scale` for extra precision.
+ */
+export function defineCurrency(code, exponent) {
+    if (!Number.isInteger(exponent) || exponent < 0 || exponent > 30) {
+        throw new RangeError(`Invalid exponent ${exponent}`);
+    }
+    if (typeof iso[code] === 'number') {
+        throw new TypeError(`${code} is an ISO 4217 currency and cannot be redefined`);
+    }
+    const prev = custom.get(code);
+    if (prev !== undefined && prev !== exponent) {
+        throw new TypeError(`${code} is already defined with exponent ${prev}`);
+    }
+    custom.set(code, exponent);
+}
+/** The minor-unit exponent of a currency (EUR 2, JPY 0, KWD 3). Throws for unknown codes. */
+export function currencyExponent(code) {
+    const isoExponent = iso[code];
+    if (typeof isoExponent === 'number') {
+        return isoExponent;
+    }
+    const customExponent = custom.get(code);
+    if (customExponent !== undefined) {
+        return customExponent;
+    }
+    throw new RangeError(`Unknown currency "${code}" (not ISO 4217 and not registered with defineCurrency)`);
+}
+/** Whether the code is an ISO 4217 currency or one registered with `defineCurrency`. */
+export function isCurrency(code) {
+    return typeof iso[code] === 'number' || custom.has(code);
+}
+export { ISO_EXPONENTS, ISO_4217_PUBLISHED, ISO_NON_MONETARY, } from './generated/iso4217.js';
+//# sourceMappingURL=currency.js.map

package/dist/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../src/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAwB,MAAM,wBAAwB,CAAC;AAc7E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;AACzC,MAAM,GAAG,GAAG,aAAiD,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAgB;IAC3D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,UAAU,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,kDAAkD,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,qCAAqC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,UAAU,CAClB,qBAAqB,IAAI,yDAAyD,CACnF,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC"}

package/dist/decimal.d.ts

@@ -0,0 +1,52 @@
+/**
+ * An exact rational factor num/den (den > 0). `n`/`d` hold the same values as numbers when both are
+ * safe.
+ */
+export interface Ratio {
+    readonly num: bigint;
+    readonly den: bigint;
+    /** num as a number, or NaN when it is not a safe integer */
+    readonly n: number;
+    /** den as a number, or NaN when it is not a safe integer */
+    readonly d: number;
+}
+/** Anything accepted where a multiplier, rate or percentage is expected. */
+export type Factor = number | bigint | string | Ratio;
+/** 10^exponent as a bigint, cached. */
+export declare function pow10n(exponent: number): bigint;
+/** 10^e as a number for 0 <= e <= 15 (all exact and safe). */
+export declare const POW10: readonly [1, 10, 100, 1000, 10000, 100000, 1000000, 10000000, 100000000, 1000000000, 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000, 1000000000000000];
+/**
+ * A bigint as a number when it is a safe integer, else unchanged: the representation Money keeps.
+ */
+export declare const normalizeMinor: (value: bigint) => number | bigint;
+/**
+ * Parses a plain decimal string ("-12.345", "+7", "0.50") into digits/10^scale. Returns the integer
+ * of all digits (number when safe, else bigint) and the count of fraction digits. Hand-rolled (no
+ * regex, no BigInt for short inputs): this is the hot path of `money("12.34", ...)`.
+ */
+export declare function parsePlainDecimal(input: string): {
+    digits: number | bigint;
+    scale: number;
+} | null;
+/**
+ * The largest exponent and number of fraction digits a decimal string may have. Far beyond any real
+ * amount or rate, and it keeps input such as "1e999999999" from building enormous powers of ten.
+ */
+export declare const MAX_DECIMAL_SCALE = 1000;
+/** Parses a decimal string, allowing exponent notation ("1e-7", as produced by String(1e-7)). */
+export declare function parseDecimal(input: string): {
+    digits: bigint;
+    scale: number;
+};
+/**
+ * Builds an exact ratio. `ratio('1.075')`, `ratio(3, 4)`, `ratio(10n)`, `ratio('1/3')`.
+ * Numbers are taken at their shortest decimal representation: `ratio(0.1)` is exactly 1/10.
+ * Pre-build ratios you use in hot loops; strings are also cached (up to 1024 entries).
+ */
+export declare function ratio(value: Factor, den?: Factor): Ratio;
+/** num/den -> exact decimal string if the expansion terminates, else null. */
+export declare function ratioToDecimal(value: Ratio): string | null;
+/** Formats an integer at `scale` as a plain decimal string ("-0.05"). */
+export declare function formatScaled(minor: number | bigint, scale: number): string;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4EAA4E;AAC5E,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAGtD,uCAAuC;AACvC,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/C;AACD,8DAA8D;AAC9D,eAAO,MAAM,KAAK,mLAER,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,MACC,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GACZ;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoDnD;AAID;;;GAGG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkB7E;AA2CD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CA8CxD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAiB1D;AAKD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmC1E"}