@fiado/type-kit 3.497.0 → 3.499.0

package/_test_/unit/loanCredit/dtos/createCustomerPaymentRequest.test.ts

@@ -65,7 +65,11 @@ describe('CreateCustomerPaymentRequest', () => {
         expect(await errorProperties({ ...VALID, type: LoanCustomerPaymentTypeEnum.ADVANCE, installmentCount: 3 })).toEqual([]);
     });
 
-    it.each([[1], [0], [2.5], ['3']])('rechaza el número de cuotas %p', async installmentCount => {
+    it('acepta adelantar una sola cuota', async () => {
+        expect(await errorProperties({ ...VALID, type: LoanCustomerPaymentTypeEnum.ADVANCE, installmentCount: 1 })).toEqual([]);
+    });
+
+    it.each([[0], [2.5], ['3']])('rechaza el número de cuotas %p', async installmentCount => {
         expect(await errorProperties({ ...VALID, type: LoanCustomerPaymentTypeEnum.ADVANCE, installmentCount })).toEqual([
             'installmentCount',
         ]);

package/_test_/unit/loanCredit/dtos/createSellerPaymentRequest.test.ts

@@ -51,9 +51,9 @@ describe('CreateSellerPaymentRequest', () => {
         expect(await errorPaths({ ...BASE, idempotencyKey: 'no-uuid' })).toEqual(['idempotencyKey']);
     });
 
-    it('cuotas solo de 2 en adelante', async () => {
-        expect(await errorPaths({ ...BASE, type: 'ADVANCE', installmentCount: 1 })).toEqual(['installmentCount']);
-        expect(await errorPaths({ ...BASE, type: 'ADVANCE', installmentCount: 2 })).toEqual([]);
+    it('cuotas desde 1', async () => {
+        expect(await errorPaths({ ...BASE, type: 'ADVANCE', installmentCount: 0 })).toEqual(['installmentCount']);
+        expect(await errorPaths({ ...BASE, type: 'ADVANCE', installmentCount: 1 })).toEqual([]);
     });
 
     it('no declara CLABE: con whitelist se descarta y nunca llega al dominio', () => {

package/_test_/unit/retailLoan/paymentContract.test.ts

@@ -72,6 +72,13 @@ describe('CreateMyPaymentRequest', () => {
     it.each([[0], [-1050], [10.123], ['1050']])('rechaza el monto %p', async expectedAmount => {
         expect(await errorProperties({ type: MyPaymentTypeEnum.SETTLEMENT, expectedAmount })).toEqual(['expectedAmount']);
     });
+
+    it('pagar por adelantado acepta desde una cuota', async () => {
+        expect(await errorProperties({ type: MyPaymentTypeEnum.ADVANCE, expectedAmount: 1050, installmentCount: 1 })).toEqual([]);
+        expect(await errorProperties({ type: MyPaymentTypeEnum.ADVANCE, expectedAmount: 1050, installmentCount: 0 })).toEqual([
+            'installmentCount',
+        ]);
+    });
 });
 
 describe('retailLoan — opciones y respuesta del pago', () => {

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/loanCredit/dtos/requests/CreateCustomerPaymentRequest.js

@@ -37,6 +37,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
-    (0, class_validator_1.Min)(2),
+    (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], CreateCustomerPaymentRequest.prototype, "installmentCount", void 0);

package/bin/loanCredit/dtos/requests/CreateSellerPaymentRequest.js

@@ -34,7 +34,7 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
-    (0, class_validator_1.Min)(2),
+    (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], CreateSellerPaymentRequest.prototype, "installmentCount", void 0);
 __decorate([

package/bin/retailLoan/dtos/CreateMyPaymentRequest.js

@@ -32,6 +32,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
-    (0, class_validator_1.Min)(2),
+    (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], CreateMyPaymentRequest.prototype, "installmentCount", void 0);

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.497.0",
+  "version": "3.499.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/dtos/requests/CreateCustomerPaymentRequest.ts

@@ -23,6 +23,6 @@ export class CreateCustomerPaymentRequest {
     @Expose()
     @IsOptional()
     @IsInt()
-    @Min(2)
+    @Min(1)
     installmentCount?: number;
 }

package/src/loanCredit/dtos/requests/CreateSellerPaymentRequest.ts

@@ -20,7 +20,7 @@ export class CreateSellerPaymentRequest {
     @Expose()
     @IsOptional()
     @IsInt()
-    @Min(2)
+    @Min(1)
     installmentCount?: number;
 
     @Expose()

package/src/retailLoan/dtos/CreateMyPaymentRequest.ts

@@ -18,6 +18,6 @@ export class CreateMyPaymentRequest {
     @Expose()
     @IsOptional()
     @IsInt()
-    @Min(2)
+    @Min(1)
     installmentCount?: number;
 }

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