@fiado/type-kit 3.216.0 → 3.217.0

package/bin/retailWizard/dtos/WizardProduct.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Ficha COMERCIAL del equipo reservado, congelada en la sesión al momento de reservarlo (S03).
+ *
+ * **Por qué un snapshot y no una lectura del catálogo en cada `GET`:**
+ * 1. Una venta se cotiza al instante en que se reserva. Si el catálogo cambia el precio o retira el
+ *    modelo mientras el vendedor sigue en el wizard, la venta en curso NO debe cambiar debajo de él
+ *    — el precio ancla el cobro (`amountCents == cashPrice`) y el contrato ya se le mostró al cliente.
+ * 2. El front pollea la sesión cada 3–5 s durante el KYC (D20). Resolver el catálogo en cada lectura
+ *    convertiría ese poll en un llamado cross-lambda por tick.
+ *
+ * Lo llena `addProduct`, que YA consulta el catálogo para elegir la unidad física y su precio: los
+ * datos salen de la MISMA lectura, sin viajes extra.
+ *
+ * ⚠️ NO lleva `stock`: es volátil por definición y no describe la unidad ya reservada (que por
+ * definición dejó de estar disponible). El stock vive en el catálogo y solo importa en el paso 03.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardProduct {
+    /** SKU del modelo comercial. Espeja `WizardSession.reservedSku`. */
+    sku: string;
+    /** Unidad física reservada. Espeja `WizardSession.reservedImei`. */
+    imei: string;
+    /**
+     * Precio de contado en centavos, TAL COMO estaba en el catálogo al reservar. Es el ancla del
+     * cobro: `registerPayment` exige `amountCents == cashPriceCents`.
+     */
+    cashPriceCents: number;
+    brand: string;
+    model: string;
+    capacity: string;
+    color: string;
+    imageUrl: string | null;
+    /** Gama del equipo (`PREMIUM` / `HIGH` / `MID` …). La define el catálogo, no el wizard. */
+    tier: string;
+    /**
+     * Financieras alternativas elegibles para este producto (derivación externa, paso 04).
+     * Mismo nombre que en `retail-catalog`: es su dato, no se renombra al cruzar la frontera.
+     */
+    eligibleFinanciers: string[];
+}

package/bin/retailWizard/dtos/WizardProduct.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailWizard/dtos/WizardSession.d.ts

@@ -7,6 +7,7 @@ import type { OccupationEnum } from '../enums/OccupationEnum';
 import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
+import type { WizardProduct } from './WizardProduct';
 import type { WizardWelcome } from './WizardWelcome';
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
@@ -46,6 +47,12 @@ export interface WizardSession {
     accountStatus: AccountStatus | null;
     reservedSku: string | null;
     reservedImei: string | null;
+    /**
+     * Ficha comercial del equipo reservado (marca, modelo, precio, financieras), congelada al
+     * reservar. `reservedSku`/`reservedImei` siguen siendo la fuente de verdad de QUÉ unidad está
+     * tomada; esto es lo que hace falta para PINTARLA sin volver al catálogo. Null antes del S03.
+     */
+    product: WizardProduct | null;
     reservationExpiresAt: string | null;
     paymentMethod: PaymentMethodEnum | null;
     externalProvider: ExternalProviderEnum | null;

package/bin/retailWizard/index.d.ts

@@ -14,6 +14,7 @@ export * from './enums/OccupationEnum';
 export * from './enums/BeneficiaryRelationEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
+export * from './dtos/WizardProduct';
 export * from './dtos/WizardWelcome';
 export * from './dtos/SalePaymentDetail';
 export * from './dtos/ProspectNewCustomer';

package/bin/retailWizard/index.js

@@ -32,6 +32,7 @@ __exportStar(require("./enums/BeneficiaryRelationEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
+__exportStar(require("./dtos/WizardProduct"), exports);
 __exportStar(require("./dtos/WizardWelcome"), exports);
 __exportStar(require("./dtos/SalePaymentDetail"), exports);
 __exportStar(require("./dtos/ProspectNewCustomer"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.216.0",
+  "version": "3.217.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/retailWizard/dtos/WizardProduct.ts

@@ -0,0 +1,41 @@
+/**
+ * Ficha COMERCIAL del equipo reservado, congelada en la sesión al momento de reservarlo (S03).
+ *
+ * **Por qué un snapshot y no una lectura del catálogo en cada `GET`:**
+ * 1. Una venta se cotiza al instante en que se reserva. Si el catálogo cambia el precio o retira el
+ *    modelo mientras el vendedor sigue en el wizard, la venta en curso NO debe cambiar debajo de él
+ *    — el precio ancla el cobro (`amountCents == cashPrice`) y el contrato ya se le mostró al cliente.
+ * 2. El front pollea la sesión cada 3–5 s durante el KYC (D20). Resolver el catálogo en cada lectura
+ *    convertiría ese poll en un llamado cross-lambda por tick.
+ *
+ * Lo llena `addProduct`, que YA consulta el catálogo para elegir la unidad física y su precio: los
+ * datos salen de la MISMA lectura, sin viajes extra.
+ *
+ * ⚠️ NO lleva `stock`: es volátil por definición y no describe la unidad ya reservada (que por
+ * definición dejó de estar disponible). El stock vive en el catálogo y solo importa en el paso 03.
+ *
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardProduct {
+    /** SKU del modelo comercial. Espeja `WizardSession.reservedSku`. */
+    sku: string;
+    /** Unidad física reservada. Espeja `WizardSession.reservedImei`. */
+    imei: string;
+    /**
+     * Precio de contado en centavos, TAL COMO estaba en el catálogo al reservar. Es el ancla del
+     * cobro: `registerPayment` exige `amountCents == cashPriceCents`.
+     */
+    cashPriceCents: number;
+    brand: string;
+    model: string;
+    capacity: string;
+    color: string;
+    imageUrl: string | null;
+    /** Gama del equipo (`PREMIUM` / `HIGH` / `MID` …). La define el catálogo, no el wizard. */
+    tier: string;
+    /**
+     * Financieras alternativas elegibles para este producto (derivación externa, paso 04).
+     * Mismo nombre que en `retail-catalog`: es su dato, no se renombra al cruzar la frontera.
+     */
+    eligibleFinanciers: string[];
+}

package/src/retailWizard/dtos/WizardSession.ts

@@ -7,6 +7,7 @@ import type { OccupationEnum } from '../enums/OccupationEnum';
 import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
+import type { WizardProduct } from './WizardProduct';
 import type { WizardWelcome } from './WizardWelcome';
 
 /** Modalidad de captura del KYC (M1 §213-329). */
@@ -49,6 +50,12 @@ export interface WizardSession {
   accountStatus: AccountStatus | null;
   reservedSku: string | null;
   reservedImei: string | null;
+  /**
+   * Ficha comercial del equipo reservado (marca, modelo, precio, financieras), congelada al
+   * reservar. `reservedSku`/`reservedImei` siguen siendo la fuente de verdad de QUÉ unidad está
+   * tomada; esto es lo que hace falta para PINTARLA sin volver al catálogo. Null antes del S03.
+   */
+  product: WizardProduct | null;
   reservationExpiresAt: string | null;
   paymentMethod: PaymentMethodEnum | null;
   externalProvider: ExternalProviderEnum | null;

package/src/retailWizard/index.ts

@@ -17,6 +17,7 @@ export * from './enums/BeneficiaryRelationEnum';
 // DTOs anidados
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
+export * from './dtos/WizardProduct';
 export * from './dtos/WizardWelcome';
 export * from './dtos/SalePaymentDetail';
 export * from './dtos/ProspectNewCustomer';