@adminiumjs/add-on-contracts 0.3.31 → 0.3.32

package/dist/payment-money.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Decimal text ↔ a provider's smallest unit, exactly.
+ *
+ * Money never passes through a float here. A provider half converts with its
+ * OWN exponent table (Stripe treats MGA as zero-decimal; PayPal sends HUF, JPY
+ * and TWD with no decimals), so these helpers take the exponent as an argument
+ * and the table is the provider's. An amount with more non-zero decimals than
+ * the exponent allows is refused (null), never rounded: rounding a customer's
+ * amount is taking a different amount.
+ */
+/** "120.50" at exponent 2 → "12050". "12000.00" at 0 → "12000". "45.2505" at 3 → null. */
+export declare function decimalToMinor(amount: string, exponent: number): string | null;
+/** "12050" at exponent 2 → "120.50". "12000" at 0 → "12000". */
+export declare function minorToDecimal(minor: string, exponent: number): string | null;
+/** True when two decimal texts are the same number ("120" and "120.00"). */
+export declare function sameAmount(a: string, b: string): boolean;
+/** Compares two decimal texts: -1, 0 or 1. Null when either is not a decimal. */
+export declare function compareAmounts(a: string, b: string): -1 | 0 | 1 | null;
+/** a + b as decimal text at `exponent` places. Null when either cannot be held there. */
+export declare function addAmounts(a: string, b: string, exponent: number): string | null;
+/** a − b as decimal text at `exponent` places. Null when either cannot be held there or b > a. */
+export declare function subtractAmounts(a: string, b: string, exponent: number): string | null;
+/**
+ * ISO 4217's minor units. The demo provider's table, and a starting point a
+ * real provider OVERRIDES with its own exceptions; never the engine's
+ * authority on what a provider takes.
+ */
+export declare function isoExponent(currency: string): number | null;
+//# sourceMappingURL=payment-money.d.ts.map

package/dist/payment-money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-money.d.ts","sourceRoot":"","sources":["../src/payment-money.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW9E;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO7E;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAQtE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhF;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrF;AAOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK3D"}

package/dist/payment-money.js

@@ -0,0 +1,99 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Decimal text ↔ a provider's smallest unit, exactly.
+ *
+ * Money never passes through a float here. A provider half converts with its
+ * OWN exponent table (Stripe treats MGA as zero-decimal; PayPal sends HUF, JPY
+ * and TWD with no decimals), so these helpers take the exponent as an argument
+ * and the table is the provider's. An amount with more non-zero decimals than
+ * the exponent allows is refused (null), never rounded: rounding a customer's
+ * amount is taking a different amount.
+ */
+/** "120.50" at exponent 2 → "12050". "12000.00" at 0 → "12000". "45.2505" at 3 → null. */
+export function decimalToMinor(amount, exponent) {
+    if (!Number.isInteger(exponent) || exponent < 0 || exponent > 6)
+        return null;
+    const match = /^(\d+)(?:\.(\d+))?$/.exec(amount);
+    if (match === null)
+        return null;
+    const whole = match[1] ?? '0';
+    const fraction = match[2] ?? '';
+    const kept = fraction.slice(0, exponent);
+    const rest = fraction.slice(exponent);
+    if (/[1-9]/.test(rest))
+        return null;
+    const digits = `${whole}${kept.padEnd(exponent, '0')}`.replace(/^0+(?=\d)/, '');
+    return digits === '' ? '0' : digits;
+}
+/** "12050" at exponent 2 → "120.50". "12000" at 0 → "12000". */
+export function minorToDecimal(minor, exponent) {
+    if (!Number.isInteger(exponent) || exponent < 0 || exponent > 6)
+        return null;
+    if (!/^\d+$/.test(minor))
+        return null;
+    const digits = minor.replace(/^0+(?=\d)/, '');
+    if (exponent === 0)
+        return digits;
+    const padded = digits.padStart(exponent + 1, '0');
+    return `${padded.slice(0, -exponent)}.${padded.slice(-exponent)}`;
+}
+/** True when two decimal texts are the same number ("120" and "120.00"). */
+export function sameAmount(a, b) {
+    const norm = (text) => {
+        const match = /^(\d+)(?:\.(\d+))?$/.exec(text);
+        if (match === null)
+            return null;
+        const whole = (match[1] ?? '0').replace(/^0+(?=\d)/, '');
+        const fraction = (match[2] ?? '').replace(/0+$/, '');
+        return fraction === '' ? whole : `${whole}.${fraction}`;
+    };
+    const left = norm(a);
+    return left !== null && left === norm(b);
+}
+/** Compares two decimal texts: -1, 0 or 1. Null when either is not a decimal. */
+export function compareAmounts(a, b) {
+    const scale = 6;
+    const left = decimalToMinor(a, scale);
+    const right = decimalToMinor(b, scale);
+    if (left === null || right === null)
+        return null;
+    const x = BigInt(left);
+    const y = BigInt(right);
+    return x < y ? -1 : x > y ? 1 : 0;
+}
+/** a + b as decimal text at `exponent` places. Null when either cannot be held there. */
+export function addAmounts(a, b, exponent) {
+    const left = decimalToMinor(a, exponent);
+    const right = decimalToMinor(b, exponent);
+    if (left === null || right === null)
+        return null;
+    return minorToDecimal((BigInt(left) + BigInt(right)).toString(), exponent);
+}
+/** a − b as decimal text at `exponent` places. Null when either cannot be held there or b > a. */
+export function subtractAmounts(a, b, exponent) {
+    const left = decimalToMinor(a, exponent);
+    const right = decimalToMinor(b, exponent);
+    if (left === null || right === null)
+        return null;
+    const result = BigInt(left) - BigInt(right);
+    return result < 0n ? null : minorToDecimal(result.toString(), exponent);
+}
+const ZERO_DECIMAL = new Set([
+    'BIF', 'CLP', 'DJF', 'GNF', 'ISK', 'JPY', 'KMF', 'KRW', 'PYG', 'RWF', 'UGX', 'UYI', 'VND', 'VUV', 'XAF', 'XOF', 'XPF',
+]);
+const THREE_DECIMAL = new Set(['BHD', 'IQD', 'JOD', 'KWD', 'LYD', 'OMR', 'TND']);
+/**
+ * ISO 4217's minor units. The demo provider's table, and a starting point a
+ * real provider OVERRIDES with its own exceptions; never the engine's
+ * authority on what a provider takes.
+ */
+export function isoExponent(currency) {
+    if (!/^[A-Z]{3}$/.test(currency))
+        return null;
+    if (ZERO_DECIMAL.has(currency))
+        return 0;
+    if (THREE_DECIMAL.has(currency))
+        return 3;
+    return 2;
+}
+//# sourceMappingURL=payment-money.js.map

package/dist/payment-money.js.map

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