soff-money 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# soff-money 💸
+
+Safe money handling for JavaScript with integer-based arithmetic and LATAM locale formatting.
+
+## The Problem
+
+In JavaScript, `0.1 + 0.2 === 0.30000000000000004`. This is fatal for e-commerce or financial applications. Additionally, formatting currencies in Latin America is painful - does the symbol go before or after? Dots or commas for thousands?
+
+## The Solution
+
+A library that handles money using integers (Safe Money pattern) and formats according to the country's locale.
+
+## Features
+
+- 🔢 **Integer-based arithmetic** - No floating point errors
+- 🌎 **LATAM-first locales** - CO, MX, AR, BR, US
+- 🌳 **Tree-shakeable** - Import only what you need
+- 📦 **Tiny bundle** - Core is < 2KB gzipped
+- 💯 **TypeScript** - Full type safety
+- ⚡ **Zero dependencies** - Pure JavaScript
+
+## Installation
+
+```bash
+npm install soff-money
+```
+
+## Quick Start
+
+```typescript
+import { Money } from 'soff-money';
+import { COP } from 'soff-money/locales/co';
+
+// Create money from cents (safe)
+const price = Money.fromCents(10000, COP); // $100.00 COP
+
+// Arithmetic operations
+const total = price.add(Money.fromCents(5000, COP)); // $150.00
+const discounted = total.multiply(0.9); // $135.00
+
+// Format for display
+console.log(total.format()); // "$ 150,00" or "$150.00" depending on locale
+
+// Safe distribution (no lost cents!)
+const [part1, part2, part3] = Money.fromCents(10000, COP).distribute(3);
+// 33.34 + 33.33 + 33.33 = 100.00 ✓
+```
+
+## Killer Feature: Fair Distribution
+
+When splitting money, you never lose cents:
+
+```typescript
+const bill = Money.fromCents(10000, COP); // $100.00
+const [alice, bob, charlie] = bill.distribute(3);
+
+// alice:   $33.34
+// bob:     $33.33
+// charlie: $33.33
+// Total:   $100.00 ✓ (not $99.99!)
+```
+
+## Available Locales
+
+| Locale | Currency | Symbol | Format      |
+| ------ | -------- | ------ | ----------- |
+| `co`   | COP      | $      | $ 1.000,00  |
+| `mx`   | MXN      | $      | $1,000.00   |
+| `ar`   | ARS      | $      | $ 1.000,00  |
+| `br`   | BRL      | R$     | R$ 1.000,00 |
+| `us`   | USD      | $      | $1,000.00   |
+
+## License
+
+MIT

package/dist/core/index.cjs

@@ -0,0 +1,244 @@
+'use strict';
+
+// src/core/money.ts
+var Money = class _Money {
+  constructor(cents, currency) {
+    if (!Number.isInteger(cents)) {
+      throw new Error("Money must be created with an integer number of cents");
+    }
+    this.cents = cents;
+    this.currency = currency;
+    Object.freeze(this);
+  }
+  /**
+   * Create money from cents (smallest unit)
+   */
+  static fromCents(cents, currency) {
+    return new _Money(Math.round(cents), currency);
+  }
+  /**
+   * Create money from a decimal amount
+   * @example Money.fromDecimal(100.50, USD) creates $100.50
+   */
+  static fromDecimal(amount, currency) {
+    const multiplier = Math.pow(10, currency.decimals);
+    const cents = Math.round(amount * multiplier);
+    return new _Money(cents, currency);
+  }
+  /**
+   * Create zero money
+   */
+  static zero(currency) {
+    return new _Money(0, currency);
+  }
+  /**
+   * Add another money value (must be same currency)
+   */
+  add(other) {
+    this.assertSameCurrency(other);
+    return new _Money(this.cents + other.cents, this.currency);
+  }
+  /**
+   * Subtract another money value (must be same currency)
+   */
+  subtract(other) {
+    this.assertSameCurrency(other);
+    return new _Money(this.cents - other.cents, this.currency);
+  }
+  /**
+   * Multiply by a factor (rounds to nearest cent)
+   */
+  multiply(factor) {
+    return new _Money(Math.round(this.cents * factor), this.currency);
+  }
+  /**
+   * Divide by a divisor (rounds to nearest cent)
+   */
+  divide(divisor) {
+    if (divisor === 0) {
+      throw new Error("Cannot divide by zero");
+    }
+    return new _Money(Math.round(this.cents / divisor), this.currency);
+  }
+  /**
+   * Distribute money evenly without losing cents
+   * The remainder is distributed to the first parts
+   * @example $100 / 3 = [$33.34, $33.33, $33.33]
+   */
+  distribute(parts) {
+    if (parts <= 0 || !Number.isInteger(parts)) {
+      throw new Error("Parts must be a positive integer");
+    }
+    const quotient = Math.floor(this.cents / parts);
+    const remainder = this.cents % parts;
+    const result = [];
+    for (let i = 0; i < parts; i++) {
+      const extra = i < remainder ? 1 : 0;
+      result.push(new _Money(quotient + extra, this.currency));
+    }
+    return result;
+  }
+  /**
+   * Distribute money according to ratios
+   * @example $100 with ratios [1, 2, 2] = [$20, $40, $40]
+   */
+  distributeByRatios(ratios) {
+    if (ratios.length === 0) {
+      throw new Error("Ratios array cannot be empty");
+    }
+    const total = ratios.reduce((sum, r) => sum + r, 0);
+    if (total <= 0) {
+      throw new Error("Sum of ratios must be positive");
+    }
+    let remaining = this.cents;
+    const result = [];
+    for (let i = 0; i < ratios.length; i++) {
+      if (i === ratios.length - 1) {
+        result.push(new _Money(remaining, this.currency));
+      } else {
+        const share = Math.round(this.cents * ratios[i] / total);
+        result.push(new _Money(share, this.currency));
+        remaining -= share;
+      }
+    }
+    return result;
+  }
+  /**
+   * Format money for display
+   */
+  format(options = {}) {
+    const { showSymbol = true, showDecimals = true, symbolPosition } = options;
+    const decimal = this.toDecimal();
+    const absValue = Math.abs(decimal);
+    const isNegative = decimal < 0;
+    let formatted;
+    if (showDecimals && this.currency.decimals > 0) {
+      const [intPart, decPart] = absValue.toFixed(this.currency.decimals).split(".");
+      const intFormatted = this.formatInteger(intPart);
+      formatted = `${intFormatted}${this.currency.decimalSeparator}${decPart}`;
+    } else {
+      formatted = this.formatInteger(Math.round(absValue).toString());
+    }
+    if (isNegative) {
+      formatted = `-${formatted}`;
+    }
+    if (showSymbol) {
+      const pos = symbolPosition ?? this.currency.symbolPosition;
+      const space = this.currency.symbolSpacing ? " " : "";
+      if (pos === "before") {
+        formatted = `${this.currency.symbol}${space}${formatted}`;
+      } else {
+        formatted = `${formatted}${space}${this.currency.symbol}`;
+      }
+    }
+    return formatted;
+  }
+  /**
+   * Get the decimal representation
+   */
+  toDecimal() {
+    return this.cents / Math.pow(10, this.currency.decimals);
+  }
+  /**
+   * Check equality with another money value
+   */
+  equals(other) {
+    return this.cents === other.cents && this.currency.code === other.currency.code;
+  }
+  /**
+   * Check if greater than another money value
+   */
+  greaterThan(other) {
+    this.assertSameCurrency(other);
+    return this.cents > other.cents;
+  }
+  /**
+   * Check if less than another money value
+   */
+  lessThan(other) {
+    this.assertSameCurrency(other);
+    return this.cents < other.cents;
+  }
+  /**
+   * Check if greater than or equal
+   */
+  greaterThanOrEqual(other) {
+    this.assertSameCurrency(other);
+    return this.cents >= other.cents;
+  }
+  /**
+   * Check if less than or equal
+   */
+  lessThanOrEqual(other) {
+    this.assertSameCurrency(other);
+    return this.cents <= other.cents;
+  }
+  /**
+   * Check if zero
+   */
+  isZero() {
+    return this.cents === 0;
+  }
+  /**
+   * Check if positive
+   */
+  isPositive() {
+    return this.cents > 0;
+  }
+  /**
+   * Check if negative
+   */
+  isNegative() {
+    return this.cents < 0;
+  }
+  /**
+   * Get absolute value
+   */
+  abs() {
+    return new _Money(Math.abs(this.cents), this.currency);
+  }
+  /**
+   * Negate the value
+   */
+  negate() {
+    return new _Money(-this.cents, this.currency);
+  }
+  /**
+   * Convert to JSON-serializable object
+   */
+  toJSON() {
+    return {
+      cents: this.cents,
+      currency: this.currency.code
+    };
+  }
+  /**
+   * String representation
+   */
+  toString() {
+    return this.format();
+  }
+  formatInteger(intStr) {
+    const parts = [];
+    let remaining = intStr;
+    while (remaining.length > 3) {
+      parts.unshift(remaining.slice(-3));
+      remaining = remaining.slice(0, -3);
+    }
+    if (remaining) {
+      parts.unshift(remaining);
+    }
+    return parts.join(this.currency.thousandsSeparator);
+  }
+  assertSameCurrency(other) {
+    if (this.currency.code !== other.currency.code) {
+      throw new Error(
+        `Cannot perform operation with different currencies: ${this.currency.code} and ${other.currency.code}`
+      );
+    }
+  }
+};
+
+exports.Money = Money;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/money.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Currency, FormatOptions, IMoney } from './types.js';\n\n/**\n * Immutable Money class that uses integer arithmetic for precision\n */\nexport class Money implements IMoney {\n  readonly cents: number;\n  readonly currency: Currency;\n\n  private constructor(cents: number, currency: Currency) {\n    if (!Number.isInteger(cents)) {\n      throw new Error('Money must be created with an integer number of cents');\n    }\n    this.cents = cents;\n    this.currency = currency;\n    Object.freeze(this);\n  }\n\n  /**\n   * Create money from cents (smallest unit)\n   */\n  static fromCents(cents: number, currency: Currency): Money {\n    return new Money(Math.round(cents), currency);\n  }\n\n  /**\n   * Create money from a decimal amount\n   * @example Money.fromDecimal(100.50, USD) creates $100.50\n   */\n  static fromDecimal(amount: number, currency: Currency): Money {\n    const multiplier = Math.pow(10, currency.decimals);\n    const cents = Math.round(amount * multiplier);\n    return new Money(cents, currency);\n  }\n\n  /**\n   * Create zero money\n   */\n  static zero(currency: Currency): Money {\n    return new Money(0, currency);\n  }\n\n  /**\n   * Add another money value (must be same currency)\n   */\n  add(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return new Money(this.cents + other.cents, this.currency);\n  }\n\n  /**\n   * Subtract another money value (must be same currency)\n   */\n  subtract(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return new Money(this.cents - other.cents, this.currency);\n  }\n\n  /**\n   * Multiply by a factor (rounds to nearest cent)\n   */\n  multiply(factor: number): Money {\n    return new Money(Math.round(this.cents * factor), this.currency);\n  }\n\n  /**\n   * Divide by a divisor (rounds to nearest cent)\n   */\n  divide(divisor: number): Money {\n    if (divisor === 0) {\n      throw new Error('Cannot divide by zero');\n    }\n    return new Money(Math.round(this.cents / divisor), this.currency);\n  }\n\n  /**\n   * Distribute money evenly without losing cents\n   * The remainder is distributed to the first parts\n   * @example $100 / 3 = [$33.34, $33.33, $33.33]\n   */\n  distribute(parts: number): Money[] {\n    if (parts <= 0 || !Number.isInteger(parts)) {\n      throw new Error('Parts must be a positive integer');\n    }\n\n    const quotient = Math.floor(this.cents / parts);\n    const remainder = this.cents % parts;\n\n    const result: Money[] = [];\n    for (let i = 0; i < parts; i++) {\n      // Add 1 cent to the first 'remainder' parts\n      const extra = i < remainder ? 1 : 0;\n      result.push(new Money(quotient + extra, this.currency));\n    }\n\n    return result;\n  }\n\n  /**\n   * Distribute money according to ratios\n   * @example $100 with ratios [1, 2, 2] = [$20, $40, $40]\n   */\n  distributeByRatios(ratios: number[]): Money[] {\n    if (ratios.length === 0) {\n      throw new Error('Ratios array cannot be empty');\n    }\n\n    const total = ratios.reduce((sum, r) => sum + r, 0);\n    if (total <= 0) {\n      throw new Error('Sum of ratios must be positive');\n    }\n\n    let remaining = this.cents;\n    const result: Money[] = [];\n\n    for (let i = 0; i < ratios.length; i++) {\n      if (i === ratios.length - 1) {\n        // Last part gets whatever is remaining to avoid rounding errors\n        result.push(new Money(remaining, this.currency));\n      } else {\n        const share = Math.round((this.cents * ratios[i]) / total);\n        result.push(new Money(share, this.currency));\n        remaining -= share;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Format money for display\n   */\n  format(options: FormatOptions = {}): string {\n    const { showSymbol = true, showDecimals = true, symbolPosition } = options;\n\n    const decimal = this.toDecimal();\n    const absValue = Math.abs(decimal);\n    const isNegative = decimal < 0;\n\n    // Format the number\n    let formatted: string;\n    if (showDecimals && this.currency.decimals > 0) {\n      const [intPart, decPart] = absValue.toFixed(this.currency.decimals).split('.');\n      const intFormatted = this.formatInteger(intPart);\n      formatted = `${intFormatted}${this.currency.decimalSeparator}${decPart}`;\n    } else {\n      formatted = this.formatInteger(Math.round(absValue).toString());\n    }\n\n    // Add negative sign\n    if (isNegative) {\n      formatted = `-${formatted}`;\n    }\n\n    // Add symbol\n    if (showSymbol) {\n      const pos = symbolPosition ?? this.currency.symbolPosition;\n      const space = this.currency.symbolSpacing ? ' ' : '';\n\n      if (pos === 'before') {\n        formatted = `${this.currency.symbol}${space}${formatted}`;\n      } else {\n        formatted = `${formatted}${space}${this.currency.symbol}`;\n      }\n    }\n\n    return formatted;\n  }\n\n  /**\n   * Get the decimal representation\n   */\n  toDecimal(): number {\n    return this.cents / Math.pow(10, this.currency.decimals);\n  }\n\n  /**\n   * Check equality with another money value\n   */\n  equals(other: IMoney): boolean {\n    return this.cents === other.cents && this.currency.code === other.currency.code;\n  }\n\n  /**\n   * Check if greater than another money value\n   */\n  greaterThan(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents > other.cents;\n  }\n\n  /**\n   * Check if less than another money value\n   */\n  lessThan(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents < other.cents;\n  }\n\n  /**\n   * Check if greater than or equal\n   */\n  greaterThanOrEqual(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents >= other.cents;\n  }\n\n  /**\n   * Check if less than or equal\n   */\n  lessThanOrEqual(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents <= other.cents;\n  }\n\n  /**\n   * Check if zero\n   */\n  isZero(): boolean {\n    return this.cents === 0;\n  }\n\n  /**\n   * Check if positive\n   */\n  isPositive(): boolean {\n    return this.cents > 0;\n  }\n\n  /**\n   * Check if negative\n   */\n  isNegative(): boolean {\n    return this.cents < 0;\n  }\n\n  /**\n   * Get absolute value\n   */\n  abs(): Money {\n    return new Money(Math.abs(this.cents), this.currency);\n  }\n\n  /**\n   * Negate the value\n   */\n  negate(): Money {\n    return new Money(-this.cents, this.currency);\n  }\n\n  /**\n   * Convert to JSON-serializable object\n   */\n  toJSON(): { cents: number; currency: string } {\n    return {\n      cents: this.cents,\n      currency: this.currency.code,\n    };\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return this.format();\n  }\n\n  private formatInteger(intStr: string): string {\n    const parts: string[] = [];\n    let remaining = intStr;\n\n    while (remaining.length > 3) {\n      parts.unshift(remaining.slice(-3));\n      remaining = remaining.slice(0, -3);\n    }\n\n    if (remaining) {\n      parts.unshift(remaining);\n    }\n\n    return parts.join(this.currency.thousandsSeparator);\n  }\n\n  private assertSameCurrency(other: IMoney): void {\n    if (this.currency.code !== other.currency.code) {\n      throw new Error(\n        `Cannot perform operation with different currencies: ${this.currency.code} and ${other.currency.code}`\n      );\n    }\n  }\n}\n"]}

package/dist/core/index.d.cts

@@ -0,0 +1,181 @@
+/**
+ * Currency configuration for a specific locale
+ */
+interface Currency {
+    /** ISO 4217 currency code (e.g., 'COP', 'USD') */
+    code: string;
+    /** Currency symbol (e.g., '$', 'R$') */
+    symbol: string;
+    /** Number of decimal places (usually 2, but some currencies use 0) */
+    decimals: number;
+    /** Thousands separator (e.g., '.' for CO, ',' for US) */
+    thousandsSeparator: string;
+    /** Decimal separator (e.g., ',' for CO, '.' for US) */
+    decimalSeparator: string;
+    /** Symbol position: 'before' or 'after' the amount */
+    symbolPosition: 'before' | 'after';
+    /** Space between symbol and amount */
+    symbolSpacing: boolean;
+}
+/**
+ * Options for formatting money
+ */
+interface FormatOptions {
+    /** Whether to show the currency symbol */
+    showSymbol?: boolean;
+    /** Whether to show decimal places */
+    showDecimals?: boolean;
+    /** Override the default symbol position */
+    symbolPosition?: 'before' | 'after';
+}
+/**
+ * Result of a money distribution operation
+ */
+type DistributionResult = Money[];
+/**
+ * Represents an immutable monetary value with safe integer arithmetic
+ */
+interface IMoney {
+    /** The amount in the smallest unit (cents) */
+    readonly cents: number;
+    /** The currency configuration */
+    readonly currency: Currency;
+    /** Add another money value */
+    add(other: IMoney): IMoney;
+    /** Subtract another money value */
+    subtract(other: IMoney): IMoney;
+    /** Multiply by a factor */
+    multiply(factor: number): IMoney;
+    /** Divide by a divisor */
+    divide(divisor: number): IMoney;
+    /** Distribute evenly without losing cents */
+    distribute(parts: number): IMoney[];
+    /** Format for display */
+    format(options?: FormatOptions): string;
+    /** Get the decimal amount */
+    toDecimal(): number;
+    /** Check equality */
+    equals(other: IMoney): boolean;
+    /** Check if greater than */
+    greaterThan(other: IMoney): boolean;
+    /** Check if less than */
+    lessThan(other: IMoney): boolean;
+    /** Check if zero */
+    isZero(): boolean;
+    /** Check if positive */
+    isPositive(): boolean;
+    /** Check if negative */
+    isNegative(): boolean;
+}
+
+/**
+ * Immutable Money class that uses integer arithmetic for precision
+ */
+declare class Money implements IMoney {
+    readonly cents: number;
+    readonly currency: Currency;
+    private constructor();
+    /**
+     * Create money from cents (smallest unit)
+     */
+    static fromCents(cents: number, currency: Currency): Money;
+    /**
+     * Create money from a decimal amount
+     * @example Money.fromDecimal(100.50, USD) creates $100.50
+     */
+    static fromDecimal(amount: number, currency: Currency): Money;
+    /**
+     * Create zero money
+     */
+    static zero(currency: Currency): Money;
+    /**
+     * Add another money value (must be same currency)
+     */
+    add(other: IMoney): Money;
+    /**
+     * Subtract another money value (must be same currency)
+     */
+    subtract(other: IMoney): Money;
+    /**
+     * Multiply by a factor (rounds to nearest cent)
+     */
+    multiply(factor: number): Money;
+    /**
+     * Divide by a divisor (rounds to nearest cent)
+     */
+    divide(divisor: number): Money;
+    /**
+     * Distribute money evenly without losing cents
+     * The remainder is distributed to the first parts
+     * @example $100 / 3 = [$33.34, $33.33, $33.33]
+     */
+    distribute(parts: number): Money[];
+    /**
+     * Distribute money according to ratios
+     * @example $100 with ratios [1, 2, 2] = [$20, $40, $40]
+     */
+    distributeByRatios(ratios: number[]): Money[];
+    /**
+     * Format money for display
+     */
+    format(options?: FormatOptions): string;
+    /**
+     * Get the decimal representation
+     */
+    toDecimal(): number;
+    /**
+     * Check equality with another money value
+     */
+    equals(other: IMoney): boolean;
+    /**
+     * Check if greater than another money value
+     */
+    greaterThan(other: IMoney): boolean;
+    /**
+     * Check if less than another money value
+     */
+    lessThan(other: IMoney): boolean;
+    /**
+     * Check if greater than or equal
+     */
+    greaterThanOrEqual(other: IMoney): boolean;
+    /**
+     * Check if less than or equal
+     */
+    lessThanOrEqual(other: IMoney): boolean;
+    /**
+     * Check if zero
+     */
+    isZero(): boolean;
+    /**
+     * Check if positive
+     */
+    isPositive(): boolean;
+    /**
+     * Check if negative
+     */
+    isNegative(): boolean;
+    /**
+     * Get absolute value
+     */
+    abs(): Money;
+    /**
+     * Negate the value
+     */
+    negate(): Money;
+    /**
+     * Convert to JSON-serializable object
+     */
+    toJSON(): {
+        cents: number;
+        currency: string;
+    };
+    /**
+     * String representation
+     */
+    toString(): string;
+    private formatInteger;
+    private assertSameCurrency;
+}
+
+export { type Currency, type DistributionResult, type FormatOptions, type IMoney, Money };