@fiado/type-kit 3.199.0 → 3.202.0

package/bin/retailCustomer/dtos/RetailCustomer.js

@@ -16,6 +16,7 @@ const regex_1 = require("../../helpers/constans/regex");
 const AddressBase_1 = require("../../address/dtos/AddressBase");
 const AccountStatusEnum_1 = require("../enums/AccountStatusEnum");
 const KycModalityEnum_1 = require("../enums/KycModalityEnum");
+const RetailCustomerStatusEnum_1 = require("../enums/RetailCustomerStatusEnum");
 const RetailKycStatusEnum_1 = require("../enums/RetailKycStatusEnum");
 const KycReview_1 = require("./KycReview");
 /**
@@ -41,7 +42,23 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], RetailCustomer.prototype, "name", void 0);
+], RetailCustomer.prototype, "originStoreId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "names", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "paternalLastName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "maternalLastName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
@@ -49,9 +66,27 @@ __decorate([
 ], RetailCustomer.prototype, "phone", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], RetailCustomer.prototype, "phoneVerified", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], RetailCustomer.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "rfc", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "email", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
@@ -136,6 +171,34 @@ __decorate([
     (0, class_transformer_1.Type)(() => KycReview_1.KycReview),
     __metadata("design:type", KycReview_1.KycReview)
 ], RetailCustomer.prototype, "kycReview", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], RetailCustomer.prototype, "kycScore", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "metamapVerificationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], RetailCustomer.prototype, "pldFlag", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "notes", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RetailCustomerStatusEnum_1.RetailCustomerStatusEnum),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "status", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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

@@ -1,10 +1,16 @@
 /**
  * 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 declare class CreateCustomerRequest {
-    name: string;
+    originStoreId: string;
+    names: string;
+    paternalLastName: string;
+    maternalLastName?: string;
     phone: string;
     curp?: string;
+    rfc?: string;
+    email?: string;
     birthDate?: string;
 }

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

@@ -15,6 +15,7 @@ const class_validator_1 = require("class-validator");
 const regex_1 = require("../../../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.
  */
 class CreateCustomerRequest {
@@ -24,7 +25,23 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], CreateCustomerRequest.prototype, "name", void 0);
+], CreateCustomerRequest.prototype, "originStoreId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateCustomerRequest.prototype, "names", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateCustomerRequest.prototype, "paternalLastName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateCustomerRequest.prototype, "maternalLastName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
@@ -36,6 +53,18 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CreateCustomerRequest.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateCustomerRequest.prototype, "rfc", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], CreateCustomerRequest.prototype, "email", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -3,8 +3,14 @@
  * AuditTrail + PiiAccessLog en el lambda. SureKeep Fase 2 — pista Retail.
  */
 export declare class UpdateCustomerRequest {
-    name?: string;
+    names?: string;
+    paternalLastName?: string;
+    maternalLastName?: string;
     phone?: string;
     curp?: string;
+    rfc?: string;
+    email?: string;
+    /** Notas operativas del BO (F1 §3.5). */
+    notes?: string;
     birthDate?: string;
 }

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

@@ -25,7 +25,19 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], UpdateCustomerRequest.prototype, "name", void 0);
+], UpdateCustomerRequest.prototype, "names", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateCustomerRequest.prototype, "paternalLastName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateCustomerRequest.prototype, "maternalLastName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
@@ -38,6 +50,24 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], UpdateCustomerRequest.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateCustomerRequest.prototype, "rfc", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], UpdateCustomerRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateCustomerRequest.prototype, "notes", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -7,10 +7,22 @@ import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
  * SureKeep Fase 2 — pista Retail.
  */
 export declare class UpsertCustomerFromKycRequest {
-    name: string;
+    /** Tienda de alta/origen — del JWT del vendedor dueño de la sesión del wizard (F1 §3.5). */
+    originStoreId: string;
+    /** Nombre partido por convención Fiado (F1 §3.5) — lo entrega el OCR del INE, NO se deriva de un string. */
+    names: string;
+    paternalLastName: string;
+    /** Segundo apellido — opcional (F1 §3.5: "el 2º apellido nullable"). */
+    maternalLastName?: string;
     phone: string;
     curp: string;
     birthDate?: string;
+    rfc?: string;
+    email?: string;
+    /** Score de confianza que devuelve Metamap junto con el resultado del KYC (F1 §3.5). */
+    kycScore?: number;
+    /** Referencia a la verificación en `kyc-verifications-business` (INT1, F1 §3.5). */
+    metamapVerificationId?: string;
     fiadoDirectoryId: string;
     fiadoPeopleId: string;
     pcfAccountId?: string;

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

@@ -28,7 +28,23 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], UpsertCustomerFromKycRequest.prototype, "name", void 0);
+], UpsertCustomerFromKycRequest.prototype, "originStoreId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "names", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "paternalLastName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "maternalLastName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.replace(/[\s-]/g, '') : value)),
@@ -50,6 +66,30 @@ __decorate([
     (0, class_validator_1.Matches)(regex_1.regexIso8601Date, { message: 'birthDate debe ser una fecha ISO 8601' }),
     __metadata("design:type", String)
 ], UpsertCustomerFromKycRequest.prototype, "birthDate", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "rfc", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], UpsertCustomerFromKycRequest.prototype, "kycScore", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "metamapVerificationId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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.199.0",
+  "version": "3.202.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/auth/dtos/SignUpProspectRequest.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Alta de prospecto M2M en `auth-business` (crea onboarding + People + DirectoryUser).
+ * Contrato REDUCIDO respecto del de agente: sin caller, sin referral, sin campos de app.
+ *
+ * `tenantId` es OBLIGATORIO y explícito: la variante de agente lo tiene hardcodeado a
+ * `FIADO_BETA`, y eliminar ese hardcode es parte del contrato de este endpoint privado.
+ *
+ * ⚠️ PII: nombre y teléfono — nunca loguear el request completo.
+ */
+export class SignUpProspectRequest {
+    @Expose() @IsString() @IsNotEmpty()
+    name!: string;
+
+    @Expose() @IsString() @IsNotEmpty()
+    phoneNumber!: string;
+
+    /** Decidido: sin `@Matches(/^[a-z0-9-]+$/)` — `FIADO_BETA` es un tenant real y ese regex lo rechazaría. */
+    @Expose() @IsString() @IsNotEmpty()
+    tenantId!: string;
+}

package/src/auth/dtos/SignUpProspectResponse.ts

@@ -0,0 +1,17 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Identidad Fiado creada (o reusada) para el prospecto.
+ *
+ * DEC-KYC-015: `directoryId` y `peopleId` llevan `@IsNotEmpty()` — son los mismos dos
+ * identificadores que en el dominio `kyc`, y vienen de un destino que ya demostró devolver
+ * strings vacíos. `@IsString()` pelado los dejaría pasar en silencio.
+ */
+export class SignUpProspectResponse {
+    @Expose() @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    @Expose() @IsString() @IsNotEmpty()
+    peopleId!: string;
+}

package/src/auth/index.ts

@@ -5,3 +5,5 @@ export * from './dtos/ResetPasswordBackofficeRequest';
 export * from './dtos/SignInBackofficeRequest';
 export * from './dtos/SignInBackofficeResponse';
 export * from './dtos/SignUpBackofficeRequest';
+export * from './dtos/SignUpProspectRequest';
+export * from './dtos/SignUpProspectResponse';

package/src/index.ts

@@ -130,5 +130,9 @@ export * as LoanCredit from './loanCredit';
 // ScoringProviderRouter configurable Modelias|Círculo con contrato agnóstico ScoringDecision;
 // SureKeep Fase 2 — pista Loan/SOFOM).
 export * as LoanScoring from './loanScoring';
+// Kyc: contrato de la lectura confirmatoria del KYC (kyc-verifications-business) — estado
+// consolidado + estados crudos + datos de persona. El consolidado reusa RetailKycStatusEnum
+// (no hay enum consolidado propio — DEC-KYC-014). SureKeep Fase 2.
+export * as Kyc from './kyc';
 export * from './messaging';
 export * from './complaint';

package/src/kyc/dtos/responses/KycByDirectoryResponse.ts

@@ -0,0 +1,69 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { IdentificationDocumentStatus } from '../../../identity/enums/IdentificationDocumentStatus';
+import { RetailKycStatusEnum } from '../../../retailCustomer/enums/RetailKycStatusEnum';
+import { KycVerificationStatusEnum } from '../../enums/KycVerificationStatusEnum';
+import { KycPersonData } from './KycPersonData';
+
+/**
+ * Estado consolidado del KYC de un directorio + los estados crudos + los datos de persona.
+ *
+ * Los campos crudos viajan además del consolidado para que el consumidor NO tenga que
+ * reimplementar el mapeo de otro dominio.
+ *
+ * DEC-KYC-014: "sin verificación" se responde con 404, NO con un valor de enum. Por eso todos
+ * los campos de identidad y estado son REQUERIDOS — este DTO solo describe el caso en que sí
+ * existe una verificación.
+ *
+ * DEC-KYC-004: el vocabulario del consolidado es `RetailKycStatusEnum`, el único de la lib.
+ *
+ * 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.
+ *
+ * ⚠️ Lleva PII en `person` (CURP y nombre completo).
+ */
+export class KycByDirectoryResponse {
+    @Expose() @IsEnum(RetailKycStatusEnum)
+    consolidated!: RetailKycStatusEnum;
+
+    /** La PK de la fila (`id`) mapeada a nombre de negocio. */
+    @Expose() @IsString() @IsNotEmpty()
+    verificationId!: string;
+
+    /** DEC-KYC-015: `@IsNotEmpty()` — el 7.3% de las filas de dev trae string vacío. */
+    @Expose() @IsString() @IsNotEmpty()
+    peopleId!: string;
+
+    @Expose() @IsOptional() @IsString()
+    metamapFlowId?: string;
+
+    @Expose() @IsEnum(KycVerificationStatusEnum)
+    verificationStatus!: KycVerificationStatusEnum;
+
+    /**
+     * Requerido y acotado al enum: se escanearon las 193 filas de `KycVerifications` en dev y los
+     * valores son exactamente los tres — `IN_PROGRESS+UNVERIFIED` 104, `COMPLETED+VERIFIED` 69,
+     * `COMPLETED+UNVERIFIED` 19, `COMPLETED+REJECTED` 1. Cero valores fuera del set, cero vacíos.
+     * Verificado, no asumido (2026-07-21).
+     */
+    @Expose() @IsEnum(IdentificationDocumentStatus)
+    verificationResult!: IdentificationDocumentStatus;
+
+    /**
+     * ISO-8601 obligatorio: el ordenamiento del endpoint (spec §6) se apoya en que estas fechas
+     * son léxicamente ordenables — si no se valida el formato, el orden es una asunción sin red.
+     * Se escanearon las 193 filas de `KycVerifications` en dev: `createDate` 193/193 ISO-8601 y
+     * `updateDate` 193/193 — 386/386, cero excepciones (ejemplo real: '2025-10-06T21:40:58.277Z').
+     * Verificado, no asumido (2026-07-21).
+     */
+    @Expose() @IsString() @IsISO8601()
+    createDate!: string;
+
+    /** ISO-8601 obligatorio — mismo escaneo de dev: 386/386 fechas ISO-8601 (2026-07-21). */
+    @Expose() @IsString() @IsISO8601()
+    updateDate!: string;
+
+    @Expose() @IsOptional() @ValidateNested() @Type(() => KycPersonData)
+    person?: KycPersonData;
+}

package/src/kyc/dtos/responses/KycPersonData.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString } from 'class-validator';
+
+/**
+ * Datos de identidad del cliente, leídos de People tras un KYC completado.
+ * ⚠️ PII: nunca loguear esta estructura ni exponerla en endpoints de alta frecuencia.
+ */
+export class KycPersonData {
+    @Expose() @IsOptional() @IsString()
+    names?: string;
+
+    @Expose() @IsOptional() @IsString()
+    paternalLastName?: string;
+
+    @Expose() @IsOptional() @IsString()
+    maternalLastName?: string;
+
+    @Expose() @IsOptional() @IsString()
+    curp?: string;
+
+    @Expose() @IsOptional() @IsString()
+    dateOfBirth?: string;
+}

package/src/kyc/enums/KycVerificationStatusEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Ciclo de vida de la verificación en `kyc-verifications-business` (crudo, sin colapsar).
+ *
+ * DEC-KYC-016: sí, duplica `KycVerificationStatus` de `@fiado/fiado-abstractions`
+ * (`bin/Fiado/Database/KycVerifications.d.ts`, mismos 5 valores) — y se queda así a propósito.
+ * `fiado-abstractions` es la lib legacy de la que `type-kit` está migrando: el contrato nuevo no
+ * debe depender de ella. No lo "arregles" importando desde abstractions.
+ *
+ * (Contraste: `verificationResult` NO se duplica — reusa `IdentificationDocumentStatus`, que ya
+ * vive publicado en esta misma lib bajo `identity`.)
+ */
+export enum KycVerificationStatusEnum {
+    CREATED = 'CREATED',
+    SENT = 'SENT',
+    IN_PROGRESS = 'IN_PROGRESS',
+    COMPLETED = 'COMPLETED',
+    ERROR = 'ERROR',
+}

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/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;