@fiado/type-kit 3.631.0 → 3.633.0

package/src/retailWizard/events/RetailPromotionInboundMessage.ts

@@ -174,11 +174,17 @@ export class RetailPromotionInboundMessage {
     @IsEnum(SaleTypeEnum)
     saleType?: SaleTypeEnum;
 
-    /** Medio de cobro, solo en contado. */
+    /** @deprecated Usa `paymentMethods`. Medio de cobro, solo en contado. */
     @IsOptional()
     @IsEnum(SalePaymentMethodEnum)
     paymentMethod?: SalePaymentMethodEnum | null;
 
+    /** Medios con que se cobró, uno por pago; solo en contado. */
+    @IsOptional()
+    @IsArray()
+    @IsEnum(SalePaymentMethodEnum, { each: true })
+    paymentMethods?: SalePaymentMethodEnum[] | null;
+
     /** Financiera externa, solo en `EXTERNAL_REFERRAL`. */
     @IsOptional()
     @IsEnum(ExternalProviderEnum)

package/src/retailWizard/index.ts

@@ -45,6 +45,11 @@ export * from './dtos/WizardProduct';
 export * from './dtos/WizardWelcome';
 export * from './dtos/WizardCreditPromotionBonus';
 export * from './dtos/SalePaymentDetail';
+export * from './dtos/SalePayment';
+export * from './validators/IsSalePaymentList';
+export * from './validators/OnlyForPaymentMethodConstraint';
+export * from './validators/PaymentsHaveSingleUseMethodsConstraint';
+export * from './validators/PaymentsMatchAmountCentsConstraint';
 export * from './dtos/ProspectNewCustomer';
 export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';

package/src/retailWizard/validators/IsSalePaymentList.ts

@@ -0,0 +1,20 @@
+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 { 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`. */
+export function IsSalePaymentList(): PropertyDecorator {
+    const decorators: PropertyDecorator[] = [
+        IsArray(),
+        ArrayMinSize(1),
+        ArrayMaxSize(MAX_SALE_PAYMENTS),
+        ValidateNested({ each: true }),
+        Type(() => SalePayment),
+        Validate(PaymentsHaveSingleUseMethodsConstraint),
+        Validate(PaymentsMatchAmountCentsConstraint),
+    ];
+    return (target, propertyKey) => decorators.forEach((decorate) => decorate(target, propertyKey));
+}

package/src/retailWizard/validators/OnlyForPaymentMethodConstraint.ts

@@ -0,0 +1,18 @@
+import {
+    ValidatorConstraint,
+    type ValidationArguments,
+    type ValidatorConstraintInterface,
+} from 'class-validator';
+
+/** Un campo de comprobante con valor solo se acepta en el medio de pago al que pertenece. */
+@ValidatorConstraint({ name: 'onlyForPaymentMethod', async: false })
+export class OnlyForPaymentMethodConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        if (value == null) return true;
+        return (args.object as { method?: unknown }).method === args.constraints[0];
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} solo aplica a pagos ${args.constraints[0]}`;
+    }
+}

package/src/retailWizard/validators/PaymentsHaveSingleUseMethodsConstraint.ts

@@ -0,0 +1,20 @@
+import {
+    ValidatorConstraint,
+    type ValidationArguments,
+    type ValidatorConstraintInterface,
+} from 'class-validator';
+import { SINGLE_USE_PAYMENT_METHODS } from '../constants/retailWizardValidation';
+
+/** Efectivo y SPEI aparecen a lo más una vez en `payments`; la tarjeta se puede repetir. */
+@ValidatorConstraint({ name: 'paymentsHaveSingleUseMethods', async: false })
+export class PaymentsHaveSingleUseMethodsConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        if (!Array.isArray(value)) return true;
+        const methods = value.map((p) => (p as { method?: unknown } | null)?.method);
+        return SINGLE_USE_PAYMENT_METHODS.every((m) => methods.filter((x) => x === m).length <= 1);
+    }
+
+    defaultMessage(): string {
+        return `payments admite a lo más un pago de cada medio ${SINGLE_USE_PAYMENT_METHODS.join(' y ')}`;
+    }
+}

package/src/retailWizard/validators/PaymentsMatchAmountCentsConstraint.ts

@@ -0,0 +1,21 @@
+import {
+    ValidatorConstraint,
+    type ValidationArguments,
+    type ValidatorConstraintInterface,
+} from 'class-validator';
+
+/** La suma de `payments[].amountCents` es el `amountCents` del cobro. */
+@ValidatorConstraint({ name: 'paymentsMatchAmountCents', async: false })
+export class PaymentsMatchAmountCentsConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        const total = (args.object as { amountCents?: unknown }).amountCents;
+        if (!Array.isArray(value) || !Number.isInteger(total)) return true;
+        const amounts = value.map((p) => (p as { amountCents?: unknown } | null)?.amountCents);
+        if (!amounts.every((a) => Number.isInteger(a))) return true;
+        return (amounts as number[]).reduce((sum, a) => sum + a, 0) === total;
+    }
+
+    defaultMessage(): string {
+        return 'la suma de payments[].amountCents debe ser amountCents';
+    }
+}