@fiado/type-kit 3.570.0 → 3.572.0

package/_test_/unit/retailCustomer/customerReferralContract.test.ts

@@ -188,6 +188,11 @@ describe('CustomerReferral y respuestas', () => {
         expect(errorsOf(CustomerReferral, { ...referral, source: 'WEB' })).toEqual(['source']);
     });
 
+    it('acepta la marca de cliente existente al capturar, opcional', () => {
+        expect(errorsOf(CustomerReferral, { ...referral, existingCustomerAtCapture: true })).toEqual([]);
+        expect(errorsOf(CustomerReferral, { ...referral, existingCustomerAtCapture: 'sí' })).toEqual(['existingCustomerAtCapture']);
+    });
+
     it('describe las respuestas de las rutas privadas', () => {
         const created: CreateCustomerReferralsResponse = { referrals: [referral] };
         const updated: UpdateCustomerReferralResponse = { referral };
@@ -200,6 +205,7 @@ describe('CustomerReferral y respuestas', () => {
                     referrerName: 'Juan Pérez',
                     source: ReferralSourceEnum.SALE,
                     capturedAt: '2026-10-21T10:00:00Z',
+                    existingCustomerAtCapture: false,
                 },
             ],
         };

package/_test_/unit/retailCustomer/promotionBonusContract.test.ts

@@ -6,8 +6,8 @@ import { BonusTypeEnum, UpsertPromotionBonusRequest } from '../../../src/retailC
 import type { PromotionBonusEntryResponse } from '../../../src/retailCustomer/index';
 
 describe('BonusTypeEnum', () => {
-    it('distingue la bienvenida de las dos promociones', () => {
-        expect(Object.values(BonusTypeEnum)).toEqual(['WELCOME', 'CREDIT_PROMOTION', 'SALE_PROMOTION']);
+    it('distingue la bienvenida, las dos promociones y el premio de referido', () => {
+        expect(Object.values(BonusTypeEnum)).toEqual(['WELCOME', 'CREDIT_PROMOTION', 'SALE_PROMOTION', 'REFERRAL']);
     });
 
     it('sale por el index raíz', () => {
@@ -51,6 +51,10 @@ describe('UpsertPromotionBonusRequest', () => {
         expect(errorsOf({ ...PENDING_SALE, bonusType: 'WELCOME' })).toContain('bonusType');
     });
 
+    it('acepta el premio de referido con su rol y referido', () => {
+        expect(errorsOf({ ...PENDING_SALE, bonusType: 'REFERRAL', role: 'REFERRER', referralId: 'ref-1' })).toEqual([]);
+    });
+
     it.each(['promotionId', 'sourceId', 'storeId', 'currency', 'idempotencyKey'])('rechaza %s vacío', (field) => {
         expect(errorsOf({ ...PENDING_SALE, [field]: '  ' })).toContain(field);
     });

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

@@ -124,6 +124,26 @@ describe('ReferralPromotionInput', () => {
         expect(errorsOf(ReferralPromotionInput, bad)).toEqual(['minAmountCents', 'windowDays', 'maxRewardsPerReferrer']);
     });
 
+    it('acepta sin límites por referido ni por recomendado (ausente = 1)', () => {
+        expect(errorsOf(ReferralPromotionInput, { ...REFERRAL, maxRewardsPerReferral: 3, maxReferredRewards: 2 })).toEqual([]);
+        expect(errorsOf(ReferralPromotionInput, { ...REFERRAL, maxRewardsPerReferral: null, maxReferredRewards: null })).toEqual([]);
+    });
+
+    it('rechaza límites por referido y por recomendado en cero, negativos o decimales', () => {
+        expect(errorsOf(ReferralPromotionInput, { ...REFERRAL, maxRewardsPerReferral: 0, maxReferredRewards: 0 })).toEqual([
+            'maxRewardsPerReferral',
+            'maxReferredRewards',
+        ]);
+        expect(errorsOf(ReferralPromotionInput, { ...REFERRAL, maxRewardsPerReferral: -2, maxReferredRewards: -1 })).toEqual([
+            'maxRewardsPerReferral',
+            'maxReferredRewards',
+        ]);
+        expect(errorsOf(ReferralPromotionInput, { ...REFERRAL, maxRewardsPerReferral: 1.5, maxReferredRewards: 2.5 })).toEqual([
+            'maxRewardsPerReferral',
+            'maxReferredRewards',
+        ]);
+    });
+
     it('deja al lambda el mínimo de 2 en compra N y racha (INVALID_REFERRAL_TRIGGER)', () => {
         const nth = { ...REFERRAL, trigger: 'NTH_PURCHASE', purchaseNumber: 1 };
         expect(errorsOf(ReferralPromotionInput, nth)).toEqual([]);
@@ -162,6 +182,8 @@ describe('promo de referido en el CRUD de promos', () => {
             minAmountCents: null,
             windowDays: 60,
             maxRewardsPerReferrer: null,
+            maxRewardsPerReferral: 2,
+            maxReferredRewards: 1,
             referrerReward: {
                 type: ReferralRewardTypeEnum.FIXED_BONUS,
                 amountCents: 100_00,

package/bin/retailCustomer/dtos/CustomerReferral.d.ts

@@ -18,6 +18,8 @@ export declare class CustomerReferral {
     saleId: string | null;
     /** Solo en `OPENING`. */
     accountOpeningSessionId: string | null;
+    /** `true` si el teléfono ya era cliente de alguna cadena del tenant al capturarlo; no genera premios. */
+    existingCustomerAtCapture?: boolean;
     createdBy: string;
     updatedBy: string;
     createdAt: string;

package/bin/retailCustomer/dtos/CustomerReferral.js

@@ -77,6 +77,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CustomerReferral.prototype, "accountOpeningSessionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CustomerReferral.prototype, "existingCustomerAtCapture", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/retailCustomer/dtos/requests/UpsertPromotionBonusRequest.js

@@ -18,7 +18,7 @@ const ReferralRoleEnum_1 = require("../../enums/ReferralRoleEnum");
 const WelcomeBonusStatusEnum_1 = require("../../enums/WelcomeBonusStatusEnum");
 /** Tope del motivo libre que el caller escribe en el asiento. */
 const FREE_TEXT_MAX_LENGTH = 256;
-const PROMOTION_BONUS_TYPES = [BonusTypeEnum_1.BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum_1.BonusTypeEnum.SALE_PROMOTION];
+const PROMOTION_BONUS_TYPES = [BonusTypeEnum_1.BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum_1.BonusTypeEnum.SALE_PROMOTION, BonusTypeEnum_1.BonusTypeEnum.REFERRAL];
 const STATUSES_REQUIRING_REASON = [
     WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.FAILED,
     WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.UNVERIFIED,

package/bin/retailCustomer/dtos/responses/CustomerReferralResponses.d.ts

@@ -20,6 +20,8 @@ export interface ReferralByPhone {
     referrerName: string;
     source: ReferralSourceEnum;
     capturedAt: string;
+    /** `true` si el teléfono ya era cliente al capturarlo; no genera premios. */
+    existingCustomerAtCapture?: boolean;
 }
 /** Respuesta de `privateGetReferralsByPhone`, del más antiguo al más reciente. */
 export interface ReferralsByPhoneResponse {

package/bin/retailCustomer/enums/BonusTypeEnum.d.ts

@@ -2,5 +2,6 @@
 export declare enum BonusTypeEnum {
     WELCOME = "WELCOME",
     CREDIT_PROMOTION = "CREDIT_PROMOTION",
-    SALE_PROMOTION = "SALE_PROMOTION"
+    SALE_PROMOTION = "SALE_PROMOTION",
+    REFERRAL = "REFERRAL"
 }

package/bin/retailCustomer/enums/BonusTypeEnum.js

@@ -7,4 +7,5 @@ var BonusTypeEnum;
     BonusTypeEnum["WELCOME"] = "WELCOME";
     BonusTypeEnum["CREDIT_PROMOTION"] = "CREDIT_PROMOTION";
     BonusTypeEnum["SALE_PROMOTION"] = "SALE_PROMOTION";
+    BonusTypeEnum["REFERRAL"] = "REFERRAL";
 })(BonusTypeEnum || (exports.BonusTypeEnum = BonusTypeEnum = {}));

package/bin/retailPromotions/dtos/ReferralPromotion.d.ts

@@ -27,6 +27,10 @@ export interface ReferralPromotionConfig {
     /** Días desde la captura del referido. */
     windowDays: number | null;
     maxRewardsPerReferrer: number | null;
+    /** Veces que se paga a quien recomienda por cada referido; ausente o `null` = 1. */
+    maxRewardsPerReferral?: number | null;
+    /** Veces que se paga o aplica el premio al recomendado; ausente o `null` = 1. */
+    maxReferredRewards?: number | null;
     referrerReward: ReferralReward;
     /** `null` = el recomendado no gana nada. */
     referredReward: ReferralReward | null;

package/bin/retailPromotions/dtos/requests/ReferralPromotionInput.d.ts

@@ -19,6 +19,10 @@ export declare class ReferralPromotionInput {
     minAmountCents?: number | null;
     windowDays?: number | null;
     maxRewardsPerReferrer?: number | null;
+    /** Veces que se paga a quien recomienda por cada referido; ausente = 1. */
+    maxRewardsPerReferral?: number | null;
+    /** Veces que se paga o aplica el premio al recomendado; ausente = 1. */
+    maxReferredRewards?: number | null;
     referrerReward: ReferralRewardInput;
     referredReward?: ReferralRewardInput | null;
 }

package/bin/retailPromotions/dtos/requests/ReferralPromotionInput.js

@@ -103,6 +103,20 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], ReferralPromotionInput.prototype, "maxRewardsPerReferrer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ReferralPromotionInput.prototype, "maxRewardsPerReferral", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ReferralPromotionInput.prototype, "maxReferredRewards", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsDefined)(),

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

@@ -15,6 +15,10 @@ export interface LiveReferralPromotionItem {
     installmentStreak: number | null;
     /** Fin de vigencia; `null` = sin fecha de fin. */
     validUntil: string | null;
+    /** Veces que se paga a quien recomienda por cada referido; ausente o `null` = 1. */
+    maxRewardsPerReferral?: number | null;
+    /** Veces que se paga o aplica el premio al recomendado; ausente o `null` = 1. */
+    maxReferredRewards?: number | null;
     referrerReward: ReferralReward;
     /** `null` = el recomendado no gana nada. */
     referredReward: ReferralReward | null;

package/package.json

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

package/src/retailCustomer/dtos/CustomerReferral.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsISO8601, IsOptional, IsString } from 'class-validator';
+import { IsBoolean, IsEnum, IsISO8601, IsOptional, IsString } from 'class-validator';
 import { ReferralSourceEnum } from '../enums/ReferralSourceEnum';
 
 /** Persona que un cliente recomienda (owner: retail-customer-business). Teléfono normalizado a 10 dígitos. */
@@ -59,6 +59,12 @@ export class CustomerReferral {
     @IsString()
     accountOpeningSessionId!: string | null;
 
+    /** `true` si el teléfono ya era cliente de alguna cadena del tenant al capturarlo; no genera premios. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    existingCustomerAtCapture?: boolean;
+
     @Expose()
     @IsString()
     createdBy!: string;

package/src/retailCustomer/dtos/requests/UpsertPromotionBonusRequest.ts

@@ -8,7 +8,7 @@ import { WelcomeBonusStatusEnum } from '../../enums/WelcomeBonusStatusEnum';
 /** Tope del motivo libre que el caller escribe en el asiento. */
 const FREE_TEXT_MAX_LENGTH = 256;
 
-const PROMOTION_BONUS_TYPES = [BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum.SALE_PROMOTION];
+const PROMOTION_BONUS_TYPES = [BonusTypeEnum.CREDIT_PROMOTION, BonusTypeEnum.SALE_PROMOTION, BonusTypeEnum.REFERRAL];
 
 const STATUSES_REQUIRING_REASON: WelcomeBonusStatusEnum[] = [
     WelcomeBonusStatusEnum.FAILED,

package/src/retailCustomer/dtos/responses/CustomerReferralResponses.ts

@@ -24,6 +24,8 @@ export interface ReferralByPhone {
     referrerName: string;
     source: ReferralSourceEnum;
     capturedAt: string;
+    /** `true` si el teléfono ya era cliente al capturarlo; no genera premios. */
+    existingCustomerAtCapture?: boolean;
 }
 
 /** Respuesta de `privateGetReferralsByPhone`, del más antiguo al más reciente. */

package/src/retailCustomer/enums/BonusTypeEnum.ts

@@ -3,4 +3,5 @@ export enum BonusTypeEnum {
     WELCOME = 'WELCOME',
     CREDIT_PROMOTION = 'CREDIT_PROMOTION',
     SALE_PROMOTION = 'SALE_PROMOTION',
+    REFERRAL = 'REFERRAL',
 }

package/src/retailPromotions/dtos/ReferralPromotion.ts

@@ -29,6 +29,10 @@ export interface ReferralPromotionConfig {
     /** Días desde la captura del referido. */
     windowDays: number | null;
     maxRewardsPerReferrer: number | null;
+    /** Veces que se paga a quien recomienda por cada referido; ausente o `null` = 1. */
+    maxRewardsPerReferral?: number | null;
+    /** Veces que se paga o aplica el premio al recomendado; ausente o `null` = 1. */
+    maxReferredRewards?: number | null;
     referrerReward: ReferralReward;
     /** `null` = el recomendado no gana nada. */
     referredReward: ReferralReward | null;

package/src/retailPromotions/dtos/requests/ReferralPromotionInput.ts

@@ -79,6 +79,20 @@ export class ReferralPromotionInput {
     @Min(1)
     maxRewardsPerReferrer?: number | null;
 
+    /** Veces que se paga a quien recomienda por cada referido; ausente = 1. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxRewardsPerReferral?: number | null;
+
+    /** Veces que se paga o aplica el premio al recomendado; ausente = 1. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxReferredRewards?: number | null;
+
     @Expose()
     @IsDefined()
     @ValidateNested()

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

@@ -16,6 +16,10 @@ export interface LiveReferralPromotionItem {
     installmentStreak: number | null;
     /** Fin de vigencia; `null` = sin fecha de fin. */
     validUntil: string | null;
+    /** Veces que se paga a quien recomienda por cada referido; ausente o `null` = 1. */
+    maxRewardsPerReferral?: number | null;
+    /** Veces que se paga o aplica el premio al recomendado; ausente o `null` = 1. */
+    maxReferredRewards?: number | null;
     referrerReward: ReferralReward;
     /** `null` = el recomendado no gana nada. */
     referredReward: ReferralReward | null;