@fiado/type-kit 3.564.0 → 3.565.0

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

@@ -0,0 +1,39 @@
+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/bin/retailCustomer/dtos/responses/CustomerReferralResponses.js

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

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

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

package/bin/retailCustomer/enums/ReferralRoleEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralRoleEnum = void 0;
+/** A quién premia una promo de referido: a quien recomienda o al recomendado. */
+var ReferralRoleEnum;
+(function (ReferralRoleEnum) {
+    ReferralRoleEnum["REFERRER"] = "REFERRER";
+    ReferralRoleEnum["REFERRED"] = "REFERRED";
+})(ReferralRoleEnum || (exports.ReferralRoleEnum = ReferralRoleEnum = {}));

package/bin/retailCustomer/enums/ReferralSourceEnum.d.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 declare enum ReferralSourceEnum {
+    SALE = "SALE",
+    OPENING = "OPENING",
+    BACKOFFICE = "BACKOFFICE"
+}

package/bin/retailCustomer/enums/ReferralSourceEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralSourceEnum = void 0;
+/** Dónde se capturó un referido: en la venta, en la apertura sin venta o en el cajón del cliente. */
+var ReferralSourceEnum;
+(function (ReferralSourceEnum) {
+    ReferralSourceEnum["SALE"] = "SALE";
+    ReferralSourceEnum["OPENING"] = "OPENING";
+    ReferralSourceEnum["BACKOFFICE"] = "BACKOFFICE";
+})(ReferralSourceEnum || (exports.ReferralSourceEnum = ReferralSourceEnum = {}));

package/bin/retailCustomer/enums/ReferralStatusEnum.d.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 declare enum ReferralStatusEnum {
+    NOT_PURCHASED = "NOT_PURCHASED",
+    ACCOUNT_OPENED = "ACCOUNT_OPENED",
+    PURCHASED = "PURCHASED",
+    SUREKEEP_CREDIT = "SUREKEEP_CREDIT"
+}

package/bin/retailCustomer/enums/ReferralStatusEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralStatusEnum = void 0;
+/** Estado del referido en el cajón: aún no compra, abrió su cuenta, ya compró o tiene crédito SureKeep. */
+var ReferralStatusEnum;
+(function (ReferralStatusEnum) {
+    ReferralStatusEnum["NOT_PURCHASED"] = "NOT_PURCHASED";
+    ReferralStatusEnum["ACCOUNT_OPENED"] = "ACCOUNT_OPENED";
+    ReferralStatusEnum["PURCHASED"] = "PURCHASED";
+    ReferralStatusEnum["SUREKEEP_CREDIT"] = "SUREKEEP_CREDIT";
+})(ReferralStatusEnum || (exports.ReferralStatusEnum = ReferralStatusEnum = {}));

package/bin/retailCustomer/index.d.ts

@@ -8,9 +8,13 @@ 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';
 export * from './dtos/KycReview';
 export * from './dtos/RetailAddress';
 export * from './dtos/RetailCustomer';
+export * from './dtos/CustomerReferral';
 export * from './dtos/requests/CreateCustomerRequest';
 export * from './dtos/requests/UpsertCustomerFromKycRequest';
 export * from './dtos/requests/UpdateCustomerRequest';
@@ -19,11 +23,16 @@ 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';
 export * from './dtos/responses/CustomerResponse';
 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';
 export * from './events/CustomerCreatedV1';
 export * from './events/CustomerUpdatedV1';
 export * from './events/CustomerKycVerifiedV1';

package/bin/retailCustomer/index.js

@@ -25,10 +25,14 @@ __exportStar(require("./enums/WelcomeBonusStatusEnum"), exports);
 __exportStar(require("./enums/WelcomeBonusAmountSourceEnum"), exports);
 __exportStar(require("./enums/WelcomeBonusSettlementStatusEnum"), exports);
 __exportStar(require("./enums/BonusTypeEnum"), exports);
+__exportStar(require("./enums/ReferralSourceEnum"), exports);
+__exportStar(require("./enums/ReferralStatusEnum"), exports);
+__exportStar(require("./enums/ReferralRoleEnum"), exports);
 // Entidades (planas, con class-validator + @Expose)
 __exportStar(require("./dtos/KycReview"), exports);
 __exportStar(require("./dtos/RetailAddress"), exports);
 __exportStar(require("./dtos/RetailCustomer"), exports);
+__exportStar(require("./dtos/CustomerReferral"), exports);
 // Request DTOs (input validado por endpoint)
 __exportStar(require("./dtos/requests/CreateCustomerRequest"), exports);
 __exportStar(require("./dtos/requests/UpsertCustomerFromKycRequest"), exports);
@@ -38,12 +42,17 @@ __exportStar(require("./dtos/requests/KycReviewRequest"), exports);
 __exportStar(require("./dtos/requests/WelcomeAccreditationRequest"), exports);
 __exportStar(require("./dtos/requests/WelcomeAccreditationResultRequest"), exports);
 __exportStar(require("./dtos/requests/UpsertPromotionBonusRequest"), exports);
+__exportStar(require("./dtos/requests/CreateCustomerReferralsRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateCustomerReferralRequest"), exports);
+__exportStar(require("./dtos/requests/GetCustomersByPhonesRequest"), exports);
+__exportStar(require("./dtos/requests/GetReferralsByPhoneQuery"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CustomerResponse"), exports);
 __exportStar(require("./dtos/responses/Customer360Response"), exports);
 __exportStar(require("./dtos/responses/WelcomeBonusResponse"), exports);
 __exportStar(require("./dtos/responses/WelcomeAccreditationResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionBonusEntryResponse"), exports);
+__exportStar(require("./dtos/responses/CustomerReferralResponses"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/CustomerCreatedV1"), exports);
 __exportStar(require("./events/CustomerUpdatedV1"), exports);

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -38,4 +38,6 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED]: 422,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SYSTEM_PROMOTION_FIELD_LOCKED]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.REFERRAL_REWARD_NEEDS_PURCHASE]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_REFERRAL_TRIGGER]: 400,
 };

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

@@ -0,0 +1,33 @@
+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/bin/retailPromotions/dtos/ReferralPromotion.js

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

package/bin/retailPromotions/dtos/SalePromotion.d.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. */
 export interface SalePromotion {
@@ -30,6 +31,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/bin/retailPromotions/dtos/requests/CheckSalePromotionPaymentRequest.d.ts

@@ -0,0 +1,5 @@
+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 declare class CheckSalePromotionPaymentRequest {
+    method: SalePaymentMethodEnum;
+}

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

@@ -0,0 +1,24 @@
+"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.CheckSalePromotionPaymentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SalePaymentMethodEnum_1 = require("../../../retailWizard/enums/SalePaymentMethodEnum");
+/** Body de `POST /private/sessions/{sessionId}/sale-promotion/payment-check` (M2M): el medio con que se va a cobrar. */
+class CheckSalePromotionPaymentRequest {
+}
+exports.CheckSalePromotionPaymentRequest = CheckSalePromotionPaymentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
+    __metadata("design:type", String)
+], CheckSalePromotionPaymentRequest.prototype, "method", void 0);

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

@@ -1,5 +1,6 @@
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
+import { ReferralPromotionInput } from './ReferralPromotionInput';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 /** Body de publicCreateSalePromotion. Nace en `DRAFT`; el retailer sale del token. */
@@ -21,4 +22,6 @@ export declare class CreateSalePromotionRequest {
     oncePerCustomer?: boolean;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable?: boolean;
+    /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
+    referral?: ReferralPromotionInput | null;
 }

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

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
 const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
+const ReferralPromotionInput_1 = require("./ReferralPromotionInput");
 const SalePromotionLeversInput_1 = require("./SalePromotionLeversInput");
 const SalePromotionScopeInput_1 = require("./SalePromotionScopeInput");
 /** Body de publicCreateSalePromotion. Nace en `DRAFT`; el retailer sale del token. */
@@ -95,3 +96,10 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], CreateSalePromotionRequest.prototype, "stackable", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ReferralPromotionInput_1.ReferralPromotionInput),
+    __metadata("design:type", ReferralPromotionInput_1.ReferralPromotionInput)
+], CreateSalePromotionRequest.prototype, "referral", void 0);

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

@@ -0,0 +1,5 @@
+/** Body de la ruta privada de premios de referido por cadena y lote de teléfonos (normalizados a 10 dígitos). */
+export declare class GetReferralRewardsByPhonesRequest {
+    retailerId: string;
+    phones: string[];
+}

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

@@ -0,0 +1,34 @@
+"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.GetReferralRewardsByPhonesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("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). */
+class GetReferralRewardsByPhonesRequest {
+}
+exports.GetReferralRewardsByPhonesRequest = GetReferralRewardsByPhonesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GetReferralRewardsByPhonesRequest.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(REWARD_PHONES_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], GetReferralRewardsByPhonesRequest.prototype, "phones", void 0);

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

@@ -1,7 +1,12 @@
+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 declare class ListSalePromotionsQuery {
     status?: SalePromotionStatusEnum;
+    kind?: SalePromotionKindEnum;
+    /** Canal de las promos de referido. */
+    channel?: ReferralPromotionChannelEnum;
     limit?: number;
     nextToken?: string;
 }

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

@@ -12,8 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListSalePromotionsQuery = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ReferralPromotionChannelEnum_1 = require("../../enums/ReferralPromotionChannelEnum");
+const SalePromotionKindEnum_1 = require("../../enums/SalePromotionKindEnum");
 const SalePromotionStatusEnum_1 = require("../../enums/SalePromotionStatusEnum");
-/** Query de publicListSalePromotions; sin `status` excluye las archivadas. */
+/** Query de publicListSalePromotions; sin `status` excluye las archivadas y sin `kind` las de referido. */
 class ListSalePromotionsQuery {
 }
 exports.ListSalePromotionsQuery = ListSalePromotionsQuery;
@@ -23,6 +25,18 @@ __decorate([
     (0, class_validator_1.IsEnum)(SalePromotionStatusEnum_1.SalePromotionStatusEnum),
     __metadata("design:type", String)
 ], ListSalePromotionsQuery.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SalePromotionKindEnum_1.SalePromotionKindEnum),
+    __metadata("design:type", String)
+], ListSalePromotionsQuery.prototype, "kind", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReferralPromotionChannelEnum_1.ReferralPromotionChannelEnum),
+    __metadata("design:type", String)
+], ListSalePromotionsQuery.prototype, "channel", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -0,0 +1,24 @@
+import { ReferralPromotionChannelEnum } from '../../enums/ReferralPromotionChannelEnum';
+import { ReferralRewardTypeEnum } from '../../enums/ReferralRewardTypeEnum';
+import { ReferralTriggerEnum } from '../../enums/ReferralTriggerEnum';
+import { CouponLeverInput } from './SalePromotionLeversInput';
+/** Premio de un rol en el body: exige el campo de su `type`. Qué premio vale con qué evento lo valida el lambda (422). */
+export declare class ReferralRewardInput {
+    type: ReferralRewardTypeEnum;
+    amountCents?: number | null;
+    percentBps?: number | null;
+    maxAmountCents?: number | null;
+    coupon?: CouponLeverInput | null;
+}
+/** Bloque `referral` del body de la promo; su presencia la vuelve `REFERRAL`. Compra N y racha ≥ 2 los valida el lambda. */
+export declare class ReferralPromotionInput {
+    channel: ReferralPromotionChannelEnum;
+    trigger: ReferralTriggerEnum;
+    purchaseNumber?: number | null;
+    installmentStreak?: number | null;
+    minAmountCents?: number | null;
+    windowDays?: number | null;
+    maxRewardsPerReferrer?: number | null;
+    referrerReward: ReferralRewardInput;
+    referredReward?: ReferralRewardInput | null;
+}

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

@@ -0,0 +1,119 @@
+"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.ReferralPromotionInput = exports.ReferralRewardInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReferralPromotionChannelEnum_1 = require("../../enums/ReferralPromotionChannelEnum");
+const ReferralRewardTypeEnum_1 = require("../../enums/ReferralRewardTypeEnum");
+const ReferralTriggerEnum_1 = require("../../enums/ReferralTriggerEnum");
+const SalePromotionLeversInput_1 = require("./SalePromotionLeversInput");
+const isPercentReward = (o) => o.type === ReferralRewardTypeEnum_1.ReferralRewardTypeEnum.PERCENT_BONUS || o.type === ReferralRewardTypeEnum_1.ReferralRewardTypeEnum.SALE_DISCOUNT;
+/** Premio de un rol en el body: exige el campo de su `type`. Qué premio vale con qué evento lo valida el lambda (422). */
+class ReferralRewardInput {
+}
+exports.ReferralRewardInput = ReferralRewardInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReferralRewardTypeEnum_1.ReferralRewardTypeEnum),
+    __metadata("design:type", String)
+], ReferralRewardInput.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.type === ReferralRewardTypeEnum_1.ReferralRewardTypeEnum.FIXED_BONUS),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ReferralRewardInput.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)(isPercentReward),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(10000),
+    __metadata("design:type", Number)
+], ReferralRewardInput.prototype, "percentBps", 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)
+], ReferralRewardInput.prototype, "maxAmountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.type === ReferralRewardTypeEnum_1.ReferralRewardTypeEnum.COUPON),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SalePromotionLeversInput_1.CouponLeverInput),
+    __metadata("design:type", SalePromotionLeversInput_1.CouponLeverInput)
+], ReferralRewardInput.prototype, "coupon", void 0);
+/** Bloque `referral` del body de la promo; su presencia la vuelve `REFERRAL`. Compra N y racha ≥ 2 los valida el lambda. */
+class ReferralPromotionInput {
+}
+exports.ReferralPromotionInput = ReferralPromotionInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReferralPromotionChannelEnum_1.ReferralPromotionChannelEnum),
+    __metadata("design:type", String)
+], ReferralPromotionInput.prototype, "channel", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReferralTriggerEnum_1.ReferralTriggerEnum),
+    __metadata("design:type", String)
+], ReferralPromotionInput.prototype, "trigger", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], ReferralPromotionInput.prototype, "purchaseNumber", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], ReferralPromotionInput.prototype, "installmentStreak", 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, "minAmountCents", 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, "windowDays", 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, "maxRewardsPerReferrer", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ReferralRewardInput),
+    __metadata("design:type", ReferralRewardInput)
+], ReferralPromotionInput.prototype, "referrerReward", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ReferralRewardInput),
+    __metadata("design:type", ReferralRewardInput)
+], ReferralPromotionInput.prototype, "referredReward", void 0);

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

@@ -1,5 +1,6 @@
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
+import { ReferralPromotionInput } from './ReferralPromotionInput';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 /** Body de publicUpdateSalePromotion: parche; el lambda crea una versión nueva para ventas futuras. */
@@ -21,4 +22,6 @@ export declare class UpdateSalePromotionRequest {
     oncePerCustomer?: boolean;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable?: boolean;
+    /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
+    referral?: ReferralPromotionInput | null;
 }

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

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
 const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
+const ReferralPromotionInput_1 = require("./ReferralPromotionInput");
 const SalePromotionLeversInput_1 = require("./SalePromotionLeversInput");
 const SalePromotionScopeInput_1 = require("./SalePromotionScopeInput");
 /** Body de publicUpdateSalePromotion: parche; el lambda crea una versión nueva para ventas futuras. */
@@ -97,3 +98,10 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], UpdateSalePromotionRequest.prototype, "stackable", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ReferralPromotionInput_1.ReferralPromotionInput),
+    __metadata("design:type", ReferralPromotionInput_1.ReferralPromotionInput)
+], UpdateSalePromotionRequest.prototype, "referral", void 0);

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

@@ -0,0 +1,25 @@
+import { ReferralRoleEnum } from '../../../retailCustomer/enums/ReferralRoleEnum';
+import { ReferralRewardStatusEnum } from '../../enums/ReferralRewardStatusEnum';
+import { ReferralRewardTypeEnum } from '../../enums/ReferralRewardTypeEnum';
+/** Premio de referido de un teléfono en una promo (candado REWARD#). Sin PII. */
+export interface ReferralRewardByPhone {
+    promotionId: string;
+    promotionName: string;
+    referralId: string;
+    role: ReferralRoleEnum;
+    rewardType: ReferralRewardTypeEnum;
+    /** `null` si el premio no tiene monto en centavos. */
+    amountCents: number | null;
+    status: ReferralRewardStatusEnum;
+    /** Fecha del estado: pago, reserva o anulación. */
+    statusAt: string;
+}
+/** Premios de un teléfono; vacío si no tiene. */
+export interface ReferralRewardsOfPhone {
+    phone: string;
+    rewards: ReferralRewardByPhone[];
+}
+/** Respuesta de la ruta privada de premios por cadena y lote de teléfonos. */
+export interface ReferralRewardsByPhonesResponse {
+    phones: ReferralRewardsOfPhone[];
+}

package/bin/retailPromotions/dtos/responses/ReferralRewardsByPhonesResponses.js

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

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

@@ -0,0 +1,16 @@
+/** 200 de privateCheckSalePromotionPayment: todas las promos apartadas admiten el medio. */
+export interface PrivateSalePromotionPaymentCheckResponse {
+    sessionId: string;
+    /** Promos apartadas que se revisaron; vacía si la sesión no tiene promo. */
+    checkedPromotionIds: string[];
+}
+/** `data` del 422 PROMOTION_PAYMENT_NOT_ELIGIBLE; las listas van separadas por coma. */
+export interface PromotionPaymentNotEligibleDetails {
+    /** Todas las promos que no admiten el medio. */
+    promotionIds: string;
+    /** La primera de ellas, para el copy. */
+    promotionId: string;
+    promotionName: string;
+    /** `PromotionPaymentOptionEnum` que acepta esa promo. */
+    acceptedOptions: string;
+}

package/bin/retailPromotions/dtos/responses/SalePromotionPaymentCheckResponses.js

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

package/bin/retailPromotions/enums/ReferralPromotionChannelEnum.d.ts

@@ -0,0 +1,5 @@
+/** Dónde vive la promo de referido: en promos de venta o en promos de crédito. */
+export declare enum ReferralPromotionChannelEnum {
+    SALE = "SALE",
+    CREDIT = "CREDIT"
+}