@fiado/type-kit 3.200.0 → 3.202.0

package/_test_/unit/auth/SignUpProspectRequest.test.ts

@@ -0,0 +1,32 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SignUpProspectRequest } from '../../../src/auth/index';
+
+describe('SignUpProspectRequest', () => {
+  it('acepta un alta válida de prospecto', async () => {
+    const dto = plainToInstance(SignUpProspectRequest,
+      { name: 'Paulina Garcia', phoneNumber: '5512345678', tenantId: 'surekeep' },
+      { excludeExtraneousValues: true });
+
+    expect(await validate(dto as object)).toHaveLength(0);
+  });
+
+  it('rechaza si falta el tenantId (el hardcode FIADO_BETA es justo lo que se elimina)', async () => {
+    const dto = plainToInstance(SignUpProspectRequest,
+      { name: 'Paulina Garcia', phoneNumber: '5512345678' },
+      { excludeExtraneousValues: true });
+
+    const errors = await validate(dto as object);
+    expect(errors.map((e) => e.property)).toContain('tenantId');
+  });
+
+  it('rechaza campos vacíos en vez de dejarlos pasar', async () => {
+    const dto = plainToInstance(SignUpProspectRequest,
+      { name: '', phoneNumber: '', tenantId: '' },
+      { excludeExtraneousValues: true });
+
+    const props = (await validate(dto as object)).map((e) => e.property);
+    expect(props).toEqual(expect.arrayContaining(['name', 'phoneNumber', 'tenantId']));
+  });
+});

package/_test_/unit/auth/SignUpProspectResponse.test.ts

@@ -0,0 +1,26 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SignUpProspectResponse } from '../../../src/auth/index';
+
+describe('SignUpProspectResponse', () => {
+  it('acepta una respuesta válida con ambos identificadores', async () => {
+    const dto = plainToInstance(SignUpProspectResponse,
+      { directoryId: 'dir-1', peopleId: 'ppl-1' },
+      { excludeExtraneousValues: true });
+
+    expect(await validate(dto as object)).toHaveLength(0);
+  });
+
+  // DEC-KYC-015: el destino ya demostró devolver strings vacíos. @IsString() pelado los dejaría
+  // pasar y la falla aparecería tres pasos río abajo. Candado simétrico sobre los DOS campos —
+  // con solo directoryId cubierto se podía quitar el @IsNotEmpty() de peopleId sin ponerse rojo.
+  it.each(['directoryId', 'peopleId'])('rechaza %s vacío en vez de dejarlo pasar', async (campo) => {
+    const dto = plainToInstance(SignUpProspectResponse,
+      { directoryId: 'dir-1', peopleId: 'ppl-1', [campo]: '' },
+      { excludeExtraneousValues: true });
+
+    const errors = await validate(dto as object);
+    expect(errors.map((e) => e.property)).toContain(campo);
+  });
+});

package/_test_/unit/kyc/KycByDirectoryResponse.test.ts

@@ -0,0 +1,139 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { KycByDirectoryResponse } from '../../../src/kyc/index';
+
+describe('KycByDirectoryResponse', () => {
+  it('acepta una respuesta completa con datos de persona', async () => {
+    const raw = {
+      consolidated: 'VERIFIED',
+      verificationId: 'ver-1',
+      peopleId: 'ppl-1',
+      metamapFlowId: 'flow-1',
+      verificationStatus: 'COMPLETED',
+      verificationResult: 'VERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z',
+      updateDate: '2026-07-21T10:05:00.000Z',
+      person: {
+        names: 'PAULINA',
+        paternalLastName: 'GARCIA',
+        maternalLastName: 'MICHAUS',
+        curp: 'GAMP981028MDFRCL08',
+        dateOfBirth: '1998-10-28',
+      },
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors).toHaveLength(0);
+    expect(dto.person?.curp).toBe('GAMP981028MDFRCL08');
+  });
+
+  it('acepta una respuesta sin datos de persona (KYC aún sin completar)', async () => {
+    const raw = {
+      consolidated: 'PENDING',
+      verificationId: 'ver-2',
+      peopleId: 'ppl-2',
+      verificationStatus: 'IN_PROGRESS',
+      verificationResult: 'UNVERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z',
+      updateDate: '2026-07-21T10:00:00.000Z',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.person).toBeUndefined();
+  });
+
+  it('rechaza un verificationStatus fuera del enum', async () => {
+    const raw = {
+      consolidated: 'VERIFIED', verificationId: 'v', peopleId: 'p',
+      verificationStatus: 'INVENTADO', verificationResult: 'VERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z', updateDate: '2026-07-21T10:00:00.000Z',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('verificationStatus');
+  });
+
+  // DEC-KYC-015: el 7.3% de las filas de dev trae peopleId vacío, 5 de ellas COMPLETED.
+  // @IsString() lo aceptaría en silencio y la falla aparecería tres pasos más adelante.
+  it('rechaza peopleId vacío en vez de dejarlo pasar', async () => {
+    const raw = {
+      consolidated: 'VERIFIED', verificationId: 'ver-1', peopleId: '',
+      verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z', updateDate: '2026-07-21T10:00:00.000Z',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('peopleId');
+  });
+
+  // DEC-KYC-015: candado simétrico al de peopleId. Sin este caso, alguien puede borrar el
+  // @IsNotEmpty() de verificationId y la suite sigue verde.
+  it('rechaza verificationId vacío en vez de dejarlo pasar', async () => {
+    const raw = {
+      consolidated: 'VERIFIED', verificationId: '', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z', updateDate: '2026-07-21T10:00:00.000Z',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('verificationId');
+  });
+
+  // DEC-KYC-014: "sin verificación" se responde con 404, NO con un consolidated fuera de
+  // RetailKycStatusEnum. Este test es el candado de esa decisión.
+  it('rechaza un consolidated fuera de RetailKycStatusEnum (p.ej. el NONE descartado)', async () => {
+    const raw = {
+      consolidated: 'NONE', verificationId: 'ver-1', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z', updateDate: '2026-07-21T10:00:00.000Z',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('consolidated');
+  });
+
+  // DEC-KYC-016: `verificationResult` está acotado a IdentificationDocumentStatus. Sin este
+  // candado se puede degradar el campo a @IsString() y la suite sigue verde (antipattern
+  // STRING_FOR_ENUM_FIELD). 'COMPLETED' es un valor del OTRO enum — el error de tipeo real.
+  it('rechaza un verificationResult que en realidad es un valor de verificationStatus', async () => {
+    const raw = {
+      consolidated: 'VERIFIED', verificationId: 'ver-1', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'COMPLETED',
+      createDate: '2026-07-21T10:00:00.000Z', updateDate: '2026-07-21T10:00:00.000Z',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('verificationResult');
+  });
+
+  // El ordenamiento del endpoint (spec §6) se apoya en fechas ISO-8601 léxicamente ordenables.
+  // Sin este candado se puede quitar el @IsISO8601() y la suite sigue verde.
+  it.each(['createDate', 'updateDate'])('rechaza %s con formato no ISO-8601', async (campo) => {
+    const raw = {
+      consolidated: 'VERIFIED', verificationId: 'ver-1', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+      createDate: '2026-07-21T10:00:00.000Z', updateDate: '2026-07-21T10:00:00.000Z',
+      [campo]: '21/07/2026',
+    };
+
+    const dto = plainToInstance(KycByDirectoryResponse, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain(campo);
+  });
+});

package/_test_/unit/kyc/KycVerificationChangedV1.test.ts

@@ -0,0 +1,99 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { KycVerificationChangedV1 } from '../../../src/kyc/index';
+
+describe('KycVerificationChangedV1', () => {
+  it('valida el shape que produce el Pipe desde el NewImage', async () => {
+    const raw = {
+      verificationId: 'ver-1',
+      directoryId: 'dir-1',
+      peopleId: 'ppl-1',
+      metamapFlowId: 'flow-1',
+      verificationStatus: 'COMPLETED',
+      verificationResult: 'VERIFIED',
+      updateDate: '2026-07-21T10:05:00.000Z',
+    };
+
+    const dto = plainToInstance(KycVerificationChangedV1, raw, { excludeExtraneousValues: true });
+
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.verificationId).toBe('ver-1');
+  });
+
+  it('rechaza un evento sin directoryId (sin él no hay gate posible)', async () => {
+    const raw = {
+      verificationId: 'ver-1', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+      updateDate: '2026-07-21T10:05:00.000Z',
+    };
+
+    const dto = plainToInstance(KycVerificationChangedV1, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('directoryId');
+  });
+
+  // DEC-KYC-015. El NewImage de DDB puede traer S: "" — pasa como string vacío, no como ausente.
+  it.each(['verificationId', 'directoryId', 'peopleId'])(
+    'rechaza %s vacío (el 7.3% de las filas de dev trae peopleId: "")',
+    async (campo) => {
+      const raw = {
+        verificationId: 'ver-1', directoryId: 'dir-1', peopleId: 'ppl-1',
+        verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+        updateDate: '2026-07-21T10:05:00.000Z',
+        [campo]: '',
+      };
+
+      const dto = plainToInstance(KycVerificationChangedV1, raw, { excludeExtraneousValues: true });
+      const errors = await validate(dto as object);
+
+      expect(errors.map((e) => e.property)).toContain(campo);
+    },
+  );
+
+  // Este es el boundary del Pipe: un estado no reconocido DEBE caer al DLQ, no colarse.
+  // Sin este candado se puede degradar verificationStatus a @IsString() y la suite sigue verde.
+  it('rechaza un verificationStatus fuera del enum', async () => {
+    const raw = {
+      verificationId: 'ver-1', directoryId: 'dir-1', peopleId: 'ppl-1',
+      verificationStatus: 'INVENTADO', verificationResult: 'VERIFIED',
+      updateDate: '2026-07-21T10:05:00.000Z',
+    };
+
+    const dto = plainToInstance(KycVerificationChangedV1, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('verificationStatus');
+  });
+
+  // DEC-KYC-016: `verificationResult` está acotado a IdentificationDocumentStatus. Sin este
+  // candado se puede degradar el campo a @IsString() y la suite sigue verde (antipattern
+  // STRING_FOR_ENUM_FIELD). 'COMPLETED' es un valor del OTRO enum — el error de tipeo real.
+  it('rechaza un verificationResult que en realidad es un valor de verificationStatus', async () => {
+    const raw = {
+      verificationId: 'ver-1', directoryId: 'dir-1', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'COMPLETED',
+      updateDate: '2026-07-21T10:05:00.000Z',
+    };
+
+    const dto = plainToInstance(KycVerificationChangedV1, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('verificationResult');
+  });
+
+  // El consumidor ordena por updateDate (spec §6): sin @IsISO8601() el orden es una asunción.
+  it('rechaza updateDate con formato no ISO-8601', async () => {
+    const raw = {
+      verificationId: 'ver-1', directoryId: 'dir-1', peopleId: 'ppl-1',
+      verificationStatus: 'COMPLETED', verificationResult: 'VERIFIED',
+      updateDate: '21/07/2026',
+    };
+
+    const dto = plainToInstance(KycVerificationChangedV1, raw, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('updateDate');
+  });
+});

package/_test_/unit/messagesConnector/SendMessageRequest.test.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { SendMessageRequest } from '../../../src/messagesConnector/dtos/SendMessageRequest';
+import { DeliveryChannelEnum } from '../../../src/messaging';
+
+/**
+ * Candado: `directoryId` es una LLAVE DE CORRELACIÓN opaca para messages-business (rate-limit + log +
+ * verify), NO una FK a un directorio. Volver a ponerle `@IsUUID()` rompe dos casos productivos:
+ * los cognitoSub UUID v7 (que class-validator rechaza) y el OTP de teléfono del wizard retail, donde
+ * el cliente todavía no tiene identidad Fiado cuando se envía el código.
+ */
+const base = {
+    channelType: DeliveryChannelEnum.SMS,
+    messageType: 'OTP_CODE',
+    typeOfDirectory: 'PHONE',
+    language: 'es',
+    country: 'MX',
+    destination: '4422194128',
+};
+
+const errorsOn = async (directoryId: unknown) => {
+    const dto = plainToInstance(SendMessageRequest, { ...base, directoryId });
+    const errors = await validate(dto);
+    return errors.filter((e) => e.property === 'directoryId');
+};
+
+describe('SendMessageRequest.directoryId', () => {
+    it('acepta un teléfono (OTP del wizard retail: aún no hay identidad Fiado)', async () => {
+        expect(await errorsOn('4422194128')).toHaveLength(0);
+    });
+
+    it('acepta un UUID v7 (cognitoSub de los pools backoffice)', async () => {
+        expect(await errorsOn('01930b5e-7c3a-7f21-9a4e-1c8d5f2b6a90')).toHaveLength(0);
+    });
+
+    it('sigue aceptando un UUID v4 (consumidores legacy)', async () => {
+        expect(await errorsOn('6aeacae2-92ff-4593-8dfe-410f1f4a2ee6')).toHaveLength(0);
+    });
+
+    it('rechaza vacío (la llave de correlación es obligatoria)', async () => {
+        expect(await errorsOn('')).not.toHaveLength(0);
+    });
+
+    it('rechaza un no-string', async () => {
+        expect(await errorsOn(12345)).not.toHaveLength(0);
+    });
+});

package/bin/auth/dtos/SignUpProspectRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 declare class SignUpProspectRequest {
+    name: string;
+    phoneNumber: string;
+    /** Decidido: sin `@Matches(/^[a-z0-9-]+$/)` — `FIADO_BETA` es un tenant real y ese regex lo rechazaría. */
+    tenantId: string;
+}

package/bin/auth/dtos/SignUpProspectRequest.js

@@ -0,0 +1,44 @@
+"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.SignUpProspectRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("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.
+ */
+class SignUpProspectRequest {
+}
+exports.SignUpProspectRequest = SignUpProspectRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SignUpProspectRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SignUpProspectRequest.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SignUpProspectRequest.prototype, "tenantId", void 0);

package/bin/auth/dtos/SignUpProspectResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 declare class SignUpProspectResponse {
+    directoryId: string;
+    peopleId: string;
+}

package/bin/auth/dtos/SignUpProspectResponse.js

@@ -0,0 +1,36 @@
+"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.SignUpProspectResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("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.
+ */
+class SignUpProspectResponse {
+}
+exports.SignUpProspectResponse = SignUpProspectResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SignUpProspectResponse.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SignUpProspectResponse.prototype, "peopleId", void 0);

package/bin/auth/index.d.ts

@@ -3,3 +3,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/bin/auth/index.js

@@ -20,3 +20,5 @@ __exportStar(require("./dtos/ResetPasswordBackofficeRequest"), exports);
 __exportStar(require("./dtos/SignInBackofficeRequest"), exports);
 __exportStar(require("./dtos/SignInBackofficeResponse"), exports);
 __exportStar(require("./dtos/SignUpBackofficeRequest"), exports);
+__exportStar(require("./dtos/SignUpProspectRequest"), exports);
+__exportStar(require("./dtos/SignUpProspectResponse"), exports);

package/bin/index.d.ts

@@ -98,5 +98,6 @@ export * as LoanOfferings from './loanOfferings';
 export * as LoanCollectorAssignment from './loanCollectorAssignment';
 export * as LoanCredit from './loanCredit';
 export * as LoanScoring from './loanScoring';
+export * as Kyc from './kyc';
 export * from './messaging';
 export * from './complaint';

package/bin/index.js

@@ -38,6 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
 exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.LoanConfig = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = void 0;
+exports.Kyc = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -170,5 +171,9 @@ exports.LoanCredit = __importStar(require("./loanCredit"));
 // ScoringProviderRouter configurable Modelias|Círculo con contrato agnóstico ScoringDecision;
 // SureKeep Fase 2 — pista Loan/SOFOM).
 exports.LoanScoring = __importStar(require("./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.
+exports.Kyc = __importStar(require("./kyc"));
 __exportStar(require("./messaging"), exports);
 __exportStar(require("./complaint"), exports);

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

@@ -0,0 +1,49 @@
+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 declare class KycByDirectoryResponse {
+    consolidated: RetailKycStatusEnum;
+    /** La PK de la fila (`id`) mapeada a nombre de negocio. */
+    verificationId: string;
+    /** DEC-KYC-015: `@IsNotEmpty()` — el 7.3% de las filas de dev trae string vacío. */
+    peopleId: string;
+    metamapFlowId?: string;
+    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).
+     */
+    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).
+     */
+    createDate: string;
+    /** ISO-8601 obligatorio — mismo escaneo de dev: 386/386 fechas ISO-8601 (2026-07-21). */
+    updateDate: string;
+    person?: KycPersonData;
+}

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

@@ -0,0 +1,91 @@
+"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.KycByDirectoryResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const IdentificationDocumentStatus_1 = require("../../../identity/enums/IdentificationDocumentStatus");
+const RetailKycStatusEnum_1 = require("../../../retailCustomer/enums/RetailKycStatusEnum");
+const KycVerificationStatusEnum_1 = require("../../enums/KycVerificationStatusEnum");
+const KycPersonData_1 = require("./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).
+ */
+class KycByDirectoryResponse {
+}
+exports.KycByDirectoryResponse = KycByDirectoryResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RetailKycStatusEnum_1.RetailKycStatusEnum),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "consolidated", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "verificationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "peopleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "metamapFlowId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(KycVerificationStatusEnum_1.KycVerificationStatusEnum),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "verificationStatus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(IdentificationDocumentStatus_1.IdentificationDocumentStatus),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "verificationResult", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "createDate", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], KycByDirectoryResponse.prototype, "updateDate", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => KycPersonData_1.KycPersonData),
+    __metadata("design:type", KycPersonData_1.KycPersonData)
+], KycByDirectoryResponse.prototype, "person", void 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/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.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;