@fiado/type-kit 3.398.0 → 3.399.0

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/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/enums/RedeliverySkipReasonEnum.d.ts

@@ -1,7 +1,18 @@
-/** Por qué un pendiente del lote no se pudo encolar. El valor es el `code` del error que lo explica. */
+/**
+ * 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"
+    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

@@ -1,11 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RedeliverySkipReasonEnum = void 0;
-/** Por qué un pendiente del lote no se pudo encolar. El valor es el `code` del error que lo explica. */
+/**
+ * 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

@@ -14,6 +14,7 @@ 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';

package/bin/webhookBusiness/index.js

@@ -35,6 +35,7 @@ __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);

package/package.json

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

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/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/enums/RedeliverySkipReasonEnum.ts

@@ -1,7 +1,18 @@
-/** Por qué un pendiente del lote no se pudo encolar. El valor es el `code` del error que lo explica. */
+/**
+ * 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

@@ -23,6 +23,7 @@ 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';