@fiado/type-kit 3.488.0 → 3.489.0

package/_test_/unit/retailCustomer/upsertCustomerFromKycRequest.test.ts

@@ -0,0 +1,51 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { UpsertCustomerFromKycRequest } from '../../../src/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest';
+import { KycMethodEnum } from '../../../src/retailCustomer/enums/KycMethodEnum';
+import { KycModalityEnum } from '../../../src/retailCustomer/enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../../../src/retailCustomer/enums/RetailKycStatusEnum';
+
+/** Valida como lo hace `retail-customer-business`: con `@Expose` y `excludeExtraneousValues`. */
+function toDto(payload: Record<string, unknown>): UpsertCustomerFromKycRequest {
+    return plainToInstance(UpsertCustomerFromKycRequest, payload, { excludeExtraneousValues: true });
+}
+
+const base = {
+    originStoreId: 'store-1',
+    names: 'Ana',
+    paternalLastName: 'Pérez',
+    phone: '5512345678',
+    curp: 'PEGA900101MDFRRN09',
+    fiadoDirectoryId: 'dir-1',
+    fiadoPeopleId: 'people-1',
+    kycStatus: Object.values(RetailKycStatusEnum)[0],
+    kycModality: KycModalityEnum.STORE_DEVICE,
+};
+
+describe('UpsertCustomerFromKycRequest — método de KYC', () => {
+    it('KycMethodEnum expone FULL_KYC y FACEMATCH', () => {
+        expect(Object.values(KycMethodEnum)).toEqual(['FULL_KYC', 'FACEMATCH']);
+    });
+
+    it('acepta el payload sin kycMethod ni biometricVerificationId', () => {
+        expect(validateSync(toDto(base)).map((e) => e.property)).toEqual([]);
+    });
+
+    it('conserva kycMethod y biometricVerificationId del alta por facematch', () => {
+        const dto = toDto({ ...base, kycMethod: KycMethodEnum.FACEMATCH, biometricVerificationId: 'bv-1' });
+        expect(validateSync(dto)).toEqual([]);
+        expect(dto.kycMethod).toBe(KycMethodEnum.FACEMATCH);
+        expect(dto.biometricVerificationId).toBe('bv-1');
+    });
+
+    it('rechaza un kycMethod fuera del catálogo', () => {
+        expect(validateSync(toDto({ ...base, kycMethod: 'SELFIE' })).map((e) => e.property)).toEqual(['kycMethod']);
+    });
+
+    it('rechaza un biometricVerificationId que no es string', () => {
+        expect(validateSync(toDto({ ...base, biometricVerificationId: 42 })).map((e) => e.property)).toEqual([
+            'biometricVerificationId',
+        ]);
+    });
+});

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.d.ts

@@ -1,4 +1,5 @@
 import { RetailAddress } from '../RetailAddress';
+import { KycMethodEnum } from '../../enums/KycMethodEnum';
 import { KycModalityEnum } from '../../enums/KycModalityEnum';
 import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
 /**
@@ -47,6 +48,10 @@ export declare class UpsertCustomerFromKycRequest {
     hasActiveMxAccount?: boolean;
     kycStatus: RetailKycStatusEnum;
     kycModality: KycModalityEnum;
+    /** Método con el que se verificó la identidad. Ausente = no pisa el valor guardado. */
+    kycMethod?: KycMethodEnum;
+    /** Verificación biométrica de `biometrics-business` que respaldó el alta por facematch. */
+    biometricVerificationId?: string;
     /**
      * Domicilio del INE (paso 02e), ya normalizado contra `places-business`. Se persiste embebido en la
      * MISMA TX del upsert.

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../../helpers/constans/regex");
 const RetailAddress_1 = require("../RetailAddress");
+const KycMethodEnum_1 = require("../../enums/KycMethodEnum");
 const KycModalityEnum_1 = require("../../enums/KycModalityEnum");
 const RetailKycStatusEnum_1 = require("../../enums/RetailKycStatusEnum");
 /**
@@ -141,6 +142,18 @@ __decorate([
     (0, class_validator_1.IsEnum)(KycModalityEnum_1.KycModalityEnum),
     __metadata("design:type", String)
 ], UpsertCustomerFromKycRequest.prototype, "kycModality", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(KycMethodEnum_1.KycMethodEnum),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "kycMethod", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "biometricVerificationId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailCustomer/enums/KycMethodEnum.d.ts

@@ -0,0 +1,5 @@
+/** Cómo se verificó la identidad del cliente: KYC completo o solo selfie contra la cuenta existente. */
+export declare enum KycMethodEnum {
+    FULL_KYC = "FULL_KYC",
+    FACEMATCH = "FACEMATCH"
+}

package/bin/retailCustomer/enums/KycMethodEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycMethodEnum = void 0;
+/** Cómo se verificó la identidad del cliente: KYC completo o solo selfie contra la cuenta existente. */
+var KycMethodEnum;
+(function (KycMethodEnum) {
+    KycMethodEnum["FULL_KYC"] = "FULL_KYC";
+    KycMethodEnum["FACEMATCH"] = "FACEMATCH";
+})(KycMethodEnum || (exports.KycMethodEnum = KycMethodEnum = {}));

package/bin/retailCustomer/index.d.ts

@@ -1,6 +1,7 @@
 export * from './enums/AccountStatusEnum';
 export * from './enums/RetailKycStatusEnum';
 export * from './enums/KycModalityEnum';
+export * from './enums/KycMethodEnum';
 export * from './enums/KycReviewResultEnum';
 export * from './enums/RetailCustomerStatusEnum';
 export * from './enums/WelcomeBonusStatusEnum';

package/bin/retailCustomer/index.js

@@ -18,6 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums/AccountStatusEnum"), exports);
 __exportStar(require("./enums/RetailKycStatusEnum"), exports);
 __exportStar(require("./enums/KycModalityEnum"), exports);
+__exportStar(require("./enums/KycMethodEnum"), exports);
 __exportStar(require("./enums/KycReviewResultEnum"), exports);
 __exportStar(require("./enums/RetailCustomerStatusEnum"), exports);
 __exportStar(require("./enums/WelcomeBonusStatusEnum"), exports);

package/package.json

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

package/src/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.ts

@@ -12,6 +12,7 @@ import {
 } from 'class-validator';
 import { regexCurp, regexIso8601Date, regexPhoneMx } from '../../../helpers/constans/regex';
 import { RetailAddress } from '../RetailAddress';
+import { KycMethodEnum } from '../../enums/KycMethodEnum';
 import { KycModalityEnum } from '../../enums/KycModalityEnum';
 import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
 
@@ -140,6 +141,18 @@ export class UpsertCustomerFromKycRequest {
     @IsEnum(KycModalityEnum)
     kycModality!: KycModalityEnum;
 
+    /** Método con el que se verificó la identidad. Ausente = no pisa el valor guardado. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(KycMethodEnum)
+    kycMethod?: KycMethodEnum;
+
+    /** Verificación biométrica de `biometrics-business` que respaldó el alta por facematch. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    biometricVerificationId?: string;
+
     /**
      * Domicilio del INE (paso 02e), ya normalizado contra `places-business`. Se persiste embebido en la
      * MISMA TX del upsert.

package/src/retailCustomer/enums/KycMethodEnum.ts

@@ -0,0 +1,5 @@
+/** Cómo se verificó la identidad del cliente: KYC completo o solo selfie contra la cuenta existente. */
+export enum KycMethodEnum {
+    FULL_KYC = 'FULL_KYC',
+    FACEMATCH = 'FACEMATCH',
+}

package/src/retailCustomer/index.ts

@@ -2,6 +2,7 @@
 export * from './enums/AccountStatusEnum';
 export * from './enums/RetailKycStatusEnum';
 export * from './enums/KycModalityEnum';
+export * from './enums/KycMethodEnum';
 export * from './enums/KycReviewResultEnum';
 export * from './enums/RetailCustomerStatusEnum';
 export * from './enums/WelcomeBonusStatusEnum';