@fiado/type-kit 3.460.0 → 3.461.0

package/src/retailWizard/dtos/WizardSession.ts

@@ -9,6 +9,7 @@ import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
+import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 
@@ -112,6 +113,10 @@ export interface WizardSession {
    */
   product: WizardProduct | null;
   reservationExpiresAt: string | null;
+  /** Líneas de la venta; `reservedSku`, `reservedImei` y `product` espejan la financiada o la principal. */
+  reservedLines?: WizardReservedLine[];
+  /** Línea elegida para financiar; `null` si la venta es de contado o aún no se elige. */
+  financedLineId?: string | null;
   paymentMethod: PaymentMethodEnum | null;
   externalProvider: ExternalProviderEnum | null;
   /** Folio de cobro server-side (D11), idempotente, sobrevive al volver atrás. */

package/src/retailWizard/dtos/requests/AddProductRequest.ts

@@ -2,14 +2,8 @@ import { Expose } from 'class-transformer';
 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).
- *
- * `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.
+ * POST /wizard/sessions/:id/product — agrega una línea a la venta y reserva sus piezas en el catálogo.
+ * `imei` y `cashPriceCents` son opcionales: la pieza y el precio los decide el servidor.
  */
 export class AddProductRequest {
   @Expose()
@@ -26,4 +20,11 @@ export class AddProductRequest {
   @IsInt()
   @Min(0)
   cashPriceCents?: number;
+
+  /** Piezas de la línea; ausente = 1. */
+  @Expose()
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  qty?: number;
 }

package/src/retailWizard/dtos/requests/CompleteSaleRequest.ts

@@ -0,0 +1,41 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsOptional, IsString, MinLength, ValidateNested } from 'class-validator';
+
+/** Identificadores capturados en la entrega para un SKU de la línea (componente si es kit). */
+export class CompleteSaleLineComponent {
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    sku!: string;
+
+    /** Vacío si el SKU se rastrea por cantidad. */
+    @Expose()
+    @IsArray()
+    @IsString({ each: true })
+    identifiers!: string[];
+}
+
+/** Línea de la sesión con los identificadores de sus piezas. */
+export class CompleteSaleLine {
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    lineId!: string;
+
+    @Expose()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CompleteSaleLineComponent)
+    components!: CompleteSaleLineComponent[];
+}
+
+/** POST /wizard/sessions/:id/complete-sale — cierra la venta con los identificadores de cada línea. */
+export class CompleteSaleRequest {
+    /** Opcional: el front previo cierra sin body; el wizard exige los identificadores que falten. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CompleteSaleLine)
+    lines?: CompleteSaleLine[];
+}

package/src/retailWizard/dtos/requests/DeleteProductRequest.ts

@@ -1,11 +1,17 @@
 import { Expose } from 'class-transformer';
 import { IsOptional, IsString } from 'class-validator';
 
-/** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
+/** DELETE /wizard/sessions/:id/product — quita una línea de la venta y libera su reserva en el catálogo. */
 export class DeleteProductRequest {
   /** Opcional a propósito: exigirlo rompe a los callers que liberan la reserva sin mandar el imei. */
   @Expose()
   @IsOptional()
   @IsString()
   imei?: string;
+
+  /** Línea a quitar de la venta. */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  lineId?: string;
 }

package/src/retailWizard/dtos/requests/QuoteRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsInt, Min } from 'class-validator';
+import { IsInt, IsOptional, IsString, Min, MinLength } from 'class-validator';
 
 /**
  * POST /wizard/sessions/:id/quote — términos elegidos en el cotizador del paso 06 (slider de
@@ -18,4 +18,11 @@ export class QuoteRequest {
     @IsInt()
     @Min(1)
     termWeeks!: number;
+
+    /** Línea que se financia; su precio fijado es el del crédito. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MinLength(1)
+    financedLineId?: string;
 }

package/src/retailWizard/dtos/requests/SuggestIdentifiersQuery.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsString, MinLength } from 'class-validator';
+
+/** Query de GET /wizard/sessions/:id/lines/:lineId/identifiers; sku es el componente si la línea es kit. */
+export class SuggestIdentifiersQuery {
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    sku!: string;
+
+    @Expose()
+    @IsString()
+    @MinLength(4)
+    prefix!: string;
+}

package/src/retailWizard/enums/LinePaymentTypeEnum.ts

@@ -0,0 +1,7 @@
+/** Forma de pago de una línea de la venta. */
+export enum LinePaymentTypeEnum {
+    /** Financiada con crédito SureKeep. */
+    CREDIT = 'CREDIT',
+    /** De contado (o con tarjeta), junto con el enganche. */
+    CASH = 'CASH',
+}

package/src/retailWizard/enums/WizardLineStatusEnum.ts

@@ -0,0 +1,9 @@
+/** Estado de una línea reservada de la sesión. */
+export enum WizardLineStatusEnum {
+    /** Escrita con su reservationId, antes de que el catálogo confirme la reserva. */
+    PENDING = 'PENDING',
+    /** El catálogo confirmó la reserva y fijó precio. */
+    RESERVED = 'RESERVED',
+    /** Marcada para liberar; pago y enganche la rechazan. */
+    RELEASING = 'RELEASING',
+}

package/src/retailWizard/index.ts

@@ -24,6 +24,8 @@ export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
 export * from './enums/BlockedCategoryEnum';
+export * from './enums/WizardLineStatusEnum';
+export * from './enums/LinePaymentTypeEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -39,6 +41,10 @@ export * from './dtos/AccountStep';
 export * from './dtos/AppOnboardingStep';
 export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardBlocked';
+export * from './dtos/WizardLineProduct';
+export * from './dtos/WizardLineIdentifiers';
+export * from './dtos/WizardReservedLine';
+export * from './dtos/SaleLine';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';
@@ -80,6 +86,8 @@ export * from './dtos/requests/QuoteRequest';
 export * from './dtos/requests/DownPaymentRequest';
 export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
+export * from './dtos/requests/CompleteSaleRequest';
+export * from './dtos/requests/SuggestIdentifiersQuery';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';