@fiado/type-kit 3.634.0 → 3.635.0

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

@@ -105,6 +105,35 @@ describe('payments en RegisterPaymentRequest', () => {
   });
 });
 
+describe('cobro de $0', () => {
+  it.each([
+    ['RegisterPaymentRequest', RegisterPaymentRequest],
+    ['DownPaymentRequest', DownPaymentRequest],
+  ])('%s de $0 no exige method ni payments', (_name, cls) => {
+    expect(errorsOf(cls as new () => object, { amountCents: 0 })).toEqual([]);
+  });
+
+  it.each([
+    ['RegisterPaymentRequest', RegisterPaymentRequest],
+    ['DownPaymentRequest', DownPaymentRequest],
+  ])('%s de $0 con method lo sigue validando', (_name, cls) => {
+    expect(errorsOf(cls as new () => object, { amountCents: 0, method: CASH })).toEqual([]);
+    expect(errorsOf(cls as new () => object, { amountCents: 0, method: 'CHEQUE' })).toEqual(['method']);
+  });
+
+  it.each([
+    ['RegisterPaymentRequest', RegisterPaymentRequest],
+    ['DownPaymentRequest', DownPaymentRequest],
+  ])('%s con monto mayor a cero sin payments sigue exigiendo method', (_name, cls) => {
+    expect(errorsOf(cls as new () => object, { amountCents: 100 })).toEqual(['method']);
+  });
+
+  it('WizardPayment de $0 guarda method y payments en null', () => {
+    expect(errorsOf(WizardPayment, { method: null, amountCents: 0, payments: null, paidAt: '2026-11-03T10:00:00.000Z' })).toEqual([]);
+    expect(errorsOf(WizardPayment, { method: 'CHEQUE', amountCents: 0, paidAt: '2026-11-03T10:00:00.000Z' })).toEqual(['method']);
+  });
+});
+
 describe('payments en los demás contratos', () => {
   it('DownPaymentRequest acepta solo payments y valida la suma', () => {
     expect(errorsOf(DownPaymentRequest, { amountCents: 15000, payments: [cash, wire] })).toEqual([]);

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

@@ -2,12 +2,12 @@ import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
 import { SalePayment } from './SalePayment';
 /** Registro del pago de contado dentro de la sesión (`WizardSession.payment`). SureKeep Fase 2 — pista Retail. */
 export declare class WizardPayment {
-    /** @deprecated Usa `payments`; con varios pagos lleva el método del primero. */
-    method: SalePaymentMethodEnum;
+    /** @deprecated Usa `payments`; con varios pagos lleva el método del primero. `null` en un cobro de $0. */
+    method: SalePaymentMethodEnum | null;
     amountCents: number;
     /** @deprecated Usa `payments`; es el comprobante como texto JSON. */
     detail?: string;
-    /** Pagos del cobro (1 a 3); ausente en sesiones anteriores al campo. */
-    payments?: SalePayment[];
+    /** Pagos del cobro (1 a 3); `null` en un cobro de $0, ausente en sesiones anteriores al campo. */
+    payments?: SalePayment[] | null;
     paidAt: string;
 }

package/bin/retailWizard/dtos/WizardPayment.js

@@ -21,6 +21,7 @@ class WizardPayment {
 exports.WizardPayment = WizardPayment;
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.method != null),
     (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
     __metadata("design:type", String)
 ], WizardPayment.prototype, "method", void 0);

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

@@ -11,7 +11,7 @@ import { SalePayment } from '../SalePayment';
  * SureKeep Fase 2 — pista SOFOM.
  */
 export declare class DownPaymentRequest {
-    /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene. */
+    /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene y el monto es mayor a cero. */
     method?: SalePaymentMethodEnum;
     amountCents: number;
     /** @deprecated Usa el comprobante de cada elemento de `payments`. */

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

@@ -29,7 +29,7 @@ class DownPaymentRequest {
 exports.DownPaymentRequest = DownPaymentRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.ValidateIf)((o) => o.payments == null || o.method !== undefined),
+    (0, class_validator_1.ValidateIf)((o) => o.method !== undefined || (o.payments == null && o.amountCents !== 0)),
     (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
     __metadata("design:type", String)
 ], DownPaymentRequest.prototype, "method", void 0);

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

@@ -7,7 +7,7 @@ import { SalePayment } from '../SalePayment';
  * (D11) ANTES del registro; el folio no viaja en el body (lo posee el server). SureKeep Fase 2 — pista Retail.
  */
 export declare class RegisterPaymentRequest {
-    /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene. */
+    /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene y el monto es mayor a cero. */
     method?: SalePaymentMethodEnum;
     amountCents: number;
     /** @deprecated Usa el comprobante de cada elemento de `payments`. */

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

@@ -25,7 +25,7 @@ class RegisterPaymentRequest {
 exports.RegisterPaymentRequest = RegisterPaymentRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.ValidateIf)((o) => o.payments == null || o.method !== undefined),
+    (0, class_validator_1.ValidateIf)((o) => o.method !== undefined || (o.payments == null && o.amountCents !== 0)),
     (0, class_validator_1.IsEnum)(SalePaymentMethodEnum_1.SalePaymentMethodEnum),
     __metadata("design:type", String)
 ], RegisterPaymentRequest.prototype, "method", void 0);

package/package.json

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

package/src/retailWizard/dtos/WizardPayment.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsInt, IsOptional, IsString, Matches, Min } from 'class-validator';
+import { IsEnum, IsInt, IsOptional, IsString, Matches, Min, ValidateIf } from 'class-validator';
 import { regexIso8601 } from '../../helpers/constans/regex';
 import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
 import { IsSalePaymentList } from '../validators/IsSalePaymentList';
@@ -7,10 +7,11 @@ import { SalePayment } from './SalePayment';
 
 /** Registro del pago de contado dentro de la sesión (`WizardSession.payment`). SureKeep Fase 2 — pista Retail. */
 export class WizardPayment {
-    /** @deprecated Usa `payments`; con varios pagos lleva el método del primero. */
+    /** @deprecated Usa `payments`; con varios pagos lleva el método del primero. `null` en un cobro de $0. */
     @Expose()
+    @ValidateIf((o: { method?: unknown }) => o.method != null)
     @IsEnum(SalePaymentMethodEnum)
-    method!: SalePaymentMethodEnum;
+    method!: SalePaymentMethodEnum | null;
 
     @Expose()
     @IsInt()
@@ -23,11 +24,11 @@ export class WizardPayment {
     @IsString()
     detail?: string;
 
-    /** Pagos del cobro (1 a 3); ausente en sesiones anteriores al campo. */
+    /** Pagos del cobro (1 a 3); `null` en un cobro de $0, ausente en sesiones anteriores al campo. */
     @Expose()
     @IsOptional()
     @IsSalePaymentList()
-    payments?: SalePayment[];
+    payments?: SalePayment[] | null;
 
     @Expose()
     @IsString()

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

@@ -15,9 +15,9 @@ import { IsSalePaymentList } from '../../validators/IsSalePaymentList';
  * SureKeep Fase 2 — pista SOFOM.
  */
 export class DownPaymentRequest {
-    /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene. */
+    /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene y el monto es mayor a cero. */
     @Expose()
-    @ValidateIf((o: { payments?: unknown; method?: unknown }) => o.payments == null || o.method !== undefined)
+    @ValidateIf((o: { payments?: unknown; method?: unknown; amountCents?: unknown }) => o.method !== undefined || (o.payments == null && o.amountCents !== 0))
     @IsEnum(SalePaymentMethodEnum)
     method?: SalePaymentMethodEnum;
 

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

@@ -11,9 +11,9 @@ import { IsSalePaymentList } from '../../validators/IsSalePaymentList';
  * (D11) ANTES del registro; el folio no viaja en el body (lo posee el server). SureKeep Fase 2 — pista Retail.
  */
 export class RegisterPaymentRequest {
-  /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene. */
+  /** @deprecated Usa `payments`; obligatorio solo si `payments` no viene y el monto es mayor a cero. */
   @Expose()
-  @ValidateIf((o: { payments?: unknown; method?: unknown }) => o.payments == null || o.method !== undefined)
+  @ValidateIf((o: { payments?: unknown; method?: unknown; amountCents?: unknown }) => o.method !== undefined || (o.payments == null && o.amountCents !== 0))
   @IsEnum(SalePaymentMethodEnum)
   method?: SalePaymentMethodEnum;