@fiado/type-kit 3.420.0 → 3.422.0

package/_test_/unit/messagesConnector/MdmNotifyQueueMessageRequest.test.ts

@@ -0,0 +1,136 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import { MdmNotifyItem } from '../../../src/messagesConnector/dtos/MdmNotifyItem';
+import { MdmNotifyQueueMessageRequest } from '../../../src/messagesConnector/dtos/MdmNotifyQueueMessageRequest';
+import * as MessagesConnectorBarrel from '../../../src/messagesConnector/index';
+import { DeviceNotifyIntensityEnum } from '../../../src/mdm/enums/DeviceNotifyIntensityEnum';
+import { MdmNoticeTypeEnum } from '../../../src/mdm/enums/MdmNoticeTypeEnum';
+import { MdmProviderEnum } from '../../../src/mdm/enums/MdmProviderEnum';
+import { MDM_NOTIFY_MAX_BATCH } from '../../../src/messagesConnector/constants/MdmNotifyBatchLimits';
+
+/** ULID real del motor: así genera los creditId `loan-credit-business`. */
+const CREDIT_ID = '01M0B5D7FQA3T06K4REEVPRM33';
+
+const validItem = {
+    imei: '351756051523999',
+    creditId: CREDIT_ID,
+    provider: MdmProviderEnum.TRUSTONIC,
+    noticeType: MdmNoticeTypeEnum.OVERDUE_1_DAY,
+    intensity: DeviceNotifyIntensityEnum.BANNER,
+};
+
+/** Lote de `size` equipos con imei distinto: el lote real nunca repite imei. */
+const batchOf = (size: number): Record<string, unknown>[] =>
+    Array.from({ length: size }, (_unused, index) => ({ ...validItem, imei: `35175605152${String(index).padStart(4, '0')}` }));
+
+const validMessage = {
+    items: [validItem],
+    operationReference: 'mdm-notify-2026-09-08-0001',
+};
+
+/** True si el error de `property` trae ese constraint puntual (no solo "algo falló"). */
+const hasConstraint = (errors: ValidationError[], property: string, constraint: string): boolean =>
+    errors.some((e) => e.property === property && Boolean(e.constraints?.[constraint]));
+
+const validateMessage = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(MdmNotifyQueueMessageRequest, { ...validMessage, ...payload }));
+
+describe('MdmNotifyQueueMessageRequest', () => {
+    it('valida el mensaje mínimo de la cola', async () => {
+        expect(await validateMessage({})).toEqual([]);
+    });
+
+    it('valida sin tenantId: messages-business asume FIADO', async () => {
+        const dto = plainToInstance(MdmNotifyQueueMessageRequest, validMessage);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.tenantId).toBeUndefined();
+    });
+
+    it('valida con tenantId explícito', async () => {
+        expect(await validateMessage({ tenantId: 'SUREKEEP' })).toEqual([]);
+    });
+
+    it('falla si tenantId viene vacío: ausente cae a FIADO, pero "" no es un tenant', async () => {
+        expect(hasConstraint(await validateMessage({ tenantId: '' }), 'tenantId', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si el lote viene vacío', async () => {
+        expect(hasConstraint(await validateMessage({ items: [] }), 'items', 'arrayNotEmpty')).toBe(true);
+    });
+
+    it('falla si items no es un arreglo', async () => {
+        expect(hasConstraint(await validateMessage({ items: 'nada' }), 'items', 'isArray')).toBe(true);
+    });
+
+    it('falla si items no viaja', async () => {
+        const { items: _omitted, ...rest } = validMessage;
+        const errors = await validate(plainToInstance(MdmNotifyQueueMessageRequest, rest));
+        expect(hasConstraint(errors, 'items', 'arrayNotEmpty')).toBe(true);
+    });
+
+    it('falla si dos ítems repiten el mismo imei: el equipo recibiría el aviso dos veces y el acuse colapsa en uno', async () => {
+        expect(hasConstraint(await validateMessage({ items: [validItem, validItem] }), 'items', 'arrayUnique')).toBe(true);
+    });
+
+    it('acepta el lote completo hasta el tope', async () => {
+        expect(await validateMessage({ items: batchOf(MDM_NOTIFY_MAX_BATCH) })).toEqual([]);
+    });
+
+    it('falla si el lote excede el tope de equipos', async () => {
+        const errors = await validateMessage({ items: batchOf(MDM_NOTIFY_MAX_BATCH + 1) });
+        expect(hasConstraint(errors, 'items', 'arrayMaxSize')).toBe(true);
+    });
+
+    it('el tope del lote es el mismo que el del endpoint HTTP que reemplaza', () => {
+        expect(MDM_NOTIFY_MAX_BATCH).toBe(500);
+    });
+
+    it('falla si operationReference no viaja', async () => {
+        const { operationReference: _omitted, ...rest } = validMessage;
+        const errors = await validate(plainToInstance(MdmNotifyQueueMessageRequest, rest));
+        expect(hasConstraint(errors, 'operationReference', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference viene vacío', async () => {
+        expect(hasConstraint(await validateMessage({ operationReference: '' }), 'operationReference', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference excede el largo máximo', async () => {
+        const errors = await validateMessage({ operationReference: 'x'.repeat(65) });
+        expect(hasConstraint(errors, 'operationReference', 'maxLength')).toBe(true);
+    });
+
+    it('acepta operationReference justo en el largo máximo', async () => {
+        expect(await validateMessage({ operationReference: 'x'.repeat(64) })).toEqual([]);
+    });
+
+    it('falla si un ítem trae un provider fuera del enum', async () => {
+        const errors = await validateMessage({ items: [{ ...validItem, provider: 'AIRDROID' }] });
+        const children = errors.find((e) => e.property === 'items')?.children ?? [];
+        expect(hasConstraint(children[0]?.children ?? [], 'provider', 'isEnum')).toBe(true);
+    });
+
+    it('falla si un ítem trae un noticeType fuera del catálogo', async () => {
+        const errors = await validateMessage({ items: [{ ...validItem, noticeType: 'OVERDUE_99_DAYS' }] });
+        const children = errors.find((e) => e.property === 'items')?.children ?? [];
+        expect(hasConstraint(children[0]?.children ?? [], 'noticeType', 'isEnum')).toBe(true);
+    });
+
+    it('falla si un ítem trae un creditId que no es ULID', async () => {
+        const errors = await validateMessage({ items: [{ ...validItem, creditId: 'no-es-ulid' }] });
+        const children = errors.find((e) => e.property === 'items')?.children ?? [];
+        expect(hasConstraint(children[0]?.children ?? [], 'creditId', 'matches')).toBe(true);
+    });
+
+    it('materializa los ítems como MdmNotifyItem', () => {
+        const dto = plainToInstance(MdmNotifyQueueMessageRequest, validMessage);
+        expect(dto.items[0]).toBeInstanceOf(MdmNotifyItem);
+    });
+});
+
+describe('barrel de messagesConnector', () => {
+    it('exporta el mensaje de cola de avisos MDM', () => {
+        expect(MessagesConnectorBarrel.MdmNotifyQueueMessageRequest).toBe(MdmNotifyQueueMessageRequest);
+    });
+});

package/_test_/unit/messagesConnector/messagingEnums.test.ts

@@ -2,12 +2,13 @@ import 'reflect-metadata';
 import { DeliveryChannelExtendedEnum, MessagingSlotEnum } from '../../../src/messagesConnector/index';
 
 describe('DeliveryChannelExtendedEnum', () => {
-    it('incluye MDM junto a los tres canales que ya existían', () => {
+    it('incluye MDM y WHATSAPP junto a los tres canales que ya existían', () => {
         expect(Object.values(DeliveryChannelExtendedEnum).sort()).toEqual([
             'MAIL',
             'MDM',
             'PUSH_NOTIFICATION',
             'SMS',
+            'WHATSAPP',
         ]);
     });
 

package/_test_/unit/whatsappConnector/ConnectorSendMessageRequest.test.ts

@@ -0,0 +1,97 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { ConnectorSendMessageRequest } from '../../../src/whatsappConnector/dtos/ConnectorSendMessageRequest';
+import { DeliveryChannelExtendedEnum } from '../../../src/messagesConnector/index';
+
+const base = {
+    channelType: DeliveryChannelExtendedEnum.WHATSAPP,
+    destination: '+525512345678',
+    language: 'es',
+    tenantId: 'surekeep',
+    messageType: 'OTP_CODE',
+    selectedProvider: {
+        templateId: 'otp_code',
+        senderId: '1234567890',
+        contentVariables: { '1': '123456' },
+        secretRef: 'whatsapp-surekeep-credentials',
+    },
+};
+
+const errorsOn = async (payload: Record<string, unknown>, property: string) => {
+    const dto = plainToInstance(ConnectorSendMessageRequest, { ...base, ...payload });
+    const errors = await validate(dto);
+    return errors.filter((e) => e.property === property);
+};
+
+describe('ConnectorSendMessageRequest', () => {
+    it('acepta el contrato completo', async () => {
+        expect(await validate(plainToInstance(ConnectorSendMessageRequest, base))).toEqual([]);
+    });
+
+    describe('channelType', () => {
+        it('acepta un valor del enum', async () => {
+            expect(await errorsOn({ channelType: DeliveryChannelExtendedEnum.WHATSAPP }, 'channelType')).toHaveLength(0);
+        });
+
+        it('rechaza un valor fuera del enum', async () => {
+            expect(await errorsOn({ channelType: 'TELEGRAM' }, 'channelType')).not.toHaveLength(0);
+        });
+
+        it('rechaza el vacío', async () => {
+            expect(await errorsOn({ channelType: '' }, 'channelType')).not.toHaveLength(0);
+        });
+
+        it('rechaza la ausencia', async () => {
+            expect(await errorsOn({ channelType: undefined }, 'channelType')).not.toHaveLength(0);
+        });
+    });
+
+    describe('destination', () => {
+        it('acepta un destino válido', async () => {
+            expect(await errorsOn({ destination: '+525512345678' }, 'destination')).toHaveLength(0);
+        });
+
+        it('rechaza el vacío', async () => {
+            expect(await errorsOn({ destination: '' }, 'destination')).not.toHaveLength(0);
+        });
+
+        it('rechaza la ausencia', async () => {
+            expect(await errorsOn({ destination: undefined }, 'destination')).not.toHaveLength(0);
+        });
+    });
+
+    describe('language', () => {
+        it('rechaza el vacío', async () => {
+            expect(await errorsOn({ language: '' }, 'language')).not.toHaveLength(0);
+        });
+
+        it('rechaza la ausencia', async () => {
+            expect(await errorsOn({ language: undefined }, 'language')).not.toHaveLength(0);
+        });
+    });
+
+    describe('tenantId', () => {
+        it('rechaza el vacío', async () => {
+            expect(await errorsOn({ tenantId: '' }, 'tenantId')).not.toHaveLength(0);
+        });
+
+        it('rechaza la ausencia', async () => {
+            expect(await errorsOn({ tenantId: undefined }, 'tenantId')).not.toHaveLength(0);
+        });
+    });
+
+    describe('selectedProvider', () => {
+        it('valida el proveedor anidado', async () => {
+            expect(await errorsOn({ selectedProvider: { templateId: '', senderId: '' } }, 'selectedProvider')).not.toHaveLength(0);
+        });
+
+        it('rechaza la ausencia', async () => {
+            expect(await errorsOn({ selectedProvider: undefined }, 'selectedProvider')).not.toHaveLength(0);
+        });
+    });
+
+    it('messageType sigue siendo opcional', async () => {
+        expect(await errorsOn({ messageType: undefined }, 'messageType')).toHaveLength(0);
+    });
+});

package/_test_/unit/whatsappConnector/ConnectorSendMessageResponse.test.ts

@@ -0,0 +1,16 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { ConnectorSendMessageResponse } from '../../../src/whatsappConnector/dtos/ConnectorSendMessageResponse';
+
+describe('ConnectorSendMessageResponse', () => {
+    it('acepta el id y el estado que devuelve Meta', async () => {
+        const dto = plainToInstance(ConnectorSendMessageResponse, { providerMessageId: 'wamid.HBg', status: 'accepted' });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('rechaza un id que no es string', async () => {
+        const dto = plainToInstance(ConnectorSendMessageResponse, { providerMessageId: 42, status: 'accepted' });
+        expect(await validate(dto)).not.toHaveLength(0);
+    });
+});

package/_test_/unit/whatsappConnector/SelectedProvider.test.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SelectedProvider } from '../../../src/whatsappConnector/dtos/SelectedProvider';
+
+const base = {
+    templateId: 'otp_code',
+    senderId: '1234567890',
+    contentVariables: { '1': '123456' },
+    secretRef: 'whatsapp-surekeep-credentials',
+};
+
+const build = (over: Record<string, unknown> = {}) => plainToInstance(SelectedProvider, { ...base, ...over });
+
+describe('SelectedProvider', () => {
+    it('acepta el proveedor ya resuelto', async () => {
+        expect(await validate(build())).toEqual([]);
+    });
+
+    it('rechaza templateId vacío', async () => {
+        expect(await validate(build({ templateId: '' }))).not.toHaveLength(0);
+    });
+
+    it('rechaza senderId vacío', async () => {
+        expect(await validate(build({ senderId: '' }))).not.toHaveLength(0);
+    });
+
+    it('rechaza secretRef vacío', async () => {
+        expect(await validate(build({ secretRef: '' }))).not.toHaveLength(0);
+    });
+
+    it('rechaza la ausencia de secretRef', async () => {
+        expect(await validate(build({ secretRef: undefined }))).not.toHaveLength(0);
+    });
+
+    it('deja contentVariables opcional', async () => {
+        expect(await validate(build({ contentVariables: undefined }))).toEqual([]);
+    });
+});

package/bin/index.d.ts

@@ -81,6 +81,7 @@ export * as MilestoneBusiness from './milestone-business';
 export * as Mdm from './mdm';
 export * as MessagesConnector from './messagesConnector';
 export * as TwilioConnector from './twilioConnector';
+export * as WhatsappConnector from './whatsappConnector';
 export * as CognitoBackofficeConnector from './cognitoBackofficeConnector';
 export * as PlatformRbac from './platformRbac';
 export * as Remittance from './remittance';

package/bin/index.js

@@ -37,8 +37,8 @@ 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.Membership = 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.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.WhatsappConnector = 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.Membership = 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 = exports.LoanConfig = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -122,6 +122,7 @@ exports.MilestoneBusiness = __importStar(require("./milestone-business"));
 exports.Mdm = __importStar(require("./mdm"));
 exports.MessagesConnector = __importStar(require("./messagesConnector"));
 exports.TwilioConnector = __importStar(require("./twilioConnector"));
+exports.WhatsappConnector = __importStar(require("./whatsappConnector"));
 exports.CognitoBackofficeConnector = __importStar(require("./cognitoBackofficeConnector"));
 // PlatformRbac: módulo del lambda platform-rbac-business (Fase 0 SureKeep).
 // Contiene Permission enum + AuthContext + RoleAssignmentInfo + PermissionScope +

package/bin/messagesConnector/dtos/MdmNotifyQueueMessageRequest.d.ts

@@ -0,0 +1,16 @@
+import { MdmNotifyItem } from './MdmNotifyItem';
+/**
+ * Mensaje que viaja por la cola de messages-business para avisar en lote a los equipos.
+ * Reemplaza al `POST /private/messages/mdm-notify`, que se retira.
+ */
+export declare class MdmNotifyQueueMessageRequest {
+    /**
+     * Equipos del lote. El tope es el mismo que el del lote de `loan-credit-business`.
+     * El imei repetido duplica el aviso en el equipo y colapsa los dos acuses en uno.
+     */
+    items: MdmNotifyItem[];
+    /** Tenant emisor del aviso. Si se omite, messages-business asume FIADO. */
+    tenantId?: string;
+    /** Referencia con la que el productor correlaciona este lote. Es la que viaja al proveedor. */
+    operationReference: string;
+}

package/bin/messagesConnector/dtos/MdmNotifyQueueMessageRequest.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.MdmNotifyQueueMessageRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MdmNotifyItem_1 = require("./MdmNotifyItem");
+const MdmNotifyBatchLimits_1 = require("../constants/MdmNotifyBatchLimits");
+/**
+ * Mensaje que viaja por la cola de messages-business para avisar en lote a los equipos.
+ * Reemplaza al `POST /private/messages/mdm-notify`, que se retira.
+ */
+class MdmNotifyQueueMessageRequest {
+}
+exports.MdmNotifyQueueMessageRequest = MdmNotifyQueueMessageRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(MdmNotifyBatchLimits_1.MDM_NOTIFY_MAX_BATCH),
+    (0, class_validator_1.ArrayUnique)((item) => item.imei),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => MdmNotifyItem_1.MdmNotifyItem),
+    __metadata("design:type", Array)
+], MdmNotifyQueueMessageRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], MdmNotifyQueueMessageRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], MdmNotifyQueueMessageRequest.prototype, "operationReference", void 0);

package/bin/messagesConnector/enums/DeliveryChannelExtendedEnum.d.ts

@@ -3,5 +3,7 @@ export declare enum DeliveryChannelExtendedEnum {
     MAIL = "MAIL",
     PUSH_NOTIFICATION = "PUSH_NOTIFICATION",
     /** Aviso en la pantalla del equipo financiado. Se entrega por IMEI, no por teléfono ni correo. */
-    MDM = "MDM"
+    MDM = "MDM",
+    /** Mensaje por WhatsApp. Se entrega por teléfono; el connector normaliza el número antes de enviar. */
+    WHATSAPP = "WHATSAPP"
 }

package/bin/messagesConnector/enums/DeliveryChannelExtendedEnum.js

@@ -8,4 +8,6 @@ var DeliveryChannelExtendedEnum;
     DeliveryChannelExtendedEnum["PUSH_NOTIFICATION"] = "PUSH_NOTIFICATION";
     /** Aviso en la pantalla del equipo financiado. Se entrega por IMEI, no por teléfono ni correo. */
     DeliveryChannelExtendedEnum["MDM"] = "MDM";
+    /** Mensaje por WhatsApp. Se entrega por teléfono; el connector normaliza el número antes de enviar. */
+    DeliveryChannelExtendedEnum["WHATSAPP"] = "WHATSAPP";
 })(DeliveryChannelExtendedEnum || (exports.DeliveryChannelExtendedEnum = DeliveryChannelExtendedEnum = {}));

package/bin/messagesConnector/index.d.ts

@@ -23,6 +23,7 @@ export * from './dtos/TemplateMessageListFiltersRequest';
 export * from './constants/MdmNotifyBatchLimits';
 export * from './dtos/MdmNotifyItem';
 export * from './dtos/MdmNotifyRequest';
+export * from './dtos/MdmNotifyQueueMessageRequest';
 export * from './dtos/MdmNotifyResponse';
 export * from './dtos/MdmNotifyBatchResponse';
 export * from './constants/MessageIdempotencyLimits';

package/bin/messagesConnector/index.js

@@ -39,6 +39,7 @@ __exportStar(require("./dtos/TemplateMessageListFiltersRequest"), exports);
 __exportStar(require("./constants/MdmNotifyBatchLimits"), exports);
 __exportStar(require("./dtos/MdmNotifyItem"), exports);
 __exportStar(require("./dtos/MdmNotifyRequest"), exports);
+__exportStar(require("./dtos/MdmNotifyQueueMessageRequest"), exports);
 __exportStar(require("./dtos/MdmNotifyResponse"), exports);
 __exportStar(require("./dtos/MdmNotifyBatchResponse"), exports);
 __exportStar(require("./constants/MessageIdempotencyLimits"), exports);

package/bin/whatsappConnector/dtos/ConnectorSendMessageRequest.d.ts

@@ -0,0 +1,20 @@
+import { DeliveryChannelExtendedEnum } from '../../messagesConnector/index';
+import { SelectedProvider } from './SelectedProvider';
+/**
+ * Contrato de entrada `messages-business → whatsapp-connector`.
+ * El proveedor llega ya resuelto: el connector solo transmite a Meta.
+ */
+export declare class ConnectorSendMessageRequest {
+    /** Canal de entrega. Acepta cualquier valor de `DeliveryChannelExtendedEnum`. */
+    channelType: DeliveryChannelExtendedEnum;
+    /** Teléfono destino. El connector lo normaliza a E.164 antes de enviar. Ej: "+525512345678". */
+    destination: string;
+    /** Tipo de mensaje de dominio. Ej: "OTP_CODE". Solo para logging/trazabilidad. */
+    messageType?: string;
+    /** Idioma de la plantilla. Ej: "es". Obligatorio: Meta lo exige en cada envío. */
+    language: string;
+    /** Tenant dueño del envío. El connector valida contra el que corresponde al `secretRef`. */
+    tenantId: string;
+    /** Proveedor ya seleccionado y resuelto por messages-business. */
+    selectedProvider: SelectedProvider;
+}

package/bin/whatsappConnector/dtos/ConnectorSendMessageRequest.js

@@ -0,0 +1,59 @@
+"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.ConnectorSendMessageRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const index_1 = require("../../messagesConnector/index");
+const SelectedProvider_1 = require("./SelectedProvider");
+/**
+ * Contrato de entrada `messages-business → whatsapp-connector`.
+ * El proveedor llega ya resuelto: el connector solo transmite a Meta.
+ */
+class ConnectorSendMessageRequest {
+}
+exports.ConnectorSendMessageRequest = ConnectorSendMessageRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(index_1.DeliveryChannelExtendedEnum),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "destination", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SelectedProvider_1.SelectedProvider),
+    __metadata("design:type", SelectedProvider_1.SelectedProvider)
+], ConnectorSendMessageRequest.prototype, "selectedProvider", void 0);

package/bin/whatsappConnector/dtos/ConnectorSendMessageResponse.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Respuesta del whatsapp-connector tras delegar el envío a Meta.
+ */
+export declare class ConnectorSendMessageResponse {
+    /** Id del mensaje generado por Meta (wamid...). */
+    providerMessageId: string;
+    /** Estado reportado por Meta al momento del envío (accepted, sent, ...). */
+    status: string;
+}

package/bin/whatsappConnector/dtos/ConnectorSendMessageResponse.js

@@ -0,0 +1,30 @@
+"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.ConnectorSendMessageResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Respuesta del whatsapp-connector tras delegar el envío a Meta.
+ */
+class ConnectorSendMessageResponse {
+}
+exports.ConnectorSendMessageResponse = ConnectorSendMessageResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageResponse.prototype, "providerMessageId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageResponse.prototype, "status", void 0);

package/bin/whatsappConnector/dtos/SelectedProvider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Proveedor ya resuelto por messages-business desde el `senderConfig` del `(tenant, channel)`.
+ * Los nombres son genéricos para no acoplar el contrato al vocabulario del proveedor.
+ */
+export declare class SelectedProvider {
+    /** Plantilla del proveedor ya resuelta. Para Meta = nombre de la plantilla aprobada. */
+    templateId: string;
+    /** Remitente ya resuelto. Para Meta = Phone Number ID de la cuenta de WhatsApp Business. */
+    senderId: string;
+    /** Variables de la plantilla ya resueltas, keyeadas por slot posicional. Ej: { "1": "1234" }. */
+    contentVariables?: Record<string, string>;
+    /**
+     * Referencia (nombre/ARN) al secret de Secrets Manager con las credenciales de Meta.
+     * Es obligatoria: el connector valida que ese secret corresponda al `tenantId` del envío.
+     */
+    secretRef: string;
+}

package/bin/whatsappConnector/dtos/SelectedProvider.js

@@ -0,0 +1,45 @@
+"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.SelectedProvider = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Proveedor ya resuelto por messages-business desde el `senderConfig` del `(tenant, channel)`.
+ * Los nombres son genéricos para no acoplar el contrato al vocabulario del proveedor.
+ */
+class SelectedProvider {
+}
+exports.SelectedProvider = SelectedProvider;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SelectedProvider.prototype, "templateId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SelectedProvider.prototype, "senderId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], SelectedProvider.prototype, "contentVariables", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SelectedProvider.prototype, "secretRef", void 0);

package/bin/whatsappConnector/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/SelectedProvider';
+export * from './dtos/ConnectorSendMessageRequest';
+export * from './dtos/ConnectorSendMessageResponse';

package/bin/whatsappConnector/index.js

@@ -0,0 +1,19 @@
+"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 });
+__exportStar(require("./dtos/SelectedProvider"), exports);
+__exportStar(require("./dtos/ConnectorSendMessageRequest"), exports);
+__exportStar(require("./dtos/ConnectorSendMessageResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -81,6 +81,7 @@ export * as MilestoneBusiness from './milestone-business';
 export * as Mdm from './mdm';
 export * as MessagesConnector from './messagesConnector';
 export * as TwilioConnector from './twilioConnector';
+export * as WhatsappConnector from './whatsappConnector';
 export * as CognitoBackofficeConnector from './cognitoBackofficeConnector';
 // PlatformRbac: módulo del lambda platform-rbac-business (Fase 0 SureKeep).
 // Contiene Permission enum + AuthContext + RoleAssignmentInfo + PermissionScope +

package/src/messagesConnector/dtos/MdmNotifyQueueMessageRequest.ts

@@ -0,0 +1,37 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsOptional, IsString, MaxLength, ValidateNested } from 'class-validator';
+import { MdmNotifyItem } from './MdmNotifyItem';
+import { MDM_NOTIFY_MAX_BATCH } from '../constants/MdmNotifyBatchLimits';
+
+/**
+ * Mensaje que viaja por la cola de messages-business para avisar en lote a los equipos.
+ * Reemplaza al `POST /private/messages/mdm-notify`, que se retira.
+ */
+export class MdmNotifyQueueMessageRequest {
+    /**
+     * Equipos del lote. El tope es el mismo que el del lote de `loan-credit-business`.
+     * El imei repetido duplica el aviso en el equipo y colapsa los dos acuses en uno.
+     */
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(MDM_NOTIFY_MAX_BATCH)
+    @ArrayUnique((item: MdmNotifyItem) => item.imei)
+    @ValidateNested({ each: true })
+    @Type(() => MdmNotifyItem)
+    items!: MdmNotifyItem[];
+
+    /** Tenant emisor del aviso. Si se omite, messages-business asume FIADO. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    tenantId?: string;
+
+    /** Referencia con la que el productor correlaciona este lote. Es la que viaja al proveedor. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    operationReference!: string;
+}

package/src/messagesConnector/enums/DeliveryChannelExtendedEnum.ts

@@ -4,4 +4,6 @@ export enum DeliveryChannelExtendedEnum {
     PUSH_NOTIFICATION = 'PUSH_NOTIFICATION',
     /** Aviso en la pantalla del equipo financiado. Se entrega por IMEI, no por teléfono ni correo. */
     MDM = 'MDM',
+    /** Mensaje por WhatsApp. Se entrega por teléfono; el connector normaliza el número antes de enviar. */
+    WHATSAPP = 'WHATSAPP',
 }

package/src/messagesConnector/index.ts

@@ -23,6 +23,7 @@ export * from './dtos/TemplateMessageListFiltersRequest';
 export * from './constants/MdmNotifyBatchLimits';
 export * from './dtos/MdmNotifyItem';
 export * from './dtos/MdmNotifyRequest';
+export * from './dtos/MdmNotifyQueueMessageRequest';
 export * from './dtos/MdmNotifyResponse';
 export * from './dtos/MdmNotifyBatchResponse';
 export * from './constants/MessageIdempotencyLimits';

package/src/whatsappConnector/dtos/ConnectorSendMessageRequest.ts

@@ -0,0 +1,28 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { DeliveryChannelExtendedEnum } from '../../messagesConnector/index';
+import { SelectedProvider } from './SelectedProvider';
+
+/**
+ * Contrato de entrada `messages-business → whatsapp-connector`.
+ * El proveedor llega ya resuelto: el connector solo transmite a Meta.
+ */
+export class ConnectorSendMessageRequest {
+    /** Canal de entrega. Acepta cualquier valor de `DeliveryChannelExtendedEnum`. */
+    @Expose() @IsEnum(DeliveryChannelExtendedEnum) channelType!: DeliveryChannelExtendedEnum;
+
+    /** Teléfono destino. El connector lo normaliza a E.164 antes de enviar. Ej: "+525512345678". */
+    @Expose() @IsString() @IsNotEmpty() destination!: string;
+
+    /** Tipo de mensaje de dominio. Ej: "OTP_CODE". Solo para logging/trazabilidad. */
+    @Expose() @IsOptional() @IsString() messageType?: string;
+
+    /** Idioma de la plantilla. Ej: "es". Obligatorio: Meta lo exige en cada envío. */
+    @Expose() @IsString() @IsNotEmpty() language!: string;
+
+    /** Tenant dueño del envío. El connector valida contra el que corresponde al `secretRef`. */
+    @Expose() @IsString() @IsNotEmpty() tenantId!: string;
+
+    /** Proveedor ya seleccionado y resuelto por messages-business. */
+    @Expose() @IsDefined() @ValidateNested() @Type(() => SelectedProvider) selectedProvider!: SelectedProvider;
+}

package/src/whatsappConnector/dtos/ConnectorSendMessageResponse.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/**
+ * Respuesta del whatsapp-connector tras delegar el envío a Meta.
+ */
+export class ConnectorSendMessageResponse {
+    /** Id del mensaje generado por Meta (wamid...). */
+    @Expose() @IsString() providerMessageId!: string;
+
+    /** Estado reportado por Meta al momento del envío (accepted, sent, ...). */
+    @Expose() @IsString() status!: string;
+}

package/src/whatsappConnector/dtos/SelectedProvider.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsObject, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Proveedor ya resuelto por messages-business desde el `senderConfig` del `(tenant, channel)`.
+ * Los nombres son genéricos para no acoplar el contrato al vocabulario del proveedor.
+ */
+export class SelectedProvider {
+    /** Plantilla del proveedor ya resuelta. Para Meta = nombre de la plantilla aprobada. */
+    @Expose() @IsString() @IsNotEmpty() templateId!: string;
+
+    /** Remitente ya resuelto. Para Meta = Phone Number ID de la cuenta de WhatsApp Business. */
+    @Expose() @IsString() @IsNotEmpty() senderId!: string;
+
+    /** Variables de la plantilla ya resueltas, keyeadas por slot posicional. Ej: { "1": "1234" }. */
+    @Expose() @IsOptional() @IsObject() contentVariables?: Record<string, string>;
+
+    /**
+     * Referencia (nombre/ARN) al secret de Secrets Manager con las credenciales de Meta.
+     * Es obligatoria: el connector valida que ese secret corresponda al `tenantId` del envío.
+     */
+    @Expose() @IsString() @IsNotEmpty() secretRef!: string;
+}

package/src/whatsappConnector/index.ts

@@ -0,0 +1,3 @@
+export * from './dtos/SelectedProvider';
+export * from './dtos/ConnectorSendMessageRequest';
+export * from './dtos/ConnectorSendMessageResponse';