subunit-money 2.1.1 → 3.1.0

package/dist/currency.js

@@ -1,15 +1,7 @@
-"use strict";
 /**
  * Currency registry and types.
  * Manages ISO 4217 currency definitions and custom currencies.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerCurrency = registerCurrency;
-exports.getCurrency = getCurrency;
-exports.hasCurrency = hasCurrency;
-exports.getAllCurrencies = getAllCurrencies;
-exports.loadCurrencyMap = loadCurrencyMap;
-exports.clearCurrencies = clearCurrencies;
 // Internal registry - mutable for registerCurrency()
 const currencies = new Map();
 /**
@@ -17,33 +9,33 @@ const currencies = new Map();
  * @param code - ISO 4217 currency code (e.g., 'USD', 'EUR', 'BTC')
  * @param decimalDigits - Number of decimal places (e.g., 2 for USD, 8 for BTC)
  */
-function registerCurrency(code, decimalDigits) {
+export function registerCurrency(code, decimalDigits) {
     currencies.set(code, { code, decimalDigits });
 }
 /**
  * Get a currency definition by code.
  * @returns The currency definition, or undefined if not registered
  */
-function getCurrency(code) {
+export function getCurrency(code) {
     return currencies.get(code);
 }
 /**
  * Check if a currency is registered.
  */
-function hasCurrency(code) {
+export function hasCurrency(code) {
     return currencies.has(code);
 }
 /**
  * Get all registered currencies, sorted by code.
  */
-function getAllCurrencies() {
+export function getAllCurrencies() {
     return Array.from(currencies.values()).sort((a, b) => a.code.localeCompare(b.code));
 }
 /**
  * Load currencies from the legacy currencymap.json format.
  * @param map - Object with currency codes as keys and {decimal_digits: number} as values
  */
-function loadCurrencyMap(map) {
+export function loadCurrencyMap(map) {
     for (const [code, data] of Object.entries(map)) {
         registerCurrency(code, data.decimal_digits);
     }
@@ -51,6 +43,6 @@ function loadCurrencyMap(map) {
 /**
  * Clear all registered currencies. Useful for testing.
  */
-function clearCurrencies() {
+export function clearCurrencies() {
     currencies.clear();
 }

package/dist/errors.js

@@ -1,16 +1,13 @@
-"use strict";
 /**
  * Custom error types for Money operations.
  * All errors extend built-in Error types for proper instanceof checks.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExchangeRateError = exports.AmountError = exports.SubunitError = exports.CurrencyUnknownError = exports.CurrencyMismatchError = void 0;
 /**
  * Thrown when attempting operations between different currencies.
  * @example
  * new Money('USD', 10).add(new Money('EUR', 5)) // throws CurrencyMismatchError
  */
-class CurrencyMismatchError extends TypeError {
+export class CurrencyMismatchError extends TypeError {
     constructor(fromCurrency, toCurrency) {
         super(`Cannot operate on ${fromCurrency} and ${toCurrency} - currencies must match`);
         this.name = 'CurrencyMismatchError';
@@ -19,13 +16,12 @@ class CurrencyMismatchError extends TypeError {
         Error.captureStackTrace?.(this, CurrencyMismatchError);
     }
 }
-exports.CurrencyMismatchError = CurrencyMismatchError;
 /**
  * Thrown when using an unregistered currency code.
  * @example
  * new Money('FAKE', 10) // throws CurrencyUnknownError
  */
-class CurrencyUnknownError extends TypeError {
+export class CurrencyUnknownError extends TypeError {
     constructor(currency) {
         super(`Unknown currency '${currency}' - register it first with Money.registerCurrency()`);
         this.name = 'CurrencyUnknownError';
@@ -33,13 +29,12 @@ class CurrencyUnknownError extends TypeError {
         Error.captureStackTrace?.(this, CurrencyUnknownError);
     }
 }
-exports.CurrencyUnknownError = CurrencyUnknownError;
 /**
  * Thrown when an amount has more decimal places than the currency allows.
  * @example
  * new Money('USD', '1.234') // throws SubunitError (USD only allows 2 decimals)
  */
-class SubunitError extends RangeError {
+export class SubunitError extends RangeError {
     constructor(currency, maxDecimals) {
         super(`${currency} only supports ${maxDecimals} decimal place(s)`);
         this.name = 'SubunitError';
@@ -48,13 +43,12 @@ class SubunitError extends RangeError {
         Error.captureStackTrace?.(this, SubunitError);
     }
 }
-exports.SubunitError = SubunitError;
 /**
  * Thrown when an amount cannot be parsed as a valid number.
  * @example
  * new Money('USD', 'abc') // throws AmountError
  */
-class AmountError extends TypeError {
+export class AmountError extends TypeError {
     constructor(amount) {
         super(`Invalid amount: ${JSON.stringify(amount)}`);
         this.name = 'AmountError';
@@ -62,13 +56,12 @@ class AmountError extends TypeError {
         Error.captureStackTrace?.(this, AmountError);
     }
 }
-exports.AmountError = AmountError;
 /**
  * Thrown when an exchange rate is not available.
  * @example
  * converter.convert(usdMoney, 'XYZ') // throws ExchangeRateError if no USD->XYZ rate
  */
-class ExchangeRateError extends Error {
+export class ExchangeRateError extends Error {
     constructor(fromCurrency, toCurrency) {
         super(`No exchange rate available from ${fromCurrency} to ${toCurrency}`);
         this.name = 'ExchangeRateError';
@@ -77,4 +70,3 @@ class ExchangeRateError extends Error {
         Error.captureStackTrace?.(this, ExchangeRateError);
     }
 }
-exports.ExchangeRateError = ExchangeRateError;

package/dist/exchange-rate-service.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Exchange Rate Service - Central authority for currency conversion rates.
  *
@@ -14,8 +13,6 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _ExchangeRateService_instances, _ExchangeRateService_rates, _ExchangeRateService_key;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExchangeRateService = void 0;
 /**
  * Service for managing exchange rates between currencies.
  *
@@ -24,7 +21,7 @@ exports.ExchangeRateService = void 0;
  * rates.setRate('USD', 'EUR', 0.92, 'ECB')
  * rates.getRate('USD', 'EUR') // { from: 'USD', to: 'EUR', rate: '0.92', ... }
  */
-class ExchangeRateService {
+export class ExchangeRateService {
     constructor() {
         _ExchangeRateService_instances.add(this);
         _ExchangeRateService_rates.set(this, new Map()
@@ -168,7 +165,6 @@ class ExchangeRateService {
         }
     }
 }
-exports.ExchangeRateService = ExchangeRateService;
 _ExchangeRateService_rates = new WeakMap(), _ExchangeRateService_instances = new WeakSet(), _ExchangeRateService_key = function _ExchangeRateService_key(from, to) {
     return `${from}:${to}`;
 };

package/dist/index.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * subunit-money - A type-safe value object for monetary amounts
  *
@@ -16,33 +15,14 @@
  * const converter = new MoneyConverter(rates)
  * const euros = converter.convert(total, 'EUR')
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.clearCurrencies = exports.loadCurrencyMap = exports.getAllCurrencies = exports.hasCurrency = exports.getCurrency = exports.registerCurrency = exports.ExchangeRateError = exports.AmountError = exports.SubunitError = exports.CurrencyUnknownError = exports.CurrencyMismatchError = exports.MoneyConverter = exports.ExchangeRateService = exports.Money = void 0;
 // Core classes
-var money_js_1 = require("./money.js");
-Object.defineProperty(exports, "Money", { enumerable: true, get: function () { return money_js_1.Money; } });
-var exchange_rate_service_js_1 = require("./exchange-rate-service.js");
-Object.defineProperty(exports, "ExchangeRateService", { enumerable: true, get: function () { return exchange_rate_service_js_1.ExchangeRateService; } });
-var money_converter_js_1 = require("./money-converter.js");
-Object.defineProperty(exports, "MoneyConverter", { enumerable: true, get: function () { return money_converter_js_1.MoneyConverter; } });
+export { Money } from './money.js';
+export { ExchangeRateService } from './exchange-rate-service.js';
+export { MoneyConverter } from './money-converter.js';
 // Error types
-var errors_js_1 = require("./errors.js");
-Object.defineProperty(exports, "CurrencyMismatchError", { enumerable: true, get: function () { return errors_js_1.CurrencyMismatchError; } });
-Object.defineProperty(exports, "CurrencyUnknownError", { enumerable: true, get: function () { return errors_js_1.CurrencyUnknownError; } });
-Object.defineProperty(exports, "SubunitError", { enumerable: true, get: function () { return errors_js_1.SubunitError; } });
-Object.defineProperty(exports, "AmountError", { enumerable: true, get: function () { return errors_js_1.AmountError; } });
-Object.defineProperty(exports, "ExchangeRateError", { enumerable: true, get: function () { return errors_js_1.ExchangeRateError; } });
+export { CurrencyMismatchError, CurrencyUnknownError, SubunitError, AmountError, ExchangeRateError, } from './errors.js';
 // Currency utilities
-var currency_js_1 = require("./currency.js");
-Object.defineProperty(exports, "registerCurrency", { enumerable: true, get: function () { return currency_js_1.registerCurrency; } });
-Object.defineProperty(exports, "getCurrency", { enumerable: true, get: function () { return currency_js_1.getCurrency; } });
-Object.defineProperty(exports, "hasCurrency", { enumerable: true, get: function () { return currency_js_1.hasCurrency; } });
-Object.defineProperty(exports, "getAllCurrencies", { enumerable: true, get: function () { return currency_js_1.getAllCurrencies; } });
-Object.defineProperty(exports, "loadCurrencyMap", { enumerable: true, get: function () { return currency_js_1.loadCurrencyMap; } });
-Object.defineProperty(exports, "clearCurrencies", { enumerable: true, get: function () { return currency_js_1.clearCurrencies; } });
+export { registerCurrency, getCurrency, hasCurrency, getAllCurrencies, loadCurrencyMap, clearCurrencies, } from './currency.js';
 // Auto-load default currencies
 // The currencymap.json file is the official ISO 4217 currency list (List One) as of 2026-01-01,
 // sourced from SIX Financial Information AG (the ISO 4217 Maintenance Agency).
@@ -53,6 +33,6 @@ Object.defineProperty(exports, "clearCurrencies", { enumerable: true, get: funct
 //
 // Note: This excludes historical currencies, supranational funds, and precious metals,
 // keeping only active national and regional currencies for practical use.
-const currency_js_2 = require("./currency.js");
-const currencymap_json_1 = __importDefault(require("../currencymap.json"));
-(0, currency_js_2.loadCurrencyMap)(currencymap_json_1.default);
+import { loadCurrencyMap } from './currency.js';
+import currencyMap from '../currencymap.json';
+loadCurrencyMap(currencyMap);

package/dist/money-converter.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Money Converter - Safe cross-currency operations.
  *
@@ -19,11 +18,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _MoneyConverter_instances, _MoneyConverter_rateService, _MoneyConverter_bankersRound;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoneyConverter = void 0;
-const money_js_1 = require("./money.js");
-const errors_js_1 = require("./errors.js");
-const currency_js_1 = require("./currency.js");
+import { Money } from './money.js';
+import { ExchangeRateError, CurrencyUnknownError } from './errors.js';
+import { getCurrency } from './currency.js';
 /**
  * Converter for performing operations between different currencies.
  *
@@ -35,7 +32,7 @@ const currency_js_1 = require("./currency.js");
  * const euros = converter.convert(new Money('USD', '100'), 'EUR')
  * console.log(euros.toString()) // "92.00 EUR"
  */
-class MoneyConverter {
+export class MoneyConverter {
     constructor(rateService) {
         _MoneyConverter_instances.add(this);
         _MoneyConverter_rateService.set(this, void 0);
@@ -53,15 +50,15 @@ class MoneyConverter {
         if (money.currency === targetCurrency) {
             return money;
         }
-        const currencyDef = (0, currency_js_1.getCurrency)(targetCurrency);
+        const currencyDef = getCurrency(targetCurrency);
         if (!currencyDef) {
-            throw new errors_js_1.CurrencyUnknownError(targetCurrency);
+            throw new CurrencyUnknownError(targetCurrency);
         }
         const rate = __classPrivateFieldGet(this, _MoneyConverter_rateService, "f").getRate(money.currency, targetCurrency);
         if (!rate) {
-            throw new errors_js_1.ExchangeRateError(money.currency, targetCurrency);
+            throw new ExchangeRateError(money.currency, targetCurrency);
         }
-        const sourceCurrencyDef = (0, currency_js_1.getCurrency)(money.currency);
+        const sourceCurrencyDef = getCurrency(money.currency);
         const sourceSubunits = money.toSubunits();
         const sourceMultiplier = 10n ** BigInt(sourceCurrencyDef.decimalDigits);
         const targetMultiplier = 10n ** BigInt(currencyDef.decimalDigits);
@@ -72,7 +69,7 @@ class MoneyConverter {
         const product = sourceSubunits * rateBigInt * targetMultiplier;
         const divisor = rateMultiplier * sourceMultiplier;
         const targetSubunits = __classPrivateFieldGet(this, _MoneyConverter_instances, "m", _MoneyConverter_bankersRound).call(this, product, divisor);
-        return money_js_1.Money.fromSubunits(targetSubunits, targetCurrency);
+        return Money.fromSubunits(targetSubunits, targetCurrency);
     }
     /**
      * Add two Money amounts, converting as needed.
@@ -121,7 +118,7 @@ class MoneyConverter {
      * @returns Total in the target currency
      */
     sum(amounts, targetCurrency) {
-        let total = money_js_1.Money.zero(targetCurrency);
+        let total = Money.zero(targetCurrency);
         for (const amount of amounts) {
             const converted = this.convert(amount, targetCurrency);
             total = total.add(converted);
@@ -139,7 +136,7 @@ class MoneyConverter {
     compare(a, b) {
         // Convert b to a's currency for comparison
         const bConverted = this.convert(b, a.currency);
-        return money_js_1.Money.compare(a, bConverted);
+        return Money.compare(a, bConverted);
     }
     /**
      * Get the exchange rate service (for direct rate access).
@@ -148,7 +145,6 @@ class MoneyConverter {
         return __classPrivateFieldGet(this, _MoneyConverter_rateService, "f");
     }
 }
-exports.MoneyConverter = MoneyConverter;
 _MoneyConverter_rateService = new WeakMap(), _MoneyConverter_instances = new WeakSet(), _MoneyConverter_bankersRound = function _MoneyConverter_bankersRound(numerator, denominator) {
     if (denominator === 1n)
         return numerator;

package/dist/money.d.ts

@@ -59,13 +59,7 @@ export declare class Money<C extends string = string> {
      * Multiply by a factor.
      *
      * DESIGN: Rounds immediately after multiplication using banker's rounding
-     * (round half-to-even). This prevents the "split penny problem" where
-     * line-item rounding differs from deferred rounding:
-     *   Per-item: $1.65 tax × 10 items = $16.50 ✓ (matches receipt)
-     *   Deferred: 10 × $1.649175 = $16.49 ✗ (missing penny)
-     *
-     * For chained calculations without intermediate rounding, perform arithmetic
-     * in Number space first, then create a Money object with the final result.
+     * (round half-to-even). This prevents the "split penny problem".
      */
     multiply(factor: number): Money<C>;
     /**
@@ -74,10 +68,6 @@ export declare class Money<C extends string = string> {
      *
      * @param proportions - Array of proportions (e.g., [1, 1, 1] for three-way split)
      * @returns Array of Money objects that sum to the original amount
-     *
-     * @example
-     * new Money('USD', '100').allocate([1, 1, 1])
-     * // Returns: [Money('33.34'), Money('33.33'), Money('33.33')]
      */
     allocate(proportions: number[]): Money<C>[];
     /**