@fiado/type-kit 3.415.0 → 3.417.0

package/_test_/unit/loanCredit/dtos/loanDeviceContract.test.ts

@@ -334,8 +334,8 @@ describe('LoanDeviceNotifyRequest', () => {
     /** Cota de cada campo de texto libre, para probar el borde exacto y el borde + 1. */
     const NOTIFY_MAX_LENGTHS: ReadonlyArray<readonly [string, number]> = [
         ['notificationCode', 64],
-        ['title', 128],
-        ['content', 1024],
+        ['title', 50],
+        ['content', 350],
     ];
 
     it('valida happy path (0 errores)', async () => {

package/_test_/unit/mdm/dtos/mdmDeviceContract.test.ts

@@ -152,8 +152,8 @@ describe('DeviceNotifyRequest — topes de longitud de los tres textos', () => {
     /** Mismos números que `LoanDeviceNotifyItem`: las dos puntas del contrato dicen lo mismo. */
     const limits = [
         ['notificationCode', 64],
-        ['title', 128],
-        ['content', 1024],
+        ['title', 50],
+        ['content', 350],
     ] as const;
 
     it.each(limits)('acepta %s en el largo máximo', async (field, max) => {

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

@@ -0,0 +1,178 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import { SendMessagesBulkItem } from '../../../src/messagesConnector/dtos/SendMessagesBulkItem';
+import { SendMessagesBulkRequest } from '../../../src/messagesConnector/dtos/SendMessagesBulkRequest';
+import { NotificationQueueMessageRequestV2 } from '../../../src/messagesConnector/dtos/NotificationQueueMessageRequestV2';
+import * as MessagesConnectorBarrel from '../../../src/messagesConnector/index';
+import { DeliveryChannelExtendedEnum } from '../../../src/messagesConnector/enums/DeliveryChannelExtendedEnum';
+import { NotificationOriginEnum } from '../../../src/messagesConnector/enums/NotificationOriginEnum';
+import { MessageBulkResultCodeEnum } from '../../../src/messagesConnector/enums/MessageBulkResultCodeEnum';
+import {
+    MESSAGES_BULK_MAX_BATCH, MESSAGES_BULK_REFERENCE_MAX_LENGTH,
+} from '../../../src/messagesConnector/constants/MessagesBulkLimits';
+
+const validItem = {
+    reference: 'collections-2026-09-09-MORNING-0001',
+    messageType: 'COLLECTION_PRE_DUE_2_DAYS',
+    channelType: DeliveryChannelExtendedEnum.SMS,
+    directoryId: '01M0B5D7FQA3T06K4REEVPRM33',
+    typeOfDirectoryId: 'USER',
+    destination: '+525512345678',
+    language: 'es',
+    country: 'MX',
+    variables: { name: 'Ana', amount: '1200.00' },
+};
+
+const validRequest = { items: [validItem] };
+
+/** True si el error de `property` trae ese constraint puntual (no solo "algo fallo"). */
+const hasConstraint = (errors: ValidationError[], property: string, constraint: string): boolean =>
+    errors.some((e) => e.property === property && Boolean(e.constraints?.[constraint]));
+
+const validateRequest = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(SendMessagesBulkRequest, { ...validRequest, ...payload }));
+
+const validateItem = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(SendMessagesBulkItem, { ...validItem, ...payload }));
+
+describe('SendMessagesBulkItem', () => {
+    it('valida el item minimo del endpoint', async () => {
+        expect(await validateItem({})).toEqual([]);
+    });
+
+    it.each(Object.values(DeliveryChannelExtendedEnum))('valida con channelType %s', async (channelType) => {
+        expect(await validateItem({ channelType })).toEqual([]);
+    });
+
+    it('falla si channelType esta fuera del enum', async () => {
+        expect(hasConstraint(await validateItem({ channelType: 'PIGEON' }), 'channelType', 'isEnum')).toBe(true);
+    });
+
+    it.each(['reference', 'messageType', 'directoryId', 'typeOfDirectoryId', 'destination', 'language', 'country'] as const)(
+        'falla si %s viene vacio', async (field) => {
+            expect(hasConstraint(await validateItem({ [field]: '' }), field, 'isNotEmpty')).toBe(true);
+        });
+
+    it('falla si la referencia excede el largo maximo', async () => {
+        const reference = 'x'.repeat(MESSAGES_BULK_REFERENCE_MAX_LENGTH + 1);
+        expect(hasConstraint(await validateItem({ reference }), 'reference', 'maxLength')).toBe(true);
+    });
+
+    it('falla si una variable no es string: el texto se interpola tal cual', async () => {
+        const errors = await validateItem({ variables: { amount: 1200 } });
+        expect(errors.some((e) => e.property === 'variables')).toBe(true);
+    });
+
+    it('valida con origin explicito', async () => {
+        expect(await validateItem({ origin: NotificationOriginEnum.EVENT })).toEqual([]);
+    });
+
+    it('valida sin origin: su ausencia ya significa EVENT', async () => {
+        const dto = plainToInstance(SendMessagesBulkItem, validItem);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.origin).toBeUndefined();
+    });
+});
+
+describe('SendMessagesBulkRequest', () => {
+    it('valida el sobre minimo', async () => {
+        expect(await validateRequest({})).toEqual([]);
+    });
+
+    it('valida sin tenantId: messages-business asume FIADO', async () => {
+        const dto = plainToInstance(SendMessagesBulkRequest, validRequest);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.tenantId).toBeUndefined();
+    });
+
+    it('falla si items viene vacio', async () => {
+        expect(hasConstraint(await validateRequest({ items: [] }), 'items', 'arrayNotEmpty')).toBe(true);
+    });
+
+    it('falla si dos items repiten la misma referencia: el resultado se devuelve por referencia', async () => {
+        expect(hasConstraint(await validateRequest({ items: [validItem, validItem] }), 'items', 'arrayUnique')).toBe(true);
+    });
+
+    it('NO declara el tope del lote: lo rechaza el lambda con su propio codigo', async () => {
+        const items = Array.from({ length: MESSAGES_BULK_MAX_BATCH + 1 },
+            (_, i) => ({ ...validItem, reference: `ref-${i}` }));
+        expect(await validateRequest({ items })).toEqual([]);
+    });
+
+    it('acepta un lote con los canales mezclados', async () => {
+        const items = [
+            { ...validItem, reference: 'a', channelType: DeliveryChannelExtendedEnum.SMS },
+            { ...validItem, reference: 'b', channelType: DeliveryChannelExtendedEnum.MAIL },
+            { ...validItem, reference: 'c', channelType: DeliveryChannelExtendedEnum.PUSH_NOTIFICATION },
+        ];
+        expect(await validateRequest({ items })).toEqual([]);
+    });
+
+    it('valida en profundidad cada item', async () => {
+        const errors = await validateRequest({ items: [{ ...validItem, channelType: 'PIGEON' }] });
+        const children = errors.find((e) => e.property === 'items')?.children ?? [];
+        expect(hasConstraint(children[0]?.children ?? [], 'channelType', 'isEnum')).toBe(true);
+    });
+
+    it('materializa los items como SendMessagesBulkItem', () => {
+        const dto = plainToInstance(SendMessagesBulkRequest, validRequest);
+        expect(dto.items[0]).toBeInstanceOf(SendMessagesBulkItem);
+    });
+
+    it('falla si tenantId viene vacio: ausente cae a FIADO, pero "" no es un tenant', async () => {
+        expect(hasConstraint(await validateRequest({ tenantId: '' }), 'tenantId', 'isNotEmpty')).toBe(true);
+    });
+});
+
+describe('NotificationQueueMessageRequestV2', () => {
+    const validQueueMessage = {
+        templateId: 'COLLECTION_PRE_DUE_2_DAYS',
+        channelType: DeliveryChannelExtendedEnum.SMS,
+        language: 'es',
+        country: 'MX',
+        typeOfDirectoryId: 'USER',
+        directoryId: '01M0B5D7FQA3T06K4REEVPRM33',
+        destination: '+525512345678',
+        variables: { name: 'Ana' },
+    };
+
+    it('acepta el messageLogId que reserva el lote', async () => {
+        const dto = plainToInstance(NotificationQueueMessageRequestV2,
+            { ...validQueueMessage, messageLogId: 'bulk-1' });
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.messageLogId).toBe('bulk-1');
+    });
+
+    it('sigue valido sin messageLogId: los productores de siempre no lo mandan', async () => {
+        const dto = plainToInstance(NotificationQueueMessageRequestV2, validQueueMessage);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.messageLogId).toBeUndefined();
+    });
+
+    it('falla si messageLogId viene vacio', async () => {
+        const dto = plainToInstance(NotificationQueueMessageRequestV2, { ...validQueueMessage, messageLogId: '' });
+        expect(hasConstraint(await validate(dto), 'messageLogId', 'isNotEmpty')).toBe(true);
+    });
+});
+
+describe('barrel de messagesConnector', () => {
+    it('exporta el par del endpoint de lotes', () => {
+        expect(MessagesConnectorBarrel.SendMessagesBulkItem).toBe(SendMessagesBulkItem);
+        expect(MessagesConnectorBarrel.SendMessagesBulkRequest).toBe(SendMessagesBulkRequest);
+        expect(MessagesConnectorBarrel.SendMessagesBulkResponse).toBeDefined();
+        expect(MessagesConnectorBarrel.SendMessagesBulkResultItem).toBeDefined();
+        expect(MessagesConnectorBarrel.MESSAGES_BULK_MAX_BATCH).toBe(MESSAGES_BULK_MAX_BATCH);
+        expect(MessagesConnectorBarrel.MessageBulkResultCodeEnum).toBe(MessageBulkResultCodeEnum);
+    });
+
+    it('el acuse por item se tipa contra el catalogo de codigos del lote', () => {
+        const result = new MessagesConnectorBarrel.SendMessagesBulkResultItem();
+        result.reference = validItem.reference;
+        result.accepted = true;
+        result.code = MessageBulkResultCodeEnum.QUEUED;
+        result.queueMessageId = 'sqs-1';
+        result.messageLogId = 'log-1';
+        expect(result.code).toBe(MessageBulkResultCodeEnum.QUEUED);
+    });
+});

package/bin/loanCredit/dtos/LoanDeviceNotifyItem.d.ts

@@ -14,8 +14,14 @@ export declare class LoanDeviceNotifyItem {
     noticeType?: MdmNoticeTypeEnum;
     /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
     notificationCode?: string;
-    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 50 y responde `INVALID_RANGE` fuera de rango.
+     */
     title?: string;
-    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 350 y responde `INVALID_RANGE` fuera de rango.
+     */
     content?: string;
 }

package/bin/loanCredit/dtos/LoanDeviceNotifyItem.js

@@ -51,7 +51,7 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(128),
+    (0, class_validator_1.MaxLength)(50),
     __metadata("design:type", String)
 ], LoanDeviceNotifyItem.prototype, "title", void 0);
 __decorate([
@@ -59,6 +59,6 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(1024),
+    (0, class_validator_1.MaxLength)(350),
     __metadata("design:type", String)
 ], LoanDeviceNotifyItem.prototype, "content", void 0);

package/bin/mdm/dtos/DeviceNotifyRequest.d.ts

@@ -8,11 +8,21 @@ export declare class DeviceNotifyRequest {
      * Cuando viaja, manda: los connectors ignoran `notificationCode`, `title` y `content`.
      */
     noticeType?: MdmNoticeTypeEnum;
-    /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`.
+     * Es exclusivo de Datacultr: Trustonic no tiene catálogo de códigos y rechaza el ítem
+     * que solo trae este campo.
+     */
     notificationCode?: string;
-    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 50 y responde `INVALID_RANGE` fuera de rango.
+     */
     title?: string;
-    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 350 y responde `INVALID_RANGE` fuera de rango.
+     */
     content?: string;
     operationReference: string;
 }

package/bin/mdm/dtos/DeviceNotifyRequest.js

@@ -47,7 +47,7 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(128),
+    (0, class_validator_1.MaxLength)(50),
     __metadata("design:type", String)
 ], DeviceNotifyRequest.prototype, "title", void 0);
 __decorate([
@@ -55,7 +55,7 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(1024),
+    (0, class_validator_1.MaxLength)(350),
     __metadata("design:type", String)
 ], DeviceNotifyRequest.prototype, "content", void 0);
 __decorate([

package/bin/messagesConnector/constants/MessagesBulkLimits.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tope de items por llamada a `POST /private/messages/bulk`. El lambda que lo atiende tiene
+ * `Timeout: 25` y cada item cuesta una escritura condicional en DDB mas un envio a SQS, asi
+ * que el lote entero tiene que caber con margen en esa ventana.
+ */
+export declare const MESSAGES_BULK_MAX_BATCH = 100;
+/** Largo maximo de la referencia de idempotencia de un item del lote. */
+export declare const MESSAGES_BULK_REFERENCE_MAX_LENGTH = 96;

package/bin/messagesConnector/constants/MessagesBulkLimits.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MESSAGES_BULK_REFERENCE_MAX_LENGTH = exports.MESSAGES_BULK_MAX_BATCH = void 0;
+/**
+ * Tope de items por llamada a `POST /private/messages/bulk`. El lambda que lo atiende tiene
+ * `Timeout: 25` y cada item cuesta una escritura condicional en DDB mas un envio a SQS, asi
+ * que el lote entero tiene que caber con margen en esa ventana.
+ */
+exports.MESSAGES_BULK_MAX_BATCH = 100;
+/** Largo maximo de la referencia de idempotencia de un item del lote. */
+exports.MESSAGES_BULK_REFERENCE_MAX_LENGTH = 96;

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

@@ -12,6 +12,11 @@ export declare class NotificationQueueMessageRequestV2 {
     destination: string;
     variables: Record<string, string>;
     referenceMessageId?: string;
+    /**
+     * Fila de `MessageLogs_GT` que el lote ya reservo para este mensaje. Cuando viaja, el
+     * consumidor completa esa fila en vez de crear una nueva.
+     */
+    messageLogId?: string;
     data?: unknown;
     /** Quien disparo la notificacion. Sin default: su ausencia ya significa EVENT. */
     origin?: NotificationOriginEnum;

package/bin/messagesConnector/dtos/NotificationQueueMessageRequestV2.js

@@ -77,6 +77,13 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], NotificationQueueMessageRequestV2.prototype, "referenceMessageId", 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)
+], NotificationQueueMessageRequestV2.prototype, "messageLogId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -0,0 +1,22 @@
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
+import { NotificationOriginEnum } from '../enums/NotificationOriginEnum';
+/**
+ * Un mensaje del lote: su destinatario, su momento, su canal y sus variables YA RESUELTAS.
+ * Mensajeria no calcula variables ni decide a quien le toca; eso lo trae hecho el caller.
+ */
+export declare class SendMessagesBulkItem {
+    /** Idempotencia: dos items con la misma referencia se aceptan una sola vez. */
+    reference: string;
+    /** El momento del catalogo de plantillas con el que se resuelve el texto. */
+    messageType: string;
+    channelType: DeliveryChannelExtendedEnum;
+    directoryId: string;
+    typeOfDirectoryId: string;
+    /** Telefono o correo del destinatario, segun el canal. */
+    destination: string;
+    language: string;
+    country: string;
+    variables: Record<string, string>;
+    /** Quien disparo el mensaje. Sin default: su ausencia ya significa EVENT. */
+    origin?: NotificationOriginEnum;
+}

package/bin/messagesConnector/dtos/SendMessagesBulkItem.js

@@ -0,0 +1,85 @@
+"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.SendMessagesBulkItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const DeliveryChannelExtendedEnum_1 = require("../enums/DeliveryChannelExtendedEnum");
+const NotificationOriginEnum_1 = require("../enums/NotificationOriginEnum");
+const IsStringValueRecord_1 = require("../validators/IsStringValueRecord");
+const MessagesBulkLimits_1 = require("../constants/MessagesBulkLimits");
+/**
+ * Un mensaje del lote: su destinatario, su momento, su canal y sus variables YA RESUELTAS.
+ * Mensajeria no calcula variables ni decide a quien le toca; eso lo trae hecho el caller.
+ */
+class SendMessagesBulkItem {
+}
+exports.SendMessagesBulkItem = SendMessagesBulkItem;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(MessagesBulkLimits_1.MESSAGES_BULK_REFERENCE_MAX_LENGTH),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "reference", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(DeliveryChannelExtendedEnum_1.DeliveryChannelExtendedEnum),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "typeOfDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "destination", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.Validate)(IsStringValueRecord_1.IsStringValueRecord),
+    __metadata("design:type", Object)
+], SendMessagesBulkItem.prototype, "variables", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(NotificationOriginEnum_1.NotificationOriginEnum),
+    __metadata("design:type", String)
+], SendMessagesBulkItem.prototype, "origin", void 0);

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

@@ -0,0 +1,14 @@
+import { SendMessagesBulkItem } from './SendMessagesBulkItem';
+/**
+ * Body de `POST /private/messages/bulk` (messages-business). Es la unica entrada de mensajes
+ * a mensajeria y NO exige que el lote sea de un solo canal.
+ *
+ * El tope de items no se declara aca: lo rechaza el lambda con su propio codigo, en vez de
+ * caer al error generico de validacion.
+ */
+export declare class SendMessagesBulkRequest {
+    /** Un resultado por referencia, asi que la referencia repetida no tiene resultado que devolver. */
+    items: SendMessagesBulkItem[];
+    /** Tenant emisor del lote. Si se omite, messages-business asume FIADO. */
+    tenantId?: string;
+}

package/bin/messagesConnector/dtos/SendMessagesBulkRequest.js

@@ -0,0 +1,41 @@
+"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.SendMessagesBulkRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SendMessagesBulkItem_1 = require("./SendMessagesBulkItem");
+/**
+ * Body de `POST /private/messages/bulk` (messages-business). Es la unica entrada de mensajes
+ * a mensajeria y NO exige que el lote sea de un solo canal.
+ *
+ * El tope de items no se declara aca: lo rechaza el lambda con su propio codigo, en vez de
+ * caer al error generico de validacion.
+ */
+class SendMessagesBulkRequest {
+}
+exports.SendMessagesBulkRequest = SendMessagesBulkRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayUnique)((item) => item.reference),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SendMessagesBulkItem_1.SendMessagesBulkItem),
+    __metadata("design:type", Array)
+], SendMessagesBulkRequest.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)
+], SendMessagesBulkRequest.prototype, "tenantId", void 0);

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

@@ -0,0 +1,5 @@
+import { SendMessagesBulkResultItem } from './SendMessagesBulkResultItem';
+/** Response 202 de `POST /private/messages/bulk`. Un resultado por item enviado. */
+export declare class SendMessagesBulkResponse {
+    results: SendMessagesBulkResultItem[];
+}

package/bin/messagesConnector/dtos/SendMessagesBulkResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendMessagesBulkResponse = void 0;
+/** Response 202 de `POST /private/messages/bulk`. Un resultado por item enviado. */
+class SendMessagesBulkResponse {
+}
+exports.SendMessagesBulkResponse = SendMessagesBulkResponse;

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

@@ -0,0 +1,11 @@
+import { MessageBulkResultCodeEnum } from '../enums/MessageBulkResultCodeEnum';
+/** Acuse de UN item del lote. Se correlaciona con el pedido por su `reference`. */
+export declare class SendMessagesBulkResultItem {
+    reference: string;
+    accepted: boolean;
+    code: MessageBulkResultCodeEnum;
+    /** MessageId que asigno SQS. Solo viaja cuando el item quedo encolado. */
+    queueMessageId?: string;
+    /** Fila de `MessageLogs_GT` con la que se sigue el mensaje. Solo cuando el item quedo encolado. */
+    messageLogId?: string;
+}

package/bin/messagesConnector/dtos/SendMessagesBulkResultItem.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendMessagesBulkResultItem = void 0;
+/** Acuse de UN item del lote. Se correlaciona con el pedido por su `reference`. */
+class SendMessagesBulkResultItem {
+}
+exports.SendMessagesBulkResultItem = SendMessagesBulkResultItem;

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

@@ -0,0 +1,16 @@
+/**
+ * Resultado de UN item del lote de `POST /private/messages/bulk`. Es por item a proposito:
+ * un telefono malo no tumba los otros noventa y nueve.
+ */
+export declare enum MessageBulkResultCodeEnum {
+    /** Encolado. La entrega sigue por la cola, con sus reintentos y su DLQ. */
+    QUEUED = "QUEUED",
+    /** Ya se habia aceptado un item con esa misma `reference`: no se encola de nuevo. */
+    DUPLICATE_REFERENCE = "DUPLICATE_REFERENCE",
+    /** El canal no entra por esta puerta. El aviso MDM sale por `mdm-notify`. */
+    CHANNEL_NOT_ACCEPTED = "CHANNEL_NOT_ACCEPTED",
+    /** La cola no acepto el mensaje. Es fallo de infraestructura: el item se puede reintentar. */
+    QUEUE_UNAVAILABLE = "QUEUE_UNAVAILABLE",
+    /** Fallo inesperado al aceptar el item. El resto del lote sigue su curso. */
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}

package/bin/messagesConnector/enums/MessageBulkResultCodeEnum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageBulkResultCodeEnum = void 0;
+/**
+ * Resultado de UN item del lote de `POST /private/messages/bulk`. Es por item a proposito:
+ * un telefono malo no tumba los otros noventa y nueve.
+ */
+var MessageBulkResultCodeEnum;
+(function (MessageBulkResultCodeEnum) {
+    /** Encolado. La entrega sigue por la cola, con sus reintentos y su DLQ. */
+    MessageBulkResultCodeEnum["QUEUED"] = "QUEUED";
+    /** Ya se habia aceptado un item con esa misma `reference`: no se encola de nuevo. */
+    MessageBulkResultCodeEnum["DUPLICATE_REFERENCE"] = "DUPLICATE_REFERENCE";
+    /** El canal no entra por esta puerta. El aviso MDM sale por `mdm-notify`. */
+    MessageBulkResultCodeEnum["CHANNEL_NOT_ACCEPTED"] = "CHANNEL_NOT_ACCEPTED";
+    /** La cola no acepto el mensaje. Es fallo de infraestructura: el item se puede reintentar. */
+    MessageBulkResultCodeEnum["QUEUE_UNAVAILABLE"] = "QUEUE_UNAVAILABLE";
+    /** Fallo inesperado al aceptar el item. El resto del lote sigue su curso. */
+    MessageBulkResultCodeEnum["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(MessageBulkResultCodeEnum || (exports.MessageBulkResultCodeEnum = MessageBulkResultCodeEnum = {}));

package/bin/messagesConnector/index.d.ts

@@ -25,3 +25,9 @@ export * from './dtos/MdmNotifyItem';
 export * from './dtos/MdmNotifyRequest';
 export * from './dtos/MdmNotifyResponse';
 export * from './dtos/MdmNotifyBatchResponse';
+export * from './enums/MessageBulkResultCodeEnum';
+export * from './constants/MessagesBulkLimits';
+export * from './dtos/SendMessagesBulkItem';
+export * from './dtos/SendMessagesBulkRequest';
+export * from './dtos/SendMessagesBulkResultItem';
+export * from './dtos/SendMessagesBulkResponse';

package/bin/messagesConnector/index.js

@@ -41,3 +41,9 @@ __exportStar(require("./dtos/MdmNotifyItem"), exports);
 __exportStar(require("./dtos/MdmNotifyRequest"), exports);
 __exportStar(require("./dtos/MdmNotifyResponse"), exports);
 __exportStar(require("./dtos/MdmNotifyBatchResponse"), exports);
+__exportStar(require("./enums/MessageBulkResultCodeEnum"), exports);
+__exportStar(require("./constants/MessagesBulkLimits"), exports);
+__exportStar(require("./dtos/SendMessagesBulkItem"), exports);
+__exportStar(require("./dtos/SendMessagesBulkRequest"), exports);
+__exportStar(require("./dtos/SendMessagesBulkResultItem"), exports);
+__exportStar(require("./dtos/SendMessagesBulkResponse"), exports);

package/package.json

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

package/src/loanCredit/dtos/LoanDeviceNotifyItem.ts

@@ -34,19 +34,25 @@ export class LoanDeviceNotifyItem {
     @MaxLength(64)
     notificationCode?: string;
 
-    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 50 y responde `INVALID_RANGE` fuera de rango.
+     */
     @Expose()
     @IsOptional()
     @IsString()
     @IsNotEmpty()
-    @MaxLength(128)
+    @MaxLength(50)
     title?: string;
 
-    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 350 y responde `INVALID_RANGE` fuera de rango.
+     */
     @Expose()
     @IsOptional()
     @IsString()
     @IsNotEmpty()
-    @MaxLength(1024)
+    @MaxLength(350)
     content?: string;
 }

package/src/mdm/dtos/DeviceNotifyRequest.ts

@@ -22,7 +22,11 @@ export class DeviceNotifyRequest {
     @IsEnum(MdmNoticeTypeEnum)
     noticeType?: MdmNoticeTypeEnum;
 
-    /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`.
+     * Es exclusivo de Datacultr: Trustonic no tiene catálogo de códigos y rechaza el ítem
+     * que solo trae este campo.
+     */
     @Expose()
     @IsOptional()
     @IsString()
@@ -30,20 +34,26 @@ export class DeviceNotifyRequest {
     @MaxLength(64)
     notificationCode?: string;
 
-    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 50 y responde `INVALID_RANGE` fuera de rango.
+     */
     @Expose()
     @IsOptional()
     @IsString()
     @IsNotEmpty()
-    @MaxLength(128)
+    @MaxLength(50)
     title?: string;
 
-    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    /**
+     * Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`.
+     * El tope es el de Trustonic, que exige de 1 a 350 y responde `INVALID_RANGE` fuera de rango.
+     */
     @Expose()
     @IsOptional()
     @IsString()
     @IsNotEmpty()
-    @MaxLength(1024)
+    @MaxLength(350)
     content?: string;
 
     @Expose()

package/src/messagesConnector/constants/MessagesBulkLimits.ts

@@ -0,0 +1,9 @@
+/**
+ * Tope de items por llamada a `POST /private/messages/bulk`. El lambda que lo atiende tiene
+ * `Timeout: 25` y cada item cuesta una escritura condicional en DDB mas un envio a SQS, asi
+ * que el lote entero tiene que caber con margen en esa ventana.
+ */
+export const MESSAGES_BULK_MAX_BATCH = 100;
+
+/** Largo maximo de la referencia de idempotencia de un item del lote. */
+export const MESSAGES_BULK_REFERENCE_MAX_LENGTH = 96;

package/src/messagesConnector/dtos/NotificationQueueMessageRequestV2.ts

@@ -55,6 +55,16 @@ export class NotificationQueueMessageRequestV2 {
     @IsString()
     referenceMessageId?: string;
 
+    /**
+     * Fila de `MessageLogs_GT` que el lote ya reservo para este mensaje. Cuando viaja, el
+     * consumidor completa esa fila en vez de crear una nueva.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    messageLogId?: string;
+
     @Expose()
     @IsOptional()
     data?: unknown;

package/src/messagesConnector/dtos/SendMessagesBulkItem.ts

@@ -0,0 +1,66 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, MaxLength, Validate } from 'class-validator';
+import { DeliveryChannelExtendedEnum } from '../enums/DeliveryChannelExtendedEnum';
+import { NotificationOriginEnum } from '../enums/NotificationOriginEnum';
+import { IsStringValueRecord } from '../validators/IsStringValueRecord';
+import { MESSAGES_BULK_REFERENCE_MAX_LENGTH } from '../constants/MessagesBulkLimits';
+
+/**
+ * Un mensaje del lote: su destinatario, su momento, su canal y sus variables YA RESUELTAS.
+ * Mensajeria no calcula variables ni decide a quien le toca; eso lo trae hecho el caller.
+ */
+export class SendMessagesBulkItem {
+    /** Idempotencia: dos items con la misma referencia se aceptan una sola vez. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(MESSAGES_BULK_REFERENCE_MAX_LENGTH)
+    reference!: string;
+
+    /** El momento del catalogo de plantillas con el que se resuelve el texto. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    messageType!: string;
+
+    @Expose()
+    @IsEnum(DeliveryChannelExtendedEnum)
+    channelType!: DeliveryChannelExtendedEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    directoryId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    typeOfDirectoryId!: string;
+
+    /** Telefono o correo del destinatario, segun el canal. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    destination!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    language!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    country!: string;
+
+    @Expose()
+    @IsObject()
+    @Validate(IsStringValueRecord)
+    variables!: Record<string, string>;
+
+    /** Quien disparo el mensaje. Sin default: su ausencia ya significa EVENT. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(NotificationOriginEnum)
+    origin?: NotificationOriginEnum;
+}

package/src/messagesConnector/dtos/SendMessagesBulkRequest.ts

@@ -0,0 +1,28 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { SendMessagesBulkItem } from './SendMessagesBulkItem';
+
+/**
+ * Body de `POST /private/messages/bulk` (messages-business). Es la unica entrada de mensajes
+ * a mensajeria y NO exige que el lote sea de un solo canal.
+ *
+ * El tope de items no se declara aca: lo rechaza el lambda con su propio codigo, en vez de
+ * caer al error generico de validacion.
+ */
+export class SendMessagesBulkRequest {
+    /** Un resultado por referencia, asi que la referencia repetida no tiene resultado que devolver. */
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayUnique((item: SendMessagesBulkItem) => item.reference)
+    @ValidateNested({ each: true })
+    @Type(() => SendMessagesBulkItem)
+    items!: SendMessagesBulkItem[];
+
+    /** Tenant emisor del lote. Si se omite, messages-business asume FIADO. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    tenantId?: string;
+}

package/src/messagesConnector/dtos/SendMessagesBulkResponse.ts

@@ -0,0 +1,6 @@
+import { SendMessagesBulkResultItem } from './SendMessagesBulkResultItem';
+
+/** Response 202 de `POST /private/messages/bulk`. Un resultado por item enviado. */
+export class SendMessagesBulkResponse {
+    results!: SendMessagesBulkResultItem[];
+}

package/src/messagesConnector/dtos/SendMessagesBulkResultItem.ts

@@ -0,0 +1,16 @@
+import { MessageBulkResultCodeEnum } from '../enums/MessageBulkResultCodeEnum';
+
+/** Acuse de UN item del lote. Se correlaciona con el pedido por su `reference`. */
+export class SendMessagesBulkResultItem {
+    reference!: string;
+
+    accepted!: boolean;
+
+    code!: MessageBulkResultCodeEnum;
+
+    /** MessageId que asigno SQS. Solo viaja cuando el item quedo encolado. */
+    queueMessageId?: string;
+
+    /** Fila de `MessageLogs_GT` con la que se sigue el mensaje. Solo cuando el item quedo encolado. */
+    messageLogId?: string;
+}

package/src/messagesConnector/enums/MessageBulkResultCodeEnum.ts

@@ -0,0 +1,16 @@
+/**
+ * Resultado de UN item del lote de `POST /private/messages/bulk`. Es por item a proposito:
+ * un telefono malo no tumba los otros noventa y nueve.
+ */
+export enum MessageBulkResultCodeEnum {
+    /** Encolado. La entrega sigue por la cola, con sus reintentos y su DLQ. */
+    QUEUED = 'QUEUED',
+    /** Ya se habia aceptado un item con esa misma `reference`: no se encola de nuevo. */
+    DUPLICATE_REFERENCE = 'DUPLICATE_REFERENCE',
+    /** El canal no entra por esta puerta. El aviso MDM sale por `mdm-notify`. */
+    CHANNEL_NOT_ACCEPTED = 'CHANNEL_NOT_ACCEPTED',
+    /** La cola no acepto el mensaje. Es fallo de infraestructura: el item se puede reintentar. */
+    QUEUE_UNAVAILABLE = 'QUEUE_UNAVAILABLE',
+    /** Fallo inesperado al aceptar el item. El resto del lote sigue su curso. */
+    INTERNAL_ERROR = 'INTERNAL_ERROR',
+}

package/src/messagesConnector/index.ts

@@ -25,3 +25,9 @@ export * from './dtos/MdmNotifyItem';
 export * from './dtos/MdmNotifyRequest';
 export * from './dtos/MdmNotifyResponse';
 export * from './dtos/MdmNotifyBatchResponse';
+export * from './enums/MessageBulkResultCodeEnum';
+export * from './constants/MessagesBulkLimits';
+export * from './dtos/SendMessagesBulkItem';
+export * from './dtos/SendMessagesBulkRequest';
+export * from './dtos/SendMessagesBulkResultItem';
+export * from './dtos/SendMessagesBulkResponse';