@fiado/type-kit 3.564.0 → 3.566.0

package/_test_/unit/retailWizard/backofficeCustomerReferrals.test.ts

@@ -0,0 +1,78 @@
+import 'reflect-metadata';
+import { RetailWizard } from '../../../src/index';
+import type {
+    BackofficeCustomerReferral,
+    BackofficeCustomerReferralsResponse,
+    BackofficeReferralReward,
+} from '../../../src/retailWizard/index';
+import { ReferralRoleEnum, ReferralSourceEnum, ReferralStatusEnum } from '../../../src/retailCustomer/index';
+import { ReferralRewardStatusEnum, ReferralRewardTypeEnum } from '../../../src/retailPromotions/index';
+
+const reward: BackofficeReferralReward = {
+    promotionId: 'promo_1',
+    promotionName: 'Abre tu cuenta · ganan los dos',
+    role: ReferralRoleEnum.REFERRED,
+    rewardType: ReferralRewardTypeEnum.FIXED_BONUS,
+    amountCents: 10000,
+    status: ReferralRewardStatusEnum.PAID,
+    statusAt: '2025-03-14T10:00:00.000Z',
+};
+
+const referral: BackofficeCustomerReferral = {
+    referralId: 'ref_1',
+    name: 'Ana Sofía Martínez Ruiz',
+    phone: '5587654321',
+    email: null,
+    status: ReferralStatusEnum.SUREKEEP_CREDIT,
+    capture: {
+        source: ReferralSourceEnum.SALE,
+        storeId: 'store_1',
+        storeName: 'Tienda Coyoacán Centro',
+        saleId: 'sale_1',
+        saleFolio: 'F-10423',
+        accountOpeningSessionId: null,
+        capturedBy: 'user_1',
+        capturedAt: '2026-10-03T10:00:00.000Z',
+    },
+    updatedBy: 'user_1',
+    updatedAt: '2026-10-03T10:00:00.000Z',
+};
+
+describe('BackofficeCustomerReferralsResponse', () => {
+    it('lista los referidos con estado y captura, sin premios en la tanda A', () => {
+        const response: BackofficeCustomerReferralsResponse = { referrals: [referral], referredBy: null };
+        expect(response.referrals[0].rewards).toBeUndefined();
+        expect(response.referrals[0].capture.source).toBe('SALE');
+    });
+
+    it('suma premios por referido y el bloque «llegó recomendado por» en la tanda B', () => {
+        const response: BackofficeCustomerReferralsResponse = {
+            referrals: [{ ...referral, rewards: [{ ...reward, role: ReferralRoleEnum.REFERRER }] }],
+            referredBy: {
+                referralId: 'ref_9',
+                referrerCustomerId: 'rc_9',
+                referrerName: 'Mariana López Ortega',
+                referredAt: '2025-03-02T10:00:00.000Z',
+                rewards: [reward],
+            },
+        };
+        expect(response.referredBy?.rewards?.[0].promotionName).toBe('Abre tu cuenta · ganan los dos');
+    });
+
+    it('el bloque «llegó recomendado por» no exige promo', () => {
+        const response: BackofficeCustomerReferralsResponse = {
+            referrals: [],
+            referredBy: {
+                referralId: 'ref_9',
+                referrerCustomerId: 'rc_9',
+                referrerName: 'Mariana López Ortega',
+                referredAt: '2025-03-02T10:00:00.000Z',
+            },
+        };
+        expect(response.referredBy?.rewards).toBeUndefined();
+    });
+
+    it('el index raíz sigue exponiendo el módulo', () => {
+        expect(RetailWizard.WizardStepEnum).toBeDefined();
+    });
+});

package/_test_/unit/retailWizard/promotionInboundMessages.test.ts

@@ -0,0 +1,151 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { RetailWizard } from '../../../src/index';
+import {
+    RetailPromotionAccountOpenedMessage,
+    RetailPromotionInboundMessage,
+    RetailPromotionInboundMessageTypeEnum,
+    RetailPromotionInstallmentPaidMessage,
+} from '../../../src/retailWizard/index';
+import type { RetailPromotionQueueMessage } from '../../../src/retailWizard/index';
+
+const errorsOf = <T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] =>
+    validateSync(plainToInstance(cls, payload)).map((e) => e.property);
+
+describe('RetailPromotionInboundMessageTypeEnum', () => {
+    it('suma la apertura y la cuota pagada sin mover los de venta', () => {
+        expect(Object.values(RetailPromotionInboundMessageTypeEnum)).toEqual([
+            'SALE_CONFIRMED',
+            'SALE_CANCELLED',
+            'ACCOUNT_OPENED',
+            'CREDIT_INSTALLMENT_PAID',
+        ]);
+    });
+});
+
+const SALE = {
+    type: 'SALE_CONFIRMED',
+    tenantId: 't-1',
+    retailerId: 'r-1',
+    storeId: 'st-1',
+    saleId: 'sale-1',
+    sessionId: 'ws-1',
+    customerId: 'c-1',
+    soldAt: '2026-10-21T10:00:00Z',
+    occurredAt: '2026-10-21T10:00:00Z',
+    lines: [{ lineId: 'l-1', sku: 'SKU-1', qty: 1, originalPriceCents: 100_00, identifiers: [] }],
+};
+
+describe('RetailPromotionInboundMessage (venta)', () => {
+    it('sigue aceptando el mensaje viejo sin los campos nuevos', () => {
+        expect(errorsOf(RetailPromotionInboundMessage, SALE)).toEqual([]);
+    });
+
+    it('acepta forma de pago, medio, financiera, monto, número de compra y teléfono', () => {
+        const extended = {
+            ...SALE,
+            saleType: 'EXTERNAL_REFERRAL',
+            paymentMethod: 'CARD',
+            externalProvider: 'PAYJOY',
+            amountCents: 8_000_00,
+            purchaseNumber: 2,
+            phone: '5512345678',
+        };
+        expect(errorsOf(RetailPromotionInboundMessage, extended)).toEqual([]);
+    });
+
+    it('rechaza valores nuevos fuera de rango', () => {
+        expect(errorsOf(RetailPromotionInboundMessage, { ...SALE, saleType: 'LAYAWAY' })).toEqual(['saleType']);
+        expect(errorsOf(RetailPromotionInboundMessage, { ...SALE, purchaseNumber: 0 })).toEqual(['purchaseNumber']);
+        expect(errorsOf(RetailPromotionInboundMessage, { ...SALE, amountCents: -1 })).toEqual(['amountCents']);
+        expect(errorsOf(RetailPromotionInboundMessage, { ...SALE, phone: '' })).toEqual(['phone']);
+    });
+
+    it('solo valida tipos de venta', () => {
+        expect(errorsOf(RetailPromotionInboundMessage, { ...SALE, type: 'ACCOUNT_OPENED' })).toEqual(['type']);
+    });
+});
+
+const OPENED = {
+    type: 'ACCOUNT_OPENED',
+    tenantId: 't-1',
+    retailerId: 'r-1',
+    storeId: 'st-1',
+    customerId: 'c-1',
+    phone: '5512345678',
+    sessionId: 'ws-1',
+    openedAt: '2026-10-21T10:00:00Z',
+};
+
+describe('RetailPromotionAccountOpenedMessage', () => {
+    it('acepta la apertura', () => {
+        expect(errorsOf(RetailPromotionAccountOpenedMessage, OPENED)).toEqual([]);
+    });
+
+    it('no hereda de la clase de venta', () => {
+        expect(new RetailPromotionAccountOpenedMessage()).not.toBeInstanceOf(RetailPromotionInboundMessage);
+    });
+
+    it('rechaza otro tipo y campos faltantes', () => {
+        expect(errorsOf(RetailPromotionAccountOpenedMessage, { ...OPENED, type: 'SALE_CONFIRMED' })).toEqual(['type']);
+        const { phone: _phone, ...noPhone } = OPENED;
+        expect(errorsOf(RetailPromotionAccountOpenedMessage, { ...noPhone, openedAt: 'hoy' })).toEqual([
+            'phone',
+            'openedAt',
+        ]);
+    });
+});
+
+const PAID = {
+    type: 'CREDIT_INSTALLMENT_PAID',
+    tenantId: 't-1',
+    creditId: 'cr-1',
+    installmentNumber: 1,
+    paidCents: 500_00,
+    paidAt: '2026-10-21T10:00:00Z',
+    installmentStatus: 'PAID',
+    paymentId: 'pay-1',
+    wizardSessionId: 'ws-1',
+    storeId: 'st-1',
+    onTime: true,
+    onTimeStreak: 1,
+};
+
+describe('RetailPromotionInstallmentPaidMessage', () => {
+    it('acepta la cuota pagada con onTime y racha', () => {
+        expect(errorsOf(RetailPromotionInstallmentPaidMessage, PAID)).toEqual([]);
+    });
+
+    it('no hereda de la clase de venta', () => {
+        expect(new RetailPromotionInstallmentPaidMessage()).not.toBeInstanceOf(RetailPromotionInboundMessage);
+    });
+
+    it('rechaza racha negativa, cuota 0, onTime no booleano y otro tipo', () => {
+        const bad = { ...PAID, type: 'ACCOUNT_OPENED', installmentNumber: 0, onTime: 'sí', onTimeStreak: -1 };
+        expect(errorsOf(RetailPromotionInstallmentPaidMessage, bad)).toEqual([
+            'type',
+            'installmentNumber',
+            'onTime',
+            'onTimeStreak',
+        ]);
+    });
+
+    it('rechaza un estado de cuota fuera del catálogo', () => {
+        expect(errorsOf(RetailPromotionInstallmentPaidMessage, { ...PAID, installmentStatus: 'X' })).toEqual([
+            'installmentStatus',
+        ]);
+    });
+});
+
+describe('RetailPromotionQueueMessage', () => {
+    it('une los tres mensajes de la cola y sale por el index raíz', () => {
+        const messages: RetailPromotionQueueMessage[] = [
+            plainToInstance(RetailPromotionInboundMessage, SALE),
+            plainToInstance(RetailPromotionAccountOpenedMessage, OPENED),
+            plainToInstance(RetailPromotionInstallmentPaidMessage, PAID),
+        ];
+        expect(messages.map((m) => m.type)).toEqual(['SALE_CONFIRMED', 'ACCOUNT_OPENED', 'CREDIT_INSTALLMENT_PAID']);
+        expect(new RetailWizard.RetailPromotionAccountOpenedMessage()).toBeInstanceOf(RetailPromotionAccountOpenedMessage);
+    });
+});

package/_test_/unit/retailWizard/referralsCapture.test.ts

@@ -0,0 +1,66 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { ValidationError, validateSync } from 'class-validator';
+import { RetailCommissionInboundMessage, WizardStepEnum } from '../../../src/retailWizard/index';
+
+function pathsOf(errors: ValidationError[], prefix = ''): string[] {
+    return errors.flatMap((e) => {
+        const path = `${prefix}${e.property}`;
+        return e.children && e.children.length > 0 ? pathsOf(e.children, `${path}.`) : [path];
+    });
+}
+
+const errorsOf = (payload: Record<string, unknown>): string[] =>
+    pathsOf(validateSync(plainToInstance(RetailCommissionInboundMessage, payload)));
+
+describe('WizardStepEnum', () => {
+    it('suma el paso Referidos como S11 sin mover los existentes', () => {
+        expect(Object.values(WizardStepEnum)).toEqual([
+            'S01', 'S02', 'S03', 'S04', 'S05', 'S06', 'S07', 'S08', 'S09', 'S10', 'S11',
+        ]);
+    });
+});
+
+const SALE_COMPLETED = {
+    type: 'SALE_COMPLETED',
+    tenantId: 't-1',
+    retailerId: 'r-1',
+    storeId: 'st-1',
+    saleId: 'sale-1',
+    sessionId: 'ws-1',
+    sellerRetailUserId: 'seller-1',
+    saleType: 'CASH',
+    externalProvider: null,
+    creditId: null,
+    soldAt: '2026-10-21T10:00:00Z',
+    occurredAt: '2026-10-21T10:00:00Z',
+    lines: [
+        {
+            lineId: 'l-1',
+            sku: 'SKU-1',
+            qty: 1,
+            netCents: 100_00,
+            itemType: 'PRODUCT',
+            category: null,
+            tier: null,
+            brand: null,
+            paymentType: 'CASH',
+        },
+    ],
+};
+
+describe('RetailCommissionInboundMessage.referrals', () => {
+    it('sigue aceptando mensajes sin referidos', () => {
+        expect(errorsOf(SALE_COMPLETED)).toEqual([]);
+    });
+
+    it('acepta los referidos con quién los capturó', () => {
+        const referrals = [{ referralId: 'ref-1', capturedBy: 'seller-1' }];
+        expect(errorsOf({ ...SALE_COMPLETED, referrals })).toEqual([]);
+    });
+
+    it('rechaza un referido sin id o sin capturista', () => {
+        const referrals = [{ referralId: '', capturedBy: 'seller-1' }, { referralId: 'ref-2' }];
+        expect(errorsOf({ ...SALE_COMPLETED, referrals })).toEqual(['referrals.0.referralId', 'referrals.1.capturedBy']);
+    });
+});

package/_test_/unit/retailWizard/ventaSagaMessages.test.ts

@@ -25,8 +25,13 @@ function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object):
 }
 
 describe('RetailPromotionInboundMessageTypeEnum', () => {
-  it('distingue confirmación y cancelación', () => {
-    expect(Object.values(RetailPromotionInboundMessageTypeEnum)).toEqual(['SALE_CONFIRMED', 'SALE_CANCELLED']);
+  it('distingue confirmación, cancelación, apertura y cuota pagada', () => {
+    expect(Object.values(RetailPromotionInboundMessageTypeEnum)).toEqual([
+      'SALE_CONFIRMED',
+      'SALE_CANCELLED',
+      'ACCOUNT_OPENED',
+      'CREDIT_INSTALLMENT_PAID',
+    ]);
   });
 });
 

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

@@ -0,0 +1,25 @@
+import { ReferralSourceEnum } from '../enums/ReferralSourceEnum';
+/** Persona que un cliente recomienda (owner: retail-customer-business). Teléfono normalizado a 10 dígitos. */
+export declare class CustomerReferral {
+    referralId: string;
+    /** Cliente que recomienda. */
+    retailCustomerId: string;
+    /** Cadena del cliente que recomienda. */
+    retailerId: string;
+    /** Tienda de captura; `null` si se agregó en el cajón. */
+    storeId: string | null;
+    name: string;
+    phone: string;
+    email: string | null;
+    source: ReferralSourceEnum;
+    /** Sesión del wizard donde se capturó (venta). */
+    wizardSessionId: string | null;
+    /** Solo en `SALE`. */
+    saleId: string | null;
+    /** Solo en `OPENING`. */
+    accountOpeningSessionId: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/retailCustomer/dtos/CustomerReferral.js

@@ -0,0 +1,99 @@
+"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.CustomerReferral = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReferralSourceEnum_1 = require("../enums/ReferralSourceEnum");
+/** Persona que un cliente recomienda (owner: retail-customer-business). Teléfono normalizado a 10 dígitos. */
+class CustomerReferral {
+}
+exports.CustomerReferral = CustomerReferral;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "referralId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "retailCustomerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReferralSourceEnum_1.ReferralSourceEnum),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "source", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "wizardSessionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "saleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "accountOpeningSessionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "createdBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "updatedBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "createdAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], CustomerReferral.prototype, "updatedAt", void 0);

package/bin/retailCustomer/dtos/requests/CreateCustomerReferralsRequest.d.ts

@@ -0,0 +1,19 @@
+import { ReferralSourceEnum } from '../../enums/ReferralSourceEnum';
+/** Un renglón del lote. El teléfono llega como se tecleó; el lambda lo normaliza y valida. */
+export declare class CustomerReferralInput {
+    name: string;
+    phone: string;
+    email?: string;
+}
+/** Body de `privateCreateCustomerReferrals`: lote de referidos de un cliente. */
+export declare class CreateCustomerReferralsRequest {
+    source: ReferralSourceEnum;
+    /** Tienda de captura; obligatoria en venta y apertura. */
+    storeId?: string;
+    wizardSessionId?: string;
+    saleId?: string;
+    accountOpeningSessionId?: string;
+    /** Usuario que capturó (vendedor o admin); la llamada M2M no lo trae en el token. */
+    capturedBy: string;
+    referrals: CustomerReferralInput[];
+}

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

@@ -0,0 +1,101 @@
+"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.CreateCustomerReferralsRequest = exports.CustomerReferralInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const Trim_1 = require("../../../common/decorators/Trim");
+const InputPatterns_1 = require("../../../common/constants/InputPatterns");
+const ReferralSourceEnum_1 = require("../../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. */
+class CustomerReferralInput {
+}
+exports.CustomerReferralInput = CustomerReferralInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(REFERRAL_NAME_MAX_LENGTH),
+    __metadata("design:type", String)
+], CustomerReferralInput.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CustomerReferralInput.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.MaxLength)(InputPatterns_1.EMAIL_MAX_LENGTH),
+    __metadata("design:type", String)
+], CustomerReferralInput.prototype, "email", void 0);
+/** Body de `privateCreateCustomerReferrals`: lote de referidos de un cliente. */
+class CreateCustomerReferralsRequest {
+}
+exports.CreateCustomerReferralsRequest = CreateCustomerReferralsRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReferralSourceEnum_1.ReferralSourceEnum),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "source", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.source !== ReferralSourceEnum_1.ReferralSourceEnum.BACKOFFICE || o.storeId !== undefined),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "wizardSessionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "saleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "accountOpeningSessionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "capturedBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CustomerReferralInput),
+    __metadata("design:type", Array)
+], CreateCustomerReferralsRequest.prototype, "referrals", void 0);

package/bin/retailCustomer/dtos/requests/GetCustomersByPhonesRequest.d.ts

@@ -0,0 +1,4 @@
+/** Body de `privateGetCustomersByPhones`: qué teléfonos ya son clientes. */
+export declare class GetCustomersByPhonesRequest {
+    phones: string[];
+}

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

@@ -0,0 +1,28 @@
+"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.GetCustomersByPhonesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const PHONES_MAX_BATCH = 100;
+/** Body de `privateGetCustomersByPhones`: qué teléfonos ya son clientes. */
+class GetCustomersByPhonesRequest {
+}
+exports.GetCustomersByPhonesRequest = GetCustomersByPhonesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(PHONES_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], GetCustomersByPhonesRequest.prototype, "phones", void 0);

package/bin/retailCustomer/dtos/requests/GetReferralsByPhoneQuery.d.ts

@@ -0,0 +1,6 @@
+/** Query de `privateGetReferralsByPhone`: quién recomendó ese teléfono en la cadena, capturado antes de `before`. */
+export declare class GetReferralsByPhoneQuery {
+    retailerId: string;
+    phone: string;
+    before?: string;
+}

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

@@ -0,0 +1,39 @@
+"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.GetReferralsByPhoneQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const Trim_1 = require("../../../common/decorators/Trim");
+/** Query de `privateGetReferralsByPhone`: quién recomendó ese teléfono en la cadena, capturado antes de `before`. */
+class GetReferralsByPhoneQuery {
+}
+exports.GetReferralsByPhoneQuery = GetReferralsByPhoneQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GetReferralsByPhoneQuery.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GetReferralsByPhoneQuery.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], GetReferralsByPhoneQuery.prototype, "before", void 0);

package/bin/retailCustomer/dtos/requests/UpdateCustomerReferralRequest.d.ts

@@ -0,0 +1,8 @@
+/** Body de `privateUpdateCustomerReferral`: corrige datos sin cambiar dónde se capturó. `email: null` lo quita. */
+export declare class UpdateCustomerReferralRequest {
+    name?: string;
+    phone?: string;
+    email?: string | null;
+    /** Usuario que edita; la llamada M2M no lo trae en el token. */
+    updatedBy: string;
+}