@fiado/type-kit 3.397.0 → 3.399.0

package/bin/webhookBusiness/dtos/PendingWebhookDeliveryView.d.ts

@@ -0,0 +1,30 @@
+import type { WebhookEventType } from '../enums/WebhookEventType';
+import type { DeliveryOutcomeEnum } from '../enums/DeliveryOutcomeEnum';
+/**
+ * Un evento que un suscriptor todavía no aceptó. Hay una sola fila por par (evento, suscriptor):
+ * lleva el desenlace vigente, no cada intento, así el listado no repite el mismo evento.
+ */
+export interface PendingWebhookDeliveryView {
+    eventId: string;
+    eventType: WebhookEventType;
+    /** Lambda que produjo el evento. */
+    source: string;
+    directoryId: string;
+    occurredAt: string;
+    /** Último desenlace asentado contra este suscriptor. Nunca `DELIVERED`: eso sale del listado. */
+    outcome: DeliveryOutcomeEnum;
+    subscriberName?: string;
+    url?: string;
+    /** Número del último asiento del par (evento, suscriptor). */
+    attempt?: number;
+    /** Intentos de red gastados en la ronda vigente. Un reenvío explícito la reabre en cero. */
+    sendAttempts?: number;
+    receiverHttpStatus?: number;
+    errorCode?: string;
+    failureReason?: string;
+    /**
+     * Falso cuando el evento en bruto ya venció o nunca se guardó. Reenviarlo exigiría mandar el
+     * payload a mano por el endpoint de reposición individual.
+     */
+    redeliverable: boolean;
+}

package/bin/webhookBusiness/dtos/PendingWebhookDeliveryView.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/webhookBusiness/dtos/RedeliveredWebhookRecipient.d.ts

@@ -0,0 +1,10 @@
+import type { DeliveryOutcomeEnum } from '../enums/DeliveryOutcomeEnum';
+import type { RedeliverySkipReasonEnum } from '../enums/RedeliverySkipReasonEnum';
+/** Cómo terminó un destinatario dentro de un reenvío manual, uno por tag del comprador. */
+export interface RedeliveredWebhookRecipient {
+    tag: string;
+    /** Desenlace vigente del destinatario, tal como quedó asentado en la bitácora. */
+    outcome: DeliveryOutcomeEnum;
+    /** Sólo cuando el evento NO volvió a salir a la red para este destinatario. */
+    skipReason?: RedeliverySkipReasonEnum;
+}

package/bin/webhookBusiness/dtos/RedeliveredWebhookRecipient.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/webhookBusiness/dtos/SkippedWebhookRedelivery.d.ts

@@ -0,0 +1,6 @@
+import type { RedeliverySkipReasonEnum } from '../enums/RedeliverySkipReasonEnum';
+/** Un pendiente que el lote no pudo encolar, con el motivo que lo explica. */
+export interface SkippedWebhookRedelivery {
+    eventId: string;
+    reason: RedeliverySkipReasonEnum;
+}

package/bin/webhookBusiness/dtos/SkippedWebhookRedelivery.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/webhookBusiness/dtos/requests/ListPendingWebhookDeliveriesRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Query de `GET /private/webhook-deliveries/pending` — lo que un suscriptor todavía no aceptó.
+ * Va contra el índice `pendingSubscriberTag-createdAt-index`, que sólo contiene lo pendiente.
+ */
+export declare class ListPendingWebhookDeliveriesRequest {
+    /** Tag del suscriptor, con el prefijo reservado `wh:`. */
+    tag: string;
+    /** Desde cuándo, por fecha del evento. Sin él la ventana arranca en el pendiente más viejo. */
+    from?: string;
+    to?: string;
+    /** Tope de filas de la página. El manager lo recorta a su máximo. */
+    limit?: number;
+    /** Cursor opaco de la página anterior. Se manda tal cual vino, sin interpretarlo. */
+    cursor?: string;
+}

package/bin/webhookBusiness/dtos/requests/ListPendingWebhookDeliveriesRequest.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListPendingWebhookDeliveriesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const WebhookFieldLimits_1 = require("../../constants/WebhookFieldLimits");
+/**
+ * Query de `GET /private/webhook-deliveries/pending` — lo que un suscriptor todavía no aceptó.
+ * Va contra el índice `pendingSubscriberTag-createdAt-index`, que sólo contiene lo pendiente.
+ */
+class ListPendingWebhookDeliveriesRequest {
+}
+exports.ListPendingWebhookDeliveriesRequest = ListPendingWebhookDeliveriesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(WebhookFieldLimits_1.WEBHOOK_TAG_MAX_LENGTH),
+    __metadata("design:type", String)
+], ListPendingWebhookDeliveriesRequest.prototype, "tag", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], ListPendingWebhookDeliveriesRequest.prototype, "from", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], ListPendingWebhookDeliveriesRequest.prototype, "to", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], ListPendingWebhookDeliveriesRequest.prototype, "limit", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2048),
+    __metadata("design:type", String)
+], ListPendingWebhookDeliveriesRequest.prototype, "cursor", void 0);

package/bin/webhookBusiness/dtos/requests/RedeliverWebhookEventsBatchRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Body de `POST /private/webhook-deliveries/redeliver-batch` — reenvío masivo de lo que un
+ * suscriptor todavía no aceptó. La selección sale siempre del índice de pendientes: un evento ya
+ * entregado no se puede reenviar por acá.
+ */
+export declare class RedeliverWebhookEventsBatchRequest {
+    tag: string;
+    /** Ventana por fecha del evento. Sin ella entra todo lo pendiente hasta el tope del lote. */
+    from?: string;
+    to?: string;
+    /** Recorte de la ventana a estos eventos. Los que no estén pendientes no entran. */
+    eventIds?: string[];
+    /** Cuántos pendientes encolar como mucho. El manager rechaza tipado si se pasa de su tope. */
+    limit?: number;
+    /** Quién dispara el reenvío, para el log de la reposición. */
+    actor?: string;
+}

package/bin/webhookBusiness/dtos/requests/RedeliverWebhookEventsBatchRequest.js

@@ -0,0 +1,68 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedeliverWebhookEventsBatchRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const WebhookFieldLimits_1 = require("../../constants/WebhookFieldLimits");
+/**
+ * Body de `POST /private/webhook-deliveries/redeliver-batch` — reenvío masivo de lo que un
+ * suscriptor todavía no aceptó. La selección sale siempre del índice de pendientes: un evento ya
+ * entregado no se puede reenviar por acá.
+ */
+class RedeliverWebhookEventsBatchRequest {
+}
+exports.RedeliverWebhookEventsBatchRequest = RedeliverWebhookEventsBatchRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(WebhookFieldLimits_1.WEBHOOK_TAG_MAX_LENGTH),
+    __metadata("design:type", String)
+], RedeliverWebhookEventsBatchRequest.prototype, "tag", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RedeliverWebhookEventsBatchRequest.prototype, "from", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RedeliverWebhookEventsBatchRequest.prototype, "to", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.MaxLength)(WebhookFieldLimits_1.WEBHOOK_EVENT_ID_MAX_LENGTH, { each: true }),
+    __metadata("design:type", Array)
+], RedeliverWebhookEventsBatchRequest.prototype, "eventIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], RedeliverWebhookEventsBatchRequest.prototype, "limit", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], RedeliverWebhookEventsBatchRequest.prototype, "actor", void 0);

package/bin/webhookBusiness/dtos/responses/ListPendingWebhookDeliveriesResponse.d.ts

@@ -0,0 +1,12 @@
+import type { PendingWebhookDeliveryView } from '../PendingWebhookDeliveryView';
+/**
+ * Respuesta de `GET /private/webhook-deliveries/pending`. Un suscriptor al día devuelve la lista
+ * vacía y no un 404: no deberle nada es el estado normal.
+ */
+export interface ListPendingWebhookDeliveriesResponse {
+    tag: string;
+    deliveries: PendingWebhookDeliveryView[];
+    count: number;
+    /** Cursor de la página siguiente. Ausente cuando no queda nada más pendiente. */
+    cursor?: string;
+}

package/bin/webhookBusiness/dtos/responses/ListPendingWebhookDeliveriesResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/webhookBusiness/dtos/responses/RedeliverWebhookEventResponse.d.ts

@@ -1,11 +1,16 @@
 import type { WebhookEventType } from '../../enums/WebhookEventType';
+import type { RedeliveredWebhookRecipient } from '../RedeliveredWebhookRecipient';
 /**
- * Respuesta de `POST /private/webhook-deliveries/redeliver`. Devuelve qué se repuso, no cómo
- * terminó cada destino: eso queda en la bitácora, que es la fuente de los desenlaces.
+ * Respuesta de `POST /private/webhook-deliveries/redeliver`. El reenvío entrega en línea, así que
+ * dice qué pasó con cada destinatario: un 200 no significa por sí solo que el evento se repuso.
  */
 export interface RedeliverWebhookEventResponse {
     eventId: string;
     eventType: WebhookEventType;
     directoryId: string;
     redeliveredAt: string;
+    /** Destinatarios que aceptaron el evento en este reenvío. En cero no se repuso nada. */
+    deliveredCount: number;
+    /** Uno por destinatario. Vacío significa que el comprador no tiene ningún tag `wh:*`. */
+    recipients: RedeliveredWebhookRecipient[];
 }

package/bin/webhookBusiness/dtos/responses/RedeliverWebhookEventsBatchResponse.d.ts

@@ -0,0 +1,14 @@
+import type { SkippedWebhookRedelivery } from '../SkippedWebhookRedelivery';
+/**
+ * Respuesta de `POST /private/webhook-deliveries/redeliver-batch`. El lote se encola, así que
+ * devuelve cuántos se aceptaron y no cómo terminó cada destino: eso queda en la bitácora.
+ */
+export interface RedeliverWebhookEventsBatchResponse {
+    tag: string;
+    /** Pendientes que entraron en la selección, antes de descartar los que no se pueden reenviar. */
+    selectedCount: number;
+    /** Los que quedaron encolados. */
+    acceptedCount: number;
+    skipped: SkippedWebhookRedelivery[];
+    acceptedAt: string;
+}

package/bin/webhookBusiness/dtos/responses/RedeliverWebhookEventsBatchResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/webhookBusiness/enums/RedeliverySkipReasonEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Por qué un evento no volvió a salir. El valor es el `code` que lo explica: los dos primeros son
+ * del error que dejó al evento fuera del lote; los demás, del destinatario que el reenvío no repuso.
+ */
+export declare enum RedeliverySkipReasonEnum {
+    /** El evento en bruto ya venció: sin payload no queda nada que reenviar. */
+    RAW_PAYLOAD_UNAVAILABLE = "WEBHOOK_RAW_PAYLOAD_UNAVAILABLE",
+    /** El bruto guardado no cumple el contrato de su tipo y no puede salir sin normalizar. */
+    PAYLOAD_INVALID = "WEBHOOK_PAYLOAD_INVALID",
+    /** El suscriptor ya había aceptado el evento. No se le repite nunca, ni a mano. */
+    ALREADY_DELIVERED = "WEBHOOK_ALREADY_DELIVERED",
+    /** El tag existe pero nadie declaró un destino para ese tipo de evento. */
+    NO_SUBSCRIPTION = "WEBHOOK_NO_SUBSCRIPTION",
+    /** El destino está dado de baja: es un no-op registrado, no un error. */
+    SUBSCRIPTION_INACTIVE = "WEBHOOK_SUBSCRIPTION_INACTIVE",
+    /** La ronda de intentos del destino ya estaba agotada y este pase no abrió otra. */
+    DELIVERY_EXHAUSTED = "WEBHOOK_DELIVERY_EXHAUSTED"
+}

package/bin/webhookBusiness/enums/RedeliverySkipReasonEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedeliverySkipReasonEnum = void 0;
+/**
+ * Por qué un evento no volvió a salir. El valor es el `code` que lo explica: los dos primeros son
+ * del error que dejó al evento fuera del lote; los demás, del destinatario que el reenvío no repuso.
+ */
+var RedeliverySkipReasonEnum;
+(function (RedeliverySkipReasonEnum) {
+    /** El evento en bruto ya venció: sin payload no queda nada que reenviar. */
+    RedeliverySkipReasonEnum["RAW_PAYLOAD_UNAVAILABLE"] = "WEBHOOK_RAW_PAYLOAD_UNAVAILABLE";
+    /** El bruto guardado no cumple el contrato de su tipo y no puede salir sin normalizar. */
+    RedeliverySkipReasonEnum["PAYLOAD_INVALID"] = "WEBHOOK_PAYLOAD_INVALID";
+    /** El suscriptor ya había aceptado el evento. No se le repite nunca, ni a mano. */
+    RedeliverySkipReasonEnum["ALREADY_DELIVERED"] = "WEBHOOK_ALREADY_DELIVERED";
+    /** El tag existe pero nadie declaró un destino para ese tipo de evento. */
+    RedeliverySkipReasonEnum["NO_SUBSCRIPTION"] = "WEBHOOK_NO_SUBSCRIPTION";
+    /** El destino está dado de baja: es un no-op registrado, no un error. */
+    RedeliverySkipReasonEnum["SUBSCRIPTION_INACTIVE"] = "WEBHOOK_SUBSCRIPTION_INACTIVE";
+    /** La ronda de intentos del destino ya estaba agotada y este pase no abrió otra. */
+    RedeliverySkipReasonEnum["DELIVERY_EXHAUSTED"] = "WEBHOOK_DELIVERY_EXHAUSTED";
+})(RedeliverySkipReasonEnum || (exports.RedeliverySkipReasonEnum = RedeliverySkipReasonEnum = {}));

package/bin/webhookBusiness/index.d.ts

@@ -3,6 +3,7 @@ export * from './enums/ComplianceDecisionEnum';
 export * from './enums/SubscriptionVisibilityEnum';
 export * from './enums/SubscriptionStatusEnum';
 export * from './enums/DeliveryOutcomeEnum';
+export * from './enums/RedeliverySkipReasonEnum';
 export * from './constants/CaseRefPattern';
 export * from './constants/WebhookFieldLimits';
 export * from './events/AccountIssuanceCompletedV1';
@@ -11,14 +12,21 @@ export * from './dtos/WebhookEventEnvelope';
 export * from './dtos/WebhookOutboundMessage';
 export * from './dtos/WebhookSubscriptionView';
 export * from './dtos/WebhookDeliveryView';
+export * from './dtos/PendingWebhookDeliveryView';
+export * from './dtos/SkippedWebhookRedelivery';
+export * from './dtos/RedeliveredWebhookRecipient';
 export * from './dtos/requests/UpsertWebhookSubscriptionRequest';
 export * from './dtos/requests/GetWebhookSubscriptionRequest';
 export * from './dtos/requests/DeactivateWebhookSubscriptionRequest';
 export * from './dtos/requests/ListWebhookDeliveriesRequest';
 export * from './dtos/requests/RedeliverWebhookEventRequest';
+export * from './dtos/requests/ListPendingWebhookDeliveriesRequest';
+export * from './dtos/requests/RedeliverWebhookEventsBatchRequest';
 export * from './dtos/responses/UpsertWebhookSubscriptionResponse';
 export * from './dtos/responses/GetWebhookSubscriptionResponse';
 export * from './dtos/responses/ListWebhookSubscriptionsResponse';
 export * from './dtos/responses/DeactivateWebhookSubscriptionResponse';
 export * from './dtos/responses/ListWebhookDeliveriesResponse';
 export * from './dtos/responses/RedeliverWebhookEventResponse';
+export * from './dtos/responses/ListPendingWebhookDeliveriesResponse';
+export * from './dtos/responses/RedeliverWebhookEventsBatchResponse';

package/bin/webhookBusiness/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./enums/ComplianceDecisionEnum"), exports);
 __exportStar(require("./enums/SubscriptionVisibilityEnum"), exports);
 __exportStar(require("./enums/SubscriptionStatusEnum"), exports);
 __exportStar(require("./enums/DeliveryOutcomeEnum"), exports);
+__exportStar(require("./enums/RedeliverySkipReasonEnum"), exports);
 // Formatos y topes compartidos por los contratos
 __exportStar(require("./constants/CaseRefPattern"), exports);
 __exportStar(require("./constants/WebhookFieldLimits"), exports);
@@ -32,12 +33,17 @@ __exportStar(require("./dtos/WebhookOutboundMessage"), exports);
 // Vistas del padrón y de la bitácora, tal como salen por la API de administración
 __exportStar(require("./dtos/WebhookSubscriptionView"), exports);
 __exportStar(require("./dtos/WebhookDeliveryView"), exports);
+__exportStar(require("./dtos/PendingWebhookDeliveryView"), exports);
+__exportStar(require("./dtos/SkippedWebhookRedelivery"), exports);
+__exportStar(require("./dtos/RedeliveredWebhookRecipient"), exports);
 // API privada de administración — requests
 __exportStar(require("./dtos/requests/UpsertWebhookSubscriptionRequest"), exports);
 __exportStar(require("./dtos/requests/GetWebhookSubscriptionRequest"), exports);
 __exportStar(require("./dtos/requests/DeactivateWebhookSubscriptionRequest"), exports);
 __exportStar(require("./dtos/requests/ListWebhookDeliveriesRequest"), exports);
 __exportStar(require("./dtos/requests/RedeliverWebhookEventRequest"), exports);
+__exportStar(require("./dtos/requests/ListPendingWebhookDeliveriesRequest"), exports);
+__exportStar(require("./dtos/requests/RedeliverWebhookEventsBatchRequest"), exports);
 // API privada de administración — responses
 __exportStar(require("./dtos/responses/UpsertWebhookSubscriptionResponse"), exports);
 __exportStar(require("./dtos/responses/GetWebhookSubscriptionResponse"), exports);
@@ -45,3 +51,5 @@ __exportStar(require("./dtos/responses/ListWebhookSubscriptionsResponse"), expor
 __exportStar(require("./dtos/responses/DeactivateWebhookSubscriptionResponse"), exports);
 __exportStar(require("./dtos/responses/ListWebhookDeliveriesResponse"), exports);
 __exportStar(require("./dtos/responses/RedeliverWebhookEventResponse"), exports);
+__exportStar(require("./dtos/responses/ListPendingWebhookDeliveriesResponse"), exports);
+__exportStar(require("./dtos/responses/RedeliverWebhookEventsBatchResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.397.0",
+  "version": "3.399.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/webhookBusiness/dtos/PendingWebhookDeliveryView.ts

@@ -0,0 +1,31 @@
+import type { WebhookEventType } from '../enums/WebhookEventType';
+import type { DeliveryOutcomeEnum } from '../enums/DeliveryOutcomeEnum';
+
+/**
+ * Un evento que un suscriptor todavía no aceptó. Hay una sola fila por par (evento, suscriptor):
+ * lleva el desenlace vigente, no cada intento, así el listado no repite el mismo evento.
+ */
+export interface PendingWebhookDeliveryView {
+    eventId: string;
+    eventType: WebhookEventType;
+    /** Lambda que produjo el evento. */
+    source: string;
+    directoryId: string;
+    occurredAt: string;
+    /** Último desenlace asentado contra este suscriptor. Nunca `DELIVERED`: eso sale del listado. */
+    outcome: DeliveryOutcomeEnum;
+    subscriberName?: string;
+    url?: string;
+    /** Número del último asiento del par (evento, suscriptor). */
+    attempt?: number;
+    /** Intentos de red gastados en la ronda vigente. Un reenvío explícito la reabre en cero. */
+    sendAttempts?: number;
+    receiverHttpStatus?: number;
+    errorCode?: string;
+    failureReason?: string;
+    /**
+     * Falso cuando el evento en bruto ya venció o nunca se guardó. Reenviarlo exigiría mandar el
+     * payload a mano por el endpoint de reposición individual.
+     */
+    redeliverable: boolean;
+}

package/src/webhookBusiness/dtos/RedeliveredWebhookRecipient.ts

@@ -0,0 +1,11 @@
+import type { DeliveryOutcomeEnum } from '../enums/DeliveryOutcomeEnum';
+import type { RedeliverySkipReasonEnum } from '../enums/RedeliverySkipReasonEnum';
+
+/** Cómo terminó un destinatario dentro de un reenvío manual, uno por tag del comprador. */
+export interface RedeliveredWebhookRecipient {
+    tag: string;
+    /** Desenlace vigente del destinatario, tal como quedó asentado en la bitácora. */
+    outcome: DeliveryOutcomeEnum;
+    /** Sólo cuando el evento NO volvió a salir a la red para este destinatario. */
+    skipReason?: RedeliverySkipReasonEnum;
+}

package/src/webhookBusiness/dtos/SkippedWebhookRedelivery.ts

@@ -0,0 +1,7 @@
+import type { RedeliverySkipReasonEnum } from '../enums/RedeliverySkipReasonEnum';
+
+/** Un pendiente que el lote no pudo encolar, con el motivo que lo explica. */
+export interface SkippedWebhookRedelivery {
+    eventId: string;
+    reason: RedeliverySkipReasonEnum;
+}

package/src/webhookBusiness/dtos/requests/ListPendingWebhookDeliveriesRequest.ts

@@ -0,0 +1,44 @@
+import { Expose, Type } from 'class-transformer';
+import { IsInt, IsISO8601, IsNotEmpty, IsOptional, IsPositive, IsString, MaxLength } from 'class-validator';
+import { WEBHOOK_TAG_MAX_LENGTH } from '../../constants/WebhookFieldLimits';
+
+/**
+ * Query de `GET /private/webhook-deliveries/pending` — lo que un suscriptor todavía no aceptó.
+ * Va contra el índice `pendingSubscriberTag-createdAt-index`, que sólo contiene lo pendiente.
+ */
+export class ListPendingWebhookDeliveriesRequest {
+    /** Tag del suscriptor, con el prefijo reservado `wh:`. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(WEBHOOK_TAG_MAX_LENGTH)
+    tag!: string;
+
+    /** Desde cuándo, por fecha del evento. Sin él la ventana arranca en el pendiente más viejo. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsISO8601()
+    from?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsISO8601()
+    to?: string;
+
+    /** Tope de filas de la página. El manager lo recorta a su máximo. */
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @IsPositive()
+    limit?: number;
+
+    /** Cursor opaco de la página anterior. Se manda tal cual vino, sin interpretarlo. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(2048)
+    cursor?: string;
+}

package/src/webhookBusiness/dtos/requests/RedeliverWebhookEventsBatchRequest.ts

@@ -0,0 +1,53 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayNotEmpty, IsArray, IsInt, IsISO8601, IsNotEmpty, IsOptional, IsPositive, IsString, MaxLength } from 'class-validator';
+import { WEBHOOK_EVENT_ID_MAX_LENGTH, WEBHOOK_TAG_MAX_LENGTH } from '../../constants/WebhookFieldLimits';
+
+/**
+ * Body de `POST /private/webhook-deliveries/redeliver-batch` — reenvío masivo de lo que un
+ * suscriptor todavía no aceptó. La selección sale siempre del índice de pendientes: un evento ya
+ * entregado no se puede reenviar por acá.
+ */
+export class RedeliverWebhookEventsBatchRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(WEBHOOK_TAG_MAX_LENGTH)
+    tag!: string;
+
+    /** Ventana por fecha del evento. Sin ella entra todo lo pendiente hasta el tope del lote. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsISO8601()
+    from?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsISO8601()
+    to?: string;
+
+    /** Recorte de la ventana a estos eventos. Los que no estén pendientes no entran. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    @MaxLength(WEBHOOK_EVENT_ID_MAX_LENGTH, { each: true })
+    eventIds?: string[];
+
+    /** Cuántos pendientes encolar como mucho. El manager rechaza tipado si se pasa de su tope. */
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @IsPositive()
+    limit?: number;
+
+    /** Quién dispara el reenvío, para el log de la reposición. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(128)
+    actor?: string;
+}

package/src/webhookBusiness/dtos/responses/ListPendingWebhookDeliveriesResponse.ts

@@ -0,0 +1,13 @@
+import type { PendingWebhookDeliveryView } from '../PendingWebhookDeliveryView';
+
+/**
+ * Respuesta de `GET /private/webhook-deliveries/pending`. Un suscriptor al día devuelve la lista
+ * vacía y no un 404: no deberle nada es el estado normal.
+ */
+export interface ListPendingWebhookDeliveriesResponse {
+    tag: string;
+    deliveries: PendingWebhookDeliveryView[];
+    count: number;
+    /** Cursor de la página siguiente. Ausente cuando no queda nada más pendiente. */
+    cursor?: string;
+}

package/src/webhookBusiness/dtos/responses/RedeliverWebhookEventResponse.ts

@@ -1,12 +1,17 @@
 import type { WebhookEventType } from '../../enums/WebhookEventType';
+import type { RedeliveredWebhookRecipient } from '../RedeliveredWebhookRecipient';
 
 /**
- * Respuesta de `POST /private/webhook-deliveries/redeliver`. Devuelve qué se repuso, no cómo
- * terminó cada destino: eso queda en la bitácora, que es la fuente de los desenlaces.
+ * Respuesta de `POST /private/webhook-deliveries/redeliver`. El reenvío entrega en línea, así que
+ * dice qué pasó con cada destinatario: un 200 no significa por sí solo que el evento se repuso.
  */
 export interface RedeliverWebhookEventResponse {
     eventId: string;
     eventType: WebhookEventType;
     directoryId: string;
     redeliveredAt: string;
+    /** Destinatarios que aceptaron el evento en este reenvío. En cero no se repuso nada. */
+    deliveredCount: number;
+    /** Uno por destinatario. Vacío significa que el comprador no tiene ningún tag `wh:*`. */
+    recipients: RedeliveredWebhookRecipient[];
 }

package/src/webhookBusiness/dtos/responses/RedeliverWebhookEventsBatchResponse.ts

@@ -0,0 +1,15 @@
+import type { SkippedWebhookRedelivery } from '../SkippedWebhookRedelivery';
+
+/**
+ * Respuesta de `POST /private/webhook-deliveries/redeliver-batch`. El lote se encola, así que
+ * devuelve cuántos se aceptaron y no cómo terminó cada destino: eso queda en la bitácora.
+ */
+export interface RedeliverWebhookEventsBatchResponse {
+    tag: string;
+    /** Pendientes que entraron en la selección, antes de descartar los que no se pueden reenviar. */
+    selectedCount: number;
+    /** Los que quedaron encolados. */
+    acceptedCount: number;
+    skipped: SkippedWebhookRedelivery[];
+    acceptedAt: string;
+}

package/src/webhookBusiness/enums/RedeliverySkipReasonEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Por qué un evento no volvió a salir. El valor es el `code` que lo explica: los dos primeros son
+ * del error que dejó al evento fuera del lote; los demás, del destinatario que el reenvío no repuso.
+ */
+export enum RedeliverySkipReasonEnum {
+    /** El evento en bruto ya venció: sin payload no queda nada que reenviar. */
+    RAW_PAYLOAD_UNAVAILABLE = 'WEBHOOK_RAW_PAYLOAD_UNAVAILABLE',
+    /** El bruto guardado no cumple el contrato de su tipo y no puede salir sin normalizar. */
+    PAYLOAD_INVALID = 'WEBHOOK_PAYLOAD_INVALID',
+    /** El suscriptor ya había aceptado el evento. No se le repite nunca, ni a mano. */
+    ALREADY_DELIVERED = 'WEBHOOK_ALREADY_DELIVERED',
+    /** El tag existe pero nadie declaró un destino para ese tipo de evento. */
+    NO_SUBSCRIPTION = 'WEBHOOK_NO_SUBSCRIPTION',
+    /** El destino está dado de baja: es un no-op registrado, no un error. */
+    SUBSCRIPTION_INACTIVE = 'WEBHOOK_SUBSCRIPTION_INACTIVE',
+    /** La ronda de intentos del destino ya estaba agotada y este pase no abrió otra. */
+    DELIVERY_EXHAUSTED = 'WEBHOOK_DELIVERY_EXHAUSTED',
+}

package/src/webhookBusiness/index.ts

@@ -4,6 +4,7 @@ export * from './enums/ComplianceDecisionEnum';
 export * from './enums/SubscriptionVisibilityEnum';
 export * from './enums/SubscriptionStatusEnum';
 export * from './enums/DeliveryOutcomeEnum';
+export * from './enums/RedeliverySkipReasonEnum';
 
 // Formatos y topes compartidos por los contratos
 export * from './constants/CaseRefPattern';
@@ -20,6 +21,9 @@ export * from './dtos/WebhookOutboundMessage';
 // Vistas del padrón y de la bitácora, tal como salen por la API de administración
 export * from './dtos/WebhookSubscriptionView';
 export * from './dtos/WebhookDeliveryView';
+export * from './dtos/PendingWebhookDeliveryView';
+export * from './dtos/SkippedWebhookRedelivery';
+export * from './dtos/RedeliveredWebhookRecipient';
 
 // API privada de administración — requests
 export * from './dtos/requests/UpsertWebhookSubscriptionRequest';
@@ -27,6 +31,8 @@ export * from './dtos/requests/GetWebhookSubscriptionRequest';
 export * from './dtos/requests/DeactivateWebhookSubscriptionRequest';
 export * from './dtos/requests/ListWebhookDeliveriesRequest';
 export * from './dtos/requests/RedeliverWebhookEventRequest';
+export * from './dtos/requests/ListPendingWebhookDeliveriesRequest';
+export * from './dtos/requests/RedeliverWebhookEventsBatchRequest';
 
 // API privada de administración — responses
 export * from './dtos/responses/UpsertWebhookSubscriptionResponse';
@@ -35,3 +41,5 @@ export * from './dtos/responses/ListWebhookSubscriptionsResponse';
 export * from './dtos/responses/DeactivateWebhookSubscriptionResponse';
 export * from './dtos/responses/ListWebhookDeliveriesResponse';
 export * from './dtos/responses/RedeliverWebhookEventResponse';
+export * from './dtos/responses/ListPendingWebhookDeliveriesResponse';
+export * from './dtos/responses/RedeliverWebhookEventsBatchResponse';