@fiado/type-kit 3.608.0 → 3.610.0

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.608.0",
+  "version": "3.610.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/requests/OriginateLoanCreditRequest.ts

@@ -8,6 +8,8 @@ import {
     Max,
     Min,
 } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 
 /**
@@ -106,4 +108,16 @@ export class OriginateLoanCreditRequest {
     @IsOptional()
     @IsString()
     productSku?: string;
+
+    /** Tipo del equipo: resuelve promociones acotadas por tipo. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    productCategory?: ProductCategoryEnum;
+
+    /** Gama del equipo: resuelve promociones acotadas por gama. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    productTier?: ProductTierEnum;
 }

package/src/loanOfferings/constants/promotionSkuBatch.ts

@@ -0,0 +1,2 @@
+/** Tope de SKUs por llamada a los lotes de promociones por SKU; el caller parte en bloques. */
+export const PROMOTION_SKU_BATCH_MAX_ITEMS = 100;

package/src/loanOfferings/dtos/requests/CreatePromotionRequest.ts

@@ -10,6 +10,8 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { PromotionEffectInput } from './PromotionEffectInput';
 
 /**
@@ -49,6 +51,20 @@ export class CreatePromotionRequest {
     @IsString({ each: true })
     productSkus?: string[] | null;
 
+    /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductCategoryEnum, { each: true })
+    productCategories?: ProductCategoryEnum[] | null;
+
+    /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    tiers?: ProductTierEnum[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/requests/ListPromotedSkusRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { PROMOTION_SKU_BATCH_MAX_ITEMS } from '../../constants/promotionSkuBatch';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionSkuInput } from './PromotionSkuInput';
+
+/** Body de `POST /private/promotions/promoted-skus` (M2M): SKUs del lote con promoción viva para el badge; hasta 100 SKUs. */
+export class ListPromotedSkusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    /** Nivel del cliente si loan-scoring ya corrió. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CreditPlanLevelEnum)
+    level?: CreditPlanLevelEnum;
+
+    /** Segmento del cliente si ya se resolvió. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    segmentId?: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_SKU_BATCH_MAX_ITEMS)
+    @ValidateNested({ each: true })
+    @Type(() => PromotionSkuInput)
+    items!: PromotionSkuInput[];
+}

package/src/loanOfferings/dtos/requests/ListSkuPromotionsRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { PROMOTION_SKU_BATCH_MAX_ITEMS } from '../../constants/promotionSkuBatch';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { PromotionSkuInput } from './PromotionSkuInput';
+
+/** Body de `POST /private/promotions/by-sku` (M2M): promociones vivas de cada SKU del lote; hasta 100 SKUs. */
+export class ListSkuPromotionsRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    /** Nivel del cliente si loan-scoring ya corrió. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CreditPlanLevelEnum)
+    level?: CreditPlanLevelEnum;
+
+    /** Segmento del cliente si ya se resolvió. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    segmentId?: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(PROMOTION_SKU_BATCH_MAX_ITEMS)
+    @ValidateNested({ each: true })
+    @Type(() => PromotionSkuInput)
+    items!: PromotionSkuInput[];
+}

package/src/loanOfferings/dtos/requests/PromotionSkuInput.ts

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+export class PromotionSkuInput {
+    @Expose()
+    @IsString()
+    sku!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    category?: ProductCategoryEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum;
+}

package/src/loanOfferings/dtos/requests/SimulateCreditPlanRequest.ts

@@ -1,5 +1,8 @@
 import { Expose } from 'class-transformer';
-import { IsArray, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { IsArray, IsEnum, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+
 
 /**
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
@@ -46,6 +49,18 @@ export class SimulateCreditPlanRequest {
     @IsString()
     productSku?: string;
 
+    /** Tipo del equipo. Sin él no se resuelven las promociones acotadas por tipo. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    productCategory?: ProductCategoryEnum;
+
+    /** Gama del equipo. Sin ella no se resuelven las promociones acotadas por gama. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    productTier?: ProductTierEnum;
+
     /**
      * Segmentos del cliente, los que devolvió `POST /private/segments/resolve`. Un arreglo vacío
      * declara que el cliente no está en ninguno; ausente declara que el caller no lo consultó.

package/src/loanOfferings/dtos/requests/UpdatePromotionRequest.ts

@@ -10,6 +10,8 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { PromotionEffectInput } from './PromotionEffectInput';
 
 /**
@@ -52,6 +54,20 @@ export class UpdatePromotionRequest {
     @IsString({ each: true })
     productSkus?: string[] | null;
 
+    /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductCategoryEnum, { each: true })
+    productCategories?: ProductCategoryEnum[] | null;
+
+    /** Gamas alcanzadas; ausente o `null` = todas las gamas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    tiers?: ProductTierEnum[] | null;
+
     /** Tiendas alcanzadas. `null` o ausente = todas. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/responses/PromotionResponse.ts

@@ -1,3 +1,5 @@
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 import { PromotionPhaseEnum } from '../../enums/PromotionPhaseEnum';
@@ -22,6 +24,10 @@ export interface PromotionResponse {
     targetLevels: CreditPlanLevelEnum[];
     /** `null` = alcanza a todos los productos. */
     productSkus: string[] | null;
+    /** `null` = alcanza a todos los tipos de producto. */
+    productCategories: ProductCategoryEnum[] | null;
+    /** `null` = alcanza a todas las gamas. */
+    tiers: ProductTierEnum[] | null;
     /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
     storeIds: string[] | null;
     validFrom: string | null;

package/src/loanOfferings/index.ts

@@ -18,6 +18,9 @@ export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
 export * from './enums/PrepaymentMinimumModeEnum';
 
+// Constantes
+export * from './constants/promotionSkuBatch';
+
 // Entity DTOs
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
@@ -50,6 +53,9 @@ export * from './dtos/requests/ChangeSegmentStatusRequest';
 export * from './dtos/requests/ResolveCustomerSegmentsRequest';
 export * from './dtos/requests/ComputeAmortizationScheduleRequest';
 export * from './dtos/requests/ListSegmentCatalogQuery';
+export * from './dtos/requests/PromotionSkuInput';
+export * from './dtos/requests/ListPromotedSkusRequest';
+export * from './dtos/requests/ListSkuPromotionsRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';

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. */

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

@@ -14,6 +14,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/src/retailWizard/enums/KycAttemptStageEnum.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 enum KycAttemptStageEnum {
+    AWAITING_START = 'AWAITING_START',
+    STARTED = 'STARTED',
+    INPUTS_COMPLETED = 'INPUTS_COMPLETED',
+    EXPIRED = 'EXPIRED',
+    RESULT = 'RESULT',
+}

package/src/retailWizard/index.ts

@@ -36,6 +36,7 @@ export * from './enums/LinePaymentTypeEnum';
 export * from './enums/WizardLineRoleEnum';
 export * from './enums/EmailStateEnum';
 export * from './enums/SaleChannelEnum';
+export * from './enums/KycAttemptStageEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -62,6 +63,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';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';