@fiado/type-kit 3.194.0 → 3.196.0

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

package/src/retailWizard/index.ts

@@ -0,0 +1,65 @@
+// Enums
+export * from './enums/WizardStateEnum';
+export * from './enums/WizardStepEnum';
+export * from './enums/OtpPurposeEnum';
+export * from './enums/FiadoPhoneStatusEnum';
+export * from './enums/PaymentMethodEnum';
+export * from './enums/ExternalProviderEnum';
+export * from './enums/SaleTypeEnum';
+export * from './enums/SalePaymentMethodEnum';
+export * from './enums/SaleStatusEnum';
+export * from './enums/CentralSyncStatusEnum';
+export * from './enums/ProspectStatusEnum';
+export * from './enums/PendingReasonEnum';
+export * from './enums/OccupationEnum';
+export * from './enums/BeneficiaryRelationEnum';
+
+// DTOs anidados
+export * from './dtos/WizardConsents';
+export * from './dtos/WizardPayment';
+export * from './dtos/WizardWelcome';
+export * from './dtos/SalePaymentDetail';
+export * from './dtos/ProspectNewCustomer';
+export * from './dtos/WizardBeneficiary';
+
+// Entidades principales (shapes de estado/persistencia — planas)
+export * from './dtos/WizardSession';
+export * from './dtos/OtpVerification';
+export * from './dtos/Sale';
+export * from './dtos/Prospect';
+
+// Paginación genérica
+export * from './dtos/PaginatedResult';
+
+// Request DTOs (input validado por endpoint)
+export * from './dtos/requests/StartSessionRequest';
+export * from './dtos/requests/CancelSessionRequest';
+export * from './dtos/requests/VerifyOtpRequest';
+export * from './dtos/requests/ResendOtpRequest';
+export * from './dtos/requests/SkipOtpRequest';
+export * from './dtos/requests/ConsentsRequest';
+export * from './dtos/requests/KycPrepareRequest';
+export * from './dtos/requests/KycConfirmRequest';
+export * from './dtos/requests/KycManualRequest';
+export * from './dtos/requests/OccupationRequest';
+export * from './dtos/requests/AddProductRequest';
+export * from './dtos/requests/DeleteProductRequest';
+export * from './dtos/requests/SetPaymentMethodRequest';
+export * from './dtos/requests/ExternalReferralRequest';
+export * from './dtos/requests/RegisterPaymentRequest';
+export * from './dtos/requests/CompleteSaleRequest';
+export * from './dtos/requests/AppInstallLinkRequest';
+export * from './dtos/requests/MarkPcfCardDeliveredRequest';
+export * from './dtos/requests/ConfirmAddressRequest';
+export * from './dtos/requests/SaveBeneficiaryRequest';
+export * from './dtos/requests/SignBeneficiaryAnnexRequest';
+export * from './dtos/requests/WelcomeTopupRequest';
+export * from './dtos/requests/CreateProspectRequest';
+export * from './dtos/requests/UpdateProspectRequest';
+export * from './dtos/requests/MarkProspectLostRequest';
+export * from './dtos/requests/CancelSaleRequest';
+
+// Contratos de eventos (PascalCase + sufijo V1)
+export * from './events/SaleCompletedV1';
+export * from './events/SaleCancelledV1';
+export * from './events/SessionExpiredV1';