@leaderty/utils 3.0.0 → 3.2.0

package/README.md

@@ -38,6 +38,31 @@ numberToMoney(-1234.5, { decimals: 2 })                                     // "
 numberToMoney(undefined, { currency: 'ARS' })                               // "-"
 ```
 
+### `moneyToNumber(value)`
+
+Lee un monto escrito a la manera argentina: coma para los decimales y sin separador de miles. Es la inversa de lo que un usuario tipea en un campo de plata.
+
+**Comportamiento:**
+- Rechaza cualquier punto: `350.5` y `350.000` no se distinguen sin adivinar.
+- Admite un monto a medio escribir (`1234,`) y hasta dos decimales. Con más decimales devuelve `null`: no redondea lo que escribió el usuario.
+- Admite el signo menos y hasta 13 cifras enteras, para que cada centavo sea exacto en un `number`.
+- Ignora los espacios alrededor del monto.
+
+**Parámetros:**
+- `value` - `string`
+
+**Devuelve:** `number`, o `null` si `value` está vacío o no es un monto válido
+
+**Ejemplos:**
+```typescript
+moneyToNumber('357672,50')   // 357672.5
+moneyToNumber('350000')      // 350000
+moneyToNumber('1234,')       // 1234
+moneyToNumber('450.000')     // null
+moneyToNumber('1,2,3')       // null
+moneyToNumber('')            // null
+```
+
 ### `dateToShort(value, options?)`
 
 Formats a date as `dd/mm/aaaa`, or `dd/mm/aaaa hh:mm` (24-hour) with `time: true`.
@@ -110,6 +135,38 @@ Formats a number with two decimals and thousands separators. Rounds like `number
 numberToDecimalString(1234.56)   // "1.234,56"
 ```
 
+### `isCbu(value)`
+
+Indica si `value` es un CBU o una CVU válido: 22 dígitos con sus dos dígitos verificadores, calculados con la clave del BCRA (Com. "A" 8303). No dice si la cuenta existe.
+
+**Parámetros:**
+- `value` - `string`, solo dígitos (sin espacios ni guiones)
+
+**Devuelve:** `boolean`
+
+**Ejemplos:**
+```typescript
+isCbu('2850590940090418135201')   // true
+isCbu('2850590940090418135202')   // false: verificador de cuenta incorrecto
+isCbu('28505909 40090418135201')  // false
+```
+
+### `isAlias(value)`
+
+Indica si `value` tiene la forma de un alias de CBU o CVU: de 6 a 20 caracteres entre letras sin ñ ni acentos, números, punto y guion. No dice si el alias existe.
+
+**Parámetros:**
+- `value` - `string`
+
+**Devuelve:** `boolean`
+
+**Ejemplos:**
+```typescript
+isAlias('casa.sol.azul')   // true
+isAlias('año.casa')        // false
+isAlias('casa')            // false: menos de 6 caracteres
+```
+
 ## Types
 
 `Currency`, `NumberToMoneyOptions` and `DateToShortOptions` are exported for consumers.

package/dist/bank.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Indica si `value` es un CBU o una CVU: 22 dígitos con sus dos dígitos verificadores
+ * (el de banco y sucursal, y el de cuenta).
+ */
+export declare function isCbu(value: string): boolean;
+/**
+ * Indica si `value` puede ser un alias de CBU o CVU: de 6 a 20 caracteres entre letras sin ñ ni acentos,
+ * números, punto y guion. No dice si el alias existe.
+ */
+export declare function isAlias(value: string): boolean;

package/dist/bank.js

@@ -0,0 +1,27 @@
+// Clave de verificación del BCRA (Com. "A" 8303, puntos 1.1 y 2.3): pesos 7139 repetidos, alineados a la
+// derecha (de derecha a izquierda, 3 1 7 9); el verificador completa la suma hasta la decena siguiente.
+const WEIGHTS = [3, 1, 7, 9];
+function checkDigit(digits) {
+    let sum = 0;
+    for (let i = 0; i < digits.length; i++) {
+        sum += Number(digits[digits.length - 1 - i]) * WEIGHTS[i % WEIGHTS.length];
+    }
+    return (10 - (sum % 10)) % 10;
+}
+/**
+ * Indica si `value` es un CBU o una CVU: 22 dígitos con sus dos dígitos verificadores
+ * (el de banco y sucursal, y el de cuenta).
+ */
+export function isCbu(value) {
+    if (!/^\d{22}$/.test(value))
+        return false;
+    return (checkDigit(value.slice(0, 7)) === Number(value[7]) &&
+        checkDigit(value.slice(8, 21)) === Number(value[21]));
+}
+/**
+ * Indica si `value` puede ser un alias de CBU o CVU: de 6 a 20 caracteres entre letras sin ñ ni acentos,
+ * números, punto y guion. No dice si el alias existe.
+ */
+export function isAlias(value) {
+    return /^[A-Za-z0-9.-]{6,20}$/.test(value);
+}

package/dist/format.d.ts

@@ -32,6 +32,19 @@ export interface DateToShortOptions {
  * numberToMoney(-1234.5, { currency: 'USD', currencyDisplay: 'symbol', decimals: 2 }) // "-US$ 1.234,50"
  */
 export declare function numberToMoney(amount: number | null | undefined, options?: NumberToMoneyOptions): string;
+/**
+ * Reads an amount typed the Argentine way: `,` for decimals and no thousands separator.
+ * Any dot is rejected: `350.5` and `350.000` can't be told apart without guessing.
+ *
+ * @param value - Text of a money field
+ * @returns The amount, or `null` when `value` has no amount or is not a valid one
+ *
+ * @example
+ * moneyToNumber('357672,50')  // 357672.5
+ * moneyToNumber('1234,')      // 1234
+ * moneyToNumber('450.000')    // null
+ */
+export declare function moneyToNumber(value: string): number | null;
 /**
  * Formats a date as `dd/mm/aaaa`, optionally with the time as `dd/mm/aaaa hh:mm`.
  *

package/dist/format.js

@@ -6,6 +6,8 @@
 /** Shown instead of a value that is missing or not a valid number/date. */
 const PLACEHOLDER = '-';
 const CURRENCY_SYMBOLS = { ARS: '$', USD: 'US$' };
+/** Up to 13 integer digits: with two decimals, 15 significant digits are always exact to the cent in a `number`. */
+const MONEY_INPUT_PATTERN = /^-?(?:\d{1,13}(?:,\d{0,2})?|,\d{1,2})$/;
 /** Argentina is UTC-3 all year (no daylight saving time since 2009). */
 const BUENOS_AIRES_OFFSET_MS = -3 * 60 * 60 * 1000;
 /** `aaaa-mm-dd`, optionally followed by a time and no time zone: a calendar date or Argentine wall-clock time. */
@@ -53,6 +55,25 @@ export function numberToMoney(amount, options = {}) {
     const prefix = currencyDisplay === 'symbol' ? CURRENCY_SYMBOLS[currency] : currency;
     return `${sign}${prefix} ${number}`;
 }
+/**
+ * Reads an amount typed the Argentine way: `,` for decimals and no thousands separator.
+ * Any dot is rejected: `350.5` and `350.000` can't be told apart without guessing.
+ *
+ * @param value - Text of a money field
+ * @returns The amount, or `null` when `value` has no amount or is not a valid one
+ *
+ * @example
+ * moneyToNumber('357672,50')  // 357672.5
+ * moneyToNumber('1234,')      // 1234
+ * moneyToNumber('450.000')    // null
+ */
+export function moneyToNumber(value) {
+    const text = value.trim();
+    if (!MONEY_INPUT_PATTERN.test(text))
+        return null;
+    // `|| 0` turns -0 into 0
+    return Number(text.replace(',', '.')) || 0;
+}
 /**
  * Formats a date as `dd/mm/aaaa`, optionally with the time as `dd/mm/aaaa hh:mm`.
  *

package/dist/index.d.ts

@@ -5,4 +5,5 @@
 export declare function numberToDecimalString(numero: number): string;
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export declare const numberToStringWithDecimals: typeof numberToDecimalString;
-export { numberToMoney, dateToShort, dateToYMD, dateToMonthYearLong, type Currency, type NumberToMoneyOptions, type DateToShortOptions, } from './format.js';
+export { numberToMoney, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, type Currency, type NumberToMoneyOptions, type DateToShortOptions, } from './format.js';
+export { isAlias, isCbu } from './bank.js';

package/dist/index.js

@@ -8,4 +8,5 @@ export function numberToDecimalString(numero) {
 }
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export const numberToStringWithDecimals = numberToDecimalString;
-export { numberToMoney, dateToShort, dateToYMD, dateToMonthYearLong, } from './format.js';
+export { numberToMoney, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, } from './format.js';
+export { isAlias, isCbu } from './bank.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaderty/utils",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",