@ducatjs/money 0.0.0-stage → 0.1.0

package/dist/rate.js

@@ -0,0 +1,271 @@
+// Exchange rates as exact rationals with metadata. A Rate never loses digits: inverses,
+// compositions and margins are exact products of ratios, and rounding happens once, when an amount
+// is converted.
+import { currencyExponent } from './currency.js';
+import { formatScaled, POW10, pow10n, ratio, ratioToDecimal, normalizeMinor, } from './decimal.js';
+import { CurrencyMismatchError, make } from './money.js';
+import { DEFAULT_ROUNDING, divideAndRound, divideAndRoundBigint, } from './rounding.js';
+const MAX_SAFE_MINOR = Number.MAX_SAFE_INTEGER;
+/** Thrown by a strict-validity conversion with a rate past its `validUntil`. */
+export class RateExpiredError extends RangeError {
+    validUntil;
+    constructor(from, to, validUntil) {
+        super(`Exchange rate ${from}→${to} expired at ${validUntil}`);
+        this.name = 'RateExpiredError';
+        this.validUntil = validUntil;
+    }
+}
+const OPPOSITE_SIDE = { bid: 'ask', ask: 'bid' };
+const ISO_DATE = /^\d{4}-\d\d-\d\d$/;
+/**
+ * @internal
+ * A date stays as given ('2026-11-06'); an instant becomes UTC ISO ('2026-11-06T15:00:00.000Z'), so
+ * that times with different offsets compare correctly as strings.
+ */
+export function toIsoString(time) {
+    if (typeof time === 'string' && ISO_DATE.test(time)) {
+        return time;
+    }
+    const date = time instanceof Date ? time : new Date(time);
+    if (Number.isNaN(date.getTime())) {
+        throw new RangeError(`Invalid date or time ${String(time)}`);
+    }
+    return date.toISOString();
+}
+/**
+ * The earlier of two ISO-8601 strings (one format compares lexicographically); undefined = no
+ * limit.
+ */
+function earlier(first, second) {
+    if (first === undefined) {
+        return second;
+    }
+    if (second === undefined || first <= second) {
+        return first;
+    }
+    return second;
+}
+/**
+ * minor × rate × 10^scaleShift, rounded once with `rounding`. This is the kernel of every
+ * conversion: `scaleShift` is the result scale minus the input scale. Pure, and `rate.den > 0` by
+ * construction.
+ */
+export function multiplyByRatioAtScale(minor, rate, scaleShift, rounding) {
+    // Fast path: all factors are safe integers, so a product that stays in the safe range is exact.
+    // `rate.n === rate.n` is false only for NaN, which marks a numerator that isn't a safe integer.
+    const rateIsSafe = rate.n === rate.n && rate.d === rate.d;
+    if (typeof minor === 'number' && rateIsSafe && scaleShift >= -15 && scaleShift <= 15) {
+        let numerator = rate.n;
+        let denominator = rate.d;
+        if (scaleShift > 0) {
+            numerator *= POW10[scaleShift];
+        }
+        else if (scaleShift < 0) {
+            denominator *= POW10[-scaleShift];
+        }
+        if (numerator <= MAX_SAFE_MINOR && denominator <= MAX_SAFE_MINOR) {
+            const product = minor * numerator;
+            if (product <= MAX_SAFE_MINOR && product >= -MAX_SAFE_MINOR) {
+                return divideAndRound(product, denominator, rounding);
+            }
+        }
+    }
+    // Slow path: the same single division, in bigint.
+    let numerator = BigInt(minor) * rate.num;
+    let denominator = rate.den;
+    if (scaleShift > 0) {
+        numerator *= pow10n(scaleShift);
+    }
+    else if (scaleShift < 0) {
+        denominator *= pow10n(-scaleShift);
+    }
+    return normalizeMinor(divideAndRoundBigint(numerator, denominator, rounding));
+}
+/**
+ * An exact exchange rate: one unit of `from` is worth `ratio` units of `to`. Build it with
+ * `exchangeRate()`. Derived rates (`inverse`, `andThen`, `withMargin`, `round`) keep their inputs
+ * in `derivedFrom`, the audit chain. Their `asOf` is the oldest input's, so staleness can't hide,
+ * and their `validUntil` is the earliest.
+ */
+export class Rate {
+    from;
+    to;
+    ratio;
+    /** @internal use exchangeRate() */
+    constructor(from, to, rate, info, derivedFrom) {
+        // Rebuilt so that a hand-made Ratio object is reduced, has a positive denominator, and has
+        // number fields that match its bigints (the fast path relies on them).
+        const normalized = ratio(rate.num, rate.den);
+        if (normalized.num <= 0n) {
+            throw new RangeError('Exchange rate must be positive');
+        }
+        this.from = from;
+        this.to = to;
+        this.ratio = normalized;
+        // Only defined fields are assigned, so rates compare and serialise without undefined keys.
+        const writable = this;
+        if (info?.source !== undefined) {
+            writable.source = info.source;
+        }
+        if (info?.asOf !== undefined) {
+            writable.asOf = toIsoString(info.asOf);
+        }
+        if (info?.validUntil !== undefined) {
+            writable.validUntil = toIsoString(info.validUntil);
+        }
+        if (info?.type !== undefined) {
+            writable.type = info.type;
+        }
+        if (derivedFrom !== undefined) {
+            writable.derivedFrom = derivedFrom;
+        }
+    }
+    /** The exact reciprocal, `to` → `from`. A bid becomes an ask and vice versa. */
+    inverse() {
+        let type = this.type;
+        if (type !== undefined) {
+            type = OPPOSITE_SIDE[type] ?? type;
+        }
+        const reciprocal = ratio(this.ratio.den, this.ratio.num);
+        return new Rate(this.to, this.from, reciprocal, timingOf(this, type), [this]);
+    }
+    /**
+     * The exact composite `from` → `next.to`. Nothing is rounded: converting with it rounds once.
+     * (Named `andThen`, not `then`, so that a Rate is never mistaken for a promise.)
+     */
+    andThen(next) {
+        if (next.from !== this.to) {
+            throw new CurrencyMismatchError(this.to, next.from);
+        }
+        const product = ratio(this.ratio.num * next.ratio.num, this.ratio.den * next.ratio.den);
+        // A composite keeps a type only when both legs agree, so it can't be mislabelled.
+        let type;
+        if (this.type === next.type) {
+            type = this.type;
+        }
+        const asOf = earlier(this.asOf, next.asOf);
+        const validUntil = earlier(this.validUntil, next.validUntil);
+        return new Rate(this.from, next.to, product, timing(asOf, validUntil, type), [this, next]);
+    }
+    /** This rate × (1 + margin), exactly: `withMargin('-0.02')` gives 2% less `to` per `from`. */
+    withMargin(margin) {
+        const marginRatio = ratio(margin);
+        const numerator = this.ratio.num * (marginRatio.den + marginRatio.num);
+        const denominator = this.ratio.den * marginRatio.den;
+        return new Rate(this.from, this.to, ratio(numerator, denominator), timingOf(this), [this]);
+    }
+    /**
+     * A new Rate rounded to `places` decimals, for businesses that quote rounded (e.g. inverse)
+     * rates.
+     */
+    round(places, rounding = 'halfEven') {
+        const rounded = ratio(this.toDecimal(places, rounding));
+        return new Rate(this.from, this.to, rounded, timingOf(this, this.type), [this]);
+    }
+    /** The rate with exactly `places` decimals, for display. The Rate itself keeps every digit. */
+    toDecimal(places, rounding = 'halfEven') {
+        const scaled = divideAndRoundBigint(this.ratio.num * pow10n(places), this.ratio.den, rounding);
+        return formatScaled(scaled, places);
+    }
+    /** The exact rate: '1.1165', or '2000/2233' when its decimal expansion doesn't terminate. */
+    toString() {
+        return ratioToDecimal(this.ratio) ?? `${this.ratio.num}/${this.ratio.den}`;
+    }
+    /** The rate, its metadata and its audit chain as JSON. `rateFromJSON` reverses it. */
+    toJSON() {
+        const json = { from: this.from, to: this.to, rate: this.toString(), ...infoOf(this) };
+        if (this.derivedFrom !== undefined) {
+            json.derivedFrom = this.derivedFrom.map((input) => input.toJSON());
+        }
+        return json;
+    }
+    /**
+     * Whether `validUntil` has passed at `now` (default: the system clock). A date is valid all day
+     * (UTC).
+     */
+    isExpired(now = new Date()) {
+        if (this.validUntil === undefined) {
+            return false;
+        }
+        let instant = toIsoString(now);
+        if (ISO_DATE.test(instant)) {
+            instant = `${instant}T00:00:00.000Z`;
+        }
+        if (ISO_DATE.test(this.validUntil)) {
+            return instant.slice(0, 10) > this.validUntil;
+        }
+        return instant > this.validUntil;
+    }
+    /** Converts `money`, rounding once to the target currency's exponent (or `options.scale`). */
+    convert(money, rounding = DEFAULT_ROUNDING, options) {
+        if (money.currency !== this.from) {
+            throw new CurrencyMismatchError(this.from, money.currency);
+        }
+        if (options?.strictValidity === true && this.validUntil !== undefined && this.isExpired()) {
+            throw new RateExpiredError(this.from, this.to, this.validUntil);
+        }
+        const scale = options?.scale ?? currencyExponent(this.to);
+        const minor = multiplyByRatioAtScale(money.minor, this.ratio, scale - money.scale, rounding);
+        return make(this.to, minor, scale);
+    }
+}
+/** The metadata fields of `info` that are defined (no undefined keys). */
+function infoOf(info) {
+    const defined = {};
+    if (info.source !== undefined) {
+        defined.source = info.source;
+    }
+    if (info.asOf !== undefined) {
+        defined.asOf = toIsoString(info.asOf);
+    }
+    if (info.validUntil !== undefined) {
+        defined.validUntil = toIsoString(info.validUntil);
+    }
+    if (info.type !== undefined) {
+        defined.type = info.type;
+    }
+    return defined;
+}
+function timing(asOf, validUntil, type) {
+    return infoOf({ asOf, validUntil, type });
+}
+/**
+ * A derived rate keeps the timing of its input; the input's source stays with it, in derivedFrom.
+ */
+function timingOf(input, type) {
+    return timing(input.asOf, input.validUntil, type);
+}
+/**
+ * An exact rate pinned to a currency pair, so converting the wrong currency is a type error. Give
+ * the rate as a decimal string ('1.1165', every digit kept), a "num/den" string, a bigint or a
+ * Ratio. Numbers are read at their shortest decimal form (1.234 is exactly 1234/1000).
+ *
+ *     const eurUsd = exchangeRate('EUR', 'USD', '1.1165', { source: 'ECB', asOf: '2026-11-06' });
+ *     eurUsd.convert(money('100', 'EUR'), 'halfEven');   // 111.65 USD
+ *     eurUsd.inverse().ratio                             // 2000/2233, exactly
+ */
+export function exchangeRate(from, to, rate, info) {
+    return new Rate(from, to, ratio(rate), info);
+}
+/** Rebuilds a Rate, with its audit chain, from `rate.toJSON()`. */
+export function rateFromJSON(json) {
+    const derivedFrom = json.derivedFrom?.map(rateFromJSON);
+    return new Rate(json.from, json.to, ratio(json.rate), infoOf(json), derivedFrom);
+}
+/** Whether `value` is a Rate. */
+export function isRate(value) {
+    return value instanceof Rate;
+}
+/**
+ * The exact rate a processor actually applied: settled ÷ presented. Use it to audit a quoted rate,
+ * which after the processor's own rounding often doesn't reproduce the settled amount.
+ *
+ *     impliedRate(money('10.00', 'EUR'), money('12.34', 'USD'))   // EUR→USD 1.234
+ */
+export function impliedRate(presented, settled, info) {
+    // (settled.minor / 10^settled.scale) ÷ (presented.minor / 10^presented.scale)
+    const numerator = BigInt(settled.minor) * pow10n(presented.scale);
+    const denominator = BigInt(presented.minor) * pow10n(settled.scale);
+    return new Rate(presented.currency, settled.currency, ratio(numerator, denominator), info);
+}
+//# sourceMappingURL=rate.js.map

package/dist/rate.js.map

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

package/dist/rounding-error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Thrown when an operation would have to round but the rounding mode is `'unnecessary'`. It lives
+ * in its own module so the generated kernels can throw it without importing `rounding.ts`, which
+ * imports them.
+ */
+export declare class RoundingError extends RangeError {
+    name: string;
+}
+//# sourceMappingURL=rounding-error.d.ts.map

package/dist/rounding-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounding-error.d.ts","sourceRoot":"","sources":["../src/rounding-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAClC,IAAI,SAAmB;CACjC"}

package/dist/rounding-error.js

@@ -0,0 +1,9 @@
+/**
+ * Thrown when an operation would have to round but the rounding mode is `'unnecessary'`. It lives
+ * in its own module so the generated kernels can throw it without importing `rounding.ts`, which
+ * imports them.
+ */
+export class RoundingError extends RangeError {
+    name = 'RoundingError';
+}
+//# sourceMappingURL=rounding-error.js.map

package/dist/rounding-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounding-error.js","sourceRoot":"","sources":["../src/rounding-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAClC,IAAI,GAAG,eAAe,CAAC;CACjC"}

package/dist/rounding.d.ts

@@ -0,0 +1,50 @@
+import { RoundingError } from './rounding-error.js';
+/**
+ * Rounding modes. The string values are the ones `Intl.NumberFormat` uses for its `roundingMode`
+ * option (ES2023), so a mode can be passed straight through to formatting. `Rounding` gives the
+ * familiar names (HalfUp, HalfEven, ...) for the same strings.
+ *
+ * An invalid mode (possible only from untyped code) is reported, with a RangeError, only when
+ * rounding is actually needed: an exact result is returned without looking at the mode, which keeps
+ * the exact path as fast as it can be.
+ */
+export type RoundingMode = 'halfEven' | 'halfExpand' | 'halfTrunc' | 'halfCeil' | 'halfFloor' | 'expand' | 'trunc' | 'ceil' | 'floor' | 'unnecessary';
+/**
+ * Familiar names for the rounding modes (HalfUp, HalfEven, Bankers, ...), mapped to the mode
+ * strings.
+ */
+export declare const Rounding: {
+    readonly HalfEven: "halfEven";
+    readonly Bankers: "halfEven";
+    readonly HalfUp: "halfExpand";
+    readonly HalfDown: "halfTrunc";
+    readonly HalfCeil: "halfCeil";
+    readonly HalfFloor: "halfFloor";
+    readonly Up: "expand";
+    readonly Down: "trunc";
+    readonly Ceil: "ceil";
+    readonly Floor: "floor";
+    readonly Unnecessary: "unnecessary";
+};
+/**
+ * The rounding mode arithmetic uses when none is given: ties away from zero ('half up'). It is the
+ * default of decimal.js, big.js, bignumber.js, Prisma.Decimal and Intl.NumberFormat, and what
+ * Math.round-based money libraries (currency.js, js-money, ts-money) intend. Parsing
+ * (`money('1.005', 'EUR')`, `fromDecimal`) and processor amounts (`toStripeAmount`, `toAdyen`) stay
+ * strict: they throw unless a mode is passed.
+ */
+export declare const DEFAULT_ROUNDING: RoundingMode;
+export { RoundingError };
+/**
+ * dividend / divisor rounded with `mode`, for safe-integer dividends and divisor > 0. Exact: the
+ * float quotient is only a first guess, corrected until the remainder has the dividend's sign and
+ * is smaller than the divisor.
+ */
+export declare function divideAndRound(dividend: number, divisor: number, mode: RoundingMode): number;
+/**
+ * dividend / divisor rounded with `mode`, for divisor > 0n. The bigint kernel is generated from the
+ * Lean proofs in proofs/Ducat/Rounding.lean (`src/generated/kernel.ts`), and so is the mode switch
+ * `divideAndRound` uses.
+ */
+export declare function divideAndRoundBigint(dividend: bigint, divisor: bigint, mode: RoundingMode): bigint;
+//# sourceMappingURL=rounding.d.ts.map

package/dist/rounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounding.d.ts","sourceRoot":"","sources":["../src/rounding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAEpB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,UAAU,GACV,WAAW,GACX,QAAQ,GACR,OAAO,GACP,MAAM,GACN,OAAO,GAEP,aAAa,CAAC;AAElB;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;CAY4B,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAA2B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,CAAC;AAIzB;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAwC5F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GACjB,MAAM,CAKR"}

package/dist/rounding.js

@@ -0,0 +1,87 @@
+import { divideAndRoundBigint as provedDivideAndRoundBigint, roundTruncatedQuotient, } from './generated/kernel.js';
+import { RoundingError } from './rounding-error.js';
+/**
+ * Familiar names for the rounding modes (HalfUp, HalfEven, Bankers, ...), mapped to the mode
+ * strings.
+ */
+export const Rounding = {
+    HalfEven: 'halfEven',
+    Bankers: 'halfEven',
+    HalfUp: 'halfExpand',
+    HalfDown: 'halfTrunc',
+    HalfCeil: 'halfCeil',
+    HalfFloor: 'halfFloor',
+    Up: 'expand',
+    Down: 'trunc',
+    Ceil: 'ceil',
+    Floor: 'floor',
+    Unnecessary: 'unnecessary',
+};
+/**
+ * The rounding mode arithmetic uses when none is given: ties away from zero ('half up'). It is the
+ * default of decimal.js, big.js, bignumber.js, Prisma.Decimal and Intl.NumberFormat, and what
+ * Math.round-based money libraries (currency.js, js-money, ts-money) intend. Parsing
+ * (`money('1.005', 'EUR')`, `fromDecimal`) and processor amounts (`toStripeAmount`, `toAdyen`) stay
+ * strict: they throw unless a mode is passed.
+ */
+export const DEFAULT_ROUNDING = 'halfExpand';
+export { RoundingError };
+const MAX_SAFE_MINOR = Number.MAX_SAFE_INTEGER;
+/**
+ * dividend / divisor rounded with `mode`, for safe-integer dividends and divisor > 0. Exact: the
+ * float quotient is only a first guess, corrected until the remainder has the dividend's sign and
+ * is smaller than the divisor.
+ */
+export function divideAndRound(dividend, divisor, mode) {
+    if (divisor === 1) {
+        return dividend;
+    }
+    // Beyond MAX_SAFE_MINOR the product quotient * divisor below could round, so take the bigint
+    // path.
+    if (!(Math.abs(dividend) + divisor <= MAX_SAFE_MINOR)) {
+        return Number(divideAndRoundBigint(BigInt(dividend), BigInt(divisor), mode));
+    }
+    let quotient = Math.trunc(dividend / divisor);
+    // exact: |quotient * divisor| <= |dividend| + divisor <= MAX_SAFE_MINOR
+    let remainder = dividend - quotient * divisor;
+    // The float quotient can be off by one ulp; fix it so the remainder has the dividend's sign and
+    // is smaller than the divisor in magnitude.
+    if (dividend >= 0) {
+        if (remainder < 0) {
+            quotient -= 1;
+            remainder += divisor;
+        }
+        else if (remainder >= divisor) {
+            quotient += 1;
+            remainder -= divisor;
+        }
+    }
+    else if (remainder > 0) {
+        quotient += 1;
+        remainder -= divisor;
+    }
+    else if (remainder <= -divisor) {
+        quotient -= 1;
+        remainder += divisor;
+    }
+    // The generated switch handles a zero remainder too; returning here saves the call on the hottest
+    // path.
+    if (remainder === 0) {
+        return quotient + 0; // + 0 normalises -0
+    }
+    // quotient and remainder are now the exact truncated quotient and remainder, as the generated
+    // switch expects
+    return roundTruncatedQuotient(dividend, divisor, quotient, remainder, mode) + 0;
+}
+/**
+ * dividend / divisor rounded with `mode`, for divisor > 0n. The bigint kernel is generated from the
+ * Lean proofs in proofs/Ducat/Rounding.lean (`src/generated/kernel.ts`), and so is the mode switch
+ * `divideAndRound` uses.
+ */
+export function divideAndRoundBigint(dividend, divisor, mode) {
+    if (divisor === 1n) {
+        return dividend;
+    }
+    return provedDivideAndRoundBigint(dividend, divisor, mode);
+}
+//# sourceMappingURL=rounding.js.map

package/dist/rounding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounding.js","sourceRoot":"","sources":["../src/rounding.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,IAAI,0BAA0B,EAClD,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBpD;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;CACqB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB,YAAY,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAkB;IAClF,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,6FAA6F;IAC7F,QAAQ;IACR,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,cAAc,CAAC,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;IAC9C,wEAAwE;IACxE,IAAI,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAE9C,gGAAgG;IAChG,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,QAAQ,IAAI,CAAC,CAAC;YACd,SAAS,IAAI,OAAO,CAAC;QACvB,CAAC;aAAM,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,QAAQ,IAAI,CAAC,CAAC;YACd,SAAS,IAAI,OAAO,CAAC;QACvB,CAAC;IACH,CAAC;SAAM,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACzB,QAAQ,IAAI,CAAC,CAAC;QACd,SAAS,IAAI,OAAO,CAAC;IACvB,CAAC;SAAM,IAAI,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,QAAQ,IAAI,CAAC,CAAC;QACd,SAAS,IAAI,OAAO,CAAC;IACvB,CAAC;IAED,kGAAkG;IAClG,QAAQ;IACR,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,QAAQ,GAAG,CAAC,CAAC,CAAC,oBAAoB;IAC3C,CAAC;IACD,8FAA8F;IAC9F,iBAAiB;IACjB,OAAO,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,OAAe,EACf,IAAkB;IAElB,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,0BAA0B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/stripe-fx.d.ts

@@ -0,0 +1,22 @@
+import type { Money } from './money.js';
+import { type Rate } from './rate.js';
+/** The fields of a Stripe BalanceTransaction used here. */
+export interface StripeBalanceTransaction {
+    readonly amount: number;
+    readonly currency: string;
+    readonly exchange_rate?: number | null;
+    /** Seconds since the Unix epoch. */
+    readonly created?: number;
+}
+/**
+ * The rate Stripe quotes on a balance transaction, from the charge currency `from` to the balance
+ * currency: "the amount in currency A, multiplied by the exchange_rate, equals the amount in
+ * currency B". The JSON number is read at its shortest decimal form, so 1.234 is exactly 1234/1000.
+ * `asOf` is the balance transaction's `created` time, the closest timestamp Stripe gives for the
+ * conversion; it is not the charge's creation time, and Stripe doesn't say when the rate was
+ * quoted. `undefined` when nothing was converted.
+ */
+export declare function stripeRate<From extends string>(from: From, transaction: StripeBalanceTransaction): Rate<Uppercase<From>, Uppercase<string>> | undefined;
+/** The exact rate Stripe applied: the balance transaction's gross amount ÷ the charged amount. */
+export declare function stripeImpliedRate<From extends string>(charged: Money<From>, transaction: StripeBalanceTransaction): Rate<From, Uppercase<string>>;
+//# sourceMappingURL=stripe-fx.d.ts.map

package/dist/stripe-fx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-fx.d.ts","sourceRoot":"","sources":["../src/stripe-fx.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAA6B,KAAK,IAAI,EAAiB,MAAM,WAAW,CAAC;AAGhF,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AASD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,MAAM,EAC5C,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,wBAAwB,GACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAOtD;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,MAAM,EACnD,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EACpB,WAAW,EAAE,wBAAwB,GACpC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAG/B"}

package/dist/stripe-fx.js

@@ -0,0 +1,30 @@
+import { exchangeRate, impliedRate } from './rate.js';
+import { fromStripe } from './stripe.js';
+function stripeInfo(transaction) {
+    if (transaction.created === undefined) {
+        return { source: 'stripe' };
+    }
+    return { source: 'stripe', asOf: new Date(transaction.created * 1000) };
+}
+/**
+ * The rate Stripe quotes on a balance transaction, from the charge currency `from` to the balance
+ * currency: "the amount in currency A, multiplied by the exchange_rate, equals the amount in
+ * currency B". The JSON number is read at its shortest decimal form, so 1.234 is exactly 1234/1000.
+ * `asOf` is the balance transaction's `created` time, the closest timestamp Stripe gives for the
+ * conversion; it is not the charge's creation time, and Stripe doesn't say when the rate was
+ * quoted. `undefined` when nothing was converted.
+ */
+export function stripeRate(from, transaction) {
+    if (transaction.exchange_rate === undefined || transaction.exchange_rate === null) {
+        return undefined;
+    }
+    const charged = from.toUpperCase();
+    const balance = transaction.currency.toUpperCase();
+    return exchangeRate(charged, balance, transaction.exchange_rate, stripeInfo(transaction));
+}
+/** The exact rate Stripe applied: the balance transaction's gross amount ÷ the charged amount. */
+export function stripeImpliedRate(charged, transaction) {
+    const settled = fromStripe(transaction.amount, transaction.currency.toUpperCase());
+    return impliedRate(charged, settled, stripeInfo(transaction));
+}
+//# sourceMappingURL=stripe-fx.js.map

package/dist/stripe-fx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-fx.js","sourceRoot":"","sources":["../src/stripe-fx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,WAAW,EAA4B,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,SAAS,UAAU,CAAC,WAAqC;IACvD,IAAI,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAU,EACV,WAAqC;IAErC,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS,IAAI,WAAW,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAqB,CAAC;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAuB,CAAC;IACxE,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,WAAqC;IAErC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACnF,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/stripe.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Stripe's minor-unit view. Stripe uses ISO exponents except where documented otherwise
+ * (https://docs.stripe.com/currencies, encoded in data/stripe.json):
+ * - zero-decimal: BIF CLP DJF GNF JPY KMF KRW MGA PYG RWF VND VUV XAF XOF XPF (note MGA: ISO says
+ *   2)
+ * - ISK, UGX: sent as two-decimal values whose last two digits are 00 (5 ISK -> 500)
+ * - HUF, TWD: two decimals for charges, but payouts must be whole units (multiple of 100)
+ * - BHD JOD KWD OMR TND: three decimals, last digit must be 0 (UAE accounts only)
+ */
+import { STRIPE_RULES } from './generated/stripe.js';
+import { type CurrencyInput, type Money } from './money.js';
+import type { RoundingMode } from './rounding.js';
+export { STRIPE_RULES };
+/** Whether Stripe supports the currency as a presentment currency. */
+export declare const isStripeCurrency: (currency: string) => boolean;
+/** The exponent Stripe's API uses for a currency (ISK 2, JPY 0, KWD 3, MGA 0). */
+export declare const stripeExponent: (currency: string) => number;
+/**
+ * Options for the Stripe amount: payout rules and how to round when Stripe needs a coarser amount.
+ */
+export interface StripeAmountOptions {
+    /** Payout amounts have stricter rules (HUF, TWD: whole units). */
+    readonly payout?: boolean;
+    /** How to round when Stripe needs a coarser amount (default 'unnecessary': throw). */
+    readonly rounding?: RoundingMode;
+}
+/** The integer `amount` to send to Stripe, e.g. toStripeAmount(money('5', 'ISK')) === 500. */
+export declare function toStripeAmount(money: Money, options?: StripeAmountOptions): number;
+/** `{ amount, currency }` with Stripe's lowercase currency code, ready for a PaymentIntent. */
+export declare function toStripe(money: Money, options?: StripeAmountOptions): {
+    amount: number;
+    currency: string;
+};
+/** Reads a Stripe amount (e.g. from a webhook): fromStripe(500, 'isk') is 5 ISK. */
+export declare function fromStripe<C extends CurrencyInput>(amount: number | bigint, currency: C): Money<Uppercase<C>>;
+//# sourceMappingURL=stripe.d.ts.map

package/dist/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../src/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,CAAC;AAUxB,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,OACA,CAAC;AAErD,kFAAkF;AAClF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAA2B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CASlF;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CACtB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEtC;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,EAChD,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,CAAC,GACV,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAGrB"}

package/dist/stripe.js

@@ -0,0 +1,39 @@
+/**
+ * Stripe's minor-unit view. Stripe uses ISO exponents except where documented otherwise
+ * (https://docs.stripe.com/currencies, encoded in data/stripe.json):
+ * - zero-decimal: BIF CLP DJF GNF JPY KMF KRW MGA PYG RWF VND VUV XAF XOF XPF (note MGA: ISO says
+ *   2)
+ * - ISK, UGX: sent as two-decimal values whose last two digits are 00 (5 ISK -> 500)
+ * - HUF, TWD: two decimals for charges, but payouts must be whole units (multiple of 100)
+ * - BHD JOD KWD OMR TND: three decimals, last digit must be 0 (UAE accounts only)
+ */
+import { STRIPE_RULES } from './generated/stripe.js';
+import {} from './money.js';
+import { fromProcessorAmount, toProcessorAmount } from './processor.js';
+export { STRIPE_RULES };
+function rule(currency) {
+    const found = STRIPE_RULES[currency.toUpperCase()];
+    if (!found) {
+        throw new RangeError(`${currency} is not a Stripe presentment currency`);
+    }
+    return found;
+}
+/** Whether Stripe supports the currency as a presentment currency. */
+export const isStripeCurrency = (currency) => STRIPE_RULES[currency.toUpperCase()] !== undefined;
+/** The exponent Stripe's API uses for a currency (ISK 2, JPY 0, KWD 3, MGA 0). */
+export const stripeExponent = (currency) => rule(currency)[0];
+/** The integer `amount` to send to Stripe, e.g. toStripeAmount(money('5', 'ISK')) === 500. */
+export function toStripeAmount(money, options) {
+    const [exp, charge, payout] = rule(money.currency);
+    return toProcessorAmount('Stripe', money, exp, options?.payout ? payout : charge, options?.rounding ?? 'unnecessary');
+}
+/** `{ amount, currency }` with Stripe's lowercase currency code, ready for a PaymentIntent. */
+export function toStripe(money, options) {
+    return { amount: toStripeAmount(money, options), currency: money.currency.toLowerCase() };
+}
+/** Reads a Stripe amount (e.g. from a webhook): fromStripe(500, 'isk') is 5 ISK. */
+export function fromStripe(amount, currency) {
+    const code = currency.toUpperCase();
+    return fromProcessorAmount('Stripe', amount, code, rule(code)[0]);
+}
+//# sourceMappingURL=stripe.js.map

package/dist/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../src/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAkC,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,SAAS,IAAI,CAAC,QAAgB;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,uCAAuC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAW,EAAE,CAC5D,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,CAAC;AAErD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAY9E,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAA6B;IACxE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,iBAAiB,CACtB,QAAQ,EACR,KAAK,EACL,GAAG,EACH,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EACjC,OAAO,EAAE,QAAQ,IAAI,aAAa,CACnC,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CACtB,KAAY,EACZ,OAA6B;IAE7B,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;AAC5F,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CACxB,MAAuB,EACvB,QAAW;IAEX,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAkB,CAAC;IACpD,OAAO,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/tax.d.ts

@@ -0,0 +1,29 @@
+import { type Factor } from './decimal.js';
+import { type Money } from './money.js';
+import { type RoundingMode } from './rounding.js';
+/**
+ * percent% of m: percentage(EUR 80, '12.5', 'halfEven') = EUR 10.00. Rounding defaults to
+ * 'halfExpand'.
+ */
+export declare function percentage<C extends string>(money: Money<C>, percent: Factor, rounding?: RoundingMode): Money<C>;
+/** A tax split: net + tax is always exactly gross. */
+export interface TaxBreakdown<C extends string> {
+    readonly net: Money<C>;
+    readonly tax: Money<C>;
+    /** Always exactly net + tax. */
+    readonly gross: Money<C>;
+}
+/**
+ * Tax-exclusive: adds percent% tax to a net amount. addTax(EUR 10, '20', 'halfEven') -> net 10, tax
+ * 2, gross 12.
+ */
+export declare function addTax<C extends string>(net: Money<C>, percent: Factor, rounding?: RoundingMode): TaxBreakdown<C>;
+/**
+ * Tax-inclusive: extracts percent% tax contained in a gross amount (VAT extraction).
+ * net = gross / (1 + percent/100) rounded; tax = gross - net, so the parts always add up.
+ * extractTax(EUR 12, '20', 'halfEven') -> net 10.00, tax 2.00.
+ */
+export declare function extractTax<C extends string>(gross: Money<C>, percent: Factor, rounding?: RoundingMode): TaxBreakdown<C>;
+/** Price after a percent% discount; the discount amount is rounded with `rounding`. */
+export declare function discount<C extends string>(price: Money<C>, percent: Factor, rounding?: RoundingMode): Money<C>;
+//# sourceMappingURL=tax.d.ts.map