@leaderty/utils 3.1.0 → 3.2.0

package/README.md

@@ -135,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/index.d.ts

@@ -6,3 +6,4 @@ export declare function numberToDecimalString(numero: number): string;
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export declare const numberToStringWithDecimals: typeof numberToDecimalString;
 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

@@ -9,3 +9,4 @@ export function numberToDecimalString(numero) {
 /** @deprecated Renamed to {@link numberToDecimalString}. */
 export const numberToStringWithDecimals = numberToDecimalString;
 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.1.0",
+  "version": "3.2.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",