@fiado/type-kit 3.627.0 → 3.629.0

package/src/loanScoring/dtos/requests/EvaluateSciRequest.ts

@@ -1,5 +1,7 @@
 import { Type } from 'class-transformer';
-import { IsBoolean, IsEmail, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { IsBoolean, IsEmail, IsNotEmpty, IsOptional, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+import { PHONE_MX_PATTERN } from '../../../common/constants/InputPatterns';
+import { CREDIT_ID_PATTERN } from '../../../common/constants/CreditIdPattern';
 import { SciInternalHistoryInput } from './SciInternalHistoryInput';
 
 /**
@@ -7,11 +9,24 @@ import { SciInternalHistoryInput } from './SciInternalHistoryInput';
  * crédito, vía api-invoker). El proveedor NO se elige acá: lo resuelve el `ScoringProviderRouter`
  * por configuración del tenant (spec 12). El tenant viaja por query `?tenantId=` (convención de
  * los privados Fiado), no en este body.
+ *
+ * La consulta al proveedor se cobra: celular e ids llegan con su formato (L-177); el CURP, acotado.
  */
 export class EvaluateSciRequest {
-    /** Acreditado a evaluar (`LoanBorrower`). La evaluación queda ligada a él en el historial. */
+    /**
+     * Llave del intento, opcional (L-173): el mismo valor devuelve la misma evaluación sin volver a
+     * consultar al proveedor. Sin ella, cada llamada es una evaluación nueva, como hasta ahora.
+     */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    idempotencyKey?: string;
+
+    /** Acreditado a evaluar (`LoanBorrower`, ULID). La evaluación queda ligada a él en el historial. */
     @IsString()
     @IsNotEmpty()
+    @Matches(CREDIT_ID_PATTERN, { message: 'borrowerId debe ser un ULID de 26 caracteres' })
     borrowerId!: string;
 
     /**
@@ -21,16 +36,23 @@ export class EvaluateSciRequest {
     @IsOptional()
     @IsString()
     @IsNotEmpty()
+    @MaxLength(64)
     retailCustomerId?: string;
 
-    /** CURP del solicitante (requerido por los proveedores de scoring). */
+    /**
+     * CURP del solicitante (requerido por los proveedores de scoring). Solo con tope de largo:
+     * retail-customer guarda el CURP de Metamap sin validar su formato, y exigir `regexCurp` aquí
+     * tumbaría la evaluación del wizard. El formato lo revisa loan-scoring antes de consultar (L-177, A).
+     */
     @IsString()
     @IsNotEmpty()
+    @MaxLength(64)
     curp!: string;
 
-    /** Celular del solicitante (requerido por Modelias). */
+    /** Celular del solicitante: 10 dígitos, sin `+52` (requerido por Modelias). */
     @IsString()
     @IsNotEmpty()
+    @Matches(PHONE_MX_PATTERN, { message: 'cellphone debe tener 10 dígitos' })
     cellphone!: string;
 
     @IsOptional()