@fin.cx/einvoice 5.0.2 → 5.1.2

package/dist_ts/formats/utils/currency.utils.js

@@ -0,0 +1,250 @@
+/**
+ * ISO 4217 Currency utilities for EN16931 compliance
+ * Provides currency-aware rounding and decimal handling
+ */
+/**
+ * ISO 4217 Currency minor units (decimal places)
+ * Based on ISO 4217:2015 standard
+ *
+ * Most currencies use 2 decimal places, but there are exceptions:
+ * - 0 decimals: JPY, KRW, CLP, etc.
+ * - 3 decimals: BHD, IQD, JOD, KWD, OMR, TND
+ * - 4 decimals: CLF (Chilean Unit of Account)
+ */
+export const ISO4217MinorUnits = {
+    // Major currencies
+    'EUR': 2, // Euro
+    'USD': 2, // US Dollar
+    'GBP': 2, // British Pound
+    'CHF': 2, // Swiss Franc
+    'CAD': 2, // Canadian Dollar
+    'AUD': 2, // Australian Dollar
+    'NZD': 2, // New Zealand Dollar
+    'CNY': 2, // Chinese Yuan
+    'INR': 2, // Indian Rupee
+    'MXN': 2, // Mexican Peso
+    'BRL': 2, // Brazilian Real
+    'RUB': 2, // Russian Ruble
+    'ZAR': 2, // South African Rand
+    'SGD': 2, // Singapore Dollar
+    'HKD': 2, // Hong Kong Dollar
+    'NOK': 2, // Norwegian Krone
+    'SEK': 2, // Swedish Krona
+    'DKK': 2, // Danish Krone
+    'PLN': 2, // Polish Zloty
+    'CZK': 2, // Czech Koruna
+    'HUF': 2, // Hungarian Forint (technically 2, though often shown as 0)
+    'RON': 2, // Romanian Leu
+    'BGN': 2, // Bulgarian Lev
+    'HRK': 2, // Croatian Kuna
+    'TRY': 2, // Turkish Lira
+    'ISK': 0, // Icelandic Króna (0 decimals)
+    // Zero decimal currencies
+    'JPY': 0, // Japanese Yen
+    'KRW': 0, // South Korean Won
+    'CLP': 0, // Chilean Peso
+    'PYG': 0, // Paraguayan Guaraní
+    'RWF': 0, // Rwandan Franc
+    'VND': 0, // Vietnamese Dong
+    'XAF': 0, // CFA Franc BEAC
+    'XOF': 0, // CFA Franc BCEAO
+    'XPF': 0, // CFP Franc
+    'BIF': 0, // Burundian Franc
+    'DJF': 0, // Djiboutian Franc
+    'GNF': 0, // Guinean Franc
+    'KMF': 0, // Comorian Franc
+    'MGA': 0, // Malagasy Ariary
+    'UGX': 0, // Ugandan Shilling
+    'VUV': 0, // Vanuatu Vatu
+    // Three decimal currencies
+    'BHD': 3, // Bahraini Dinar
+    'IQD': 3, // Iraqi Dinar
+    'JOD': 3, // Jordanian Dinar
+    'KWD': 3, // Kuwaiti Dinar
+    'LYD': 3, // Libyan Dinar
+    'OMR': 3, // Omani Rial
+    'TND': 3, // Tunisian Dinar
+    // Four decimal currencies
+    'CLF': 4, // Chilean Unit of Account (UF)
+    'UYW': 4, // Unidad Previsional (Uruguay)
+};
+/**
+ * Rounding modes for currency calculations
+ */
+export var RoundingMode;
+(function (RoundingMode) {
+    RoundingMode["HALF_UP"] = "HALF_UP";
+    RoundingMode["HALF_DOWN"] = "HALF_DOWN";
+    RoundingMode["HALF_EVEN"] = "HALF_EVEN";
+    RoundingMode["UP"] = "UP";
+    RoundingMode["DOWN"] = "DOWN";
+    RoundingMode["CEILING"] = "CEILING";
+    RoundingMode["FLOOR"] = "FLOOR"; // Round toward negative infinity
+})(RoundingMode || (RoundingMode = {}));
+/**
+ * Get minor units (decimal places) for a currency
+ */
+export function getCurrencyMinorUnits(currencyCode) {
+    const code = currencyCode.toUpperCase();
+    return ISO4217MinorUnits[code] ?? 2; // Default to 2 if unknown
+}
+/**
+ * Round a value according to currency rules
+ */
+export function roundToCurrency(value, currencyCode, mode = RoundingMode.HALF_UP) {
+    const minorUnits = getCurrencyMinorUnits(currencyCode);
+    if (minorUnits === 0) {
+        // For zero decimal currencies, round to integer
+        return Math.round(value);
+    }
+    const multiplier = Math.pow(10, minorUnits);
+    const scaled = value * multiplier;
+    let rounded;
+    switch (mode) {
+        case RoundingMode.HALF_UP:
+            // Round half values away from zero
+            if (scaled >= 0) {
+                rounded = Math.floor(scaled + 0.5);
+            }
+            else {
+                rounded = Math.ceil(scaled - 0.5);
+            }
+            break;
+        case RoundingMode.HALF_DOWN:
+            // Round half values toward zero
+            const fraction = Math.abs(scaled % 1);
+            if (fraction === 0.5) {
+                // Exactly 0.5 - round toward zero
+                rounded = scaled >= 0 ? Math.floor(scaled) : Math.ceil(scaled);
+            }
+            else {
+                // Not exactly 0.5 - use normal rounding
+                rounded = Math.round(scaled);
+            }
+            break;
+        case RoundingMode.HALF_EVEN:
+            // Banker's rounding
+            const isHalf = Math.abs(scaled % 1) === 0.5;
+            if (isHalf) {
+                const floor = Math.floor(scaled);
+                rounded = floor % 2 === 0 ? floor : Math.ceil(scaled);
+            }
+            else {
+                rounded = Math.round(scaled);
+            }
+            break;
+        case RoundingMode.UP:
+            rounded = scaled >= 0 ? Math.ceil(scaled) : Math.floor(scaled);
+            break;
+        case RoundingMode.DOWN:
+            rounded = Math.trunc(scaled);
+            break;
+        case RoundingMode.CEILING:
+            rounded = Math.ceil(scaled);
+            break;
+        case RoundingMode.FLOOR:
+            rounded = Math.floor(scaled);
+            break;
+        default:
+            rounded = Math.round(scaled);
+    }
+    return rounded / multiplier;
+}
+/**
+ * Get tolerance for currency comparison
+ * Based on the smallest representable unit for the currency
+ */
+export function getCurrencyTolerance(currencyCode) {
+    const minorUnits = getCurrencyMinorUnits(currencyCode);
+    // Tolerance is half of the smallest unit
+    return 0.5 * Math.pow(10, -minorUnits);
+}
+/**
+ * Compare two monetary values with currency-aware tolerance
+ */
+export function areMonetaryValuesEqual(value1, value2, currencyCode) {
+    const tolerance = getCurrencyTolerance(currencyCode);
+    return Math.abs(value1 - value2) <= tolerance;
+}
+/**
+ * Format a value according to currency decimal places
+ */
+export function formatCurrencyValue(value, currencyCode) {
+    const minorUnits = getCurrencyMinorUnits(currencyCode);
+    return value.toFixed(minorUnits);
+}
+/**
+ * Validate if a value has correct decimal places for a currency
+ */
+export function hasValidDecimalPlaces(value, currencyCode) {
+    const minorUnits = getCurrencyMinorUnits(currencyCode);
+    const multiplier = Math.pow(10, minorUnits);
+    const scaled = Math.round(value * multiplier);
+    const reconstructed = scaled / multiplier;
+    return Math.abs(value - reconstructed) < Number.EPSILON;
+}
+/**
+ * Currency calculation context for EN16931 compliance
+ */
+export class CurrencyCalculator {
+    constructor(config) {
+        if (typeof config === 'string') {
+            this.currency = config;
+            this.minorUnits = getCurrencyMinorUnits(config);
+            this.roundingMode = RoundingMode.HALF_UP;
+        }
+        else {
+            this.currency = config.code;
+            this.minorUnits = config.minorUnits;
+            this.roundingMode = config.roundingMode;
+        }
+    }
+    /**
+     * Round a value according to configured rules
+     */
+    round(value) {
+        return roundToCurrency(value, this.currency, this.roundingMode);
+    }
+    /**
+     * Calculate line net amount with rounding
+     * EN16931: Line net = (quantity × unit price) - line discounts
+     */
+    calculateLineNet(quantity, unitPrice, discount = 0) {
+        const gross = quantity * unitPrice;
+        const net = gross - discount;
+        return this.round(net);
+    }
+    /**
+     * Calculate VAT amount with rounding
+     * EN16931: VAT amount = taxable amount × (rate / 100)
+     */
+    calculateVAT(taxableAmount, rate) {
+        const vat = taxableAmount * (rate / 100);
+        return this.round(vat);
+    }
+    /**
+     * Compare values with currency-aware tolerance
+     */
+    areEqual(value1, value2) {
+        return areMonetaryValuesEqual(value1, value2, this.currency);
+    }
+    /**
+     * Get the tolerance for comparisons
+     */
+    getTolerance() {
+        return getCurrencyTolerance(this.currency);
+    }
+    /**
+     * Format value for display
+     */
+    format(value) {
+        return formatCurrencyValue(value, this.currency);
+    }
+}
+/**
+ * Get version info for ISO 4217 data
+ */
+export function getISO4217Version() {
+    return '2015'; // Update when currency list is updated
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3VycmVuY3kudXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9mb3JtYXRzL3V0aWxzL2N1cnJlbmN5LnV0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVIOzs7Ozs7OztHQVFHO0FBQ0gsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQTJCO0lBQ3ZELG1CQUFtQjtJQUNuQixLQUFLLEVBQUUsQ0FBQyxFQUFFLE9BQU87SUFDakIsS0FBSyxFQUFFLENBQUMsRUFBRSxZQUFZO0lBQ3RCLEtBQUssRUFBRSxDQUFDLEVBQUUsZ0JBQWdCO0lBQzFCLEtBQUssRUFBRSxDQUFDLEVBQUUsY0FBYztJQUN4QixLQUFLLEVBQUUsQ0FBQyxFQUFFLGtCQUFrQjtJQUM1QixLQUFLLEVBQUUsQ0FBQyxFQUFFLG9CQUFvQjtJQUM5QixLQUFLLEVBQUUsQ0FBQyxFQUFFLHFCQUFxQjtJQUMvQixLQUFLLEVBQUUsQ0FBQyxFQUFFLGVBQWU7SUFDekIsS0FBSyxFQUFFLENBQUMsRUFBRSxlQUFlO0lBQ3pCLEtBQUssRUFBRSxDQUFDLEVBQUUsZUFBZTtJQUN6QixLQUFLLEVBQUUsQ0FBQyxFQUFFLGlCQUFpQjtJQUMzQixLQUFLLEVBQUUsQ0FBQyxFQUFFLGdCQUFnQjtJQUMxQixLQUFLLEVBQUUsQ0FBQyxFQUFFLHFCQUFxQjtJQUMvQixLQUFLLEVBQUUsQ0FBQyxFQUFFLG1CQUFtQjtJQUM3QixLQUFLLEVBQUUsQ0FBQyxFQUFFLG1CQUFtQjtJQUM3QixLQUFLLEVBQUUsQ0FBQyxFQUFFLGtCQUFrQjtJQUM1QixLQUFLLEVBQUUsQ0FBQyxFQUFFLGdCQUFnQjtJQUMxQixLQUFLLEVBQUUsQ0FBQyxFQUFFLGVBQWU7SUFDekIsS0FBSyxFQUFFLENBQUMsRUFBRSxlQUFlO0lBQ3pCLEtBQUssRUFBRSxDQUFDLEVBQUUsZUFBZTtJQUN6QixLQUFLLEVBQUUsQ0FBQyxFQUFFLDREQUE0RDtJQUN0RSxLQUFLLEVB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

package/dist_ts/formats/utils/decimal.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Decimal Arithmetic Library for EN16931 Compliance
+ * Provides arbitrary precision decimal arithmetic to avoid floating-point errors
+ *
+ * Based on EN16931 requirements for financial calculations:
+ * - All monetary amounts must be calculated with sufficient precision
+ * - Rounding must be consistent and predictable
+ * - No loss of precision in intermediate calculations
+ */
+/**
+ * Decimal class for arbitrary precision arithmetic
+ * Internally stores the value as an integer with a scale factor
+ */
+export declare class Decimal {
+    private readonly value;
+    private readonly scale;
+    private static _ZERO;
+    private static _ONE;
+    private static _TEN;
+    private static _HUNDRED;
+    static get ZERO(): Decimal;
+    static get ONE(): Decimal;
+    static get TEN(): Decimal;
+    static get HUNDRED(): Decimal;
+    private static readonly DEFAULT_SCALE;
+    /**
+     * Create a new Decimal from various input types
+     */
+    constructor(value: string | number | bigint | Decimal, scale?: number);
+    /**
+     * Convert to string representation
+     */
+    toString(decimalPlaces?: number): string;
+    /**
+     * Convert to number (may lose precision)
+     */
+    toNumber(): number;
+    /**
+     * Convert to fixed decimal places string
+     */
+    toFixed(decimalPlaces: number): string;
+    /**
+     * Add two decimals
+     */
+    add(other: Decimal | number | string): Decimal;
+    /**
+     * Subtract another decimal
+     */
+    subtract(other: Decimal | number | string): Decimal;
+    /**
+     * Multiply by another decimal
+     */
+    multiply(other: Decimal | number | string): Decimal;
+    /**
+     * Divide by another decimal
+     */
+    divide(other: Decimal | number | string, precision?: number): Decimal;
+    /**
+     * Calculate percentage (this * rate / 100)
+     */
+    percentage(rate: Decimal | number | string): Decimal;
+    /**
+     * Round to specified decimal places using a specific rounding mode
+     */
+    round(decimalPlaces: number, mode?: 'HALF_UP' | 'HALF_DOWN' | 'HALF_EVEN' | 'UP' | 'DOWN' | 'CEILING' | 'FLOOR'): Decimal;
+    /**
+     * Compare with another decimal
+     */
+    compareTo(other: Decimal | number | string): number;
+    /**
+     * Check equality
+     */
+    equals(other: Decimal | number | string, tolerance?: Decimal | number | string): boolean;
+    /**
+     * Check if less than
+     */
+    lessThan(other: Decimal | number | string): boolean;
+    /**
+     * Check if less than or equal
+     */
+    lessThanOrEqual(other: Decimal | number | string): boolean;
+    /**
+     * Check if greater than
+     */
+    greaterThan(other: Decimal | number | string): boolean;
+    /**
+     * Check if greater than or equal
+     */
+    greaterThanOrEqual(other: Decimal | number | string): boolean;
+    /**
+     * Get absolute value
+     */
+    abs(): Decimal;
+    /**
+     * Negate the value
+     */
+    negate(): Decimal;
+    /**
+     * Check if zero
+     */
+    isZero(): boolean;
+    /**
+     * Check if negative
+     */
+    isNegative(): boolean;
+    /**
+     * Check if positive
+     */
+    isPositive(): boolean;
+    /**
+     * Rescale to a different number of decimal places
+     */
+    private rescale;
+    /**
+     * Normalize by removing trailing zeros
+     */
+    private normalize;
+    /**
+     * Create a Decimal from a percentage string (e.g., "19%" -> 0.19)
+     */
+    static fromPercentage(value: string): Decimal;
+    /**
+     * Sum an array of decimals
+     */
+    static sum(values: (Decimal | number | string)[]): Decimal;
+    /**
+     * Get the minimum value
+     */
+    static min(...values: (Decimal | number | string)[]): Decimal;
+    /**
+     * Get the maximum value
+     */
+    static max(...values: (Decimal | number | string)[]): Decimal;
+}
+/**
+ * Helper function to create a Decimal
+ */
+export declare function decimal(value: string | number | bigint | Decimal): Decimal;
+/**
+ * Export commonly used rounding modes
+ */
+export declare const RoundingMode: {
+    readonly HALF_UP: "HALF_UP";
+    readonly HALF_DOWN: "HALF_DOWN";
+    readonly HALF_EVEN: "HALF_EVEN";
+    readonly UP: "UP";
+    readonly DOWN: "DOWN";
+    readonly CEILING: "CEILING";
+    readonly FLOOR: "FLOOR";
+};
+export type RoundingMode = typeof RoundingMode[keyof typeof RoundingMode];