@leaderty/utils 3.1.0 → 3.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @leaderty/utils
 
-Argentine number and date formatting. Every function returns the same output on any system: none of them uses `Intl`, `toLocaleString()` or the system time zone, so a WebView in English still shows `350.000` and `dd/mm/aaaa`.
+Argentine number and date formatting. Every formatter returns the same output on any system: none of them uses `Intl`, `toLocaleString()` or the system time zone, so a WebView in English still shows `350.000` and `dd/mm/aaaa`. `parseLocalDate` is the exception: it returns a `Date` at local midnight.
 
 ## Setup
 
@@ -121,6 +121,25 @@ dateToMonthYearLong('2026-10-11')   // "octubre de 2026"
 dateToMonthYearLong('2026-10-01')   // "octubre de 2026" (not September)
 ```
 
+### `parseLocalDate(value)`
+
+Lee una fecha del API como fecha local. `new Date('aaaa-mm-dd')` es medianoche UTC: en Argentina es el día anterior, y el día 1 cae en el mes anterior.
+
+**Comportamiento:**
+- `'aaaa-mm-dd'` da la medianoche de ese día en la zona horaria del sistema.
+- Cualquier otro string se lee con `new Date(value)`: `'aaaa-mm-ddThh:mm:ss'` (sin zona, ya local) y las fechas con zona quedan igual.
+
+**Parámetros:**
+- `value` - `string`
+
+**Devuelve:** `Date`
+
+**Ejemplos:**
+```typescript
+parseLocalDate('2026-10-01')             // 1 de octubre, 00:00 locales (no el 30/9)
+parseLocalDate('2026-10-22T22:05:36Z')   // igual que new Date('2026-10-22T22:05:36Z')
+```
+
 ### `numberToDecimalString(numero)`
 
 Formats a number with two decimals and thousands separators. Rounds like `numberToMoney(n, { decimals: 2 })`, so `1.005` gives `1,01`. Formerly `numberToStringWithDecimals`, which stays as a deprecated alias.
@@ -135,6 +154,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

@@ -93,3 +93,16 @@ export declare function dateToYMD(value: Date | string | null | undefined): stri
  * dateToMonthYearLong(new Date(2027, 0, 11)) // "enero de 2027"
  */
 export declare function dateToMonthYearLong(value: Date | string | null | undefined): string;
+/**
+ * Reads an API date as a local date. `new Date('aaaa-mm-dd')` is midnight UTC: in Argentina that is
+ * the previous day, and the 1st falls in the previous month.
+ * Only that format changes; `'aaaa-mm-ddThh:mm:ss'` (no zone, already local) and zoned dates are read by `new Date`.
+ *
+ * @param value - Date string from the API
+ * @returns Local midnight of that day for `'aaaa-mm-dd'`, otherwise `new Date(value)`
+ *
+ * @example
+ * parseLocalDate('2026-10-01')            // October 1, 00:00 in the system time zone
+ * parseLocalDate('2026-10-22T22:05:36Z')  // same as new Date('2026-10-22T22:05:36Z')
+ */
+export declare function parseLocalDate(value: string): Date;

package/dist/format.js

@@ -139,6 +139,22 @@ export function dateToMonthYearLong(value) {
         return PLACEHOLDER;
     return `${MONTH_NAMES[parts.month - 1]} de ${parts.year}`;
 }
+/**
+ * Reads an API date as a local date. `new Date('aaaa-mm-dd')` is midnight UTC: in Argentina that is
+ * the previous day, and the 1st falls in the previous month.
+ * Only that format changes; `'aaaa-mm-ddThh:mm:ss'` (no zone, already local) and zoned dates are read by `new Date`.
+ *
+ * @param value - Date string from the API
+ * @returns Local midnight of that day for `'aaaa-mm-dd'`, otherwise `new Date(value)`
+ *
+ * @example
+ * parseLocalDate('2026-10-01')            // October 1, 00:00 in the system time zone
+ * parseLocalDate('2026-10-22T22:05:36Z')  // same as new Date('2026-10-22T22:05:36Z')
+ */
+export function parseLocalDate(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    return match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value);
+}
 function toDateParts(value) {
     if (value === null || value === undefined)
         return null;

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, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, type Currency, type NumberToMoneyOptions, type DateToShortOptions, } from './format.js';
+export { numberToMoney, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, parseLocalDate, 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, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, } from './format.js';
+export { numberToMoney, moneyToNumber, dateToShort, dateToYMD, dateToMonthYearLong, parseLocalDate, } 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.3.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",