@fiado/type-kit 3.198.0 → 3.200.0

package/bin/retailCustomer/dtos/responses/CustomerResponse.d.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';
 /**
  * Vista de un cliente retail hacia el consumidor (BO / api-invoker). SureKeep Fase 2 — pista Retail.
@@ -9,9 +10,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;
@@ -25,6 +32,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/bin/retailCustomer/enums/RetailCustomerStatusEnum.d.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 declare enum RetailCustomerStatusEnum {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE"
+}

package/bin/retailCustomer/enums/RetailCustomerStatusEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailCustomerStatusEnum = void 0;
+/**
+ * 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.
+ */
+var RetailCustomerStatusEnum;
+(function (RetailCustomerStatusEnum) {
+    RetailCustomerStatusEnum["ACTIVE"] = "ACTIVE";
+    RetailCustomerStatusEnum["INACTIVE"] = "INACTIVE";
+})(RetailCustomerStatusEnum || (exports.RetailCustomerStatusEnum = RetailCustomerStatusEnum = {}));

package/bin/retailCustomer/index.d.ts

@@ -2,6 +2,7 @@ export * from './enums/AccountStatusEnum';
 export * from './enums/RetailKycStatusEnum';
 export * from './enums/KycModalityEnum';
 export * from './enums/KycReviewResultEnum';
+export * from './enums/RetailCustomerStatusEnum';
 export * from './dtos/KycReview';
 export * from './dtos/RetailCustomer';
 export * from './dtos/requests/CreateCustomerRequest';

package/bin/retailCustomer/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./enums/AccountStatusEnum"), exports);
 __exportStar(require("./enums/RetailKycStatusEnum"), exports);
 __exportStar(require("./enums/KycModalityEnum"), exports);
 __exportStar(require("./enums/KycReviewResultEnum"), exports);
+__exportStar(require("./enums/RetailCustomerStatusEnum"), exports);
 // Entidades (planas, con class-validator + @Expose)
 __exportStar(require("./dtos/KycReview"), exports);
 __exportStar(require("./dtos/RetailCustomer"), exports);

package/package.json

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

package/src/loanCredit/dtos/LoanBorrower.ts

@@ -10,7 +10,7 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { regexIso8601 } from '../../helpers/constans/regex';
-import { ClientLevelEnum } from '../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
 import { LoanBeneficiary } from './LoanBeneficiary';
 
 /**

package/src/loanCredit/dtos/LoanContract.ts

@@ -0,0 +1,70 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { ContractTypeEnum } from '../enums/ContractTypeEnum';
+
+/**
+ * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
+ *
+ * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
+ * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
+ * `signedAt` ausente = draft sin firmar.
+ */
+export class LoanContract {
+    @Expose()
+    @IsString()
+    contractId!: string;
+
+    @Expose()
+    @IsString()
+    creditId!: string;
+
+    @Expose()
+    @IsEnum(ContractTypeEnum)
+    type!: ContractTypeEnum;
+
+    /** Key del PDF en el bucket del tenant (`loan-{tenant}-{env}`). Ausente hasta generar (AS-09). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    pdfS3Key?: string;
+
+    /** Hash SHA-256 del PDF firmado (trazabilidad FES — M2 §4.4). Ausente hasta generar. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    sha256?: string;
+
+    /** El OTP de firma fue verificado (voluntad de firma — FES). */
+    @Expose()
+    @IsBoolean()
+    otpVerified!: boolean;
+
+    /** Sello de tiempo NOM-151 (TSA). Ausente hasta firmar (AS del TSA connector). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    nom151Timestamp?: string;
+
+    @Expose()
+    @IsOptional()
+    @Matches(regexIso8601)
+    signedAt?: string;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @Matches(regexIso8601)
+    createdAt!: string;
+
+    @Expose()
+    @Matches(regexIso8601)
+    updatedAt!: string;
+}

package/src/loanCredit/dtos/LoanCredit.ts

@@ -11,7 +11,7 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { regexIso8601 } from '../../helpers/constans/regex';
-import { ClientLevelEnum } from '../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../enums/LoanCreditStatusEnum';
 import { ActivationChecklist } from './ActivationChecklist';
 
@@ -91,6 +91,19 @@ export class LoanCredit {
     @IsInt()
     totalToPayCents!: number;
 
+    /** CAT decimal (`3.85` = 385%) — lo calcula el simulador de loan-offerings (C3/AS-01). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    catAnnual?: number;
+
+    /** Sesión del wizard que originó — clave de idempotencia del originate (AS-07). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    wizardSessionId?: string;
+
     /** IMEI del equipo financiado (se fija en el enrolamiento MDM). */
     @Expose()
     @IsOptional()

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

@@ -0,0 +1,39 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Body de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5).
+ * Marca condiciones del checklist de activación cumplidas (solo las que cambian, solo a `true`):
+ * `downPayment` la reporta el wizard al confirmar el enganche (paso 07); `imeiEnrolled` +
+ * `lockVerified` las dispara el paso 09 variante crédito (enrolamiento MDM vía la abstracción de
+ * proveedor). `contractSigned` NO se marca por acá — solo la firma FES (endpoint sign).
+ *
+ * Cuando las 4 condiciones quedan `true` en el mismo request → el crédito pasa a `ACTIVE`:
+ * vencimientos `activatedAt + n×7d` (domingo→lunes), `voluntaryCancelDeadline = +7d`, flag de
+ * cobro PCF configurado (C7 — solo flag, el débito real requiere adendum).
+ */
+export class ActivationCheckRequest {
+    /** Enganche confirmado (efectivo/débito inmediato; SPEI espera confirmación — M2 §5). */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    downPayment?: boolean;
+
+    /** IMEI enrolado en MDM. Dispara el enroll vía `MdmConnectorRouter` si aún no se hizo. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    imeiEnrolled?: boolean;
+
+    /** Software de bloqueo verificado (el MDM reporta "activo"). */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    lockVerified?: boolean;
+
+    /** IMEI del equipo (paso 09) si no se fijó en el originate. Luhn-validado por el motor. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    imei?: string;
+}

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

@@ -3,23 +3,30 @@ import {
     IsEnum,
     IsInt,
     IsNotEmpty,
-    IsNumber,
     IsOptional,
     IsString,
     Max,
     Min,
 } from 'class-validator';
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 
 /**
- * Body de POST /credits (loan-credit-business). Origina el crédito en `PENDING_ACTIVATION` y genera
- * su plan de cuotas (amortización francesa + IVA 16% — M2 §3 / 05_MOTOR §4).
+ * Body de `POST /private/credits/originate` (loan-credit-business — wizard, vía api-invoker).
+ * Origina el crédito en `PENDING_ACTIVATION`: valida (M2 §4.2: sin otro crédito vivo, plan activo,
+ * IMEI libre), invoca el simulador de loan-offerings con `planId+termWeeks+precio+enganche` (la
+ * TNA y el CAT los resuelve el PLAN — el caller NO los manda) y persiste crédito + cuotas +
+ * contratos draft.
  *
- * Los términos financieros (`planId`, `termWeeks`, `tnaAnnual`) vienen de la cotización hecha con
- * loan-offerings; el motor recalcula la tabla internamente (la cotización es informativa, el plan
- * de cuotas del crédito lo genera y persiste este lambda).
+ * **Idempotente por `wizardSessionId`** (el wizard reintenta): mismo wizardSessionId → devuelve el
+ * crédito ya originado, no crea otro. El tenant viaja por query `?tenantId=` (convención privados).
  */
 export class OriginateLoanCreditRequest {
+    /** Sesión del wizard que origina — clave de idempotencia (AS-07). */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    wizardSessionId!: string;
+
     @Expose()
     @IsString()
     @IsNotEmpty()
@@ -46,14 +53,7 @@ export class OriginateLoanCreditRequest {
     @Min(0)
     downPaymentCents!: number;
 
-    /** TNA decimal (`2.30` = 230%). */
-    @Expose()
-    @IsNumber()
-    @Min(0)
-    @Max(10)
-    tnaAnnual!: number;
-
-    /** SCI del cliente al originar (snapshot). */
+    /** SCI del cliente al originar (snapshot de la evaluación del paso 05). */
     @Expose()
     @IsOptional()
     @IsInt()
@@ -66,6 +66,7 @@ export class OriginateLoanCreditRequest {
     @IsEnum(ClientLevelEnum)
     clientLevelAtOrigination?: ClientLevelEnum;
 
+    /** IMEI del equipo si ya se conoce (también puede fijarse en el paso 09 vía activate-check). */
     @Expose()
     @IsOptional()
     @IsString()

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

@@ -0,0 +1,24 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsOptional, Max, Min } from 'class-validator';
+
+/**
+ * Body de `POST /private/credits/:creditId/quote` (loan-credit-business — wizard paso 06).
+ * Re-cotiza el crédito en `PENDING_ACTIVATION` con términos nuevos (el cliente itera
+ * plazo/enganche en el cotizador) e invoca el simulador de loan-offerings; regenera las cuotas.
+ * Campos ausentes = conservar el valor actual del crédito. Rechaza si el crédito no está PENDING
+ * o si el contrato ya se firmó (los términos quedan congelados con la firma).
+ */
+export class QuoteLoanCreditRequest {
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(104)
+    termWeeks?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    downPaymentCents?: number;
+}

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

@@ -0,0 +1,24 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString, Length } from 'class-validator';
+
+/**
+ * Body de `POST /private/credits/:creditId/sign` (loan-credit-business — wizard paso 08, firma FES
+ * M2 §4.4). Endpoint de DOS tiempos sobre el mismo contrato:
+ *
+ * 1. **SIN `otpCode`** → INICIA la firma: congela términos, genera los 3 PDFs (C4), calcula sus
+ *    sha256 y dispara el OTP dedicado de firma (4 dígitos, 5 min, vía messages-business — D5;
+ *    distinto al OTP del paso 01). Responde `otpSent: true`.
+ * 2. **CON `otpCode`** → VERIFICA el OTP y firma: marca los contratos `otpVerified` + `signedAt` +
+ *    NOM-151, y pone `activationChecklist.contractSigned = true`.
+ *
+ * Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS` · `CREDIT_NOT_PENDING`.
+ * (Semántica a ratificar con el contrato del wizard — AS-07.)
+ */
+export class SignLoanCreditRequest {
+    /** Código OTP de firma. Ausente = iniciar la firma (generar PDFs + enviar OTP). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Length(4, 4)
+    otpCode?: string;
+}

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

@@ -9,7 +9,7 @@ import {
     Min,
     ValidateNested,
 } from 'class-validator';
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanBeneficiary } from '../LoanBeneficiary';
 
 /**

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

@@ -0,0 +1,11 @@
+import { LoanCreditResponse } from './LoanCreditResponse';
+
+/**
+ * Response de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5):
+ * el crédito con el checklist actualizado. `missingItems` lista las condiciones que faltan
+ * (vacío cuando el crédito quedó `ACTIVE`).
+ */
+export interface ActivationCheckResponse {
+    credit: LoanCreditResponse;
+    missingItems: string[];
+}

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 
 /**
  * Response de los endpoints de LoanBorrower (loan-credit-business). Interface plain (las salidas

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

@@ -0,0 +1,17 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/**
+ * Response de un documento del contrato (loan-credit-business). `signedAt` ausente = draft.
+ */
+export interface LoanContractResponse {
+    contractId: string;
+    creditId: string;
+    type: ContractTypeEnum;
+    pdfS3Key?: string;
+    sha256?: string;
+    otpVerified: boolean;
+    nom151Timestamp?: string;
+    signedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}

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

@@ -1,4 +1,4 @@
-import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
 
 /**

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

@@ -1,11 +1,14 @@
+import { LoanContractResponse } from './LoanContractResponse';
 import { LoanCreditResponse } from './LoanCreditResponse';
 import { LoanInstallmentResponse } from './LoanInstallmentResponse';
 
 /**
- * Response de POST /credits (loan-credit-business): el crédito recién originado en
- * `PENDING_ACTIVATION` + su plan de cuotas completo (las fechas se fijan al activar).
+ * Response de `POST /private/credits/originate` (loan-credit-business): el crédito recién
+ * originado en `PENDING_ACTIVATION` + su plan de cuotas (fechas ausentes hasta activar) + los 3
+ * contratos draft (C4 — se firman en el paso 08).
  */
 export interface OriginateLoanCreditResponse {
     credit: LoanCreditResponse;
     installments: LoanInstallmentResponse[];
+    contracts: LoanContractResponse[];
 }

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

@@ -0,0 +1,11 @@
+import { LoanCreditResponse } from './LoanCreditResponse';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+
+/**
+ * Response de `POST /private/credits/:creditId/quote` (loan-credit-business): el crédito con los
+ * términos re-cotizados + el plan de cuotas regenerado (fechas ausentes hasta activar).
+ */
+export interface QuoteLoanCreditResponse {
+    credit: LoanCreditResponse;
+    installments: LoanInstallmentResponse[];
+}

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

@@ -0,0 +1,21 @@
+import { LoanContractResponse } from './LoanContractResponse';
+
+/**
+ * Response de `POST /private/credits/:creditId/sign` (loan-credit-business — firma FES en 2
+ * tiempos): al INICIAR (`otpSent: true`, contratos con PDF+hash sin firmar); al VERIFICAR
+ * (`signed: true`, contratos firmados + checklist con `contractSigned = true`).
+ */
+export interface SignLoanCreditResponse {
+    creditId: string;
+    /** true cuando el request inició la firma y el OTP fue despachado. */
+    otpSent: boolean;
+    /** true cuando el OTP fue verificado y los contratos quedaron firmados. */
+    signed: boolean;
+    contracts: LoanContractResponse[];
+    activationChecklist: {
+        downPayment: boolean;
+        contractSigned: boolean;
+        imeiEnrolled: boolean;
+        lockVerified: boolean;
+    };
+}

package/src/loanCredit/enums/ContractTypeEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Tipo de documento del contrato de crédito (M2 §4.3 / C4 — 3 documentos):
+ * `CREDIT` = contrato de crédito celular (RECA 16145-439-038506/04-01076-0525) ·
+ * `PROMISSORY_NOTE` = pagaré (garantiza el crédito; mismo monto/tasa/plazo) ·
+ * `SIC_AUTHORIZATION` = autorización de consulta/reporte a Círculo de Crédito (Art. 28 LRSIC).
+ * @enum {string}
+ */
+export enum ContractTypeEnum {
+    CREDIT = 'CREDIT',
+    PROMISSORY_NOTE = 'PROMISSORY_NOTE',
+    SIC_AUTHORIZATION = 'SIC_AUTHORIZATION',
+}

package/src/loanCredit/enums/LoanInstallmentStatusEnum.ts

@@ -1,11 +1,14 @@
 /**
- * Estado de una cuota semanal del crédito (M2 §6.1 / 05_MOTOR §5).
- * `RESTRUCTURED` (reestructurado) = la cuota dejó de aplicar por reestructura o cancelación.
+ * Estado de una cuota semanal del crédito (M2 §6.1: pendiente · pagado · pagado_adelantado ·
+ * vencido · reestructurado). `PAID_IN_ADVANCE` = pago adelantado (cubre cuota futura tal cual,
+ * sin recalcular tabla — M2 §3.7). `RESTRUCTURED` = la cuota dejó de aplicar por
+ * reestructura o cancelación.
  * @enum {string}
  */
 export enum LoanInstallmentStatusEnum {
     PENDING = 'PENDING',
     PAID = 'PAID',
+    PAID_IN_ADVANCE = 'PAID_IN_ADVANCE',
     OVERDUE = 'OVERDUE',
     RESTRUCTURED = 'RESTRUCTURED',
 }

package/src/loanCredit/index.ts

@@ -1,23 +1,32 @@
 // Enums
 export * from './enums/LoanCreditStatusEnum';
 export * from './enums/LoanInstallmentStatusEnum';
-export * from './enums/ClientLevelEnum';
+export * from './enums/ContractTypeEnum';
+// Re-export del enum canónico de nivel (owner: loanScoring — un solo origen de verdad).
+export { ClientLevelEnum } from '../loanScoring/enums/ClientLevelEnum';
 
 // Entity DTOs
 export * from './dtos/LoanBorrower';
 export * from './dtos/LoanBeneficiary';
 export * from './dtos/LoanCredit';
 export * from './dtos/LoanInstallment';
+export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
 
 // Request DTOs
 export * from './dtos/requests/UpsertLoanBorrowerRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
-export * from './dtos/requests/UpdateActivationChecklistRequest';
+export * from './dtos/requests/QuoteLoanCreditRequest';
+export * from './dtos/requests/SignLoanCreditRequest';
+export * from './dtos/requests/ActivationCheckRequest';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 
 // Response DTOs
 export * from './dtos/responses/LoanBorrowerResponse';
 export * from './dtos/responses/LoanCreditResponse';
 export * from './dtos/responses/LoanInstallmentResponse';
+export * from './dtos/responses/LoanContractResponse';
 export * from './dtos/responses/OriginateLoanCreditResponse';
+export * from './dtos/responses/QuoteLoanCreditResponse';
+export * from './dtos/responses/SignLoanCreditResponse';
+export * from './dtos/responses/ActivationCheckResponse';

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' })