@fiado/type-kit 3.544.0 → 3.545.0

package/_test_/unit/loanCredit/devicePostureBackfillDtos.test.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { DevicePostureBackfillResult, RunDevicePostureBackfillRequest } from '../../../src/loanCredit/index';
+
+const valid = { dryRun: true, requestedBy: 'andres@somosfiado.com', reason: 'F3: backfill en prod' };
+
+describe('RunDevicePostureBackfillRequest', () => {
+    it('valida el dry-run y la corrida real', async () => {
+        for (const dryRun of [true, false]) {
+            expect(await validate(plainToInstance(RunDevicePostureBackfillRequest, { ...valid, dryRun }))).toEqual([]);
+        }
+    });
+
+    it('dryRun es obligatorio y booleano: no se infiere una corrida real', async () => {
+        const missing = await validate(plainToInstance(RunDevicePostureBackfillRequest, { requestedBy: valid.requestedBy, reason: valid.reason }));
+        const text = await validate(plainToInstance(RunDevicePostureBackfillRequest, { ...valid, dryRun: 'false' }));
+        expect(missing.map(e => e.property)).toContain('dryRun');
+        expect(text.map(e => e.property)).toContain('dryRun');
+    });
+
+    it('acepta el cursor de la página anterior', async () => {
+        expect(await validate(plainToInstance(RunDevicePostureBackfillRequest, { ...valid, cursor: 'eyJwayI6IkNSRURJVCMxIn0' }))).toEqual([]);
+    });
+});
+
+describe('DevicePostureBackfillResult', () => {
+    it('reporta lo contado y lo escrito por separado', () => {
+        const result: DevicePostureBackfillResult = {
+            dryRun: true,
+            devicesScanned: 120,
+            wouldWrite: 5,
+            written: 0,
+            skippedByCondition: 0,
+            nextCursor: 'eyJwayI6IkNSRURJVCMyIn0',
+        };
+        expect(result.written).toBe(0);
+    });
+});

package/_test_/unit/loanCredit/reconcileModeDtos.test.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    ReconcileModeEnum,
+    ReconcileModeView,
+    UpdateReconcileModeRequest,
+} from '../../../src/loanCredit/index';
+import { MdmProviderEnum } from '../../../src/mdm/enums/MdmProviderEnum';
+
+const validUpdate = { mode: 'ACT', expectedVersion: 0, reason: 'T3 aprobada', requestedBy: 'andres@somosfiado.com' };
+
+describe('UpdateReconcileModeRequest', () => {
+    it('valida OBSERVE y ACT', async () => {
+        for (const mode of [ReconcileModeEnum.OBSERVE, ReconcileModeEnum.ACT]) {
+            const errors = await validate(plainToInstance(UpdateReconcileModeRequest, { ...validUpdate, mode }));
+            expect(errors).toEqual([]);
+        }
+    });
+
+    it('rechaza un modo fuera del enum', async () => {
+        const errors = await validate(plainToInstance(UpdateReconcileModeRequest, { ...validUpdate, mode: 'SHADOW' }));
+        expect(errors.map(e => e.property)).toContain('mode');
+    });
+
+    it('exige expectedVersion entero ≥ 0: con 0 se crea la fila', async () => {
+        const negative = await validate(plainToInstance(UpdateReconcileModeRequest, { ...validUpdate, expectedVersion: -1 }));
+        const missing = await validate(plainToInstance(UpdateReconcileModeRequest, { mode: 'ACT', reason: 'x', requestedBy: 'a@b.mx' }));
+        expect(negative.map(e => e.property)).toContain('expectedVersion');
+        expect(missing.map(e => e.property)).toContain('expectedVersion');
+    });
+
+    it('exige quién lo pide y por qué', async () => {
+        const errors = await validate(plainToInstance(UpdateReconcileModeRequest, { mode: 'ACT', expectedVersion: 0 }));
+        expect(errors.map(e => e.property).sort()).toEqual(['reason', 'requestedBy']);
+    });
+});
+
+describe('ReconcileModeView', () => {
+    it('describe el modo vigente de un proveedor', () => {
+        const view: ReconcileModeView = {
+            provider: MdmProviderEnum.TRUSTONIC,
+            mode: ReconcileModeEnum.OBSERVE,
+            version: 0,
+        };
+        expect(view.mode).toBe('OBSERVE');
+    });
+});

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

@@ -0,0 +1,46 @@
+import 'reflect-metadata';
+import { DeviceStatusResponse } from '../../../../src/mdm/dtos/DeviceStatusResponse';
+import { MdmErrorCodeEnum } from '../../../../src/mdm/enums/MdmErrorCodeEnum';
+import { MdmOperationStatusEnum } from '../../../../src/mdm/enums/MdmOperationStatusEnum';
+import * as MdmBarrel from '../../../../src/mdm/index';
+
+describe('DeviceStatusResponse — corte del proveedor', () => {
+    it('distingue «el proveedor tiene corte» de «el proveedor dice que no hay»', () => {
+        const withCut: DeviceStatusResponse = {
+            imei: '356253241262026',
+            status: MdmOperationStatusEnum.SUCCESS,
+            lockScheduledFor: '2026-10-23T05:59:59.000Z',
+        };
+        const withoutCut: DeviceStatusResponse = {
+            imei: '356253241262026',
+            status: MdmOperationStatusEnum.SUCCESS,
+            lockScheduledFor: null,
+        };
+        expect(withCut.lockScheduledFor).toBe('2026-10-23T05:59:59.000Z');
+        expect(withoutCut.lockScheduledFor).toBeNull();
+    });
+
+    it('el corte ilegible viaja en su propio campo y no toca el error del ítem', () => {
+        const unreadable: DeviceStatusResponse = {
+            imei: '352999000000023',
+            status: MdmOperationStatusEnum.SUCCESS,
+            lockScheduleReadError: {
+                code: MdmErrorCodeEnum.PROVIDER_NOT_SUPPORTED,
+                message: 'El proveedor no permite leer el corte por IMEI',
+            },
+        };
+        expect(unreadable.error).toBeUndefined();
+        expect(unreadable.lockScheduledFor).toBeUndefined();
+        expect(unreadable.lockScheduleReadError?.code).toBe(MdmErrorCodeEnum.PROVIDER_NOT_SUPPORTED);
+    });
+
+    it('el connector viejo no manda ninguno de los dos campos', () => {
+        const legacy: DeviceStatusResponse = { imei: '1', status: MdmOperationStatusEnum.SUCCESS };
+        expect('lockScheduledFor' in legacy).toBe(false);
+        expect('lockScheduleReadError' in legacy).toBe(false);
+    });
+
+    it('sale por el barrel de mdm', () => {
+        expect(MdmBarrel.DeviceStatusResponse).toBeDefined();
+    });
+});

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

@@ -0,0 +1,9 @@
+/** Body de `POST /private/device-posture/backfill` (loan-credit-business). */
+export declare class RunDevicePostureBackfillRequest {
+    /** `true` sólo cuenta lo que escribiría; `false` escribe. Nunca se infiere. */
+    dryRun: boolean;
+    requestedBy: string;
+    reason: string;
+    /** `nextCursor` de la corrida anterior, para seguir donde cortó por presupuesto. */
+    cursor?: string;
+}

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

@@ -0,0 +1,42 @@
+"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.RunDevicePostureBackfillRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Body de `POST /private/device-posture/backfill` (loan-credit-business). */
+class RunDevicePostureBackfillRequest {
+}
+exports.RunDevicePostureBackfillRequest = RunDevicePostureBackfillRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], RunDevicePostureBackfillRequest.prototype, "dryRun", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], RunDevicePostureBackfillRequest.prototype, "requestedBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(300),
+    __metadata("design:type", String)
+], RunDevicePostureBackfillRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2048),
+    __metadata("design:type", String)
+], RunDevicePostureBackfillRequest.prototype, "cursor", void 0);

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

@@ -0,0 +1,9 @@
+import { ReconcileModeEnum } from '../../enums/ReconcileModeEnum';
+/** Body de `PUT /private/reconcile-modes/:provider` (loan-credit-business). */
+export declare class UpdateReconcileModeRequest {
+    mode: ReconcileModeEnum;
+    /** Versión que el cliente leyó con el GET; 0 cuando la fila todavía no existe. */
+    expectedVersion: number;
+    reason: string;
+    requestedBy: string;
+}

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

@@ -0,0 +1,42 @@
+"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.UpdateReconcileModeRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReconcileModeEnum_1 = require("../../enums/ReconcileModeEnum");
+/** Body de `PUT /private/reconcile-modes/:provider` (loan-credit-business). */
+class UpdateReconcileModeRequest {
+}
+exports.UpdateReconcileModeRequest = UpdateReconcileModeRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReconcileModeEnum_1.ReconcileModeEnum),
+    __metadata("design:type", String)
+], UpdateReconcileModeRequest.prototype, "mode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], UpdateReconcileModeRequest.prototype, "expectedVersion", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(300),
+    __metadata("design:type", String)
+], UpdateReconcileModeRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], UpdateReconcileModeRequest.prototype, "requestedBy", void 0);

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

@@ -0,0 +1,12 @@
+/** Resultado de una página del backfill. Sin `nextCursor`, la flota ya se recorrió completa. */
+export interface DevicePostureBackfillResult {
+    dryRun: boolean;
+    devicesScanned: number;
+    /** Intenciones manuales y prórrogas que faltan en el expediente. */
+    wouldWrite: number;
+    /** Siempre 0 en dry-run. */
+    written: number;
+    /** Escrituras que perdieron la condición (ya existía el campo o cambió la versión). */
+    skippedByCondition: number;
+    nextCursor?: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,11 @@
+import { MdmProviderEnum } from '../../../mdm/enums/MdmProviderEnum';
+import { ReconcileModeEnum } from '../../enums/ReconcileModeEnum';
+/** Modo vigente del conciliador para un proveedor. Sin fila guardada: OBSERVE con versión 0. */
+export interface ReconcileModeView {
+    provider: MdmProviderEnum;
+    mode: ReconcileModeEnum;
+    version: number;
+    updatedBy?: string;
+    updatedAt?: string;
+    reason?: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/enums/ReconcileModeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Modo del conciliador del corte, por proveedor: sólo calcula (OBSERVE) o también decide (ACT). */
+export declare enum ReconcileModeEnum {
+    OBSERVE = "OBSERVE",
+    ACT = "ACT"
+}

package/bin/loanCredit/enums/ReconcileModeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconcileModeEnum = void 0;
+/** Modo del conciliador del corte, por proveedor: sólo calcula (OBSERVE) o también decide (ACT). */
+var ReconcileModeEnum;
+(function (ReconcileModeEnum) {
+    ReconcileModeEnum["OBSERVE"] = "OBSERVE";
+    ReconcileModeEnum["ACT"] = "ACT";
+})(ReconcileModeEnum || (exports.ReconcileModeEnum = ReconcileModeEnum = {}));

package/bin/loanCredit/index.d.ts

@@ -160,3 +160,8 @@ export * from './dtos/responses/SellerPaymentOptions';
 export * from './dtos/responses/SellerCreditLookupResult';
 export * from './dtos/responses/InStorePaymentListItem';
 export * from './dtos/responses/CreditCustomerListItem';
+export * from './enums/ReconcileModeEnum';
+export * from './dtos/requests/UpdateReconcileModeRequest';
+export * from './dtos/responses/ReconcileModeView';
+export * from './dtos/requests/RunDevicePostureBackfillRequest';
+export * from './dtos/responses/DevicePostureBackfillResult';

package/bin/loanCredit/index.js

@@ -204,3 +204,9 @@ __exportStar(require("./dtos/responses/SellerPaymentOptions"), exports);
 __exportStar(require("./dtos/responses/SellerCreditLookupResult"), exports);
 __exportStar(require("./dtos/responses/InStorePaymentListItem"), exports);
 __exportStar(require("./dtos/responses/CreditCustomerListItem"), exports);
+// Conciliador del corte MDM: modo por proveedor y backfill
+__exportStar(require("./enums/ReconcileModeEnum"), exports);
+__exportStar(require("./dtos/requests/UpdateReconcileModeRequest"), exports);
+__exportStar(require("./dtos/responses/ReconcileModeView"), exports);
+__exportStar(require("./dtos/requests/RunDevicePostureBackfillRequest"), exports);
+__exportStar(require("./dtos/responses/DevicePostureBackfillResult"), exports);

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

@@ -11,5 +11,9 @@ export declare class DeviceStatusResponse {
     lastSeenAt?: string;
     lastTransition?: string;
     enrolledAt?: string;
+    /** Corte que el proveedor tiene armado (ISO-8601). `null`: el proveedor dice que no hay corte. */
+    lockScheduledFor?: string | null;
+    /** No se pudo leer el corte; el `error` del ítem sigue hablando sólo del estado del equipo. */
+    lockScheduleReadError?: MdmError;
     error?: MdmError;
 }

package/package.json

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

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

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsEmail, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+
+/** Body de `POST /private/device-posture/backfill` (loan-credit-business). */
+export class RunDevicePostureBackfillRequest {
+    /** `true` sólo cuenta lo que escribiría; `false` escribe. Nunca se infiere. */
+    @Expose()
+    @IsBoolean()
+    dryRun!: boolean;
+
+    @Expose()
+    @IsEmail()
+    requestedBy!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(300)
+    reason!: string;
+
+    /** `nextCursor` de la corrida anterior, para seguir donde cortó por presupuesto. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(2048)
+    cursor?: string;
+}

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

@@ -0,0 +1,26 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsEnum, IsInt, IsNotEmpty, IsString, MaxLength, Min } from 'class-validator';
+import { ReconcileModeEnum } from '../../enums/ReconcileModeEnum';
+
+/** Body de `PUT /private/reconcile-modes/:provider` (loan-credit-business). */
+export class UpdateReconcileModeRequest {
+    @Expose()
+    @IsEnum(ReconcileModeEnum)
+    mode!: ReconcileModeEnum;
+
+    /** Versión que el cliente leyó con el GET; 0 cuando la fila todavía no existe. */
+    @Expose()
+    @IsInt()
+    @Min(0)
+    expectedVersion!: number;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(300)
+    reason!: string;
+
+    @Expose()
+    @IsEmail()
+    requestedBy!: string;
+}

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

@@ -0,0 +1,12 @@
+/** Resultado de una página del backfill. Sin `nextCursor`, la flota ya se recorrió completa. */
+export interface DevicePostureBackfillResult {
+    dryRun: boolean;
+    devicesScanned: number;
+    /** Intenciones manuales y prórrogas que faltan en el expediente. */
+    wouldWrite: number;
+    /** Siempre 0 en dry-run. */
+    written: number;
+    /** Escrituras que perdieron la condición (ya existía el campo o cambió la versión). */
+    skippedByCondition: number;
+    nextCursor?: string;
+}

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

@@ -0,0 +1,12 @@
+import { MdmProviderEnum } from '../../../mdm/enums/MdmProviderEnum';
+import { ReconcileModeEnum } from '../../enums/ReconcileModeEnum';
+
+/** Modo vigente del conciliador para un proveedor. Sin fila guardada: OBSERVE con versión 0. */
+export interface ReconcileModeView {
+    provider: MdmProviderEnum;
+    mode: ReconcileModeEnum;
+    version: number;
+    updatedBy?: string;
+    updatedAt?: string;
+    reason?: string;
+}

package/src/loanCredit/enums/ReconcileModeEnum.ts

@@ -0,0 +1,5 @@
+/** Modo del conciliador del corte, por proveedor: sólo calcula (OBSERVE) o también decide (ACT). */
+export enum ReconcileModeEnum {
+    OBSERVE = 'OBSERVE',
+    ACT = 'ACT',
+}

package/src/loanCredit/index.ts

@@ -188,3 +188,10 @@ export * from './dtos/responses/SellerPaymentOptions';
 export * from './dtos/responses/SellerCreditLookupResult';
 export * from './dtos/responses/InStorePaymentListItem';
 export * from './dtos/responses/CreditCustomerListItem';
+
+// Conciliador del corte MDM: modo por proveedor y backfill
+export * from './enums/ReconcileModeEnum';
+export * from './dtos/requests/UpdateReconcileModeRequest';
+export * from './dtos/responses/ReconcileModeView';
+export * from './dtos/requests/RunDevicePostureBackfillRequest';
+export * from './dtos/responses/DevicePostureBackfillResult';

package/src/mdm/dtos/DeviceStatusResponse.ts

@@ -12,5 +12,9 @@ export class DeviceStatusResponse {
     lastSeenAt?: string;
     lastTransition?: string;
     enrolledAt?: string;
+    /** Corte que el proveedor tiene armado (ISO-8601). `null`: el proveedor dice que no hay corte. */
+    lockScheduledFor?: string | null;
+    /** No se pudo leer el corte; el `error` del ítem sigue hablando sólo del estado del equipo. */
+    lockScheduleReadError?: MdmError;
     error?: MdmError;
 }