@fiado/type-kit 3.200.0 → 3.203.0

package/bin/kyc/dtos/responses/KycPersonData.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 declare class KycPersonData {
+    names?: string;
+    paternalLastName?: string;
+    maternalLastName?: string;
+    curp?: string;
+    dateOfBirth?: string;
+}

package/bin/kyc/dtos/responses/KycPersonData.js

@@ -0,0 +1,51 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycPersonData = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("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.
+ */
+class KycPersonData {
+}
+exports.KycPersonData = KycPersonData;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycPersonData.prototype, "names", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycPersonData.prototype, "paternalLastName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycPersonData.prototype, "maternalLastName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycPersonData.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycPersonData.prototype, "dateOfBirth", void 0);

package/bin/kyc/enums/KycVerificationStatusEnum.d.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 declare enum KycVerificationStatusEnum {
+    CREATED = "CREATED",
+    SENT = "SENT",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    ERROR = "ERROR"
+}

package/bin/kyc/enums/KycVerificationStatusEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycVerificationStatusEnum = void 0;
+/**
+ * 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`.)
+ */
+var KycVerificationStatusEnum;
+(function (KycVerificationStatusEnum) {
+    KycVerificationStatusEnum["CREATED"] = "CREATED";
+    KycVerificationStatusEnum["SENT"] = "SENT";
+    KycVerificationStatusEnum["IN_PROGRESS"] = "IN_PROGRESS";
+    KycVerificationStatusEnum["COMPLETED"] = "COMPLETED";
+    KycVerificationStatusEnum["ERROR"] = "ERROR";
+})(KycVerificationStatusEnum || (exports.KycVerificationStatusEnum = KycVerificationStatusEnum = {}));

package/bin/kyc/events/KycVerificationChangedV1.d.ts

@@ -0,0 +1,35 @@
+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 declare class KycVerificationChangedV1 {
+    /** La PK de la fila (`id`) mapeada a nombre de negocio. */
+    verificationId: string;
+    directoryId: string;
+    peopleId: string;
+    metamapFlowId?: string;
+    verificationStatus: KycVerificationStatusEnum;
+    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).
+     */
+    updateDate: string;
+}

package/bin/kyc/events/KycVerificationChangedV1.js

@@ -0,0 +1,76 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycVerificationChangedV1 = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const IdentificationDocumentStatus_1 = require("../../identity/enums/IdentificationDocumentStatus");
+const KycVerificationStatusEnum_1 = require("../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.
+ */
+class KycVerificationChangedV1 {
+}
+exports.KycVerificationChangedV1 = KycVerificationChangedV1;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "verificationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "peopleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "metamapFlowId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(KycVerificationStatusEnum_1.KycVerificationStatusEnum),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "verificationStatus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(IdentificationDocumentStatus_1.IdentificationDocumentStatus),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "verificationResult", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "updateDate", void 0);

package/bin/kyc/index.d.ts

@@ -0,0 +1,4 @@
+export * from './enums/KycVerificationStatusEnum';
+export * from './dtos/responses/KycPersonData';
+export * from './dtos/responses/KycByDirectoryResponse';
+export * from './events/KycVerificationChangedV1';

package/bin/kyc/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums (el consolidado reusa RetailKycStatusEnum del dominio retailCustomer — DEC-KYC-014;
+// `verificationResult` reusa IdentificationDocumentStatus de `identity` — DEC-KYC-016)
+__exportStar(require("./enums/KycVerificationStatusEnum"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/KycPersonData"), exports);
+__exportStar(require("./dtos/responses/KycByDirectoryResponse"), exports);
+// Events
+__exportStar(require("./events/KycVerificationChangedV1"), exports);

package/bin/loanCredit/dtos/LoanBorrower.d.ts

@@ -9,6 +9,8 @@ export declare class LoanBorrower {
     borrowerId: string;
     /** FK al comprador de retail (`RetailCustomer` — owner retail-customer-business). */
     retailCustomerId: string;
+    /** DirectoryId Fiado del cliente (id operacional — hidratado de CustomerKycVerifiedV1). */
+    fiadoDirectoryId?: string;
     /** SCI vigente 0-100 (M7). Ausente hasta la primera evaluación. */
     sciScore?: number;
     clientLevel?: ClientLevelEnum;

package/bin/loanCredit/dtos/LoanBorrower.js

@@ -33,6 +33,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], LoanBorrower.prototype, "retailCustomerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanBorrower.prototype, "fiadoDirectoryId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -14,4 +14,16 @@
 export declare class SignLoanCreditRequest {
     /** Código OTP de firma. Ausente = iniciar la firma (generar PDFs + enviar OTP). */
     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).
+     */
+    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).
+     */
+    otpDestination?: string;
 }

package/bin/loanCredit/dtos/requests/SignLoanCreditRequest.js

@@ -35,3 +35,15 @@ __decorate([
     (0, class_validator_1.Length)(4, 4),
     __metadata("design:type", String)
 ], SignLoanCreditRequest.prototype, "otpCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SignLoanCreditRequest.prototype, "otpDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SignLoanCreditRequest.prototype, "otpDestination", void 0);

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

@@ -0,0 +1,11 @@
+/**
+ * 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/dtos/requests/UpdateActivationChecklistRequest.js

@@ -0,0 +1,46 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateActivationChecklistRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * 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`).
+ */
+class UpdateActivationChecklistRequest {
+}
+exports.UpdateActivationChecklistRequest = UpdateActivationChecklistRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "downPayment", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "contractSigned", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "imeiEnrolled", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "lockVerified", void 0);

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

@@ -7,6 +7,8 @@ import { LoanBeneficiary } from '../LoanBeneficiary';
  */
 export declare class UpsertLoanBorrowerRequest {
     retailCustomerId: string;
+    /** DirectoryId Fiado del cliente (id operacional). */
+    fiadoDirectoryId?: string;
     sciScore?: number;
     clientLevel?: ClientLevelEnum;
     bureauScore?: number;

package/bin/loanCredit/dtos/requests/UpsertLoanBorrowerRequest.js

@@ -28,6 +28,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], UpsertLoanBorrowerRequest.prototype, "retailCustomerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertLoanBorrowerRequest.prototype, "fiadoDirectoryId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanCredit/dtos/responses/LoanBorrowerResponse.d.ts

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

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

@@ -0,0 +1,11 @@
+/**
+ * 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

@@ -0,0 +1,15 @@
+"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 = {}));

package/bin/messagesConnector/dtos/SendMessageRequest.js

@@ -29,7 +29,8 @@ __decorate([
 ], SendMessageRequest.prototype, "messageType", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsUUID)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], SendMessageRequest.prototype, "directoryId", void 0);
 __decorate([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.200.0",
+  "version": "3.203.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',
+}