@fiado/type-kit 3.411.0 → 3.413.0

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

@@ -0,0 +1,97 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { ListMessagingCandidatesRequest } from '../../../../src/loanCredit/dtos/requests/ListMessagingCandidatesRequest';
+import { ListMessagingCandidatesResponse } from '../../../../src/loanCredit/dtos/responses/ListMessagingCandidatesResponse';
+import { MessagingCandidateItem } from '../../../../src/loanCredit/dtos/MessagingCandidateItem';
+import { MESSAGING_CANDIDATES_MAX_LIMIT } from '../../../../src/loanCredit/constants/MessagingCandidateLimits';
+import { DeliveryChannelExtendedEnum, MessagingSlotEnum } from '../../../../src/messagesConnector/index';
+import { MdmProviderEnum } from '../../../../src/mdm/enums/MdmProviderEnum';
+
+const RUN_DATE = '2026-09-08';
+
+/** `whitelist: true` es lo que corre el motor en `validateRequest`: sin decorador, la propiedad se borra. */
+const validateWhitelisted = (body: object) => {
+    const dto = plainToInstance(ListMessagingCandidatesRequest, body);
+    return validate(dto, { whitelist: true, forbidNonWhitelisted: false }).then(errors => ({ dto, errors }));
+};
+
+describe('ListMessagingCandidatesRequest', () => {
+    it('acepta la primera página: sin cursor y sin limit', async () => {
+        const { dto, errors } = await validateWhitelisted({ slot: MessagingSlotEnum.MORNING, runDate: RUN_DATE });
+
+        expect(errors).toEqual([]);
+        expect(dto.cursor).toBeUndefined();
+        expect(dto.limit).toBeUndefined();
+    });
+
+    it('convierte el limit que llega como texto', async () => {
+        const { dto, errors } = await validateWhitelisted({ slot: MessagingSlotEnum.EVENING, runDate: RUN_DATE, limit: '25' });
+
+        expect(errors).toEqual([]);
+        expect(dto.limit).toBe(25);
+    });
+
+    it('rechaza un slot fuera del enum', async () => {
+        const { errors } = await validateWhitelisted({ slot: 'NIGHT', runDate: RUN_DATE });
+
+        expect(errors.some(error => error.property === 'slot')).toBe(true);
+    });
+
+    it('rechaza un runDate con hora: el día de tienda no lleva reloj', async () => {
+        const { errors } = await validateWhitelisted({ slot: MessagingSlotEnum.MORNING, runDate: '2026-09-08T10:00:00Z' });
+
+        expect(errors.some(error => error.property === 'runDate')).toBe(true);
+    });
+
+    it('rechaza un limit por encima del tope de página', async () => {
+        const { errors } = await validateWhitelisted({
+            slot: MessagingSlotEnum.AFTERNOON,
+            runDate: RUN_DATE,
+            limit: MESSAGING_CANDIDATES_MAX_LIMIT + 1,
+        });
+
+        expect(errors.some(error => error.property === 'limit')).toBe(true);
+    });
+});
+
+describe('MessagingCandidateItem', () => {
+    it('el candidato sin crédito conserva la persona', () => {
+        const item: MessagingCandidateItem = {
+            personId: '01JB2Z0N7Q9K3M5R8T1V4W6X7Y',
+            messageType: 'COLLECTION_NOTICE',
+            slot: MessagingSlotEnum.MORNING,
+            channel: DeliveryChannelExtendedEnum.SMS,
+            variables: { firstName: 'Ana', amount: '1,250.00' },
+            reference: 'collections#2026-09-08#MORNING#1',
+        };
+
+        expect(item.personId).toBeDefined();
+        expect(item.creditId).toBeUndefined();
+    });
+
+    it('el candidato de MDM lleva IMEI y proveedor', () => {
+        const item: MessagingCandidateItem = {
+            personId: '01JB2Z0N7Q9K3M5R8T1V4W6X7Y',
+            creditId: 'CRD-01JB2Z0N7Q9K3M5R8T1V4W6X7Y',
+            messageType: 'COLLECTION_NOTICE',
+            slot: MessagingSlotEnum.EVENING,
+            channel: DeliveryChannelExtendedEnum.MDM,
+            variables: {},
+            reference: 'collections#2026-09-08#EVENING#7',
+            imei: '351756051523999',
+            mdmProvider: MdmProviderEnum.DATACULTR,
+        };
+
+        expect(item.channel).toBe('MDM');
+        expect(item.imei).toBe('351756051523999');
+    });
+});
+
+describe('ListMessagingCandidatesResponse', () => {
+    it('la última página cierra con nextCursor en null, no en undefined', () => {
+        const response: ListMessagingCandidatesResponse = { items: [], nextCursor: null };
+
+        expect(response.nextCursor).toBeNull();
+    });
+});

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

@@ -148,6 +148,27 @@ describe('DeviceNotifyRequest — los tres textos son opcionales', () => {
     });
 });
 
+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],
+    ] as const;
+
+    it.each(limits)('acepta %s en el largo máximo', async (field, max) => {
+        const dto = plainToInstance(DeviceNotifyRequest, { ...validNotify, [field]: 'x'.repeat(max) });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it.each(limits)('falla si %s excede el largo máximo', async (field, max) => {
+        const dto = plainToInstance(DeviceNotifyRequest, { ...validNotify, [field]: 'x'.repeat(max + 1) });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, field, 'maxLength')).toBe(true);
+    });
+});
+
 describe('MdmNoticeTypeEnum', () => {
     it('expone los diez avisos del catálogo de cobranza', () => {
         expect(Object.values(MdmNoticeTypeEnum)).toEqual([

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

@@ -0,0 +1,162 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import { MdmNotifyItem } from '../../../src/messagesConnector/dtos/MdmNotifyItem';
+import { MdmNotifyRequest } from '../../../src/messagesConnector/dtos/MdmNotifyRequest';
+import * as MessagesConnectorBarrel from '../../../src/messagesConnector/index';
+import { DeviceNotifyIntensityEnum } from '../../../src/mdm/enums/DeviceNotifyIntensityEnum';
+import { MdmNoticeTypeEnum } from '../../../src/mdm/enums/MdmNoticeTypeEnum';
+import { MdmOperationStatusEnum } from '../../../src/mdm/enums/MdmOperationStatusEnum';
+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,
+};
+
+const validRequest = {
+    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 validateRequest = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(MdmNotifyRequest, { ...validRequest, ...payload }));
+
+const validateItem = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(MdmNotifyItem, { ...validItem, ...payload }));
+
+describe('MdmNotifyItem', () => {
+    it('valida el ítem mínimo del endpoint', async () => {
+        expect(await validateItem({})).toEqual([]);
+    });
+
+    it.each(Object.values(MdmProviderEnum))('valida con provider %s', async (provider) => {
+        expect(await validateItem({ provider })).toEqual([]);
+    });
+
+    it('falla si provider está fuera del enum', async () => {
+        expect(hasConstraint(await validateItem({ provider: 'AIRDROID' }), 'provider', 'isEnum')).toBe(true);
+    });
+
+    it.each(Object.values(MdmNoticeTypeEnum))('valida con noticeType %s', async (noticeType) => {
+        expect(await validateItem({ noticeType })).toEqual([]);
+    });
+
+    it('falla si noticeType no viaja: el endpoint resuelve el catálogo, no hay otro camino', async () => {
+        const { noticeType: _omitted, ...rest } = validItem;
+        const errors = await validate(plainToInstance(MdmNotifyItem, rest));
+        expect(hasConstraint(errors, 'noticeType', 'isEnum')).toBe(true);
+    });
+
+    it('falla si intensity no viaja', async () => {
+        const { intensity: _omitted, ...rest } = validItem;
+        const errors = await validate(plainToInstance(MdmNotifyItem, rest));
+        expect(hasConstraint(errors, 'intensity', 'isEnum')).toBe(true);
+    });
+
+    it('falla si el imei viene vacío', async () => {
+        expect(hasConstraint(await validateItem({ imei: '' }), 'imei', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si el creditId no es un ULID', async () => {
+        expect(hasConstraint(await validateItem({ creditId: 'no-es-ulid' }), 'creditId', 'matches')).toBe(true);
+    });
+
+    it('valida sin language ni country: caen al par por defecto', async () => {
+        const dto = plainToInstance(MdmNotifyItem, validItem);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.language).toBeUndefined();
+        expect(dto.country).toBeUndefined();
+    });
+
+    it('valida con language y country explícitos', async () => {
+        expect(await validateItem({ language: 'es', country: 'MX' })).toEqual([]);
+    });
+
+    it.each(['language', 'country'] as const)('falla si %s viene vacío', async (field) => {
+        expect(hasConstraint(await validateItem({ [field]: '' }), field, 'isNotEmpty')).toBe(true);
+    });
+});
+
+describe('MdmNotifyRequest', () => {
+    it('valida el sobre mínimo', async () => {
+        expect(await validateRequest({})).toEqual([]);
+    });
+
+    it('valida sin tenantId: messages-business asume FIADO', async () => {
+        const dto = plainToInstance(MdmNotifyRequest, validRequest);
+        expect(await validate(dto)).toEqual([]);
+        expect(dto.tenantId).toBeUndefined();
+    });
+
+    it('falla si items viene vacío', async () => {
+        expect(hasConstraint(await validateRequest({ items: [] }), 'items', 'arrayNotEmpty')).toBe(true);
+    });
+
+    it('falla si items excede el tope del lote', async () => {
+        const items = Array.from({ length: MDM_NOTIFY_MAX_BATCH + 1 }, () => validItem);
+        expect(hasConstraint(await validateRequest({ items }), 'items', 'arrayMaxSize')).toBe(true);
+    });
+
+    it('falla si dos ítems repiten el mismo imei: el resultado se devuelve por imei', async () => {
+        expect(hasConstraint(await validateRequest({ items: [validItem, validItem] }), 'items', 'arrayUnique')).toBe(true);
+    });
+
+    it('valida en profundidad cada ítem', async () => {
+        const errors = await validateRequest({ items: [{ ...validItem, provider: 'AIRDROID' }] });
+        const children = errors.find((e) => e.property === 'items')?.children ?? [];
+        expect(hasConstraint(children[0]?.children ?? [], 'provider', 'isEnum')).toBe(true);
+    });
+
+    it('materializa los ítems como MdmNotifyItem', async () => {
+        const dto = plainToInstance(MdmNotifyRequest, validRequest);
+        expect(dto.items[0]).toBeInstanceOf(MdmNotifyItem);
+    });
+
+    it('falla si operationReference viene vacío', async () => {
+        expect(hasConstraint(await validateRequest({ operationReference: '' }), 'operationReference', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference excede el largo máximo', async () => {
+        const errors = await validateRequest({ operationReference: 'x'.repeat(65) });
+        expect(hasConstraint(errors, 'operationReference', 'maxLength')).toBe(true);
+    });
+
+    it('falla si tenantId viene vacío: ausente cae a FIADO, pero "" no es un tenant', async () => {
+        expect(hasConstraint(await validateRequest({ tenantId: '' }), 'tenantId', 'isNotEmpty')).toBe(true);
+    });
+
+    it('valida con tenantId explícito', async () => {
+        expect(await validateRequest({ tenantId: 'SUREKEEP' })).toEqual([]);
+    });
+});
+
+describe('barrel de messagesConnector', () => {
+    it('exporta el par del endpoint de avisos MDM', () => {
+        expect(MessagesConnectorBarrel.MdmNotifyItem).toBe(MdmNotifyItem);
+        expect(MessagesConnectorBarrel.MdmNotifyRequest).toBe(MdmNotifyRequest);
+        expect(MessagesConnectorBarrel.MdmNotifyResponse).toBeDefined();
+        expect(MessagesConnectorBarrel.MdmNotifyBatchResponse).toBeDefined();
+        expect(MessagesConnectorBarrel.MDM_NOTIFY_MAX_BATCH).toBe(MDM_NOTIFY_MAX_BATCH);
+    });
+
+    it('el resultado por imei se tipa contra el estado de operación de MDM', () => {
+        const result = new MessagesConnectorBarrel.MdmNotifyResponse();
+        result.imei = validItem.imei;
+        result.creditId = CREDIT_ID;
+        result.status = MdmOperationStatusEnum.SUCCESS;
+        result.sentAt = '2026-09-08T12:00:00.000Z';
+        expect(result.status).toBe(MdmOperationStatusEnum.SUCCESS);
+    });
+});

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

@@ -0,0 +1,37 @@
+import 'reflect-metadata';
+import { DeliveryChannelExtendedEnum, MessagingSlotEnum } from '../../../src/messagesConnector/index';
+
+describe('DeliveryChannelExtendedEnum', () => {
+    it('incluye MDM junto a los tres canales que ya existían', () => {
+        expect(Object.values(DeliveryChannelExtendedEnum).sort()).toEqual([
+            'MAIL',
+            'MDM',
+            'PUSH_NOTIFICATION',
+            'SMS',
+        ]);
+    });
+
+    it('cada clave es igual a su valor', () => {
+        for (const [key, value] of Object.entries(DeliveryChannelExtendedEnum)) {
+            expect(key).toBe(value);
+        }
+    });
+});
+
+describe('MessagingSlotEnum', () => {
+    it('tiene exactamente los tres momentos del contrato', () => {
+        expect(Object.values(MessagingSlotEnum).sort()).toEqual(['AFTERNOON', 'EVENING', 'MORNING']);
+    });
+
+    it('cada clave es igual a su valor', () => {
+        for (const [key, value] of Object.entries(MessagingSlotEnum)) {
+            expect(key).toBe(value);
+        }
+    });
+
+    it('ningún valor lleva la hora: la hora vive en la agenda del tenant', () => {
+        for (const value of Object.values(MessagingSlotEnum)) {
+            expect(value).not.toMatch(/\d/);
+        }
+    });
+});

package/bin/loanCredit/constants/MessagingCandidateLimits.d.ts

@@ -0,0 +1,4 @@
+/** Tope de candidatos por página. Una cartera grande no cabe en una sola llamada. */
+export declare const MESSAGING_CANDIDATES_MAX_LIMIT = 100;
+/** Tamaño de página cuando el caller no manda `limit`. */
+export declare const MESSAGING_CANDIDATES_DEFAULT_LIMIT = 50;

package/bin/loanCredit/constants/MessagingCandidateLimits.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MESSAGING_CANDIDATES_DEFAULT_LIMIT = exports.MESSAGING_CANDIDATES_MAX_LIMIT = void 0;
+/** Tope de candidatos por página. Una cartera grande no cabe en una sola llamada. */
+exports.MESSAGING_CANDIDATES_MAX_LIMIT = 100;
+/** Tamaño de página cuando el caller no manda `limit`. */
+exports.MESSAGING_CANDIDATES_DEFAULT_LIMIT = 50;

package/bin/loanCredit/constants/StoreDayPattern.d.ts

@@ -0,0 +1,3 @@
+/** Día de tienda en la zona horaria del tenant, sin hora: `YYYY-MM-DD`. */
+export declare const STORE_DAY_PATTERN: RegExp;
+export declare const STORE_DAY_MESSAGE = "runDate debe ser un d\u00EDa de tienda en formato YYYY-MM-DD";

package/bin/loanCredit/constants/StoreDayPattern.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORE_DAY_MESSAGE = exports.STORE_DAY_PATTERN = void 0;
+/** Día de tienda en la zona horaria del tenant, sin hora: `YYYY-MM-DD`. */
+exports.STORE_DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+exports.STORE_DAY_MESSAGE = 'runDate debe ser un día de tienda en formato YYYY-MM-DD';

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

@@ -0,0 +1,31 @@
+import { DeliveryChannelExtendedEnum, MessagingSlotEnum } from '../../messagesConnector/index';
+import { MdmProviderEnum } from '../../mdm/enums/MdmProviderEnum';
+/**
+ * Un candidato a recibir un mensaje: a quién, qué momento le toca y por dónde sale.
+ * Mensajería no resuelve nada de dominio con este ítem: solo elige la plantilla y entrega.
+ */
+export declare class MessagingCandidateItem {
+    /** El destinatario es la PERSONA. Siempre viaja. */
+    personId: string;
+    /**
+     * El crédito es el motivo del mensaje, no a quién se le manda.
+     * Va vacío en los avisos que no cuelgan de un crédito.
+     */
+    creditId?: string;
+    /** Momento del catálogo de plantillas — parte de la PK de `TemplateMessages_GT`. */
+    messageType: string;
+    /** Momento de la corrida que produjo este candidato. */
+    slot: MessagingSlotEnum;
+    channel: DeliveryChannelExtendedEnum;
+    /**
+     * Variables del texto YA RESUELTAS. Mensajería no sabe qué es un crédito:
+     * si aquí viajara un id para que ella lo resuelva, cada mensaje sería otra llamada entre lambdas.
+     */
+    variables: Record<string, string>;
+    /** Referencia de rastreo del candidato; el consumidor la usa para deduplicar. */
+    reference: string;
+    /** IMEI del equipo. Solo viaja cuando `channel` es `MDM`. */
+    imei?: string;
+    /** Proveedor MDM del equipo. Solo viaja cuando `channel` es `MDM`. */
+    mdmProvider?: MdmProviderEnum;
+}

package/bin/loanCredit/dtos/MessagingCandidateItem.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagingCandidateItem = void 0;
+/**
+ * Un candidato a recibir un mensaje: a quién, qué momento le toca y por dónde sale.
+ * Mensajería no resuelve nada de dominio con este ítem: solo elige la plantilla y entrega.
+ */
+class MessagingCandidateItem {
+}
+exports.MessagingCandidateItem = MessagingCandidateItem;

package/bin/loanCredit/dtos/requests/ListMessagingCandidatesRequest.d.ts

@@ -0,0 +1,11 @@
+import { MessagingSlotEnum } from '../../../messagesConnector/index';
+/** Body de `POST /private/messaging/candidates` (loan-credit-business). Pide una página de candidatos. */
+export declare class ListMessagingCandidatesRequest {
+    /** Qué horario disparó la corrida. El nombre del momento, nunca la hora. */
+    slot: MessagingSlotEnum;
+    /** Día de tienda de la corrida. Lo manda el caller: el cupo no puede salir del reloj del lambda. */
+    runDate: string;
+    /** Cursor opaco de la página anterior. Ausente en la primera página. */
+    cursor?: string;
+    limit?: number;
+}

package/bin/loanCredit/dtos/requests/ListMessagingCandidatesRequest.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.ListMessagingCandidatesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const index_1 = require("../../../messagesConnector/index");
+const MessagingCandidateLimits_1 = require("../../constants/MessagingCandidateLimits");
+const StoreDayPattern_1 = require("../../constants/StoreDayPattern");
+/** Body de `POST /private/messaging/candidates` (loan-credit-business). Pide una página de candidatos. */
+class ListMessagingCandidatesRequest {
+}
+exports.ListMessagingCandidatesRequest = ListMessagingCandidatesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(index_1.MessagingSlotEnum),
+    __metadata("design:type", String)
+], ListMessagingCandidatesRequest.prototype, "slot", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(StoreDayPattern_1.STORE_DAY_PATTERN, { message: StoreDayPattern_1.STORE_DAY_MESSAGE }),
+    __metadata("design:type", String)
+], ListMessagingCandidatesRequest.prototype, "runDate", 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)
+], ListMessagingCandidatesRequest.prototype, "cursor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(MessagingCandidateLimits_1.MESSAGING_CANDIDATES_MAX_LIMIT),
+    __metadata("design:type", Number)
+], ListMessagingCandidatesRequest.prototype, "limit", void 0);

package/bin/loanCredit/dtos/responses/ListMessagingCandidatesResponse.d.ts

@@ -0,0 +1,7 @@
+import { MessagingCandidateItem } from '../MessagingCandidateItem';
+/** Response de `POST /private/messaging/candidates`. Una página de candidatos. */
+export declare class ListMessagingCandidatesResponse {
+    items: MessagingCandidateItem[];
+    /** Cursor de la siguiente página. `null` significa que ya no queda nadie — nunca `undefined`. */
+    nextCursor: string | null;
+}

package/bin/loanCredit/dtos/responses/ListMessagingCandidatesResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListMessagingCandidatesResponse = void 0;
+/** Response de `POST /private/messaging/candidates`. Una página de candidatos. */
+class ListMessagingCandidatesResponse {
+}
+exports.ListMessagingCandidatesResponse = ListMessagingCandidatesResponse;

package/bin/loanCredit/index.d.ts

@@ -82,3 +82,9 @@ export * from './dtos/responses/LoanDeviceNotifyResponse';
 export * from './dtos/responses/LoanDeviceReleaseResult';
 export * from './dtos/responses/LoanDeviceReleaseResponse';
 export * from './validators/IsFutureIso8601DateTime';
+export { MessagingSlotEnum } from '../messagesConnector/enums/MessagingSlotEnum';
+export * from './constants/MessagingCandidateLimits';
+export * from './constants/StoreDayPattern';
+export * from './dtos/MessagingCandidateItem';
+export * from './dtos/requests/ListMessagingCandidatesRequest';
+export * from './dtos/responses/ListMessagingCandidatesResponse';

package/bin/loanCredit/index.js

@@ -14,7 +14,7 @@ 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 });
-exports.MdmLockModeEnum = exports.DeviceLockScreenMessage = exports.MdmError = exports.DeviceReleaseReasonEnum = exports.MdmNoticeTypeEnum = exports.DeviceNotifyIntensityEnum = exports.DeviceEnrollmentModeEnum = exports.MdmProviderEnum = exports.MdmOperationTypeEnum = exports.MdmDeviceStatusEnum = exports.MdmOperationStatusEnum = exports.ClientLevelEnum = void 0;
+exports.MessagingSlotEnum = exports.MdmLockModeEnum = exports.DeviceLockScreenMessage = exports.MdmError = exports.DeviceReleaseReasonEnum = exports.MdmNoticeTypeEnum = exports.DeviceNotifyIntensityEnum = exports.DeviceEnrollmentModeEnum = exports.MdmProviderEnum = exports.MdmOperationTypeEnum = exports.MdmDeviceStatusEnum = exports.MdmOperationStatusEnum = exports.ClientLevelEnum = void 0;
 // Enums
 __exportStar(require("./enums/LoanCreditStatusEnum"), exports);
 __exportStar(require("./enums/LoanInstallmentStatusEnum"), exports);
@@ -118,3 +118,12 @@ __exportStar(require("./dtos/responses/LoanDeviceNotifyResponse"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceReleaseResult"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceReleaseResponse"), exports);
 __exportStar(require("./validators/IsFutureIso8601DateTime"), exports);
+// Candidatos de mensajería — contrato de `POST /private/messaging/candidates`
+// Re-export del enum canónico del momento (owner: messagesConnector — un solo origen de verdad).
+var MessagingSlotEnum_1 = require("../messagesConnector/enums/MessagingSlotEnum");
+Object.defineProperty(exports, "MessagingSlotEnum", { enumerable: true, get: function () { return MessagingSlotEnum_1.MessagingSlotEnum; } });
+__exportStar(require("./constants/MessagingCandidateLimits"), exports);
+__exportStar(require("./constants/StoreDayPattern"), exports);
+__exportStar(require("./dtos/MessagingCandidateItem"), exports);
+__exportStar(require("./dtos/requests/ListMessagingCandidatesRequest"), exports);
+__exportStar(require("./dtos/responses/ListMessagingCandidatesResponse"), exports);

package/bin/mdm/dtos/DeviceNotifyRequest.js

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

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

@@ -0,0 +1,5 @@
+/**
+ * Mismo tope que el lote de `loan-credit-business`, el único caller del endpoint.
+ * Si aquí fuera más chico, un lote que ese endpoint ya aceptó se caería con 400 al llegar a mensajería.
+ */
+export declare const MDM_NOTIFY_MAX_BATCH = 500;

package/bin/messagesConnector/constants/MdmNotifyBatchLimits.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MDM_NOTIFY_MAX_BATCH = void 0;
+const LoanDeviceBatchLimits_1 = require("../../loanCredit/constants/LoanDeviceBatchLimits");
+/**
+ * Mismo tope que el lote de `loan-credit-business`, el único caller del endpoint.
+ * Si aquí fuera más chico, un lote que ese endpoint ya aceptó se caería con 400 al llegar a mensajería.
+ */
+exports.MDM_NOTIFY_MAX_BATCH = LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH;

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

@@ -0,0 +1,5 @@
+import { MdmNotifyResponse } from './MdmNotifyResponse';
+/** Response de `POST /private/messages/mdm-notify`. Un resultado por ítem enviado. */
+export declare class MdmNotifyBatchResponse {
+    results: MdmNotifyResponse[];
+}

package/bin/messagesConnector/dtos/MdmNotifyBatchResponse.js

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

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

@@ -0,0 +1,22 @@
+import { DeviceNotifyIntensityEnum } from '../../mdm/enums/DeviceNotifyIntensityEnum';
+import { MdmNoticeTypeEnum } from '../../mdm/enums/MdmNoticeTypeEnum';
+import { MdmProviderEnum } from '../../mdm/enums/MdmProviderEnum';
+/**
+ * Equipo al que se le avisa. El caller dice cuál es el aviso; el texto lo resuelve
+ * messages-business contra el catálogo, así que aquí no viajan `title` ni `content`.
+ */
+export declare class MdmNotifyItem {
+    imei: string;
+    creditId: string;
+    /** Proveedor MDM del equipo: messages-business agrupa por él y hace una llamada por grupo. */
+    provider: MdmProviderEnum;
+    /** Id agnóstico del aviso. Es obligatorio: resolverlo contra el catálogo es el punto del endpoint. */
+    noticeType: MdmNoticeTypeEnum;
+    intensity: DeviceNotifyIntensityEnum;
+    /**
+     * Idioma y país con los que se busca la plantilla del aviso.
+     * Ausentes, messages-business cae al par por defecto del tenant.
+     */
+    language?: string;
+    country?: string;
+}

package/bin/messagesConnector/dtos/MdmNotifyItem.js

@@ -0,0 +1,65 @@
+"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.MdmNotifyItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditIdPattern_1 = require("../../common/constants/CreditIdPattern");
+const DeviceNotifyIntensityEnum_1 = require("../../mdm/enums/DeviceNotifyIntensityEnum");
+const MdmNoticeTypeEnum_1 = require("../../mdm/enums/MdmNoticeTypeEnum");
+const MdmProviderEnum_1 = require("../../mdm/enums/MdmProviderEnum");
+/**
+ * Equipo al que se le avisa. El caller dice cuál es el aviso; el texto lo resuelve
+ * messages-business contra el catálogo, así que aquí no viajan `title` ni `content`.
+ */
+class MdmNotifyItem {
+}
+exports.MdmNotifyItem = MdmNotifyItem;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], MdmNotifyItem.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
+    __metadata("design:type", String)
+], MdmNotifyItem.prototype, "creditId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(MdmProviderEnum_1.MdmProviderEnum),
+    __metadata("design:type", String)
+], MdmNotifyItem.prototype, "provider", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(MdmNoticeTypeEnum_1.MdmNoticeTypeEnum),
+    __metadata("design:type", String)
+], MdmNotifyItem.prototype, "noticeType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(DeviceNotifyIntensityEnum_1.DeviceNotifyIntensityEnum),
+    __metadata("design:type", String)
+], MdmNotifyItem.prototype, "intensity", 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)
+], MdmNotifyItem.prototype, "language", 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)
+], MdmNotifyItem.prototype, "country", void 0);

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

@@ -0,0 +1,10 @@
+import { MdmNotifyItem } from './MdmNotifyItem';
+/** Body de `POST /private/messages/mdm-notify` (messages-business). Avisa en lote. */
+export declare class MdmNotifyRequest {
+    /** Un resultado por imei, así que el imei repetido no tiene resultado que devolver. */
+    items: MdmNotifyItem[];
+    /** Tenant emisor del aviso. Si se omite, messages-business asume FIADO. */
+    tenantId?: string;
+    /** Referencia con la que el caller correlaciona este batch. */
+    operationReference: string;
+}

package/bin/messagesConnector/dtos/MdmNotifyRequest.js

@@ -0,0 +1,44 @@
+"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.MdmNotifyRequest = 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");
+/** Body de `POST /private/messages/mdm-notify` (messages-business). Avisa en lote. */
+class MdmNotifyRequest {
+}
+exports.MdmNotifyRequest = MdmNotifyRequest;
+__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)
+], MdmNotifyRequest.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)
+], MdmNotifyRequest.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)
+], MdmNotifyRequest.prototype, "operationReference", void 0);

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

@@ -0,0 +1,11 @@
+import { MdmError } from '../../mdm/dtos/MdmError';
+import { MdmOperationStatusEnum } from '../../mdm/enums/MdmOperationStatusEnum';
+/** Resultado por equipo del aviso en lote. `error` solo viaja cuando el status es ERROR. */
+export declare class MdmNotifyResponse {
+    imei: string;
+    creditId: string;
+    status: MdmOperationStatusEnum;
+    /** Momento en que el proveedor aceptó el aviso, en ISO-8601. */
+    sentAt?: string;
+    error?: MdmError;
+}

package/bin/messagesConnector/dtos/MdmNotifyResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MdmNotifyResponse = void 0;
+/** Resultado por equipo del aviso en lote. `error` solo viaja cuando el status es ERROR. */
+class MdmNotifyResponse {
+}
+exports.MdmNotifyResponse = MdmNotifyResponse;

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

@@ -1,5 +1,7 @@
 export declare enum DeliveryChannelExtendedEnum {
     SMS = "SMS",
     MAIL = "MAIL",
-    PUSH_NOTIFICATION = "PUSH_NOTIFICATION"
+    PUSH_NOTIFICATION = "PUSH_NOTIFICATION",
+    /** Aviso en la pantalla del equipo financiado. Se entrega por IMEI, no por teléfono ni correo. */
+    MDM = "MDM"
 }

package/bin/messagesConnector/enums/DeliveryChannelExtendedEnum.js

@@ -6,4 +6,6 @@ var DeliveryChannelExtendedEnum;
     DeliveryChannelExtendedEnum["SMS"] = "SMS";
     DeliveryChannelExtendedEnum["MAIL"] = "MAIL";
     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";
 })(DeliveryChannelExtendedEnum || (exports.DeliveryChannelExtendedEnum = DeliveryChannelExtendedEnum = {}));

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

@@ -0,0 +1,9 @@
+/**
+ * Momento del día en que corre una agenda de mensajería.
+ * Es el nombre del momento, nunca la hora: la hora vive en la agenda de cada tenant y cambia sin desplegar.
+ */
+export declare enum MessagingSlotEnum {
+    MORNING = "MORNING",
+    AFTERNOON = "AFTERNOON",
+    EVENING = "EVENING"
+}

package/bin/messagesConnector/enums/MessagingSlotEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagingSlotEnum = void 0;
+/**
+ * Momento del día en que corre una agenda de mensajería.
+ * Es el nombre del momento, nunca la hora: la hora vive en la agenda de cada tenant y cambia sin desplegar.
+ */
+var MessagingSlotEnum;
+(function (MessagingSlotEnum) {
+    MessagingSlotEnum["MORNING"] = "MORNING";
+    MessagingSlotEnum["AFTERNOON"] = "AFTERNOON";
+    MessagingSlotEnum["EVENING"] = "EVENING";
+})(MessagingSlotEnum || (exports.MessagingSlotEnum = MessagingSlotEnum = {}));

package/bin/messagesConnector/index.d.ts

@@ -1,5 +1,6 @@
 export * from './enums/DeliveryChannelExtendedEnum';
 export * from './enums/NotificationOriginEnum';
+export * from './enums/MessagingSlotEnum';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';
@@ -19,3 +20,8 @@ export * from './dtos/TemplateMessageUpdateRequest';
 export * from './dtos/TemplateMessageResponse';
 export * from './dtos/TemplateMessageListResponse';
 export * from './dtos/TemplateMessageListFiltersRequest';
+export * from './constants/MdmNotifyBatchLimits';
+export * from './dtos/MdmNotifyItem';
+export * from './dtos/MdmNotifyRequest';
+export * from './dtos/MdmNotifyResponse';
+export * from './dtos/MdmNotifyBatchResponse';

package/bin/messagesConnector/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums/DeliveryChannelExtendedEnum"), exports);
 __exportStar(require("./enums/NotificationOriginEnum"), exports);
+__exportStar(require("./enums/MessagingSlotEnum"), exports);
 __exportStar(require("./validators/IsStringValueRecord"), exports);
 __exportStar(require("./dtos/NotificationQueueMessageRequestV2"), exports);
 __exportStar(require("./dtos/SendMessageRequest"), exports);
@@ -35,3 +36,8 @@ __exportStar(require("./dtos/TemplateMessageUpdateRequest"), exports);
 __exportStar(require("./dtos/TemplateMessageResponse"), exports);
 __exportStar(require("./dtos/TemplateMessageListResponse"), exports);
 __exportStar(require("./dtos/TemplateMessageListFiltersRequest"), exports);
+__exportStar(require("./constants/MdmNotifyBatchLimits"), exports);
+__exportStar(require("./dtos/MdmNotifyItem"), exports);
+__exportStar(require("./dtos/MdmNotifyRequest"), exports);
+__exportStar(require("./dtos/MdmNotifyResponse"), exports);
+__exportStar(require("./dtos/MdmNotifyBatchResponse"), exports);

package/package.json

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

package/src/loanCredit/constants/MessagingCandidateLimits.ts

@@ -0,0 +1,5 @@
+/** Tope de candidatos por página. Una cartera grande no cabe en una sola llamada. */
+export const MESSAGING_CANDIDATES_MAX_LIMIT = 100;
+
+/** Tamaño de página cuando el caller no manda `limit`. */
+export const MESSAGING_CANDIDATES_DEFAULT_LIMIT = 50;

package/src/loanCredit/constants/StoreDayPattern.ts

@@ -0,0 +1,4 @@
+/** Día de tienda en la zona horaria del tenant, sin hora: `YYYY-MM-DD`. */
+export const STORE_DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+export const STORE_DAY_MESSAGE = 'runDate debe ser un día de tienda en formato YYYY-MM-DD';

package/src/loanCredit/dtos/MessagingCandidateItem.ts

@@ -0,0 +1,40 @@
+import { DeliveryChannelExtendedEnum, MessagingSlotEnum } from '../../messagesConnector/index';
+import { MdmProviderEnum } from '../../mdm/enums/MdmProviderEnum';
+
+/**
+ * Un candidato a recibir un mensaje: a quién, qué momento le toca y por dónde sale.
+ * Mensajería no resuelve nada de dominio con este ítem: solo elige la plantilla y entrega.
+ */
+export class MessagingCandidateItem {
+    /** El destinatario es la PERSONA. Siempre viaja. */
+    personId!: string;
+
+    /**
+     * El crédito es el motivo del mensaje, no a quién se le manda.
+     * Va vacío en los avisos que no cuelgan de un crédito.
+     */
+    creditId?: string;
+
+    /** Momento del catálogo de plantillas — parte de la PK de `TemplateMessages_GT`. */
+    messageType!: string;
+
+    /** Momento de la corrida que produjo este candidato. */
+    slot!: MessagingSlotEnum;
+
+    channel!: DeliveryChannelExtendedEnum;
+
+    /**
+     * Variables del texto YA RESUELTAS. Mensajería no sabe qué es un crédito:
+     * si aquí viajara un id para que ella lo resuelva, cada mensaje sería otra llamada entre lambdas.
+     */
+    variables!: Record<string, string>;
+
+    /** Referencia de rastreo del candidato; el consumidor la usa para deduplicar. */
+    reference!: string;
+
+    /** IMEI del equipo. Solo viaja cuando `channel` es `MDM`. */
+    imei?: string;
+
+    /** Proveedor MDM del equipo. Solo viaja cuando `channel` es `MDM`. */
+    mdmProvider?: MdmProviderEnum;
+}

package/src/loanCredit/dtos/requests/ListMessagingCandidatesRequest.ts

@@ -0,0 +1,33 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Max, Min } from 'class-validator';
+import { MessagingSlotEnum } from '../../../messagesConnector/index';
+import { MESSAGING_CANDIDATES_MAX_LIMIT } from '../../constants/MessagingCandidateLimits';
+import { STORE_DAY_MESSAGE, STORE_DAY_PATTERN } from '../../constants/StoreDayPattern';
+
+/** Body de `POST /private/messaging/candidates` (loan-credit-business). Pide una página de candidatos. */
+export class ListMessagingCandidatesRequest {
+    /** Qué horario disparó la corrida. El nombre del momento, nunca la hora. */
+    @Expose()
+    @IsEnum(MessagingSlotEnum)
+    slot!: MessagingSlotEnum;
+
+    /** Día de tienda de la corrida. Lo manda el caller: el cupo no puede salir del reloj del lambda. */
+    @Expose()
+    @Matches(STORE_DAY_PATTERN, { message: STORE_DAY_MESSAGE })
+    runDate!: string;
+
+    /** Cursor opaco de la página anterior. Ausente en la primera página. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    cursor?: string;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(MESSAGING_CANDIDATES_MAX_LIMIT)
+    limit?: number;
+}

package/src/loanCredit/dtos/responses/ListMessagingCandidatesResponse.ts

@@ -0,0 +1,9 @@
+import { MessagingCandidateItem } from '../MessagingCandidateItem';
+
+/** Response de `POST /private/messaging/candidates`. Una página de candidatos. */
+export class ListMessagingCandidatesResponse {
+    items!: MessagingCandidateItem[];
+
+    /** Cursor de la siguiente página. `null` significa que ya no queda nadie — nunca `undefined`. */
+    nextCursor!: string | null;
+}

package/src/loanCredit/index.ts

@@ -98,3 +98,13 @@ export * from './dtos/responses/LoanDeviceReleaseResult';
 export * from './dtos/responses/LoanDeviceReleaseResponse';
 
 export * from './validators/IsFutureIso8601DateTime';
+
+// Candidatos de mensajería — contrato de `POST /private/messaging/candidates`
+// Re-export del enum canónico del momento (owner: messagesConnector — un solo origen de verdad).
+export { MessagingSlotEnum } from '../messagesConnector/enums/MessagingSlotEnum';
+export * from './constants/MessagingCandidateLimits';
+export * from './constants/StoreDayPattern';
+export * from './dtos/MessagingCandidateItem';
+export * from './dtos/requests/ListMessagingCandidatesRequest';
+export * from './dtos/responses/ListMessagingCandidatesResponse';
+

package/src/mdm/dtos/DeviceNotifyRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from "class-transformer";
-import { IsString, IsNotEmpty, IsEnum, IsOptional } from "class-validator";
+import { IsString, IsNotEmpty, IsEnum, IsOptional, MaxLength } from "class-validator";
 import { DeviceNotifyIntensityEnum } from "../enums/DeviceNotifyIntensityEnum";
 import { MdmNoticeTypeEnum } from "../enums/MdmNoticeTypeEnum";
 
@@ -27,6 +27,7 @@ export class DeviceNotifyRequest {
     @IsOptional()
     @IsString()
     @IsNotEmpty()
+    @MaxLength(64)
     notificationCode?: string;
 
     /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
@@ -34,6 +35,7 @@ export class DeviceNotifyRequest {
     @IsOptional()
     @IsString()
     @IsNotEmpty()
+    @MaxLength(128)
     title?: string;
 
     /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
@@ -41,6 +43,7 @@ export class DeviceNotifyRequest {
     @IsOptional()
     @IsString()
     @IsNotEmpty()
+    @MaxLength(1024)
     content?: string;
 
     @Expose()

package/src/messagesConnector/constants/MdmNotifyBatchLimits.ts

@@ -0,0 +1,7 @@
+import { LOAN_DEVICE_MAX_BATCH } from '../../loanCredit/constants/LoanDeviceBatchLimits';
+
+/**
+ * Mismo tope que el lote de `loan-credit-business`, el único caller del endpoint.
+ * Si aquí fuera más chico, un lote que ese endpoint ya aceptó se caería con 400 al llegar a mensajería.
+ */
+export const MDM_NOTIFY_MAX_BATCH = LOAN_DEVICE_MAX_BATCH;

package/src/messagesConnector/dtos/MdmNotifyBatchResponse.ts

@@ -0,0 +1,6 @@
+import { MdmNotifyResponse } from './MdmNotifyResponse';
+
+/** Response de `POST /private/messages/mdm-notify`. Un resultado por ítem enviado. */
+export class MdmNotifyBatchResponse {
+    results!: MdmNotifyResponse[];
+}

package/src/messagesConnector/dtos/MdmNotifyItem.ts

@@ -0,0 +1,51 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, Matches } from 'class-validator';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../../common/constants/CreditIdPattern';
+import { DeviceNotifyIntensityEnum } from '../../mdm/enums/DeviceNotifyIntensityEnum';
+import { MdmNoticeTypeEnum } from '../../mdm/enums/MdmNoticeTypeEnum';
+import { MdmProviderEnum } from '../../mdm/enums/MdmProviderEnum';
+
+/**
+ * Equipo al que se le avisa. El caller dice cuál es el aviso; el texto lo resuelve
+ * messages-business contra el catálogo, así que aquí no viajan `title` ni `content`.
+ */
+export class MdmNotifyItem {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    imei!: string;
+
+    @Expose()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
+    creditId!: string;
+
+    /** Proveedor MDM del equipo: messages-business agrupa por él y hace una llamada por grupo. */
+    @Expose()
+    @IsEnum(MdmProviderEnum)
+    provider!: MdmProviderEnum;
+
+    /** Id agnóstico del aviso. Es obligatorio: resolverlo contra el catálogo es el punto del endpoint. */
+    @Expose()
+    @IsEnum(MdmNoticeTypeEnum)
+    noticeType!: MdmNoticeTypeEnum;
+
+    @Expose()
+    @IsEnum(DeviceNotifyIntensityEnum)
+    intensity!: DeviceNotifyIntensityEnum;
+
+    /**
+     * Idioma y país con los que se busca la plantilla del aviso.
+     * Ausentes, messages-business cae al par por defecto del tenant.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    language?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    country?: string;
+}

package/src/messagesConnector/dtos/MdmNotifyRequest.ts

@@ -0,0 +1,31 @@
+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';
+
+/** Body de `POST /private/messages/mdm-notify` (messages-business). Avisa en lote. */
+export class MdmNotifyRequest {
+    /** Un resultado por imei, así que el imei repetido no tiene resultado que devolver. */
+    @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 caller correlaciona este batch. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    operationReference!: string;
+}

package/src/messagesConnector/dtos/MdmNotifyResponse.ts

@@ -0,0 +1,16 @@
+import { MdmError } from '../../mdm/dtos/MdmError';
+import { MdmOperationStatusEnum } from '../../mdm/enums/MdmOperationStatusEnum';
+
+/** Resultado por equipo del aviso en lote. `error` solo viaja cuando el status es ERROR. */
+export class MdmNotifyResponse {
+    imei!: string;
+
+    creditId!: string;
+
+    status!: MdmOperationStatusEnum;
+
+    /** Momento en que el proveedor aceptó el aviso, en ISO-8601. */
+    sentAt?: string;
+
+    error?: MdmError;
+}

package/src/messagesConnector/enums/DeliveryChannelExtendedEnum.ts

@@ -2,4 +2,6 @@ export enum DeliveryChannelExtendedEnum {
     SMS = 'SMS',
     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',
 }

package/src/messagesConnector/enums/MessagingSlotEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Momento del día en que corre una agenda de mensajería.
+ * Es el nombre del momento, nunca la hora: la hora vive en la agenda de cada tenant y cambia sin desplegar.
+ */
+export enum MessagingSlotEnum {
+    MORNING = 'MORNING',
+    AFTERNOON = 'AFTERNOON',
+    EVENING = 'EVENING',
+}

package/src/messagesConnector/index.ts

@@ -1,5 +1,6 @@
 export * from './enums/DeliveryChannelExtendedEnum';
 export * from './enums/NotificationOriginEnum';
+export * from './enums/MessagingSlotEnum';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';
@@ -19,3 +20,8 @@ export * from './dtos/TemplateMessageUpdateRequest';
 export * from './dtos/TemplateMessageResponse';
 export * from './dtos/TemplateMessageListResponse';
 export * from './dtos/TemplateMessageListFiltersRequest';
+export * from './constants/MdmNotifyBatchLimits';
+export * from './dtos/MdmNotifyItem';
+export * from './dtos/MdmNotifyRequest';
+export * from './dtos/MdmNotifyResponse';
+export * from './dtos/MdmNotifyBatchResponse';