@ducatjs/money 0.0.0 → 0.1.0

package/dist/braintree.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Braintree's amount view (https://developer.paypal.com/braintree/docs/reference/general/currencies,
+ * encoded in data/braintree.json). `amount` is a decimal string in major units, "formatted like
+ * '10' or '10.00'":
+ * - zero-decimal currencies can't include decimals: BIF CLP DJF GNF ISK JPY KMF KRW LAK PYG RWF UGX
+ *   VND VUV XAF XOF XPF (LAK has 2 in ISO 4217);
+ * - the others take their ISO decimals ("10.00"). No three-decimal currency is listed.
+ * Amounts must be greater than zero, refunds and credits included.
+ */
+import { BRAINTREE_EXPONENTS } from './generated/braintree.js';
+import { type CurrencyInput, type Money } from './money.js';
+import type { RoundingMode } from './rounding.js';
+export { BRAINTREE_EXPONENTS };
+/** The number of decimals Braintree takes for a currency (JPY 0, LAK 0, USD 2). */
+export declare function braintreeExponent(currency: string): number;
+/** Whether Braintree lists the currency (case-insensitive). */
+export declare function isBraintreeCurrency(currency: string): boolean;
+/** Options for the Braintree amount: how to round when Braintree needs a coarser amount. */
+export interface BraintreeAmountOptions {
+    /**
+     * How to round when Braintree needs fewer decimals than the value has (default 'unnecessary':
+     * throw).
+     */
+    readonly rounding?: RoundingMode;
+}
+/**
+ * The exact `amount` string: toBraintree(money('10', 'USD')) === '10.00', JPY 100 -> '100'.
+ * Braintree has no currency field on a transaction: the merchant account sets it.
+ * Throws a RangeError for zero or negative amounts.
+ */
+export declare function toBraintree(money: Money, options?: BraintreeAmountOptions): string;
+/** Reads a Braintree amount string exactly: fromBraintree('10.00', 'USD'). */
+export declare function fromBraintree<C extends CurrencyInput>(amount: string, currency: C): Money<Uppercase<C>>;
+//# sourceMappingURL=braintree.d.ts.map

package/dist/braintree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"braintree.d.ts","sourceRoot":"","sources":["../src/braintree.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAK/B,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,4FAA4F;AAC5F,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAWlF;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,CAAC,SAAS,aAAa,EACnD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,GACV,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAMrB"}

package/dist/braintree.js

@@ -0,0 +1,45 @@
+/**
+ * Braintree's amount view (https://developer.paypal.com/braintree/docs/reference/general/currencies,
+ * encoded in data/braintree.json). `amount` is a decimal string in major units, "formatted like
+ * '10' or '10.00'":
+ * - zero-decimal currencies can't include decimals: BIF CLP DJF GNF ISK JPY KMF KRW LAK PYG RWF UGX
+ *   VND VUV XAF XOF XPF (LAK has 2 in ISO 4217);
+ * - the others take their ISO decimals ("10.00"). No three-decimal currency is listed.
+ * Amounts must be greater than zero, refunds and credits included.
+ */
+import { BRAINTREE_EXPONENTS } from './generated/braintree.js';
+import {} from './money.js';
+import { fromProcessorDecimal, toProcessorDecimal } from './processor.js';
+export { BRAINTREE_EXPONENTS };
+/** "Can only contain numbers and one decimal point (e.g. x.xx)". */
+const AMOUNT_PATTERN = /^[0-9]+(\.[0-9]+)?$/;
+/** The number of decimals Braintree takes for a currency (JPY 0, LAK 0, USD 2). */
+export function braintreeExponent(currency) {
+    const exponent = BRAINTREE_EXPONENTS[currency.toUpperCase()];
+    if (exponent === undefined) {
+        throw new RangeError(`${currency} is not a Braintree currency`);
+    }
+    return exponent;
+}
+/** Whether Braintree lists the currency (case-insensitive). */
+export function isBraintreeCurrency(currency) {
+    return BRAINTREE_EXPONENTS[currency.toUpperCase()] !== undefined;
+}
+/**
+ * The exact `amount` string: toBraintree(money('10', 'USD')) === '10.00', JPY 100 -> '100'.
+ * Braintree has no currency field on a transaction: the merchant account sets it.
+ * Throws a RangeError for zero or negative amounts.
+ */
+export function toBraintree(money, options) {
+    const rounding = options?.rounding ?? 'unnecessary';
+    // 81531 "Amount must be greater than zero"; 81501: credits are positive too ("x.xx, not -x.xx").
+    return toProcessorDecimal('Braintree', money, braintreeExponent(money.currency), rounding, 'positive');
+}
+/** Reads a Braintree amount string exactly: fromBraintree('10.00', 'USD'). */
+export function fromBraintree(amount, currency) {
+    const code = currency.toUpperCase();
+    // Validates the currency before parsing, so an unlisted currency is the error reported.
+    braintreeExponent(code);
+    return fromProcessorDecimal('Braintree', amount, code, AMOUNT_PATTERN);
+}
+//# sourceMappingURL=braintree.js.map

package/dist/braintree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"braintree.js","sourceRoot":"","sources":["../src/braintree.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAkC,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,oEAAoE;AACpE,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAE7C,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,8BAA8B,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,CAAC;AACnE,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAgC;IACxE,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,aAAa,CAAC;IAEpD,iGAAiG;IACjG,OAAO,kBAAkB,CACvB,WAAW,EACX,KAAK,EACL,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,EACjC,QAAQ,EACR,UAAU,CACX,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,QAAW;IAEX,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAkB,CAAC;IAEpD,wFAAwF;IACxF,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACzE,CAAC"}

package/dist/cash.d.ts

@@ -0,0 +1,35 @@
+import { CASH_RULES, type CashRule } from './generated/cash.js';
+import { type Money } from './money.js';
+import { type RoundingMode } from './rounding.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 declare function roundToIncrement<C extends string>(money: Money<C>, increment: Money<NoInfer<C>>, rounding?: RoundingMode): Money<C>;
+/**
+ * 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 declare function cashRule(currency: string, country?: string): CashRule | undefined;
+/**
+ * Options for `cashRound`: the country (needed for EUR), the rounding mode, and whether to use
+ * unverified rules.
+ */
+export interface CashRoundOptions {
+    readonly country?: string;
+    readonly rounding?: RoundingMode;
+    /**
+     * Apply rules that are only backed by secondary sources (default true; see
+     * data/cash-rounding.json).
+     */
+    readonly includeUnverified?: boolean;
+}
+/**
+ * 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 declare function cashRound<C extends string>(money: Money<C>, options?: CashRoundOptions): Money<C>;
+export { CASH_RULES, type CashRule };
+//# sourceMappingURL=cash.d.ts.map

package/dist/cash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cash.d.ts","sourceRoot":"","sources":["../src/cash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAiD,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGxF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAC5B,QAAQ,GAAE,YAA2B,GACpC,KAAK,CAAC,CAAC,CAAC,CAyBV;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAkBjF;AAuBD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC,CAAC,CAAC,CAOjG;AAED,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,CAAC"}

package/dist/cash.js

@@ -0,0 +1,86 @@
+import { CASH_RULES } from './generated/cash.js';
+import { CurrencyMismatchError, make, scaleUp, toScale } from './money.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 ?? 'halfExpand');
+}
+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,51 @@
+import { type Rounded } from './exact.js';
+import { type Factor } from './decimal.js';
+import { type CurrencyInput, type Money } from './money.js';
+import { type RateProvider } from './provider.js';
+import { type ConvertOptions, type Rate } from './rate.js';
+import { type RoundingMode } from './rounding.js';
+export { exchangeRate, impliedRate, isRate, multiplyByRatioAtScale, Rate, RateExpiredError, rateFromJSON, type ConvertOptions, type RateInfo, type RateJSON, 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`).
+ * 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?: RoundingMode, 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?: RoundingMode, 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?: RoundingMode, 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.
+ *
+ *     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?: RoundingMode, 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,MAAM,YAAY,CAAC;AAClE,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAkC,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpE,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,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;;;;;;GAMG;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,YAAY,EACvB,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,YAAY,EACvB,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,YAAY,EACvB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,KAAK,CAAC,EAAE,CAAC,CAAC;AAuCb;;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;;;;;;GAMG;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,YAA+B,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAG9B"}

package/dist/convert.js

@@ -0,0 +1,55 @@
+// `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 { 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;
+    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.
+ *
+ *     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 rounded = exact(money).convert(rate).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":"AAAA,wFAAwF;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,EAAgB,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,KAAK,EAAe,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,IAAI,EAAkC,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,MAAM,EAAqB,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAkC,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAqB,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,sBAAsB,EACtB,IAAI,EACJ,gBAAgB,EAChB,YAAY,GAKb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,GAAG,EACH,UAAU,EACV,QAAQ,EACR,WAAW,EACX,aAAa,GAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,SAAS,EACT,oBAAoB,EACpB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,GAAG,GAOJ,MAAM,eAAe,CAAC;AAQvB,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAQ,KAAkC,EAAE,IAAI,KAAK,UAAU,CAAC;AACzE,CAAC;AAyCD,MAAM,UAAU,OAAO,CACrB,KAAY,EACZ,YAA2B,EAC3B,cAAqD,EACrD,iBAAiD,EACjD,YAAqC;IAErC,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,cAA0C,CAAC;QAC5D,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAA+C,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC;IACxB,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,IAAI,KAA0C,CAAC;QAC/C,IAAI,YAAY,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YACrC,KAAK,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,iBAA6C,EAAE,YAAY,CAAC,CAAC;IAC1F,CAAC;IAED,8FAA8F;IAC9F,IAAI,IAAI,GAAG,KAAK,CAAC,cAAwB,CAAC,CAAC;IAC3C,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,6FAA6F;QAC7F,4FAA4F;QAC5F,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,QAAQ,GAAI,iBAA8C,IAAI,gBAAgB,CAAC;IACrF,MAAM,KAAK,GAAG,YAAY,EAAE,KAAK,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAkB,EAClB,IAA6B,EAC7B,WAAyB,gBAAgB,EACzC,OAAwB;IAExB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACvF,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;AACpE,CAAC"}

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"}