@fiado/type-kit 3.634.0 → 3.636.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/helpdesk/dtos/HelpdeskCreateTicketRequest.d.ts

@@ -1,4 +1,5 @@
 import { AlertClassification } from "../enums/AlertClassificationEnum";
+import { ZendeskCaseTag } from "../enums/ZendeskCaseTagEnum";
 export declare class HelpdeskCreateTicketRequest {
     subject: string;
     note: string;
@@ -15,4 +16,9 @@ export declare class HelpdeskCreateTicketRequest {
     groupId?: number;
     /** Clasificación explícita del usuario para el asunto; si no va, zendesk-business la calcula. */
     classification?: AlertClassification;
+    /**
+     * Tags de caso del alertamiento interno. A diferencia de `tags`, NO se usan para buscar el
+     * hilo: sólo se agregan al ticket, al crearlo y al anexarle una nota.
+     */
+    caseTags?: ZendeskCaseTag[];
 }

package/bin/helpdesk/dtos/HelpdeskCreateTicketRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelpdeskCreateTicketRequest = void 0;
 const class_validator_1 = require("class-validator");
 const AlertClassificationEnum_1 = require("../enums/AlertClassificationEnum");
+const ZendeskCaseTagEnum_1 = require("../enums/ZendeskCaseTagEnum");
 class HelpdeskCreateTicketRequest {
 }
 exports.HelpdeskCreateTicketRequest = HelpdeskCreateTicketRequest;
@@ -68,3 +69,9 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], HelpdeskCreateTicketRequest.prototype, "classification", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(ZendeskCaseTagEnum_1.ZendeskCaseTag, { each: true }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], HelpdeskCreateTicketRequest.prototype, "caseTags", void 0);

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.d.ts

@@ -1,5 +1,6 @@
 import { AlertClassification } from "../enums/AlertClassificationEnum";
 import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
+import { ZendeskCaseTag } from "../enums/ZendeskCaseTagEnum";
 /**
  * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
  * la convierte en una nota interna de Zendesk: solo la ven los agentes, el usuario nunca.
@@ -27,4 +28,9 @@ export declare class ZendeskInternalAlertRequest {
      * si no, la calcula a partir del scope del directorio.
      */
     classification?: AlertClassification;
+    /**
+     * Tags de caso que se agregan al ticket (ver `ZendeskCaseTag`). Se acumulan: al anexar a un
+     * ticket existente se suman a los que ya tiene. No cambian a qué hilo va la nota.
+     */
+    caseTags?: ZendeskCaseTag[];
 }

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.js

@@ -13,6 +13,7 @@ exports.ZendeskInternalAlertRequest = void 0;
 const class_validator_1 = require("class-validator");
 const AlertClassificationEnum_1 = require("../enums/AlertClassificationEnum");
 const InternalAlertChannelEnum_1 = require("../enums/InternalAlertChannelEnum");
+const ZendeskCaseTagEnum_1 = require("../enums/ZendeskCaseTagEnum");
 /**
  * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
  * la convierte en una nota interna de Zendesk: solo la ven los agentes, el usuario nunca.
@@ -49,3 +50,9 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], ZendeskInternalAlertRequest.prototype, "classification", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsEnum)(ZendeskCaseTagEnum_1.ZendeskCaseTag, { each: true }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], ZendeskInternalAlertRequest.prototype, "caseTags", void 0);

package/bin/helpdesk/enums/ZendeskCaseTagEnum.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tag de caso en el ticket interno de Zendesk: qué tipo de problema tiene el cliente, para que
+ * CS lo vea en su vista. Lo pone el Lambda que manda la alerta.
+ *
+ * Distinto de `InternalAlertChannel`: el canal decide a qué hilo va la nota; el tag de caso sólo
+ * se agrega al ticket y se ACUMULA (un cliente puede pasar por varios casos). No participa en la
+ * búsqueda del hilo.
+ *
+ * En minúsculas: es como Zendesk guarda los tags y como se configuran las vistas.
+ * Fuente: accountsresolver-validacion-corregido.csv, columna "NUEVO TAG zendesk".
+ */
+export declare enum ZendeskCaseTag {
+    IT_PROBLEM = "it_problem",
+    COMPLIANCE_PROBLEM = "compliance_problem",
+    CUSTOMER_CARE_OOW = "customer_care_oow",
+    CUSTOMER_CARE_FIX_PHOTO = "customer_care_fix_photo",
+    CUSTOMER_CARE_PREVENTIVE = "customer_care_preventive",
+    CUSTOMER_CARE_FIX_DOB = "customer_care_fix_dob",
+    CUSTOMER_CARE_FIX_ADDRESS_USA = "customer_care_fix_address_usa",
+    CUSTOMER_CARE_FIX_ADDRESS_MX = "customer_care_fix_address_mx"
+}

package/bin/helpdesk/enums/ZendeskCaseTagEnum.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZendeskCaseTag = void 0;
+/**
+ * Tag de caso en el ticket interno de Zendesk: qué tipo de problema tiene el cliente, para que
+ * CS lo vea en su vista. Lo pone el Lambda que manda la alerta.
+ *
+ * Distinto de `InternalAlertChannel`: el canal decide a qué hilo va la nota; el tag de caso sólo
+ * se agrega al ticket y se ACUMULA (un cliente puede pasar por varios casos). No participa en la
+ * búsqueda del hilo.
+ *
+ * En minúsculas: es como Zendesk guarda los tags y como se configuran las vistas.
+ * Fuente: accountsresolver-validacion-corregido.csv, columna "NUEVO TAG zendesk".
+ */
+var ZendeskCaseTag;
+(function (ZendeskCaseTag) {
+    ZendeskCaseTag["IT_PROBLEM"] = "it_problem";
+    ZendeskCaseTag["COMPLIANCE_PROBLEM"] = "compliance_problem";
+    ZendeskCaseTag["CUSTOMER_CARE_OOW"] = "customer_care_oow";
+    ZendeskCaseTag["CUSTOMER_CARE_FIX_PHOTO"] = "customer_care_fix_photo";
+    ZendeskCaseTag["CUSTOMER_CARE_PREVENTIVE"] = "customer_care_preventive";
+    ZendeskCaseTag["CUSTOMER_CARE_FIX_DOB"] = "customer_care_fix_dob";
+    ZendeskCaseTag["CUSTOMER_CARE_FIX_ADDRESS_USA"] = "customer_care_fix_address_usa";
+    ZendeskCaseTag["CUSTOMER_CARE_FIX_ADDRESS_MX"] = "customer_care_fix_address_mx";
+})(ZendeskCaseTag || (exports.ZendeskCaseTag = ZendeskCaseTag = {}));

package/bin/helpdesk/index.d.ts

@@ -2,6 +2,7 @@ export * from './dtos/HelpdeskCreateUserRequest';
 export * from './dtos/HelpdeskCreateTicketRequest';
 export * from './dtos/ZendeskInternalAlertRequest';
 export * from './enums/InternalAlertChannelEnum';
+export * from './enums/ZendeskCaseTagEnum';
 export * from './enums/AlertClassificationEnum';
 export * from './enums/ZendeskAlertKindEnum';
 export * from './interfaces/IZendeskAlertMessage';

package/bin/helpdesk/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./dtos/HelpdeskCreateTicketRequest"), exports);
 // Alertamiento interno (cola de Zendesk)
 __exportStar(require("./dtos/ZendeskInternalAlertRequest"), exports);
 __exportStar(require("./enums/InternalAlertChannelEnum"), exports);
+__exportStar(require("./enums/ZendeskCaseTagEnum"), exports);
 __exportStar(require("./enums/AlertClassificationEnum"), exports);
 __exportStar(require("./enums/ZendeskAlertKindEnum"), exports);
 __exportStar(require("./interfaces/IZendeskAlertMessage"), exports);

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.636.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/helpdesk/dtos/HelpdeskCreateTicketRequest.ts

@@ -1,5 +1,6 @@
 import { IsArray, IsBoolean, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString } from "class-validator";
 import { AlertClassification } from "../enums/AlertClassificationEnum";
+import { ZendeskCaseTag } from "../enums/ZendeskCaseTagEnum";
 
 export class HelpdeskCreateTicketRequest {
 
@@ -49,4 +50,13 @@ export class HelpdeskCreateTicketRequest {
     @IsOptional()
     classification?: AlertClassification;
 
+    /**
+     * Tags de caso del alertamiento interno. A diferencia de `tags`, NO se usan para buscar el
+     * hilo: sólo se agregan al ticket, al crearlo y al anexarle una nota.
+     */
+    @IsArray()
+    @IsEnum(ZendeskCaseTag, { each: true })
+    @IsOptional()
+    caseTags?: ZendeskCaseTag[];
+
 }

package/src/helpdesk/dtos/ZendeskInternalAlertRequest.ts

@@ -1,6 +1,7 @@
 import { ArrayNotEmpty, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString } from "class-validator";
 import { AlertClassification } from "../enums/AlertClassificationEnum";
 import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
+import { ZendeskCaseTag } from "../enums/ZendeskCaseTagEnum";
 
 /**
  * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
@@ -45,4 +46,13 @@ export class ZendeskInternalAlertRequest {
     @IsEnum(AlertClassification)
     @IsOptional()
     classification?: AlertClassification;
+
+    /**
+     * Tags de caso que se agregan al ticket (ver `ZendeskCaseTag`). Se acumulan: al anexar a un
+     * ticket existente se suman a los que ya tiene. No cambian a qué hilo va la nota.
+     */
+    @IsArray()
+    @IsEnum(ZendeskCaseTag, { each: true })
+    @IsOptional()
+    caseTags?: ZendeskCaseTag[];
 }

package/src/helpdesk/enums/ZendeskCaseTagEnum.ts

@@ -0,0 +1,21 @@
+/**
+ * Tag de caso en el ticket interno de Zendesk: qué tipo de problema tiene el cliente, para que
+ * CS lo vea en su vista. Lo pone el Lambda que manda la alerta.
+ *
+ * Distinto de `InternalAlertChannel`: el canal decide a qué hilo va la nota; el tag de caso sólo
+ * se agrega al ticket y se ACUMULA (un cliente puede pasar por varios casos). No participa en la
+ * búsqueda del hilo.
+ *
+ * En minúsculas: es como Zendesk guarda los tags y como se configuran las vistas.
+ * Fuente: accountsresolver-validacion-corregido.csv, columna "NUEVO TAG zendesk".
+ */
+export enum ZendeskCaseTag {
+    IT_PROBLEM = 'it_problem',
+    COMPLIANCE_PROBLEM = 'compliance_problem',
+    CUSTOMER_CARE_OOW = 'customer_care_oow',
+    CUSTOMER_CARE_FIX_PHOTO = 'customer_care_fix_photo',
+    CUSTOMER_CARE_PREVENTIVE = 'customer_care_preventive',
+    CUSTOMER_CARE_FIX_DOB = 'customer_care_fix_dob',
+    CUSTOMER_CARE_FIX_ADDRESS_USA = 'customer_care_fix_address_usa',
+    CUSTOMER_CARE_FIX_ADDRESS_MX = 'customer_care_fix_address_mx'
+}

package/src/helpdesk/index.ts

@@ -4,6 +4,7 @@ export * from './dtos/HelpdeskCreateTicketRequest';
 // Alertamiento interno (cola de Zendesk)
 export * from './dtos/ZendeskInternalAlertRequest';
 export * from './enums/InternalAlertChannelEnum';
+export * from './enums/ZendeskCaseTagEnum';
 export * from './enums/AlertClassificationEnum';
 export * from './enums/ZendeskAlertKindEnum';
 export * from './interfaces/IZendeskAlertMessage';

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;