@fiado/type-kit 3.636.0 → 3.638.0

package/_test_/unit/emailVerification/dtos/internal/EmailOwnersByEmailRequest.test.ts

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { EmailOwnersByEmailRequest } from '../../../../../src/emailVerification/dtos/internal/EmailOwnersByEmailRequest';
+import * as emailVerification from '../../../../../src/emailVerification';
+
+describe('EmailOwnersByEmailRequest', () => {
+    it('valida happy path (0 errores)', async () => {
+        const dto = plainToInstance(EmailOwnersByEmailRequest, { email: 'persona@ejemplo.com' });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si email no es un correo válido', async () => {
+        const dto = plainToInstance(EmailOwnersByEmailRequest, { email: 'no-es-correo' });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'email')).toBe(true);
+    });
+
+    it('falla si falta email', async () => {
+        const dto = plainToInstance(EmailOwnersByEmailRequest, {});
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'email')).toBe(true);
+    });
+
+    it('se exporta desde el barrel de emailVerification', () => {
+        expect(emailVerification.EmailOwnersByEmailRequest).toBe(EmailOwnersByEmailRequest);
+    });
+});

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

@@ -3,6 +3,7 @@ import { plainToInstance } from 'class-transformer';
 import { validateSync, type ValidationError } from 'class-validator';
 import { SalePayment } from '../../../src/retailWizard/dtos/SalePayment';
 import { WizardPayment } from '../../../src/retailWizard/dtos/WizardPayment';
+import { StoredSalePayment } from '../../../src/retailWizard/dtos/StoredSalePayment';
 import { RegisterPaymentRequest } from '../../../src/retailWizard/dtos/requests/RegisterPaymentRequest';
 import { DownPaymentRequest } from '../../../src/retailWizard/dtos/requests/DownPaymentRequest';
 import { CreateAccessorySaleRequest } from '../../../src/retailWizard/dtos/requests/CreateAccessorySaleRequest';
@@ -28,17 +29,32 @@ const cash = { method: CASH, amountCents: 10000, cashConfirmedInRegister: true }
 const card = { method: CARD, amountCents: 5000, cardLast4: '4242', authCode: 'A1B2C3' };
 const wire = { method: WIRE, amountCents: 5000, speiTrackingKey: 'MBAN01002610', senderClabe: '012180001234567897' };
 
-describe('SalePayment', () => {
+describe('SalePayment (forma del request)', () => {
+  it('acepta cualquier monto entero y comprobante en texto, sin revisar formato ni medio', () => {
+    expect(errorsOf(SalePayment, { method: CARD, amountCents: 0, cardLast4: '1', authCode: ' ' })).toEqual([]);
+    expect(errorsOf(SalePayment, { method: CASH, amountCents: -5, speiTrackingKey: 'MBAN-01' })).toEqual([]);
+    expect(errorsOf(SalePayment, { method: WIRE, amountCents: 1, senderClabe: null, cashConfirmedInRegister: null })).toEqual([]);
+  });
+
+  it('rechaza lo que no tiene la forma', () => {
+    expect(errorsOf(SalePayment, { method: 'FIADO', amountCents: 1 })).toEqual(['method']);
+    expect(errorsOf(SalePayment, { method: CASH, amountCents: 1.5 })).toEqual(['amountCents']);
+    expect(errorsOf(SalePayment, { method: CARD, amountCents: 1, cardLast4: 4242 })).toEqual(['cardLast4']);
+    expect(errorsOf(SalePayment, { method: CASH, amountCents: 1, cashConfirmedInRegister: 'yes' })).toEqual(['cashConfirmedInRegister']);
+  });
+});
+
+describe('StoredSalePayment (cobro ya registrado)', () => {
   it('acepta cada medio con comprobante', () => {
-    expect(errorsOf(SalePayment, cash)).toEqual([]);
-    expect(errorsOf(SalePayment, card)).toEqual([]);
-    expect(errorsOf(SalePayment, wire)).toEqual([]);
+    expect(errorsOf(StoredSalePayment, cash)).toEqual([]);
+    expect(errorsOf(StoredSalePayment, card)).toEqual([]);
+    expect(errorsOf(StoredSalePayment, wire)).toEqual([]);
   });
 
   it('acepta tarjeta y SPEI sin comprobante, ausente o en null', () => {
-    expect(errorsOf(SalePayment, { method: CARD, amountCents: 5000 })).toEqual([]);
-    expect(errorsOf(SalePayment, { method: WIRE, amountCents: 5000, speiTrackingKey: null, senderClabe: null })).toEqual([]);
-    expect(errorsOf(SalePayment, { method: CASH, amountCents: 5000, cashConfirmedInRegister: null })).toEqual([]);
+    expect(errorsOf(StoredSalePayment, { method: CARD, amountCents: 5000 })).toEqual([]);
+    expect(errorsOf(StoredSalePayment, { method: WIRE, amountCents: 5000, speiTrackingKey: null, senderClabe: null })).toEqual([]);
+    expect(errorsOf(StoredSalePayment, { method: CASH, amountCents: 5000, cashConfirmedInRegister: null })).toEqual([]);
   });
 
   it.each([
@@ -49,7 +65,7 @@ describe('SalePayment', () => {
     ['senderClabe', { ...wire, senderClabe: '0121' }],
     ['cashConfirmedInRegister', { ...cash, cashConfirmedInRegister: 'yes' }],
   ])('rechaza %s con formato inválido', (field, payload) => {
-    expect(errorsOf(SalePayment, payload)).toEqual([field]);
+    expect(errorsOf(StoredSalePayment, payload)).toEqual([field]);
   });
 
   it.each([
@@ -57,13 +73,13 @@ describe('SalePayment', () => {
     ['speiTrackingKey', { ...card, speiTrackingKey: 'MBAN01' }],
     ['cashConfirmedInRegister', { ...wire, cashConfirmedInRegister: true }],
   ])('rechaza %s en un medio que no le corresponde', (field, payload) => {
-    expect(errorsOf(SalePayment, payload)).toEqual([field]);
+    expect(errorsOf(StoredSalePayment, payload)).toEqual([field]);
   });
 
   it('rechaza un medio fuera del enum y un monto no positivo', () => {
-    expect(errorsOf(SalePayment, { method: 'FIADO', amountCents: 100 })).toEqual(['method']);
-    expect(errorsOf(SalePayment, { ...cash, amountCents: 0 })).toEqual(['amountCents']);
-    expect(errorsOf(SalePayment, { ...cash, amountCents: 10.5 })).toEqual(['amountCents']);
+    expect(errorsOf(StoredSalePayment, { method: 'FIADO', amountCents: 100 })).toEqual(['method']);
+    expect(errorsOf(StoredSalePayment, { ...cash, amountCents: 0 })).toEqual(['amountCents']);
+    expect(errorsOf(StoredSalePayment, { ...cash, amountCents: 10.5 })).toEqual(['amountCents']);
   });
 });
 
@@ -72,10 +88,6 @@ describe('payments en RegisterPaymentRequest', () => {
     expect(errorsOf(RegisterPaymentRequest, { amountCents: 20000, payments: [cash, card, wire] })).toEqual([]);
   });
 
-  it('acepta tarjeta repetida', () => {
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 20000, payments: [cash, card, card] })).toEqual([]);
-  });
-
   it('sigue aceptando el formato viejo', () => {
     expect(errorsOf(RegisterPaymentRequest, { method: CASH, amountCents: 20000, detail: { cashConfirmedInRegister: true } })).toEqual([]);
   });
@@ -84,24 +96,17 @@ describe('payments en RegisterPaymentRequest', () => {
     expect(errorsOf(RegisterPaymentRequest, { amountCents: 20000 })).toEqual(['method']);
   });
 
-  it('rechaza efectivo o SPEI repetidos', () => {
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 20000, payments: [cash, cash] })).toEqual(['payments']);
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 10000, payments: [wire, wire] })).toEqual(['payments']);
-  });
-
-  it(`rechaza más de ${MAX_SALE_PAYMENTS} pagos o una lista vacía`, () => {
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 25000, payments: [cash, card, card, wire] })).toEqual(['payments']);
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 0, payments: [] })).toEqual(['payments']);
-  });
-
-  it('rechaza que la suma no cuadre con amountCents', () => {
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 20001, payments: [cash, card, wire] })).toEqual(['payments']);
+  it('deja pasar las reglas de negocio para que el dominio responda con su code', () => {
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 20000, payments: [cash, cash] })).toEqual([]);
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 25000, payments: [cash, card, card, wire] })).toEqual([]);
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 0, payments: [] })).toEqual([]);
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 20001, payments: [cash, card, wire] })).toEqual([]);
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 15000, payments: [cash, { ...card, cardLast4: '1' }] })).toEqual([]);
   });
 
-  it('reporta el campo del pago inválido', () => {
-    expect(errorsOf(RegisterPaymentRequest, { amountCents: 15000, payments: [cash, { ...card, cardLast4: '1' }] })).toEqual([
-      'payments.1.cardLast4',
-    ]);
+  it('rechaza lo que no tiene la forma y reporta el campo', () => {
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 1, payments: 'CASH' })).toEqual(['payments']);
+    expect(errorsOf(RegisterPaymentRequest, { amountCents: 1, payments: [{ ...card, method: 'FIADO' }] })).toEqual(['payments.0.method']);
   });
 });
 
@@ -135,16 +140,18 @@ describe('cobro de $0', () => {
 });
 
 describe('payments en los demás contratos', () => {
-  it('DownPaymentRequest acepta solo payments y valida la suma', () => {
+  it('DownPaymentRequest acepta solo payments y deja la suma al dominio', () => {
     expect(errorsOf(DownPaymentRequest, { amountCents: 15000, payments: [cash, wire] })).toEqual([]);
-    expect(errorsOf(DownPaymentRequest, { amountCents: 1, payments: [cash, wire] })).toEqual(['payments']);
+    expect(errorsOf(DownPaymentRequest, { amountCents: 1, payments: [cash, wire] })).toEqual([]);
+    expect(errorsOf(DownPaymentRequest, { amountCents: 1, payments: [{ ...wire, amountCents: 'x' }] })).toEqual(['payments.0.amountCents']);
   });
 
   it('CreateAccessorySaleRequest acepta solo payments y ya no exige paymentDetail', () => {
     const lines = [{ sku: 'ACC-1', qty: 1 }];
     expect(errorsOf(CreateAccessorySaleRequest, { lines, amountCents: 15000, payments: [cash, card] })).toEqual([]);
     expect(errorsOf(CreateAccessorySaleRequest, { lines, amountCents: 15000 })).toEqual(['paymentMethod']);
-    expect(errorsOf(CreateAccessorySaleRequest, { lines, amountCents: 20000, payments: [cash, cash] })).toEqual(['payments']);
+    expect(errorsOf(CreateAccessorySaleRequest, { lines, amountCents: 20000, payments: [cash, cash] })).toEqual([]);
+    expect(errorsOf(CreateAccessorySaleRequest, { lines, amountCents: 1, payments: [{ ...card, authCode: 7 }] })).toEqual(['payments.0.authCode']);
   });
 
   it('WizardPayment guarda payments tipados', () => {
@@ -152,6 +159,7 @@ describe('payments en los demás contratos', () => {
     expect(errorsOf(WizardPayment, { ...base, payments: [cash, card] })).toEqual([]);
     expect(errorsOf(WizardPayment, base)).toEqual([]);
     expect(errorsOf(WizardPayment, { ...base, payments: [cash, cash] })).toEqual(['payments']);
+    expect(errorsOf(WizardPayment, { ...base, payments: [{ ...card, cardLast4: '1' }] })).toEqual(['payments.0.cardLast4']);
   });
 
   it('RetailPromotionInboundMessage acepta paymentMethods y rechaza valores fuera del enum', () => {

package/bin/emailVerification/dtos/internal/EmailOwnersByEmailRequest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Request interno (api-invoker) para buscar qué directorios tienen un correo.
+ */
+export declare class EmailOwnersByEmailRequest {
+    email: string;
+}

package/bin/emailVerification/dtos/internal/EmailOwnersByEmailRequest.js

@@ -0,0 +1,25 @@
+"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.EmailOwnersByEmailRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Request interno (api-invoker) para buscar qué directorios tienen un correo.
+ */
+class EmailOwnersByEmailRequest {
+}
+exports.EmailOwnersByEmailRequest = EmailOwnersByEmailRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], EmailOwnersByEmailRequest.prototype, "email", void 0);

package/bin/emailVerification/index.d.ts

@@ -24,3 +24,4 @@ export * from './dtos/internal/EmailsByDirectoryRequest';
 export * from './dtos/internal/EmailsByDirectoryResponse';
 export * from './dtos/internal/EmailStartByDirectoryRequest';
 export * from './dtos/internal/EmailStartByDirectoryResponse';
+export * from './dtos/internal/EmailOwnersByEmailRequest';

package/bin/emailVerification/index.js

@@ -40,3 +40,4 @@ __exportStar(require("./dtos/internal/EmailsByDirectoryRequest"), exports);
 __exportStar(require("./dtos/internal/EmailsByDirectoryResponse"), exports);
 __exportStar(require("./dtos/internal/EmailStartByDirectoryRequest"), exports);
 __exportStar(require("./dtos/internal/EmailStartByDirectoryResponse"), exports);
+__exportStar(require("./dtos/internal/EmailOwnersByEmailRequest"), exports);

package/bin/retailCommission/dtos/CommissionApi.d.ts

@@ -1,4 +1,5 @@
 import type { CommissionPlanStatusEnum } from '../enums/CommissionPlanStatusEnum';
+import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
 import type { CommissionPayoutStatusEnum } from '../enums/CommissionPayoutStatusEnum';
 import type { CommissionAddOn, CommissionCategory, CommissionPlanSnapshot, CommissionQuota } from './CommissionPlan';
 import type { CommissionAccrual, CommissionAppliedBonus, CommissionSaleInput, CommissionSaleLine } from './CommissionAccrual';
@@ -227,12 +228,74 @@ export interface RuleActionResponse {
     rule: CommissionRule;
     snapshotId: string;
 }
+/** Un campo de la regla que cambió de una versión a la siguiente, con su valor antes y después. */
+export type CommissionRuleChange = {
+    field: 'name';
+    before: string;
+    after: string;
+} | {
+    field: 'description';
+    before: string | null;
+    after: string | null;
+} | {
+    field: 'levers';
+    before: CommissionRuleLevers;
+    after: CommissionRuleLevers;
+} | {
+    field: 'scope';
+    before: CommissionRuleScope;
+    after: CommissionRuleScope;
+} | {
+    field: 'condition';
+    before: CommissionRuleCondition | null;
+    after: CommissionRuleCondition | null;
+} | {
+    field: 'effectiveFrom';
+    before: string;
+    after: string;
+} | {
+    field: 'effectiveTo';
+    before: string | null;
+    after: string | null;
+} | {
+    field: 'priority';
+    before: number;
+    after: number;
+} | {
+    field: 'replacesOthers';
+    before: boolean;
+    after: boolean;
+} | {
+    field: 'countBy';
+    before: CommissionCountByEnum;
+    after: CommissionCountByEnum;
+} | {
+    field: 'payTiming';
+    before: CommissionPayTimingEnum;
+    after: CommissionPayTimingEnum;
+} | {
+    field: 'onSaleAdvanceBps';
+    before: number | null;
+    after: number | null;
+};
 /** Un evento del historial de una regla. */
 export interface CommissionRuleEvent {
     at: string;
     action: string;
     performedBy: string;
     version: number | null;
+    /**
+     * Solo en ediciones: lo que cambió respecto a la versión anterior; vacío si no cambió ningún campo.
+     * Ausente si no hay versión anterior con qué comparar, y en motores anteriores.
+     */
+    changes?: CommissionRuleChange[];
+    /** Junto a `changes`: si la versión editada cuenta piezas o ventas, para leer sus palancas y su condición. */
+    countBy?: CommissionCountByEnum;
+    /** El estado que tenía la regla y el que le dejó el evento; `null` si no lo cambió o no se sabe. Ausente en motores anteriores. */
+    statusChange?: {
+        from: CommissionRuleStatusEnum;
+        to: CommissionRuleStatusEnum;
+    } | null;
 }
 /** `GET /backoffice/commissions/rules/{ruleId}/history` — del más nuevo al más viejo. */
 export interface RuleHistoryResponse {

package/bin/retailWizard/dtos/SalePayment.d.ts

@@ -1,5 +1,8 @@
 import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
-/** Un pago del cobro. El comprobante es opcional: si viene se valida y solo en su medio; si no, `null` o ausente. */
+/**
+ * Un pago del cobro tal como llega en un request: solo la forma. Tope, uso único, suma, monto
+ * positivo y formato del comprobante los valida el dominio con su code.
+ */
 export declare class SalePayment {
     method: SalePaymentMethodEnum;
     amountCents: number;

package/bin/retailWizard/dtos/SalePayment.js

@@ -12,12 +12,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SalePayment = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const retailIntegrationLimits_1 = require("../../retailIntegration/constants/retailIntegrationLimits");
 const SalePaymentMethodEnum_1 = require("../enums/SalePaymentMethodEnum");
-const OnlyForPaymentMethodConstraint_1 = require("../validators/OnlyForPaymentMethodConstraint");
-const { CASH, CARD, WIRE } = SalePaymentMethodEnum_1.SalePaymentMethodEnum;
 const hasValue = (field) => (o) => o[field] != null;
-/** Un pago del cobro. El comprobante es opcional: si viene se valida y solo en su medio; si no, `null` o ausente. */
+/**
+ * Un pago del cobro tal como llega en un request: solo la forma. Tope, uso único, suma, monto
+ * positivo y formato del comprobante los valida el dominio con su code.
+ */
 class SalePayment {
 }
 exports.SalePayment = SalePayment;
@@ -29,41 +29,35 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsInt)(),
-    (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], SalePayment.prototype, "amountCents", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)(hasValue('cashConfirmedInRegister')),
     (0, class_validator_1.IsBoolean)(),
-    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [CASH]),
     __metadata("design:type", Boolean)
 ], SalePayment.prototype, "cashConfirmedInRegister", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)(hasValue('cardLast4')),
-    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_CARD_LAST4_PATTERN),
-    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [CARD]),
+    (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SalePayment.prototype, "cardLast4", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)(hasValue('authCode')),
-    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SALE_ID_TEXT_PATTERN),
-    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [CARD]),
+    (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SalePayment.prototype, "authCode", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)(hasValue('speiTrackingKey')),
-    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SPEI_TRACKING_KEY_PATTERN),
-    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [WIRE]),
+    (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SalePayment.prototype, "speiTrackingKey", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)(hasValue('senderClabe')),
-    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_CLABE_PATTERN),
-    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [WIRE]),
+    (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SalePayment.prototype, "senderClabe", void 0);

package/bin/retailWizard/dtos/StoredSalePayment.d.ts

@@ -0,0 +1,13 @@
+import { SalePayment } from './SalePayment';
+/**
+ * Pago ya registrado (cobro de la sesión): monto positivo y comprobante con formato, solo en su medio.
+ * Repite las reglas de forma porque class-validator descarta las del padre en la propiedad que se redeclara.
+ */
+export declare class StoredSalePayment extends SalePayment {
+    amountCents: number;
+    cashConfirmedInRegister?: boolean | null;
+    cardLast4?: string | null;
+    authCode?: string | null;
+    speiTrackingKey?: string | null;
+    senderClabe?: string | null;
+}

package/bin/retailWizard/dtos/StoredSalePayment.js

@@ -0,0 +1,59 @@
+"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.StoredSalePayment = void 0;
+const class_validator_1 = require("class-validator");
+const retailIntegrationLimits_1 = require("../../retailIntegration/constants/retailIntegrationLimits");
+const SalePaymentMethodEnum_1 = require("../enums/SalePaymentMethodEnum");
+const OnlyForPaymentMethodConstraint_1 = require("../validators/OnlyForPaymentMethodConstraint");
+const SalePayment_1 = require("./SalePayment");
+const { CASH, CARD, WIRE } = SalePaymentMethodEnum_1.SalePaymentMethodEnum;
+/**
+ * Pago ya registrado (cobro de la sesión): monto positivo y comprobante con formato, solo en su medio.
+ * Repite las reglas de forma porque class-validator descarta las del padre en la propiedad que se redeclara.
+ */
+class StoredSalePayment extends SalePayment_1.SalePayment {
+}
+exports.StoredSalePayment = StoredSalePayment;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], StoredSalePayment.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [CASH]),
+    __metadata("design:type", Boolean)
+], StoredSalePayment.prototype, "cashConfirmedInRegister", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_CARD_LAST4_PATTERN),
+    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [CARD]),
+    __metadata("design:type", String)
+], StoredSalePayment.prototype, "cardLast4", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SALE_ID_TEXT_PATTERN),
+    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [CARD]),
+    __metadata("design:type", String)
+], StoredSalePayment.prototype, "authCode", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SPEI_TRACKING_KEY_PATTERN),
+    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [WIRE]),
+    __metadata("design:type", String)
+], StoredSalePayment.prototype, "speiTrackingKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_CLABE_PATTERN),
+    (0, class_validator_1.Validate)(OnlyForPaymentMethodConstraint_1.OnlyForPaymentMethodConstraint, [WIRE]),
+    __metadata("design:type", String)
+], StoredSalePayment.prototype, "senderClabe", void 0);

package/bin/retailWizard/dtos/requests/CreateAccessorySaleRequest.d.ts

@@ -13,6 +13,6 @@ export declare class CreateAccessorySaleRequest {
     amountCents: number;
     /** @deprecated Usa el comprobante de cada elemento de `payments`. */
     paymentDetail?: SalePaymentDetail;
-    /** Pagos del cobro (1 a 3); si viene, manda sobre `paymentMethod` y `paymentDetail`. */
+    /** Pagos del cobro; si viene, manda sobre `paymentMethod` y `paymentDetail`. */
     payments?: SalePayment[];
 }

package/bin/retailWizard/dtos/requests/CreateAccessorySaleRequest.js

@@ -15,7 +15,7 @@ const class_validator_1 = require("class-validator");
 const SalePaymentMethodEnum_1 = require("../../enums/SalePaymentMethodEnum");
 const SalePaymentDetail_1 = require("../SalePaymentDetail");
 const AccessorySaleLine_1 = require("../AccessorySaleLine");
-const IsSalePaymentList_1 = require("../../validators/IsSalePaymentList");
+const IsSalePaymentInputList_1 = require("../../validators/IsSalePaymentInputList");
 /**
  * POST /wizard/accessory-sales — cierra la venta de mostrador, sin cliente.
  * `amountCents` es lo cobrado en caja: iguala la suma del catálogo y la de `payments`.
@@ -54,6 +54,6 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, IsSalePaymentList_1.IsSalePaymentList)(),
+    (0, IsSalePaymentInputList_1.IsSalePaymentInputList)(),
     __metadata("design:type", Array)
 ], CreateAccessorySaleRequest.prototype, "payments", void 0);

package/bin/retailWizard/dtos/requests/DownPaymentRequest.d.ts

@@ -16,6 +16,6 @@ export declare class DownPaymentRequest {
     amountCents: number;
     /** @deprecated Usa el comprobante de cada elemento de `payments`. */
     detail?: SalePaymentDetail;
-    /** Pagos del cobro (1 a 3); si viene, manda sobre `method` y `detail`. */
+    /** Pagos del cobro; si viene, manda sobre `method` y `detail`. */
     payments?: SalePayment[];
 }

package/bin/retailWizard/dtos/requests/DownPaymentRequest.js

@@ -14,7 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const SalePaymentMethodEnum_1 = require("../../enums/SalePaymentMethodEnum");
 const SalePaymentDetail_1 = require("../SalePaymentDetail");
-const IsSalePaymentList_1 = require("../../validators/IsSalePaymentList");
+const IsSalePaymentInputList_1 = require("../../validators/IsSalePaymentInputList");
 /**
  * POST /wizard/sessions/:id/down-payment — cobro del ENGANCHE de la venta a crédito (paso 07,
  * pista SOFOM). Endpoint propio, separado del cobro de contado (`/payment`): acá la regla dura es
@@ -49,6 +49,6 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, IsSalePaymentList_1.IsSalePaymentList)(),
+    (0, IsSalePaymentInputList_1.IsSalePaymentInputList)(),
     __metadata("design:type", Array)
 ], DownPaymentRequest.prototype, "payments", void 0);

package/bin/retailWizard/dtos/requests/RegisterPaymentRequest.d.ts

@@ -12,6 +12,6 @@ export declare class RegisterPaymentRequest {
     amountCents: number;
     /** @deprecated Usa el comprobante de cada elemento de `payments`. */
     detail?: SalePaymentDetail;
-    /** Pagos del cobro (1 a 3); si viene, manda sobre `method` y `detail`. */
+    /** Pagos del cobro; si viene, manda sobre `method` y `detail`. */
     payments?: SalePayment[];
 }

package/bin/retailWizard/dtos/requests/RegisterPaymentRequest.js

@@ -14,7 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const SalePaymentMethodEnum_1 = require("../../enums/SalePaymentMethodEnum");
 const SalePaymentDetail_1 = require("../SalePaymentDetail");
-const IsSalePaymentList_1 = require("../../validators/IsSalePaymentList");
+const IsSalePaymentInputList_1 = require("../../validators/IsSalePaymentInputList");
 /**
  * POST /wizard/sessions/:id/payment — registra el cobro de contado (idempotente por sesión). Regla
  * dura: `amountCents == cashPrice` de la reserva. `POST /payment/folio` genera el folio server-side
@@ -45,6 +45,6 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, IsSalePaymentList_1.IsSalePaymentList)(),
+    (0, IsSalePaymentInputList_1.IsSalePaymentInputList)(),
     __metadata("design:type", Array)
 ], RegisterPaymentRequest.prototype, "payments", void 0);

package/bin/retailWizard/index.d.ts

@@ -41,6 +41,8 @@ export * from './dtos/WizardWelcome';
 export * from './dtos/WizardCreditPromotionBonus';
 export * from './dtos/SalePaymentDetail';
 export * from './dtos/SalePayment';
+export * from './dtos/StoredSalePayment';
+export * from './validators/IsSalePaymentInputList';
 export * from './validators/IsSalePaymentList';
 export * from './validators/OnlyForPaymentMethodConstraint';
 export * from './validators/PaymentsHaveSingleUseMethodsConstraint';

package/bin/retailWizard/index.js

@@ -61,6 +61,8 @@ __exportStar(require("./dtos/WizardWelcome"), exports);
 __exportStar(require("./dtos/WizardCreditPromotionBonus"), exports);
 __exportStar(require("./dtos/SalePaymentDetail"), exports);
 __exportStar(require("./dtos/SalePayment"), exports);
+__exportStar(require("./dtos/StoredSalePayment"), exports);
+__exportStar(require("./validators/IsSalePaymentInputList"), exports);
 __exportStar(require("./validators/IsSalePaymentList"), exports);
 __exportStar(require("./validators/OnlyForPaymentMethodConstraint"), exports);
 __exportStar(require("./validators/PaymentsHaveSingleUseMethodsConstraint"), exports);

package/bin/retailWizard/validators/IsSalePaymentInputList.d.ts

@@ -0,0 +1,2 @@
+/** Forma de `payments` en un request: arreglo de pagos bien tipados. Las reglas de negocio las valida el dominio. */
+export declare function IsSalePaymentInputList(): PropertyDecorator;

package/bin/retailWizard/validators/IsSalePaymentInputList.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsSalePaymentInputList = IsSalePaymentInputList;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SalePayment_1 = require("../dtos/SalePayment");
+/** Forma de `payments` en un request: arreglo de pagos bien tipados. Las reglas de negocio las valida el dominio. */
+function IsSalePaymentInputList() {
+    const decorators = [(0, class_validator_1.IsArray)(), (0, class_validator_1.ValidateNested)({ each: true }), (0, class_transformer_1.Type)(() => SalePayment_1.SalePayment)];
+    return (target, propertyKey) => decorators.forEach((decorate) => decorate(target, propertyKey));
+}

package/bin/retailWizard/validators/IsSalePaymentList.d.ts

@@ -1,2 +1,2 @@
-/** Reglas de `payments`: 1 a 3 pagos válidos, efectivo y SPEI una vez, y la suma igual a `amountCents`. */
+/** Reglas de `payments` ya registrados (cobro de la sesión): 1 a 3 pagos válidos, efectivo y SPEI una vez, y la suma igual a `amountCents`. */
 export declare function IsSalePaymentList(): PropertyDecorator;

package/bin/retailWizard/validators/IsSalePaymentList.js

@@ -4,17 +4,17 @@ exports.IsSalePaymentList = IsSalePaymentList;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const retailWizardValidation_1 = require("../constants/retailWizardValidation");
-const SalePayment_1 = require("../dtos/SalePayment");
+const StoredSalePayment_1 = require("../dtos/StoredSalePayment");
 const PaymentsHaveSingleUseMethodsConstraint_1 = require("./PaymentsHaveSingleUseMethodsConstraint");
 const PaymentsMatchAmountCentsConstraint_1 = require("./PaymentsMatchAmountCentsConstraint");
-/** Reglas de `payments`: 1 a 3 pagos válidos, efectivo y SPEI una vez, y la suma igual a `amountCents`. */
+/** Reglas de `payments` ya registrados (cobro de la sesión): 1 a 3 pagos válidos, efectivo y SPEI una vez, y la suma igual a `amountCents`. */
 function IsSalePaymentList() {
     const decorators = [
         (0, class_validator_1.IsArray)(),
         (0, class_validator_1.ArrayMinSize)(1),
         (0, class_validator_1.ArrayMaxSize)(retailWizardValidation_1.MAX_SALE_PAYMENTS),
         (0, class_validator_1.ValidateNested)({ each: true }),
-        (0, class_transformer_1.Type)(() => SalePayment_1.SalePayment),
+        (0, class_transformer_1.Type)(() => StoredSalePayment_1.StoredSalePayment),
         (0, class_validator_1.Validate)(PaymentsHaveSingleUseMethodsConstraint_1.PaymentsHaveSingleUseMethodsConstraint),
         (0, class_validator_1.Validate)(PaymentsMatchAmountCentsConstraint_1.PaymentsMatchAmountCentsConstraint),
     ];

package/package.json

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

package/src/emailVerification/dtos/internal/EmailOwnersByEmailRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsEmail } from 'class-validator';
+
+/**
+ * Request interno (api-invoker) para buscar qué directorios tienen un correo.
+ */
+export class EmailOwnersByEmailRequest {
+    @Expose()
+    @IsEmail()
+    email!: string;
+}

package/src/emailVerification/index.ts

@@ -24,3 +24,4 @@ export * from './dtos/internal/EmailsByDirectoryRequest';
 export * from './dtos/internal/EmailsByDirectoryResponse';
 export * from './dtos/internal/EmailStartByDirectoryRequest';
 export * from './dtos/internal/EmailStartByDirectoryResponse';
+export * from './dtos/internal/EmailOwnersByEmailRequest';

package/src/retailCommission/dtos/CommissionApi.ts

@@ -1,4 +1,5 @@
 import type { CommissionPlanStatusEnum } from '../enums/CommissionPlanStatusEnum';
+import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
 import type { CommissionPayoutStatusEnum } from '../enums/CommissionPayoutStatusEnum';
 import type {
     CommissionAddOn,
@@ -295,12 +296,36 @@ export interface RuleActionResponse {
     snapshotId: string;
 }
 
+/** Un campo de la regla que cambió de una versión a la siguiente, con su valor antes y después. */
+export type CommissionRuleChange =
+    | { field: 'name'; before: string; after: string }
+    | { field: 'description'; before: string | null; after: string | null }
+    | { field: 'levers'; before: CommissionRuleLevers; after: CommissionRuleLevers }
+    | { field: 'scope'; before: CommissionRuleScope; after: CommissionRuleScope }
+    | { field: 'condition'; before: CommissionRuleCondition | null; after: CommissionRuleCondition | null }
+    | { field: 'effectiveFrom'; before: string; after: string }
+    | { field: 'effectiveTo'; before: string | null; after: string | null }
+    | { field: 'priority'; before: number; after: number }
+    | { field: 'replacesOthers'; before: boolean; after: boolean }
+    | { field: 'countBy'; before: CommissionCountByEnum; after: CommissionCountByEnum }
+    | { field: 'payTiming'; before: CommissionPayTimingEnum; after: CommissionPayTimingEnum }
+    | { field: 'onSaleAdvanceBps'; before: number | null; after: number | null };
+
 /** Un evento del historial de una regla. */
 export interface CommissionRuleEvent {
     at: string;
     action: string;
     performedBy: string;
     version: number | null;
+    /**
+     * Solo en ediciones: lo que cambió respecto a la versión anterior; vacío si no cambió ningún campo.
+     * Ausente si no hay versión anterior con qué comparar, y en motores anteriores.
+     */
+    changes?: CommissionRuleChange[];
+    /** Junto a `changes`: si la versión editada cuenta piezas o ventas, para leer sus palancas y su condición. */
+    countBy?: CommissionCountByEnum;
+    /** El estado que tenía la regla y el que le dejó el evento; `null` si no lo cambió o no se sabe. Ausente en motores anteriores. */
+    statusChange?: { from: CommissionRuleStatusEnum; to: CommissionRuleStatusEnum } | null;
 }
 
 /** `GET /backoffice/commissions/rules/{ruleId}/history` — del más nuevo al más viejo. */

package/src/retailWizard/dtos/SalePayment.ts

@@ -1,18 +1,13 @@
 import { Expose } from 'class-transformer';
-import { IsBoolean, IsEnum, IsInt, Matches, Min, Validate, ValidateIf } from 'class-validator';
-import {
-    RETAIL_CARD_LAST4_PATTERN,
-    RETAIL_CLABE_PATTERN,
-    RETAIL_SALE_ID_TEXT_PATTERN,
-    RETAIL_SPEI_TRACKING_KEY_PATTERN,
-} from '../../retailIntegration/constants/retailIntegrationLimits';
+import { IsBoolean, IsEnum, IsInt, IsString, ValidateIf } from 'class-validator';
 import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
-import { OnlyForPaymentMethodConstraint } from '../validators/OnlyForPaymentMethodConstraint';
 
-const { CASH, CARD, WIRE } = SalePaymentMethodEnum;
 const hasValue = (field: keyof SalePayment) => (o: SalePayment) => o[field] != null;
 
-/** Un pago del cobro. El comprobante es opcional: si viene se valida y solo en su medio; si no, `null` o ausente. */
+/**
+ * Un pago del cobro tal como llega en un request: solo la forma. Tope, uso único, suma, monto
+ * positivo y formato del comprobante los valida el dominio con su code.
+ */
 export class SalePayment {
     @Expose()
     @IsEnum(SalePaymentMethodEnum)
@@ -20,36 +15,30 @@ export class SalePayment {
 
     @Expose()
     @IsInt()
-    @Min(1)
     amountCents!: number;
 
     @Expose()
     @ValidateIf(hasValue('cashConfirmedInRegister'))
     @IsBoolean()
-    @Validate(OnlyForPaymentMethodConstraint, [CASH])
     cashConfirmedInRegister?: boolean | null;
 
     @Expose()
     @ValidateIf(hasValue('cardLast4'))
-    @Matches(RETAIL_CARD_LAST4_PATTERN)
-    @Validate(OnlyForPaymentMethodConstraint, [CARD])
+    @IsString()
     cardLast4?: string | null;
 
     @Expose()
     @ValidateIf(hasValue('authCode'))
-    @Matches(RETAIL_SALE_ID_TEXT_PATTERN)
-    @Validate(OnlyForPaymentMethodConstraint, [CARD])
+    @IsString()
     authCode?: string | null;
 
     @Expose()
     @ValidateIf(hasValue('speiTrackingKey'))
-    @Matches(RETAIL_SPEI_TRACKING_KEY_PATTERN)
-    @Validate(OnlyForPaymentMethodConstraint, [WIRE])
+    @IsString()
     speiTrackingKey?: string | null;
 
     @Expose()
     @ValidateIf(hasValue('senderClabe'))
-    @Matches(RETAIL_CLABE_PATTERN)
-    @Validate(OnlyForPaymentMethodConstraint, [WIRE])
+    @IsString()
     senderClabe?: string | null;
 }

package/src/retailWizard/dtos/StoredSalePayment.ts

@@ -0,0 +1,46 @@
+import { IsBoolean, IsInt, IsString, Min, Matches, Validate } from 'class-validator';
+import {
+    RETAIL_CARD_LAST4_PATTERN,
+    RETAIL_CLABE_PATTERN,
+    RETAIL_SALE_ID_TEXT_PATTERN,
+    RETAIL_SPEI_TRACKING_KEY_PATTERN,
+} from '../../retailIntegration/constants/retailIntegrationLimits';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+import { OnlyForPaymentMethodConstraint } from '../validators/OnlyForPaymentMethodConstraint';
+import { SalePayment } from './SalePayment';
+
+const { CASH, CARD, WIRE } = SalePaymentMethodEnum;
+
+/**
+ * Pago ya registrado (cobro de la sesión): monto positivo y comprobante con formato, solo en su medio.
+ * Repite las reglas de forma porque class-validator descarta las del padre en la propiedad que se redeclara.
+ */
+export class StoredSalePayment extends SalePayment {
+    @IsInt()
+    @Min(1)
+    declare amountCents: number;
+
+    @IsBoolean()
+    @Validate(OnlyForPaymentMethodConstraint, [CASH])
+    declare cashConfirmedInRegister?: boolean | null;
+
+    @IsString()
+    @Matches(RETAIL_CARD_LAST4_PATTERN)
+    @Validate(OnlyForPaymentMethodConstraint, [CARD])
+    declare cardLast4?: string | null;
+
+    @IsString()
+    @Matches(RETAIL_SALE_ID_TEXT_PATTERN)
+    @Validate(OnlyForPaymentMethodConstraint, [CARD])
+    declare authCode?: string | null;
+
+    @IsString()
+    @Matches(RETAIL_SPEI_TRACKING_KEY_PATTERN)
+    @Validate(OnlyForPaymentMethodConstraint, [WIRE])
+    declare speiTrackingKey?: string | null;
+
+    @IsString()
+    @Matches(RETAIL_CLABE_PATTERN)
+    @Validate(OnlyForPaymentMethodConstraint, [WIRE])
+    declare senderClabe?: string | null;
+}

package/src/retailWizard/dtos/requests/CreateAccessorySaleRequest.ts

@@ -14,7 +14,7 @@ import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
 import { SalePaymentDetail } from '../SalePaymentDetail';
 import { AccessorySaleLine } from '../AccessorySaleLine';
 import { SalePayment } from '../SalePayment';
-import { IsSalePaymentList } from '../../validators/IsSalePaymentList';
+import { IsSalePaymentInputList } from '../../validators/IsSalePaymentInputList';
 
 /**
  * POST /wizard/accessory-sales — cierra la venta de mostrador, sin cliente.
@@ -47,9 +47,9 @@ export class CreateAccessorySaleRequest {
   @Type(() => SalePaymentDetail)
   paymentDetail?: SalePaymentDetail;
 
-  /** Pagos del cobro (1 a 3); si viene, manda sobre `paymentMethod` y `paymentDetail`. */
+  /** Pagos del cobro; si viene, manda sobre `paymentMethod` y `paymentDetail`. */
   @Expose()
   @IsOptional()
-  @IsSalePaymentList()
+  @IsSalePaymentInputList()
   payments?: SalePayment[];
 }

package/src/retailWizard/dtos/requests/DownPaymentRequest.ts

@@ -3,7 +3,7 @@ import { IsEnum, IsInt, IsOptional, Min, ValidateIf, ValidateNested } from 'clas
 import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
 import { SalePaymentDetail } from '../SalePaymentDetail';
 import { SalePayment } from '../SalePayment';
-import { IsSalePaymentList } from '../../validators/IsSalePaymentList';
+import { IsSalePaymentInputList } from '../../validators/IsSalePaymentInputList';
 
 /**
  * POST /wizard/sessions/:id/down-payment — cobro del ENGANCHE de la venta a crédito (paso 07,
@@ -33,9 +33,9 @@ export class DownPaymentRequest {
     @ValidateNested()
     detail?: SalePaymentDetail;
 
-    /** Pagos del cobro (1 a 3); si viene, manda sobre `method` y `detail`. */
+    /** Pagos del cobro; si viene, manda sobre `method` y `detail`. */
     @Expose()
     @IsOptional()
-    @IsSalePaymentList()
+    @IsSalePaymentInputList()
     payments?: SalePayment[];
 }

package/src/retailWizard/dtos/requests/RegisterPaymentRequest.ts

@@ -3,7 +3,7 @@ import { IsEnum, IsInt, IsOptional, ValidateIf, ValidateNested, Min } from 'clas
 import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
 import { SalePaymentDetail } from '../SalePaymentDetail';
 import { SalePayment } from '../SalePayment';
-import { IsSalePaymentList } from '../../validators/IsSalePaymentList';
+import { IsSalePaymentInputList } from '../../validators/IsSalePaymentInputList';
 
 /**
  * POST /wizard/sessions/:id/payment — registra el cobro de contado (idempotente por sesión). Regla
@@ -29,9 +29,9 @@ export class RegisterPaymentRequest {
   @ValidateNested()
   detail?: SalePaymentDetail;
 
-  /** Pagos del cobro (1 a 3); si viene, manda sobre `method` y `detail`. */
+  /** Pagos del cobro; si viene, manda sobre `method` y `detail`. */
   @Expose()
   @IsOptional()
-  @IsSalePaymentList()
+  @IsSalePaymentInputList()
   payments?: SalePayment[];
 }

package/src/retailWizard/index.ts

@@ -46,6 +46,8 @@ export * from './dtos/WizardWelcome';
 export * from './dtos/WizardCreditPromotionBonus';
 export * from './dtos/SalePaymentDetail';
 export * from './dtos/SalePayment';
+export * from './dtos/StoredSalePayment';
+export * from './validators/IsSalePaymentInputList';
 export * from './validators/IsSalePaymentList';
 export * from './validators/OnlyForPaymentMethodConstraint';
 export * from './validators/PaymentsHaveSingleUseMethodsConstraint';

package/src/retailWizard/validators/IsSalePaymentInputList.ts

@@ -0,0 +1,9 @@
+import { Type } from 'class-transformer';
+import { IsArray, ValidateNested } from 'class-validator';
+import { SalePayment } from '../dtos/SalePayment';
+
+/** Forma de `payments` en un request: arreglo de pagos bien tipados. Las reglas de negocio las valida el dominio. */
+export function IsSalePaymentInputList(): PropertyDecorator {
+    const decorators: PropertyDecorator[] = [IsArray(), ValidateNested({ each: true }), Type(() => SalePayment)];
+    return (target, propertyKey) => decorators.forEach((decorate) => decorate(target, propertyKey));
+}

package/src/retailWizard/validators/IsSalePaymentList.ts

@@ -1,18 +1,18 @@
 import { Type } from 'class-transformer';
 import { ArrayMaxSize, ArrayMinSize, IsArray, Validate, ValidateNested } from 'class-validator';
 import { MAX_SALE_PAYMENTS } from '../constants/retailWizardValidation';
-import { SalePayment } from '../dtos/SalePayment';
+import { StoredSalePayment } from '../dtos/StoredSalePayment';
 import { PaymentsHaveSingleUseMethodsConstraint } from './PaymentsHaveSingleUseMethodsConstraint';
 import { PaymentsMatchAmountCentsConstraint } from './PaymentsMatchAmountCentsConstraint';
 
-/** Reglas de `payments`: 1 a 3 pagos válidos, efectivo y SPEI una vez, y la suma igual a `amountCents`. */
+/** Reglas de `payments` ya registrados (cobro de la sesión): 1 a 3 pagos válidos, efectivo y SPEI una vez, y la suma igual a `amountCents`. */
 export function IsSalePaymentList(): PropertyDecorator {
     const decorators: PropertyDecorator[] = [
         IsArray(),
         ArrayMinSize(1),
         ArrayMaxSize(MAX_SALE_PAYMENTS),
         ValidateNested({ each: true }),
-        Type(() => SalePayment),
+        Type(() => StoredSalePayment),
         Validate(PaymentsHaveSingleUseMethodsConstraint),
         Validate(PaymentsMatchAmountCentsConstraint),
     ];