@fiado/type-kit 3.408.0 → 3.410.0

package/_test_/unit/loanCredit/dtos/loanDeviceContract.test.ts

@@ -369,13 +369,24 @@ describe('LoanDeviceNotifyRequest', () => {
         expect(JSON.stringify(itemsError)).toContain(field);
     });
 
-    it.each(['notificationCode', 'title', 'content'] as const)('falla si %s no viene', async field => {
+    it.each(['notificationCode', 'title', 'content'] as const)('valida sin %s', async field => {
         const { [field]: _omitted, ...rest } = validNotifyItem;
         const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems([rest]));
         const errors = await validate(dto);
-        const itemsError = errors.find(e => e.property === 'items');
-        expect(itemsError).toBeDefined();
-        expect(JSON.stringify(itemsError)).toContain(field);
+        expect(errors).toEqual([]);
+    });
+
+    it('valida el ítem que manda el motor: noticeType y nada de texto', async () => {
+        const items = [
+            {
+                creditId: CREDIT_ID,
+                intensity: DeviceNotifyIntensityEnum.FULLSCREEN,
+                noticeType: MdmNoticeTypeEnum.OVERDUE_1_DAY,
+            },
+        ];
+        const dto = plainToInstance(LoanDeviceNotifyRequest, notifyWithItems(items));
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
     });
 
     it.each(['notificationCode', 'title', 'content'] as const)('falla si %s no es string', async field => {

package/_test_/unit/mdm/dtos/mdmDeviceContract.test.ts

@@ -116,6 +116,38 @@ describe('DeviceNotifyRequest.noticeType', () => {
     });
 });
 
+describe('DeviceNotifyRequest — los tres textos son opcionales', () => {
+    /** Aviso como lo manda el motor: solo el id agnóstico, sin relleno de texto. */
+    const noticeOnly = {
+        imei: validNotify.imei,
+        intensity: validNotify.intensity,
+        noticeType: MdmNoticeTypeEnum.OVERDUE_1_DAY,
+        operationReference: validNotify.operationReference,
+    };
+
+    it('valida con noticeType y sin ninguno de los tres textos', async () => {
+        const dto = plainToInstance(DeviceNotifyRequest, noticeOnly);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.notificationCode).toBeUndefined();
+        expect(dto.title).toBeUndefined();
+        expect(dto.content).toBeUndefined();
+    });
+
+    it.each(['notificationCode', 'title', 'content'] as const)('valida sin %s', async field => {
+        const { [field]: _omitted, ...rest } = validNotify;
+        const dto = plainToInstance(DeviceNotifyRequest, rest);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it.each(['notificationCode', 'title', 'content'] as const)('falla si %s viene vacío', async field => {
+        const dto = plainToInstance(DeviceNotifyRequest, { ...validNotify, [field]: '' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, field, 'isNotEmpty')).toBe(true);
+    });
+});
+
 describe('MdmNoticeTypeEnum', () => {
     it('expone los diez avisos del catálogo de cobranza', () => {
         expect(Object.values(MdmNoticeTypeEnum)).toEqual([

package/bin/loanCredit/dtos/LoanDeviceNotifyItem.d.ts

@@ -2,22 +2,20 @@ import { DeviceNotifyIntensityEnum } from '../../mdm/enums/DeviceNotifyIntensity
 import { MdmNoticeTypeEnum } from '../../mdm/enums/MdmNoticeTypeEnum';
 /**
  * Ítem de notificación: a qué crédito se le avisa y con qué aviso.
- * El aviso viaja como `noticeType`; los tres campos de texto siguen siendo obligatorios porque
- * Datacultr usa el código del catálogo y Trustonic el texto crudo.
+ * El aviso viaja como `noticeType`; los tres campos de texto son el camino legacy.
  */
 export declare class LoanDeviceNotifyItem {
     creditId: string;
     intensity: DeviceNotifyIntensityEnum;
     /**
      * Id agnóstico del aviso; cada connector lo traduce a lo que su proveedor entiende.
-     * Los connectors lo van a preferir sobre `notificationCode`/`title`/`content`;
-     * hasta entonces esos tres siguen siendo la fuente.
+     * Cuando viaja, manda: los connectors ignoran `notificationCode`, `title` y `content`.
      */
     noticeType?: MdmNoticeTypeEnum;
-    /** Código de notificación del catálogo de Datacultr. Queda por compatibilidad durante la migración a `noticeType`. */
-    notificationCode: string;
-    /** Título crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
-    title: string;
-    /** Cuerpo crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
-    content: string;
+    /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
+    notificationCode?: string;
+    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    title?: string;
+    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    content?: string;
 }

package/bin/loanCredit/dtos/LoanDeviceNotifyItem.js

@@ -17,8 +17,7 @@ const MdmNoticeTypeEnum_1 = require("../../mdm/enums/MdmNoticeTypeEnum");
 const CreditIdPattern_1 = require("../constants/CreditIdPattern");
 /**
  * Ítem de notificación: a qué crédito se le avisa y con qué aviso.
- * El aviso viaja como `noticeType`; los tres campos de texto siguen siendo obligatorios porque
- * Datacultr usa el código del catálogo y Trustonic el texto crudo.
+ * El aviso viaja como `noticeType`; los tres campos de texto son el camino legacy.
  */
 class LoanDeviceNotifyItem {
 }
@@ -41,6 +40,7 @@ __decorate([
 ], LoanDeviceNotifyItem.prototype, "noticeType", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MaxLength)(64),
@@ -48,6 +48,7 @@ __decorate([
 ], LoanDeviceNotifyItem.prototype, "notificationCode", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MaxLength)(128),
@@ -55,6 +56,7 @@ __decorate([
 ], LoanDeviceNotifyItem.prototype, "title", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MaxLength)(1024),

package/bin/loanCredit/dtos/LoanInstallment.d.ts

@@ -17,7 +17,10 @@ export declare class LoanInstallment {
     ivaCents: number;
     /** capital + interés + IVA. */
     totalCents: number;
-    /** Saldo insoluto de capital tras aplicar la cuota. */
+    /**
+     * Lo que debe ESTA cuota, no el insoluto del crédito: nace igual a `totalCents`. Hoy nadie lo
+     * decrementa — quien aplique pagos es quien lo consume.
+     */
     outstandingBalanceCents: number;
     paidAt?: string;
     createdBy: string;

package/bin/loanCredit/dtos/responses/LoanInstallmentResponse.d.ts

@@ -12,6 +12,10 @@ export interface LoanInstallmentResponse {
     interestCents: number;
     ivaCents: number;
     totalCents: number;
+    /**
+     * Lo que debe ESTA cuota, no el insoluto del crédito: nace igual a `totalCents`. Hoy nadie lo
+     * decrementa — quien aplique pagos es quien lo consume.
+     */
     outstandingBalanceCents: number;
     paidAt?: string;
 }

package/bin/mdm/dtos/DeviceNotifyRequest.d.ts

@@ -5,15 +5,14 @@ export declare class DeviceNotifyRequest {
     intensity: DeviceNotifyIntensityEnum;
     /**
      * Id agnóstico del aviso; cada connector lo traduce a lo que su proveedor entiende.
-     * Los connectors lo van a preferir sobre `notificationCode`/`title`/`content`;
-     * hasta entonces esos tres siguen siendo la fuente.
+     * Cuando viaja, manda: los connectors ignoran `notificationCode`, `title` y `content`.
      */
     noticeType?: MdmNoticeTypeEnum;
-    /** Código de notificación del catálogo de Datacultr. Queda por compatibilidad durante la migración a `noticeType`. */
-    notificationCode: string;
-    /** Título crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
-    title: string;
-    /** Cuerpo crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
-    content: string;
+    /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
+    notificationCode?: string;
+    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    title?: string;
+    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
+    content?: string;
     operationReference: string;
 }

package/bin/mdm/dtos/DeviceNotifyRequest.js

@@ -36,18 +36,21 @@ __decorate([
 ], DeviceNotifyRequest.prototype, "noticeType", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], DeviceNotifyRequest.prototype, "notificationCode", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], DeviceNotifyRequest.prototype, "title", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)

package/bin/mdm/enums/MdmErrorCodeEnum.d.ts

@@ -3,6 +3,11 @@ export declare enum MdmErrorCodeEnum {
     PROVIDER_NOT_SUPPORTED = "PROVIDER_NOT_SUPPORTED",
     /** El proveedor la tiene, pero ESTE equipo no la admite por cómo se enroló. No es terminal. */
     DEVICE_CAPABILITY_NOT_SUPPORTED = "DEVICE_CAPABILITY_NOT_SUPPORTED",
+    /**
+     * El proveedor la tiene y el equipo la admite, pero no en el ESTADO en que está ahora. No es
+     * terminal ni describe cómo se enroló: el mismo equipo, en otro estado, sí acepta la operación.
+     */
+    DEVICE_STATE_NOT_SUPPORTED = "DEVICE_STATE_NOT_SUPPORTED",
     /** No hay connector cableado para ese proveedor: reintentar nunca lo resuelve. */
     CONNECTOR_NOT_WIRED = "CONNECTOR_NOT_WIRED",
     DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",

package/bin/mdm/enums/MdmErrorCodeEnum.js

@@ -7,6 +7,11 @@ var MdmErrorCodeEnum;
     MdmErrorCodeEnum["PROVIDER_NOT_SUPPORTED"] = "PROVIDER_NOT_SUPPORTED";
     /** El proveedor la tiene, pero ESTE equipo no la admite por cómo se enroló. No es terminal. */
     MdmErrorCodeEnum["DEVICE_CAPABILITY_NOT_SUPPORTED"] = "DEVICE_CAPABILITY_NOT_SUPPORTED";
+    /**
+     * El proveedor la tiene y el equipo la admite, pero no en el ESTADO en que está ahora. No es
+     * terminal ni describe cómo se enroló: el mismo equipo, en otro estado, sí acepta la operación.
+     */
+    MdmErrorCodeEnum["DEVICE_STATE_NOT_SUPPORTED"] = "DEVICE_STATE_NOT_SUPPORTED";
     /** No hay connector cableado para ese proveedor: reintentar nunca lo resuelve. */
     MdmErrorCodeEnum["CONNECTOR_NOT_WIRED"] = "CONNECTOR_NOT_WIRED";
     MdmErrorCodeEnum["DEVICE_NOT_FOUND"] = "DEVICE_NOT_FOUND";

package/package.json

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

package/src/loanCredit/dtos/LoanDeviceNotifyItem.ts

@@ -6,8 +6,7 @@ import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPatte
 
 /**
  * Ítem de notificación: a qué crédito se le avisa y con qué aviso.
- * El aviso viaja como `noticeType`; los tres campos de texto siguen siendo obligatorios porque
- * Datacultr usa el código del catálogo y Trustonic el texto crudo.
+ * El aviso viaja como `noticeType`; los tres campos de texto son el camino legacy.
  */
 export class LoanDeviceNotifyItem {
     @Expose()
@@ -20,32 +19,34 @@ export class LoanDeviceNotifyItem {
 
     /**
      * Id agnóstico del aviso; cada connector lo traduce a lo que su proveedor entiende.
-     * Los connectors lo van a preferir sobre `notificationCode`/`title`/`content`;
-     * hasta entonces esos tres siguen siendo la fuente.
+     * Cuando viaja, manda: los connectors ignoran `notificationCode`, `title` y `content`.
      */
     @Expose()
     @IsOptional()
     @IsEnum(MdmNoticeTypeEnum)
     noticeType?: MdmNoticeTypeEnum;
 
-    /** Código de notificación del catálogo de Datacultr. Queda por compatibilidad durante la migración a `noticeType`. */
+    /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
     @Expose()
+    @IsOptional()
     @IsString()
     @IsNotEmpty()
     @MaxLength(64)
-    notificationCode: string;
+    notificationCode?: string;
 
-    /** Título crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
+    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
     @Expose()
+    @IsOptional()
     @IsString()
     @IsNotEmpty()
     @MaxLength(128)
-    title: string;
+    title?: string;
 
-    /** Cuerpo crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
+    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
     @Expose()
+    @IsOptional()
     @IsString()
     @IsNotEmpty()
     @MaxLength(1024)
-    content: string;
+    content?: string;
 }

package/src/loanCredit/dtos/LoanInstallment.ts

@@ -47,7 +47,10 @@ export class LoanInstallment {
     @IsInt()
     totalCents!: number;
 
-    /** Saldo insoluto de capital tras aplicar la cuota. */
+    /**
+     * Lo que debe ESTA cuota, no el insoluto del crédito: nace igual a `totalCents`. Hoy nadie lo
+     * decrementa — quien aplique pagos es quien lo consume.
+     */
     @Expose()
     @IsInt()
     outstandingBalanceCents!: number;

package/src/loanCredit/dtos/responses/LoanInstallmentResponse.ts

@@ -13,6 +13,10 @@ export interface LoanInstallmentResponse {
     interestCents: number;
     ivaCents: number;
     totalCents: number;
+    /**
+     * Lo que debe ESTA cuota, no el insoluto del crédito: nace igual a `totalCents`. Hoy nadie lo
+     * decrementa — quien aplique pagos es quien lo consume.
+     */
     outstandingBalanceCents: number;
     paidAt?: string;
 }

package/src/mdm/dtos/DeviceNotifyRequest.ts

@@ -15,31 +15,33 @@ export class DeviceNotifyRequest {
 
     /**
      * Id agnóstico del aviso; cada connector lo traduce a lo que su proveedor entiende.
-     * Los connectors lo van a preferir sobre `notificationCode`/`title`/`content`;
-     * hasta entonces esos tres siguen siendo la fuente.
+     * Cuando viaja, manda: los connectors ignoran `notificationCode`, `title` y `content`.
      */
     @Expose()
     @IsOptional()
     @IsEnum(MdmNoticeTypeEnum)
     noticeType?: MdmNoticeTypeEnum;
 
-    /** Código de notificación del catálogo de Datacultr. Queda por compatibilidad durante la migración a `noticeType`. */
+    /** Código del catálogo de Datacultr. Camino legacy: solo se lee si no viaja `noticeType`. */
     @Expose()
+    @IsOptional()
     @IsString()
     @IsNotEmpty()
-    notificationCode: string;
+    notificationCode?: string;
 
-    /** Título crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
+    /** Título crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
     @Expose()
+    @IsOptional()
     @IsString()
     @IsNotEmpty()
-    title: string;
+    title?: string;
 
-    /** Cuerpo crudo que exige Trustonic. Queda por compatibilidad durante la migración a `noticeType`. */
+    /** Cuerpo crudo para Trustonic. Camino legacy: solo se lee si no viaja `noticeType`. */
     @Expose()
+    @IsOptional()
     @IsString()
     @IsNotEmpty()
-    content: string;
+    content?: string;
 
     @Expose()
     @IsString()

package/src/mdm/enums/MdmErrorCodeEnum.ts

@@ -3,6 +3,11 @@ export enum MdmErrorCodeEnum {
     PROVIDER_NOT_SUPPORTED = "PROVIDER_NOT_SUPPORTED",
     /** El proveedor la tiene, pero ESTE equipo no la admite por cómo se enroló. No es terminal. */
     DEVICE_CAPABILITY_NOT_SUPPORTED = "DEVICE_CAPABILITY_NOT_SUPPORTED",
+    /**
+     * El proveedor la tiene y el equipo la admite, pero no en el ESTADO en que está ahora. No es
+     * terminal ni describe cómo se enroló: el mismo equipo, en otro estado, sí acepta la operación.
+     */
+    DEVICE_STATE_NOT_SUPPORTED = "DEVICE_STATE_NOT_SUPPORTED",
     /** No hay connector cableado para ese proveedor: reintentar nunca lo resuelve. */
     CONNECTOR_NOT_WIRED = "CONNECTOR_NOT_WIRED",
     DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",