@fiado/type-kit 3.569.0 → 3.571.0

package/_test_/unit/collection/disbursementType.test.ts

@@ -3,8 +3,8 @@ import { Collection } from '../../../src/index';
 import { DisbursementType } from '../../../src/collection/index';
 
 describe('DisbursementType', () => {
-    it('v1 solo trae el riel MEX_BONUS', () => {
-        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS']);
+    it('trae los productos de bono y comisión de vendedor', () => {
+        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS', 'MEX_SELLER_COMMISSION']);
     });
 
     it('cada clave es igual a su valor', () => {
@@ -15,5 +15,6 @@ describe('DisbursementType', () => {
 
     it('sale por el index raíz', () => {
         expect(Collection.DisbursementType.MEX_BONUS).toBe('MEX_BONUS');
+        expect(Collection.DisbursementType.MEX_SELLER_COMMISSION).toBe('MEX_SELLER_COMMISSION');
     });
 });

package/_test_/unit/productCatalog/enums/ProductSubtypeEnum.test.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import { ProductSubtypeEnum } from '../../../../src/productCatalog/enums/ProductSubtypeEnum';
+
+describe('ProductSubtypeEnum SureKeep', () => {
+  it('trae los subtipos de bono y comisión de vendedor', () => {
+    expect(ProductSubtypeEnum.SUREKEEP_BONUS_MX).toBe('BONUS_MX');
+    expect(ProductSubtypeEnum.SUREKEEP_SELLER_COMMISSION_MX).toBe('SELLER_COMMISSION_MX');
+  });
+});

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/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/collection/enums/DisbursementType.d.ts

@@ -1,7 +1,10 @@
 /**
- * Riel por el que el motor de cobro deposita una dispersión. Nombra el movimiento, no el propósito:
- * el propósito lo manda el llamador en `concept`.
+ * Producto con el que el motor de cobro deposita una dispersión.
+ * El detalle para la persona va en `concept`.
  */
 export declare enum DisbursementType {
-    MEX_BONUS = "MEX_BONUS"
+    /** Bono. */
+    MEX_BONUS = "MEX_BONUS",
+    /** Comisión de vendedor. */
+    MEX_SELLER_COMMISSION = "MEX_SELLER_COMMISSION"
 }

package/bin/collection/enums/DisbursementType.js

@@ -2,10 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DisbursementType = void 0;
 /**
- * Riel por el que el motor de cobro deposita una dispersión. Nombra el movimiento, no el propósito:
- * el propósito lo manda el llamador en `concept`.
+ * Producto con el que el motor de cobro deposita una dispersión.
+ * El detalle para la persona va en `concept`.
  */
 var DisbursementType;
 (function (DisbursementType) {
+    /** Bono. */
     DisbursementType["MEX_BONUS"] = "MEX_BONUS";
+    /** Comisión de vendedor. */
+    DisbursementType["MEX_SELLER_COMMISSION"] = "MEX_SELLER_COMMISSION";
 })(DisbursementType || (exports.DisbursementType = DisbursementType = {}));

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -59,6 +59,7 @@ export declare enum ProductSubtypeEnum {
      */
     SP_CASH_IN_CASH_IN_OXXO = "CASH_IN_OXXO",
     SUREKEEP_BONUS_MX = "BONUS_MX",
+    SUREKEEP_SELLER_COMMISSION_MX = "SELLER_COMMISSION_MX",
     STORE_PHONE = "PHONE",
     REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
     REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -75,6 +75,8 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["SP_CASH_IN_CASH_IN_OXXO"] = "CASH_IN_OXXO";
     //SUREKEEP
     ProductSubtypeEnum["SUREKEEP_BONUS_MX"] = "BONUS_MX";
+    // Comisión de vendedor de SureKeep abonada a la wallet.
+    ProductSubtypeEnum["SUREKEEP_SELLER_COMMISSION_MX"] = "SELLER_COMMISSION_MX";
     //STORE
     ProductSubtypeEnum["STORE_PHONE"] = "PHONE";
     // REFUND_PCF

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

package/src/collection/enums/DisbursementType.ts

@@ -1,7 +1,10 @@
 /**
- * Riel por el que el motor de cobro deposita una dispersión. Nombra el movimiento, no el propósito:
- * el propósito lo manda el llamador en `concept`.
+ * Producto con el que el motor de cobro deposita una dispersión.
+ * El detalle para la persona va en `concept`.
  */
 export enum DisbursementType {
+    /** Bono. */
     MEX_BONUS = 'MEX_BONUS',
+    /** Comisión de vendedor. */
+    MEX_SELLER_COMMISSION = 'MEX_SELLER_COMMISSION',
 }

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -83,6 +83,8 @@ export enum ProductSubtypeEnum {
 
     //SUREKEEP
     SUREKEEP_BONUS_MX = "BONUS_MX",
+    // Comisión de vendedor de SureKeep abonada a la wallet.
+    SUREKEEP_SELLER_COMMISSION_MX = "SELLER_COMMISSION_MX",
 
     //STORE
     STORE_PHONE = "PHONE",

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