@fiado/type-kit 3.343.0 → 3.344.0

package/bin/identity/dtos/PeopleResponse.d.ts

@@ -114,6 +114,20 @@ export declare class PeopleResponse {
         createdAt: number;
         updatedAt: number;
         CP_Status: CPStatusEnum;
+        /**
+         * Cuándo llegó el ÚLTIMO rechazo de documento de CP (epoch ms). Es el reloj de la ventana
+         * de 24 h: pasada, el estado se cierra a `DOC_REJECTED_DENIED`.
+         *
+         * Se reescribe con cada rechazo nuevo — un reintento fallido reabre la ventana completa, no
+         * hereda el plazo del anterior.
+         */
+        docRejectedAt?: number | null;
+        /**
+         * Link de IDology para volver a escanear el documento, tal como llega en
+         * `payload.additional_data.document_scan_url`. Presente en el 100 % de los rechazos
+         * observados en producción (460 de 460).
+         */
+        docRejectedScanUrl?: string | null;
         status: AccountRequirementStatusEnum;
         observations: string;
         selfieResult: string | null;

package/bin/identity/dtos/PeopleUpdateRequest.d.ts

@@ -105,6 +105,10 @@ export declare class PeopleUpdateRequest {
     documentNumber?: string;
     stateOfDocument?: string;
     CP_Status?: CPStatusEnum;
+    /** Epoch ms del último rechazo de documento de CP. Reloj de la ventana de 24 h. */
+    docRejectedAt?: number | null;
+    /** Link de IDology para volver a escanear el documento (`additional_data.document_scan_url`). */
+    docRejectedScanUrl?: string | null;
     status?: AccountRequirementStatusEnum;
     observations?: string;
     externalReferenceId?: string | null;

package/bin/identity/enums/CPStatusEnum.d.ts

@@ -9,5 +9,42 @@ export declare enum CPStatusEnum {
     DOCUMENT_ERROR = "DOCUMENT_ERROR",
     INCOMPLETE_OOW_ANSWERS = "INCOMPLETE_OOW_ANSWERS",
     OOW_EXPIRED = "OOW_EXPIRED",
+    /**
+     * DOCUMENTO RECHAZADO POR CP — el usuario puede subirlo de nuevo (ventana de 24 h).
+     *
+     * CP manda un solo evento (`cardholder.kyc.document_rejected`) con `kyc_status:
+     * DOCUMENT_REJECTED` para todos los casos; el motivo real viaja como texto libre de IDology en
+     * `payload.kyc_reason_codes[0]`, con los motivos concatenados por "; ". Estos valores son ese
+     * texto mapeado, para que el frontend pueda dar un mensaje concreto en vez de "documento
+     * rechazado" a secas.
+     *
+     * Distribución en producción (460 eventos, 450 personas, ago–oct 2025):
+     *   DOC_TOO_SMALL                       220
+     *   DOC_TOO_SMALL_IMAGE_ERROR           179
+     *   DOC_BAD_RESOLUTION                   30
+     *   DOC_IMAGE_ERROR                       2
+     *   DOC_TOO_SMALL_BARCODE_IMAGE_ERROR     1
+     *
+     * `Invalid Transaction Request` (28 casos) queda FUERA a propósito: es un fallo de la petición
+     * a IDology, no del documento de la persona.
+     */
+    /** "Document Too Small" */
+    DOC_TOO_SMALL = "DOC_TOO_SMALL",
+    /** "Document Too Small; Image Error" */
+    DOC_TOO_SMALL_IMAGE_ERROR = "DOC_TOO_SMALL_IMAGE_ERROR",
+    /** "Image size is not within specified resolutions." */
+    DOC_BAD_RESOLUTION = "DOC_BAD_RESOLUTION",
+    /** "Image Error" */
+    DOC_IMAGE_ERROR = "DOC_IMAGE_ERROR",
+    /** "Document Too Small; Barcode Not Detected; Image Error" */
+    DOC_TOO_SMALL_BARCODE_IMAGE_ERROR = "DOC_TOO_SMALL_BARCODE_IMAGE_ERROR",
+    /**
+     * Venció la ventana de 24 h para volver a subir el documento.
+     *
+     * Es UNO solo para los cinco motivos de arriba: pasado el plazo el usuario ya no puede
+     * reintentar, así que cuál era el problema de la foto deja de importar — el mensaje es el mismo.
+     * Cinco variantes `_DENIED` serían cinco copys idénticos.
+     */
+    DOC_REJECTED_DENIED = "DOC_REJECTED_DENIED",
     NONE = "NONE"
 }

package/bin/identity/enums/CPStatusEnum.js

@@ -13,5 +13,42 @@ var CPStatusEnum;
     CPStatusEnum["DOCUMENT_ERROR"] = "DOCUMENT_ERROR";
     CPStatusEnum["INCOMPLETE_OOW_ANSWERS"] = "INCOMPLETE_OOW_ANSWERS";
     CPStatusEnum["OOW_EXPIRED"] = "OOW_EXPIRED";
+    /**
+     * DOCUMENTO RECHAZADO POR CP — el usuario puede subirlo de nuevo (ventana de 24 h).
+     *
+     * CP manda un solo evento (`cardholder.kyc.document_rejected`) con `kyc_status:
+     * DOCUMENT_REJECTED` para todos los casos; el motivo real viaja como texto libre de IDology en
+     * `payload.kyc_reason_codes[0]`, con los motivos concatenados por "; ". Estos valores son ese
+     * texto mapeado, para que el frontend pueda dar un mensaje concreto en vez de "documento
+     * rechazado" a secas.
+     *
+     * Distribución en producción (460 eventos, 450 personas, ago–oct 2025):
+     *   DOC_TOO_SMALL                       220
+     *   DOC_TOO_SMALL_IMAGE_ERROR           179
+     *   DOC_BAD_RESOLUTION                   30
+     *   DOC_IMAGE_ERROR                       2
+     *   DOC_TOO_SMALL_BARCODE_IMAGE_ERROR     1
+     *
+     * `Invalid Transaction Request` (28 casos) queda FUERA a propósito: es un fallo de la petición
+     * a IDology, no del documento de la persona.
+     */
+    /** "Document Too Small" */
+    CPStatusEnum["DOC_TOO_SMALL"] = "DOC_TOO_SMALL";
+    /** "Document Too Small; Image Error" */
+    CPStatusEnum["DOC_TOO_SMALL_IMAGE_ERROR"] = "DOC_TOO_SMALL_IMAGE_ERROR";
+    /** "Image size is not within specified resolutions." */
+    CPStatusEnum["DOC_BAD_RESOLUTION"] = "DOC_BAD_RESOLUTION";
+    /** "Image Error" */
+    CPStatusEnum["DOC_IMAGE_ERROR"] = "DOC_IMAGE_ERROR";
+    /** "Document Too Small; Barcode Not Detected; Image Error" */
+    CPStatusEnum["DOC_TOO_SMALL_BARCODE_IMAGE_ERROR"] = "DOC_TOO_SMALL_BARCODE_IMAGE_ERROR";
+    /**
+     * Venció la ventana de 24 h para volver a subir el documento.
+     *
+     * Es UNO solo para los cinco motivos de arriba: pasado el plazo el usuario ya no puede
+     * reintentar, así que cuál era el problema de la foto deja de importar — el mensaje es el mismo.
+     * Cinco variantes `_DENIED` serían cinco copys idénticos.
+     */
+    CPStatusEnum["DOC_REJECTED_DENIED"] = "DOC_REJECTED_DENIED";
     CPStatusEnum["NONE"] = "NONE";
 })(CPStatusEnum || (exports.CPStatusEnum = CPStatusEnum = {}));

package/bin/onboarding/enums/OnboardingAccountStatusEnum.d.ts

@@ -27,6 +27,23 @@ export declare enum OnboardingAccountStatusEnum {
      * Se deriva de `CP_Status === PENDING_OOW_QUESTIONS`.
      */
     PENDING_OOW_QUESTIONS = "PENDING_OOW_QUESTIONS",
+    /**
+     * CP rechazó el documento y el usuario puede subir otra foto (ventana de 24 h).
+     *
+     * Son cinco estados y no uno porque el motivo cambia el mensaje: "salió muy chica" no es lo
+     * mismo que "no se pudo leer". El texto original de IDology se mapea en
+     * `documentRejection.ts` (onboarding-business).
+     *
+     * Cuando llega alguno de estos, `reason` trae el LINK de IDology para reescanear el documento
+     * (`document_scan_url`), no un motivo del catálogo.
+     */
+    DOC_TOO_SMALL = "DOC_TOO_SMALL",
+    DOC_TOO_SMALL_IMAGE_ERROR = "DOC_TOO_SMALL_IMAGE_ERROR",
+    DOC_BAD_RESOLUTION = "DOC_BAD_RESOLUTION",
+    DOC_IMAGE_ERROR = "DOC_IMAGE_ERROR",
+    DOC_TOO_SMALL_BARCODE_IMAGE_ERROR = "DOC_TOO_SMALL_BARCODE_IMAGE_ERROR",
+    /** Venció la ventana de 24 h: ya no puede reintentar. Uno solo para los cinco motivos. */
+    DOC_REJECTED_DENIED = "DOC_REJECTED_DENIED",
     REJECTED = "REJECTED",
     OPEN = "OPEN"
 }

package/bin/onboarding/enums/OnboardingAccountStatusEnum.js

@@ -31,6 +31,23 @@ var OnboardingAccountStatusEnum;
      * Se deriva de `CP_Status === PENDING_OOW_QUESTIONS`.
      */
     OnboardingAccountStatusEnum["PENDING_OOW_QUESTIONS"] = "PENDING_OOW_QUESTIONS";
+    /**
+     * CP rechazó el documento y el usuario puede subir otra foto (ventana de 24 h).
+     *
+     * Son cinco estados y no uno porque el motivo cambia el mensaje: "salió muy chica" no es lo
+     * mismo que "no se pudo leer". El texto original de IDology se mapea en
+     * `documentRejection.ts` (onboarding-business).
+     *
+     * Cuando llega alguno de estos, `reason` trae el LINK de IDology para reescanear el documento
+     * (`document_scan_url`), no un motivo del catálogo.
+     */
+    OnboardingAccountStatusEnum["DOC_TOO_SMALL"] = "DOC_TOO_SMALL";
+    OnboardingAccountStatusEnum["DOC_TOO_SMALL_IMAGE_ERROR"] = "DOC_TOO_SMALL_IMAGE_ERROR";
+    OnboardingAccountStatusEnum["DOC_BAD_RESOLUTION"] = "DOC_BAD_RESOLUTION";
+    OnboardingAccountStatusEnum["DOC_IMAGE_ERROR"] = "DOC_IMAGE_ERROR";
+    OnboardingAccountStatusEnum["DOC_TOO_SMALL_BARCODE_IMAGE_ERROR"] = "DOC_TOO_SMALL_BARCODE_IMAGE_ERROR";
+    /** Venció la ventana de 24 h: ya no puede reintentar. Uno solo para los cinco motivos. */
+    OnboardingAccountStatusEnum["DOC_REJECTED_DENIED"] = "DOC_REJECTED_DENIED";
     OnboardingAccountStatusEnum["REJECTED"] = "REJECTED";
     OnboardingAccountStatusEnum["OPEN"] = "OPEN";
 })(OnboardingAccountStatusEnum || (exports.OnboardingAccountStatusEnum = OnboardingAccountStatusEnum = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.343.0",
+  "version": "3.344.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/identity/dtos/PeopleResponse.ts

@@ -120,6 +120,20 @@ export class PeopleResponse {
         createdAt:number,
         updatedAt:number,
         CP_Status:CPStatusEnum,
+        /**
+         * Cuándo llegó el ÚLTIMO rechazo de documento de CP (epoch ms). Es el reloj de la ventana
+         * de 24 h: pasada, el estado se cierra a `DOC_REJECTED_DENIED`.
+         *
+         * Se reescribe con cada rechazo nuevo — un reintento fallido reabre la ventana completa, no
+         * hereda el plazo del anterior.
+         */
+        docRejectedAt?:number | null,
+        /**
+         * Link de IDology para volver a escanear el documento, tal como llega en
+         * `payload.additional_data.document_scan_url`. Presente en el 100 % de los rechazos
+         * observados en producción (460 de 460).
+         */
+        docRejectedScanUrl?:string | null,
         status:AccountRequirementStatusEnum,
         observations:string,
         selfieResult:string | null;

package/src/identity/dtos/PeopleUpdateRequest.ts

@@ -112,6 +112,10 @@ export class PeopleUpdateRequest {
     documentNumber?: string;
     stateOfDocument?: string;
     CP_Status?: CPStatusEnum;
+    /** Epoch ms del último rechazo de documento de CP. Reloj de la ventana de 24 h. */
+    docRejectedAt?: number | null;
+    /** Link de IDology para volver a escanear el documento (`additional_data.document_scan_url`). */
+    docRejectedScanUrl?: string | null;
     status?: AccountRequirementStatusEnum;
     observations?: string
     externalReferenceId?: string | null;

package/src/identity/enums/CPStatusEnum.ts

@@ -9,5 +9,45 @@ export  enum CPStatusEnum {
     DOCUMENT_ERROR = "DOCUMENT_ERROR",
     INCOMPLETE_OOW_ANSWERS = "INCOMPLETE_OOW_ANSWERS",
     OOW_EXPIRED = "OOW_EXPIRED",
+
+    /**
+     * DOCUMENTO RECHAZADO POR CP — el usuario puede subirlo de nuevo (ventana de 24 h).
+     *
+     * CP manda un solo evento (`cardholder.kyc.document_rejected`) con `kyc_status:
+     * DOCUMENT_REJECTED` para todos los casos; el motivo real viaja como texto libre de IDology en
+     * `payload.kyc_reason_codes[0]`, con los motivos concatenados por "; ". Estos valores son ese
+     * texto mapeado, para que el frontend pueda dar un mensaje concreto en vez de "documento
+     * rechazado" a secas.
+     *
+     * Distribución en producción (460 eventos, 450 personas, ago–oct 2025):
+     *   DOC_TOO_SMALL                       220
+     *   DOC_TOO_SMALL_IMAGE_ERROR           179
+     *   DOC_BAD_RESOLUTION                   30
+     *   DOC_IMAGE_ERROR                       2
+     *   DOC_TOO_SMALL_BARCODE_IMAGE_ERROR     1
+     *
+     * `Invalid Transaction Request` (28 casos) queda FUERA a propósito: es un fallo de la petición
+     * a IDology, no del documento de la persona.
+     */
+    /** "Document Too Small" */
+    DOC_TOO_SMALL = "DOC_TOO_SMALL",
+    /** "Document Too Small; Image Error" */
+    DOC_TOO_SMALL_IMAGE_ERROR = "DOC_TOO_SMALL_IMAGE_ERROR",
+    /** "Image size is not within specified resolutions." */
+    DOC_BAD_RESOLUTION = "DOC_BAD_RESOLUTION",
+    /** "Image Error" */
+    DOC_IMAGE_ERROR = "DOC_IMAGE_ERROR",
+    /** "Document Too Small; Barcode Not Detected; Image Error" */
+    DOC_TOO_SMALL_BARCODE_IMAGE_ERROR = "DOC_TOO_SMALL_BARCODE_IMAGE_ERROR",
+
+    /**
+     * Venció la ventana de 24 h para volver a subir el documento.
+     *
+     * Es UNO solo para los cinco motivos de arriba: pasado el plazo el usuario ya no puede
+     * reintentar, así que cuál era el problema de la foto deja de importar — el mensaje es el mismo.
+     * Cinco variantes `_DENIED` serían cinco copys idénticos.
+     */
+    DOC_REJECTED_DENIED = "DOC_REJECTED_DENIED",
+
     NONE = "NONE"
 }

package/src/onboarding/enums/OnboardingAccountStatusEnum.ts

@@ -27,6 +27,23 @@ export enum OnboardingAccountStatusEnum {
      * Se deriva de `CP_Status === PENDING_OOW_QUESTIONS`.
      */
     PENDING_OOW_QUESTIONS = 'PENDING_OOW_QUESTIONS',
+    /**
+     * CP rechazó el documento y el usuario puede subir otra foto (ventana de 24 h).
+     *
+     * Son cinco estados y no uno porque el motivo cambia el mensaje: "salió muy chica" no es lo
+     * mismo que "no se pudo leer". El texto original de IDology se mapea en
+     * `documentRejection.ts` (onboarding-business).
+     *
+     * Cuando llega alguno de estos, `reason` trae el LINK de IDology para reescanear el documento
+     * (`document_scan_url`), no un motivo del catálogo.
+     */
+    DOC_TOO_SMALL = 'DOC_TOO_SMALL',
+    DOC_TOO_SMALL_IMAGE_ERROR = 'DOC_TOO_SMALL_IMAGE_ERROR',
+    DOC_BAD_RESOLUTION = 'DOC_BAD_RESOLUTION',
+    DOC_IMAGE_ERROR = 'DOC_IMAGE_ERROR',
+    DOC_TOO_SMALL_BARCODE_IMAGE_ERROR = 'DOC_TOO_SMALL_BARCODE_IMAGE_ERROR',
+    /** Venció la ventana de 24 h: ya no puede reintentar. Uno solo para los cinco motivos. */
+    DOC_REJECTED_DENIED = 'DOC_REJECTED_DENIED',
     REJECTED = 'REJECTED',
     OPEN = 'OPEN',
 }