@fiado/type-kit 3.412.0 → 3.413.0

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/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/index.d.ts

@@ -20,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

@@ -36,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.412.0",
+  "version": "3.413.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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/index.ts

@@ -20,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';