@fiado/type-kit 3.411.0 → 3.412.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/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/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';

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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.411.0",
+  "version": "3.412.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/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';