@fiado/type-kit 3.194.0 → 3.195.0

package/src/retailCustomer/dtos/responses/CustomerResponse.ts

@@ -0,0 +1,31 @@
+import { AddressBase } from '../../../address/dtos/AddressBase';
+import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
+import { KycModalityEnum } from '../../enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
+
+/**
+ * Vista de un cliente retail hacia el consumidor (BO / api-invoker). SureKeep Fase 2 — pista Retail.
+ * `address` reusa el `AddressBase` canónico de Fiado (ver TD en RetailCustomer.address).
+ */
+export interface CustomerResponse {
+    retailCustomerId: string;
+    retailerId: string;
+    name: string;
+    phone: string;
+    curp: string;
+    birthDate: string | null;
+    fiadoDirectoryId: string | null;
+    fiadoPeopleId: string | null;
+    pcfAccountId: string | null;
+    pcfClabe: string | null;
+    pcfAccountLevel: 1 | 2 | null;
+    accountStatus: AccountStatusEnum | null;
+    failReason: string | null;
+    welcomeAccredited: boolean;
+    address: AddressBase | null;
+    addressConfirmed: boolean;
+    kycStatus: RetailKycStatusEnum;
+    kycModality: KycModalityEnum | null;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/retailCustomer/enums/AccountStatusEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado de la apertura async de la cuenta PagoConFiado (PCF) del cliente retail (D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum AccountStatusEnum {
+    OPENING = 'OPENING',
+    OPEN = 'OPEN',
+    FAILED = 'FAILED',
+}

package/src/retailCustomer/enums/KycModalityEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Modalidad con la que el cliente ejecuta el KYC en el wizard (M1 §213-329).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum KycModalityEnum {
+    CUSTOMER_LINK = 'CUSTOMER_LINK',
+    STORE_DEVICE = 'STORE_DEVICE',
+    MANUAL = 'MANUAL',
+}

package/src/retailCustomer/enums/KycReviewResultEnum.ts

@@ -0,0 +1,8 @@
+/**
+ * Resultado de la revisión manual del oficial de Cumplimiento (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum KycReviewResultEnum {
+    APPROVED = 'APPROVED',
+    REJECTED = 'REJECTED',
+}

package/src/retailCustomer/enums/RetailKycStatusEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado del KYC del cliente retail (vocabulario retail; espejo operativo del KYC de Fiado).
+ * PENDING (sin resultado) · VERIFIED (Metamap OK) · FAILED (incluye PLD) · MANUAL (captura manual,
+ * cae en cola de Cumplimiento) · REVIEW (esperando resolución de Cumplimiento).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum RetailKycStatusEnum {
+    PENDING = 'PENDING',
+    VERIFIED = 'VERIFIED',
+    FAILED = 'FAILED',
+    MANUAL = 'MANUAL',
+    REVIEW = 'REVIEW',
+}

package/src/retailCustomer/events/CustomerCreatedV1.ts

@@ -0,0 +1,7 @@
+/** Emitido cuando se da de alta un cliente retail (→ cola Central). SureKeep Fase 2 — pista Retail. */
+export interface CustomerCreatedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    phone: string;
+    occurredAt: string;
+}

package/src/retailCustomer/events/CustomerKycVerifiedV1.ts

@@ -0,0 +1,28 @@
+import { KycModalityEnum } from '../enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../enums/RetailKycStatusEnum';
+
+/**
+ * Puente retail↔sofom (D24/D35) — emitido en la MISMA TX del `upsert-from-kyc` con el payload OCR
+ * completo. Lo consume `loan-credit-business` (idempotente, hidrata `LoanBorrower_GT`) y dispara la
+ * apertura de cuenta async. También alimenta CDC→Iceberg (atomicidad efectiva por outbox).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface CustomerKycVerifiedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    fiadoDirectoryId: string;
+    fiadoPeopleId: string;
+    phone: string;
+    curp: string;
+    firstName: string;
+    paternalLastName: string;
+    maternalLastName: string | null;
+    birthDate: string;
+    sex: string | null;
+    nationality: string | null;
+    documentValidUntil: string | null;
+    addressRaw: string | null;
+    kycStatus: RetailKycStatusEnum;
+    kycModality: KycModalityEnum;
+    occurredAt: string;
+}

package/src/retailCustomer/events/CustomerUpdatedV1.ts

@@ -0,0 +1,9 @@
+/** Emitido cuando se editan datos de contacto/PII de un cliente retail. SureKeep Fase 2 — pista Retail. */
+export interface CustomerUpdatedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    /** Nombres de los campos modificados (sin sus valores — PII zero-tolerance). */
+    updatedFields: string[];
+    updatedBy: string;
+    occurredAt: string;
+}

package/src/retailCustomer/events/KycApprovedByComplianceV1.ts

@@ -0,0 +1,12 @@
+/**
+ * Emitido cuando el oficial de Cumplimiento APRUEBA un KYC en revisión manual (D21). Dispara post-pasos
+ * idempotentes fuera de la TX (espejo a Fiado + apertura PCF N1 diferida). SureKeep Fase 2 — pista Retail.
+ */
+export interface KycApprovedByComplianceV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    reviewedBy: string;
+    justification: string;
+    metamapVerificationId: string;
+    occurredAt: string;
+}

package/src/retailCustomer/events/KycRejectedByComplianceV1.ts

@@ -0,0 +1,12 @@
+/**
+ * Emitido cuando el oficial de Cumplimiento RECHAZA un KYC en revisión manual (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface KycRejectedByComplianceV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    reviewedBy: string;
+    justification: string;
+    metamapVerificationId: string;
+    occurredAt: string;
+}

package/src/retailCustomer/index.ts

@@ -0,0 +1,27 @@
+// Enums
+export * from './enums/AccountStatusEnum';
+export * from './enums/RetailKycStatusEnum';
+export * from './enums/KycModalityEnum';
+export * from './enums/KycReviewResultEnum';
+
+// Entidades (planas, con class-validator + @Expose)
+export * from './dtos/KycReview';
+export * from './dtos/RetailCustomer';
+
+// Request DTOs (input validado por endpoint)
+export * from './dtos/requests/CreateCustomerRequest';
+export * from './dtos/requests/UpsertCustomerFromKycRequest';
+export * from './dtos/requests/UpdateCustomerRequest';
+export * from './dtos/requests/AccountResultRequest';
+export * from './dtos/requests/KycReviewRequest';
+
+// Response DTOs
+export * from './dtos/responses/CustomerResponse';
+export * from './dtos/responses/Customer360Response';
+
+// Contratos de eventos (PascalCase + sufijo V1)
+export * from './events/CustomerCreatedV1';
+export * from './events/CustomerUpdatedV1';
+export * from './events/CustomerKycVerifiedV1';
+export * from './events/KycApprovedByComplianceV1';
+export * from './events/KycRejectedByComplianceV1';

package/src/retailWizard/dtos/OtpVerification.ts

@@ -0,0 +1,25 @@
+import type { OtpPurposeEnum } from '../enums/OtpPurposeEnum';
+
+/**
+ * Verificación OTP (modelo-datos §2). NO es tabla aparte: vive como ítem en
+ * `<T>RetailWizardSession_GT` (pk `SESSION#<sessionId>` · sk `OTP#<ulid>`) — misma partición de la
+ * sesión → 1 Query trae sesión + OTPs. El código lo genera/valida `messages-business` (D5); aquí
+ * solo trackeamos el `messagesLogId`, nunca el código. SureKeep Fase 2 — pista Retail.
+ */
+export interface OtpVerification {
+  otpId: string;
+  sessionId: string;
+  purpose: OtpPurposeEnum;
+  /** Sustituye al `code_hash` de v0.1 (D5): tracking del envío en messages-business. */
+  messagesLogId: string;
+  channelsDispatched: string[];
+  /** Máx 3 → 423 OTP_MAX_TRIES. */
+  attempts: number;
+  /** 5 min. */
+  expiresAt: string;
+  verifiedAt: string | null;
+  createdBy: string;
+  updatedBy: string;
+  createdAt: number;
+  updatedAt: number;
+}

package/src/retailWizard/dtos/PaginatedResult.ts

@@ -0,0 +1,6 @@
+/** Resultado paginado genérico (cursor opaco `nextToken`). SureKeep Fase 2 — pista Retail. */
+export interface PaginatedResult<T> {
+  items: T[];
+  count: number;
+  nextToken?: string;
+}

package/src/retailWizard/dtos/Prospect.ts

@@ -0,0 +1,33 @@
+import type { ProspectStatusEnum } from '../enums/ProspectStatusEnum';
+import type { PendingReasonEnum } from '../enums/PendingReasonEnum';
+import type { ProspectNewCustomer } from './ProspectNewCustomer';
+
+/**
+ * Prospecto (modelo-datos §4). pk `PROSPECT#<prospectId>` · sk `META` · GSIs
+ * `storeId-nextContactAt-index`, `seller-nextContactAt-index`. La reanudación lee la WizardSession
+ * real (no se duplica el snapshot del wizard). SureKeep Fase 2 — pista Retail.
+ */
+export interface Prospect {
+  prospectId: string;
+  retailerId: string;
+  storeId: string;
+  sellerRetailUserId: string;
+  /** Identificado vs captura manual (uno de los dos). */
+  retailCustomerId: string | null;
+  newCustomer: ProspectNewCustomer | null;
+  productSku: string | null;
+  pendingReason: PendingReasonEnum;
+  /** Obligatorio si `pendingReason=OTHER`; ≤200. */
+  freeReason: string | null;
+  /** Agenda (default mañana); urgencia derivada OVERDUE/TODAY/UPCOMING. */
+  nextContactAt: string;
+  notes: string | null;
+  status: ProspectStatusEnum;
+  wizardSessionId: string | null;
+  saleId: string | null;
+  lastContactAt: string | null;
+  createdBy: string;
+  updatedBy: string;
+  createdAt: number;
+  updatedAt: number;
+}

package/src/retailWizard/dtos/ProspectNewCustomer.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/** Captura manual de un cliente no identificado en un prospecto (`Prospect.newCustomer`). SureKeep Fase 2 — pista Retail. */
+export class ProspectNewCustomer {
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    phone!: string;
+}

package/src/retailWizard/dtos/Sale.ts

@@ -0,0 +1,43 @@
+import type { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import type { SaleStatusEnum } from '../enums/SaleStatusEnum';
+import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
+import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
+import type { SalePaymentDetail } from './SalePaymentDetail';
+
+/**
+ * Venta (modelo-datos §3). pk `SALE#<saleId>` · sk `META` · 4 GSIs (`retailerId-soldAt-index`,
+ * `storeId-soldAt-index`, `seller-soldAt-index`, `customerId-soldAt-index`). Unicidad de folio vía
+ * `UNIQ#FOLIO#<folio>` en la MISMA TransactWriteItems del cierre. SureKeep Fase 2 — pista Retail.
+ */
+export interface Sale {
+  saleId: string;
+  retailerId: string;
+  storeId: string;
+  sellerRetailUserId: string;
+  retailCustomerId: string;
+  wizardSessionId: string;
+  type: SaleTypeEnum;
+  externalProvider: ExternalProviderEnum | null;
+  sku: string;
+  /** IMEI consumido del silo también en contado (local-first); null en EXTERNAL_REFERRAL (D15). */
+  imei: string | null;
+  /** 0 en EXTERNAL_REFERRAL. */
+  amountCents: number;
+  paymentMethod: SalePaymentMethodEnum | null;
+  /** `LG-T{storeCode}-VTA-{5hex}-{YYYY}W{ww}` (D11) — único vía `UNIQ#FOLIO`. */
+  folio: string;
+  paymentDetail: SalePaymentDetail | null;
+  soldAt: string;
+  cardNumberDelivered: string | null;
+  centralSyncStatus: CentralSyncStatusEnum;
+  centralTag: string | null;
+  status: SaleStatusEnum;
+  cancelledAt: string | null;
+  /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
+  cancelReason: string | null;
+  createdBy: string;
+  updatedBy: string;
+  createdAt: number;
+  updatedAt: number;
+}

package/src/retailWizard/dtos/SalePaymentDetail.ts

@@ -0,0 +1,33 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Detalle del pago según el medio (`Sale.paymentDetail`): efectivo `{cashConfirmedInRegister}` ·
+ * tarjeta `{cardLast4, authCode}` · SPEI `{speiTrackingKey, senderClabe?}`. SureKeep Fase 2 — pista Retail.
+ */
+export class SalePaymentDetail {
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    cashConfirmedInRegister?: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    cardLast4?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    authCode?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    speiTrackingKey?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    senderClabe?: string;
+}

package/src/retailWizard/dtos/WizardBeneficiary.ts

@@ -0,0 +1,31 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { BeneficiaryRelationEnum } from '../enums/BeneficiaryRelationEnum';
+
+/**
+ * Beneficiario capturado en el paso 10 (bienvenida N2). Se envía a `IAccountBeneficiaryApi.create`
+ * (expediente wallet Fiado). El cliente puede NO dar beneficiario (opcional en régimen simplificado N1).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export class WizardBeneficiary {
+    @Expose()
+    @IsString()
+    fullName!: string;
+
+    @Expose()
+    @IsEnum(BeneficiaryRelationEnum)
+    relation!: BeneficiaryRelationEnum;
+
+    /** Porcentaje de asignación (1-100). Si hay un solo beneficiario, típicamente 100. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    percentage?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    freeRelation?: string;
+}

package/src/retailWizard/dtos/WizardConsents.ts

@@ -0,0 +1,29 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString, Matches } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+
+/** Consentimientos aceptados en el wizard (VL + contrato PCF). SureKeep Fase 2 — pista Retail. */
+export class WizardConsents {
+    @Expose()
+    @IsString()
+    vlTermsVersion!: string;
+
+    @Expose()
+    @IsString()
+    pcfContractVersion!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'acceptedAt debe ser una fecha ISO 8601' })
+    acceptedAt!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    ip?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    deviceFingerprint?: string;
+}

package/src/retailWizard/dtos/WizardPayment.ts

@@ -0,0 +1,26 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Matches, Min } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+
+/** Registro del pago de contado dentro de la sesión (`WizardSession.payment`). SureKeep Fase 2 — pista Retail. */
+export class WizardPayment {
+    @Expose()
+    @IsEnum(SalePaymentMethodEnum)
+    method!: SalePaymentMethodEnum;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    amountCents!: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    detail?: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'paidAt debe ser una fecha ISO 8601' })
+    paidAt!: string;
+}

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;
+}