@fiado/type-kit 3.199.0 → 3.202.0

package/src/retailCustomer/dtos/RetailCustomer.ts

@@ -1,9 +1,20 @@
 import { Expose, Type } from 'class-transformer';
-import { IsBoolean, IsEnum, IsIn, IsOptional, IsString, Matches, ValidateNested } from 'class-validator';
+import {
+    IsBoolean,
+    IsEmail,
+    IsEnum,
+    IsIn,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Matches,
+    ValidateNested,
+} from 'class-validator';
 import { regexIso8601, regexIso8601Date } from '../../helpers/constans/regex';
 import { AddressBase } from '../../address/dtos/AddressBase';
 import { AccountStatusEnum } from '../enums/AccountStatusEnum';
 import { KycModalityEnum } from '../enums/KycModalityEnum';
+import { RetailCustomerStatusEnum } from '../enums/RetailCustomerStatusEnum';
 import { RetailKycStatusEnum } from '../enums/RetailKycStatusEnum';
 import { KycReview } from './KycReview';
 
@@ -22,17 +33,50 @@ export class RetailCustomer {
     @IsString()
     retailerId!: string;
 
+    /** Tienda de alta/origen del cliente — hash del GSI `retailerId-originStoreId-index` (F1 §3.5). */
     @Expose()
     @IsString()
-    name!: string;
+    originStoreId!: string;
+
+    /** Nombre(s) de pila. Nombre partido por convención Fiado (`PeopleName` del dominio identity), F1 §3.5. */
+    @Expose()
+    @IsString()
+    names!: string;
+
+    @Expose()
+    @IsString()
+    paternalLastName!: string;
+
+    /** Segundo apellido — nullable (F1 §3.5: "el 2º apellido nullable"). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    maternalLastName!: string | null;
 
     @Expose()
     @IsString()
     phone!: string;
 
+    /** Lo pone el OTP del paso 01 del wizard (F1 §3.5). Default false. */
     @Expose()
+    @IsBoolean()
+    phoneVerified!: boolean;
+
+    /** null hasta el KYC (F1 §3.5); al capturarse se crea el centinela `UNIQ#CURP#<curp>` en la misma TX. */
+    @Expose()
+    @IsOptional()
     @IsString()
-    curp!: string;
+    curp!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    rfc!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsEmail()
+    email!: string | null;
 
     /** Fecha de nacimiento (ISO 8601, admite fecha sola); se completa con el OCR del KYC. */
     @Expose()
@@ -112,6 +156,34 @@ export class RetailCustomer {
     @Type(() => KycReview)
     kycReview!: KycReview | null;
 
+    /** Score de confianza que devuelve Metamap con el resultado del KYC (F1 §3.5). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    kycScore!: number | null;
+
+    /** Referencia a la verificación en `kyc-verifications-business` (INT1, F1 §3.5). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    metamapVerificationId!: string | null;
+
+    /** Alerta PLD (regulatorio, F1 §3.5). Default false. */
+    @Expose()
+    @IsBoolean()
+    pldFlag!: boolean;
+
+    /** Notas operativas del BO (F1 §3.5). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    notes!: string | null;
+
+    /** Soft-delete (F1 §3.5). Default ACTIVE. */
+    @Expose()
+    @IsEnum(RetailCustomerStatusEnum)
+    status!: RetailCustomerStatusEnum;
+
     @Expose()
     @IsString()
     @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })

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

@@ -1,15 +1,29 @@
 import { Expose } from 'class-transformer';
-import { IsOptional, IsString, Matches } from 'class-validator';
+import { IsEmail, IsOptional, IsString, Matches } from 'class-validator';
 import { regexIso8601Date } from '../../../helpers/constans/regex';
 
 /**
  * Alta básica de un cliente retail (identidad comercial mínima; el KYC la enriquece después).
+ * Nombre partido por convención Fiado y CURP opcional — "null hasta KYC" (F1 §3.5).
  * SureKeep Fase 2 — pista Retail.
  */
 export class CreateCustomerRequest {
     @Expose()
     @IsString()
-    name!: string;
+    originStoreId!: string;
+
+    @Expose()
+    @IsString()
+    names!: string;
+
+    @Expose()
+    @IsString()
+    paternalLastName!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    maternalLastName?: string;
 
     @Expose()
     @IsString()
@@ -20,6 +34,16 @@ export class CreateCustomerRequest {
     @IsString()
     curp?: string;
 
+    @Expose()
+    @IsOptional()
+    @IsString()
+    rfc?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEmail()
+    email?: string;
+
     @Expose()
     @IsOptional()
     @IsString()

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

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsOptional, IsString, Matches } from 'class-validator';
+import { IsEmail, IsOptional, IsString, Matches } from 'class-validator';
 import { regexIso8601Date } from '../../../helpers/constans/regex';
 
 /**
@@ -10,7 +10,17 @@ export class UpdateCustomerRequest {
     @Expose()
     @IsOptional()
     @IsString()
-    name?: string;
+    names?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    paternalLastName?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    maternalLastName?: string;
 
     @Expose()
     @IsOptional()
@@ -22,6 +32,22 @@ export class UpdateCustomerRequest {
     @IsString()
     curp?: string;
 
+    @Expose()
+    @IsOptional()
+    @IsString()
+    rfc?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEmail()
+    email?: string;
+
+    /** Notas operativas del BO (F1 §3.5). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    notes?: string;
+
     @Expose()
     @IsOptional()
     @IsString()

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

@@ -1,5 +1,14 @@
 import { Expose, Transform, Type } from 'class-transformer';
-import { IsEnum, IsIn, IsOptional, IsString, Matches, ValidateNested } from 'class-validator';
+import {
+    IsEmail,
+    IsEnum,
+    IsIn,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Matches,
+    ValidateNested,
+} from 'class-validator';
 import { regexCurp, regexIso8601Date, regexPhoneMx } from '../../../helpers/constans/regex';
 import { AddressBase } from '../../../address/dtos/AddressBase';
 import { KycModalityEnum } from '../../enums/KycModalityEnum';
@@ -11,9 +20,25 @@ import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
  * SureKeep Fase 2 — pista Retail.
  */
 export class UpsertCustomerFromKycRequest {
+    /** Tienda de alta/origen — del JWT del vendedor dueño de la sesión del wizard (F1 §3.5). */
     @Expose()
     @IsString()
-    name!: string;
+    originStoreId!: string;
+
+    /** Nombre partido por convención Fiado (F1 §3.5) — lo entrega el OCR del INE, NO se deriva de un string. */
+    @Expose()
+    @IsString()
+    names!: string;
+
+    @Expose()
+    @IsString()
+    paternalLastName!: string;
+
+    /** Segundo apellido — opcional (F1 §3.5: "el 2º apellido nullable"). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    maternalLastName?: string;
 
     // Normalización en el boundary: se strippean espacios/guiones para que centinela de unicidad,
     // lookup y search del BO (que también strippea) usen el MISMO formato de teléfono.
@@ -37,6 +62,28 @@ export class UpsertCustomerFromKycRequest {
     @Matches(regexIso8601Date, { message: 'birthDate debe ser una fecha ISO 8601' })
     birthDate?: string;
 
+    @Expose()
+    @IsOptional()
+    @IsString()
+    rfc?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEmail()
+    email?: string;
+
+    /** Score de confianza que devuelve Metamap junto con el resultado del KYC (F1 §3.5). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    kycScore?: number;
+
+    /** Referencia a la verificación en `kyc-verifications-business` (INT1, F1 §3.5). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    metamapVerificationId?: string;
+
     @Expose()
     @IsString()
     fiadoDirectoryId!: string;

package/src/retailCustomer/dtos/responses/CustomerResponse.ts

@@ -1,6 +1,7 @@
 import { AddressBase } from '../../../address/dtos/AddressBase';
 import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
 import { KycModalityEnum } from '../../enums/KycModalityEnum';
+import { RetailCustomerStatusEnum } from '../../enums/RetailCustomerStatusEnum';
 import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
 
 /**
@@ -10,9 +11,15 @@ import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
 export interface CustomerResponse {
     retailCustomerId: string;
     retailerId: string;
-    name: string;
+    originStoreId: string;
+    names: string;
+    paternalLastName: string;
+    maternalLastName: string | null;
     phone: string;
-    curp: string;
+    phoneVerified: boolean;
+    curp: string | null;
+    rfc: string | null;
+    email: string | null;
     birthDate: string | null;
     fiadoDirectoryId: string | null;
     fiadoPeopleId: string | null;
@@ -26,6 +33,11 @@ export interface CustomerResponse {
     addressConfirmed: boolean;
     kycStatus: RetailKycStatusEnum;
     kycModality: KycModalityEnum | null;
+    kycScore: number | null;
+    metamapVerificationId: string | null;
+    pldFlag: boolean;
+    notes: string | null;
+    status: RetailCustomerStatusEnum;
     createdAt: string;
     updatedAt: string;
 }

package/src/retailCustomer/enums/RetailCustomerStatusEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de vigencia del cliente retail — soft-delete de la convención F1 (modelo-datos F1 §1-§2:
+ * "soft-delete" es obligatorio en todas las entidades del silo). ACTIVE es el default del alta;
+ * INACTIVE marca la baja lógica (nunca se borra el ítem, para trazabilidad regulatoria).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum RetailCustomerStatusEnum {
+    ACTIVE = 'ACTIVE',
+    INACTIVE = 'INACTIVE',
+}

package/src/retailCustomer/index.ts

@@ -3,6 +3,7 @@ export * from './enums/AccountStatusEnum';
 export * from './enums/RetailKycStatusEnum';
 export * from './enums/KycModalityEnum';
 export * from './enums/KycReviewResultEnum';
+export * from './enums/RetailCustomerStatusEnum';
 
 // Entidades (planas, con class-validator + @Expose)
 export * from './dtos/KycReview';

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

@@ -1,11 +0,0 @@
-/**
- * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
- * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
- * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
- */
-export declare class UpdateActivationChecklistRequest {
-    downPayment?: boolean;
-    contractSigned?: boolean;
-    imeiEnrolled?: boolean;
-    lockVerified?: boolean;
-}

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

@@ -1,11 +0,0 @@
-/**
- * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
- * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
- * un CLIENTE nunca es `ALL`.
- * @enum {string}
- */
-export declare enum ClientLevelEnum {
-    BRONZE = "BRONZE",
-    SILVER = "SILVER",
-    GOLD = "GOLD"
-}

package/bin/loanCredit/enums/ClientLevelEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClientLevelEnum = void 0;
-/**
- * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
- * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
- * un CLIENTE nunca es `ALL`.
- * @enum {string}
- */
-var ClientLevelEnum;
-(function (ClientLevelEnum) {
-    ClientLevelEnum["BRONZE"] = "BRONZE";
-    ClientLevelEnum["SILVER"] = "SILVER";
-    ClientLevelEnum["GOLD"] = "GOLD";
-})(ClientLevelEnum || (exports.ClientLevelEnum = ClientLevelEnum = {}));