@fiado/type-kit 3.496.0 → 3.498.0

package/_test_/unit/retailPromotions/evaluatedSalePromotion.test.ts

@@ -1,6 +1,7 @@
 import 'reflect-metadata';
 import {
   EvaluatedSalePromotion,
+  PromotionAppliesToEnum,
   RetailPromotionsErrorCodeEnum,
   SalePromotionKindEnum,
 } from '../../../src/retailPromotions/index';
@@ -17,6 +18,7 @@ const basePromotion: EvaluatedSalePromotion = {
   giftOptions: [],
   giftChooseCount: null,
   afterSale: [],
+  appliesTo: PromotionAppliesToEnum.SUREKEEP_ONLY,
 };
 
 describe('EvaluatedSalePromotion.blockedBy', () => {

package/_test_/unit/retailPromotions/resolveSalePromotionKind.test.ts

@@ -1,6 +1,7 @@
 import 'reflect-metadata';
 import {
   EvaluatedSalePromotion,
+  PromotionAppliesToEnum,
   SalePromotionKindEnum,
   SalePromotionLeverEnum,
   resolveSalePromotionKind,
@@ -40,6 +41,7 @@ describe('EvaluatedSalePromotion.kind', () => {
       giftOptions: [],
       giftChooseCount: 1,
       afterSale: [],
+      appliesTo: PromotionAppliesToEnum.SUREKEEP_ONLY,
     };
     expect(promotion.kind).toBe(SalePromotionKindEnum.GIFT);
   });

package/_test_/unit/retailPromotions/salePromotionConditions.test.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+import {
+  EvaluatedSalePromotion,
+  PromotionAppliesToEnum,
+  RetailPromotionsErrorCodeEnum,
+  SalePromotionConditions,
+  SalePromotionKindEnum,
+  StoreSalePromotionItem,
+} from '../../../src/retailPromotions/index';
+
+const storeItem: StoreSalePromotionItem = {
+  promotionId: 'promo-1',
+  version: 1,
+  name: 'Regalo',
+  customerText: 'Llévate un regalo',
+  levers: { gift: null, deviceDiscount: null, accessoryDiscount: null, coupon: null, walletBonus: null, extendedWarranty: null, airtime: null },
+  scope: { storeIds: null, productCategories: null, tiers: null, skus: null },
+  appliesTo: PromotionAppliesToEnum.ANY_FINANCIER,
+};
+
+const evaluated: EvaluatedSalePromotion = {
+  promotionId: 'promo-1',
+  version: 1,
+  kind: SalePromotionKindEnum.SALE,
+  name: 'Regalo',
+  customerText: 'Llévate un regalo',
+  levers: [],
+  lines: [],
+  totalDiscountCents: 0,
+  giftOptions: [],
+  giftChooseCount: null,
+  afterSale: [],
+  appliesTo: PromotionAppliesToEnum.SUREKEEP_ONLY,
+};
+
+describe('SalePromotionConditions', () => {
+  it('todas sus llaves son opcionales', () => {
+    const none: SalePromotionConditions = {};
+    expect(Object.keys(none)).toHaveLength(0);
+  });
+
+  it('acepta las tres condiciones del cliente', () => {
+    const all: SalePromotionConditions = { oncePerCustomer: true, requiresActiveSurekeepCredit: true, segmentIds: ['seg-1'] };
+    expect(all.segmentIds).toEqual(['seg-1']);
+  });
+});
+
+describe('StoreSalePromotionItem', () => {
+  it('trae appliesTo y no trae condiciones ni bloqueo cuando no aplican', () => {
+    expect(storeItem.appliesTo).toBe(PromotionAppliesToEnum.ANY_FINANCIER);
+    expect(storeItem.conditions).toBeUndefined();
+    expect(storeItem.blockedBy).toBeUndefined();
+  });
+
+  it('acepta condiciones y el motivo de bloqueo', () => {
+    const blocked: StoreSalePromotionItem = {
+      ...storeItem,
+      conditions: { oncePerCustomer: true },
+      blockedBy: RetailPromotionsErrorCodeEnum.CUSTOMER_NOT_IDENTIFIED,
+    };
+    expect(blocked.blockedBy).toBe(RetailPromotionsErrorCodeEnum.CUSTOMER_NOT_IDENTIFIED);
+  });
+});
+
+describe('EvaluatedSalePromotion', () => {
+  it('trae appliesTo y condiciones opcionales', () => {
+    const withConditions: EvaluatedSalePromotion = { ...evaluated, conditions: { requiresActiveSurekeepCredit: true } };
+    expect(withConditions.appliesTo).toBe(PromotionAppliesToEnum.SUREKEEP_ONLY);
+    expect(withConditions.conditions?.requiresActiveSurekeepCredit).toBe(true);
+  });
+});

package/bin/retailPromotions/dtos/responses/WizardSalePromotionResponses.d.ts

@@ -2,6 +2,7 @@ import { CouponScopeEnum } from '../../enums/CouponScopeEnum';
 import { CouponStatusEnum } from '../../enums/CouponStatusEnum';
 import { EntitlementKindEnum } from '../../enums/EntitlementKindEnum';
 import { EntitlementStateEnum } from '../../enums/EntitlementStateEnum';
+import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { RetailPromotionsErrorCodeEnum } from '../../enums/RetailPromotionsErrorCodeEnum';
 import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEnum';
 import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
@@ -9,6 +10,12 @@ import { SalePromotionLeverEnum } from '../../enums/SalePromotionLeverEnum';
 import { DiscountValue } from '../DiscountValue';
 import { LinePromotionDiscount } from '../LinePromotionDiscount';
 import { SalePromotionLevers, SalePromotionScope } from '../SalePromotionLevers';
+/** Condiciones del cliente que pide la promo; solo vienen las que aplican. */
+export interface SalePromotionConditions {
+    oncePerCustomer?: boolean;
+    requiresActiveSurekeepCredit?: boolean;
+    segmentIds?: string[];
+}
 /** Promo vigente en la tienda de la sesión, para los chips de «Elige el teléfono». */
 export interface StoreSalePromotionItem {
     promotionId: string;
@@ -18,6 +25,11 @@ export interface StoreSalePromotionItem {
     levers: SalePromotionLevers;
     /** Para cruzar con cada equipo; todo `null` = fila «Toda la tienda». */
     scope: SalePromotionScope;
+    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    appliesTo: PromotionAppliesToEnum;
+    conditions?: SalePromotionConditions;
+    /** Si viene, todavía no se puede decidir para este cliente (ej. CUSTOMER_NOT_IDENTIFIED). */
+    blockedBy?: RetailPromotionsErrorCodeEnum | null;
 }
 export interface ListStoreSalePromotionsResponse {
     items: StoreSalePromotionItem[];
@@ -49,6 +61,9 @@ export interface EvaluatedSalePromotion {
     giftOptions: GiftOption[];
     giftChooseCount: number | null;
     afterSale: AfterSaleBenefit[];
+    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    appliesTo: PromotionAppliesToEnum;
+    conditions?: SalePromotionConditions;
     /** Si viene, la promo se muestra pero no se puede elegir; dice por qué (ej. CUSTOMER_NOT_IDENTIFIED). */
     blockedBy?: RetailPromotionsErrorCodeEnum | null;
 }

package/package.json

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

package/src/retailPromotions/dtos/responses/WizardSalePromotionResponses.ts

@@ -2,6 +2,7 @@ import { CouponScopeEnum } from '../../enums/CouponScopeEnum';
 import { CouponStatusEnum } from '../../enums/CouponStatusEnum';
 import { EntitlementKindEnum } from '../../enums/EntitlementKindEnum';
 import { EntitlementStateEnum } from '../../enums/EntitlementStateEnum';
+import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { RetailPromotionsErrorCodeEnum } from '../../enums/RetailPromotionsErrorCodeEnum';
 import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEnum';
 import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
@@ -10,6 +11,13 @@ import { DiscountValue } from '../DiscountValue';
 import { LinePromotionDiscount } from '../LinePromotionDiscount';
 import { SalePromotionLevers, SalePromotionScope } from '../SalePromotionLevers';
 
+/** Condiciones del cliente que pide la promo; solo vienen las que aplican. */
+export interface SalePromotionConditions {
+    oncePerCustomer?: boolean;
+    requiresActiveSurekeepCredit?: boolean;
+    segmentIds?: string[];
+}
+
 /** Promo vigente en la tienda de la sesión, para los chips de «Elige el teléfono». */
 export interface StoreSalePromotionItem {
     promotionId: string;
@@ -19,6 +27,11 @@ export interface StoreSalePromotionItem {
     levers: SalePromotionLevers;
     /** Para cruzar con cada equipo; todo `null` = fila «Toda la tienda». */
     scope: SalePromotionScope;
+    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    appliesTo: PromotionAppliesToEnum;
+    conditions?: SalePromotionConditions;
+    /** Si viene, todavía no se puede decidir para este cliente (ej. CUSTOMER_NOT_IDENTIFIED). */
+    blockedBy?: RetailPromotionsErrorCodeEnum | null;
 }
 
 export interface ListStoreSalePromotionsResponse {
@@ -54,6 +67,9 @@ export interface EvaluatedSalePromotion {
     giftOptions: GiftOption[];
     giftChooseCount: number | null;
     afterSale: AfterSaleBenefit[];
+    /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
+    appliesTo: PromotionAppliesToEnum;
+    conditions?: SalePromotionConditions;
     /** Si viene, la promo se muestra pero no se puede elegir; dice por qué (ej. CUSTOMER_NOT_IDENTIFIED). */
     blockedBy?: RetailPromotionsErrorCodeEnum | null;
 }