@fiado/type-kit 3.204.0 → 3.206.0

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

@@ -32,6 +32,8 @@ export declare class LoanCredit {
     totalToPayCents: number;
     /** CAT decimal (`3.85` = 385%) — lo calcula el simulador de loan-offerings (C3/AS-01). */
     catAnnual?: number;
+    /** Id de la evaluación SCI referenciada al originar (snapshot en LoanSciEvaluation_GT). */
+    sciEvaluationId?: string;
     /** Sesión del wizard que originó — clave de idempotencia del originate (AS-07). */
     wizardSessionId?: string;
     /** IMEI del equipo financiado (se fija en el enrolamiento MDM). */

package/bin/loanCredit/dtos/LoanCredit.js

@@ -109,6 +109,12 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], LoanCredit.prototype, "catAnnual", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], LoanCredit.prototype, "sciEvaluationId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -17,7 +17,13 @@ export declare class OriginateLoanCreditRequest {
     termWeeks: number;
     equipmentPriceCents: number;
     downPaymentCents: number;
-    /** SCI del cliente al originar (snapshot de la evaluación del paso 05). */
+    /**
+     * Id de la evaluación SCI del paso 05 (snapshot inmutable en loan-scoring). Si viene, el
+     * motor LEE el snapshot (getSciEvaluation), valida la decisión (REJECTED → 422
+     * SCORE_ADVERSE) y persiste score/nivel DESDE el snapshot — ignora los campos sueltos.
+     */
+    sciEvaluationId?: string;
+    /** SCI del cliente al originar (fallback informativo si NO viene sciEvaluationId). */
     sciAtOrigination?: number;
     clientLevelAtOrigination?: ClientLevelEnum;
     /** IMEI del equipo si ya se conoce (también puede fijarse en el paso 09 vía activate-check). */

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

@@ -63,6 +63,12 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], OriginateLoanCreditRequest.prototype, "downPaymentCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "sciEvaluationId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -25,6 +25,7 @@ export interface LoanCreditResponse {
         imeiEnrolled: boolean;
         lockVerified: boolean;
     };
+    sciEvaluationId?: string;
     sciAtOrigination?: number;
     clientLevelAtOrigination?: ClientLevelEnum;
     activatedAt?: string;

package/bin/retailWizard/dtos/responses/KycPrepareResponse.d.ts

@@ -0,0 +1,59 @@
+import { KycModalityEnum } from '../../../retailCustomer/enums/KycModalityEnum';
+/**
+ * Metadata que el wizard entrega al SDK de Metamap para que la verificación quede correlacionada
+ * con la identidad Fiado. Viaja base64 dentro de `KycPrepareResponse.metadata`.
+ *
+ * **La arma el wizard, no el front** (`loan-backoffice-webapp/.env.example`): el front no conoce
+ * `peopleId` ni `typeOfDirectoryId` — los resuelve el wizard al crear/reusar la identidad.
+ *
+ * Espeja `kyc-verifications-business/src/core/entities/Metadata.ts`. Es la ÚNICA correlación entre
+ * la verificación de Metamap y el cliente Fiado: el webhook crea la fila desde acá (D18/D19).
+ *
+ * ⚠️ `typeOfDocumentId` e `isPartial` van OPCIONALES a propósito: el tipo del productor los declara
+ * requeridos, pero están ausentes en el 100% de los 311 bloques de metadata observados en dev
+ * (spec KYC F2 §14.1). Todo indica que los completa el SDK/backend de Metamap. Marcarlos requeridos
+ * acá obligaría al wizard a inventar valores. Se cierra cuando el dueño del SDK lo confirme.
+ */
+export interface KycSdkMetadata {
+    directoryId: string;
+    typeOfDirectoryId: string;
+    peopleId: string;
+    countryId: string;
+    phoneNumber: string;
+    typeOfDocumentId?: string;
+    isPartial?: boolean;
+    customInput?: boolean;
+    userPhotoLink?: string;
+    userPhotoLinkHash?: string;
+}
+/**
+ * POST /wizard/sessions/:id/kyc/prepare — respuesta.
+ *
+ * **Bifurca por modalidad**, por eso todo es opcional salvo `modality`:
+ * - `STORE_DEVICE` → `clientId` + `flowId` + `metadata` para que el front monte el
+ *   `<metamap-button>` en la tablet. Única excepción a la regla puente (D25): el widget es un SDK
+ *   de un SaaS de terceros que corre en el dispositivo del cliente y habla con Metamap, no con Fiado.
+ * - `CUSTOMER_LINK` → `shortUrl` para el QR / SMS al teléfono del cliente.
+ *
+ * `alreadyVerified` corta el flujo antes de cualquiera de las dos: cuando la consolidación del spec
+ * KYC F2 §8.2 ya da `VERIFIED` para ese directorio, no hay identidad que capturar.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface KycPrepareResponse {
+    /**
+     * `MANUAL` NO es una modalidad de `prepare`: la captura manual es su propio endpoint
+     * (`KycManualRequest`). Por eso el tipo se estrecha a las dos que el SDK puede ejecutar.
+     */
+    modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** STORE_DEVICE — clientId de la cuenta Metamap (mismo valor en prod y dev). */
+    clientId?: string;
+    /** STORE_DEVICE — flow de Metamap por país; sale de la configuración del wizard. */
+    flowId?: string;
+    /** STORE_DEVICE — `KycSdkMetadata` serializada en base64. */
+    metadata?: string;
+    /** CUSTOMER_LINK — link corto para el QR o el SMS. */
+    shortUrl?: string;
+    /** El cliente ya tiene una identidad verificada vigente: no hay nada que capturar. */
+    alreadyVerified?: boolean;
+}

package/bin/retailWizard/dtos/responses/KycPrepareResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailWizard/index.d.ts

@@ -49,6 +49,7 @@ export * from './dtos/requests/CreateProspectRequest';
 export * from './dtos/requests/UpdateProspectRequest';
 export * from './dtos/requests/MarkProspectLostRequest';
 export * from './dtos/requests/CancelSaleRequest';
+export * from './dtos/responses/KycPrepareResponse';
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SessionExpiredV1';

package/bin/retailWizard/index.js

@@ -70,6 +70,8 @@ __exportStar(require("./dtos/requests/CreateProspectRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateProspectRequest"), exports);
 __exportStar(require("./dtos/requests/MarkProspectLostRequest"), exports);
 __exportStar(require("./dtos/requests/CancelSaleRequest"), exports);
+// Response DTOs (output tipado por endpoint)
+__exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/SaleCompletedV1"), exports);
 __exportStar(require("./events/SaleCancelledV1"), exports);

package/package.json

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

package/src/loanCredit/dtos/LoanCredit.ts

@@ -98,6 +98,12 @@ export class LoanCredit {
     @Min(0)
     catAnnual?: number;
 
+    /** Id de la evaluación SCI referenciada al originar (snapshot en LoanSciEvaluation_GT). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    sciEvaluationId?: string;
+
     /** Sesión del wizard que originó — clave de idempotencia del originate (AS-07). */
     @Expose()
     @IsOptional()

package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts

@@ -53,7 +53,17 @@ export class OriginateLoanCreditRequest {
     @Min(0)
     downPaymentCents!: number;
 
-    /** SCI del cliente al originar (snapshot de la evaluación del paso 05). */
+    /**
+     * Id de la evaluación SCI del paso 05 (snapshot inmutable en loan-scoring). Si viene, el
+     * motor LEE el snapshot (getSciEvaluation), valida la decisión (REJECTED → 422
+     * SCORE_ADVERSE) y persiste score/nivel DESDE el snapshot — ignora los campos sueltos.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    sciEvaluationId?: string;
+
+    /** SCI del cliente al originar (fallback informativo si NO viene sciEvaluationId). */
     @Expose()
     @IsOptional()
     @IsInt()

package/src/loanCredit/dtos/responses/LoanCreditResponse.ts

@@ -26,6 +26,7 @@ export interface LoanCreditResponse {
         imeiEnrolled: boolean;
         lockVerified: boolean;
     };
+    sciEvaluationId?: string;
     sciAtOrigination?: number;
     clientLevelAtOrigination?: ClientLevelEnum;
     activatedAt?: string;

package/src/retailWizard/dtos/responses/KycPrepareResponse.ts

@@ -0,0 +1,61 @@
+import { KycModalityEnum } from '../../../retailCustomer/enums/KycModalityEnum';
+
+/**
+ * Metadata que el wizard entrega al SDK de Metamap para que la verificación quede correlacionada
+ * con la identidad Fiado. Viaja base64 dentro de `KycPrepareResponse.metadata`.
+ *
+ * **La arma el wizard, no el front** (`loan-backoffice-webapp/.env.example`): el front no conoce
+ * `peopleId` ni `typeOfDirectoryId` — los resuelve el wizard al crear/reusar la identidad.
+ *
+ * Espeja `kyc-verifications-business/src/core/entities/Metadata.ts`. Es la ÚNICA correlación entre
+ * la verificación de Metamap y el cliente Fiado: el webhook crea la fila desde acá (D18/D19).
+ *
+ * ⚠️ `typeOfDocumentId` e `isPartial` van OPCIONALES a propósito: el tipo del productor los declara
+ * requeridos, pero están ausentes en el 100% de los 311 bloques de metadata observados en dev
+ * (spec KYC F2 §14.1). Todo indica que los completa el SDK/backend de Metamap. Marcarlos requeridos
+ * acá obligaría al wizard a inventar valores. Se cierra cuando el dueño del SDK lo confirme.
+ */
+export interface KycSdkMetadata {
+    directoryId: string;
+    typeOfDirectoryId: string;
+    peopleId: string;
+    countryId: string;
+    phoneNumber: string;
+    typeOfDocumentId?: string;
+    isPartial?: boolean;
+    customInput?: boolean;
+    userPhotoLink?: string;
+    userPhotoLinkHash?: string;
+}
+
+/**
+ * POST /wizard/sessions/:id/kyc/prepare — respuesta.
+ *
+ * **Bifurca por modalidad**, por eso todo es opcional salvo `modality`:
+ * - `STORE_DEVICE` → `clientId` + `flowId` + `metadata` para que el front monte el
+ *   `<metamap-button>` en la tablet. Única excepción a la regla puente (D25): el widget es un SDK
+ *   de un SaaS de terceros que corre en el dispositivo del cliente y habla con Metamap, no con Fiado.
+ * - `CUSTOMER_LINK` → `shortUrl` para el QR / SMS al teléfono del cliente.
+ *
+ * `alreadyVerified` corta el flujo antes de cualquiera de las dos: cuando la consolidación del spec
+ * KYC F2 §8.2 ya da `VERIFIED` para ese directorio, no hay identidad que capturar.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface KycPrepareResponse {
+    /**
+     * `MANUAL` NO es una modalidad de `prepare`: la captura manual es su propio endpoint
+     * (`KycManualRequest`). Por eso el tipo se estrecha a las dos que el SDK puede ejecutar.
+     */
+    modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** STORE_DEVICE — clientId de la cuenta Metamap (mismo valor en prod y dev). */
+    clientId?: string;
+    /** STORE_DEVICE — flow de Metamap por país; sale de la configuración del wizard. */
+    flowId?: string;
+    /** STORE_DEVICE — `KycSdkMetadata` serializada en base64. */
+    metadata?: string;
+    /** CUSTOMER_LINK — link corto para el QR o el SMS. */
+    shortUrl?: string;
+    /** El cliente ya tiene una identidad verificada vigente: no hay nada que capturar. */
+    alreadyVerified?: boolean;
+}

package/src/retailWizard/index.ts

@@ -59,6 +59,9 @@ export * from './dtos/requests/UpdateProspectRequest';
 export * from './dtos/requests/MarkProspectLostRequest';
 export * from './dtos/requests/CancelSaleRequest';
 
+// Response DTOs (output tipado por endpoint)
+export * from './dtos/responses/KycPrepareResponse';
+
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';