@fiado/type-kit 3.193.0 → 3.195.0

package/src/retailWizard/dtos/WizardSession.ts

@@ -0,0 +1,68 @@
+import type { WizardStateEnum } from '../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+import type { FiadoPhoneStatusEnum } from '../enums/FiadoPhoneStatusEnum';
+import type { PaymentMethodEnum } from '../enums/PaymentMethodEnum';
+import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
+import type { OccupationEnum } from '../enums/OccupationEnum';
+import type { WizardConsents } from './WizardConsents';
+import type { WizardPayment } from './WizardPayment';
+import type { WizardWelcome } from './WizardWelcome';
+
+/** Modalidad de captura del KYC (M1 §213-329). */
+export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
+
+/** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
+export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED';
+
+/**
+ * Estado de la SAGA del wizard (modelo-datos §1). ES la tabla de estado: cada paso persiste su
+ * avance; reanudable. pk `SESSION#<sessionId>` · sk `META` · GSIs `phone-state-index`,
+ * `customerId-pk-index`. Los ítems `OTP#` viven en la MISMA partición (ver OtpVerification).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardSession {
+  sessionId: string;
+  retailerId: string;
+  storeId: string;
+  sellerRetailUserId: string;
+  /** Llave de la sesión; 1 ACTIVE por teléfono vía `UNIQ#ACTIVE-PHONE#<phone>`. */
+  phone: string;
+  retailCustomerId: string | null;
+  currentStep: WizardStepEnum;
+  state: WizardStateEnum;
+  otpVerified: boolean;
+  otpSkipped: boolean;
+  consents: WizardConsents | null;
+  /** Espejo del estado KYC (fuente = customer). */
+  kycStatus: string | null;
+  kycModality: KycModality | null;
+  metamapIdentityId: string | null;
+  occupation: OccupationEnum | null;
+  occupationOther: string | null;
+  /** Del gate `signInPhoneNumber` del 01a (D27). */
+  fiadoPhoneStatus: FiadoPhoneStatusEnum | null;
+  fiadoDirectoryId: string | null;
+  fiadoPeopleId: string | null;
+  pcfProvisioned: boolean;
+  accountOpened: boolean;
+  accountStatus: AccountStatus | null;
+  reservedSku: string | null;
+  reservedImei: string | null;
+  reservationExpiresAt: string | null;
+  paymentMethod: PaymentMethodEnum | null;
+  externalProvider: ExternalProviderEnum | null;
+  /** Folio de cobro server-side (D11), idempotente, sobrevive al volver atrás. */
+  folio: string | null;
+  payment: WizardPayment | null;
+  welcome: WizardWelcome | null;
+  saleId: string | null;
+  /** Prospecto vinculado (si la sesión se reanudó desde un prospecto): se cierra al cerrar la venta (D-prospecto). */
+  prospectId: string | null;
+  cancelReason: string | null;
+  /** TTL DDB ~24h de inactividad (D14). */
+  ttlEpoch: number;
+  createdBy: string;
+  updatedBy: string;
+  createdAt: number;
+  updatedAt: number;
+}

package/src/retailWizard/dtos/WizardWelcome.ts

@@ -0,0 +1,31 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsIn, IsOptional, IsString } from 'class-validator';
+
+/** Estado del paso 10 (bienvenida N2) dentro de la sesión (`WizardSession.welcome`). SureKeep Fase 2 — pista Retail. */
+export class WizardWelcome {
+    @Expose()
+    @IsBoolean()
+    addressConfirmed!: boolean;
+
+    @Expose()
+    @IsBoolean()
+    benefCaptured!: boolean;
+
+    @Expose()
+    @IsBoolean()
+    annexSigned!: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    annexVersion?: string;
+
+    @Expose()
+    @IsBoolean()
+    topupApplied!: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsIn([1, 2])
+    accountLevel?: 1 | 2;
+}

package/src/retailWizard/dtos/requests/AddProductRequest.ts

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsString, Min } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
+ * RetailInventory F1 (condición atómica H2). El `cashPriceCents` de la reserva ancla el cobro
+ * (regla dura: `amountCents == cashPrice`). SureKeep Fase 2 — pista Retail.
+ */
+export class AddProductRequest {
+  @Expose()
+  @IsString()
+  sku!: string;
+
+  @Expose()
+  @IsString()
+  imei!: string;
+
+  @Expose()
+  @IsInt()
+  @Min(0)
+  cashPriceCents!: number;
+}

package/src/retailWizard/dtos/requests/AppInstallLinkRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString } from 'class-validator';
+
+/** POST /wizard/sessions/:id/app/install-link — genera el shortlink de instalación de la app (QR, D9). SureKeep Fase 2 — pista Retail. */
+export class AppInstallLinkRequest {
+  @Expose()
+  @IsOptional()
+  @IsString()
+  channel?: string;
+}

package/src/retailWizard/dtos/requests/CancelSaleRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength } from 'class-validator';
+
+/**
+ * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
+ * OBLIGATORIO (AuditTrail). Retorna el IMEI al silo (`SOLD → AVAILABLE`) y emite `SaleCancelledV1`.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export class CancelSaleRequest {
+  @Expose()
+  @IsString()
+  @MaxLength(200)
+  reason!: string;
+}

package/src/retailWizard/dtos/requests/CancelSessionRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength } from 'class-validator';
+
+/** POST /wizard/sessions/:id/cancel — cancela la sesión (libera reserva + UNIQ#ACTIVE-PHONE). SureKeep Fase 2 — pista Retail. */
+export class CancelSessionRequest {
+  @Expose()
+  @IsString()
+  @MaxLength(200)
+  reason!: string;
+}

package/src/retailWizard/dtos/requests/CompleteSaleRequest.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/complete-sale — cierra la venta (saga de 2 pasos, flujo 09). Exige
+ * payment registrado (regla dura). Consume el IMEI del silo (SOLD), asigna la tarjeta PCF, persiste
+ * la Sale con `UNIQ#FOLIO` y emite el outbox `SaleCompletedV1` en la MISMA tx. Cierra el prospecto
+ * vinculado si lo hay. `cardNumber` = tarjeta física entregada en tienda (S7). SureKeep Fase 2 — pista Retail.
+ */
+export class CompleteSaleRequest {
+  @Expose()
+  @IsOptional()
+  @IsString()
+  cardNumber?: string;
+}

package/src/retailWizard/dtos/requests/ConfirmAddressRequest.ts

@@ -0,0 +1,22 @@
+import { Expose, Type } from 'class-transformer';
+import { IsBoolean, IsOptional, ValidateNested } from 'class-validator';
+import { AddressBase } from '../../../address/dtos/AddressBase';
+
+/**
+ * POST /wizard/sessions/:id/address/confirm — el cliente ratifica/edita el domicilio en el paso 10
+ * (el `address` ya existía desde el 02e). Setea `addressConfirmed`. SureKeep Fase 2 — pista Retail.
+ */
+export class ConfirmAddressRequest {
+  // TD-ADDRESSBASE-OCR: reusa el `AddressBase` canónico por decisión de Andrés (apego al spec + modelo-datos).
+  // La dirección OCR/editada puede NO llenar los ~12 campos requeridos de AddressBase → posible rechazo en
+  // runtime con @ValidateNested. Ajustar después (ver RetailCustomer.address).
+  @Expose()
+  @IsOptional()
+  @Type(() => AddressBase)
+  @ValidateNested()
+  address?: AddressBase;
+
+  @Expose()
+  @IsBoolean()
+  confirmed!: boolean;
+}

package/src/retailWizard/dtos/requests/ConsentsRequest.ts

@@ -0,0 +1,21 @@
+import { Expose, Type } from 'class-transformer';
+import { IsOptional, IsString, ValidateNested } from 'class-validator';
+import { WizardConsents } from '../WizardConsents';
+
+/**
+ * POST /wizard/sessions/:id/consents — registra los consentimientos VL + contrato PCF. Dispara la
+ * tríada Fiado idempotente (D26): lookup directory por phone → reusa o crea onboarding+people+directory.
+ * Puede incluir el nombre del cliente (para el signUpProspect si no existe todavía). SureKeep Fase 2 — pista Retail.
+ */
+export class ConsentsRequest {
+  @Expose()
+  @Type(() => WizardConsents)
+  @ValidateNested()
+  consents!: WizardConsents;
+
+  /** Nombre del cliente (para la creación de identidad Fiado si aún no existe). */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  customerName?: string;
+}

package/src/retailWizard/dtos/requests/CreateProspectRequest.ts

@@ -0,0 +1,47 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength, ValidateNested } from 'class-validator';
+import { PendingReasonEnum } from '../../enums/PendingReasonEnum';
+import { ProspectNewCustomer } from '../ProspectNewCustomer';
+
+/**
+ * POST /prospects — crea un prospecto (seguimiento comercial). Identificado (`retailCustomerId`) vs
+ * captura manual (`newCustomer`). `freeReason` obligatorio si `pendingReason=OTHER`. SureKeep Fase 2 — pista Retail.
+ */
+export class CreateProspectRequest {
+  @Expose()
+  @IsOptional()
+  @IsString()
+  retailCustomerId?: string;
+
+  @Expose()
+  @IsOptional()
+  @Type(() => ProspectNewCustomer)
+  @ValidateNested()
+  newCustomer?: ProspectNewCustomer;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  productSku?: string;
+
+  @Expose()
+  @IsEnum(PendingReasonEnum)
+  pendingReason!: PendingReasonEnum;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @MaxLength(200)
+  freeReason?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  nextContactAt?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @MaxLength(200)
+  notes?: string;
+}

package/src/retailWizard/dtos/requests/DeleteProductRequest.ts

@@ -0,0 +1,9 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
+export class DeleteProductRequest {
+  @Expose()
+  @IsString()
+  imei!: string;
+}

package/src/retailWizard/dtos/requests/ExternalReferralRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { ExternalProviderEnum } from '../../enums/ExternalProviderEnum';
+
+/**
+ * POST /wizard/sessions/:id/external-referral — deriva a proveedor externo (pausa la sesión en
+ * PAUSED_EXTERNAL_REFERRAL). No consume IMEI del silo (D15). SureKeep Fase 2 — pista Retail.
+ */
+export class ExternalReferralRequest {
+  @Expose()
+  @IsEnum(ExternalProviderEnum)
+  provider!: ExternalProviderEnum;
+}

package/src/retailWizard/dtos/requests/KycConfirmRequest.ts

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { IsOptional, IsString, ValidateNested } from 'class-validator';
+import { AddressBase } from '../../../address/dtos/AddressBase';
+
+/**
+ * POST /wizard/sessions/:id/kyc/confirm — confirma el resultado KYC (server-side, idempotente por
+ * directoryId). Lo llama el consumer `kyc-inbound` (primario, D28) y opcionalmente el front (puente D25).
+ * Dispara el upsert customer (accountStatus=OPENING) + la apertura async (02f). SureKeep Fase 2 — pista Retail.
+ */
+export class KycConfirmRequest {
+  @Expose()
+  @IsString()
+  metamapIdentityId!: string;
+
+  // TD-ADDRESSBASE-OCR: reusa el `AddressBase` canónico por decisión de Andrés (apego al spec). Si el
+  // documento trae la dirección, el OCR puede NO llenar los ~12 campos requeridos de AddressBase →
+  // posible rechazo en runtime con @ValidateNested. Ajustar después (ver RetailCustomer.address).
+  @Expose()
+  @IsOptional()
+  @Type(() => AddressBase)
+  @ValidateNested()
+  address?: AddressBase;
+}

package/src/retailWizard/dtos/requests/KycManualRequest.ts

@@ -0,0 +1,17 @@
+import { Expose, Type } from 'class-transformer';
+import { ValidateNested } from 'class-validator';
+import { AddressBase } from '../../../address/dtos/AddressBase';
+
+/**
+ * POST /wizard/sessions/:id/kyc/manual — captura manual del domicilio cuando el documento no lo trae
+ * (MANUAL degrada wallet pero NO bloquea la venta de contado — regla dura). SureKeep Fase 2 — pista Retail.
+ */
+export class KycManualRequest {
+  // TD-ADDRESSBASE-OCR: reusa el `AddressBase` canónico por decisión de Andrés (apego al spec). La
+  // captura manual puede NO llenar los ~12 campos requeridos de AddressBase → posible rechazo en runtime
+  // con @ValidateNested. Ajustar después (ver RetailCustomer.address).
+  @Expose()
+  @Type(() => AddressBase)
+  @ValidateNested()
+  address!: AddressBase;
+}

package/src/retailWizard/dtos/requests/KycPrepareRequest.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { IsIn } from 'class-validator';
+
+/** Modalidad de captura KYC solicitada. */
+export type KycModalityInput = 'CUSTOMER_LINK' | 'STORE_DEVICE';
+
+/**
+ * POST /wizard/sessions/:id/kyc/prepare — prepara el flujo KYC (getFlows) y devuelve el identityId
+ * de Metamap para que el SDK front lo arranque. `modality` = link al cliente o captura en tablet.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export class KycPrepareRequest {
+  @Expose()
+  @IsIn(['CUSTOMER_LINK', 'STORE_DEVICE'])
+  modality!: KycModalityInput;
+}

package/src/retailWizard/dtos/requests/MarkPcfCardDeliveredRequest.ts

@@ -0,0 +1,9 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/** POST /wizard/sessions/:id/pcf-card/mark-delivered — marca la tarjeta física PCF como entregada (S7). SureKeep Fase 2 — pista Retail. */
+export class MarkPcfCardDeliveredRequest {
+  @Expose()
+  @IsString()
+  cardNumber!: string;
+}

package/src/retailWizard/dtos/requests/MarkProspectLostRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength } from 'class-validator';
+
+/** POST /prospects/:id/mark-lost — marca el prospecto como LOST con motivo. SureKeep Fase 2 — pista Retail. */
+export class MarkProspectLostRequest {
+  @Expose()
+  @IsString()
+  @MaxLength(200)
+  reason!: string;
+}

package/src/retailWizard/dtos/requests/OccupationRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { OccupationEnum } from '../../enums/OccupationEnum';
+
+/**
+ * POST /wizard/sessions/:id/occupation — registra la ocupación (dato del expediente PCF, vive en
+ * People de Fiado — D17). Sin ocupación NO se abre la cuenta (Manual v1.4 §8.13). `OTHER` abre texto ≤60.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export class OccupationRequest {
+  @Expose()
+  @IsEnum(OccupationEnum)
+  occupation!: OccupationEnum;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @MaxLength(60)
+  occupationOther?: string;
+}

package/src/retailWizard/dtos/requests/RegisterPaymentRequest.ts

@@ -0,0 +1,26 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, ValidateNested, Min } from 'class-validator';
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+
+/**
+ * POST /wizard/sessions/:id/payment — registra el cobro de contado (idempotente por sesión). Regla
+ * dura: `amountCents == cashPrice` de la reserva. `POST /payment/folio` genera el folio server-side
+ * (D11) ANTES del registro; el folio no viaja en el body (lo posee el server). SureKeep Fase 2 — pista Retail.
+ */
+export class RegisterPaymentRequest {
+  @Expose()
+  @IsEnum(SalePaymentMethodEnum)
+  method!: SalePaymentMethodEnum;
+
+  @Expose()
+  @IsInt()
+  @Min(0)
+  amountCents!: number;
+
+  @Expose()
+  @IsOptional()
+  @Type(() => SalePaymentDetail)
+  @ValidateNested()
+  detail?: SalePaymentDetail;
+}

package/src/retailWizard/dtos/requests/ResendOtpRequest.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/otp/resend — reenvía OTP (resend 60s de cooldown). Body vacío: el destino
+ * es el teléfono de la sesión. Clase declarada para el contrato/validación (sin campos requeridos).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export class ResendOtpRequest {
+  @Expose()
+  @IsOptional()
+  @IsString()
+  channel?: string;
+}

package/src/retailWizard/dtos/requests/SaveBeneficiaryRequest.ts

@@ -0,0 +1,11 @@
+import { Expose, Type } from 'class-transformer';
+import { ValidateNested } from 'class-validator';
+import { WizardBeneficiary } from '../WizardBeneficiary';
+
+/** POST /wizard/sessions/:id/beneficiary — captura el beneficiario (opcional en N1 simplificado). SureKeep Fase 2 — pista Retail. */
+export class SaveBeneficiaryRequest {
+  @Expose()
+  @Type(() => WizardBeneficiary)
+  @ValidateNested()
+  beneficiary!: WizardBeneficiary;
+}

package/src/retailWizard/dtos/requests/SetPaymentMethodRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { PaymentMethodEnum } from '../../enums/PaymentMethodEnum';
+
+/** POST /wizard/sessions/:id/payment-method — router del paso 04 (contado / crédito / externo). SureKeep Fase 2 — pista Retail. */
+export class SetPaymentMethodRequest {
+  @Expose()
+  @IsEnum(PaymentMethodEnum)
+  paymentMethod!: PaymentMethodEnum;
+}

package/src/retailWizard/dtos/requests/SignBeneficiaryAnnexRequest.ts

@@ -0,0 +1,9 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/** POST /wizard/sessions/:id/beneficiary-annex/sign — firma el anexo de beneficiario (versión + OTP F3). SureKeep Fase 2 — pista Retail. */
+export class SignBeneficiaryAnnexRequest {
+  @Expose()
+  @IsString()
+  annexVersion!: string;
+}

package/src/retailWizard/dtos/requests/SkipOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength } from 'class-validator';
+
+/** POST /wizard/sessions/:id/otp/skip — salta el OTP (M1 §184 `otp_no_verificado`; genera AuditTrail). SureKeep Fase 2 — pista Retail. */
+export class SkipOtpRequest {
+  @Expose()
+  @IsString()
+  @MaxLength(200)
+  reason!: string;
+}

package/src/retailWizard/dtos/requests/StartSessionRequest.ts

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString, Matches } from 'class-validator';
+import { regexPhoneMx } from '../../../helpers/constans/regex';
+
+/**
+ * POST /wizard/sessions — arranca (o reanuda) la saga del wizard para un teléfono.
+ * `retailerId`/`storeId`/`sellerRetailUserId` NO viajan en el body: se derivan del JWT del vendedor.
+ * Regla dura: 1 sesión ACTIVE por teléfono (409 SESSION_ACTIVE vía UNIQ#ACTIVE-PHONE). SureKeep Fase 2 — pista Retail.
+ */
+export class StartSessionRequest {
+  @Expose()
+  @IsString()
+  @Matches(regexPhoneMx, { message: 'phone debe ser un teléfono MX de 10 dígitos' })
+  phone!: string;
+
+  /** Prospecto a reanudar (opcional): si viene, la sesión se vincula al prospecto. */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  prospectId?: string;
+}

package/src/retailWizard/dtos/requests/UpdateProspectRequest.ts

@@ -0,0 +1,28 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { PendingReasonEnum } from '../../enums/PendingReasonEnum';
+
+/** PUT /prospects/:id — edita agenda / notas / motivo de un prospecto. SureKeep Fase 2 — pista Retail. */
+export class UpdateProspectRequest {
+  @Expose()
+  @IsOptional()
+  @IsEnum(PendingReasonEnum)
+  pendingReason?: PendingReasonEnum;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @MaxLength(200)
+  freeReason?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  nextContactAt?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @MaxLength(200)
+  notes?: string;
+}

package/src/retailWizard/dtos/requests/VerifyOtpRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length } from 'class-validator';
+
+/** POST /wizard/sessions/:id/otp/verify — verifica el código OTP (código validado en messages-business). SureKeep Fase 2 — pista Retail. */
+export class VerifyOtpRequest {
+  @Expose()
+  @IsString()
+  @Length(4, 8)
+  code!: string;
+}

package/src/retailWizard/dtos/requests/WelcomeTopupRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsOptional } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/welcome-topup — acreditación de bienvenida (D33): una sola vez por cliente
+ * (idempotencia permanente por `welcomeAccredited`). Ni una segunda venta re-acredita. SureKeep Fase 2 — pista Retail.
+ */
+export class WelcomeTopupRequest {
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  skip?: boolean;
+}

package/src/retailWizard/enums/BeneficiaryRelationEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Parentesco del beneficiario (catálogo de 9 valores Fiado; dropdown del paso 10).
+ * SureKeep Fase 2 — pista Retail.
+ *
+ * SPOUSE - Cónyuge · CHILD - Hijo(a) · PARENT - Padre/Madre · SIBLING - Hermano(a) ·
+ * GRANDPARENT - Abuelo(a) · GRANDCHILD - Nieto(a) · PARTNER - Concubino(a) · FRIEND - Amigo(a) · OTHER - Otro.
+ */
+export enum BeneficiaryRelationEnum {
+    SPOUSE = 'SPOUSE',
+    CHILD = 'CHILD',
+    PARENT = 'PARENT',
+    SIBLING = 'SIBLING',
+    GRANDPARENT = 'GRANDPARENT',
+    GRANDCHILD = 'GRANDCHILD',
+    PARTNER = 'PARTNER',
+    FRIEND = 'FRIEND',
+    OTHER = 'OTHER',
+}

package/src/retailWizard/enums/CentralSyncStatusEnum.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de sincronización de la venta con Central (local-first; badge en BO). SureKeep Fase 2 — pista Retail.
+ *
+ * PENDING - Aún no sincronizada.
+ * SENT - Enviada a Central.
+ * FAILED - Falló la sincronización.
+ * N_A - No aplica (p. ej. derivación externa).
+ */
+export enum CentralSyncStatusEnum {
+    PENDING = 'PENDING',
+    SENT = 'SENT',
+    FAILED = 'FAILED',
+    N_A = 'N_A',
+}

package/src/retailWizard/enums/ExternalProviderEnum.ts

@@ -0,0 +1,7 @@
+/** Proveedor externo de financiamiento al que se deriva la venta. SureKeep Fase 2 — pista Retail. */
+export enum ExternalProviderEnum {
+    PAYJOY = 'PAYJOY',
+    CREDIYA = 'CREDIYA',
+    LESPAGO = 'LESPAGO',
+    INNOVA = 'INNOVA',
+}

package/src/retailWizard/enums/FiadoPhoneStatusEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Estado del teléfono en el gate `signInPhoneNumber` del paso 01a (D27) — decide si el 01d crea o
+ * vincula la identidad Fiado y habilita el UX "Cliente reconocido". SureKeep Fase 2 — pista Retail.
+ *
+ * SIGN_UP - Teléfono nuevo (onboarding recién creado por el gate).
+ * PENDING_PASSWORD_CREATION - Cliente existente sin contraseña aún.
+ * ACTIVE - Cliente Fiado activo.
+ * USER_TEMP_BLOCKED - Bloqueo temporal.
+ */
+export enum FiadoPhoneStatusEnum {
+    SIGN_UP = 'SIGN_UP',
+    PENDING_PASSWORD_CREATION = 'PENDING_PASSWORD_CREATION',
+    ACTIVE = 'ACTIVE',
+    USER_TEMP_BLOCKED = 'USER_TEMP_BLOCKED',
+}

package/src/retailWizard/enums/OccupationEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Ocupación del cliente (micro-paso del 02; dropdown de 7 valores + OTHER abre texto libre ≤60).
+ * Sin ocupación NO se abre la cuenta (Manual v1.4 §8.13). SureKeep Fase 2 — pista Retail.
+ */
+export enum OccupationEnum {
+    EMPLOYED = 'EMPLOYED',
+    SELF_EMPLOYED = 'SELF_EMPLOYED',
+    STUDENT = 'STUDENT',
+    HOMEMAKER = 'HOMEMAKER',
+    RETIRED = 'RETIRED',
+    UNEMPLOYED = 'UNEMPLOYED',
+    OTHER = 'OTHER',
+}

package/src/retailWizard/enums/OtpPurposeEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Propósito de un OTP dentro del wizard (v0.1 `otp_purpose`). SureKeep Fase 2 — pista Retail.
+ *
+ * IDENTITY - OTP de verificación de identidad (teléfono).
+ * SIGNATURE - OTP de firma (F3).
+ */
+export enum OtpPurposeEnum {
+    IDENTITY = 'IDENTITY',
+    SIGNATURE = 'SIGNATURE',
+}