@fiado/type-kit 3.354.0 → 3.355.0

package/bin/webhookBusiness/enums/SubscriptionVisibilityEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionVisibilityEnum = void 0;
+/**
+ * Qué cliente y qué credenciales lleva la entrega. No es "dentro o fuera de la VPC".
+ * Es enum y no un booleano para poder sumar un tercer modo (firma, mTLS, bearer) sin migrar la tabla.
+ */
+var SubscriptionVisibilityEnum;
+(function (SubscriptionVisibilityEnum) {
+    /** Receptor dentro de la VPC: la baseUrl se resuelve por destino y se pasa por llamada. */
+    SubscriptionVisibilityEnum["PRIVATE"] = "PRIVATE";
+    /** Receptor fuera de la VPC: HTTP plano contra la URL absoluta, sin token ni headers propios. */
+    SubscriptionVisibilityEnum["PUBLIC"] = "PUBLIC";
+})(SubscriptionVisibilityEnum || (exports.SubscriptionVisibilityEnum = SubscriptionVisibilityEnum = {}));

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

@@ -0,0 +1,10 @@
+/**
+ * Catálogo cerrado de eventos que `webhook-business` entrega a suscriptores externos (corte 1).
+ * El valor es el nombre versionado del contrato: el receptor rutea por él y no por el shape.
+ */
+export declare enum WebhookEventType {
+    /** La emisión de la cuenta PCF llegó a su desenlace terminal (abrió o falló). */
+    AccountIssuanceCompleted = "AccountIssuanceCompletedV1",
+    /** El oficial de cumplimiento dictaminó sobre el caso. */
+    ComplianceDecision = "ComplianceDecisionV1"
+}

package/bin/webhookBusiness/enums/WebhookEventType.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookEventType = void 0;
+/**
+ * Catálogo cerrado de eventos que `webhook-business` entrega a suscriptores externos (corte 1).
+ * El valor es el nombre versionado del contrato: el receptor rutea por él y no por el shape.
+ */
+var WebhookEventType;
+(function (WebhookEventType) {
+    /** La emisión de la cuenta PCF llegó a su desenlace terminal (abrió o falló). */
+    WebhookEventType["AccountIssuanceCompleted"] = "AccountIssuanceCompletedV1";
+    /** El oficial de cumplimiento dictaminó sobre el caso. */
+    WebhookEventType["ComplianceDecision"] = "ComplianceDecisionV1";
+})(WebhookEventType || (exports.WebhookEventType = WebhookEventType = {}));

package/bin/webhookBusiness/events/AccountIssuanceCompletedV1.d.ts

@@ -0,0 +1,19 @@
+import { AccountStatusEnum } from '../../retailCustomer/enums/AccountStatusEnum';
+/**
+ * Desenlace terminal de la emisión de la cuenta PCF, entregado por webhook a un suscriptor externo.
+ * Espeja `RetailCustomer.AccountResultRequest`, el contrato que el receptor ya espera. No lleva CLABE.
+ */
+export declare class AccountIssuanceCompletedV1 {
+    /** Identidad de la persona en Fiado. El `directoryId` viaja en el sobre, no aquí. */
+    peopleId: string;
+    /** `OPENING` y `LINKED` no son valores válidos: este evento solo reporta el desenlace. */
+    status: AccountStatusEnum;
+    /** Nivel de la cuenta PCF. Presente solo con `OPEN`. */
+    pcfAccountLevel?: 1 | 2;
+    /**
+     * Por qué no abrió, para soporte y administración. Presente solo con `FAILED`.
+     * Texto libre del core, que puede mencionar cumplimiento: nunca se le muestra al vendedor ni al
+     * comprador, misma regla que `WizardBlocked.detail`.
+     */
+    failReason?: string;
+}

package/bin/webhookBusiness/events/AccountIssuanceCompletedV1.js

@@ -0,0 +1,47 @@
+"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.AccountIssuanceCompletedV1 = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const AccountStatusEnum_1 = require("../../retailCustomer/enums/AccountStatusEnum");
+const WebhookFieldLimits_1 = require("../constants/WebhookFieldLimits");
+/**
+ * Desenlace terminal de la emisión de la cuenta PCF, entregado por webhook a un suscriptor externo.
+ * Espeja `RetailCustomer.AccountResultRequest`, el contrato que el receptor ya espera. No lleva CLABE.
+ */
+class AccountIssuanceCompletedV1 {
+}
+exports.AccountIssuanceCompletedV1 = AccountIssuanceCompletedV1;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AccountIssuanceCompletedV1.prototype, "peopleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsIn)([AccountStatusEnum_1.AccountStatusEnum.OPEN, AccountStatusEnum_1.AccountStatusEnum.FAILED]),
+    __metadata("design:type", String)
+], AccountIssuanceCompletedV1.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([1, 2]),
+    __metadata("design:type", Number)
+], AccountIssuanceCompletedV1.prototype, "pcfAccountLevel", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(WebhookFieldLimits_1.WEBHOOK_FAIL_REASON_MAX_LENGTH),
+    __metadata("design:type", String)
+], AccountIssuanceCompletedV1.prototype, "failReason", void 0);

package/bin/webhookBusiness/events/ComplianceDecisionV1.d.ts

@@ -0,0 +1,25 @@
+import { ComplianceDecisionEnum } from '../enums/ComplianceDecisionEnum';
+/**
+ * Dictamen del oficial de cumplimiento, entregado por webhook a un suscriptor externo.
+ * Lleva el desenlace accionable y nada más: el receptor necesita saber qué hacer, no por qué.
+ *
+ * Restricción legal, no preferencia de diseño. El DTO NO lleva qué lista disparó, ni la
+ * justificación del oficial, ni quién firmó, ni el `alertId` de PLD. Avisar de una coincidencia en
+ * listas de cumplimiento es delito. Cualquier campo que se agregue aquí tiene que pasar ese filtro.
+ */
+export declare class ComplianceDecisionV1 {
+    /** Identidad de la persona en Fiado. El `directoryId` viaja en el sobre, no aquí. */
+    peopleId: string;
+    /**
+     * Estado consolidado del caso, no el sello de una lista: `REJECTED` en cuanto una lista rechaza,
+     * `CLEARED` sólo cuando ya no queda ninguna trabando.
+     */
+    decision: ComplianceDecisionEnum;
+    /** ISO-8601. Cuándo se estampó el dictamen. */
+    decidedAt: string;
+    /**
+     * Referencia OPACA para soporte, acuñada para el webhook: permite rastrear el caso sin nombrarlo.
+     * El formato con prefijo es lo que impide que entre el `alertId` de PLD. Ver `CaseRefPattern`.
+     */
+    caseRef?: string;
+}

package/bin/webhookBusiness/events/ComplianceDecisionV1.js

@@ -0,0 +1,51 @@
+"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.ComplianceDecisionV1 = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ComplianceDecisionEnum_1 = require("../enums/ComplianceDecisionEnum");
+const CaseRefPattern_1 = require("../constants/CaseRefPattern");
+/**
+ * Dictamen del oficial de cumplimiento, entregado por webhook a un suscriptor externo.
+ * Lleva el desenlace accionable y nada más: el receptor necesita saber qué hacer, no por qué.
+ *
+ * Restricción legal, no preferencia de diseño. El DTO NO lleva qué lista disparó, ni la
+ * justificación del oficial, ni quién firmó, ni el `alertId` de PLD. Avisar de una coincidencia en
+ * listas de cumplimiento es delito. Cualquier campo que se agregue aquí tiene que pasar ese filtro.
+ */
+class ComplianceDecisionV1 {
+}
+exports.ComplianceDecisionV1 = ComplianceDecisionV1;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ComplianceDecisionV1.prototype, "peopleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ComplianceDecisionEnum_1.ComplianceDecisionEnum),
+    __metadata("design:type", String)
+], ComplianceDecisionV1.prototype, "decision", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], ComplianceDecisionV1.prototype, "decidedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(CaseRefPattern_1.WEBHOOK_CASE_REF_PATTERN, { message: CaseRefPattern_1.WEBHOOK_CASE_REF_MESSAGE }),
+    __metadata("design:type", String)
+], ComplianceDecisionV1.prototype, "caseRef", void 0);

package/bin/webhookBusiness/index.d.ts

@@ -0,0 +1,24 @@
+export * from './enums/WebhookEventType';
+export * from './enums/ComplianceDecisionEnum';
+export * from './enums/SubscriptionVisibilityEnum';
+export * from './enums/SubscriptionStatusEnum';
+export * from './enums/DeliveryOutcomeEnum';
+export * from './constants/CaseRefPattern';
+export * from './constants/WebhookFieldLimits';
+export * from './events/AccountIssuanceCompletedV1';
+export * from './events/ComplianceDecisionV1';
+export * from './dtos/WebhookEventEnvelope';
+export * from './dtos/WebhookOutboundMessage';
+export * from './dtos/WebhookSubscriptionView';
+export * from './dtos/WebhookDeliveryView';
+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/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';

package/bin/webhookBusiness/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums/WebhookEventType"), exports);
+__exportStar(require("./enums/ComplianceDecisionEnum"), exports);
+__exportStar(require("./enums/SubscriptionVisibilityEnum"), exports);
+__exportStar(require("./enums/SubscriptionStatusEnum"), exports);
+__exportStar(require("./enums/DeliveryOutcomeEnum"), exports);
+// Formatos y topes compartidos por los contratos
+__exportStar(require("./constants/CaseRefPattern"), exports);
+__exportStar(require("./constants/WebhookFieldLimits"), exports);
+// Contratos de eventos (PascalCase + sufijo V1)
+__exportStar(require("./events/AccountIssuanceCompletedV1"), exports);
+__exportStar(require("./events/ComplianceDecisionV1"), exports);
+// Sobre común + unión cerrada de la cola
+__exportStar(require("./dtos/WebhookEventEnvelope"), exports);
+__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);
+// 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);
+// API privada de administración — responses
+__exportStar(require("./dtos/responses/UpsertWebhookSubscriptionResponse"), exports);
+__exportStar(require("./dtos/responses/GetWebhookSubscriptionResponse"), exports);
+__exportStar(require("./dtos/responses/ListWebhookSubscriptionsResponse"), exports);
+__exportStar(require("./dtos/responses/DeactivateWebhookSubscriptionResponse"), exports);
+__exportStar(require("./dtos/responses/ListWebhookDeliveriesResponse"), exports);
+__exportStar(require("./dtos/responses/RedeliverWebhookEventResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -168,3 +168,7 @@ export * as Collection from './collection';
 export * as UserConfirmations from './userConfirmations';
 // PeopleBusiness: contrato de lectura por lote de People_GT + AccountRequirementControl_GT.
 export * as PeopleBusiness from './peopleBusiness';
+// WebhookBusiness: contrato de la cola del lambda webhook-business — entrega de eventos de Fiado a
+// suscriptores externos. Sobre común `WebhookEventEnvelope<T>` + los dos eventos del corte 1.
+// El evento del oficial de cumplimiento NO dice sobre qué se dictaminó (restricción legal).
+export * as WebhookBusiness from './webhookBusiness';

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -72,6 +72,6 @@ export enum ProductSubtypeEnum {
     // EQ_CASH_SA (Equality/Passport — depósito en efectivo en tiendas afiliadas)
     EQ_CASH_SA_CASH_IN = "CASH_IN",
 
-    //SK_BONUS
-    SKBONUS_WELCOME = "WELCOME",
+    //SUREKEEP
+    SUREKEEP_BONUS_MX = "BONUS_MX",
 }

package/src/productCatalog/enums/ProductTypeEnum.ts

@@ -19,9 +19,9 @@ export enum ProductTypeEnum {
      */
     EQ_CASH_SA = "EQ_CASH_SA",
     /**
-     * Bonos que Fiado le acredita a un cliente de SureKeep. La familia agrupa; el motivo va en el
-     * subtipo. Deliberadamente FUERA del switch de `CreateTransactionManager`: el camino por
-     * defecto es el que escribe el par de asientos FiadoTx + PagoConFiadoTx.
+     * Categoría de las transacciones de SureKeep. Agrupa; el motivo va en el subtipo. Deliberadamente
+     * FUERA del switch de `CreateTransactionManager`: el camino por defecto es el que escribe el par
+     * de asientos FiadoTx + PagoConFiadoTx.
      */
-    SK_BONUS = "SK_BONUS"
+    SUREKEEP = "SUREKEEP"
 }

package/src/transactionProcessor/dtos/{AuthorizeWelcomeBonusRequest.ts → AuthorizeBonusRequest.ts}

@@ -1,14 +1,14 @@
 import { IsNotEmpty, IsNumber, IsPositive, IsString, MaxLength } from "class-validator";
 
 /**
- * Acreditación de un bono de SureKeep a la wallet PagoConfiado del comprador.
+ * Acreditación de un bono a la wallet PagoConfiado de una persona.
  *
  * NO lleva `operation`: un bono solo suma, y el servicio hardcodea `ADD`. Con el campo en el
  * request, un caller equivocado debitaría la wallet con el producto del bono.
  *
  * NO lleva `peopleId`: `initialize()` lo resuelve desde el directorio y pisa cualquier valor.
  */
-export class AuthorizeWelcomeBonusRequest {
+export class AuthorizeBonusRequest {
     /** Es el `bonusId` del asiento: única por intento, para que un reintento real vuelva a ejecutar. */
     @IsString()
     @IsNotEmpty()
@@ -33,4 +33,4 @@ export class AuthorizeWelcomeBonusRequest {
     concept: string;
 }
 
-export default AuthorizeWelcomeBonusRequest;
+export default AuthorizeBonusRequest;

package/src/transactionProcessor/index.ts

@@ -10,7 +10,7 @@ export * from './dtos/AuthorizeSpeiMexBankTransferInRequest';
 export * from './dtos/AuthorizeSpeiBankTransferNcRequest';
 export * from './dtos/AuthorizeCollectorTransactionRequest';
 export * from './dtos/AuthorizeDisputeTransactionRequest';
-export * from './dtos/AuthorizeWelcomeBonusRequest';
+export * from './dtos/AuthorizeBonusRequest';
 export * from './dtos/CardInfo';
 export * from './dtos/InstallmentsInfo';
 export * from './dtos/MerchantInfo';

package/src/webhookBusiness/constants/CaseRefPattern.ts

@@ -0,0 +1,9 @@
+/**
+ * Formato de `caseRef`: prefijo `case_` más un ULID de 26 caracteres en Crockford base32, el mismo
+ * cuerpo que `CREDIT_ID_PATTERN`. El prefijo obliga a acuñar la referencia para el webhook, así que
+ * un `alertId` de PLD (UUID crudo o `stuck-<id>`) no lo satisface y no puede colarse.
+ */
+export const WEBHOOK_CASE_REF_PATTERN = /^case_[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+
+/** Mensaje único, para que el productor no tenga que adivinar el formato. */
+export const WEBHOOK_CASE_REF_MESSAGE = 'caseRef debe ser case_ seguido de un ULID de 26 caracteres';

package/src/webhookBusiness/constants/WebhookFieldLimits.ts

@@ -0,0 +1,8 @@
+/** Tope del `tag` del padrón, común a los tres contratos que lo llevan. */
+export const WEBHOOK_TAG_MAX_LENGTH = 128;
+
+/** Tope del `eventId`, común al sobre de la cola y al request de reposición. */
+export const WEBHOOK_EVENT_ID_MAX_LENGTH = 128;
+
+/** Tope del `failReason` del core, que sale sin transformar hacia un receptor externo. */
+export const WEBHOOK_FAIL_REASON_MAX_LENGTH = 512;

package/src/webhookBusiness/dtos/WebhookDeliveryView.ts

@@ -0,0 +1,29 @@
+import type { WebhookEventType } from '../enums/WebhookEventType';
+import type { DeliveryOutcomeEnum } from '../enums/DeliveryOutcomeEnum';
+import type { SubscriptionVisibilityEnum } from '../enums/SubscriptionVisibilityEnum';
+
+/**
+ * Un asiento de la bitácora de entregas: qué evento salió, a quién y cómo terminó.
+ * Nunca lleva el payload del evento, sólo identificadores operacionales y el desenlace.
+ */
+export interface WebhookDeliveryView {
+    eventId: string;
+    eventType: WebhookEventType;
+    /** Lambda que produjo el evento. */
+    source: string;
+    directoryId: string;
+    occurredAt: string;
+    outcome: DeliveryOutcomeEnum;
+    tag?: string;
+    subscriberName?: string;
+    visibility?: SubscriptionVisibilityEnum;
+    url?: string;
+    attempt?: number;
+    /** Status con el que respondió el receptor. Ausente si nunca hubo respuesta. */
+    receiverHttpStatus?: number;
+    errorCode?: string;
+    /** Motivo del fallo, recortado. Nunca la respuesta entera del receptor. */
+    failureReason?: string;
+    latencyMs?: number;
+    createdAt?: number;
+}

package/src/webhookBusiness/dtos/WebhookEventEnvelope.ts

@@ -0,0 +1,42 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsISO8601, IsNotEmpty, IsNotEmptyObject, IsObject, IsString, MaxLength } from 'class-validator';
+import { WebhookEventType } from '../enums/WebhookEventType';
+import { WEBHOOK_EVENT_ID_MAX_LENGTH } from '../constants/WebhookFieldLimits';
+
+/**
+ * Sobre común de todo lo que sale por `webhook-business`. El receptor rutea por `eventType` y recién
+ * ahí valida el `payload` contra la clase concreta que le corresponde.
+ *
+ * `TEventType` deja fijar el miembro del catálogo que acompaña a `TPayload`, para que el par
+ * `(eventType, payload)` quede amarrado en `WebhookOutboundMessage`.
+ */
+export class WebhookEventEnvelope<TPayload, TEventType extends WebhookEventType = WebhookEventType> {
+    /** Idempotencia del receptor: reprocesar el mismo `eventId` no debe duplicar efectos. */
+    @Expose() @IsString() @IsNotEmpty() @MaxLength(WEBHOOK_EVENT_ID_MAX_LENGTH)
+    eventId!: string;
+
+    @Expose() @IsEnum(WebhookEventType)
+    eventType!: TEventType;
+
+    /** Lambda que lo produjo. Para soporte y para la bitácora de entregas. */
+    @Expose() @IsString() @IsNotEmpty()
+    source!: string;
+
+    /**
+     * La llave de enrutamiento: con esto `webhook-business` resuelve los tags `wh:*` y decide a
+     * quién le toca. Obligatorio en TODO evento — sin él no hay destinatario posible.
+     */
+    @Expose() @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    /** ISO-8601. Resuelve el reordenamiento; la cola es estándar y no garantiza orden. */
+    @Expose() @IsString() @IsISO8601()
+    occurredAt!: string;
+
+    /**
+     * El evento concreto, sin transformar. Se valida como objeto presente y nada más: la clase real
+     * la elige el receptor por `eventType`, y un `@Type()` genérico aquí dejaría el payload vacío.
+     */
+    @Expose() @IsObject() @IsNotEmptyObject()
+    payload!: TPayload;
+}

package/src/webhookBusiness/dtos/WebhookOutboundMessage.ts

@@ -0,0 +1,18 @@
+import { WebhookEventEnvelope } from './WebhookEventEnvelope';
+import { WebhookEventType } from '../enums/WebhookEventType';
+import { AccountIssuanceCompletedV1 } from '../events/AccountIssuanceCompletedV1';
+import { ComplianceDecisionV1 } from '../events/ComplianceDecisionV1';
+
+/**
+ * Unión cerrada de todo lo que la cola de `webhook-business` transporta hacia suscriptores externos
+ * (corte 1). Cada variante amarra el par `(eventType, payload)`: un sobre que declara un tipo de
+ * evento y lleva el payload de otro no compila.
+ */
+export type WebhookOutboundMessage =
+    | WebhookEventEnvelope<AccountIssuanceCompletedV1, WebhookEventType.AccountIssuanceCompleted>
+    | WebhookEventEnvelope<ComplianceDecisionV1, WebhookEventType.ComplianceDecision>;
+
+type AssertNever<T extends never> = T;
+
+/** Falla la compilación si se agrega un `WebhookEventType` que la unión de arriba no cubre. */
+type UncoveredWebhookEventType = AssertNever<Exclude<WebhookEventType, WebhookOutboundMessage['eventType']>>;

package/src/webhookBusiness/dtos/WebhookSubscriptionView.ts

@@ -0,0 +1,24 @@
+import type { WebhookEventType } from '../enums/WebhookEventType';
+import type { SubscriptionStatusEnum } from '../enums/SubscriptionStatusEnum';
+import type { SubscriptionVisibilityEnum } from '../enums/SubscriptionVisibilityEnum';
+
+/**
+ * Una fila del padrón de suscriptores tal como sale por la API de administración.
+ * Expone el par `(tag, eventType)` en vez de las llaves crudas: `TAG#`/`EVT#` son detalle de DynamoDB.
+ */
+export interface WebhookSubscriptionView {
+    tag: string;
+    eventType: WebhookEventType;
+    subscriberName: string;
+    url: string;
+    visibility: SubscriptionVisibilityEnum;
+    status: SubscriptionStatusEnum;
+    /** Vínculo informativo con el padrón de socios M2M de RBAC. Todavía no gobierna la entrega. */
+    integrationId?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+    updatedBy?: string;
+}

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

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { WebhookEventType } from '../../enums/WebhookEventType';
+import { WEBHOOK_TAG_MAX_LENGTH } from '../../constants/WebhookFieldLimits';
+
+/**
+ * Body de `POST /private/webhook-subscriptions/deactivate` — baja lógica del destino.
+ * La fila no se borra: la bitácora referencia tags que tienen que seguir siendo explicables.
+ */
+export class DeactivateWebhookSubscriptionRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(WEBHOOK_TAG_MAX_LENGTH)
+    tag!: string;
+
+    @Expose()
+    @IsEnum(WebhookEventType)
+    eventType!: WebhookEventType;
+
+    /** Quién dispara la baja. Sin él la auditoría queda en `system`. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(128)
+    actor?: string;
+}

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

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsString, MaxLength } from 'class-validator';
+import { WebhookEventType } from '../../enums/WebhookEventType';
+import { WEBHOOK_TAG_MAX_LENGTH } from '../../constants/WebhookFieldLimits';
+
+/**
+ * Query de `GET /private/webhook-subscriptions/lookup`. El par viaja en el query string y no en el
+ * path porque el tag lleva `:` reservado, y un path param con dos puntos depende del cliente.
+ */
+export class GetWebhookSubscriptionRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(WEBHOOK_TAG_MAX_LENGTH)
+    tag!: string;
+
+    @Expose()
+    @IsEnum(WebhookEventType)
+    eventType!: WebhookEventType;
+}

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

@@ -0,0 +1,21 @@
+import { Expose, Type } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsOptional, IsPositive, IsString } from 'class-validator';
+
+/**
+ * Query de `GET /private/webhook-deliveries` — la bitácora de un comprador, la consulta que
+ * contesta "por qué el suscriptor no se enteró de esto". Va contra el GSI `directoryId-createdAt-index`.
+ */
+export class ListWebhookDeliveriesRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    directoryId!: string;
+
+    /** Tope de asientos a devolver. El manager lo recorta a su máximo. */
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @IsPositive()
+    limit?: number;
+}

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

@@ -0,0 +1,28 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsNotEmptyObject, IsObject, IsOptional, IsString, MaxLength } from 'class-validator';
+import { WEBHOOK_EVENT_ID_MAX_LENGTH } from '../../constants/WebhookFieldLimits';
+
+/**
+ * Body de `POST /private/webhook-deliveries/redeliver` — reposición manual de un evento.
+ * El `payload` viaja en el request porque la bitácora guarda el desenlace, nunca el evento: de la
+ * fila salen el tipo, el origen y el destinatario; el contenido lo repone quien lo produjo.
+ */
+export class RedeliverWebhookEventRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(WEBHOOK_EVENT_ID_MAX_LENGTH)
+    eventId!: string;
+
+    @Expose()
+    @IsObject()
+    @IsNotEmptyObject()
+    payload!: unknown;
+
+    /** Quién dispara el reenvío, para el log de la reposición. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(128)
+    actor?: string;
+}