@fiado/type-kit 3.400.0 → 3.401.0

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

@@ -7,7 +7,17 @@ import { LoanDeviceLastSeenRequest } from '../../../../src/loanCredit/dtos/reque
 import { LoanDeviceStatusRequest } from '../../../../src/loanCredit/dtos/requests/LoanDeviceStatusRequest';
 import { LoanDeviceManualLockRequest } from '../../../../src/loanCredit/dtos/requests/LoanDeviceManualLockRequest';
 import { LoanDeviceManualUnlockRequest } from '../../../../src/loanCredit/dtos/requests/LoanDeviceManualUnlockRequest';
+import { LoanDeviceNotifyRequest } from '../../../../src/loanCredit/dtos/requests/LoanDeviceNotifyRequest';
+import { LoanDeviceReleaseRequest } from '../../../../src/loanCredit/dtos/requests/LoanDeviceReleaseRequest';
+import { LoanDeviceNotifyResponse } from '../../../../src/loanCredit/dtos/responses/LoanDeviceNotifyResponse';
+import { LoanDeviceNotifyResult } from '../../../../src/loanCredit/dtos/responses/LoanDeviceNotifyResult';
+import { LoanDeviceReleaseResponse } from '../../../../src/loanCredit/dtos/responses/LoanDeviceReleaseResponse';
+import { LoanDeviceReleaseResult } from '../../../../src/loanCredit/dtos/responses/LoanDeviceReleaseResult';
 import { LoanDeviceLockReasonEnum } from '../../../../src/loanCredit/enums/LoanDeviceLockReasonEnum';
+import { LoanDeviceMdmStatusEnum } from '../../../../src/loanCredit/enums/LoanDeviceMdmStatusEnum';
+import { DeviceNotifyIntensityEnum } from '../../../../src/mdm/enums/DeviceNotifyIntensityEnum';
+import { DeviceReleaseReasonEnum } from '../../../../src/mdm/enums/DeviceReleaseReasonEnum';
+import { MdmOperationStatusEnum } from '../../../../src/mdm/enums/MdmOperationStatusEnum';
 import { LOAN_DEVICE_MAX_BATCH } from '../../../../src/loanCredit/constants/LoanDeviceBatchLimits';
 
 /** ULIDs reales del motor: así es como `LoanCreditService` genera los creditId. */
@@ -34,6 +44,9 @@ const creditIdAt = (index: number): string => {
 const hasConstraint = (errors: ValidationError[], property: string, constraint: string): boolean =>
     errors.some(e => e.property === property && Boolean(e.constraints?.[constraint]));
 
+/** Instante ISO-8601 a N días de ahora; evita que el test caduque con el calendario. */
+const isoInDays = (days: number): string => new Date(Date.now() + days * 86_400_000).toISOString();
+
 const validEnrollItem = {
     creditId: CREDIT_ID,
     imei: '351756051523999',
@@ -230,6 +243,15 @@ describe('LoanDeviceManualUnlockRequest', () => {
         expect(JSON.stringify(itemsError)).toContain('creditId');
     });
 
+    it(`acepta exactamente ${LOAN_DEVICE_MAX_BATCH} ítems`, async () => {
+        const items = Array.from({ length: LOAN_DEVICE_MAX_BATCH }, (_, i) => ({
+            creditId: creditIdAt(i),
+        }));
+        const dto = plainToInstance(LoanDeviceManualUnlockRequest, { ...validUnlock, items });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
     it(`falla si el lote supera ${LOAN_DEVICE_MAX_BATCH} ítems`, async () => {
         const items = Array.from({ length: LOAN_DEVICE_MAX_BATCH + 1 }, (_, i) => ({
             creditId: creditIdAt(i),
@@ -294,3 +316,386 @@ describe.each([
         expect(hasConstraint(errors, 'creditIds', 'arrayUnique')).toBe(true);
     });
 });
+
+describe('LoanDeviceNotifyRequest', () => {
+    const validNotifyItem = {
+        creditId: CREDIT_ID,
+        intensity: DeviceNotifyIntensityEnum.BANNER,
+        notificationCode: 'PAYMENT_REMINDER_D1',
+        title: 'Tu pago está pendiente',
+        content: 'Ponte al corriente para seguir usando tu equipo.',
+    };
+    const validNotify = { items: [validNotifyItem], operationReference: 'notify-2026-09-02-0001' };
+
+    const notifyWithItems = (items: unknown[]) => ({ ...validNotify, items });
+
+    /** Cota de cada campo de texto libre, para probar el borde exacto y el borde + 1. */
+    const NOTIFY_MAX_LENGTHS: ReadonlyArray<readonly [string, number]> = [
+        ['notificationCode', 64],
+        ['title', 128],
+        ['content', 1024],
+    ];
+
+    it('valida happy path (0 errores)', async () => {
+        const dto = plainToInstance(LoanDeviceNotifyRequest, validNotify);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('valida con intensity FULLSCREEN', async () => {
+        const items = [{ ...validNotifyItem, intensity: DeviceNotifyIntensityEnum.FULLSCREEN }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si intensity está fuera del enum', async () => {
+        const items = [{ ...validNotifyItem, intensity: 'POPUP' }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('intensity');
+    });
+
+    it.each(['notificationCode', 'title', 'content'] as const)('falla si %s viene vacío', async field => {
+        const items = [{ ...validNotifyItem, [field]: '' }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain(field);
+    });
+
+    it.each(['notificationCode', 'title', 'content'] as const)('falla si %s no viene', async field => {
+        const { [field]: _omitted, ...rest } = validNotifyItem;
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems([rest]));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain(field);
+    });
+
+    it.each(['notificationCode', 'title', 'content'] as const)('falla si %s no es string', async field => {
+        const items = [{ ...validNotifyItem, [field]: 42 }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain(field);
+    });
+
+    it('falla si intensity no viene', async () => {
+        const { intensity: _omitted, ...rest } = validNotifyItem;
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems([rest]));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('intensity');
+    });
+
+    it.each(NOTIFY_MAX_LENGTHS)('acepta %s en su largo máximo de %i', async (field, max) => {
+        const items = [{ ...validNotifyItem, [field]: 'x'.repeat(max) }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it.each(NOTIFY_MAX_LENGTHS)('falla si %s supera su largo máximo de %i', async (field, max) => {
+        const items = [{ ...validNotifyItem, [field]: 'x'.repeat(max + 1) }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('maxLength');
+        expect(JSON.stringify(itemsError)).toContain(field);
+    });
+
+    it('falla si algún creditId no es un ULID', async () => {
+        const items = [{ ...validNotifyItem, creditId: A_UUID }];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('creditId');
+    });
+
+    it(`acepta exactamente ${LOAN_DEVICE_MAX_BATCH} ítems`, async () => {
+        const items = Array.from({ length: LOAN_DEVICE_MAX_BATCH }, (_, i) => ({
+            ...validNotifyItem,
+            creditId: creditIdAt(i),
+        }));
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it(`falla si el lote supera ${LOAN_DEVICE_MAX_BATCH} ítems`, async () => {
+        const items = Array.from({ length: LOAN_DEVICE_MAX_BATCH + 1 }, (_, i) => ({
+            ...validNotifyItem,
+            creditId: creditIdAt(i),
+        }));
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'items', 'arrayMaxSize')).toBe(true);
+    });
+
+    it('falla si dos ítems traen el mismo creditId', async () => {
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems([validNotifyItem, { ...validNotifyItem }]));
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'items', 'arrayUnique')).toBe(true);
+    });
+
+    it('falla si items viene vacío', async () => {
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems([]));
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'items', 'arrayNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference supera los 64 caracteres', async () => {
+        const dto = plainToInstance(LoanDeviceNotifyRequest, { ...validNotify, operationReference: 'x'.repeat(200) });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'operationReference', 'isLength')).toBe(true);
+    });
+
+    it('falla si operationReference viene vacío', async () => {
+        const dto = plainToInstance(LoanDeviceNotifyRequest, { ...validNotify, operationReference: '' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'operationReference', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference no viene', async () => {
+        const { operationReference: _omitted, ...rest } = validNotify;
+        const dto = plainToInstance(LoanDeviceNotifyRequest, rest);
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'operationReference')).toBe(true);
+    });
+});
+
+describe('LoanDeviceReleaseRequest', () => {
+    const validReleaseItem = { creditId: CREDIT_ID, reason: DeviceReleaseReasonEnum.CREDIT_PAID_OFF };
+    const validRelease = { items: [validReleaseItem], operationReference: 'release-2026-09-02-0001' };
+
+    const releaseWithItems = (items: unknown[]) => ({ ...validRelease, items });
+
+    it('valida happy path sin comment (0 errores)', async () => {
+        const dto = plainToInstance(LoanDeviceReleaseRequest, validRelease);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('valida con comment presente', async () => {
+        const items = [{ ...validReleaseItem, reason: DeviceReleaseReasonEnum.OTHER, comment: 'Equipo robado y repuesto.' }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si comment no es string', async () => {
+        const items = [{ ...validReleaseItem, comment: 42 }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('comment');
+    });
+
+    it('acepta comment en su largo máximo de 500', async () => {
+        const items = [{ ...validReleaseItem, comment: 'x'.repeat(500) }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si comment supera los 500 caracteres', async () => {
+        const items = [{ ...validReleaseItem, comment: 'x'.repeat(501) }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('maxLength');
+        expect(JSON.stringify(itemsError)).toContain('comment');
+    });
+
+    it('falla si reason está fuera del enum', async () => {
+        const items = [{ creditId: CREDIT_ID, reason: 'PORQUE_SI' }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('reason');
+    });
+
+    it('falla si reason no viene', async () => {
+        const items = [{ creditId: CREDIT_ID }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('reason');
+    });
+
+    it('falla si algún creditId no es un ULID', async () => {
+        const items = [{ ...validReleaseItem, creditId: A_UUID }];
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('creditId');
+    });
+
+    it(`acepta exactamente ${LOAN_DEVICE_MAX_BATCH} ítems`, async () => {
+        const items = Array.from({ length: LOAN_DEVICE_MAX_BATCH }, (_, i) => ({
+            ...validReleaseItem,
+            creditId: creditIdAt(i),
+        }));
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it(`falla si el lote supera ${LOAN_DEVICE_MAX_BATCH} ítems`, async () => {
+        const items = Array.from({ length: LOAN_DEVICE_MAX_BATCH + 1 }, (_, i) => ({
+            ...validReleaseItem,
+            creditId: creditIdAt(i),
+        }));
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems(items));
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'items', 'arrayMaxSize')).toBe(true);
+    });
+
+    it('falla si dos ítems traen el mismo creditId', async () => {
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems([validReleaseItem, { ...validReleaseItem }]));
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'items', 'arrayUnique')).toBe(true);
+    });
+
+    it('falla si items viene vacío', async () => {
+        const dto = plainToInstance(LoanDeviceReleaseRequest, releaseWithItems([]));
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'items', 'arrayNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference supera los 64 caracteres', async () => {
+        const dto = plainToInstance(LoanDeviceReleaseRequest, { ...validRelease, operationReference: 'x'.repeat(200) });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'operationReference', 'isLength')).toBe(true);
+    });
+
+    it('falla si operationReference viene vacío', async () => {
+        const dto = plainToInstance(LoanDeviceReleaseRequest, { ...validRelease, operationReference: '' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'operationReference', 'isNotEmpty')).toBe(true);
+    });
+
+    it('falla si operationReference no viene', async () => {
+        const { operationReference: _omitted, ...rest } = validRelease;
+        const dto = plainToInstance(LoanDeviceReleaseRequest, rest);
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'operationReference')).toBe(true);
+    });
+});
+
+describe('LoanDeviceManualUnlockRequest — unlockUntil', () => {
+    const unlockWith = (item: Record<string, unknown>) => ({
+        items: [item],
+        operationReference: 'unlock-2026-09-02-0001',
+    });
+
+    /** Falla y el error apunta a `unlockUntil`. */
+    const expectUnlockUntilRejected = async (unlockUntil: unknown): Promise<void> => {
+        const dto = plainToInstance(LoanDeviceManualUnlockRequest, unlockWith({ creditId: CREDIT_ID, unlockUntil }));
+        const errors = await validate(dto);
+        const itemsError = errors.find(e => e.property === 'items');
+        expect(itemsError).toBeDefined();
+        expect(JSON.stringify(itemsError)).toContain('unlockUntil');
+    };
+
+    it('valida con unlockUntil datetime futuro', async () => {
+        const dto = plainToInstance(LoanDeviceManualUnlockRequest, unlockWith({
+            creditId: CREDIT_ID,
+            unlockUntil: isoInDays(30),
+        }));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si unlockUntil no es ISO-8601', async () => {
+        await expectUnlockUntilRejected('30/09/2026');
+    });
+
+    it('falla si unlockUntil es una fecha pasada', async () => {
+        await expectUnlockUntilRejected(isoInDays(-1));
+    });
+
+    it('falla si unlockUntil es solo fecha, sin hora', async () => {
+        await expectUnlockUntilRejected('2099-09-30');
+    });
+
+    it('falla si unlockUntil no trae zona horaria', async () => {
+        await expectUnlockUntilRejected('2099-09-30T23:59:59');
+    });
+
+    it('falla si unlockUntil no es string', async () => {
+        await expectUnlockUntilRejected(42);
+    });
+
+    it('sigue aceptando ítems sin unlockUntil (el campo es opcional)', async () => {
+        const dto = plainToInstance(LoanDeviceManualUnlockRequest, unlockWith({ creditId: CREDIT_ID }));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+});
+
+describe('responses de notify y release', () => {
+    it('LoanDeviceNotifyResponse arma un resultado por ítem, con la referencia del batch', () => {
+        const response: LoanDeviceNotifyResponse = {
+            results: [
+                {
+                    creditId: CREDIT_ID,
+                    status: MdmOperationStatusEnum.SUCCESS,
+                    operationReference: 'notify-2026-09-02-0001',
+                    mdmStatus: LoanDeviceMdmStatusEnum.LOCKED,
+                    notifiedAt: isoInDays(0),
+                },
+            ],
+        };
+        expect(response.results[0].notifiedAt).toBeDefined();
+        expect(response.results[0].operationReference).toBe('notify-2026-09-02-0001');
+    });
+
+    it('LoanDeviceNotifyResult deja notifiedAt opcional: un ítem puede fallar sin instante', () => {
+        const failed: LoanDeviceNotifyResult = {
+            creditId: CREDIT_ID,
+            status: MdmOperationStatusEnum.ERROR,
+            operationReference: 'notify-2026-09-02-0002',
+            mdmStatus: LoanDeviceMdmStatusEnum.ACTIVE,
+        };
+        expect(failed.notifiedAt).toBeUndefined();
+    });
+
+    it('LoanDeviceReleaseResponse reporta el expediente ya liberado', () => {
+        const response: LoanDeviceReleaseResponse = {
+            results: [
+                {
+                    creditId: CREDIT_ID,
+                    status: MdmOperationStatusEnum.SUCCESS,
+                    operationReference: 'release-2026-09-02-0001',
+                    mdmStatus: LoanDeviceMdmStatusEnum.RELEASED,
+                    releasedAt: isoInDays(0),
+                },
+            ],
+        };
+        expect(response.results[0].mdmStatus).toBe(LoanDeviceMdmStatusEnum.RELEASED);
+    });
+
+    it('LoanDeviceReleaseResult deja releasedAt opcional: un ítem puede fallar sin instante', () => {
+        const failed: LoanDeviceReleaseResult = {
+            creditId: CREDIT_ID,
+            status: MdmOperationStatusEnum.ERROR,
+            operationReference: 'release-2026-09-02-0002',
+            mdmStatus: LoanDeviceMdmStatusEnum.ACTIVE,
+        };
+        expect(failed.releasedAt).toBeUndefined();
+    });
+});

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

@@ -0,0 +1,12 @@
+import { DeviceNotifyIntensityEnum } from '../../mdm/enums/DeviceNotifyIntensityEnum';
+/**
+ * Ítem de notificación: a qué crédito se le avisa y con qué texto.
+ * Los tres campos de texto son obligatorios: Datacultr usa el código y Trustonic el texto crudo.
+ */
+export declare class LoanDeviceNotifyItem {
+    creditId: string;
+    intensity: DeviceNotifyIntensityEnum;
+    notificationCode: string;
+    title: string;
+    content: string;
+}

package/bin/loanCredit/dtos/LoanDeviceNotifyItem.js

@@ -0,0 +1,54 @@
+"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.LoanDeviceNotifyItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const DeviceNotifyIntensityEnum_1 = require("../../mdm/enums/DeviceNotifyIntensityEnum");
+const CreditIdPattern_1 = require("../constants/CreditIdPattern");
+/**
+ * Ítem de notificación: a qué crédito se le avisa y con qué texto.
+ * Los tres campos de texto son obligatorios: Datacultr usa el código y Trustonic el texto crudo.
+ */
+class LoanDeviceNotifyItem {
+}
+exports.LoanDeviceNotifyItem = LoanDeviceNotifyItem;
+__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)
+], LoanDeviceNotifyItem.prototype, "creditId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(DeviceNotifyIntensityEnum_1.DeviceNotifyIntensityEnum),
+    __metadata("design:type", String)
+], LoanDeviceNotifyItem.prototype, "intensity", 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)
+], LoanDeviceNotifyItem.prototype, "notificationCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], LoanDeviceNotifyItem.prototype, "title", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(1024),
+    __metadata("design:type", String)
+], LoanDeviceNotifyItem.prototype, "content", void 0);

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

@@ -0,0 +1,8 @@
+import { DeviceReleaseReasonEnum } from '../../mdm/enums/DeviceReleaseReasonEnum';
+/** Ítem de liberación definitiva: qué crédito se libera del MDM y por qué. */
+export declare class LoanDeviceReleaseItem {
+    creditId: string;
+    reason: DeviceReleaseReasonEnum;
+    /** Nota libre del operador; queda en el expediente del dispositivo. */
+    comment?: string;
+}

package/bin/loanCredit/dtos/LoanDeviceReleaseItem.js

@@ -0,0 +1,37 @@
+"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.LoanDeviceReleaseItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const DeviceReleaseReasonEnum_1 = require("../../mdm/enums/DeviceReleaseReasonEnum");
+const CreditIdPattern_1 = require("../constants/CreditIdPattern");
+/** Ítem de liberación definitiva: qué crédito se libera del MDM y por qué. */
+class LoanDeviceReleaseItem {
+}
+exports.LoanDeviceReleaseItem = LoanDeviceReleaseItem;
+__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)
+], LoanDeviceReleaseItem.prototype, "creditId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(DeviceReleaseReasonEnum_1.DeviceReleaseReasonEnum),
+    __metadata("design:type", String)
+], LoanDeviceReleaseItem.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], LoanDeviceReleaseItem.prototype, "comment", void 0);

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

@@ -0,0 +1,6 @@
+/** Ítem de desbloqueo: qué crédito se desbloquea y, opcionalmente, hasta cuándo. */
+export declare class LoanDeviceUnlockItem {
+    creditId: string;
+    /** Datetime ISO-8601 futuro de hasta cuándo vale el desbloqueo; solo aplica en modo SCHEDULED. */
+    unlockUntil?: string;
+}

package/bin/loanCredit/dtos/LoanDeviceUnlockItem.js

@@ -0,0 +1,31 @@
+"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.LoanDeviceUnlockItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditIdPattern_1 = require("../constants/CreditIdPattern");
+const IsFutureIso8601DateTime_1 = require("../validators/IsFutureIso8601DateTime");
+/** Ítem de desbloqueo: qué crédito se desbloquea y, opcionalmente, hasta cuándo. */
+class LoanDeviceUnlockItem {
+}
+exports.LoanDeviceUnlockItem = LoanDeviceUnlockItem;
+__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)
+], LoanDeviceUnlockItem.prototype, "creditId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Validate)(IsFutureIso8601DateTime_1.IsFutureIso8601DateTime),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], LoanDeviceUnlockItem.prototype, "unlockUntil", void 0);

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

@@ -1,7 +1,7 @@
-import { LoanDeviceCreditRefItem } from '../LoanDeviceCreditRefItem';
+import { LoanDeviceUnlockItem } from '../LoanDeviceUnlockItem';
 /** Body de `POST /private/devices/manual-unlock` (loan-credit-business). Desbloquea en lote. */
 export declare class LoanDeviceManualUnlockRequest {
-    items: LoanDeviceCreditRefItem[];
+    items: LoanDeviceUnlockItem[];
     /** Referencia con la que el caller correlaciona este batch; vuelve en cada resultado. */
     operationReference: string;
 }

package/bin/loanCredit/dtos/requests/LoanDeviceManualUnlockRequest.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoanDeviceManualUnlockRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const LoanDeviceCreditRefItem_1 = require("../LoanDeviceCreditRefItem");
+const LoanDeviceUnlockItem_1 = require("../LoanDeviceUnlockItem");
 const LoanDeviceBatchLimits_1 = require("../../constants/LoanDeviceBatchLimits");
 /** Body de `POST /private/devices/manual-unlock` (loan-credit-business). Desbloquea en lote. */
 class LoanDeviceManualUnlockRequest {
@@ -25,7 +25,7 @@ __decorate([
     (0, class_validator_1.ArrayMaxSize)(LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH),
     (0, class_validator_1.ArrayUnique)((item) => item.creditId),
     (0, class_validator_1.ValidateNested)({ each: true }),
-    (0, class_transformer_1.Type)(() => LoanDeviceCreditRefItem_1.LoanDeviceCreditRefItem),
+    (0, class_transformer_1.Type)(() => LoanDeviceUnlockItem_1.LoanDeviceUnlockItem),
     __metadata("design:type", Array)
 ], LoanDeviceManualUnlockRequest.prototype, "items", void 0);
 __decorate([

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

@@ -0,0 +1,7 @@
+import { LoanDeviceNotifyItem } from '../LoanDeviceNotifyItem';
+/** Body de `POST /private/devices/notify` (loan-credit-business). Notifica en lote. */
+export declare class LoanDeviceNotifyRequest {
+    items: LoanDeviceNotifyItem[];
+    /** Referencia con la que el caller correlaciona este batch; vuelve en cada resultado. */
+    operationReference: string;
+}

package/bin/loanCredit/dtos/requests/LoanDeviceNotifyRequest.js

@@ -0,0 +1,37 @@
+"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.LoanDeviceNotifyRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const LoanDeviceNotifyItem_1 = require("../LoanDeviceNotifyItem");
+const LoanDeviceBatchLimits_1 = require("../../constants/LoanDeviceBatchLimits");
+/** Body de `POST /private/devices/notify` (loan-credit-business). Notifica en lote. */
+class LoanDeviceNotifyRequest {
+}
+exports.LoanDeviceNotifyRequest = LoanDeviceNotifyRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH),
+    (0, class_validator_1.ArrayUnique)((item) => item.creditId),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => LoanDeviceNotifyItem_1.LoanDeviceNotifyItem),
+    __metadata("design:type", Array)
+], LoanDeviceNotifyRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Length)(1, 64),
+    __metadata("design:type", String)
+], LoanDeviceNotifyRequest.prototype, "operationReference", void 0);

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

@@ -0,0 +1,7 @@
+import { LoanDeviceReleaseItem } from '../LoanDeviceReleaseItem';
+/** Body de `POST /private/devices/release` (loan-credit-business). Libera en lote. */
+export declare class LoanDeviceReleaseRequest {
+    items: LoanDeviceReleaseItem[];
+    /** Referencia con la que el caller correlaciona este batch; vuelve en cada resultado. */
+    operationReference: string;
+}

package/bin/loanCredit/dtos/requests/LoanDeviceReleaseRequest.js

@@ -0,0 +1,37 @@
+"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.LoanDeviceReleaseRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const LoanDeviceReleaseItem_1 = require("../LoanDeviceReleaseItem");
+const LoanDeviceBatchLimits_1 = require("../../constants/LoanDeviceBatchLimits");
+/** Body de `POST /private/devices/release` (loan-credit-business). Libera en lote. */
+class LoanDeviceReleaseRequest {
+}
+exports.LoanDeviceReleaseRequest = LoanDeviceReleaseRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH),
+    (0, class_validator_1.ArrayUnique)((item) => item.creditId),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => LoanDeviceReleaseItem_1.LoanDeviceReleaseItem),
+    __metadata("design:type", Array)
+], LoanDeviceReleaseRequest.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Length)(1, 64),
+    __metadata("design:type", String)
+], LoanDeviceReleaseRequest.prototype, "operationReference", void 0);

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

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

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

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

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

@@ -0,0 +1,8 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+/** Resultado por crédito de la notificación en lote. */
+export declare class LoanDeviceNotifyResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar la notificación. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+    notifiedAt?: string;
+}

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoanDeviceNotifyResult = void 0;
+const LoanDeviceOperationResult_1 = require("../LoanDeviceOperationResult");
+/** Resultado por crédito de la notificación en lote. */
+class LoanDeviceNotifyResult extends LoanDeviceOperationResult_1.LoanDeviceOperationResult {
+}
+exports.LoanDeviceNotifyResult = LoanDeviceNotifyResult;

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

@@ -0,0 +1,5 @@
+import { LoanDeviceReleaseResult } from './LoanDeviceReleaseResult';
+/** Response de `POST /private/devices/release`. Un resultado por ítem enviado. */
+export declare class LoanDeviceReleaseResponse {
+    results: LoanDeviceReleaseResult[];
+}

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

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

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

@@ -0,0 +1,8 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+/** Resultado por crédito de la liberación definitiva en lote. */
+export declare class LoanDeviceReleaseResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar la liberación. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+    releasedAt?: string;
+}

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoanDeviceReleaseResult = void 0;
+const LoanDeviceOperationResult_1 = require("../LoanDeviceOperationResult");
+/** Resultado por crédito de la liberación definitiva en lote. */
+class LoanDeviceReleaseResult extends LoanDeviceOperationResult_1.LoanDeviceOperationResult {
+}
+exports.LoanDeviceReleaseResult = LoanDeviceReleaseResult;

package/bin/loanCredit/index.d.ts

@@ -33,6 +33,8 @@ export { MdmDeviceStatusEnum } from '../mdm/enums/MdmDeviceStatusEnum';
 export { MdmOperationTypeEnum } from '../mdm/enums/MdmOperationTypeEnum';
 export { MdmProviderEnum } from '../mdm/enums/MdmProviderEnum';
 export { DeviceEnrollmentModeEnum } from '../mdm/enums/DeviceEnrollmentModeEnum';
+export { DeviceNotifyIntensityEnum } from '../mdm/enums/DeviceNotifyIntensityEnum';
+export { DeviceReleaseReasonEnum } from '../mdm/enums/DeviceReleaseReasonEnum';
 export { MdmError } from '../mdm/dtos/MdmError';
 export { DeviceLockScreenMessage } from '../mdm/dtos/DeviceLockScreenMessage';
 export { MdmLockModeEnum } from '../retailCatalog/enums/MdmLockModeEnum';
@@ -42,12 +44,17 @@ export * from './dtos/LoanDeviceOperationResult';
 export * from './dtos/LoanDeviceCreditRefItem';
 export * from './dtos/LoanDeviceEnrollItem';
 export * from './dtos/LoanDeviceManualLockItem';
+export * from './dtos/LoanDeviceUnlockItem';
+export * from './dtos/LoanDeviceNotifyItem';
+export * from './dtos/LoanDeviceReleaseItem';
 export * from './dtos/requests/LoanDeviceEnrollRequest';
 export * from './dtos/requests/LoanDeviceEnrollStatusRequest';
 export * from './dtos/requests/LoanDeviceStatusRequest';
 export * from './dtos/requests/LoanDeviceLastSeenRequest';
 export * from './dtos/requests/LoanDeviceManualLockRequest';
 export * from './dtos/requests/LoanDeviceManualUnlockRequest';
+export * from './dtos/requests/LoanDeviceNotifyRequest';
+export * from './dtos/requests/LoanDeviceReleaseRequest';
 export * from './dtos/responses/LoanDeviceEnrollResult';
 export * from './dtos/responses/LoanDeviceEnrollResponse';
 export * from './dtos/responses/LoanDeviceEnrollStatusResult';
@@ -61,3 +68,8 @@ export * from './dtos/responses/LoanDeviceManualLockResponse';
 export * from './dtos/responses/LoanDevicePinUnlockResult';
 export * from './dtos/responses/LoanDeviceUnlockResult';
 export * from './dtos/responses/LoanDeviceManualUnlockResponse';
+export * from './dtos/responses/LoanDeviceNotifyResult';
+export * from './dtos/responses/LoanDeviceNotifyResponse';
+export * from './dtos/responses/LoanDeviceReleaseResult';
+export * from './dtos/responses/LoanDeviceReleaseResponse';
+export * from './validators/IsFutureIso8601DateTime';

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.DeviceEnrollmentModeEnum = exports.MdmProviderEnum = exports.MdmOperationTypeEnum = exports.MdmDeviceStatusEnum = exports.MdmOperationStatusEnum = exports.ClientLevelEnum = void 0;
+exports.MdmLockModeEnum = exports.DeviceLockScreenMessage = exports.MdmError = exports.DeviceReleaseReasonEnum = 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);
@@ -63,6 +63,10 @@ var MdmProviderEnum_1 = require("../mdm/enums/MdmProviderEnum");
 Object.defineProperty(exports, "MdmProviderEnum", { enumerable: true, get: function () { return MdmProviderEnum_1.MdmProviderEnum; } });
 var DeviceEnrollmentModeEnum_1 = require("../mdm/enums/DeviceEnrollmentModeEnum");
 Object.defineProperty(exports, "DeviceEnrollmentModeEnum", { enumerable: true, get: function () { return DeviceEnrollmentModeEnum_1.DeviceEnrollmentModeEnum; } });
+var DeviceNotifyIntensityEnum_1 = require("../mdm/enums/DeviceNotifyIntensityEnum");
+Object.defineProperty(exports, "DeviceNotifyIntensityEnum", { enumerable: true, get: function () { return DeviceNotifyIntensityEnum_1.DeviceNotifyIntensityEnum; } });
+var DeviceReleaseReasonEnum_1 = require("../mdm/enums/DeviceReleaseReasonEnum");
+Object.defineProperty(exports, "DeviceReleaseReasonEnum", { enumerable: true, get: function () { return DeviceReleaseReasonEnum_1.DeviceReleaseReasonEnum; } });
 var MdmError_1 = require("../mdm/dtos/MdmError");
 Object.defineProperty(exports, "MdmError", { enumerable: true, get: function () { return MdmError_1.MdmError; } });
 var DeviceLockScreenMessage_1 = require("../mdm/dtos/DeviceLockScreenMessage");
@@ -75,12 +79,17 @@ __exportStar(require("./dtos/LoanDeviceOperationResult"), exports);
 __exportStar(require("./dtos/LoanDeviceCreditRefItem"), exports);
 __exportStar(require("./dtos/LoanDeviceEnrollItem"), exports);
 __exportStar(require("./dtos/LoanDeviceManualLockItem"), exports);
+__exportStar(require("./dtos/LoanDeviceUnlockItem"), exports);
+__exportStar(require("./dtos/LoanDeviceNotifyItem"), exports);
+__exportStar(require("./dtos/LoanDeviceReleaseItem"), exports);
 __exportStar(require("./dtos/requests/LoanDeviceEnrollRequest"), exports);
 __exportStar(require("./dtos/requests/LoanDeviceEnrollStatusRequest"), exports);
 __exportStar(require("./dtos/requests/LoanDeviceStatusRequest"), exports);
 __exportStar(require("./dtos/requests/LoanDeviceLastSeenRequest"), exports);
 __exportStar(require("./dtos/requests/LoanDeviceManualLockRequest"), exports);
 __exportStar(require("./dtos/requests/LoanDeviceManualUnlockRequest"), exports);
+__exportStar(require("./dtos/requests/LoanDeviceNotifyRequest"), exports);
+__exportStar(require("./dtos/requests/LoanDeviceReleaseRequest"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceEnrollResult"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceEnrollResponse"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceEnrollStatusResult"), exports);
@@ -94,3 +103,8 @@ __exportStar(require("./dtos/responses/LoanDeviceManualLockResponse"), exports);
 __exportStar(require("./dtos/responses/LoanDevicePinUnlockResult"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceUnlockResult"), exports);
 __exportStar(require("./dtos/responses/LoanDeviceManualUnlockResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceNotifyResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceNotifyResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceReleaseResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceReleaseResponse"), exports);
+__exportStar(require("./validators/IsFutureIso8601DateTime"), exports);

package/bin/loanCredit/validators/IsFutureIso8601DateTime.d.ts

@@ -0,0 +1,18 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/**
+ * Valida que el valor sea un datetime ISO-8601 con hora y zona, y posterior al momento actual.
+ *
+ * Por qué no alcanza `@IsISO8601()`:
+ * - acepta el date-only (`"2026-09-30"`), que no fija un instante y el proveedor MDM necesita uno;
+ * - acepta fechas pasadas, y un corte "hasta ayer" es un no-op silencioso.
+ *
+ * Uso típico:
+ * ```ts
+ *   @Validate(IsFutureIso8601DateTime)
+ *   unlockUntil?: string;
+ * ```
+ */
+export declare class IsFutureIso8601DateTime implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean;
+    defaultMessage(args: ValidationArguments): string;
+}

package/bin/loanCredit/validators/IsFutureIso8601DateTime.js

@@ -0,0 +1,41 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsFutureIso8601DateTime = void 0;
+const class_validator_1 = require("class-validator");
+/** Datetime ISO-8601 completo: fecha, hora y zona (`Z` u offset). Rechaza el date-only. */
+const ISO_DATETIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/;
+/**
+ * Valida que el valor sea un datetime ISO-8601 con hora y zona, y posterior al momento actual.
+ *
+ * Por qué no alcanza `@IsISO8601()`:
+ * - acepta el date-only (`"2026-09-30"`), que no fija un instante y el proveedor MDM necesita uno;
+ * - acepta fechas pasadas, y un corte "hasta ayer" es un no-op silencioso.
+ *
+ * Uso típico:
+ * ```ts
+ *   @Validate(IsFutureIso8601DateTime)
+ *   unlockUntil?: string;
+ * ```
+ */
+let IsFutureIso8601DateTime = class IsFutureIso8601DateTime {
+    validate(value, _args) {
+        if (typeof value !== 'string' || !ISO_DATETIME_PATTERN.test(value)) {
+            return false;
+        }
+        const instant = Date.parse(value);
+        return !Number.isNaN(instant) && instant > Date.now();
+    }
+    defaultMessage(args) {
+        return `${args.property} debe ser un datetime ISO-8601 con hora y zona, y posterior al momento actual`;
+    }
+};
+exports.IsFutureIso8601DateTime = IsFutureIso8601DateTime;
+exports.IsFutureIso8601DateTime = IsFutureIso8601DateTime = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isFutureIso8601DateTime', async: false })
+], IsFutureIso8601DateTime);

package/package.json

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

package/src/loanCredit/dtos/LoanDeviceNotifyItem.ts

@@ -0,0 +1,36 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsString, Matches, MaxLength } from 'class-validator';
+import { DeviceNotifyIntensityEnum } from '../../mdm/enums/DeviceNotifyIntensityEnum';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
+
+/**
+ * Ítem de notificación: a qué crédito se le avisa y con qué texto.
+ * Los tres campos de texto son obligatorios: Datacultr usa el código y Trustonic el texto crudo.
+ */
+export class LoanDeviceNotifyItem {
+    @Expose()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
+    creditId: string;
+
+    @Expose()
+    @IsEnum(DeviceNotifyIntensityEnum)
+    intensity: DeviceNotifyIntensityEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    notificationCode: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    title: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(1024)
+    content: string;
+}

package/src/loanCredit/dtos/LoanDeviceReleaseItem.ts

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, Matches, MaxLength } from 'class-validator';
+import { DeviceReleaseReasonEnum } from '../../mdm/enums/DeviceReleaseReasonEnum';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
+
+/** Ítem de liberación definitiva: qué crédito se libera del MDM y por qué. */
+export class LoanDeviceReleaseItem {
+    @Expose()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
+    creditId: string;
+
+    @Expose()
+    @IsEnum(DeviceReleaseReasonEnum)
+    reason: DeviceReleaseReasonEnum;
+
+    /** Nota libre del operador; queda en el expediente del dispositivo. */
+    @Expose()
+    @IsString()
+    @IsOptional()
+    @MaxLength(500)
+    comment?: string;
+}

package/src/loanCredit/dtos/LoanDeviceUnlockItem.ts

@@ -0,0 +1,17 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, Matches, Validate } from 'class-validator';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
+import { IsFutureIso8601DateTime } from '../validators/IsFutureIso8601DateTime';
+
+/** Ítem de desbloqueo: qué crédito se desbloquea y, opcionalmente, hasta cuándo. */
+export class LoanDeviceUnlockItem {
+    @Expose()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
+    creditId: string;
+
+    /** Datetime ISO-8601 futuro de hasta cuándo vale el desbloqueo; solo aplica en modo SCHEDULED. */
+    @Expose()
+    @Validate(IsFutureIso8601DateTime)
+    @IsOptional()
+    unlockUntil?: string;
+}

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

@@ -1,6 +1,6 @@
 import { Expose, Type } from 'class-transformer';
 import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsString, Length, ValidateNested } from 'class-validator';
-import { LoanDeviceCreditRefItem } from '../LoanDeviceCreditRefItem';
+import { LoanDeviceUnlockItem } from '../LoanDeviceUnlockItem';
 import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
 
 /** Body de `POST /private/devices/manual-unlock` (loan-credit-business). Desbloquea en lote. */
@@ -9,10 +9,10 @@ export class LoanDeviceManualUnlockRequest {
     @IsArray()
     @ArrayNotEmpty()
     @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
-    @ArrayUnique((item: LoanDeviceCreditRefItem) => item.creditId)
+    @ArrayUnique((item: LoanDeviceUnlockItem) => item.creditId)
     @ValidateNested({ each: true })
-    @Type(() => LoanDeviceCreditRefItem)
-    items: LoanDeviceCreditRefItem[];
+    @Type(() => LoanDeviceUnlockItem)
+    items: LoanDeviceUnlockItem[];
 
     /** Referencia con la que el caller correlaciona este batch; vuelve en cada resultado. */
     @Expose()

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

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsString, Length, ValidateNested } from 'class-validator';
+import { LoanDeviceNotifyItem } from '../LoanDeviceNotifyItem';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/notify` (loan-credit-business). Notifica en lote. */
+export class LoanDeviceNotifyRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique((item: LoanDeviceNotifyItem) => item.creditId)
+    @ValidateNested({ each: true })
+    @Type(() => LoanDeviceNotifyItem)
+    items: LoanDeviceNotifyItem[];
+
+    /** Referencia con la que el caller correlaciona este batch; vuelve en cada resultado. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Length(1, 64)
+    operationReference: string;
+}

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

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsString, Length, ValidateNested } from 'class-validator';
+import { LoanDeviceReleaseItem } from '../LoanDeviceReleaseItem';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/release` (loan-credit-business). Libera en lote. */
+export class LoanDeviceReleaseRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique((item: LoanDeviceReleaseItem) => item.creditId)
+    @ValidateNested({ each: true })
+    @Type(() => LoanDeviceReleaseItem)
+    items: LoanDeviceReleaseItem[];
+
+    /** Referencia con la que el caller correlaciona este batch; vuelve en cada resultado. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Length(1, 64)
+    operationReference: string;
+}

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

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

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

@@ -0,0 +1,10 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+
+/** Resultado por crédito de la notificación en lote. */
+export class LoanDeviceNotifyResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar la notificación. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    notifiedAt?: string;
+}

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

@@ -0,0 +1,6 @@
+import { LoanDeviceReleaseResult } from './LoanDeviceReleaseResult';
+
+/** Response de `POST /private/devices/release`. Un resultado por ítem enviado. */
+export class LoanDeviceReleaseResponse {
+    results: LoanDeviceReleaseResult[];
+}

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

@@ -0,0 +1,10 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+
+/** Resultado por crédito de la liberación definitiva en lote. */
+export class LoanDeviceReleaseResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar la liberación. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    releasedAt?: string;
+}

package/src/loanCredit/index.ts

@@ -44,6 +44,8 @@ export { MdmDeviceStatusEnum } from '../mdm/enums/MdmDeviceStatusEnum';
 export { MdmOperationTypeEnum } from '../mdm/enums/MdmOperationTypeEnum';
 export { MdmProviderEnum } from '../mdm/enums/MdmProviderEnum';
 export { DeviceEnrollmentModeEnum } from '../mdm/enums/DeviceEnrollmentModeEnum';
+export { DeviceNotifyIntensityEnum } from '../mdm/enums/DeviceNotifyIntensityEnum';
+export { DeviceReleaseReasonEnum } from '../mdm/enums/DeviceReleaseReasonEnum';
 export { MdmError } from '../mdm/dtos/MdmError';
 export { DeviceLockScreenMessage } from '../mdm/dtos/DeviceLockScreenMessage';
 export { MdmLockModeEnum } from '../retailCatalog/enums/MdmLockModeEnum';
@@ -55,6 +57,9 @@ export * from './dtos/LoanDeviceOperationResult';
 export * from './dtos/LoanDeviceCreditRefItem';
 export * from './dtos/LoanDeviceEnrollItem';
 export * from './dtos/LoanDeviceManualLockItem';
+export * from './dtos/LoanDeviceUnlockItem';
+export * from './dtos/LoanDeviceNotifyItem';
+export * from './dtos/LoanDeviceReleaseItem';
 
 export * from './dtos/requests/LoanDeviceEnrollRequest';
 export * from './dtos/requests/LoanDeviceEnrollStatusRequest';
@@ -62,6 +67,8 @@ export * from './dtos/requests/LoanDeviceStatusRequest';
 export * from './dtos/requests/LoanDeviceLastSeenRequest';
 export * from './dtos/requests/LoanDeviceManualLockRequest';
 export * from './dtos/requests/LoanDeviceManualUnlockRequest';
+export * from './dtos/requests/LoanDeviceNotifyRequest';
+export * from './dtos/requests/LoanDeviceReleaseRequest';
 
 export * from './dtos/responses/LoanDeviceEnrollResult';
 export * from './dtos/responses/LoanDeviceEnrollResponse';
@@ -76,3 +83,9 @@ export * from './dtos/responses/LoanDeviceManualLockResponse';
 export * from './dtos/responses/LoanDevicePinUnlockResult';
 export * from './dtos/responses/LoanDeviceUnlockResult';
 export * from './dtos/responses/LoanDeviceManualUnlockResponse';
+export * from './dtos/responses/LoanDeviceNotifyResult';
+export * from './dtos/responses/LoanDeviceNotifyResponse';
+export * from './dtos/responses/LoanDeviceReleaseResult';
+export * from './dtos/responses/LoanDeviceReleaseResponse';
+
+export * from './validators/IsFutureIso8601DateTime';

package/src/loanCredit/validators/IsFutureIso8601DateTime.ts

@@ -0,0 +1,32 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+
+/** Datetime ISO-8601 completo: fecha, hora y zona (`Z` u offset). Rechaza el date-only. */
+const ISO_DATETIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/;
+
+/**
+ * Valida que el valor sea un datetime ISO-8601 con hora y zona, y posterior al momento actual.
+ *
+ * Por qué no alcanza `@IsISO8601()`:
+ * - acepta el date-only (`"2026-09-30"`), que no fija un instante y el proveedor MDM necesita uno;
+ * - acepta fechas pasadas, y un corte "hasta ayer" es un no-op silencioso.
+ *
+ * Uso típico:
+ * ```ts
+ *   @Validate(IsFutureIso8601DateTime)
+ *   unlockUntil?: string;
+ * ```
+ */
+@ValidatorConstraint({ name: 'isFutureIso8601DateTime', async: false })
+export class IsFutureIso8601DateTime implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        if (typeof value !== 'string' || !ISO_DATETIME_PATTERN.test(value)) {
+            return false;
+        }
+        const instant = Date.parse(value);
+        return !Number.isNaN(instant) && instant > Date.now();
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} debe ser un datetime ISO-8601 con hora y zona, y posterior al momento actual`;
+    }
+}