@fiado/type-kit 3.200.0 → 3.203.0

package/src/kyc/events/KycVerificationChangedV1.ts

@@ -0,0 +1,51 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { IdentificationDocumentStatus } from '../../identity/enums/IdentificationDocumentStatus';
+import { KycVerificationStatusEnum } from '../enums/KycVerificationStatusEnum';
+
+/**
+ * Cambio terminal de una verificación KYC, tal como llega desde el DDB Stream de
+ * `KycVerifications` a través del EventBridge Pipe (filtrado a COMPLETED).
+ *
+ * NO lleva `tenantId`: el de la tabla es un valor hardcodeado que no discrimina silo.
+ * La pertenencia se resuelve en el consumer con el gate de `WizardSession`.
+ *
+ * Los estados viajan CRUDOS para no acoplar al consumidor con el mapeo del dominio dueño.
+ *
+ * DEC-KYC-015: los tres identificadores usan `@IsNotEmpty()`. El NewImage de DDB puede traer
+ * `S: ""` — que `@IsString()` aceptaría en silencio. Preferimos que el mensaje caiga al DLQ
+ * en el boundary antes que fallar mudo tres pasos río abajo.
+ *
+ * DEC-KYC-016: `verificationResult` reusa `IdentificationDocumentStatus` — es el enum que el
+ * lambda productor (`kyc-verifications-business`) escribe literalmente en la tabla; duplicarlo
+ * aquí sería drift garantizado.
+ */
+export class KycVerificationChangedV1 {
+    /** La PK de la fila (`id`) mapeada a nombre de negocio. */
+    @Expose() @IsString() @IsNotEmpty()
+    verificationId!: string;
+
+    @Expose() @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    @Expose() @IsString() @IsNotEmpty()
+    peopleId!: string;
+
+    @Expose() @IsOptional() @IsString()
+    metamapFlowId?: string;
+
+    @Expose() @IsEnum(KycVerificationStatusEnum)
+    verificationStatus!: KycVerificationStatusEnum;
+
+    @Expose() @IsEnum(IdentificationDocumentStatus)
+    verificationResult!: IdentificationDocumentStatus;
+
+    /**
+     * ISO-8601 obligatorio: el ordenamiento del endpoint (spec §6) se apoya en que la fecha es
+     * léxicamente ordenable. Se escanearon las 193 filas de `KycVerifications` en dev —
+     * `createDate` 193/193 y `updateDate` 193/193 ISO-8601: 386/386, cero excepciones
+     * (ejemplo real: '2025-10-06T21:40:58.277Z'). Verificado, no asumido (2026-07-21).
+     */
+    @Expose() @IsString() @IsISO8601()
+    updateDate!: string;
+}

package/src/kyc/index.ts

@@ -0,0 +1,10 @@
+// Enums (el consolidado reusa RetailKycStatusEnum del dominio retailCustomer — DEC-KYC-014;
+// `verificationResult` reusa IdentificationDocumentStatus de `identity` — DEC-KYC-016)
+export * from './enums/KycVerificationStatusEnum';
+
+// Response DTOs
+export * from './dtos/responses/KycPersonData';
+export * from './dtos/responses/KycByDirectoryResponse';
+
+// Events
+export * from './events/KycVerificationChangedV1';

package/src/loanCredit/dtos/LoanBorrower.ts

@@ -28,6 +28,12 @@ export class LoanBorrower {
     @IsString()
     retailCustomerId!: string;
 
+    /** DirectoryId Fiado del cliente (id operacional — hidratado de CustomerKycVerifiedV1). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    fiadoDirectoryId?: string;
+
     /** SCI vigente 0-100 (M7). Ausente hasta la primera evaluación. */
     @Expose()
     @IsOptional()

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

@@ -21,4 +21,24 @@ export class SignLoanCreditRequest {
     @IsString()
     @Length(4, 4)
     otpCode?: string;
+
+    /**
+     * SOLO en el inicio de firma (tiempo 1) con el OTP REAL de messages-business: el directoryId
+     * Fiado del cliente (lo aporta el WIZARD — dueño del dato; fallback: el fiadoDirectoryId
+     * hidratado en el borrower). El OTP se genera/verifica keyeado a este id (D5).
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    otpDirectoryId?: string;
+
+    /**
+     * SOLO en el inicio de firma (tiempo 1) con el OTP REAL: el teléfono destino del SMS (E.164).
+     * PII TRANSITORIA: el motor la pasa a messages-business y NO la persiste ni loggea (silo
+     * PII-zero — el teléfono vive en RetailCustomer).
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    otpDestination?: string;
 }

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

@@ -23,6 +23,12 @@ export class UpsertLoanBorrowerRequest {
     @IsNotEmpty()
     retailCustomerId!: string;
 
+    /** DirectoryId Fiado del cliente (id operacional). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    fiadoDirectoryId?: string;
+
     @Expose()
     @IsOptional()
     @IsInt()

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

@@ -7,6 +7,7 @@ import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 export interface LoanBorrowerResponse {
     borrowerId: string;
     retailCustomerId: string;
+    fiadoDirectoryId?: string;
     sciScore?: number;
     clientLevel?: ClientLevelEnum;
     bureauScore?: number;

package/src/messagesConnector/dtos/SendMessageRequest.ts

@@ -5,7 +5,14 @@ import { DeliveryChannelEnum } from '../../messaging';
 export class SendMessageRequest {
     @Expose() @IsEnum(DeliveryChannelEnum) channelType!: DeliveryChannelEnum;
     @Expose() @IsString() @IsNotEmpty() messageType!: string;
-    @Expose() @IsUUID() directoryId!: string;
+    // directoryId NO se valida como @IsUUID: para messages es una LLAVE DE CORRELACIÓN opaca
+    // (rate-limit + log + verify), no una FK a ningún directorio — la llave real es el par
+    // (typeOfDirectory, directoryId). Exigir UUID rompía dos casos legítimos: los cognitoSub UUID v7
+    // (que class-validator @IsUUID() v1-5 rechaza) y el OTP de teléfono del wizard retail, donde el
+    // cliente todavía NO tiene identidad Fiado — el OTP es justamente lo que verifica el teléfono, y
+    // corre ANTES de crear directory/people. Las otras dos puertas ya usan @IsString:
+    // VerifyOtpRequest y NotificationQueueMessageRequestV2 — esto deja el SEND HTTP consistente.
+    @Expose() @IsString() @IsNotEmpty() directoryId!: string;
     @Expose() @IsString() @IsNotEmpty() typeOfDirectory!: string;
     @Expose() @IsString() @IsNotEmpty() language!: string;
     @Expose() @IsString() @IsNotEmpty() country!: string;

package/bin/benefitCenter/enums/BenefitFlowEnum.d.ts

@@ -1,11 +0,0 @@
-export declare enum BenefitFlowEnum {
-    TOPUPS = "TOPUPS",
-    BILL_PAYMENT = "BILL_PAYMENT",
-    CREDIT = "CREDIT",
-    INSURANCE = "INSURANCE",
-    DONATION = "DONATION",
-    PHARMACY = "PHARMACY",
-    REMITTANCE = "REMITTANCE",
-    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
-    WALLET_FUNDING = "WALLET_FUNDING"
-}

package/bin/benefitCenter/enums/BenefitFlowEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BenefitFlowEnum = void 0;
-var BenefitFlowEnum;
-(function (BenefitFlowEnum) {
-    BenefitFlowEnum["TOPUPS"] = "TOPUPS";
-    BenefitFlowEnum["BILL_PAYMENT"] = "BILL_PAYMENT";
-    BenefitFlowEnum["CREDIT"] = "CREDIT";
-    BenefitFlowEnum["INSURANCE"] = "INSURANCE";
-    BenefitFlowEnum["DONATION"] = "DONATION";
-    BenefitFlowEnum["PHARMACY"] = "PHARMACY";
-    BenefitFlowEnum["REMITTANCE"] = "REMITTANCE";
-    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
-    BenefitFlowEnum["WALLET_FUNDING"] = "WALLET_FUNDING";
-})(BenefitFlowEnum || (exports.BenefitFlowEnum = BenefitFlowEnum = {}));

package/bin/loanConfig/enums/ModifiableByRoleEnum.d.ts

@@ -1,11 +0,0 @@
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-export declare enum ModifiableByRoleEnum {
-    SUPER_ADMIN = "super_admin",
-    SOFOM_ADMIN = "sofom_admin",
-    RETAILER_ADMIN = "retailer_admin"
-}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModifiableByRoleEnum = void 0;
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-var ModifiableByRoleEnum;
-(function (ModifiableByRoleEnum) {
-    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
-    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
-    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
-})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

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

@@ -1,17 +0,0 @@
-import { CurrencyId } from '../../currency/enums/CurrencyId';
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-export declare class CashInFeeDto {
-    /** Comisión fija, en la moneda del país. */
-    fixed?: number;
-    /** Porcentaje del monto depositado (0–100). */
-    percentage?: number;
-    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
-    cap?: number;
-    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
-    currency: CurrencyId;
-}

package/bin/places/dtos/CashInFeeDto.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CashInFeeDto = void 0;
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-class CashInFeeDto {
-}
-exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -1,22 +0,0 @@
-import { MfaMethodEnum } from '../enums/MfaMethodEnum';
-/**
- * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
- * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
- * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
- * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
- * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
- */
-export declare class ResendOtpRequest {
-    email: string;
-    tenantId: string;
-}
-/**
- * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
- * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
- * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
- * el server responde 200 genérico sin session ni método.
- */
-export interface ResendOtpResponse {
-    session?: string;
-    mfaMethod?: MfaMethodEnum;
-}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -1,11 +0,0 @@
-/**
- * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
- * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
- * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
- * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
- * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
- */
-export declare class ResendSelfRegisterOtpRequest {
-    tenantId: string;
-    email: string;
-}