@veriko-mx/sdk 0.4.12 → 0.4.14

package/CHANGELOG.md

@@ -7,6 +7,33 @@ versiones según [SemVer](https://semver.org/lang/es/).
 
 Sin cambios todavía.
 
+## [0.4.14] — 2026-10-15
+
+### Añadido
+
+- `beneficiaries.create()` devuelve `CreatedBeneficiary`, con `reactivated`: `true` cuando el alta reactivó una
+  cuenta archivada con el mismo número (la API responde `200` con `meta.reactivated`) y `false` en un alta
+  nueva.
+
+## [0.4.13] — 2026-10-15
+
+### Añadido
+
+- `catalog.speiCalendar()` (`GET /v1/public/spei-calendar/{year}`): el calendario de días inhábiles
+  SPEI de un año. Devuelve `SpeiCalendar`, con `non_business_days` y `source` en `attributes` y los
+  años con calendario en `coveredYears`. Admite `ifNoneMatch`, y su `ETag` queda en `etag`. No
+  consume cuota. Un año sin calendario se lanza como `NotFoundError` con
+  `spei_calendar_year_not_covered`.
+- `validations.validateOcr()` y `validations.enqueueOcr()` aceptan `bancoEmisor` y `bancoReceptor`:
+  la clave SPEI de 4 o 5 dígitos sustituye al banco leído del comprobante antes de consultar a
+  Banxico.
+- `validations.list()`, `validations.stats()` y `validations.export()` aceptan `banks`, hasta 50
+  claves SPEI en lista o separadas por comas; filtra por banco emisor o receptor.
+- `webhooks.deliveries()`, `webhooks.iterDeliveries()` y `webhooks.exportDeliveries()` aceptan
+  `responseStatus`, `validationId`, `q`, `from`, `to`, `minAttempt` y `minResponseTimeMs`.
+  `status`, `eventType` y `responseStatus` admiten una lista, y el endpoint una lista de hasta 20.
+  Nuevo tipo `DeliveryFilters`.
+
 ## [0.4.12] — 2026-10-02
 
 ### Añadido

package/README.md

@@ -52,13 +52,13 @@ validación pasa a `returned`.
 
 ## Las familias de operaciones
 
-El cliente agrupa las 69 operaciones M2M de la API en once familias:
+El cliente agrupa las 70 operaciones M2M de la API en once familias:
 
 | familia                | qué cubre                                                                                                                                                |
 | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `client.validations`   | Validar por campos o por imagen, consultar, listar, exportar, revisar el estado de pago, borrar, la política de reintentos y la descarga del comprobante |
 | `client.webhooks`      | Registrar endpoints, rotar su secreto, enviar un evento de prueba y leer el historial de entregas                                                        |
-| `client.catalog`       | Catálogo de bancos SPEI, banco emisor de una tarjeta y estado del servicio de Banxico                                                                    |
+| `client.catalog`       | Catálogo de bancos SPEI, calendario de días inhábiles SPEI, banco emisor de una tarjeta y estado del servicio de Banxico                                 |
 | `client.beneficiaries` | Cuentas beneficiarias guardadas y la importación masiva, como ciclo completo                                                                             |
 | `client.usage`         | Cuota de validaciones, límites de tasa y registro de actividad de la API                                                                                 |
 | `client.account`       | Perfil y política de reintentos predeterminada de la cuenta                                                                                              |
@@ -147,6 +147,10 @@ o PDF de 1 a 3 páginas, de hasta 12 MB.
 
 `cuentasCandidatas` reemplaza a `cuentaBeneficiaria` cuando la imagen no muestra la cuenta.
 
+`bancoEmisor` y `bancoReceptor` corrigen el banco que se leyó del comprobante. Llevan la clave SPEI
+de 4 o 5 dígitos (`'40012'`), que sustituye a la leída antes de consultar a Banxico; un valor con
+otro formato, como un nombre, se ignora y se conserva el leído.
+
 El comprobante de una validación por OCR se descarga con `client.validations.image(id)`.
 
 ### Sin esperar al veredicto
@@ -268,9 +272,10 @@ for await (const item of client.validations.iter({ from: '2025-03-01', to: '2025
 `totalPages` y `hasNext`.
 
 Los filtros (`status`, `type`, `from`, `to`, `search`, `playground`, `withDeleted`, `batchId`,
-`bank`, `amountMin`, `amountMax`, `clientRef` y `retryState`) van en `camelCase`. `status` acepta un estado o una
+`bank`, `banks`, `amountMin`, `amountMax`, `clientRef` y `retryState`) van en `camelCase`. `status` acepta un estado o una
 lista, y `withDeleted: true` devuelve sólo las validaciones retiradas, mientras que `false` devuelve
-sólo las activas.
+sólo las activas. `banks` filtra por varios bancos a la vez: hasta 50 claves SPEI, en lista o
+separadas por comas, y devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellos.
 
 Un listado trae menos campos que `get()`: no incluye los datos enviados, el resultado de Banxico ni
 los enlaces al comprobante.
@@ -371,13 +376,29 @@ tres seguidos. Cuando eso pasa, el estado queda en `auto_disabled` y se reactiva
 
 El historial de intentos está en `client.webhooks.deliveries()`, con o sin identificador de
 endpoint, y se recorre con `iterDeliveries()`. `exportDeliveries()` lo descarga en CSV o en XLSX.
-Los filtros `status` y `eventType` sólo existen en el listado global: con un endpoint y un filtro,
-el SDK consulta ese listado con `endpoint_id`.
+Los filtros sólo existen en el listado global: con un endpoint y un filtro, o con una lista de hasta
+20 endpoints, el SDK consulta ese listado con `endpoint_id`.
+
+```ts
+const failed = await client.webhooks.deliveries({
+  status: ['failed', 'retrying'],
+  responseStatus: ['5xx', 'none'],
+  from: '2026-10-01',
+  minAttempt: 2,
+});
+```
+
+`status`, `eventType` y `responseStatus` aceptan un valor o una lista. `responseStatus` admite un
+código exacto (`404`), una familia (`'5xx'`) o `'none'` para las entregas sin respuesta. `from` y
+`to` acotan la fecha de creación, `validationId` deja las de una validación, `minResponseTimeMs` las
+respuestas lentas y `q` busca en el identificador, el endpoint, el evento, la validación y el código
+HTTP. `exportDeliveries()` acepta los mismos filtros y `limit`.
 
 ## Catálogo y estado de Banxico
 
 ```ts
 const banks = await client.catalog.banks(); // instituciones SPEI con su código
+const calendar = await client.catalog.speiCalendar(2026); // días inhábiles SPEI del año
 const card = await client.catalog.binLookup('455632'); // banco emisor de una tarjeta
 const status = await client.catalog.banxicoStatus();
 
@@ -387,6 +408,12 @@ console.log(status.attributes.status); // 'operational'
 `banxicoStatus()` sirve para distinguir un `cep_unavailable` propio de la transferencia de una caída
 del servicio, y `banxicoTimeseries()` devuelve la serie de latencia o de veredictos por ventana.
 
+`speiCalendar()` devuelve `SpeiCalendar`: `attributes.non_business_days` trae los días inhábiles de
+lunes a viernes (`YYYY-MM-DD`), `attributes.source` la disposición de la CNBV publicada en el DOF y
+`coveredYears` los años con calendario. Los sábados y los domingos son inhábiles siempre y no se
+repiten en la lista. La consulta no consume cuota. Un año sin calendario se lanza como
+`NotFoundError` con `spei_calendar_year_not_covered`.
+
 ## Beneficiarios
 
 `client.beneficiaries` guarda las cuentas a las que se paga: CLABE, tarjeta o celular DiMo. El tipo
@@ -402,6 +429,10 @@ const found = await client.beneficiaries.lookup('012180004412345678'); // la cue
 console.log(found.attributes.bank_name);
 ```
 
+Registrar una cuenta archivada la reactiva: la API responde `200` en vez de `201` y `beneficiary.reactivated`
+es `true`. Sin `label`, la cuenta conserva su alias. Registrar una cuenta que ya está activa se lanza como
+`InvalidRequestError` con `beneficiary_already_registered`.
+
 La lista completa se recorre con `client.beneficiaries.list()`, que no pagina, y `delete()` archiva una cuenta sin
 borrarla: `list({ withArchived: true })` devuelve sólo las archivadas. `export()` la descarga en CSV o en
 XLSX.
@@ -447,9 +478,9 @@ cuota. `breakdown()`, `heatmap()` y `apiUsage()` desglosan el consumo, y
 
 ## Lecturas condicionales
 
-`client.validations.get()` y `client.catalog.banks()` admiten `ifNoneMatch`. La respuesta trae el
-`ETag` en `etag`, y cuando nada cambió la API responde `304`, que el SDK lanza como `ApiError` con
-`status` 304.
+`client.validations.get()`, `client.catalog.banks()` y `client.catalog.speiCalendar()` admiten
+`ifNoneMatch`. La respuesta trae el `ETag` en `etag`, y cuando nada cambió la API responde `304`,
+que el SDK lanza como `ApiError` con `status` 304.
 
 ```ts
 import { ApiError } from '@veriko-mx/sdk';
@@ -712,7 +743,7 @@ completos, por si hace falta una operación que el SDK todavía no envuelve.
 
 ## Superficie M2M
 
-El SDK cubre exactamente las 69 operaciones del spec público: `security: []` para las públicas y
+El SDK cubre exactamente las 70 operaciones del spec público: `security: []` para las públicas y
 `ApiKeyAuth` para las autenticadas.
 
 Entre ellas están el perfil y su política de reintentos, el resumen del panel, los dos endpoints

package/dist/cjs/client.d.ts

@@ -7,7 +7,7 @@ export declare const DEFAULT_TIMEOUT_MS = 30000;
 export declare const API_KEY_ENV_VAR = "VERIKO_API_KEY";
 export declare const BASE_URL_ENV_VAR = "VERIKO_BASE_URL";
 /** La versión que viaja en el `User-Agent`. `test/client.test.ts` la compara con `package.json`. */
-export declare const VERSION = "0.4.12";
+export declare const VERSION = "0.4.14";
 export interface VerikoOptions {
     /** La clave de API. Por omisión, `VERIKO_API_KEY`. */
     apiKey?: string;

package/dist/cjs/client.js

@@ -9,7 +9,7 @@ exports.DEFAULT_TIMEOUT_MS = 30_000;
 exports.API_KEY_ENV_VAR = 'VERIKO_API_KEY';
 exports.BASE_URL_ENV_VAR = 'VERIKO_BASE_URL';
 /** La versión que viaja en el `User-Agent`. `test/client.test.ts` la compara con `package.json`. */
-exports.VERSION = '0.4.12';
+exports.VERSION = '0.4.14';
 /**
  * Cliente de la API de Veriko.
  *