@fiado/type-kit 3.354.0 → 3.355.0

package/_test_/unit/webhookBusiness/WebhookEventEnvelope.test.ts

@@ -0,0 +1,147 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    AccountIssuanceCompletedV1,
+    ComplianceDecisionV1,
+    WebhookEventEnvelope,
+    WebhookEventType,
+    WebhookOutboundMessage,
+} from '../../../src/webhookBusiness/index';
+
+const validEnvelope = {
+    eventId: 'evt-1',
+    eventType: WebhookEventType.AccountIssuanceCompleted,
+    source: 'retail-customer-business',
+    directoryId: 'dir-1',
+    occurredAt: '2026-08-22T10:05:00.000Z',
+    payload: { peopleId: 'ppl-1', status: 'OPEN' },
+};
+
+describe('WebhookEventEnvelope', () => {
+    it('valida el sobre completo', async () => {
+        const dto = plainToInstance(WebhookEventEnvelope, validEnvelope, { excludeExtraneousValues: true });
+
+        expect(await validate(dto as object)).toHaveLength(0);
+    });
+
+    // Candado del bug que el diseño original traía: con `@Type(() => Object)` el payload llegaba {}.
+    it('no destruye el payload al deserializar con excludeExtraneousValues', () => {
+        const dto = plainToInstance(WebhookEventEnvelope, validEnvelope, { excludeExtraneousValues: true });
+
+        expect(dto.payload).toEqual({ peopleId: 'ppl-1', status: 'OPEN' });
+    });
+
+    it.each(['eventId', 'source', 'directoryId'])('rechaza %s vacío', async (field) => {
+        const dto = plainToInstance(
+            WebhookEventEnvelope,
+            { ...validEnvelope, [field]: '' },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain(field);
+    });
+
+    // Sin directoryId no hay tag `wh:*` que resolver, o sea que no hay destinatario posible.
+    it('rechaza un sobre sin directoryId', async () => {
+        const { directoryId, ...raw } = validEnvelope;
+        const dto = plainToInstance(WebhookEventEnvelope, raw, { excludeExtraneousValues: true });
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('directoryId');
+    });
+
+    // Mismo tope que `RedeliverWebhookEventRequest.eventId`: es la misma llave en los dos contratos.
+    it('rechaza un eventId mas largo que el tope', async () => {
+        const dto = plainToInstance(
+            WebhookEventEnvelope,
+            { ...validEnvelope, eventId: 'e'.repeat(129) },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('eventId');
+    });
+
+    it('rechaza un payload vacío', async () => {
+        const dto = plainToInstance(
+            WebhookEventEnvelope,
+            { ...validEnvelope, payload: {} },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('payload');
+    });
+
+    it('rechaza un eventType fuera del catálogo cerrado', async () => {
+        const dto = plainToInstance(
+            WebhookEventEnvelope,
+            { ...validEnvelope, eventType: 'AccountOpenedV1' },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('eventType');
+    });
+
+    it('rechaza un occurredAt que no es ISO-8601', async () => {
+        const dto = plainToInstance(
+            WebhookEventEnvelope,
+            { ...validEnvelope, occurredAt: '22/08/2026' },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('occurredAt');
+    });
+});
+
+describe('WebhookOutboundMessage', () => {
+    it('acepta los dos sobres del corte 1', () => {
+        const account: WebhookOutboundMessage = plainToInstance(
+            WebhookEventEnvelope<AccountIssuanceCompletedV1, WebhookEventType.AccountIssuanceCompleted>,
+            validEnvelope,
+            { excludeExtraneousValues: true },
+        );
+        const compliance: WebhookOutboundMessage = plainToInstance(
+            WebhookEventEnvelope<ComplianceDecisionV1, WebhookEventType.ComplianceDecision>,
+            {
+                ...validEnvelope,
+                eventType: WebhookEventType.ComplianceDecision,
+                payload: { peopleId: 'ppl-1', decision: 'CLEARED', decidedAt: '2026-08-22T10:05:00.000Z' },
+            },
+            { excludeExtraneousValues: true },
+        );
+
+        expect([account.eventType, compliance.eventType]).toEqual([
+            WebhookEventType.AccountIssuanceCompleted,
+            WebhookEventType.ComplianceDecision,
+        ]);
+    });
+
+    // Cada variante fija el par (eventType, payload): el tipo de un evento con el payload de otro
+    // no compila. Sin el `@ts-expect-error` este archivo falla, que es el candado.
+    it('no acepta el eventType de un evento con el payload de otro', () => {
+        // @ts-expect-error un payload de AccountIssuanceCompletedV1 no viaja como ComplianceDecision
+        const mismatched: WebhookOutboundMessage = {
+            ...validEnvelope,
+            eventType: WebhookEventType.ComplianceDecision,
+            payload: { peopleId: 'ppl-1', status: 'OPEN' } as unknown as AccountIssuanceCompletedV1,
+        };
+
+        expect(mismatched.eventType).toBe(WebhookEventType.ComplianceDecision);
+    });
+
+    // La unión cubre TODO el catálogo. `WebhookOutboundMessage.ts` lo garantiza en compilación;
+    // esta lista lo vuelve a fallar en jest si alguien agrega un evento y no toca la unión.
+    it('cubre todos los eventos del catálogo', () => {
+        const covered: WebhookOutboundMessage['eventType'][] = [
+            WebhookEventType.AccountIssuanceCompleted,
+            WebhookEventType.ComplianceDecision,
+        ];
+
+        expect(covered.sort()).toEqual(Object.values(WebhookEventType).sort());
+    });
+});

package/_test_/unit/webhookBusiness/webhookEvents.test.ts

@@ -0,0 +1,197 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    AccountIssuanceCompletedV1,
+    ComplianceDecisionEnum,
+    ComplianceDecisionV1,
+} from '../../../src/webhookBusiness/index';
+import { AccountStatusEnum } from '../../../src/retailCustomer/enums/AccountStatusEnum';
+
+const validCaseRef = 'case_01JCVK8ZQXW3NBTR7YHMD5EA2F';
+
+describe('AccountIssuanceCompletedV1', () => {
+    it('valida el desenlace OPEN con nivel de cuenta', async () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.OPEN, pcfAccountLevel: 2 },
+            { excludeExtraneousValues: true },
+        );
+
+        expect(await validate(dto as object)).toHaveLength(0);
+    });
+
+    // El campo espeja `RetailCustomer.AccountResultRequest`, donde el receptor ya lo lee así.
+    it('descarta el nombre viejo accountLevel', () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.OPEN, accountLevel: 2 },
+            { excludeExtraneousValues: true },
+        );
+
+        expect(dto).not.toHaveProperty('accountLevel');
+        expect(dto.pcfAccountLevel).toBeUndefined();
+    });
+
+    it('valida el desenlace FAILED con failReason', async () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.FAILED, failReason: 'CURP duplicada en el core' },
+            { excludeExtraneousValues: true },
+        );
+
+        expect(await validate(dto as object)).toHaveLength(0);
+    });
+
+    // Texto libre del core que sale a un tercero: sin tope, un volcado del core viaja entero.
+    it('rechaza un failReason mas largo que el tope', async () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.FAILED, failReason: 'x'.repeat(513) },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('failReason');
+    });
+
+    it('acepta un failReason en el tope exacto', async () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.FAILED, failReason: 'x'.repeat(512) },
+            { excludeExtraneousValues: true },
+        );
+
+        expect(await validate(dto as object)).toHaveLength(0);
+    });
+
+    // Este evento reporta el desenlace, no el trámite en curso ni la cuenta preexistente.
+    it.each([AccountStatusEnum.OPENING, AccountStatusEnum.LINKED])('rechaza el status no terminal %s', async (status) => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('status');
+    });
+
+    it('rechaza un peopleId vacío', async () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: '', status: AccountStatusEnum.OPEN },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('peopleId');
+    });
+
+    it('rechaza un pcfAccountLevel fuera de 1 y 2', async () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.OPEN, pcfAccountLevel: 3 },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('pcfAccountLevel');
+    });
+
+    // La CLABE no viaja en este evento: se resuelve por el Cliente 360, enmascarada.
+    it('descarta la CLABE si un productor la mete de contrabando', () => {
+        const dto = plainToInstance(
+            AccountIssuanceCompletedV1,
+            { peopleId: 'ppl-1', status: AccountStatusEnum.OPEN, clabe: '646180000000000000' },
+            { excludeExtraneousValues: true },
+        );
+
+        expect(dto).not.toHaveProperty('clabe');
+    });
+});
+
+describe('ComplianceDecisionV1', () => {
+    it.each([ComplianceDecisionEnum.CLEARED, ComplianceDecisionEnum.REJECTED])(
+        'valida el dictamen %s',
+        async (decision) => {
+            const dto = plainToInstance(
+                ComplianceDecisionV1,
+                { peopleId: 'ppl-1', decision, decidedAt: '2026-08-22T10:05:00.000Z', caseRef: validCaseRef },
+                { excludeExtraneousValues: true },
+            );
+
+            expect(await validate(dto as object)).toHaveLength(0);
+        },
+    );
+
+    it('acepta el dictamen sin caseRef', async () => {
+        const dto = plainToInstance(
+            ComplianceDecisionV1,
+            { peopleId: 'ppl-1', decision: ComplianceDecisionEnum.CLEARED, decidedAt: '2026-08-22T10:05:00.000Z' },
+            { excludeExtraneousValues: true },
+        );
+
+        expect(await validate(dto as object)).toHaveLength(0);
+    });
+
+    // El prefijo `case_` es el guardrail: obliga a acuñar la referencia, no a reciclar un id de PLD.
+    it.each([
+        ['un UUID crudo, que es la forma de un alertId', '3f2504e0-4f89-11d3-9a0c-0305e82c3301'],
+        ['un alertId determinista', 'stuck-9f2b41c8'],
+        ['el prefijo sin cuerpo ULID', 'case_1'],
+        ['un ULID sin prefijo', '01JCVK8ZQXW3NBTR7YHMD5EA2F'],
+        ['el prefijo con caracteres fuera de Crockford base32', 'case_01JCVK8ZQXW3NBTR7YHMD5EAIL'],
+    ])('rechaza un caseRef que es %s', async (_caso, caseRef) => {
+        const dto = plainToInstance(
+            ComplianceDecisionV1,
+            { peopleId: 'ppl-1', decision: ComplianceDecisionEnum.REJECTED, decidedAt: '2026-08-22T10:05:00.000Z', caseRef },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('caseRef');
+    });
+
+    it('rechaza un decidedAt que no es ISO-8601', async () => {
+        const dto = plainToInstance(
+            ComplianceDecisionV1,
+            { peopleId: 'ppl-1', decision: ComplianceDecisionEnum.REJECTED, decidedAt: 'ayer' },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('decidedAt');
+    });
+
+    it('rechaza un dictamen fuera del enum', async () => {
+        const dto = plainToInstance(
+            ComplianceDecisionV1,
+            { peopleId: 'ppl-1', decision: 'UNDER_REVIEW', decidedAt: '2026-08-22T10:05:00.000Z' },
+            { excludeExtraneousValues: true },
+        );
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('decision');
+    });
+
+    // Restricción legal: avisar de una coincidencia en listas es delito. Ninguno de estos campos
+    // puede sobrevivir a la deserialización, ni siquiera si el productor los manda.
+    it.each(['fiadoList', 'blackList', 'cnbv', 'reason', 'justification', 'by', 'reviewedBy', 'alertId'])(
+        'no deja pasar el campo prohibido %s',
+        (field) => {
+            const dto = plainToInstance(
+                ComplianceDecisionV1,
+                {
+                    peopleId: 'ppl-1',
+                    decision: ComplianceDecisionEnum.REJECTED,
+                    decidedAt: '2026-08-22T10:05:00.000Z',
+                    [field]: 'lo que sea',
+                },
+                { excludeExtraneousValues: true },
+            );
+
+            expect(dto).not.toHaveProperty(field);
+        },
+    );
+});

package/_test_/unit/webhookBusiness/webhookSubscriptionRequests.test.ts

@@ -0,0 +1,60 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    DeactivateWebhookSubscriptionRequest,
+    GetWebhookSubscriptionRequest,
+    UpsertWebhookSubscriptionRequest,
+    WebhookEventType,
+} from '../../../src/webhookBusiness/index';
+
+const validUpsert = {
+    tag: 'wh:acme',
+    eventType: WebhookEventType.AccountIssuanceCompleted,
+    subscriberName: 'ACME',
+    url: 'https://acme.example/webhooks/fiado',
+    visibility: 'PUBLIC',
+    status: 'ACTIVE',
+};
+
+// El `tag` es la misma llave en los tres contratos, así que lleva el mismo tope en los tres.
+describe('tope del tag del padrón', () => {
+    const longTag = `wh:${'x'.repeat(130)}`;
+
+    it.each([
+        ['UpsertWebhookSubscriptionRequest', UpsertWebhookSubscriptionRequest, validUpsert],
+        [
+            'DeactivateWebhookSubscriptionRequest',
+            DeactivateWebhookSubscriptionRequest,
+            { tag: 'wh:acme', eventType: WebhookEventType.AccountIssuanceCompleted },
+        ],
+        [
+            'GetWebhookSubscriptionRequest',
+            GetWebhookSubscriptionRequest,
+            { tag: 'wh:acme', eventType: WebhookEventType.AccountIssuanceCompleted },
+        ],
+    ])('%s rechaza un tag mas largo que el tope', async (_name, cls, valid) => {
+        const dto = plainToInstance(cls, { ...valid, tag: longTag }, { excludeExtraneousValues: true });
+        const errors = await validate(dto as object);
+
+        expect(errors.map((e) => e.property)).toContain('tag');
+    });
+
+    it.each([
+        ['UpsertWebhookSubscriptionRequest', UpsertWebhookSubscriptionRequest, validUpsert],
+        [
+            'DeactivateWebhookSubscriptionRequest',
+            DeactivateWebhookSubscriptionRequest,
+            { tag: 'wh:acme', eventType: WebhookEventType.AccountIssuanceCompleted },
+        ],
+        [
+            'GetWebhookSubscriptionRequest',
+            GetWebhookSubscriptionRequest,
+            { tag: 'wh:acme', eventType: WebhookEventType.AccountIssuanceCompleted },
+        ],
+    ])('%s acepta un tag dentro del tope', async (_name, cls, valid) => {
+        const dto = plainToInstance(cls, valid, { excludeExtraneousValues: true });
+
+        expect(await validate(dto as object)).toHaveLength(0);
+    });
+});

package/bin/index.d.ts

@@ -112,3 +112,4 @@ export * as Shipping from './shipping';
 export * as Collection from './collection';
 export * as UserConfirmations from './userConfirmations';
 export * as PeopleBusiness from './peopleBusiness';
+export * as WebhookBusiness from './webhookBusiness';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.LoanConfig = exports.DatalakeQuery = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = void 0;
-exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = void 0;
+exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -209,3 +209,7 @@ exports.Collection = __importStar(require("./collection"));
 exports.UserConfirmations = __importStar(require("./userConfirmations"));
 // PeopleBusiness: contrato de lectura por lote de People_GT + AccountRequirementControl_GT.
 exports.PeopleBusiness = __importStar(require("./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).
+exports.WebhookBusiness = __importStar(require("./webhookBusiness"));

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -49,5 +49,5 @@ export declare enum ProductSubtypeEnum {
     CP_MC_SEND = "MC_SEND",
     CREDIT_DISBURSEMENT = "DISBURSEMENT",
     EQ_CASH_SA_CASH_IN = "CASH_IN",
-    SKBONUS_WELCOME = "WELCOME"
+    SUREKEEP_BONUS_MX = "BONUS_MX"
 }

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -64,6 +64,6 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["CREDIT_DISBURSEMENT"] = "DISBURSEMENT";
     // EQ_CASH_SA (Equality/Passport — depósito en efectivo en tiendas afiliadas)
     ProductSubtypeEnum["EQ_CASH_SA_CASH_IN"] = "CASH_IN";
-    //SK_BONUS
-    ProductSubtypeEnum["SKBONUS_WELCOME"] = "WELCOME";
+    //SUREKEEP
+    ProductSubtypeEnum["SUREKEEP_BONUS_MX"] = "BONUS_MX";
 })(ProductSubtypeEnum || (exports.ProductSubtypeEnum = ProductSubtypeEnum = {}));

package/bin/productCatalog/enums/ProductTypeEnum.d.ts

@@ -19,9 +19,9 @@ export declare 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/bin/productCatalog/enums/ProductTypeEnum.js

@@ -23,9 +23,9 @@ var ProductTypeEnum;
      */
     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.
      */
-    ProductTypeEnum["SK_BONUS"] = "SK_BONUS";
+    ProductTypeEnum["SUREKEEP"] = "SUREKEEP";
 })(ProductTypeEnum || (exports.ProductTypeEnum = ProductTypeEnum = {}));

package/bin/transactionProcessor/dtos/{AuthorizeWelcomeBonusRequest.d.ts → AuthorizeBonusRequest.d.ts}

@@ -1,12 +1,12 @@
 /**
- * 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 declare class AuthorizeWelcomeBonusRequest {
+export declare class AuthorizeBonusRequest {
     /** Es el `bonusId` del asiento: única por intento, para que un reintento real vuelva a ejecutar. */
     idempotencyKey: string;
     productCatalogId: string;
@@ -16,4 +16,4 @@ export declare class AuthorizeWelcomeBonusRequest {
     /** Lo que el cliente ve como descripción de su movimiento. */
     concept: string;
 }
-export default AuthorizeWelcomeBonusRequest;
+export default AuthorizeBonusRequest;

package/bin/transactionProcessor/dtos/{AuthorizeWelcomeBonusRequest.js → AuthorizeBonusRequest.js}

@@ -9,42 +9,42 @@ 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.AuthorizeWelcomeBonusRequest = void 0;
+exports.AuthorizeBonusRequest = void 0;
 const class_validator_1 = require("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.
  */
-class AuthorizeWelcomeBonusRequest {
+class AuthorizeBonusRequest {
 }
-exports.AuthorizeWelcomeBonusRequest = AuthorizeWelcomeBonusRequest;
+exports.AuthorizeBonusRequest = AuthorizeBonusRequest;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], AuthorizeWelcomeBonusRequest.prototype, "idempotencyKey", void 0);
+], AuthorizeBonusRequest.prototype, "idempotencyKey", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], AuthorizeWelcomeBonusRequest.prototype, "productCatalogId", void 0);
+], AuthorizeBonusRequest.prototype, "productCatalogId", void 0);
 __decorate([
     (0, class_validator_1.IsNumber)(),
     (0, class_validator_1.IsPositive)(),
     __metadata("design:type", Number)
-], AuthorizeWelcomeBonusRequest.prototype, "amount", void 0);
+], AuthorizeBonusRequest.prototype, "amount", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], AuthorizeWelcomeBonusRequest.prototype, "directoryId", void 0);
+], AuthorizeBonusRequest.prototype, "directoryId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
-], AuthorizeWelcomeBonusRequest.prototype, "concept", void 0);
-exports.default = AuthorizeWelcomeBonusRequest;
+], AuthorizeBonusRequest.prototype, "concept", void 0);
+exports.default = AuthorizeBonusRequest;

package/bin/transactionProcessor/index.d.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/bin/transactionProcessor/index.js

@@ -26,7 +26,7 @@ __exportStar(require("./dtos/AuthorizeSpeiMexBankTransferInRequest"), exports);
 __exportStar(require("./dtos/AuthorizeSpeiBankTransferNcRequest"), exports);
 __exportStar(require("./dtos/AuthorizeCollectorTransactionRequest"), exports);
 __exportStar(require("./dtos/AuthorizeDisputeTransactionRequest"), exports);
-__exportStar(require("./dtos/AuthorizeWelcomeBonusRequest"), exports);
+__exportStar(require("./dtos/AuthorizeBonusRequest"), exports);
 __exportStar(require("./dtos/CardInfo"), exports);
 __exportStar(require("./dtos/InstallmentsInfo"), exports);
 __exportStar(require("./dtos/MerchantInfo"), exports);

package/bin/webhookBusiness/constants/CaseRefPattern.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 declare const WEBHOOK_CASE_REF_PATTERN: RegExp;
+/** Mensaje único, para que el productor no tenga que adivinar el formato. */
+export declare const WEBHOOK_CASE_REF_MESSAGE = "caseRef debe ser case_ seguido de un ULID de 26 caracteres";

package/bin/webhookBusiness/constants/CaseRefPattern.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_CASE_REF_MESSAGE = exports.WEBHOOK_CASE_REF_PATTERN = void 0;
+/**
+ * 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.
+ */
+exports.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. */
+exports.WEBHOOK_CASE_REF_MESSAGE = 'caseRef debe ser case_ seguido de un ULID de 26 caracteres';

package/bin/webhookBusiness/constants/WebhookFieldLimits.d.ts

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

package/bin/webhookBusiness/constants/WebhookFieldLimits.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_FAIL_REASON_MAX_LENGTH = exports.WEBHOOK_EVENT_ID_MAX_LENGTH = exports.WEBHOOK_TAG_MAX_LENGTH = void 0;
+/** Tope del `tag` del padrón, común a los tres contratos que lo llevan. */
+exports.WEBHOOK_TAG_MAX_LENGTH = 128;
+/** Tope del `eventId`, común al sobre de la cola y al request de reposición. */
+exports.WEBHOOK_EVENT_ID_MAX_LENGTH = 128;
+/** Tope del `failReason` del core, que sale sin transformar hacia un receptor externo. */
+exports.WEBHOOK_FAIL_REASON_MAX_LENGTH = 512;

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

@@ -0,0 +1,28 @@
+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/bin/webhookBusiness/dtos/WebhookDeliveryView.js

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