@fiado/type-kit 3.564.0 → 3.566.0

package/bin/retailWizard/events/RetailCommissionInboundMessage.js

@@ -9,7 +9,7 @@ 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.RetailCommissionInboundMessage = exports.RetailCommissionInboundLine = void 0;
+exports.RetailCommissionInboundMessage = exports.RetailCommissionInboundReferral = exports.RetailCommissionInboundLine = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const ItemTypeEnum_1 = require("../../retailCatalog/enums/ItemTypeEnum");
@@ -78,6 +78,20 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], RetailCommissionInboundLine.prototype, "phoneCount", void 0);
+/** Referido capturado en la venta, con quien lo capturó para su comisión. */
+class RetailCommissionInboundReferral {
+}
+exports.RetailCommissionInboundReferral = RetailCommissionInboundReferral;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundReferral.prototype, "referralId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundReferral.prototype, "capturedBy", void 0);
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 class RetailCommissionInboundMessage {
 }
@@ -151,3 +165,10 @@ __decorate([
     (0, class_transformer_1.Type)(() => RetailCommissionInboundLine),
     __metadata("design:type", Array)
 ], RetailCommissionInboundMessage.prototype, "lines", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RetailCommissionInboundReferral),
+    __metadata("design:type", Array)
+], RetailCommissionInboundMessage.prototype, "referrals", void 0);

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

@@ -0,0 +1,15 @@
+import { RetailPromotionInboundMessageTypeEnum } from '../enums/RetailPromotionInboundMessageTypeEnum';
+/** Cuenta PCF que quedó OPEN (LINKED no cuenta); el wizard la publica en RetailPromotionInboundQueue. */
+export declare class RetailPromotionAccountOpenedMessage {
+    type: RetailPromotionInboundMessageTypeEnum.ACCOUNT_OPENED;
+    tenantId: string;
+    retailerId: string;
+    storeId: string;
+    /** El retailCustomerId de quien abrió la cuenta. */
+    customerId: string;
+    /** Teléfono a 10 dígitos: con él se busca al referidor. */
+    phone: string;
+    /** Sesión del wizard donde se abrió la cuenta. */
+    sessionId: string;
+    openedAt: string;
+}

package/bin/retailWizard/events/RetailPromotionAccountOpenedMessage.js

@@ -0,0 +1,56 @@
+"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.RetailPromotionAccountOpenedMessage = void 0;
+const class_validator_1 = require("class-validator");
+const RetailPromotionInboundMessageTypeEnum_1 = require("../enums/RetailPromotionInboundMessageTypeEnum");
+/** Cuenta PCF que quedó OPEN (LINKED no cuenta); el wizard la publica en RetailPromotionInboundQueue. */
+class RetailPromotionAccountOpenedMessage {
+}
+exports.RetailPromotionAccountOpenedMessage = RetailPromotionAccountOpenedMessage;
+__decorate([
+    (0, class_validator_1.Equals)(RetailPromotionInboundMessageTypeEnum_1.RetailPromotionInboundMessageTypeEnum.ACCOUNT_OPENED),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "customerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "phone", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RetailPromotionAccountOpenedMessage.prototype, "openedAt", void 0);

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

@@ -1,6 +1,9 @@
 import { LinePromotionAmount } from '../../retailPromotions/dtos/LinePromotionAmount';
 import { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
+import { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import { RetailPromotionInboundMessageTypeEnum } from '../enums/RetailPromotionInboundMessageTypeEnum';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import { SaleTypeEnum } from '../enums/SaleTypeEnum';
 import { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 /** Línea de la venta en el mensaje de Promociones. */
 export declare class RetailPromotionInboundLine {
@@ -45,4 +48,16 @@ export declare class RetailPromotionInboundMessage {
     /** Todas las promos de venta de la venta; `salePromotionId` queda como la principal. */
     salePromotions?: SalePromotionRef[] | null;
     lines: RetailPromotionInboundLine[];
+    /** Forma de pago; ausente en mensajes viejos. */
+    saleType?: SaleTypeEnum;
+    /** Medio de cobro, solo en contado. */
+    paymentMethod?: SalePaymentMethodEnum | null;
+    /** Financiera externa, solo en `EXTERNAL_REFERRAL`. */
+    externalProvider?: ExternalProviderEnum | null;
+    /** Precio del equipo en centavos; en crédito no es el enganche. */
+    amountCents?: number;
+    /** 1 + ventas no canceladas del cliente en la cadena. */
+    purchaseNumber?: number;
+    /** Teléfono del cliente a 10 dígitos. */
+    phone?: string;
 }

package/bin/retailWizard/events/RetailPromotionInboundMessage.js

@@ -14,7 +14,10 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const LinePromotionAmount_1 = require("../../retailPromotions/dtos/LinePromotionAmount");
 const SalePromotionRef_1 = require("../../retailPromotions/dtos/SalePromotionRef");
+const ExternalProviderEnum_1 = require("../enums/ExternalProviderEnum");
 const RetailPromotionInboundMessageTypeEnum_1 = require("../enums/RetailPromotionInboundMessageTypeEnum");
+const SalePaymentMethodEnum_1 = require("../enums/SalePaymentMethodEnum");
+const SaleTypeEnum_1 = require("../enums/SaleTypeEnum");
 const WizardLineRoleEnum_1 = require("../enums/WizardLineRoleEnum");
 /** Línea de la venta en el mensaje de Promociones. */
 class RetailPromotionInboundLine {
@@ -98,12 +101,16 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], RetailPromotionInboundLine.prototype, "returned", void 0);
+const SALE_MESSAGE_TYPES = [
+    RetailPromotionInboundMessageTypeEnum_1.RetailPromotionInboundMessageTypeEnum.SALE_CONFIRMED,
+    RetailPromotionInboundMessageTypeEnum_1.RetailPromotionInboundMessageTypeEnum.SALE_CANCELLED,
+];
 /** Venta confirmada o cancelada que el wizard publica en RetailPromotionInboundQueue; crédito = trae creditId. */
 class RetailPromotionInboundMessage {
 }
 exports.RetailPromotionInboundMessage = RetailPromotionInboundMessage;
 __decorate([
-    (0, class_validator_1.IsEnum)(RetailPromotionInboundMessageTypeEnum_1.RetailPromotionInboundMessageTypeEnum),
+    (0, class_validator_1.IsIn)(SALE_MESSAGE_TYPES),
     __metadata("design:type", String)
 ], RetailPromotionInboundMessage.prototype, "type", void 0);
 __decorate([
@@ -182,3 +189,36 @@ __decorate([
     (0, class_transformer_1.Type)(() => RetailPromotionInboundLine),
     __metadata("design:type", Array)
 ], RetailPromotionInboundMessage.prototype, "lines", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SaleTypeEnum_1.SaleTypeEnum),
+    __metadata("design:type", String)
+], RetailPromotionInboundMessage.prototype, "saleType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
+    __metadata("design:type", String)
+], RetailPromotionInboundMessage.prototype, "paymentMethod", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ExternalProviderEnum_1.ExternalProviderEnum),
+    __metadata("design:type", String)
+], RetailPromotionInboundMessage.prototype, "externalProvider", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailPromotionInboundMessage.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], RetailPromotionInboundMessage.prototype, "purchaseNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailPromotionInboundMessage.prototype, "phone", void 0);

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

@@ -0,0 +1,20 @@
+import { LoanInstallmentStatusEnum } from '../../loanCredit/enums/LoanInstallmentStatusEnum';
+import { RetailPromotionInboundMessageTypeEnum } from '../enums/RetailPromotionInboundMessageTypeEnum';
+/** Cuota pagada que loan-credit publica en RetailPromotionInboundQueue: `InstallmentPaidV1` + contexto. Sin PII. */
+export declare class RetailPromotionInstallmentPaidMessage {
+    type: RetailPromotionInboundMessageTypeEnum.CREDIT_INSTALLMENT_PAID;
+    tenantId: string;
+    creditId: string;
+    installmentNumber: number;
+    /** Lo pagado de la cuota en total, en centavos. */
+    paidCents: number;
+    paidAt: string;
+    installmentStatus: LoanInstallmentStatusEnum;
+    paymentId: string;
+    wizardSessionId: string;
+    storeId: string;
+    /** Pagada a más tardar en su vencimiento. */
+    onTime: boolean;
+    /** Cuotas seguidas a tiempo hasta esta, incluida; 0 si esta fue tarde. */
+    onTimeStreak: number;
+}

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