@fiado/type-kit 3.471.0 → 3.473.0

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

@@ -0,0 +1,45 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsOptional, IsString, Min, ValidateIf } from 'class-validator';
+
+const hasPromotion = (o: ApplyLinePromotionRequest): boolean =>
+  o.promotionId !== undefined || o.promotionVersion !== undefined;
+
+/**
+ * PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion (privateApplyLinePromotion, M2M de Promociones).
+ * Reemplaza la promo de la línea por valor: un campo ausente queda borrado. `tenantId` va en el query.
+ * Nunca toca role ni linkedLineId: los GIFT los gestiona el PUT …/gifts. Responde 204 sin body.
+ */
+export class ApplyLinePromotionRequest {
+  @Expose()
+  @ValidateIf(hasPromotion)
+  @IsString()
+  @IsNotEmpty()
+  promotionId?: string;
+
+  /** Va junto con promotionId; las versiones de Promociones empiezan en 1. */
+  @Expose()
+  @ValidateIf(hasPromotion)
+  @IsInt()
+  @Min(1)
+  promotionVersion?: number;
+
+  /** Solo en la línea ancla. */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  discountCode?: string;
+
+  /** Descuento total de la línea; 0 mientras el código espera revalidarse. */
+  @Expose()
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  discountCents?: number;
+
+  @Expose()
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  originalPriceCents?: number;
+}

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

@@ -0,0 +1,24 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsString, Min, ValidateIf } from 'class-validator';
+
+/**
+ * PUT /private/wizard/sessions/{id}/sale-promotion (privateApplySalePromotion, M2M de Promociones).
+ * Ambos en `null` = «Ninguna»; la versión va solo con la promo. `tenantId` va en el query.
+ * Responde 204 sin body.
+ */
+export class ApplySalePromotionRequest {
+  @Expose()
+  @ValidateIf(
+    (o: ApplySalePromotionRequest) =>
+      o.salePromotionId !== null || (o.salePromotionVersion !== null && o.salePromotionVersion !== undefined),
+  )
+  @IsString()
+  @IsNotEmpty()
+  salePromotionId!: string | null;
+
+  @Expose()
+  @ValidateIf((o: ApplySalePromotionRequest) => o.salePromotionId !== null && o.salePromotionId !== undefined)
+  @IsInt()
+  @Min(1)
+  salePromotionVersion!: number | null;
+}

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

@@ -0,0 +1,40 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsNotEmpty, IsString, ValidateNested } from 'class-validator';
+
+/** Componente de la línea con los identificadores de sus piezas. */
+export class PinSessionPiecesComponent {
+  @Expose()
+  @IsString()
+  @IsNotEmpty()
+  sku!: string;
+
+  @Expose()
+  @IsArray()
+  @IsString({ each: true })
+  identifiers!: string[];
+}
+
+/** Línea de la sesión cuyas piezas se fijan. */
+export class PinSessionPiecesLine {
+  @Expose()
+  @IsString()
+  @IsNotEmpty()
+  lineId!: string;
+
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => PinSessionPiecesComponent)
+  components!: PinSessionPiecesComponent[];
+}
+
+/** POST /wizard/sessions/:id/pieces (publicPinSessionPieces) — deja HELD las piezas de las líneas. */
+export class PinSessionPiecesRequest {
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => PinSessionPiecesLine)
+  lines!: PinSessionPiecesLine[];
+}

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

@@ -19,7 +19,7 @@ export class QuoteRequest {
     @Min(1)
     termWeeks!: number;
 
-    /** Línea que se financia; su precio fijado es el del crédito. */
+    /** Se ignora: el servidor financia la ancla. Se acepta un release más por el front viejo. */
     @Expose()
     @IsOptional()
     @IsString()

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

@@ -0,0 +1,40 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsInt, IsNotEmpty, IsString, Min, ValidateIf, ValidateNested } from 'class-validator';
+
+/** Un regalo del conjunto que queda ligado al ancla. */
+export class AnchorGiftItem {
+  @Expose()
+  @IsString()
+  @IsNotEmpty()
+  sku!: string;
+}
+
+/** Hay que validar el campo si hay regalos o si vino con valor. */
+function mustValidate(o: SetAnchorGiftsRequest, value: unknown): boolean {
+  return (Array.isArray(o.items) && o.items.length > 0) || (value !== null && value !== undefined);
+}
+
+/**
+ * PUT /private/wizard/sessions/{id}/lines/{anchorLineId}/gifts (M2M de Promociones).
+ * Deja exactamente esos GIFT en el ancla; `items: []` suelta todos. `tenantId` va en el query.
+ */
+export class SetAnchorGiftsRequest {
+  /** Obligatorio si hay regalos; puede ir `null` con `items: []`. */
+  @Expose()
+  @ValidateIf((o: SetAnchorGiftsRequest) => mustValidate(o, o.promotionId))
+  @IsString()
+  @IsNotEmpty()
+  promotionId!: string | null;
+
+  @Expose()
+  @ValidateIf((o: SetAnchorGiftsRequest) => mustValidate(o, o.promotionVersion))
+  @IsInt()
+  @Min(1)
+  promotionVersion!: number | null;
+
+  @Expose()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => AnchorGiftItem)
+  items!: AnchorGiftItem[];
+}

package/src/retailWizard/dtos/responses/PrivateWizardSessionResponse.ts

@@ -0,0 +1,30 @@
+import type { PaymentMethodEnum } from '../../enums/PaymentMethodEnum';
+import type { WizardStateEnum } from '../../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+import type { WizardPayment } from '../WizardPayment';
+import type { WizardReservedLine } from '../WizardReservedLine';
+
+/** GET /private/wizard/sessions/{id} (privateGetWizardSession): lo que Promociones lee de la sesión. */
+export interface PrivateWizardSessionResponse {
+  sessionId: string;
+  retailerId: string;
+  storeId: string;
+  /** `null` mientras el KYC no dé de alta al cliente. */
+  retailCustomerId: string | null;
+  state: WizardStateEnum;
+  currentStep: WizardStepEnum;
+  /** `loan.creditId`; `null` en contado o antes de originar. */
+  creditId: string | null;
+  /** Línea ancla (teléfono o kit) que deriva el servidor; `null` si aún no hay. */
+  anchorLineId: string | null;
+  salePromotionId: string | null;
+  salePromotionVersion: number | null;
+  /** Líneas vivas con los campos de Promociones y financedCents. */
+  lines: WizardReservedLine[];
+  fiadoDirectoryId?: string | null;
+  folio?: string | null;
+  /** Forma de pago que eligió el vendedor; existe antes que `creditId`. */
+  paymentMethod?: PaymentMethodEnum | null;
+  /** Cobro de contado; `null` mientras no se cobra. */
+  payment?: WizardPayment | null;
+}

package/src/retailWizard/dtos/responses/SetAnchorGiftsResponse.ts

@@ -0,0 +1,6 @@
+import type { WizardGiftLine } from '../WizardGiftLine';
+
+/** Respuesta del PUT de regalos: las líneas GIFT que quedaron ligadas al ancla. */
+export interface SetAnchorGiftsResponse {
+  lines: WizardGiftLine[];
+}

package/src/retailWizard/enums/RetailPromotionInboundMessageTypeEnum.ts

@@ -0,0 +1,5 @@
+/** Tipo de mensaje que el wizard publica en la cola de Promociones. */
+export enum RetailPromotionInboundMessageTypeEnum {
+    SALE_CONFIRMED = 'SALE_CONFIRMED',
+    SALE_CANCELLED = 'SALE_CANCELLED',
+}

package/src/retailWizard/enums/WizardLineRoleEnum.ts

@@ -0,0 +1,4 @@
+/** Papel especial de una línea; sin `role` es una línea normal. */
+export enum WizardLineRoleEnum {
+    GIFT = 'GIFT',
+}

package/src/retailWizard/events/RetailCommissionInboundMessage.ts

@@ -0,0 +1,54 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsEnum, IsISO8601, IsInt, IsNotEmpty, IsString, Min, ValidateNested } from 'class-validator';
+import { ItemTypeEnum } from '../../retailCatalog/enums/ItemTypeEnum';
+
+/** Línea vendida en el mensaje de comisiones. */
+export class RetailCommissionInboundLine {
+    @IsString()
+    @IsNotEmpty()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    /** Precio neto de la línea (precio − descuento). */
+    @IsInt()
+    @Min(0)
+    netCents!: number;
+
+    @IsEnum(ItemTypeEnum)
+    itemType!: ItemTypeEnum;
+}
+
+/** Venta de la saga que el wizard publica en la cola de comisiones, con sus líneas. */
+export class RetailCommissionInboundMessage {
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    @IsISO8601()
+    soldAt!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => RetailCommissionInboundLine)
+    lines!: RetailCommissionInboundLine[];
+}

package/src/retailWizard/events/RetailPromotionInboundMessage.ts

@@ -0,0 +1,138 @@
+import { Type } from 'class-transformer';
+import {
+    ArrayMinSize,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsISO8601,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { RetailPromotionInboundMessageTypeEnum } from '../enums/RetailPromotionInboundMessageTypeEnum';
+import { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
+
+/** Línea de la venta en el mensaje de Promociones. */
+export class RetailPromotionInboundLine {
+    @IsString()
+    @IsNotEmpty()
+    lineId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    @IsOptional()
+    @IsEnum(WizardLineRoleEnum)
+    role?: WizardLineRoleEnum;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    linkedLineId?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    promotionId?: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    promotionVersion?: number;
+
+    /** Solo en la línea ancla. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    discountCode?: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    discountCents?: number;
+
+    /** Si la línea no lo trae, basePriceCents × qty. */
+    @IsInt()
+    @Min(0)
+    originalPriceCents!: number;
+
+    /** Identificadores de todos los componentes de la línea, aplanados. */
+    @IsArray()
+    @IsString({ each: true })
+    identifiers!: string[];
+
+    /** Solo en SALE_CANCELLED: la pieza regresó al inventario. */
+    @IsOptional()
+    @IsBoolean()
+    returned?: boolean;
+}
+
+/** Venta confirmada o cancelada que el wizard publica en RetailPromotionInboundQueue; crédito = trae creditId. */
+export class RetailPromotionInboundMessage {
+    @IsEnum(RetailPromotionInboundMessageTypeEnum)
+    type!: RetailPromotionInboundMessageTypeEnum;
+
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    /** El retailCustomerId de la venta. */
+    @IsString()
+    @IsNotEmpty()
+    customerId!: string;
+
+    @IsISO8601()
+    soldAt!: string;
+
+    /** soldAt en la confirmación; cancelledAt en la cancelación. */
+    @IsISO8601()
+    occurredAt!: string;
+
+    @IsOptional()
+    @IsString()
+    creditId?: string;
+
+    @IsOptional()
+    @IsString()
+    fiadoDirectoryId?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    salePromotionId?: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    salePromotionVersion?: number;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => RetailPromotionInboundLine)
+    lines!: RetailPromotionInboundLine[];
+}

package/src/retailWizard/events/SaleCompletedV1.ts

@@ -14,9 +14,8 @@ export interface SaleCompletedV1 {
   sku: string;
   imei: string | null;
   /**
-   * Lo COBRADO en caja al cerrar (contrato histórico — La Central y comisión F4 lo asumen así).
-   * En contado == precio del equipo; en CREDIT es SOLO el enganche: desambiguar con `type` +
-   * `equipmentPriceCents`, NUNCA redefinir este campo.
+   * Lo cobrado en caja al cerrar: enganche + lo no financiado (en contado, el total).
+   * Desambiguar con `type` + `equipmentPriceCents`.
    */
   amountCents: number;
   /**

package/src/retailWizard/index.ts

@@ -26,6 +26,7 @@ export * from './enums/BlockedReasonEnum';
 export * from './enums/BlockedCategoryEnum';
 export * from './enums/WizardLineStatusEnum';
 export * from './enums/LinePaymentTypeEnum';
+export * from './enums/WizardLineRoleEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -43,7 +44,10 @@ export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardBlocked';
 export * from './dtos/WizardLineProduct';
 export * from './dtos/WizardLineIdentifiers';
+export * from './dtos/WizardLinePromotionFields';
+export * from './dtos/WizardFinancingPreview';
 export * from './dtos/WizardReservedLine';
+export * from './dtos/WizardGiftLine';
 export * from './dtos/SaleLine';
 
 // Entidades principales (shapes de estado/persistencia — planas)
@@ -68,6 +72,10 @@ export * from './dtos/requests/KycManualRequest';
 export * from './dtos/requests/ProofOfAddressPrepareRequest';
 export * from './dtos/requests/OccupationRequest';
 export * from './dtos/requests/AddProductRequest';
+export * from './dtos/requests/PinSessionPiecesRequest';
+export * from './dtos/requests/ApplyLinePromotionRequest';
+export * from './dtos/requests/SetAnchorGiftsRequest';
+export * from './dtos/requests/ApplySalePromotionRequest';
 export * from './dtos/requests/DeleteProductRequest';
 export * from './dtos/requests/SetPaymentMethodRequest';
 export * from './dtos/requests/ExternalReferralRequest';
@@ -156,8 +164,15 @@ export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';
 export * from './events/SaleCancelledV2';
 export * from './events/SessionExpiredV1';
+export * from './enums/RetailPromotionInboundMessageTypeEnum';
+export * from './events/RetailPromotionInboundMessage';
+export * from './events/RetailCommissionInboundMessage';
 
 // Lookup privado por lote (GET /private/wizard-sessions/batch)
 export * from './enums/WizardSessionLookupStatusEnum';
 export * from './dtos/WizardSessionLookupEntry';
 export * from './dtos/responses/WizardSessionLookupResponse';
+
+// M2M de Promociones (lectura privada de la sesión y regalo)
+export * from './dtos/responses/PrivateWizardSessionResponse';
+export * from './dtos/responses/SetAnchorGiftsResponse';