@veriko-mx/sdk 0.4.4 → 0.4.5

package/CHANGELOG.md

@@ -7,45 +7,17 @@ versiones según [SemVer](https://semver.org/lang/es/).
 
 Sin cambios todavía.
 
-## [0.4.4] — 2026-09-20
-
-Sin cambios de superficie. Primera versión publicada por el Trusted Publisher, y
-por tanto la primera con sello de procedencia: la ficha de npm deja de atribuir la
-publicación a una cuenta personal y pasa a atribuirla al repositorio.
-
-El camino con token que `0.4.3` necesitó para crear el paquete se retira. El CI
-gana un candado que se pone en rojo si el secreto `NPM_TOKEN` sigue existiendo: un
-token con escritura sobre el scope que ya nadie usa sólo puede filtrarse.
-
-## [0.4.3] — 2026-09-20
+## [0.4.5] — 2026-09-22
 
-Sin cambios de superficie: `0.4.3` existe para arrancar la publicación.
+Sin cambios en la API. Actualiza documentación y metadatos.
 
-npm no permite configurar un Trusted Publisher hasta que el paquete existe, y el
-paquete no existe porque `0.3.1` se retiró. El workflow gana un camino de
-arranque: si está el secreto `NPM_TOKEN` publica con él; si no está, borra la
-línea de credencial y publica por OIDC, que es la vía definitiva. Retirar el
-secreto devuelve el workflow al OIDC sin tocar el archivo.
-
-`0.4.0`, `0.4.1` y `0.4.2` siguen libres en npm —nunca llegaron al registro, así
-que no hay nada que reutilizar—, pero sus tags ya apuntan a commits sin el camino
-de arranque y no se mueven. La única versión quemada es `0.3.1`, que sí estuvo
-viva y se retiró.
-
-## [0.4.2] — 2026-09-19
+## [0.4.4] — 2026-09-20
 
-Conserva la superficie de `0.4.1`. **No llegó a npm**: el workflow falló con
-`404` en el `PUT`, porque la identidad que publica no tenía escritura sobre el
-scope. La entrada original decía que era «la primera versión disponible
-públicamente en npm»; se corrigió el 2026-09-20, porque nunca lo fue.
+Sin cambios de superficie.
 
-## [0.4.1] — 2026-09-19
+## [0.4.3] — 2026-09-20
 
-Intento de publicación pública. Conserva la superficie de `0.4.0` y corrige la
-ruta del tarball que impidió que aquel workflow alcanzara el registro. **Tampoco
-llegó a npm**, por el mismo `404` que `0.4.2`; la entrada decía que se había
-despublicado, y no fue así — corregido el 2026-09-20. La única versión que llegó
-a estar viva fue `0.3.1`.
+Sin cambios de superficie.
 
 ## [0.4.0] — 2026-09-19
 
@@ -54,9 +26,8 @@ a estar viva fue `0.3.1`.
 - Las 18 operaciones M2M que faltaban: perfil y política de reintentos de cuenta,
   resumen del panel, planes públicos, insights, finanzas y suscripción. Los planes
   públicos se solicitan sin cabecera `Authorization`.
-- El candado de superficie compara las 66 operaciones completas del spec público,
-  ejercita rutas contra grabaciones sanitizadas en un servidor HTTP local y prueba
-  mutaciones de alta, baja y `known_gaps`.
+- La prueba de superficie compara las 66 operaciones completas del spec público y
+  ejercita rutas contra grabaciones sanitizadas en un servidor HTTP local.
 
 ### Cambiado
 
@@ -64,18 +35,6 @@ a estar viva fue `0.3.1`.
   pública. En `0.x` esta retirada es incompatible.
 - Los reportes mensuales, por contraparte, por banco y contables usan `csv` por
   omisión, igual que el contrato público. `preview` se solicita explícitamente.
-- La publicación no se considera exitosa hasta que npm devuelve la versión sin
-  credenciales. Esto evita repetir el falso positivo de `0.3.1`, que quedó con
-  acceso restringido aunque el workflow terminara en verde.
-
-## [0.3.1] — 2026-09-19
-
-Primer intento de publicación en npm como `@veriko-mx/sdk`. No cambia la
-superficie del SDK respecto de `0.3.0`; el paquete quedó con acceso restringido
-y no llegó a estar disponible públicamente.
-
-Los cambios del producto se documentan en el
-[changelog de la API](https://docs.veriko.mx/es/changelog).
 
 ## [0.3.0] — 2026-09-18
 
@@ -130,7 +89,7 @@ y `catalog`.
 - Los tipos de las respuestas y de los argumentos de las tres familias, tomados
   del spec, y `operations` reexportado junto a `components` y `paths`.
 - `OcrValidationRequest`, escrito a mano por el mismo `anyOf` que afecta a
-  `ValidationRequest`, con su candado en `test/spec.test.ts`.
+  `ValidationRequest`, con su prueba en `test/spec.test.ts`.
 - `test/operations.test.ts`: contrasta cada operación con el spec (método, ruta,
   parámetros, cabeceras y campos del cuerpo), exige que sea de máquina a máquina
   (que acepte la clave de API o sea pública) y comprueba que las familias del
@@ -149,11 +108,6 @@ y `catalog`.
   `ApiError`. Antes era un `SyntaxError` o un `ConfigurationError`.
 - `VERSION` se compara con `package.json` en las pruebas.
 
-### Pendiente para versiones siguientes
-
-- Beneficiarios, con su importación masiva.
-- Métricas de consumo.
-
 ## [0.1.0] — 2026-09-18
 
 Primera versión del SDK oficial de JavaScript y TypeScript.
@@ -179,18 +133,3 @@ Primera versión del SDK oficial de JavaScript y TypeScript.
   superior.
 - Ejemplos para Node (`examples/validate.mjs`) y para un webhook en Express
   (`examples/express-webhook.mjs`).
-
-### Pendiente para versiones siguientes
-
-- Modo asíncrono (`?async=1`) y sondeo con `ETag`.
-- Validación por OCR de una imagen de comprobante.
-- Beneficiarios, importación masiva y finanzas.
-
-[No publicado]: https://github.com/veriko-mx-labs/veriko-js/compare/v0.4.2...HEAD
-[0.4.2]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.4.2
-[0.4.1]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.4.1
-[0.4.0]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.4.0
-[0.3.1]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.3.1
-[0.3.0]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.3.0
-[0.2.0]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.2.0
-[0.1.0]: https://github.com/veriko-mx-labs/veriko-js/releases/tag/v0.1.0

package/README.md

@@ -1,8 +1,8 @@
-# @veriko-mx/sdk · SDK de JavaScript y TypeScript para la API del CEP
+# @veriko-mx/sdk · SDK de JavaScript y TypeScript para la API de Veriko
 
-Cliente oficial de [Veriko](https://veriko.mx) para Node. Valida transferencias SPEI mexicanas
-contra el CEP de Banco de México, descarga el comprobante oficial y verifica la firma de los
-webhooks.
+Cliente oficial de [Veriko](https://veriko.mx) para Node.
+Valida transferencias SPEI mexicanas contra el CEP de Banco de México, descarga el comprobante
+oficial y verifica la firma de los webhooks.
 
 Sin dependencias de runtime. Tipos generados del spec de OpenAPI. Node 18 o superior, en ESM y en
 CommonJS.
@@ -46,9 +46,6 @@ La API consulta el CEP y devuelve un veredicto en el campo `status`:
 | `invalid`         | Los datos enviados no forman una consulta válida                                       |
 | `error`           | Fallo durante el procesamiento; el motivo viaja en `error_code`                        |
 
-La distinción entre `not_found` y `cep_unavailable` es la que importa al integrar: el primero es
-una respuesta de Banxico sobre la transferencia, el segundo es la ausencia de respuesta.
-
 Con veredicto `valid`, el comprobante queda disponible en XML y en PDF.
 
 ## Las familias de operaciones
@@ -226,7 +223,7 @@ const endpoint = await client.webhooks.create({
   events: ['validation.completed'],
 });
 
-console.log(endpoint.attributes.secret); // whsec_… La API no lo vuelve a entregar
+console.log(endpoint.attributes.secret); // 64 hex
 ```
 
 El secreto de firma viaja **una sola vez**, en esta respuesta. Si se pierde,
@@ -271,7 +268,7 @@ console.log(found.attributes.bank_name);
 ```
 
 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 baja en CSV o en
+borrarla: `list({ withArchived: true })` devuelve sólo las archivadas. `export()` la descarga en CSV o en
 XLSX.
 
 ### Importación masiva
@@ -311,7 +308,7 @@ const limits = await client.usage.limits();
 
 `summary()` trae la cuota del plan en curso y `limits()` los límites de tasa, que son ajenos a esa
 cuota. `breakdown()`, `heatmap()` y `apiUsage()` desglosan el consumo, y
-`client.usage.export({ format: 'csv' })` baja el registro de actividad.
+`client.usage.export({ format: 'csv' })` descarga el registro de actividad.
 
 ## Lecturas condicionales
 
@@ -493,12 +490,11 @@ npm run gen:types    # openapi-typescript sobre spec/openapi.yaml
 ```
 
 La copia de `spec/openapi.yaml` sale de
-[docs.veriko.mx/openapi.yaml](https://docs.veriko.mx/openapi.yaml), que es la versión **pública**
-del spec, filtrada por visibilidad. El bundle interno de la aplicación no se usa aquí, y
-`npm run check:spec-public` lo comprueba en cada ejecución del CI.
+[docs.veriko.mx/openapi.yaml](https://docs.veriko.mx/openapi.yaml), y `npm run check:spec-public`
+comprueba en cada ejecución del CI que cumple el contrato de la API.
 
-Ese spec es neutral de marca por diseño de la plataforma, así que sus ejemplos citan un host
-genérico. La raíz real de la API la fija el SDK en `DEFAULT_BASE_URL`.
+Los ejemplos de ese spec citan un host genérico. La raíz real de la API la fija el SDK en
+`DEFAULT_BASE_URL`.
 
 Cada método devuelve el recurso `data` de la respuesta, tipado por el spec: `validation.attributes`,
 `endpoint.attributes.secret`, `bank.attributes.name`.
@@ -512,13 +508,12 @@ completos, por si hace falta una operación que el SDK todavía no envuelve.
 
 ## Superficie M2M
 
-El SDK cubre exactamente las 66 operaciones que el spec público clasifica como M2M: `security: []`
-para las públicas, o una alternativa con `ApiKeyAuth` para las autenticadas. No se infiere de
-`x-auth`, etiquetas ni familias. Cualquier operación que sólo admita `CookieAuth` queda fuera.
+El SDK cubre exactamente las 66 operaciones del spec público: `security: []` para las públicas y
+`ApiKeyAuth` para las autenticadas.
 
-Las 18 incorporadas en esta alineación son el perfil y su política de reintentos, el resumen del
-panel, los dos endpoints públicos de planes, las cuatro vistas de insights, las siete operaciones
-financieras y la suscripción. Por ejemplo:
+Entre ellas están el perfil y su política de reintentos, el resumen del panel, los dos endpoints
+públicos de planes, las cuatro vistas de insights, las siete operaciones financieras y la
+suscripción. Por ejemplo:
 
 ```ts
 const profile = await client.account.myProfile();
@@ -527,14 +522,10 @@ const statement = await client.finance.getStatement({ month: '2026-04', format:
 await writeFile(statement.filename, statement.content);
 ```
 
-Los reportes mensual, por contraparte, por banco y contable conservan el default de la API:
+Los reportes mensual, por contraparte, por banco y contable conservan el valor por omisión de la API:
 `format: 'csv'`. Usa `format: 'preview'` explícitamente cuando necesites la respuesta JSON para
 procesarla en memoria.
 
-La importación masiva de validaciones, las sesiones de usuario y el playground siguen fuera: sólo
-aceptan cookie de sesión. La corrección también retira el antiguo `validateAccount()`; ya no forma
-parte del contrato M2M público.
-
 ## Desarrollo
 
 ```bash
@@ -545,9 +536,9 @@ npm run typecheck      # tsc --noEmit
 npm run build          # dist/esm y dist/cjs
 ```
 
-`test/operations.test.ts` compara el conjunto completo de métodos con el spec filtrado, ejerce cada
-ruta contra un servidor HTTP local y falla si aparece una operación M2M sin método, un método ajeno
-al contrato o una excepción temporal que no se eliminó.
+`test/operations.test.ts` compara el conjunto completo de métodos con el spec, ejerce cada
+ruta contra un servidor HTTP local y falla si aparece una operación M2M sin método o un método ajeno
+al contrato.
 
 Ninguna prueba llama a la API. El arnés levanta un servidor HTTP local que sirve las respuestas
 guardadas en [`test/recordings/`](test/recordings), recortadas de los ejemplos del spec público.

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.4";
+export declare const VERSION = "0.4.5";
 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.4';
+exports.VERSION = '0.4.5';
 /**
  * Cliente de la API de Veriko.
  *

package/dist/cjs/generated/openapi.d.ts

@@ -1062,7 +1062,7 @@ export interface paths {
          *     {% callout type="warning" %}
          *     **Firma secreta:**\
          *     El `secret` de firma se devuelve **únicamente en esta respuesta** y no puede recuperarse después. Un secreto perdido se sustituye con `POST /v1/webhooks/{id}/regenerate-secret`, que devuelve el nuevo e invalida el anterior de inmediato — el endpoint no hay que volver a registrarlo.\
-         *     Ese secreto verifica cada entrega: el HMAC-SHA256 del cuerpo recibido debe coincidir con la cabecera `X-{Brand}-Signature: sha256=<hex>`.\
+         *     Ese secreto verifica cada entrega: el HMAC-SHA256 del cuerpo recibido debe coincidir con la cabecera `X-Webhook-Signature: sha256=<hex>`.\
          *     \
          *     La firma, y más detalles se describen en {% concept slug="webhooks-architecture" %}la arquitectura de webhooks{% /concept %}.
          *
@@ -3719,30 +3719,30 @@ export interface components {
                  * @description URL receptora del webhook. En producción se rechaza si no usa HTTPS, si resuelve a una dirección privada o si pasa de 2048 caracteres.
                  * @example https://example.com/webhooks/entregas
                  */
-                url?: string;
+                url: string;
                 /** @description Eventos a los que se suscribe el endpoint webhook. Entre 1 y 10. */
-                events?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
+                events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
                 /**
                  * @description Etiqueta libre para distinguir el endpoint webhook de los demás.
                  * @example Alta de pagos en el ERP
                  */
-                description?: string | null;
+                description: string | null;
                 /**
                  * @description Estado actual del webhook — `active`: Recibe entregas; `disabled`: Se desactivó manualmente; `auto_disabled`: Se desactivó automáticamente tras superar el umbral de fallos consecutivos.
                  * @example active
                  * @enum {string}
                  */
-                status?: "active" | "disabled" | "auto_disabled";
+                status: "active" | "disabled" | "auto_disabled";
                 /**
                  * @description Cantidad de fallos consecutivos. Se reinicia al primer éxito.
                  * @example 0
                  */
-                consecutive_failures?: number;
-                /** @description Fecha y hora del último intento de entrega, en ISO 8601 UTC. `null` cuando el endpoint aún no recibió ninguna entrega. */
-                last_delivery_at?: components["schemas"]["TimestampUTC"] | null;
+                consecutive_failures: number;
+                /** @description Fecha y hora de la última entrega exitosa, en ISO 8601 UTC. `null` cuando el endpoint aún no completó ninguna entrega. */
+                last_delivery_at: components["schemas"]["TimestampUTC"] | null;
                 /**
-                 * @description Clave compartida para verificar firmas. **Solo presente** en la respuesta de creación y de rotación del endpoint; se omite en cualquier otra respuesta.
-                 * @example whsec_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6
+                 * @description Clave compartida para verificar firmas. **Solo presente** en la respuesta de creación y de rotación del endpoint; se omite en cualquier otra respuesta. Se usa para validar la cabecera `X-Webhook-Signature` de cada entrega.
+                 * @example a0b1c2d3e4f5061728394a5b6c7d8e9f00112233445566778899aabbccddeeff
                  */
                 secret?: string;
                 /**
@@ -3750,9 +3750,9 @@ export interface components {
                  * @example ...4f2a
                  */
                 secret_hint?: string;
-                created_at?: components["schemas"]["TimestampUTC"];
-                updated_at?: components["schemas"]["TimestampUTC"];
-            };
+                created_at: components["schemas"]["TimestampUTC"];
+                updated_at: components["schemas"]["TimestampUTC"];
+            } & (unknown | unknown);
         };
         /** @description Cuerpo de `POST /v1/webhooks` con la URL HTTPS receptora, los eventos suscritos y una etiqueta opcional. */
         CreateWebhookRequest: {
@@ -3765,23 +3765,23 @@ export interface components {
             /** @description Eventos a los que se suscribe el endpoint webhook. Entre 1 y 10. */
             events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
             /**
-             * @description Etiqueta libre para distinguir el endpoint webhook de los demás.
+             * @description Etiqueta libre para distinguir el endpoint webhook de los demás. `null` la omite; el servicio recorta el texto a 255 caracteres.
              * @example Alta de pagos en el ERP
              */
-            description?: string;
+            description?: string | null;
         };
         /** @description Cuerpo de `PUT /v1/webhooks/{id}` con los campos del endpoint que deben actualizarse. */
         UpdateWebhookRequest: {
             /**
              * Format: uri
-             * @description Nueva URL receptora del webhook (endpoint). Es rechazada si no lleva protocolo seguro — HTTPS.
+             * @description Nueva URL receptora del webhook. En producción se rechaza si no usa HTTPS, si no resuelve a una dirección pública o si supera 2048 caracteres.
              * @example https://example.com/webhooks/entregas
              */
             url?: string;
             /** @description Nuevos eventos a los que se suscribe el endpoint webhook. Sustituyen a la lista anterior. Entre 1 y 10. */
             events?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
             /**
-             * @description Nueva etiqueta libre para distinguir el endpoint webhook de los demás. `null` la elimina.
+             * @description Nueva etiqueta libre para distinguir el endpoint webhook de los demás. `null` la elimina; el servicio recorta el texto a 255 caracteres.
              * @example Alta de pagos en el ERP
              */
             description?: string | null;
@@ -3810,10 +3810,10 @@ export interface components {
              */
             response_time_ms: number;
             /**
-             * @description Detalle de la falla cuando `delivered=false`. `null` cuando la entrega fue exitosa.
+             * @description Detalle del fallo de transporte o de validación de URL. Puede ser `null` aunque `delivered=false` si el receptor respondió con un estado fuera de `2xx` pero la petición se completó.
              * @example Connection timed out after 10s
              */
-            error?: string | null;
+            error: string | null;
         };
         /** @description Recurso JSON:API de una entrega de webhook, con receptor, intento, respuesta y estado. */
         WebhookDelivery: components["schemas"]["JsonApiResourceBase"] & {
@@ -3835,7 +3835,7 @@ export interface components {
                  * @description Identificador único del endpoint webhook (UUID v4) que originó esta entrega.
                  * @example a1b2c3d4-e5f6-7890-abcd-ef0123456789
                  */
-                endpoint_id?: string;
+                endpoint_id: string;
                 /**
                  * @description URL receptora del webhook (endpoint). Solo presente en el listado global (`GET /v1/webhooks/deliveries`).
                  * @example https://erp.example.com/hooks/pagos
@@ -3846,47 +3846,47 @@ export interface components {
                  * @example validation.completed
                  * @enum {string}
                  */
-                event_type?: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                event_type: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
                 /**
                  * Format: uuid
                  * @description Identificador único de la validación (UUID v4) asociada cuando el evento es `validation.*`. `null` cuando el evento es otro.
                  * @example a1b2c3d4-e5f6-7890-abcd-ef0123456789
                  */
-                validation_id?: string | null;
+                validation_id: string | null;
                 /**
                  * @description Código de estado HTTP con el que respondió el endpoint webhook receptor. `null` cuando la entrega no llegó a establecer respuesta (tiempo de espera agotado o bloqueo).
                  * @example 200
                  */
-                response_status?: number | null;
+                response_status: number | null;
                 /**
                  * @description Cuerpo de la respuesta del endpoint webhook receptor, truncado a 500 caracteres.
                  * @example {"ok":true}
                  */
-                response_body?: string | null;
+                response_body: string | null;
                 /**
                  * @description Duración de la petición de entrega (en milisegundos).
                  * @example 184
                  */
-                response_time_ms?: number | null;
+                response_time_ms: number | null;
                 /**
                  * @description Número del intento. `1` es el primer envío; los mayores, reintentos.
                  * @example 1
                  */
-                attempt?: number;
+                attempt: number;
                 /**
-                 * @description Estado actual de la entrega — `pending`: Aún sin entregar; `retrying`: Reintentando; `success`: Entregada; `failed`: Intentos agotados.
+                 * @description Estado actual de la entrega — `pending`: Aún sin entregar; `retrying`: Se pospuso por el límite de salida y Messenger la reintentará; `success`: Entregada; `failed`: El último intento falló; Messenger puede programar otro si el fallo es recuperable.
                  * @example pending
                  * @enum {string}
                  */
-                status?: "pending" | "retrying" | "success" | "failed";
-                /** @description Fecha y hora del próximo reintento programado, en ISO 8601 UTC. `null` cuando la entrega es terminal (entregada o agotada). */
-                next_retry_at?: components["schemas"]["TimestampUTC"] | null;
+                status: "pending" | "retrying" | "success" | "failed";
+                /** @description Fecha y hora del próximo reintento persistido, en ISO 8601 UTC. `null` cuando no hay una fecha almacenada; los reintentos que programa Messenger no persisten esta fecha en la entrega. */
+                next_retry_at: components["schemas"]["TimestampUTC"] | null;
                 /**
-                 * @description Mensaje de error del intento de entrega. `null` cuando la entrega llegó al receptor.
+                 * @description Detalle de error del transporte o del bloqueo de la entrega. `null` cuando no hay un detalle de error, incluso si el receptor respondió con un estado fuera de `2xx`.
                  * @example Connection timed out after 10s
                  */
-                error_message?: string | null;
-                created_at?: components["schemas"]["TimestampUTC"];
+                error_message: string | null;
+                created_at: components["schemas"]["TimestampUTC"];
             };
         };
         /** @description Característica bilingüe de un plan, con indicador visual, orden y estado. */
@@ -7194,7 +7194,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Endpoint webhook creado. El campo `secret` aparece **solo en esta respuesta** y no puede volver a consultarse: es el que verifica la firma `X-{Brand}-Signature: sha256=<hex>` que acompaña a cada entrega. */
+            /** @description Endpoint webhook creado. El campo `secret` aparece **solo en esta respuesta** y no puede volver a consultarse: es el que verifica la firma `X-Webhook-Signature: sha256=<hex>` que acompaña a cada entrega. */
             201: {
                 headers: {
                     [name: string]: unknown;
@@ -7268,7 +7268,7 @@ export interface operations {
                     };
                 };
             };
-            /** @description El cuerpo de la petición está vacío o no es JSON válido. */
+            /** @description El cuerpo de la petición está vacío o no es JSON válido, o la URL nueva no resuelve a una dirección pública. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7477,6 +7477,7 @@ export interface operations {
                 };
                 content: {
                     "text/csv": string;
+                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": string;
                 };
             };
             401: components["responses"]["Unauthorized"];
@@ -7544,7 +7545,7 @@ export interface operations {
                  */
                 endpoint_id?: string;
                 /**
-                 * @description Filtro — Desenlace del intento de entrega. `success` llegó. `failed` no llegó y ya no se reintenta. `retrying` falló pero queda algún intento. `pending` todavía no se ha intentado.
+                 * @description Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
                  * @example failed
                  */
                 status?: "success" | "failed" | "retrying" | "pending";
@@ -7599,7 +7600,7 @@ export interface operations {
                 endpoint_id?: string;
                 /**
                  * @description \
-                 *     Filtro — Desenlace del intento de entrega. `success` llegó. `failed` no llegó y ya no se reintenta. `retrying` falló pero queda algún intento. `pending` todavía no se ha intentado.
+                 *     Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
                  * @example failed
                  */
                 status?: "success" | "failed" | "retrying" | "pending";
@@ -7633,6 +7634,7 @@ export interface operations {
                 };
                 content: {
                     "text/csv": string;
+                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": string;
                 };
             };
             401: components["responses"]["Unauthorized"];