@fiado/type-kit 3.564.0 → 3.565.0

package/bin/retailWizard/events/RetailPromotionInstallmentPaidMessage.js

@@ -0,0 +1,75 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailPromotionInstallmentPaidMessage = void 0;
+const class_validator_1 = require("class-validator");
+const LoanInstallmentStatusEnum_1 = require("../../loanCredit/enums/LoanInstallmentStatusEnum");
+const RetailPromotionInboundMessageTypeEnum_1 = require("../enums/RetailPromotionInboundMessageTypeEnum");
+/** Cuota pagada que loan-credit publica en RetailPromotionInboundQueue: `InstallmentPaidV1` + contexto. Sin PII. */
+class RetailPromotionInstallmentPaidMessage {
+}
+exports.RetailPromotionInstallmentPaidMessage = RetailPromotionInstallmentPaidMessage;
+__decorate([
+    (0, class_validator_1.Equals)(RetailPromotionInboundMessageTypeEnum_1.RetailPromotionInboundMessageTypeEnum.CREDIT_INSTALLMENT_PAID),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "creditId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], RetailPromotionInstallmentPaidMessage.prototype, "installmentNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailPromotionInstallmentPaidMessage.prototype, "paidCents", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "paidAt", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(LoanInstallmentStatusEnum_1.LoanInstallmentStatusEnum),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "installmentStatus", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "paymentId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "wizardSessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionInstallmentPaidMessage.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], RetailPromotionInstallmentPaidMessage.prototype, "onTime", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailPromotionInstallmentPaidMessage.prototype, "onTimeStreak", void 0);

package/bin/retailWizard/events/RetailPromotionQueueMessage.d.ts

@@ -0,0 +1,5 @@
+import { RetailPromotionAccountOpenedMessage } from './RetailPromotionAccountOpenedMessage';
+import { RetailPromotionInboundMessage } from './RetailPromotionInboundMessage';
+import { RetailPromotionInstallmentPaidMessage } from './RetailPromotionInstallmentPaidMessage';
+/** Cualquier mensaje de RetailPromotionInboundQueue; el `type` dice cuál clase validar. */
+export type RetailPromotionQueueMessage = RetailPromotionInboundMessage | RetailPromotionAccountOpenedMessage | RetailPromotionInstallmentPaidMessage;

package/bin/retailWizard/events/RetailPromotionQueueMessage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailWizard/index.d.ts

@@ -157,6 +157,7 @@ export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
 export * from './dtos/responses/BackofficeCustomerTableResponse';
 export * from './dtos/responses/BackofficeAccountOpeningsResponse';
+export * from './dtos/responses/BackofficeCustomerReferralsResponse';
 export * from './enums/StoreKindEnum';
 export * from './dtos/responses/BackofficeStoreTableResponse';
 export * from './enums/StoreMixCategoryEnum';
@@ -169,6 +170,9 @@ export * from './events/SessionExpiredV1';
 export * from './enums/RetailPromotionInboundMessageTypeEnum';
 export * from './enums/RetailCommissionInboundMessageTypeEnum';
 export * from './events/RetailPromotionInboundMessage';
+export * from './events/RetailPromotionAccountOpenedMessage';
+export * from './events/RetailPromotionInstallmentPaidMessage';
+export * from './events/RetailPromotionQueueMessage';
 export * from './events/RetailCommissionInboundMessage';
 export * from './enums/WizardSessionLookupStatusEnum';
 export * from './dtos/WizardSessionLookupEntry';

package/bin/retailWizard/index.js

@@ -190,6 +190,7 @@ __exportStar(require("./enums/SellerTableSourceStatusEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeSellerTableResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeCustomerTableResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeAccountOpeningsResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeCustomerReferralsResponse"), exports);
 __exportStar(require("./enums/StoreKindEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeStoreTableResponse"), exports);
 __exportStar(require("./enums/StoreMixCategoryEnum"), exports);
@@ -203,6 +204,9 @@ __exportStar(require("./events/SessionExpiredV1"), exports);
 __exportStar(require("./enums/RetailPromotionInboundMessageTypeEnum"), exports);
 __exportStar(require("./enums/RetailCommissionInboundMessageTypeEnum"), exports);
 __exportStar(require("./events/RetailPromotionInboundMessage"), exports);
+__exportStar(require("./events/RetailPromotionAccountOpenedMessage"), exports);
+__exportStar(require("./events/RetailPromotionInstallmentPaidMessage"), exports);
+__exportStar(require("./events/RetailPromotionQueueMessage"), exports);
 __exportStar(require("./events/RetailCommissionInboundMessage"), exports);
 // Lookup privado por lote (GET /private/wizard-sessions/batch)
 __exportStar(require("./enums/WizardSessionLookupStatusEnum"), exports);

package/package.json

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

package/src/retailCustomer/dtos/CustomerReferral.ts

@@ -0,0 +1,77 @@
+import { Expose } from 'class-transformer';
+import { 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. */
+export class CustomerReferral {
+    @Expose()
+    @IsString()
+    referralId!: string;
+
+    /** Cliente que recomienda. */
+    @Expose()
+    @IsString()
+    retailCustomerId!: string;
+
+    /** Cadena del cliente que recomienda. */
+    @Expose()
+    @IsString()
+    retailerId!: string;
+
+    /** Tienda de captura; `null` si se agregó en el cajón. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    storeId!: string | null;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    phone!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    email!: string | null;
+
+    @Expose()
+    @IsEnum(ReferralSourceEnum)
+    source!: ReferralSourceEnum;
+
+    /** Sesión del wizard donde se capturó (venta). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    wizardSessionId!: string | null;
+
+    /** Solo en `SALE`. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    saleId!: string | null;
+
+    /** Solo en `OPENING`. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    accountOpeningSessionId!: string | null;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsISO8601()
+    createdAt!: string;
+
+    @Expose()
+    @IsISO8601()
+    updatedAt!: string;
+}

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

@@ -0,0 +1,91 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayMinSize,
+    IsArray,
+    IsEmail,
+    IsEnum,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    MaxLength,
+    ValidateIf,
+    ValidateNested,
+} from 'class-validator';
+import { Trim } from '../../../common/decorators/Trim';
+import { EMAIL_MAX_LENGTH } from '../../../common/constants/InputPatterns';
+import { ReferralSourceEnum } from '../../enums/ReferralSourceEnum';
+
+const REFERRAL_NAME_MAX_LENGTH = 120;
+
+/** Un renglón del lote. El teléfono llega como se tecleó; el lambda lo normaliza y valida. */
+export class CustomerReferralInput {
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(REFERRAL_NAME_MAX_LENGTH)
+    name!: string;
+
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    phone!: string;
+
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsEmail()
+    @MaxLength(EMAIL_MAX_LENGTH)
+    email?: string;
+}
+
+/** Body de `privateCreateCustomerReferrals`: lote de referidos de un cliente. */
+export class CreateCustomerReferralsRequest {
+    @Expose()
+    @IsEnum(ReferralSourceEnum)
+    source!: ReferralSourceEnum;
+
+    /** Tienda de captura; obligatoria en venta y apertura. */
+    @Expose()
+    @ValidateIf((o: CreateCustomerReferralsRequest) => o.source !== ReferralSourceEnum.BACKOFFICE || o.storeId !== undefined)
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    storeId?: string;
+
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    wizardSessionId?: string;
+
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    saleId?: string;
+
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    accountOpeningSessionId?: string;
+
+    /** Usuario que capturó (vendedor o admin); la llamada M2M no lo trae en el token. */
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    capturedBy!: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => CustomerReferralInput)
+    referrals!: CustomerReferralInput[];
+}

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

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsString } from 'class-validator';
+
+const PHONES_MAX_BATCH = 100;
+
+/** Body de `privateGetCustomersByPhones`: qué teléfonos ya son clientes. */
+export class GetCustomersByPhonesRequest {
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(PHONES_MAX_BATCH)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    phones!: string[];
+}

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

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { Trim } from '../../../common/decorators/Trim';
+
+/** Query de `privateGetReferralsByPhone`: quién recomendó ese teléfono en la cadena, capturado antes de `before`. */
+export class GetReferralsByPhoneQuery {
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    phone!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    before?: string;
+}

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

@@ -0,0 +1,38 @@
+import { Expose } from 'class-transformer';
+import { IsEmail, IsNotEmpty, IsOptional, IsString, MaxLength, ValidateIf } from 'class-validator';
+import { Trim } from '../../../common/decorators/Trim';
+import { EMAIL_MAX_LENGTH } from '../../../common/constants/InputPatterns';
+
+const REFERRAL_NAME_MAX_LENGTH = 120;
+
+/** Body de `privateUpdateCustomerReferral`: corrige datos sin cambiar dónde se capturó. `email: null` lo quita. */
+export class UpdateCustomerReferralRequest {
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(REFERRAL_NAME_MAX_LENGTH)
+    name?: string;
+
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    phone?: string;
+
+    @Expose()
+    @ValidateIf((o: UpdateCustomerReferralRequest) => o.email !== undefined && o.email !== null)
+    @Trim()
+    @IsEmail()
+    @MaxLength(EMAIL_MAX_LENGTH)
+    email?: string | null;
+
+    /** Usuario que edita; la llamada M2M no lo trae en el token. */
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    updatedBy!: string;
+}

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

@@ -1,7 +1,8 @@
 import { Expose } from 'class-transformer';
-import { IsIn, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString, MaxLength, ValidateIf } from 'class-validator';
+import { IsEnum, IsIn, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString, MaxLength, ValidateIf } from 'class-validator';
 import { Trim } from '../../../common/decorators/Trim';
 import { BonusTypeEnum } from '../../enums/BonusTypeEnum';
+import { ReferralRoleEnum } from '../../enums/ReferralRoleEnum';
 import { WelcomeBonusStatusEnum } from '../../enums/WelcomeBonusStatusEnum';
 
 /** Tope del motivo libre que el caller escribe en el asiento. */
@@ -118,4 +119,17 @@ export class UpsertPromotionBonusRequest {
     @IsString()
     @IsNotEmpty()
     sellerRetailUserId?: string;
+
+    /** Solo en premios de referido: a quién se le paga. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ReferralRoleEnum)
+    role?: ReferralRoleEnum;
+
+    @Expose()
+    @IsOptional()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    referralId?: string;
 }

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

@@ -0,0 +1,46 @@
+import { CustomerReferral } from '../CustomerReferral';
+import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
+import { ReferralSourceEnum } from '../../enums/ReferralSourceEnum';
+
+/** Respuesta de `privateCreateCustomerReferrals`. */
+export interface CreateCustomerReferralsResponse {
+    referrals: CustomerReferral[];
+}
+
+/** Respuesta de `privateUpdateCustomerReferral`. */
+export interface UpdateCustomerReferralResponse {
+    referral: CustomerReferral;
+}
+
+/** Respuesta de `privateListCustomerReferrals`. */
+export interface ListCustomerReferralsResponse {
+    referrals: CustomerReferral[];
+}
+
+/** Quién recomendó un teléfono. */
+export interface ReferralByPhone {
+    referralId: string;
+    referrerCustomerId: string;
+    referrerName: string;
+    source: ReferralSourceEnum;
+    capturedAt: string;
+}
+
+/** Respuesta de `privateGetReferralsByPhone`, del más antiguo al más reciente. */
+export interface ReferralsByPhoneResponse {
+    referrals: ReferralByPhone[];
+}
+
+/** Teléfono que ya es cliente. */
+export interface CustomerByPhone {
+    phone: string;
+    retailCustomerId: string;
+    retailerId: string;
+    /** `null` si la cuenta PCF aún no se pide. */
+    accountStatus: AccountStatusEnum | null;
+}
+
+/** Respuesta de `privateGetCustomersByPhones`; los teléfonos que no son clientes no aparecen. */
+export interface CustomersByPhonesResponse {
+    customers: CustomerByPhone[];
+}

package/src/retailCustomer/enums/ReferralRoleEnum.ts

@@ -0,0 +1,5 @@
+/** A quién premia una promo de referido: a quien recomienda o al recomendado. */
+export enum ReferralRoleEnum {
+    REFERRER = 'REFERRER',
+    REFERRED = 'REFERRED',
+}

package/src/retailCustomer/enums/ReferralSourceEnum.ts

@@ -0,0 +1,6 @@
+/** Dónde se capturó un referido: en la venta, en la apertura sin venta o en el cajón del cliente. */
+export enum ReferralSourceEnum {
+    SALE = 'SALE',
+    OPENING = 'OPENING',
+    BACKOFFICE = 'BACKOFFICE',
+}

package/src/retailCustomer/enums/ReferralStatusEnum.ts

@@ -0,0 +1,7 @@
+/** Estado del referido en el cajón: aún no compra, abrió su cuenta, ya compró o tiene crédito SureKeep. */
+export enum ReferralStatusEnum {
+    NOT_PURCHASED = 'NOT_PURCHASED',
+    ACCOUNT_OPENED = 'ACCOUNT_OPENED',
+    PURCHASED = 'PURCHASED',
+    SUREKEEP_CREDIT = 'SUREKEEP_CREDIT',
+}

package/src/retailCustomer/index.ts

@@ -9,11 +9,15 @@ export * from './enums/WelcomeBonusStatusEnum';
 export * from './enums/WelcomeBonusAmountSourceEnum';
 export * from './enums/WelcomeBonusSettlementStatusEnum';
 export * from './enums/BonusTypeEnum';
+export * from './enums/ReferralSourceEnum';
+export * from './enums/ReferralStatusEnum';
+export * from './enums/ReferralRoleEnum';
 
 // Entidades (planas, con class-validator + @Expose)
 export * from './dtos/KycReview';
 export * from './dtos/RetailAddress';
 export * from './dtos/RetailCustomer';
+export * from './dtos/CustomerReferral';
 
 // Request DTOs (input validado por endpoint)
 export * from './dtos/requests/CreateCustomerRequest';
@@ -24,6 +28,10 @@ export * from './dtos/requests/KycReviewRequest';
 export * from './dtos/requests/WelcomeAccreditationRequest';
 export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/requests/UpsertPromotionBonusRequest';
+export * from './dtos/requests/CreateCustomerReferralsRequest';
+export * from './dtos/requests/UpdateCustomerReferralRequest';
+export * from './dtos/requests/GetCustomersByPhonesRequest';
+export * from './dtos/requests/GetReferralsByPhoneQuery';
 
 // Response DTOs
 export * from './dtos/responses/CustomerResponse';
@@ -31,6 +39,7 @@ export * from './dtos/responses/Customer360Response';
 export * from './dtos/responses/WelcomeBonusResponse';
 export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './dtos/responses/PromotionBonusEntryResponse';
+export * from './dtos/responses/CustomerReferralResponses';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/CustomerCreatedV1';

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -36,4 +36,6 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 |
     [C.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
     [C.SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED]: 422,
     [C.SYSTEM_PROMOTION_FIELD_LOCKED]: 422,
+    [C.REFERRAL_REWARD_NEEDS_PURCHASE]: 422,
+    [C.INVALID_REFERRAL_TRIGGER]: 400,
 };

package/src/retailPromotions/dtos/ReferralPromotion.ts

@@ -0,0 +1,35 @@
+import { ReferralPromotionChannelEnum } from '../enums/ReferralPromotionChannelEnum';
+import { ReferralRewardTypeEnum } from '../enums/ReferralRewardTypeEnum';
+import { ReferralTriggerEnum } from '../enums/ReferralTriggerEnum';
+import { CouponLever } from './SalePromotionLevers';
+
+/** Premio de un rol; solo trae valor el campo que corresponde a su `type`. */
+export interface ReferralReward {
+    type: ReferralRewardTypeEnum;
+    /** `FIXED_BONUS`. */
+    amountCents: number | null;
+    /** `PERCENT_BONUS` y `SALE_DISCOUNT`; 1000 = 10%. */
+    percentBps: number | null;
+    /** Tope del %; `null` = sin tope. */
+    maxAmountCents: number | null;
+    /** `COUPON`. */
+    coupon: CouponLever | null;
+}
+
+/** Evento, condiciones y premios de una promo `REFERRAL`; forma de pago, gama, vigencia y presupuesto son los de la promo. */
+export interface ReferralPromotionConfig {
+    channel: ReferralPromotionChannelEnum;
+    trigger: ReferralTriggerEnum;
+    /** Solo en `NTH_PURCHASE`. */
+    purchaseNumber: number | null;
+    /** Solo en `INSTALLMENT_STREAK`. */
+    installmentStreak: number | null;
+    /** Monto mínimo de la compra o del crédito. */
+    minAmountCents: number | null;
+    /** Días desde la captura del referido. */
+    windowDays: number | null;
+    maxRewardsPerReferrer: number | null;
+    referrerReward: ReferralReward;
+    /** `null` = el recomendado no gana nada. */
+    referredReward: ReferralReward | null;
+}

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -3,6 +3,7 @@ import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum'
 import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
 import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
 import { SalePromotionSystemKeyEnum } from '../enums/SalePromotionSystemKeyEnum';
+import { ReferralPromotionConfig } from './ReferralPromotion';
 import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
 
 /** Promo de venta tal como la devuelve el CRUD. Dinero en centavos, fechas ISO. */
@@ -31,6 +32,8 @@ export interface SalePromotion {
     oncePerCustomer: boolean;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable: boolean;
+    /** Solo en promos `REFERRAL`. */
+    referral?: ReferralPromotionConfig | null;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

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

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { SalePaymentMethodEnum } from '../../../retailWizard/enums/SalePaymentMethodEnum';
+
+/** Body de `POST /private/sessions/{sessionId}/sale-promotion/payment-check` (M2M): el medio con que se va a cobrar. */
+export class CheckSalePromotionPaymentRequest {
+    @Expose()
+    @IsEnum(SalePaymentMethodEnum)
+    method!: SalePaymentMethodEnum;
+}

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

@@ -13,6 +13,7 @@ import {
 } from 'class-validator';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
+import { ReferralPromotionInput } from './ReferralPromotionInput';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 
@@ -85,4 +86,11 @@ export class CreateSalePromotionRequest {
     @IsOptional()
     @IsBoolean()
     stackable?: boolean;
+
+    /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => ReferralPromotionInput)
+    referral?: ReferralPromotionInput | null;
 }

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

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsString } from 'class-validator';
+
+const REWARD_PHONES_MAX_BATCH = 100;
+
+/** Body de la ruta privada de premios de referido por cadena y lote de teléfonos (normalizados a 10 dígitos). */
+export class GetReferralRewardsByPhonesRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(REWARD_PHONES_MAX_BATCH)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    phones!: string[];
+}

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

@@ -1,14 +1,27 @@
 import { Expose, Type } from 'class-transformer';
 import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { ReferralPromotionChannelEnum } from '../../enums/ReferralPromotionChannelEnum';
+import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
 import { SalePromotionStatusEnum } from '../../enums/SalePromotionStatusEnum';
 
-/** Query de publicListSalePromotions; sin `status` excluye las archivadas. */
+/** Query de publicListSalePromotions; sin `status` excluye las archivadas y sin `kind` las de referido. */
 export class ListSalePromotionsQuery {
     @Expose()
     @IsOptional()
     @IsEnum(SalePromotionStatusEnum)
     status?: SalePromotionStatusEnum;
 
+    @Expose()
+    @IsOptional()
+    @IsEnum(SalePromotionKindEnum)
+    kind?: SalePromotionKindEnum;
+
+    /** Canal de las promos de referido. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ReferralPromotionChannelEnum)
+    channel?: ReferralPromotionChannelEnum;
+
     @Expose()
     @IsOptional()
     @Type(() => Number)