@fiado/type-kit 3.248.0 → 3.249.0

package/src/kyc/dtos/KycSubChecks.ts

@@ -1,55 +1,55 @@
-import { Expose } from 'class-transformer';
-import { IsEnum, IsOptional } from 'class-validator';
-import { KycSubCheckStatusEnum } from '../enums/KycSubCheckStatusEnum';
-import { KycWatchlistStatusEnum } from '../enums/KycWatchlistStatusEnum';
-
-/**
- * Los 8 sub-pasos del KYC de Metamap, descompuestos — el resultado de CADA estación, no el
- * veredicto global. Viaja dentro de `KycVerificationChangedV1.subChecks`.
- *
- * **Por qué existe:** hoy el KYC llega como un solo bombillo (VERIFIED/REJECTED). Pero no todo
- * fallo es igual: un facematch fallido es fraude, un hit de watchlist es "que lo mire cumplimiento",
- * una mala foto es un reintento. Descomponerlo deja que SureKeep aplique una política por sub-paso.
- *
- * **El webhook los produce como TRADUCTOR, no como juez:** deriva cada uno de la presencia de
- * `error` en el `step_completed` de Metamap. NO decide qué significa el fallo para la venta —
- * esa política vive del lado de SureKeep (consolidación / oficial de cumplimiento).
- *
- * **Todos opcionales:** un flujo de Metamap puede no correr todas las estaciones. Un campo ausente
- * significa "esa estación no corrió en este flujo", distinto de un `FAIL`.
- *
- * SureKeep Fase 2 — descomposición del KYC en sub-pasos.
- */
-export class KycSubChecks {
-    /** ¿Se leyó bien el documento? Mala foto → FAIL (reintento). */
-    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
-    documentReading?: KycSubCheckStatusEnum;
-
-    /** ¿El documento es una plantilla válida (una INE de verdad)? */
-    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
-    templateMatching?: KycSubCheckStatusEnum;
-
-    /** ¿El documento fue alterado/photoshopeado? FAIL = detectó alteración. */
-    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
-    alterationDetection?: KycSubCheckStatusEnum;
-
-    /** ¿La cara de la selfie coincide con la del documento? FAIL = no coincide (suplantación). */
-    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
-    facematch?: KycSubCheckStatusEnum;
-
-    /** ¿Es una persona viva frente a la cámara y no una foto de una foto? FAIL = no vivo. */
-    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
-    liveness?: KycSubCheckStatusEnum;
-
-    /** ¿Tiene 18 o más? FAIL = menor de edad. */
-    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
-    ageCheck?: KycSubCheckStatusEnum;
-
-    /** ¿Apareció en una watchlist? HIT = apareció → oficial de cumplimiento (NO es rechazo). */
-    @Expose() @IsOptional() @IsEnum(KycWatchlistStatusEnum)
-    watchlists?: KycWatchlistStatusEnum;
-
-    /** ¿Apareció en una lista premium (PEP/sanciones)? HIT → oficial de cumplimiento. */
-    @Expose() @IsOptional() @IsEnum(KycWatchlistStatusEnum)
-    premiumAmlWatchlists?: KycWatchlistStatusEnum;
-}
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional } from 'class-validator';
+import { KycSubCheckStatusEnum } from '../enums/KycSubCheckStatusEnum';
+import { KycWatchlistStatusEnum } from '../enums/KycWatchlistStatusEnum';
+
+/**
+ * Los 8 sub-pasos del KYC de Metamap, descompuestos — el resultado de CADA estación, no el
+ * veredicto global. Viaja dentro de `KycVerificationChangedV1.subChecks`.
+ *
+ * **Por qué existe:** hoy el KYC llega como un solo bombillo (VERIFIED/REJECTED). Pero no todo
+ * fallo es igual: un facematch fallido es fraude, un hit de watchlist es "que lo mire cumplimiento",
+ * una mala foto es un reintento. Descomponerlo deja que SureKeep aplique una política por sub-paso.
+ *
+ * **El webhook los produce como TRADUCTOR, no como juez:** deriva cada uno de la presencia de
+ * `error` en el `step_completed` de Metamap. NO decide qué significa el fallo para la venta —
+ * esa política vive del lado de SureKeep (consolidación / oficial de cumplimiento).
+ *
+ * **Todos opcionales:** un flujo de Metamap puede no correr todas las estaciones. Un campo ausente
+ * significa "esa estación no corrió en este flujo", distinto de un `FAIL`.
+ *
+ * SureKeep Fase 2 — descomposición del KYC en sub-pasos.
+ */
+export class KycSubChecks {
+    /** ¿Se leyó bien el documento? Mala foto → FAIL (reintento). */
+    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
+    documentReading?: KycSubCheckStatusEnum;
+
+    /** ¿El documento es una plantilla válida (una INE de verdad)? */
+    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
+    templateMatching?: KycSubCheckStatusEnum;
+
+    /** ¿El documento fue alterado/photoshopeado? FAIL = detectó alteración. */
+    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
+    alterationDetection?: KycSubCheckStatusEnum;
+
+    /** ¿La cara de la selfie coincide con la del documento? FAIL = no coincide (suplantación). */
+    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
+    facematch?: KycSubCheckStatusEnum;
+
+    /** ¿Es una persona viva frente a la cámara y no una foto de una foto? FAIL = no vivo. */
+    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
+    liveness?: KycSubCheckStatusEnum;
+
+    /** ¿Tiene 18 o más? FAIL = menor de edad. */
+    @Expose() @IsOptional() @IsEnum(KycSubCheckStatusEnum)
+    ageCheck?: KycSubCheckStatusEnum;
+
+    /** ¿Apareció en una watchlist? HIT = apareció → oficial de cumplimiento (NO es rechazo). */
+    @Expose() @IsOptional() @IsEnum(KycWatchlistStatusEnum)
+    watchlists?: KycWatchlistStatusEnum;
+
+    /** ¿Apareció en una lista premium (PEP/sanciones)? HIT → oficial de cumplimiento. */
+    @Expose() @IsOptional() @IsEnum(KycWatchlistStatusEnum)
+    premiumAmlWatchlists?: KycWatchlistStatusEnum;
+}

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

@@ -1,69 +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;
-}
+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

@@ -1,48 +1,48 @@
-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;
-
-    /**
-     * Vigencia del documento de identidad (el `expirationDate` que lee el OCR). Aditivo y opcional:
-     * un mensaje viejo sin el campo sigue validando, y un documento cuyo OCR no la resolvió viaja
-     * sin ella.
-     *
-     * Se usa para mostrarle al vendedor con qué documento se verificó al cliente. NO es un gate:
-     * quién decide si la identidad es válida es el proveedor, no esta fecha.
-     */
-    @Expose() @IsOptional() @IsString()
-    documentExpiresAt?: string;
-
-    /**
-     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — el catálogo del
-     * proveedor, sin traducir).
-     *
-     * 🔴 **Sin esto no se puede nombrar el documento sin adivinar.** La vigencia viajaba sola, así que
-     * el consumidor solo podía escribir "INE" a mano — y el flujo acepta más de un tipo. Con un
-     * pasaporte en la mano, el vendedor leía en pantalla un documento que el cliente no traía.
-     *
-     * Aditivo y opcional: los mensajes que no lo traigan siguen validando, y el consumidor debe poder
-     * mostrar el resumen sin él (mejor no nombrar el documento que nombrar el equivocado).
-     */
-    @Expose() @IsOptional() @IsString()
-    documentType?: string;
-}
+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;
+
+    /**
+     * Vigencia del documento de identidad (el `expirationDate` que lee el OCR). Aditivo y opcional:
+     * un mensaje viejo sin el campo sigue validando, y un documento cuyo OCR no la resolvió viaja
+     * sin ella.
+     *
+     * Se usa para mostrarle al vendedor con qué documento se verificó al cliente. NO es un gate:
+     * quién decide si la identidad es válida es el proveedor, no esta fecha.
+     */
+    @Expose() @IsOptional() @IsString()
+    documentExpiresAt?: string;
+
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — el catálogo del
+     * proveedor, sin traducir).
+     *
+     * 🔴 **Sin esto no se puede nombrar el documento sin adivinar.** La vigencia viajaba sola, así que
+     * el consumidor solo podía escribir "INE" a mano — y el flujo acepta más de un tipo. Con un
+     * pasaporte en la mano, el vendedor leía en pantalla un documento que el cliente no traía.
+     *
+     * Aditivo y opcional: los mensajes que no lo traigan siguen validando, y el consumidor debe poder
+     * mostrar el resumen sin él (mejor no nombrar el documento que nombrar el equivocado).
+     */
+    @Expose() @IsOptional() @IsString()
+    documentType?: string;
+}

package/src/kyc/enums/KycSubCheckNameEnum.ts

@@ -1,36 +1,36 @@
-/**
- * Nombre de la estación del KYC que reporta un `KycStepCompletedV1`.
- *
- * ⚠️ Los VALORES son exactamente las llaves de `KycSubChecks`. No es coincidencia ni estética: el
- * consumidor arma el progreso de la verificación asentando cada estación sobre el acumulado, sin
- * tabla de traducción. Si un valor dejara de coincidir con su llave, el progreso quedaría con un
- * campo huérfano y la estación real nunca se marcaría — una falla muda. Ese acumulado se arma con
- * `applyKycStep`, NO indexando a mano: la asignación directa no compila (los campos de `KycSubChecks`
- * son opcionales) y el cast que la destraba desactiva el candado del vocabulario.
- *
- * Son las 8 del contrato, no las 13 que Metamap puede emitir: las otras (ip-validation, selfie,
- * voice, duplicate-user-detection, curp/ine validation) no forman parte de `KycSubChecks` y por lo
- * tanto no viajan. Ampliar la lista es un cambio de contrato en los dos lados, no un valor más aquí.
- *
- * SureKeep Fase 2 — progreso del KYC estación por estación.
- */
-export enum KycSubCheckNameEnum {
-    DOCUMENT_READING = 'documentReading',
-    TEMPLATE_MATCHING = 'templateMatching',
-    ALTERATION_DETECTION = 'alterationDetection',
-    FACEMATCH = 'facematch',
-    LIVENESS = 'liveness',
-    AGE_CHECK = 'ageCheck',
-    WATCHLISTS = 'watchlists',
-    PREMIUM_AML_WATCHLISTS = 'premiumAmlWatchlists',
-}
-
-/**
- * Las estaciones de LISTA — las únicas cuyo resultado se expresa en `CLEAR`/`HIT`. El resto son
- * binarias (`PASS`/`FAIL`). Se exporta porque el validador del evento y los consumidores necesitan
- * la MISMA partición: duplicarla en cada repo es drift garantizado.
- */
-export const KYC_WATCHLIST_STEPS: readonly KycSubCheckNameEnum[] = [
-    KycSubCheckNameEnum.WATCHLISTS,
-    KycSubCheckNameEnum.PREMIUM_AML_WATCHLISTS,
-];
+/**
+ * Nombre de la estación del KYC que reporta un `KycStepCompletedV1`.
+ *
+ * ⚠️ Los VALORES son exactamente las llaves de `KycSubChecks`. No es coincidencia ni estética: el
+ * consumidor arma el progreso de la verificación asentando cada estación sobre el acumulado, sin
+ * tabla de traducción. Si un valor dejara de coincidir con su llave, el progreso quedaría con un
+ * campo huérfano y la estación real nunca se marcaría — una falla muda. Ese acumulado se arma con
+ * `applyKycStep`, NO indexando a mano: la asignación directa no compila (los campos de `KycSubChecks`
+ * son opcionales) y el cast que la destraba desactiva el candado del vocabulario.
+ *
+ * Son las 8 del contrato, no las 13 que Metamap puede emitir: las otras (ip-validation, selfie,
+ * voice, duplicate-user-detection, curp/ine validation) no forman parte de `KycSubChecks` y por lo
+ * tanto no viajan. Ampliar la lista es un cambio de contrato en los dos lados, no un valor más aquí.
+ *
+ * SureKeep Fase 2 — progreso del KYC estación por estación.
+ */
+export enum KycSubCheckNameEnum {
+    DOCUMENT_READING = 'documentReading',
+    TEMPLATE_MATCHING = 'templateMatching',
+    ALTERATION_DETECTION = 'alterationDetection',
+    FACEMATCH = 'facematch',
+    LIVENESS = 'liveness',
+    AGE_CHECK = 'ageCheck',
+    WATCHLISTS = 'watchlists',
+    PREMIUM_AML_WATCHLISTS = 'premiumAmlWatchlists',
+}
+
+/**
+ * Las estaciones de LISTA — las únicas cuyo resultado se expresa en `CLEAR`/`HIT`. El resto son
+ * binarias (`PASS`/`FAIL`). Se exporta porque el validador del evento y los consumidores necesitan
+ * la MISMA partición: duplicarla en cada repo es drift garantizado.
+ */
+export const KYC_WATCHLIST_STEPS: readonly KycSubCheckNameEnum[] = [
+    KycSubCheckNameEnum.WATCHLISTS,
+    KycSubCheckNameEnum.PREMIUM_AML_WATCHLISTS,
+];

package/src/kyc/enums/KycSubCheckStatusEnum.ts

@@ -1,15 +1,15 @@
-/**
- * Resultado de un sub-paso BINARIO del KYC (los que pasan o fallan sin matices).
- *
- * El webhook lo deriva de la presencia/ausencia de `error` en el `step_completed` de Metamap:
- * sin error → `PASS`, con error → `FAIL`. No hay tri-estado en estos.
- *
- * Aplica a: document-reading, template-matching, alteration-detection, facematch, liveness, age-check.
- * (Las listas de watchlist usan `KycWatchlistStatusEnum` — un hit NO es un fallo.)
- *
- * SureKeep Fase 2 — descomposición del KYC en sub-pasos.
- */
-export enum KycSubCheckStatusEnum {
-    PASS = 'PASS',
-    FAIL = 'FAIL',
-}
+/**
+ * Resultado de un sub-paso BINARIO del KYC (los que pasan o fallan sin matices).
+ *
+ * El webhook lo deriva de la presencia/ausencia de `error` en el `step_completed` de Metamap:
+ * sin error → `PASS`, con error → `FAIL`. No hay tri-estado en estos.
+ *
+ * Aplica a: document-reading, template-matching, alteration-detection, facematch, liveness, age-check.
+ * (Las listas de watchlist usan `KycWatchlistStatusEnum` — un hit NO es un fallo.)
+ *
+ * SureKeep Fase 2 — descomposición del KYC en sub-pasos.
+ */
+export enum KycSubCheckStatusEnum {
+    PASS = 'PASS',
+    FAIL = 'FAIL',
+}

package/src/kyc/enums/KycVerificationStatusEnum.ts

@@ -1,18 +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',
-}
+/**
+ * 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/enums/KycWatchlistStatusEnum.ts

@@ -1,16 +1,16 @@
-/**
- * Resultado de un sub-paso de LISTA del KYC (watchlists, premium-aml-watchlists).
- *
- * Deliberadamente NO reusa `KycSubCheckStatusEnum`: un `HIT` en una lista **no es un fallo**.
- * Es un "que lo mire un humano" — el cliente aparece en una lista y un oficial de cumplimiento (D21)
- * decide, en vez de rechazar automáticamente. Ese matiz es justo lo que el vocabulario binario
- * pasado por alto perdía: si `HIT` fuera `FAIL`, la venta se bloquearía sola sin revisión.
- *
- * `CLEAR` = no apareció en ninguna lista. `HIT` = apareció, requiere revisión de cumplimiento.
- *
- * SureKeep Fase 2 — descomposición del KYC en sub-pasos.
- */
-export enum KycWatchlistStatusEnum {
-    CLEAR = 'CLEAR',
-    HIT = 'HIT',
-}
+/**
+ * Resultado de un sub-paso de LISTA del KYC (watchlists, premium-aml-watchlists).
+ *
+ * Deliberadamente NO reusa `KycSubCheckStatusEnum`: un `HIT` en una lista **no es un fallo**.
+ * Es un "que lo mire un humano" — el cliente aparece en una lista y un oficial de cumplimiento (D21)
+ * decide, en vez de rechazar automáticamente. Ese matiz es justo lo que el vocabulario binario
+ * pasado por alto perdía: si `HIT` fuera `FAIL`, la venta se bloquearía sola sin revisión.
+ *
+ * `CLEAR` = no apareció en ninguna lista. `HIT` = apareció, requiere revisión de cumplimiento.
+ *
+ * SureKeep Fase 2 — descomposición del KYC en sub-pasos.
+ */
+export enum KycWatchlistStatusEnum {
+    CLEAR = 'CLEAR',
+    HIT = 'HIT',
+}