@fiado/type-kit 3.407.0 → 3.409.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/constants/creditPaymentHook.d.ts

@@ -0,0 +1,2 @@
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+export declare const CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

package/bin/loanCredit/constants/creditPaymentHook.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = void 0;
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+exports.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

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/requests/CreditPaymentAppliedRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+export declare class CreditPaymentAppliedRequest {
+    /** Quién aplicó el pago; queda en la bitácora del expediente. */
+    actor?: string;
+    /** Referencia del pago en el sistema que lo aplicó. Sólo trazabilidad. */
+    paymentReference?: string;
+}

package/bin/loanCredit/dtos/requests/CreditPaymentAppliedRequest.js

@@ -0,0 +1,38 @@
+"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.CreditPaymentAppliedRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const creditPaymentHook_1 = require("../../constants/creditPaymentHook");
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+class CreditPaymentAppliedRequest {
+}
+exports.CreditPaymentAppliedRequest = CreditPaymentAppliedRequest;
+__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)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditPaymentAppliedRequest.prototype, "actor", 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)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditPaymentAppliedRequest.prototype, "paymentReference", void 0);

package/bin/loanCredit/dtos/requests/CreditSettledRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+export declare class CreditSettledRequest {
+    /** Quién declaró la liquidación; queda en la bitácora del expediente. */
+    actor?: string;
+    /** Referencia del pago que liquidó. Sólo trazabilidad. */
+    paymentReference?: string;
+}

package/bin/loanCredit/dtos/requests/CreditSettledRequest.js

@@ -0,0 +1,38 @@
+"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.CreditSettledRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const creditPaymentHook_1 = require("../../constants/creditPaymentHook");
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+class CreditSettledRequest {
+}
+exports.CreditSettledRequest = CreditSettledRequest;
+__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)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditSettledRequest.prototype, "actor", 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)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditSettledRequest.prototype, "paymentReference", void 0);

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

@@ -0,0 +1,8 @@
+import { CreditPaymentUnlockDecisionEnum } from '../../enums/CreditPaymentUnlockDecisionEnum';
+/** Resultado de aplicar un pago: el crédito sale de mora y el equipo se suelta si corresponde. */
+export interface CreditPaymentAppliedResponse {
+    creditId: string;
+    /** El crédito salió de mora. Pasa aunque no haya equipo, esté sin candado, o sea SCHEDULED. */
+    creditReactivated: boolean;
+    unlockDecision: CreditPaymentUnlockDecisionEnum;
+}

package/bin/loanCredit/dtos/responses/CreditPaymentAppliedResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,8 @@
+import { CreditSettlementDecisionEnum } from '../../enums/CreditSettlementDecisionEnum';
+import { CreditSettlementReleaseDecisionEnum } from '../../enums/CreditSettlementReleaseDecisionEnum';
+/** Resultado de liquidar el crédito; `releaseDecision` es null si el equipo no salió al proveedor. */
+export interface CreditSettledResponse {
+    creditId: string;
+    settlementDecision: CreditSettlementDecisionEnum;
+    releaseDecision: CreditSettlementReleaseDecisionEnum | null;
+}

package/bin/loanCredit/dtos/responses/CreditSettledResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/enums/CreditPaymentUnlockDecisionEnum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+export declare enum CreditPaymentUnlockDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CREDIT_NOT_UNLOCKABLE = "CREDIT_NOT_UNLOCKABLE",
+    NOT_ENROLLED = "NOT_ENROLLED",
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    NOT_LOCKED = "NOT_LOCKED",
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    LOCKED_FOR_OTHER_REASON = "LOCKED_FOR_OTHER_REASON",
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    THRESHOLD_NOT_MET = "THRESHOLD_NOT_MET",
+    UNLOCKED = "UNLOCKED",
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    UNLOCK_PENDING = "UNLOCK_PENDING",
+    UNLOCK_FAILED = "UNLOCK_FAILED"
+}

package/bin/loanCredit/enums/CreditPaymentUnlockDecisionEnum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditPaymentUnlockDecisionEnum = void 0;
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+var CreditPaymentUnlockDecisionEnum;
+(function (CreditPaymentUnlockDecisionEnum) {
+    CreditPaymentUnlockDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CreditPaymentUnlockDecisionEnum["CREDIT_NOT_UNLOCKABLE"] = "CREDIT_NOT_UNLOCKABLE";
+    CreditPaymentUnlockDecisionEnum["NOT_ENROLLED"] = "NOT_ENROLLED";
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    CreditPaymentUnlockDecisionEnum["NOT_LOCKED"] = "NOT_LOCKED";
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    CreditPaymentUnlockDecisionEnum["LOCKED_FOR_OTHER_REASON"] = "LOCKED_FOR_OTHER_REASON";
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    CreditPaymentUnlockDecisionEnum["THRESHOLD_NOT_MET"] = "THRESHOLD_NOT_MET";
+    CreditPaymentUnlockDecisionEnum["UNLOCKED"] = "UNLOCKED";
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    CreditPaymentUnlockDecisionEnum["UNLOCK_PENDING"] = "UNLOCK_PENDING";
+    CreditPaymentUnlockDecisionEnum["UNLOCK_FAILED"] = "UNLOCK_FAILED";
+})(CreditPaymentUnlockDecisionEnum || (exports.CreditPaymentUnlockDecisionEnum = CreditPaymentUnlockDecisionEnum = {}));

package/bin/loanCredit/enums/CreditSettlementDecisionEnum.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+export declare enum CreditSettlementDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    ALREADY_SETTLED = "ALREADY_SETTLED",
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CREDIT_NOT_SETTLEABLE = "CREDIT_NOT_SETTLEABLE",
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    NO_INSTALLMENTS = "NO_INSTALLMENTS",
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    INCOMPLETE_PLAN = "INCOMPLETE_PLAN",
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    BALANCE_OUTSTANDING = "BALANCE_OUTSTANDING",
+    SETTLED = "SETTLED",
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    SETTLE_CONFLICT = "SETTLE_CONFLICT",
+    SETTLE_FAILED = "SETTLE_FAILED"
+}

package/bin/loanCredit/enums/CreditSettlementDecisionEnum.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettlementDecisionEnum = void 0;
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+var CreditSettlementDecisionEnum;
+(function (CreditSettlementDecisionEnum) {
+    CreditSettlementDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    CreditSettlementDecisionEnum["ALREADY_SETTLED"] = "ALREADY_SETTLED";
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CreditSettlementDecisionEnum["CREDIT_NOT_SETTLEABLE"] = "CREDIT_NOT_SETTLEABLE";
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    CreditSettlementDecisionEnum["NO_INSTALLMENTS"] = "NO_INSTALLMENTS";
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    CreditSettlementDecisionEnum["INCOMPLETE_PLAN"] = "INCOMPLETE_PLAN";
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    CreditSettlementDecisionEnum["BALANCE_OUTSTANDING"] = "BALANCE_OUTSTANDING";
+    CreditSettlementDecisionEnum["SETTLED"] = "SETTLED";
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    CreditSettlementDecisionEnum["SETTLE_CONFLICT"] = "SETTLE_CONFLICT";
+    CreditSettlementDecisionEnum["SETTLE_FAILED"] = "SETTLE_FAILED";
+})(CreditSettlementDecisionEnum || (exports.CreditSettlementDecisionEnum = CreditSettlementDecisionEnum = {}));

package/bin/loanCredit/enums/CreditSettlementReleaseDecisionEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+export declare enum CreditSettlementReleaseDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CREDIT_NOT_SETTLED = "CREDIT_NOT_SETTLED",
+    NOT_ENROLLED = "NOT_ENROLLED",
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    ALREADY_RELEASED = "ALREADY_RELEASED",
+    RELEASED = "RELEASED",
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    RELEASE_PENDING = "RELEASE_PENDING",
+    RELEASE_FAILED = "RELEASE_FAILED"
+}

package/bin/loanCredit/enums/CreditSettlementReleaseDecisionEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettlementReleaseDecisionEnum = void 0;
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+var CreditSettlementReleaseDecisionEnum;
+(function (CreditSettlementReleaseDecisionEnum) {
+    CreditSettlementReleaseDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CreditSettlementReleaseDecisionEnum["CREDIT_NOT_SETTLED"] = "CREDIT_NOT_SETTLED";
+    CreditSettlementReleaseDecisionEnum["NOT_ENROLLED"] = "NOT_ENROLLED";
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    CreditSettlementReleaseDecisionEnum["ALREADY_RELEASED"] = "ALREADY_RELEASED";
+    CreditSettlementReleaseDecisionEnum["RELEASED"] = "RELEASED";
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    CreditSettlementReleaseDecisionEnum["RELEASE_PENDING"] = "RELEASE_PENDING";
+    CreditSettlementReleaseDecisionEnum["RELEASE_FAILED"] = "RELEASE_FAILED";
+})(CreditSettlementReleaseDecisionEnum || (exports.CreditSettlementReleaseDecisionEnum = CreditSettlementReleaseDecisionEnum = {}));

package/bin/loanCredit/index.d.ts

@@ -17,6 +17,14 @@ export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
 export * from './dtos/requests/ActivationCheckRequest';
+export * from './dtos/requests/CreditPaymentAppliedRequest';
+export * from './dtos/requests/CreditSettledRequest';
+export * from './dtos/responses/CreditPaymentAppliedResponse';
+export * from './dtos/responses/CreditSettledResponse';
+export * from './enums/CreditPaymentUnlockDecisionEnum';
+export * from './enums/CreditSettlementDecisionEnum';
+export * from './enums/CreditSettlementReleaseDecisionEnum';
+export * from './constants/creditPaymentHook';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 export * from './dtos/responses/LoanBorrowerResponse';
 export * from './dtos/responses/LoanCreditResponse';

package/bin/loanCredit/index.js

@@ -39,6 +39,14 @@ __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/QuoteLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/SignLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/ActivationCheckRequest"), exports);
+__exportStar(require("./dtos/requests/CreditPaymentAppliedRequest"), exports);
+__exportStar(require("./dtos/requests/CreditSettledRequest"), exports);
+__exportStar(require("./dtos/responses/CreditPaymentAppliedResponse"), exports);
+__exportStar(require("./dtos/responses/CreditSettledResponse"), exports);
+__exportStar(require("./enums/CreditPaymentUnlockDecisionEnum"), exports);
+__exportStar(require("./enums/CreditSettlementDecisionEnum"), exports);
+__exportStar(require("./enums/CreditSettlementReleaseDecisionEnum"), exports);
+__exportStar(require("./constants/creditPaymentHook"), exports);
 __exportStar(require("./dtos/requests/ChangeLoanCreditStatusRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/LoanBorrowerResponse"), exports);

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/package.json

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

package/src/loanCredit/constants/creditPaymentHook.ts

@@ -0,0 +1,2 @@
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+export const CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

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/requests/CreditPaymentAppliedRequest.ts

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH } from '../../constants/creditPaymentHook';
+
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+export class CreditPaymentAppliedRequest {
+    /** Quién aplicó el pago; queda en la bitácora del expediente. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    actor?: string;
+
+    /** Referencia del pago en el sistema que lo aplicó. Sólo trazabilidad. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    paymentReference?: string;
+}

package/src/loanCredit/dtos/requests/CreditSettledRequest.ts

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH } from '../../constants/creditPaymentHook';
+
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+export class CreditSettledRequest {
+    /** Quién declaró la liquidación; queda en la bitácora del expediente. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    actor?: string;
+
+    /** Referencia del pago que liquidó. Sólo trazabilidad. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    paymentReference?: string;
+}

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

@@ -0,0 +1,9 @@
+import { CreditPaymentUnlockDecisionEnum } from '../../enums/CreditPaymentUnlockDecisionEnum';
+
+/** Resultado de aplicar un pago: el crédito sale de mora y el equipo se suelta si corresponde. */
+export interface CreditPaymentAppliedResponse {
+    creditId: string;
+    /** El crédito salió de mora. Pasa aunque no haya equipo, esté sin candado, o sea SCHEDULED. */
+    creditReactivated: boolean;
+    unlockDecision: CreditPaymentUnlockDecisionEnum;
+}

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

@@ -0,0 +1,9 @@
+import { CreditSettlementDecisionEnum } from '../../enums/CreditSettlementDecisionEnum';
+import { CreditSettlementReleaseDecisionEnum } from '../../enums/CreditSettlementReleaseDecisionEnum';
+
+/** Resultado de liquidar el crédito; `releaseDecision` es null si el equipo no salió al proveedor. */
+export interface CreditSettledResponse {
+    creditId: string;
+    settlementDecision: CreditSettlementDecisionEnum;
+    releaseDecision: CreditSettlementReleaseDecisionEnum | null;
+}

package/src/loanCredit/enums/CreditPaymentUnlockDecisionEnum.ts

@@ -0,0 +1,20 @@
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+export enum CreditPaymentUnlockDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CREDIT_NOT_UNLOCKABLE = 'CREDIT_NOT_UNLOCKABLE',
+    NOT_ENROLLED = 'NOT_ENROLLED',
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    NOT_LOCKED = 'NOT_LOCKED',
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    LOCKED_FOR_OTHER_REASON = 'LOCKED_FOR_OTHER_REASON',
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    THRESHOLD_NOT_MET = 'THRESHOLD_NOT_MET',
+    UNLOCKED = 'UNLOCKED',
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    UNLOCK_PENDING = 'UNLOCK_PENDING',
+    UNLOCK_FAILED = 'UNLOCK_FAILED',
+}

package/src/loanCredit/enums/CreditSettlementDecisionEnum.ts

@@ -0,0 +1,21 @@
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+export enum CreditSettlementDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    ALREADY_SETTLED = 'ALREADY_SETTLED',
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CREDIT_NOT_SETTLEABLE = 'CREDIT_NOT_SETTLEABLE',
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    NO_INSTALLMENTS = 'NO_INSTALLMENTS',
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    INCOMPLETE_PLAN = 'INCOMPLETE_PLAN',
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    BALANCE_OUTSTANDING = 'BALANCE_OUTSTANDING',
+    SETTLED = 'SETTLED',
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    SETTLE_CONFLICT = 'SETTLE_CONFLICT',
+    SETTLE_FAILED = 'SETTLE_FAILED',
+}

package/src/loanCredit/enums/CreditSettlementReleaseDecisionEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+export enum CreditSettlementReleaseDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CREDIT_NOT_SETTLED = 'CREDIT_NOT_SETTLED',
+    NOT_ENROLLED = 'NOT_ENROLLED',
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    ALREADY_RELEASED = 'ALREADY_RELEASED',
+    RELEASED = 'RELEASED',
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    RELEASE_PENDING = 'RELEASE_PENDING',
+    RELEASE_FAILED = 'RELEASE_FAILED',
+}

package/src/loanCredit/index.ts

@@ -23,6 +23,14 @@ export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
 export * from './dtos/requests/ActivationCheckRequest';
+export * from './dtos/requests/CreditPaymentAppliedRequest';
+export * from './dtos/requests/CreditSettledRequest';
+export * from './dtos/responses/CreditPaymentAppliedResponse';
+export * from './dtos/responses/CreditSettledResponse';
+export * from './enums/CreditPaymentUnlockDecisionEnum';
+export * from './enums/CreditSettlementDecisionEnum';
+export * from './enums/CreditSettlementReleaseDecisionEnum';
+export * from './constants/creditPaymentHook';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 
 // Response DTOs

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()