@fiado/type-kit 3.609.0 → 3.611.0

package/bin/kyc/events/KycStepCompletedV1.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KycStepCompletedV1 = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const KycFlowEnum_1 = require("../enums/KycFlowEnum");
 const KycSubCheckNameEnum_1 = require("../enums/KycSubCheckNameEnum");
 const IsKycStepStatusByStep_1 = require("../validators/IsKycStepStatusByStep");
 /**
@@ -91,3 +92,16 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], KycStepCompletedV1.prototype, "metamapFlowId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycStepCompletedV1.prototype, "attemptId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(KycFlowEnum_1.KycFlowEnum),
+    __metadata("design:type", String)
+], KycStepCompletedV1.prototype, "flow", void 0);

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

@@ -71,4 +71,6 @@ export declare class KycVerificationChangedV1 {
      * degradación segura (el consumidor lo pide y lo guarda él).
      */
     addressPushedToFiado?: boolean;
+    /** Intento del wizard que originó la verificación; el consumidor descarta los que no son el vigente. */
+    attemptId?: string;
 }

package/bin/kyc/events/KycVerificationChangedV1.js

@@ -104,3 +104,10 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], KycVerificationChangedV1.prototype, "addressPushedToFiado", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationChangedV1.prototype, "attemptId", void 0);

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

@@ -0,0 +1,14 @@
+import { KycFlowEnum } from '../enums/KycFlowEnum';
+import { KycProgressStageEnum } from '../enums/KycProgressStageEnum';
+/** Avance de una verificación de Metamap (started, inputs_completed, expired) que publica `kyc-metamap-webhook`. */
+export declare class KycVerificationProgressV1 {
+    eventType: 'KycVerificationProgressV1';
+    stage: KycProgressStageEnum;
+    flow: KycFlowEnum;
+    verificationId: string;
+    directoryId: string;
+    /** Intento del wizard que originó la verificación; ausente en sesiones previas al despliegue. */
+    attemptId?: string;
+    /** ISO-8601 en UTC con `Z`, igual que los demás eventos de la cola. */
+    occurredAt: string;
+}

package/bin/kyc/events/KycVerificationProgressV1.js

@@ -0,0 +1,63 @@
+"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.KycVerificationProgressV1 = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const KycFlowEnum_1 = require("../enums/KycFlowEnum");
+const KycProgressStageEnum_1 = require("../enums/KycProgressStageEnum");
+/** Avance de una verificación de Metamap (started, inputs_completed, expired) que publica `kyc-metamap-webhook`. */
+class KycVerificationProgressV1 {
+}
+exports.KycVerificationProgressV1 = KycVerificationProgressV1;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsIn)(['KycVerificationProgressV1']),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "eventType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(KycProgressStageEnum_1.KycProgressStageEnum),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "stage", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(KycFlowEnum_1.KycFlowEnum),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "flow", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "verificationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "attemptId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/, {
+        message: 'occurredAt debe ser ISO-8601 en UTC con Z (ej. 2026-10-28T10:05:00.000Z)',
+    }),
+    __metadata("design:type", String)
+], KycVerificationProgressV1.prototype, "occurredAt", void 0);

package/bin/kyc/index.d.ts

@@ -3,6 +3,8 @@ export * from './enums/KycSubCheckStatusEnum';
 export * from './enums/KycWatchlistStatusEnum';
 export * from './enums/KycSubCheckNameEnum';
 export * from './enums/ProofAddressStatusEnum';
+export * from './enums/KycProgressStageEnum';
+export * from './enums/KycFlowEnum';
 export * from './dtos/KycSubChecks';
 export * from './validators/IsKycStepStatusByStep';
 export * from './helpers/applyKycStep';
@@ -12,3 +14,4 @@ export * from './dtos/responses/KycByDirectoryResponse';
 export * from './events/KycVerificationChangedV1';
 export * from './events/KycStepCompletedV1';
 export * from './events/KycProofOfAddressCompletedV1';
+export * from './events/KycVerificationProgressV1';

package/bin/kyc/index.js

@@ -21,6 +21,8 @@ __exportStar(require("./enums/KycSubCheckStatusEnum"), exports);
 __exportStar(require("./enums/KycWatchlistStatusEnum"), exports);
 __exportStar(require("./enums/KycSubCheckNameEnum"), exports);
 __exportStar(require("./enums/ProofAddressStatusEnum"), exports);
+__exportStar(require("./enums/KycProgressStageEnum"), exports);
+__exportStar(require("./enums/KycFlowEnum"), exports);
 // Sub-pasos descompuestos (SureKeep F2)
 __exportStar(require("./dtos/KycSubChecks"), exports);
 // Validators
@@ -36,3 +38,4 @@ __exportStar(require("./dtos/responses/KycByDirectoryResponse"), exports);
 __exportStar(require("./events/KycVerificationChangedV1"), exports);
 __exportStar(require("./events/KycStepCompletedV1"), exports);
 __exportStar(require("./events/KycProofOfAddressCompletedV1"), exports);
+__exportStar(require("./events/KycVerificationProgressV1"), exports);

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

@@ -0,0 +1,9 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+/** Documento del ciclo de vida de un crédito, visto por su acreditado. */
+export interface LoanCustomerCreditDocument {
+    documentType: ContractTypeEnum;
+    /** Llave del documento: el paymentId en un comprobante, el periodo `YYYY-MM` en un estado de cuenta. */
+    documentKey: string;
+    /** ISO-8601; `null` mientras el PDF no se haya generado. */
+    generatedAt: string | null;
+}

package/bin/loanCredit/dtos/responses/LoanCustomerCreditDocument.js

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

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

@@ -0,0 +1,9 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+/** Enlace prefirmado y temporal del PDF de un documento del ciclo de vida. `expiresAt` en ISO-8601. */
+export interface LoanCustomerCreditDocumentUrl {
+    creditId: string;
+    documentType: ContractTypeEnum;
+    documentKey: string;
+    url: string;
+    expiresAt: string;
+}

package/bin/loanCredit/dtos/responses/LoanCustomerCreditDocumentUrl.js

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

package/bin/loanCredit/index.d.ts

@@ -42,6 +42,8 @@ export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
+export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';

package/bin/loanCredit/index.js

@@ -66,6 +66,8 @@ __exportStar(require("./dtos/responses/LoanPaymentListItem"), exports);
 __exportStar(require("./dtos/responses/LoanContractDownloadUrl"), exports);
 __exportStar(require("./dtos/responses/LoanContractPreview"), exports);
 __exportStar(require("./dtos/responses/LoanContractResponse"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerCreditDocument"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerCreditDocumentUrl"), exports);
 __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/SignLoanCreditResponse"), exports);

package/bin/retailLoan/dtos/MyDocument.d.ts

@@ -4,7 +4,8 @@ import { MyDocumentKindEnum } from '../enums/MyDocumentKindEnum';
 import { MyDocumentStatusEnum } from '../enums/MyDocumentStatusEnum';
 /**
  * Un documento del crédito. `documentRef` sigue la convención del módulo de la app:
- * `doc-contract-<contractId>` para contratos y `doc-stmt-YYYY-MM` para estados de cuenta.
+ * `doc-contract-<contractId>` para contratos, `doc-stmt-YYYY-MM` para estados de cuenta y
+ * `doc-receipt-<paymentId>` para comprobantes de pago.
  */
 export interface MyDocument {
     documentRef: string;

package/bin/retailLoan/enums/MyDocumentGroupIdEnum.d.ts

@@ -1,5 +1,6 @@
 /** Ids de grupo que exige el módulo de la app (`DocumentGroupList`): minúsculas a propósito. */
 export declare enum MyDocumentGroupIdEnum {
     CONTRACT = "contract",
-    MONTHLY = "monthly"
+    MONTHLY = "monthly",
+    PAYMENT_RECEIPTS = "receipts"
 }

package/bin/retailLoan/enums/MyDocumentGroupIdEnum.js

@@ -6,4 +6,5 @@ var MyDocumentGroupIdEnum;
 (function (MyDocumentGroupIdEnum) {
     MyDocumentGroupIdEnum["CONTRACT"] = "contract";
     MyDocumentGroupIdEnum["MONTHLY"] = "monthly";
+    MyDocumentGroupIdEnum["PAYMENT_RECEIPTS"] = "receipts";
 })(MyDocumentGroupIdEnum || (exports.MyDocumentGroupIdEnum = MyDocumentGroupIdEnum = {}));

package/bin/retailLoan/enums/MyDocumentKindEnum.d.ts

@@ -1,4 +1,5 @@
 export declare enum MyDocumentKindEnum {
     CONTRACT = "CONTRACT",
-    MONTHLY_STATEMENT = "MONTHLY_STATEMENT"
+    MONTHLY_STATEMENT = "MONTHLY_STATEMENT",
+    PAYMENT_RECEIPT = "PAYMENT_RECEIPT"
 }

package/bin/retailLoan/enums/MyDocumentKindEnum.js

@@ -5,4 +5,5 @@ var MyDocumentKindEnum;
 (function (MyDocumentKindEnum) {
     MyDocumentKindEnum["CONTRACT"] = "CONTRACT";
     MyDocumentKindEnum["MONTHLY_STATEMENT"] = "MONTHLY_STATEMENT";
+    MyDocumentKindEnum["PAYMENT_RECEIPT"] = "PAYMENT_RECEIPT";
 })(MyDocumentKindEnum || (exports.MyDocumentKindEnum = MyDocumentKindEnum = {}));

package/bin/retailWizard/dtos/KycAttemptProgress.d.ts

@@ -0,0 +1,14 @@
+import { KycModalityEnum } from '../../retailCustomer/enums/KycModalityEnum';
+import { KycAttemptStageEnum } from '../enums/KycAttemptStageEnum';
+/** Avance del intento vigente de un flujo KYC, tal como lo devuelve `GET kyc/status`. */
+export interface KycAttemptProgress {
+    attemptId: string;
+    modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** `shortUrl` del QR; ausente en `STORE_DEVICE`. */
+    link?: string;
+    stage: KycAttemptStageEnum;
+    /** Cuándo entró a la etapa actual, ISO-8601 UTC. */
+    stageAt: string;
+    /** Fecha del prepare, ISO-8601 UTC; el front mide contra ella el tope de 25 min. */
+    attemptStartedAt: string;
+}

package/bin/retailWizard/dtos/KycAttemptProgress.js

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

package/bin/retailWizard/dtos/KycStatusProgress.d.ts

@@ -0,0 +1,7 @@
+import type { KycAttemptProgress } from './KycAttemptProgress';
+/** Bloque `progress` de `GET kyc/status`: el intento vigente de cada flujo, o `null` si no hay. */
+export interface KycStatusProgress {
+    identity: KycAttemptProgress | null;
+    facematch: KycAttemptProgress | null;
+    proofOfAddress: KycAttemptProgress | null;
+}

package/bin/retailWizard/dtos/KycStatusProgress.js

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

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

@@ -52,6 +52,8 @@ export interface KycSdkMetadata {
      * domicilio del documento de identidad: `kyc-metamap-webhook` rutea por este campo.
      */
     kycStep?: KycMetadataStepEnum;
+    /** Intento del wizard que originó la verificación; el webhook lo copia a cada evento. */
+    attemptId?: string;
 }
 /**
  * Paso del onboarding que originó una verificación, tal como viaja en `KycSdkMetadata.kycStep`.
@@ -94,6 +96,8 @@ export interface KycPrepareResponse {
      * (`KycManualRequest`). Por eso el tipo se estrecha a las dos que el SDK puede ejecutar.
      */
     modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** Intento que abrió este prepare; ausente cuando no se crea intento: alreadyVerified o bypass de dev. */
+    attemptId?: string;
     /** 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. */

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

@@ -13,6 +13,8 @@ import { KycModalityEnum } from '../../../retailCustomer/enums/KycModalityEnum';
 export interface ProofOfAddressPrepareResponse {
     /** `MANUAL` no es una modalidad de `prepare`: la captura manual es su propio endpoint. */
     modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** Intento que abrió este prepare; ausente cuando alreadyHasAddress. */
+    attemptId?: string;
     /** STORE_DEVICE — clientId de la cuenta Metamap (mismo valor en prod y dev). */
     clientId?: string;
     /** STORE_DEVICE — flow de Metamap del comprobante de domicilio. */

package/bin/retailWizard/enums/KycAttemptStageEnum.d.ts

@@ -0,0 +1,8 @@
+/** Etapa del intento vigente de un flujo KYC del wizard; el rango de monotonía vive en el wizard. */
+export declare enum KycAttemptStageEnum {
+    AWAITING_START = "AWAITING_START",
+    STARTED = "STARTED",
+    INPUTS_COMPLETED = "INPUTS_COMPLETED",
+    EXPIRED = "EXPIRED",
+    RESULT = "RESULT"
+}

package/bin/retailWizard/enums/KycAttemptStageEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycAttemptStageEnum = void 0;
+/** Etapa del intento vigente de un flujo KYC del wizard; el rango de monotonía vive en el wizard. */
+var KycAttemptStageEnum;
+(function (KycAttemptStageEnum) {
+    KycAttemptStageEnum["AWAITING_START"] = "AWAITING_START";
+    KycAttemptStageEnum["STARTED"] = "STARTED";
+    KycAttemptStageEnum["INPUTS_COMPLETED"] = "INPUTS_COMPLETED";
+    KycAttemptStageEnum["EXPIRED"] = "EXPIRED";
+    KycAttemptStageEnum["RESULT"] = "RESULT";
+})(KycAttemptStageEnum || (exports.KycAttemptStageEnum = KycAttemptStageEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -33,6 +33,7 @@ export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
 export * from './enums/EmailStateEnum';
 export * from './enums/SaleChannelEnum';
+export * from './enums/KycAttemptStageEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -57,6 +58,8 @@ export * from './dtos/WizardReservedLine';
 export * from './dtos/WizardGiftLine';
 export * from './dtos/SaleLine';
 export * from './dtos/AccessorySaleLine';
+export * from './dtos/KycAttemptProgress';
+export * from './dtos/KycStatusProgress';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';

package/bin/retailWizard/index.js

@@ -52,6 +52,7 @@ __exportStar(require("./enums/LinePaymentTypeEnum"), exports);
 __exportStar(require("./enums/WizardLineRoleEnum"), exports);
 __exportStar(require("./enums/EmailStateEnum"), exports);
 __exportStar(require("./enums/SaleChannelEnum"), exports);
+__exportStar(require("./enums/KycAttemptStageEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -79,6 +80,8 @@ __exportStar(require("./dtos/WizardReservedLine"), exports);
 __exportStar(require("./dtos/WizardGiftLine"), exports);
 __exportStar(require("./dtos/SaleLine"), exports);
 __exportStar(require("./dtos/AccessorySaleLine"), exports);
+__exportStar(require("./dtos/KycAttemptProgress"), exports);
+__exportStar(require("./dtos/KycStatusProgress"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);

package/package.json

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

package/src/biometrics/dtos/responses/BiometricVerificationResponse.ts

@@ -138,6 +138,10 @@ export class BiometricVerificationResponse {
     @Expose() @IsISO8601({ strict: true })
     expiresAt!: string;
 
+    /** Cuándo el usuario terminó de subir su información. ISO-8601 UTC con `Z`; ausente si aún no. */
+    @Expose() @IsOptional() @IsISO8601({ strict: true })
+    inputsCompletedAt?: string;
+
     /** Cuándo alcanzó un estado terminal. Ausente mientras siga viva. */
     @Expose() @IsOptional() @IsISO8601({ strict: true })
     completedAt?: string;

package/src/biometrics/enums/BiometricEventTypeEnum.ts

@@ -3,8 +3,8 @@
  * lo que el consumer usa para decidir la transición de estado.
  *
  * Es el vocabulario NUESTRO, no el de Metamap: `kyc-metamap-webhook` traduce sus `eventName` a
- * estos cuatro antes de publicar. Así el consumer no aprende el catálogo de un proveedor externo, y
- * el día que entre otro proveedor traduce a los mismos cuatro.
+ * estos valores antes de publicar. Así el consumer no aprende el catálogo de un proveedor externo, y
+ * el día que entre otro proveedor traduce a los mismos valores.
  *
  * `biometrics-business` — Entrega 1.
  */
@@ -28,4 +28,10 @@ export enum BiometricEventTypeEnum {
      * contra `expiresAt` (DEC-015), así que una verificación vence aunque este evento nunca llegue.
      */
     VERIFICATION_EXPIRED = 'VERIFICATION_EXPIRED',
+
+    /** El usuario terminó de subir su información. Sigue en `IN_PROGRESS` y graba `inputsCompletedAt`. */
+    INPUTS_COMPLETED = 'INPUTS_COMPLETED',
+
+    /** El proveedor cambió el veredicto (revisión manual). Se trata igual que `VERIFICATION_COMPLETED`. */
+    UPDATED = 'UPDATED',
 }

package/src/kyc/enums/KycFlowEnum.ts

@@ -0,0 +1,5 @@
+/** Flujo de Metamap al que pertenece un evento; el webhook lo deriva de `metadata.kycStep`. */
+export enum KycFlowEnum {
+    IDENTITY = 'IDENTITY',
+    PROOF_OF_ADDRESS = 'PROOF_OF_ADDRESS',
+}

package/src/kyc/enums/KycProgressStageEnum.ts

@@ -0,0 +1,6 @@
+/** Etapa de avance de una verificación de Metamap, tal como la publica `kyc-metamap-webhook`. */
+export enum KycProgressStageEnum {
+    STARTED = 'STARTED',
+    INPUTS_COMPLETED = 'INPUTS_COMPLETED',
+    EXPIRED = 'EXPIRED',
+}

package/src/kyc/events/KycProofOfAddressCompletedV1.ts

@@ -65,4 +65,8 @@ export class KycProofOfAddressCompletedV1 {
         message: 'occurredAt debe ser ISO-8601 en UTC con Z (ej. 2026-08-11T10:05:00.000Z): un offset rompe el orden léxico',
     })
     occurredAt!: string;
+
+    /** Intento del wizard que originó el comprobante; el consumidor descarta los que no son el vigente. */
+    @Expose() @IsOptional() @IsString() @IsNotEmpty()
+    attemptId?: string;
 }

package/src/kyc/events/KycStepCompletedV1.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
 import { IsEnum, IsIn, IsISO8601, IsNotEmpty, IsOptional, IsString, Matches, Validate } from 'class-validator';
+import { KycFlowEnum } from '../enums/KycFlowEnum';
 import { KycSubCheckNameEnum } from '../enums/KycSubCheckNameEnum';
 import { KycSubCheckStatusEnum } from '../enums/KycSubCheckStatusEnum';
 import { KycWatchlistStatusEnum } from '../enums/KycWatchlistStatusEnum';
@@ -102,4 +103,12 @@ export class KycStepCompletedV1 {
     /** El flujo de Metamap que corrió. Solo para diagnóstico — nadie ramifica por él. */
     @Expose() @IsOptional() @IsString()
     metamapFlowId?: string;
+
+    /** Intento del wizard que originó la verificación; el consumidor descarta los que no son el vigente. */
+    @Expose() @IsOptional() @IsString() @IsNotEmpty()
+    attemptId?: string;
+
+    /** Flujo al que pertenece la estación, derivado de `metadata.kycStep`. */
+    @Expose() @IsOptional() @IsEnum(KycFlowEnum)
+    flow?: KycFlowEnum;
 }

package/src/kyc/events/KycVerificationChangedV1.ts

@@ -95,4 +95,8 @@ export class KycVerificationChangedV1 {
      */
     @Expose() @IsOptional() @IsBoolean()
     addressPushedToFiado?: boolean;
+
+    /** Intento del wizard que originó la verificación; el consumidor descarta los que no son el vigente. */
+    @Expose() @IsOptional() @IsString() @IsNotEmpty()
+    attemptId?: string;
 }

package/src/kyc/events/KycVerificationProgressV1.ts

@@ -0,0 +1,33 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsIn, IsISO8601, IsNotEmpty, IsOptional, IsString, Matches } from 'class-validator';
+import { KycFlowEnum } from '../enums/KycFlowEnum';
+import { KycProgressStageEnum } from '../enums/KycProgressStageEnum';
+
+/** Avance de una verificación de Metamap (started, inputs_completed, expired) que publica `kyc-metamap-webhook`. */
+export class KycVerificationProgressV1 {
+    @Expose() @IsIn(['KycVerificationProgressV1'])
+    eventType!: 'KycVerificationProgressV1';
+
+    @Expose() @IsEnum(KycProgressStageEnum)
+    stage!: KycProgressStageEnum;
+
+    @Expose() @IsEnum(KycFlowEnum)
+    flow!: KycFlowEnum;
+
+    @Expose() @IsString() @IsNotEmpty()
+    verificationId!: string;
+
+    @Expose() @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    /** Intento del wizard que originó la verificación; ausente en sesiones previas al despliegue. */
+    @Expose() @IsOptional() @IsString() @IsNotEmpty()
+    attemptId?: string;
+
+    /** ISO-8601 en UTC con `Z`, igual que los demás eventos de la cola. */
+    @Expose() @IsString() @IsISO8601({ strict: true })
+    @Matches(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/, {
+        message: 'occurredAt debe ser ISO-8601 en UTC con Z (ej. 2026-10-28T10:05:00.000Z)',
+    })
+    occurredAt!: string;
+}

package/src/kyc/index.ts

@@ -5,6 +5,8 @@ export * from './enums/KycSubCheckStatusEnum';
 export * from './enums/KycWatchlistStatusEnum';
 export * from './enums/KycSubCheckNameEnum';
 export * from './enums/ProofAddressStatusEnum';
+export * from './enums/KycProgressStageEnum';
+export * from './enums/KycFlowEnum';
 
 // Sub-pasos descompuestos (SureKeep F2)
 export * from './dtos/KycSubChecks';
@@ -26,3 +28,4 @@ export * from './dtos/responses/KycByDirectoryResponse';
 export * from './events/KycVerificationChangedV1';
 export * from './events/KycStepCompletedV1';
 export * from './events/KycProofOfAddressCompletedV1';
+export * from './events/KycVerificationProgressV1';

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

@@ -0,0 +1,10 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/** Documento del ciclo de vida de un crédito, visto por su acreditado. */
+export interface LoanCustomerCreditDocument {
+    documentType: ContractTypeEnum;
+    /** Llave del documento: el paymentId en un comprobante, el periodo `YYYY-MM` en un estado de cuenta. */
+    documentKey: string;
+    /** ISO-8601; `null` mientras el PDF no se haya generado. */
+    generatedAt: string | null;
+}

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

@@ -0,0 +1,10 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/** Enlace prefirmado y temporal del PDF de un documento del ciclo de vida. `expiresAt` en ISO-8601. */
+export interface LoanCustomerCreditDocumentUrl {
+    creditId: string;
+    documentType: ContractTypeEnum;
+    documentKey: string;
+    url: string;
+    expiresAt: string;
+}

package/src/loanCredit/index.ts

@@ -51,6 +51,8 @@ export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
+export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';

package/src/retailLoan/dtos/MyDocument.ts

@@ -5,7 +5,8 @@ import { MyDocumentStatusEnum } from '../enums/MyDocumentStatusEnum';
 
 /**
  * Un documento del crédito. `documentRef` sigue la convención del módulo de la app:
- * `doc-contract-<contractId>` para contratos y `doc-stmt-YYYY-MM` para estados de cuenta.
+ * `doc-contract-<contractId>` para contratos, `doc-stmt-YYYY-MM` para estados de cuenta y
+ * `doc-receipt-<paymentId>` para comprobantes de pago.
  */
 export interface MyDocument {
     documentRef: string;

package/src/retailLoan/enums/MyDocumentGroupIdEnum.ts

@@ -2,4 +2,5 @@
 export enum MyDocumentGroupIdEnum {
     CONTRACT = 'contract',
     MONTHLY = 'monthly',
+    PAYMENT_RECEIPTS = 'receipts',
 }

package/src/retailLoan/enums/MyDocumentKindEnum.ts

@@ -1,4 +1,5 @@
 export enum MyDocumentKindEnum {
     CONTRACT = 'CONTRACT',
     MONTHLY_STATEMENT = 'MONTHLY_STATEMENT',
+    PAYMENT_RECEIPT = 'PAYMENT_RECEIPT',
 }

package/src/retailWizard/dtos/KycAttemptProgress.ts

@@ -0,0 +1,15 @@
+import { KycModalityEnum } from '../../retailCustomer/enums/KycModalityEnum';
+import { KycAttemptStageEnum } from '../enums/KycAttemptStageEnum';
+
+/** Avance del intento vigente de un flujo KYC, tal como lo devuelve `GET kyc/status`. */
+export interface KycAttemptProgress {
+    attemptId: string;
+    modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** `shortUrl` del QR; ausente en `STORE_DEVICE`. */
+    link?: string;
+    stage: KycAttemptStageEnum;
+    /** Cuándo entró a la etapa actual, ISO-8601 UTC. */
+    stageAt: string;
+    /** Fecha del prepare, ISO-8601 UTC; el front mide contra ella el tope de 25 min. */
+    attemptStartedAt: string;
+}

package/src/retailWizard/dtos/KycStatusProgress.ts

@@ -0,0 +1,8 @@
+import type { KycAttemptProgress } from './KycAttemptProgress';
+
+/** Bloque `progress` de `GET kyc/status`: el intento vigente de cada flujo, o `null` si no hay. */
+export interface KycStatusProgress {
+    identity: KycAttemptProgress | null;
+    facematch: KycAttemptProgress | null;
+    proofOfAddress: KycAttemptProgress | null;
+}

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

@@ -53,6 +53,8 @@ export interface KycSdkMetadata {
      * domicilio del documento de identidad: `kyc-metamap-webhook` rutea por este campo.
      */
     kycStep?: KycMetadataStepEnum;
+    /** Intento del wizard que originó la verificación; el webhook lo copia a cada evento. */
+    attemptId?: string;
 }
 
 /**
@@ -98,6 +100,8 @@ export interface KycPrepareResponse {
      * (`KycManualRequest`). Por eso el tipo se estrecha a las dos que el SDK puede ejecutar.
      */
     modality: KycModalityEnum.CUSTOMER_LINK | KycModalityEnum.STORE_DEVICE;
+    /** Intento que abrió este prepare; ausente cuando no se crea intento: alreadyVerified o bypass de dev. */
+    attemptId?: string;
     /** 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. */