@fiado/type-kit 3.328.0 → 3.331.0

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.ClientLevelEnum = void 0;
+exports.MdmLockModeEnum = exports.DeviceLockScreenMessage = exports.MdmError = 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);
@@ -45,3 +45,47 @@ __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/SignLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/ActivationCheckResponse"), exports);
+// Device / MDM — contrato hacia los callers de loan-credit
+__exportStar(require("./enums/LoanDeviceMdmStatusEnum"), exports);
+__exportStar(require("./enums/LoanDeviceLockReasonEnum"), exports);
+// Re-export de los tipos canónicos del dominio `mdm` que este contrato reusa (un solo origen de verdad).
+var MdmOperationStatusEnum_1 = require("../mdm/enums/MdmOperationStatusEnum");
+Object.defineProperty(exports, "MdmOperationStatusEnum", { enumerable: true, get: function () { return MdmOperationStatusEnum_1.MdmOperationStatusEnum; } });
+var MdmDeviceStatusEnum_1 = require("../mdm/enums/MdmDeviceStatusEnum");
+Object.defineProperty(exports, "MdmDeviceStatusEnum", { enumerable: true, get: function () { return MdmDeviceStatusEnum_1.MdmDeviceStatusEnum; } });
+var MdmOperationTypeEnum_1 = require("../mdm/enums/MdmOperationTypeEnum");
+Object.defineProperty(exports, "MdmOperationTypeEnum", { enumerable: true, get: function () { return MdmOperationTypeEnum_1.MdmOperationTypeEnum; } });
+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 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");
+Object.defineProperty(exports, "DeviceLockScreenMessage", { enumerable: true, get: function () { return DeviceLockScreenMessage_1.DeviceLockScreenMessage; } });
+var MdmLockModeEnum_1 = require("../retailCatalog/enums/MdmLockModeEnum");
+Object.defineProperty(exports, "MdmLockModeEnum", { enumerable: true, get: function () { return MdmLockModeEnum_1.MdmLockModeEnum; } });
+__exportStar(require("./constants/LoanDeviceBatchLimits"), exports);
+__exportStar(require("./dtos/LoanDeviceResult"), exports);
+__exportStar(require("./dtos/LoanDeviceOperationResult"), exports);
+__exportStar(require("./dtos/LoanDeviceCreditRefItem"), exports);
+__exportStar(require("./dtos/LoanDeviceEnrollItem"), exports);
+__exportStar(require("./dtos/LoanDeviceManualLockItem"), 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/responses/LoanDeviceEnrollResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceEnrollResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceEnrollStatusResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceEnrollStatusResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceStatusResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceStatusResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceLastSeenResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceLastSeenResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceLockResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceManualLockResponse"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceUnlockResult"), exports);
+__exportStar(require("./dtos/responses/LoanDeviceManualUnlockResponse"), exports);

package/bin/places/dtos/GetNearbyPlacesRequest.d.ts

@@ -7,4 +7,17 @@ export declare class GetNearbyPlacesRequest {
     latitude: number;
     longitude: number;
     types: PlaceTypeEnum[];
+    /**
+     * Radio de búsqueda en km.
+     *
+     * Sólo aplica a los tipos que consultan un directorio EN VIVO del proveedor; los que
+     * se sirven de la cache geoespacial lo ignoran, porque su área la fija la resolución
+     * de las celdas y no un radio del request.
+     *
+     * Omitido = el default de quien atiende la búsqueda. No lleva `@Max` acá a propósito:
+     * el tope sano depende del proveedor (un directorio que no pagina devuelve miles de
+     * tiendas en una sola respuesta), así que lo aplica el lambda que lo consume y no este
+     * contrato, que es compartido.
+     */
+    radius?: number;
 }

package/bin/places/dtos/GetNearbyPlacesRequest.js

@@ -37,3 +37,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(PlaceTypeEnum_1.PlaceTypeEnum, { each: true }),
     __metadata("design:type", Array)
 ], GetNearbyPlacesRequest.prototype, "types", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], GetNearbyPlacesRequest.prototype, "radius", void 0);

package/bin/places/dtos/GetNearbyPlacesResponse.d.ts

@@ -1,11 +1,25 @@
 import { EstablishmentDto } from './EstablishmentDto';
 import { OfficeDto } from '../../offices/dtos/OfficeDto';
+import { FundingStoreItem } from '../../walletFunding/dtos/FundingStoreItem';
 /**
  * Respuesta de la búsqueda unificada. Solo se incluyen los tipos pedidos en `types`.
  */
 export declare class GetNearbyPlacesResponse {
     cashInUs?: EstablishmentDto[];
     cashInMx?: EstablishmentDto[];
+    /**
+     * Cash-in MX servido por el directorio EN VIVO del proveedor de fondeo, en vez de
+     * por la cache geoespacial que alimenta `cashInMx`.
+     *
+     * Campo aparte a propósito, por dos razones. `FundingStoreItem` trae lo que
+     * `EstablishmentDto` no tiene y la app necesita pintar en el pin —comisión de caja,
+     * tope por operación, horario, logo—; y es el MISMO tipo que ya comparten el connector
+     * y el wallet-app, así que reusarlo evita una tercera declaración del mismo concepto.
+     *
+     * Cuál de los dos campos se llena lo decide la configuración de ruteo del lambda:
+     * viene uno u otro, nunca los dos.
+     */
+    cashInMxStores?: FundingStoreItem[];
     officeFiado?: OfficeDto[];
     storeFiado?: OfficeDto[];
 }

package/bin/retailWizard/enums/BlockedCategoryEnum.d.ts

@@ -11,5 +11,10 @@ export declare enum BlockedCategoryEnum {
      */
     UNDER_REVIEW = "UNDER_REVIEW",
     /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
-    TEMPORARY = "TEMPORARY"
+    TEMPORARY = "TEMPORARY",
+    /**
+     * Quien revisaba el caso ya resolvió que la cuenta no se abre. Es terminal: nadie la va a
+     * destrabar y la venta no continúa. Tampoco dice por qué.
+     */
+    REJECTED = "REJECTED"
 }

package/bin/retailWizard/enums/BlockedCategoryEnum.js

@@ -16,4 +16,9 @@ var BlockedCategoryEnum;
     BlockedCategoryEnum["UNDER_REVIEW"] = "UNDER_REVIEW";
     /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
     BlockedCategoryEnum["TEMPORARY"] = "TEMPORARY";
+    /**
+     * Quien revisaba el caso ya resolvió que la cuenta no se abre. Es terminal: nadie la va a
+     * destrabar y la venta no continúa. Tampoco dice por qué.
+     */
+    BlockedCategoryEnum["REJECTED"] = "REJECTED";
 })(BlockedCategoryEnum || (exports.BlockedCategoryEnum = BlockedCategoryEnum = {}));

package/bin/retailWizard/enums/PendingReasonEnum.d.ts

@@ -1,7 +1,7 @@
 /**
  * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
  *
- * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los tres últimos los pone
  * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
@@ -27,7 +27,9 @@ export declare enum PendingReasonEnum {
      */
     ACCOUNT_UNDER_REVIEW = "ACCOUNT_UNDER_REVIEW",
     /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
-    ACCOUNT_OPEN_FAILED = "ACCOUNT_OPEN_FAILED"
+    ACCOUNT_OPEN_FAILED = "ACCOUNT_OPEN_FAILED",
+    /** La revisión terminó y la cuenta no se abre. La venta no continúa. */
+    ACCOUNT_REJECTED = "ACCOUNT_REJECTED"
 }
 /** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
 export declare const SYSTEM_PENDING_REASONS: readonly PendingReasonEnum[];

package/bin/retailWizard/enums/PendingReasonEnum.js

@@ -4,7 +4,7 @@ exports.SYSTEM_PENDING_REASONS = exports.PendingReasonEnum = void 0;
 /**
  * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
  *
- * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los tres últimos los pone
  * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
@@ -32,9 +32,12 @@ var PendingReasonEnum;
     PendingReasonEnum["ACCOUNT_UNDER_REVIEW"] = "ACCOUNT_UNDER_REVIEW";
     /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
     PendingReasonEnum["ACCOUNT_OPEN_FAILED"] = "ACCOUNT_OPEN_FAILED";
+    /** La revisión terminó y la cuenta no se abre. La venta no continúa. */
+    PendingReasonEnum["ACCOUNT_REJECTED"] = "ACCOUNT_REJECTED";
 })(PendingReasonEnum || (exports.PendingReasonEnum = PendingReasonEnum = {}));
 /** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
 exports.SYSTEM_PENDING_REASONS = [
     PendingReasonEnum.ACCOUNT_UNDER_REVIEW,
     PendingReasonEnum.ACCOUNT_OPEN_FAILED,
+    PendingReasonEnum.ACCOUNT_REJECTED,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.328.0",
+  "version": "3.331.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",
@@ -28,4 +28,4 @@
     "class-validator": "^0.14.2",
     "reflect-metadata": "^0.2.2"
   }
-}
+}

package/src/identity/dtos/ManualApproval.ts

@@ -13,4 +13,14 @@ export interface ManualApproval {
     at: string;
     /** justificación obligatoria del override */
     reason: string;
+    /**
+     * Conclusión del oficial. Ausente en los sellos escritos antes de este campo, que solo se
+     * estampaban al aprobar: leerlos sin `verdict` equivale a `APPROVED`.
+     */
+    verdict?: ManualApprovalVerdict;
+    /** Alerta de PLD que se dictaminó, para rastrear el sello hasta su expediente. */
+    alertId?: string;
 }
+
+/** Conclusión del oficial de cumplimiento sobre la lista que revisó. */
+export type ManualApprovalVerdict = 'APPROVED' | 'REJECTED';

package/src/identity/dtos/PeopleResponse.ts

@@ -137,6 +137,10 @@ export class PeopleResponse {
         /** Geolocalización aprobada. `null` = no evaluada; solo `false` bloquea. */
         geoApproved?:boolean | null;
         cnbvManualApproval?: ManualApproval | null;
+        /** Sello del oficial sobre las listas internacionales y PEP (`blackListApproved`). */
+        blackListManualApproval?: ManualApproval | null;
+        /** Sello del oficial sobre la lista negra interna de Fiado (`fiadoListApproved`). */
+        fiadoListManualApproval?: ManualApproval | null;
         minorManualApproval?: ManualApproval | null;
 
     }

package/src/identity/dtos/PeopleUpdateRequest.ts

@@ -60,6 +60,8 @@ export class PeopleUpdateRequest {
     ofacListApproved?: boolean | null;
     cnbvListApproved?: boolean | null;
     cnbvManualApproval?: ManualApproval | null;
+    blackListManualApproval?: ManualApproval | null;
+    fiadoListManualApproval?: ManualApproval | null;
     minorManualApproval?: ManualApproval | null;
     blackListApproved?: boolean | null;
     whiteList?: boolean | null;

package/src/loanCredit/constants/LoanDeviceBatchLimits.ts

@@ -0,0 +1,2 @@
+/** Cota de ítems por request; es el tamaño de lote del fan-out SQS de cobranza. */
+export const LOAN_DEVICE_MAX_BATCH = 500;

package/src/loanCredit/dtos/LoanDeviceCreditRefItem.ts

@@ -0,0 +1,9 @@
+import { Expose } from 'class-transformer';
+import { IsUUID } from 'class-validator';
+
+/** Ítem que solo referencia un crédito, para las mutaciones que no necesitan más datos. */
+export class LoanDeviceCreditRefItem {
+    @Expose()
+    @IsUUID()
+    creditId: string;
+}

package/src/loanCredit/dtos/LoanDeviceEnrollItem.ts

@@ -0,0 +1,47 @@
+import { Expose } from 'class-transformer';
+import { IsISO8601, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString, IsUUID, Matches, Max, MaxLength } from 'class-validator';
+import { SKU_PATTERN } from '../../retailCatalog/constants/SkuPattern';
+
+/** Charset y largo del IMEI: exactamente 15 dígitos. */
+const IMEI_PATTERN = /^\d{15}$/;
+
+/** Plazo máximo del crédito en meses. */
+const MAX_TERM_MONTHS = 60;
+
+/** Ítem de enrolamiento: un crédito con el equipo que se va a enrolar en el MDM. */
+export class LoanDeviceEnrollItem {
+    @Expose()
+    @IsUUID()
+    creditId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(IMEI_PATTERN, { message: 'imei admite solo 15 dígitos' })
+    imei: string;
+
+    /** Segundo IMEI del equipo (dual SIM), si lo tiene. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(IMEI_PATTERN, { message: 'imei2 admite solo 15 dígitos' })
+    imei2?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    @Matches(SKU_PATTERN, { message: 'productSku admite solo [A-Za-z0-9-]' })
+    productSku: string;
+
+    @Expose()
+    @IsInt()
+    @IsPositive()
+    @Max(MAX_TERM_MONTHS)
+    termMonths: number;
+
+    /** En modo SCHEDULED es el primer autolock. */
+    @Expose()
+    @IsISO8601()
+    firstDueDate: string;
+}

package/src/loanCredit/dtos/LoanDeviceManualLockItem.ts

@@ -0,0 +1,22 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsOptional, IsUUID, ValidateNested } from 'class-validator';
+import { LoanDeviceLockReasonEnum } from '../enums/LoanDeviceLockReasonEnum';
+import { DeviceLockScreenMessage } from '../../mdm/dtos/DeviceLockScreenMessage';
+
+/** Ítem de bloqueo manual: qué crédito se bloquea, por qué y con qué mensaje en pantalla. */
+export class LoanDeviceManualLockItem {
+    @Expose()
+    @IsUUID()
+    creditId: string;
+
+    @Expose()
+    @IsEnum(LoanDeviceLockReasonEnum)
+    reason: LoanDeviceLockReasonEnum;
+
+    /** Mensaje que ve el usuario en la pantalla bloqueada; si no viene, el lambda usa el default. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => DeviceLockScreenMessage)
+    screenMessage?: DeviceLockScreenMessage;
+}

package/src/loanCredit/dtos/LoanDeviceOperationResult.ts

@@ -0,0 +1,11 @@
+import { LoanDeviceResult } from './LoanDeviceResult';
+
+/** Resultado por ítem de las mutaciones (enroll, lock, unlock), que sí llevan referencia de operación. */
+export class LoanDeviceOperationResult extends LoanDeviceResult {
+    /** Referencia de la operación con la que el caller correlaciona el batch. */
+    operationReference: string;
+
+    /** Referencia opaca del proveedor, solo para trazabilidad de soporte.
+     *  El avance se consulta por `creditId` en `enroll-status` (enroll) o `status` (lock/unlock). */
+    pollingHandle?: string;
+}

package/src/loanCredit/dtos/LoanDeviceResult.ts

@@ -0,0 +1,12 @@
+import { MdmOperationStatusEnum } from '../../mdm/enums/MdmOperationStatusEnum';
+import { MdmError } from '../../mdm/dtos/MdmError';
+
+/** Base de todo resultado por ítem: un ítem puede fallar sin tumbar el batch completo. */
+export class LoanDeviceResult {
+    creditId: string;
+
+    /** Solo toma SUCCESS | PENDING | ERROR; el motivo del fallo viaja en `error.code`. */
+    status: MdmOperationStatusEnum;
+
+    error?: MdmError;
+}

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

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsString, Length, ValidateNested } from 'class-validator';
+import { LoanDeviceEnrollItem } from '../LoanDeviceEnrollItem';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/enroll` (loan-credit-business). Enrola en lote. */
+export class LoanDeviceEnrollRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique((item: LoanDeviceEnrollItem) => item.creditId)
+    @ValidateNested({ each: true })
+    @Type(() => LoanDeviceEnrollItem)
+    items: LoanDeviceEnrollItem[];
+
+    /** 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/LoanDeviceEnrollStatusRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsUUID } from 'class-validator';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/enroll-status` (loan-credit-business). Consulta en lote. */
+export class LoanDeviceEnrollStatusRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique()
+    @IsUUID(undefined, { each: true })
+    creditIds: string[];
+}

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

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsUUID } from 'class-validator';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/last-seen` (loan-credit-business). Consulta en lote. */
+export class LoanDeviceLastSeenRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique()
+    @IsUUID(undefined, { each: true })
+    creditIds: string[];
+}

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

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsString, Length, ValidateNested } from 'class-validator';
+import { LoanDeviceManualLockItem } from '../LoanDeviceManualLockItem';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/manual-lock` (loan-credit-business). Bloquea en lote. */
+export class LoanDeviceManualLockRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique((item: LoanDeviceManualLockItem) => item.creditId)
+    @ValidateNested({ each: true })
+    @Type(() => LoanDeviceManualLockItem)
+    items: LoanDeviceManualLockItem[];
+
+    /** 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/LoanDeviceManualUnlockRequest.ts

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsNotEmpty, IsString, Length, ValidateNested } from 'class-validator';
+import { LoanDeviceCreditRefItem } from '../LoanDeviceCreditRefItem';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/manual-unlock` (loan-credit-business). Desbloquea en lote. */
+export class LoanDeviceManualUnlockRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique((item: LoanDeviceCreditRefItem) => item.creditId)
+    @ValidateNested({ each: true })
+    @Type(() => LoanDeviceCreditRefItem)
+    items: LoanDeviceCreditRefItem[];
+
+    /** 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/LoanDeviceStatusRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsUUID } from 'class-validator';
+import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+
+/** Body de `POST /private/devices/status` (loan-credit-business). Consulta en lote. */
+export class LoanDeviceStatusRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
+    @ArrayUnique()
+    @IsUUID(undefined, { each: true })
+    creditIds: string[];
+}

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

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

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

@@ -0,0 +1,8 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+
+/** Resultado por crédito del enrolamiento en lote. */
+export class LoanDeviceEnrollResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar el enroll. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+}

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

@@ -0,0 +1,6 @@
+import { LoanDeviceEnrollStatusResult } from './LoanDeviceEnrollStatusResult';
+
+/** Response de `POST /private/devices/enroll-status`. Un resultado por crédito consultado. */
+export class LoanDeviceEnrollStatusResponse {
+    results: LoanDeviceEnrollStatusResult[];
+}

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

@@ -0,0 +1,21 @@
+import { LoanDeviceResult } from '../LoanDeviceResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+import { DeviceEnrollmentModeEnum } from '../../../mdm/enums/DeviceEnrollmentModeEnum';
+
+/** Resultado por crédito del avance del enrolamiento. */
+export class LoanDeviceEnrollStatusResult extends LoanDeviceResult {
+    /** Estado nuestro del expediente. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    /** Referencia de la operación de enroll que dejó el expediente en este estado. */
+    operationReference?: string;
+
+    /** Referencia opaca del proveedor, solo para trazabilidad de soporte.
+     *  El avance se consulta por `creditId` en este mismo endpoint. */
+    pollingHandle?: string;
+
+    enrolledAt?: string;
+
+    /** Modo con el que se resolvió el enroll (por API o esperando al dispositivo). */
+    enrollmentMode?: DeviceEnrollmentModeEnum;
+}

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

@@ -0,0 +1,6 @@
+import { LoanDeviceLastSeenResult } from './LoanDeviceLastSeenResult';
+
+/** Response de `POST /private/devices/last-seen`. Un resultado por crédito consultado. */
+export class LoanDeviceLastSeenResponse {
+    results: LoanDeviceLastSeenResult[];
+}

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

@@ -0,0 +1,6 @@
+import { LoanDeviceResult } from '../LoanDeviceResult';
+
+/** Resultado por crédito de la última vez que se vio el dispositivo. */
+export class LoanDeviceLastSeenResult extends LoanDeviceResult {
+    lastSeenAt?: string;
+}

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

@@ -0,0 +1,10 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+
+/** Resultado por crédito del bloqueo manual en lote. */
+export class LoanDeviceLockResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar el bloqueo. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    lockedAt?: string;
+}

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

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

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

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

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

@@ -0,0 +1,6 @@
+import { LoanDeviceStatusResult } from './LoanDeviceStatusResult';
+
+/** Response de `POST /private/devices/status`. Un resultado por crédito consultado. */
+export class LoanDeviceStatusResponse {
+    results: LoanDeviceStatusResult[];
+}

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

@@ -0,0 +1,39 @@
+import { LoanDeviceResult } from '../LoanDeviceResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+import { LoanDeviceLockReasonEnum } from '../../enums/LoanDeviceLockReasonEnum';
+import { MdmDeviceStatusEnum } from '../../../mdm/enums/MdmDeviceStatusEnum';
+import { MdmOperationTypeEnum } from '../../../mdm/enums/MdmOperationTypeEnum';
+import { MdmProviderEnum } from '../../../mdm/enums/MdmProviderEnum';
+import { MdmLockModeEnum } from '../../../retailCatalog/enums/MdmLockModeEnum';
+
+/** Resultado por crédito del estado del dispositivo. */
+export class LoanDeviceStatusResult extends LoanDeviceResult {
+    /** Estado nuestro del expediente; es el autoritativo. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    /** Observación del proveedor, solo informativa: el autoritativo es `mdmStatus`. */
+    providerStatus?: MdmDeviceStatusEnum;
+
+    /** Proveedor con el que se enroló; queda congelado al enrolar. */
+    mdmProvider?: MdmProviderEnum;
+
+    /** Modo de bloqueo con el que se enroló; queda congelado al enrolar. */
+    mdmLockMode?: MdmLockModeEnum;
+
+    imei?: string;
+
+    /** Motivo del bloqueo vigente; es lo que decide si el backoffice desbloquea. */
+    lockReason?: LoanDeviceLockReasonEnum;
+
+    lockedAt?: string;
+
+    /** ISO-8601 del próximo autolock programado; solo aplica en modo SCHEDULED. */
+    currentLockScheduledFor?: string;
+
+    lastSeenAt?: string;
+
+    /** Operación a la que corresponde `lastOperationAt`. */
+    lastOperationType?: MdmOperationTypeEnum;
+
+    lastOperationAt?: string;
+}

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

@@ -0,0 +1,10 @@
+import { LoanDeviceOperationResult } from '../LoanDeviceOperationResult';
+import { LoanDeviceMdmStatusEnum } from '../../enums/LoanDeviceMdmStatusEnum';
+
+/** Resultado por crédito del desbloqueo manual en lote. */
+export class LoanDeviceUnlockResult extends LoanDeviceOperationResult {
+    /** Estado nuestro del expediente después de intentar el desbloqueo. */
+    mdmStatus: LoanDeviceMdmStatusEnum;
+
+    unlockedAt?: string;
+}

package/src/loanCredit/enums/LoanDeviceLockReasonEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Motivo por el que se bloquea manualmente el dispositivo de un crédito.
+ * @enum {string}
+ */
+export enum LoanDeviceLockReasonEnum {
+    /** Cuota vencida (T+1). */
+    OVERDUE_T_PLUS_1 = 'OVERDUE_T_PLUS_1',
+    /** Sospecha o confirmación de fraude. */
+    FRAUD = 'FRAUD',
+    /** Bloqueo manual disparado por un administrador. */
+    ADMIN_MANUAL = 'ADMIN_MANUAL',
+}