@fiado/type-kit 3.215.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/dtos/requests/AddProductRequest.d.ts

@@ -1,10 +1,15 @@
 /**
  * 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.
+ * RetailInventory F1 (condición atómica H2).
+ *
+ * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
+ * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
+ * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
+ * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
+ * SureKeep Fase 2 — pista Retail.
  */
 export declare class AddProductRequest {
     sku: string;
-    imei: string;
-    cashPriceCents: number;
+    imei?: string;
+    cashPriceCents?: number;
 }

package/bin/retailWizard/dtos/requests/AddProductRequest.js

@@ -14,8 +14,13 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("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.
+ * RetailInventory F1 (condición atómica H2).
+ *
+ * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
+ * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
+ * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
+ * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
+ * SureKeep Fase 2 — pista Retail.
  */
 class AddProductRequest {
 }
@@ -27,11 +32,13 @@ __decorate([
 ], AddProductRequest.prototype, "sku", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AddProductRequest.prototype, "imei", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)

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.215.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/dtos/requests/AddProductRequest.ts

@@ -1,10 +1,15 @@
 import { Expose } from 'class-transformer';
-import { IsInt, IsString, Min } from 'class-validator';
+import { IsInt, IsOptional, 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.
+ * RetailInventory F1 (condición atómica H2).
+ *
+ * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
+ * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
+ * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
+ * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
+ * SureKeep Fase 2 — pista Retail.
  */
 export class AddProductRequest {
   @Expose()
@@ -12,11 +17,13 @@ export class AddProductRequest {
   sku!: string;
 
   @Expose()
+  @IsOptional()
   @IsString()
-  imei!: string;
+  imei?: string;
 
   @Expose()
+  @IsOptional()
   @IsInt()
   @Min(0)
-  cashPriceCents!: number;
+  cashPriceCents?: number;
 }

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';