@fiado/type-kit 3.194.0 → 3.195.0

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',
+}

package/src/retailWizard/enums/PaymentMethodEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Router del paso 04 — método de pago elegido en el wizard. SureKeep Fase 2 — pista Retail.
+ *
+ * SUREKEEP - Crédito SureKeep (pista SOFOM, F2).
+ * CASH_SALE - Venta de contado.
+ * EXTERNAL - Derivación a proveedor externo.
+ */
+export enum PaymentMethodEnum {
+    SUREKEEP = 'SUREKEEP',
+    CASH_SALE = 'CASH_SALE',
+    EXTERNAL = 'EXTERNAL',
+}

package/src/retailWizard/enums/PendingReasonEnum.ts

@@ -0,0 +1,21 @@
+/**
+ * Motivo por el que un cliente quedó como prospecto (15 valores, filtrados por paso).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum PendingReasonEnum {
+    OTP_FAILED = 'OTP_FAILED',
+    NO_INE = 'NO_INE',
+    NO_OCCUPATION = 'NO_OCCUPATION',
+    DISLIKES_CATALOG = 'DISLIKES_CATALOG',
+    PRICE_HIGH = 'PRICE_HIGH',
+    EVALUATING_CONDITIONS = 'EVALUATING_CONDITIONS',
+    REJECTED_RETRY = 'REJECTED_RETRY',
+    INSTALLMENT_HIGH = 'INSTALLMENT_HIGH',
+    EVALUATING_DOWNPAYMENT = 'EVALUATING_DOWNPAYMENT',
+    EVALUATING_TERM = 'EVALUATING_TERM',
+    NO_MONEY_TODAY = 'NO_MONEY_TODAY',
+    CONTRACT_DOUBTS = 'CONTRACT_DOUBTS',
+    DEVICE_ISSUE = 'DEVICE_ISSUE',
+    CLIENT_THINKING = 'CLIENT_THINKING',
+    OTHER = 'OTHER',
+}

package/src/retailWizard/enums/ProspectStatusEnum.ts

@@ -0,0 +1,16 @@
+/**
+ * Estado de un prospecto (seguimiento comercial). SureKeep Fase 2 — pista Retail.
+ *
+ * NEW - Recién creado.
+ * FOLLOW_UP - En seguimiento.
+ * CONTACTED - Ya contactado.
+ * CLOSED - Cerrado (automático al producirse la venta vinculada).
+ * LOST - Perdido.
+ */
+export enum ProspectStatusEnum {
+    NEW = 'NEW',
+    FOLLOW_UP = 'FOLLOW_UP',
+    CONTACTED = 'CONTACTED',
+    CLOSED = 'CLOSED',
+    LOST = 'LOST',
+}

package/src/retailWizard/enums/SalePaymentMethodEnum.ts

@@ -0,0 +1,6 @@
+/** Medio de pago con el que se cobró la venta de contado. SureKeep Fase 2 — pista Retail. */
+export enum SalePaymentMethodEnum {
+    CASH = 'CASH',
+    CARD = 'CARD',
+    WIRE = 'WIRE',
+}

package/src/retailWizard/enums/SaleStatusEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de una venta. SureKeep Fase 2 — pista Retail.
+ *
+ * COMPLETED - Venta cerrada.
+ * CANCELLED - Venta cancelada (flujo C; `cancelReason` obligatorio).
+ */
+export enum SaleStatusEnum {
+    COMPLETED = 'COMPLETED',
+    CANCELLED = 'CANCELLED',
+}

package/src/retailWizard/enums/SaleTypeEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Tipo de venta (v0.1 `sale_type`; las 4 externas colapsan en EXTERNAL_REFERRAL + provider).
+ * SureKeep Fase 2 — pista Retail.
+ *
+ * CASH - Venta de contado.
+ * EXTERNAL_REFERRAL - Derivación a proveedor externo.
+ * CREDIT - Crédito SureKeep (F3).
+ */
+export enum SaleTypeEnum {
+    CASH = 'CASH',
+    EXTERNAL_REFERRAL = 'EXTERNAL_REFERRAL',
+    CREDIT = 'CREDIT',
+}

package/src/retailWizard/enums/WizardStateEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Estado de la SAGA del wizard de venta de contado. SureKeep Fase 2 — pista Retail.
+ *
+ * ACTIVE - Sesión en curso.
+ * PAUSED_EXTERNAL_REFERRAL - Pausada por derivación a proveedor externo.
+ * PAUSED_NO_TOPUP - El cliente salió sin recarga de bienvenida (M1 §1087).
+ * COMPLETED - Venta cerrada.
+ * EXPIRED - Expiró por inactividad (TTL DDB ~24h).
+ * CANCELLED - Cancelada (incluye KYC PLD).
+ */
+export enum WizardStateEnum {
+    ACTIVE = 'ACTIVE',
+    PAUSED_EXTERNAL_REFERRAL = 'PAUSED_EXTERNAL_REFERRAL',
+    PAUSED_NO_TOPUP = 'PAUSED_NO_TOPUP',
+    COMPLETED = 'COMPLETED',
+    EXPIRED = 'EXPIRED',
+    CANCELLED = 'CANCELLED',
+}

package/src/retailWizard/enums/WizardStepEnum.ts

@@ -0,0 +1,13 @@
+/** Paso fino del wizard (v0.1 `phase` 1-3 → paso fino S01..S10). SureKeep Fase 2 — pista Retail. */
+export enum WizardStepEnum {
+    S01 = 'S01',
+    S02 = 'S02',
+    S03 = 'S03',
+    S04 = 'S04',
+    S05 = 'S05',
+    S06 = 'S06',
+    S07 = 'S07',
+    S08 = 'S08',
+    S09 = 'S09',
+    S10 = 'S10',
+}

package/src/retailWizard/events/SaleCancelledV1.ts

@@ -0,0 +1,13 @@
+/**
+ * Emitido al cancelar una venta (flujo C). Se escribe al outbox transaccional; drena a la cola Central.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface SaleCancelledV1 {
+  saleId: string;
+  folio: string;
+  retailCustomerId: string;
+  imei: string | null;
+  cancelReason: string;
+  cancelledAt: string;
+  occurredAt: string;
+}

package/src/retailWizard/events/SaleCompletedV1.ts

@@ -0,0 +1,17 @@
+/**
+ * Emitido al cerrar una venta (flujo 09). Se escribe al outbox transaccional en la MISMA
+ * `TransactWriteItems` del cierre; drena a la cola Central + datalake. Solo identificadores
+ * operacionales (nunca PII). SureKeep Fase 2 — pista Retail.
+ */
+export interface SaleCompletedV1 {
+  saleId: string;
+  folio: string;
+  retailerId: string;
+  storeId: string;
+  retailCustomerId: string;
+  sku: string;
+  imei: string | null;
+  amountCents: number;
+  soldAt: string;
+  occurredAt: string;
+}

package/src/retailWizard/events/SessionExpiredV1.ts

@@ -0,0 +1,10 @@
+/**
+ * Emitido cuando una sesión del wizard expira por inactividad (barrido del scheduler, TTL DDB ~24h).
+ * Libera la reserva del silo si la hubiera. SureKeep Fase 2 — pista Retail.
+ */
+export interface SessionExpiredV1 {
+  sessionId: string;
+  phone: string;
+  reservedImei: string | null;
+  occurredAt: string;
+}