@fiado/type-kit 3.387.0 → 3.389.0

package/bin/collection/dtos/CollectRequest.d.ts

@@ -1,3 +1,4 @@
+import { CollectionPricingDto } from './CollectionPricingDto';
 /**
  * Cobro inmediato y síncrono, con el importe ya resuelto por el dominio.
  *
@@ -14,4 +15,9 @@ export declare class CollectRequest {
     productId: string;
     chargeId: string;
     amount: number;
+    /**
+     * Tarifa con la que se cobra este cargo. Ausente, se aplica la configurada para la fuente — que es
+     * lo normal; se manda sólo cuando este cobro tiene condiciones propias.
+     */
+    pricing?: CollectionPricingDto;
 }

package/bin/collection/dtos/CollectRequest.js

@@ -11,6 +11,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CollectRequest = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 /**
  * Cobro inmediato y síncrono, con el importe ya resuelto por el dominio.
  *
@@ -47,3 +49,9 @@ __decorate([
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
 ], CollectRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], CollectRequest.prototype, "pricing", void 0);

package/bin/collection/dtos/CollectionAttemptDto.d.ts

@@ -1,3 +1,4 @@
+import { CollectionPricingDto } from './CollectionPricingDto';
 import { MechanismType } from '../enums/MechanismType';
 import { CollectionResultStatus } from '../enums/CollectionResultStatus';
 /** Un intento de cobro ejecutado sobre un intent, para el backoffice de monitoreo. */
@@ -11,5 +12,12 @@ export declare class CollectionAttemptDto {
     result?: CollectionResultStatus;
     errorCode?: string;
     errorDetail?: string;
+    /**
+     * La tarifa que se aplicó en ESTE intento. Se guarda por intento y no se deduce de la config
+     * porque la config puede haber cambiado desde entonces, y sin esto no habría forma de reconstruir
+     * con qué comisión se cobró.
+     */
+    pricing?: CollectionPricingDto;
+    collectionCycle?: number;
     createdAt: number;
 }

package/bin/collection/dtos/CollectionAttemptDto.js

@@ -11,6 +11,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CollectionAttemptDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 const MechanismType_1 = require("../enums/MechanismType");
 const CollectionResultStatus_1 = require("../enums/CollectionResultStatus");
 /** Un intento de cobro ejecutado sobre un intent, para el backoffice de monitoreo. */
@@ -57,6 +59,17 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CollectionAttemptDto.prototype, "errorDetail", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], CollectionAttemptDto.prototype, "pricing", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionAttemptDto.prototype, "collectionCycle", void 0);
 __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)

package/bin/collection/dtos/PendingChargeDto.d.ts

@@ -1,4 +1,5 @@
 import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { CollectionPricingDto } from './CollectionPricingDto';
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
@@ -8,6 +9,11 @@ import { CurrencyId } from '../../currency/enums/CurrencyId';
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
+ *
+ * `pricing` sigue el mismo criterio que `amount`: las condiciones comerciales de una cartera las
+ * conoce el dominio, no el motor. Va por cargo y no por producto porque la misma mecánica de cobro
+ * puede tarifarse distinto para un cliente concreto —una promoción, un beneficio, la comisión
+ * perdonada de la primera cuota—. Ausente, el motor aplica la tarifa configurada para la fuente.
  */
 export declare class PendingChargeDto {
     chargeId: string;
@@ -25,5 +31,6 @@ export declare class PendingChargeDto {
     taxAmount?: number;
     outstandingBalance?: number;
     amountCollected?: number;
+    pricing?: CollectionPricingDto;
     metadata?: Record<string, unknown>;
 }

package/bin/collection/dtos/PendingChargeDto.js

@@ -11,7 +11,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PendingChargeDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
 const CurrencyId_1 = require("../../currency/enums/CurrencyId");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
@@ -21,6 +23,11 @@ const CurrencyId_1 = require("../../currency/enums/CurrencyId");
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
+ *
+ * `pricing` sigue el mismo criterio que `amount`: las condiciones comerciales de una cartera las
+ * conoce el dominio, no el motor. Va por cargo y no por producto porque la misma mecánica de cobro
+ * puede tarifarse distinto para un cliente concreto —una promoción, un beneficio, la comisión
+ * perdonada de la primera cuota—. Ausente, el motor aplica la tarifa configurada para la fuente.
  */
 class PendingChargeDto {
 }
@@ -90,6 +97,12 @@ __decorate([
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
 ], PendingChargeDto.prototype, "amountCollected", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], PendingChargeDto.prototype, "pricing", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsObject)(),

package/bin/collection/enums/AckIntentStatus.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Desenlace de dar por atendida la alerta de un intent. No tiene variante "terminal": reconocer una
+ * alerta es válido incluso sobre un intent que ya cerró después del problema que la disparó.
+ */
+export declare enum AckIntentStatus {
+    ACKED = "ACKED",
+    NOT_FOUND = "NOT_FOUND"
+}

package/bin/collection/enums/AckIntentStatus.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AckIntentStatus = void 0;
+/**
+ * Desenlace de dar por atendida la alerta de un intent. No tiene variante "terminal": reconocer una
+ * alerta es válido incluso sobre un intent que ya cerró después del problema que la disparó.
+ */
+var AckIntentStatus;
+(function (AckIntentStatus) {
+    AckIntentStatus["ACKED"] = "ACKED";
+    AckIntentStatus["NOT_FOUND"] = "NOT_FOUND";
+})(AckIntentStatus || (exports.AckIntentStatus = AckIntentStatus = {}));

package/bin/collection/enums/RedriveOutboxStatus.d.ts

@@ -0,0 +1,8 @@
+/** Desenlace de reinyectar un evento atascado en la cola muerta. */
+export declare enum RedriveOutboxStatus {
+    /** El evento volvió a la cola de entrega y se reintentará. */
+    REDRIVEN = "REDRIVEN",
+    /** El evento no estaba en la cola muerta: reinyectarlo duplicaría una entrega en curso. */
+    NOT_DLQ = "NOT_DLQ",
+    NOT_FOUND = "NOT_FOUND"
+}

package/bin/collection/enums/RedriveOutboxStatus.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedriveOutboxStatus = void 0;
+/** Desenlace de reinyectar un evento atascado en la cola muerta. */
+var RedriveOutboxStatus;
+(function (RedriveOutboxStatus) {
+    /** El evento volvió a la cola de entrega y se reintentará. */
+    RedriveOutboxStatus["REDRIVEN"] = "REDRIVEN";
+    /** El evento no estaba en la cola muerta: reinyectarlo duplicaría una entrega en curso. */
+    RedriveOutboxStatus["NOT_DLQ"] = "NOT_DLQ";
+    RedriveOutboxStatus["NOT_FOUND"] = "NOT_FOUND";
+})(RedriveOutboxStatus || (exports.RedriveOutboxStatus = RedriveOutboxStatus = {}));

package/bin/collection/enums/RetryIntentStatus.d.ts

@@ -0,0 +1,8 @@
+/** Desenlace de un reintento forzado desde el panel de operación. */
+export declare enum RetryIntentStatus {
+    /** El intent estaba vivo y quedó reagendado para el próximo barrido. */
+    RETRIED = "RETRIED",
+    /** El intent ya había terminado (cobrado o cancelado). Forzar un reintento sería revivirlo. */
+    ALREADY_TERMINAL = "ALREADY_TERMINAL",
+    NOT_FOUND = "NOT_FOUND"
+}

package/bin/collection/enums/RetryIntentStatus.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryIntentStatus = void 0;
+/** Desenlace de un reintento forzado desde el panel de operación. */
+var RetryIntentStatus;
+(function (RetryIntentStatus) {
+    /** El intent estaba vivo y quedó reagendado para el próximo barrido. */
+    RetryIntentStatus["RETRIED"] = "RETRIED";
+    /** El intent ya había terminado (cobrado o cancelado). Forzar un reintento sería revivirlo. */
+    RetryIntentStatus["ALREADY_TERMINAL"] = "ALREADY_TERMINAL";
+    RetryIntentStatus["NOT_FOUND"] = "NOT_FOUND";
+})(RetryIntentStatus || (exports.RetryIntentStatus = RetryIntentStatus = {}));

package/bin/collection/index.d.ts

@@ -5,6 +5,9 @@ export * from './enums/CollectionResultStatus';
 export * from './enums/DeregisterChargeStatus';
 export * from './enums/RegisterCollectibleStatus';
 export * from './enums/CollectionFeeMode';
+export * from './enums/RetryIntentStatus';
+export * from './enums/AckIntentStatus';
+export * from './enums/RedriveOutboxStatus';
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';
 export * from './dtos/CollectResponse';

package/bin/collection/index.js

@@ -22,6 +22,9 @@ __exportStar(require("./enums/CollectionResultStatus"), exports);
 __exportStar(require("./enums/DeregisterChargeStatus"), exports);
 __exportStar(require("./enums/RegisterCollectibleStatus"), exports);
 __exportStar(require("./enums/CollectionFeeMode"), exports);
+__exportStar(require("./enums/RetryIntentStatus"), exports);
+__exportStar(require("./enums/AckIntentStatus"), exports);
+__exportStar(require("./enums/RedriveOutboxStatus"), exports);
 // DTOs
 __exportStar(require("./dtos/PendingChargeDto"), exports);
 __exportStar(require("./dtos/CollectRequest"), exports);

package/package.json

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

package/src/collection/dtos/CollectRequest.ts

@@ -1,4 +1,6 @@
-import { IsString, IsNumber } from 'class-validator';
+import { IsString, IsNumber, IsOptional, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
+import { CollectionPricingDto } from './CollectionPricingDto';
 
 /**
  * Cobro inmediato y síncrono, con el importe ya resuelto por el dominio.
@@ -16,4 +18,10 @@ export class CollectRequest {
   @IsString() productId!: string;
   @IsString() chargeId!: string;
   @IsNumber() amount!: number;
+
+  /**
+   * Tarifa con la que se cobra este cargo. Ausente, se aplica la configurada para la fuente — que es
+   * lo normal; se manda sólo cuando este cobro tiene condiciones propias.
+   */
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
 }

package/src/collection/dtos/CollectionAttemptDto.ts

@@ -1,4 +1,6 @@
-import { IsString, IsInt, IsEnum, IsOptional, IsNumber } from 'class-validator';
+import { IsString, IsInt, IsEnum, IsOptional, IsNumber, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
+import { CollectionPricingDto } from './CollectionPricingDto';
 import { MechanismType } from '../enums/MechanismType';
 import { CollectionResultStatus } from '../enums/CollectionResultStatus';
 
@@ -13,5 +15,13 @@ export class CollectionAttemptDto {
   @IsOptional() @IsEnum(CollectionResultStatus) result?: CollectionResultStatus;
   @IsOptional() @IsString() errorCode?: string;
   @IsOptional() @IsString() errorDetail?: string;
+
+  /**
+   * La tarifa que se aplicó en ESTE intento. Se guarda por intento y no se deduce de la config
+   * porque la config puede haber cambiado desde entonces, y sin esto no habría forma de reconstruir
+   * con qué comisión se cobró.
+   */
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
+  @IsOptional() @IsInt() collectionCycle?: number;
   @IsInt() createdAt!: number;                    // epoch ms
 }

package/src/collection/dtos/PendingChargeDto.ts

@@ -1,5 +1,7 @@
-import { IsString, IsInt, IsOptional, IsEnum, IsObject, IsNumber } from 'class-validator';
+import { IsString, IsInt, IsOptional, IsEnum, IsObject, IsNumber, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
 import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { CollectionPricingDto } from './CollectionPricingDto';
 
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
@@ -10,6 +12,11 @@ import { CurrencyId } from '../../currency/enums/CurrencyId';
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
+ *
+ * `pricing` sigue el mismo criterio que `amount`: las condiciones comerciales de una cartera las
+ * conoce el dominio, no el motor. Va por cargo y no por producto porque la misma mecánica de cobro
+ * puede tarifarse distinto para un cliente concreto —una promoción, un beneficio, la comisión
+ * perdonada de la primera cuota—. Ausente, el motor aplica la tarifa configurada para la fuente.
  */
 export class PendingChargeDto {
   @IsString() chargeId!: string;          // record_id / INSTALLMENT#n
@@ -27,5 +34,6 @@ export class PendingChargeDto {
   @IsOptional() @IsNumber() taxAmount?: number;
   @IsOptional() @IsNumber() outstandingBalance?: number;
   @IsOptional() @IsNumber() amountCollected?: number;
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
   @IsOptional() @IsObject() metadata?: Record<string, unknown>; // por-dominio (fiado_/loanco_interest, imei…)
 }

package/src/collection/enums/AckIntentStatus.ts

@@ -0,0 +1,8 @@
+/**
+ * Desenlace de dar por atendida la alerta de un intent. No tiene variante "terminal": reconocer una
+ * alerta es válido incluso sobre un intent que ya cerró después del problema que la disparó.
+ */
+export enum AckIntentStatus {
+  ACKED = 'ACKED',
+  NOT_FOUND = 'NOT_FOUND',
+}

package/src/collection/enums/RedriveOutboxStatus.ts

@@ -0,0 +1,8 @@
+/** Desenlace de reinyectar un evento atascado en la cola muerta. */
+export enum RedriveOutboxStatus {
+  /** El evento volvió a la cola de entrega y se reintentará. */
+  REDRIVEN = 'REDRIVEN',
+  /** El evento no estaba en la cola muerta: reinyectarlo duplicaría una entrega en curso. */
+  NOT_DLQ = 'NOT_DLQ',
+  NOT_FOUND = 'NOT_FOUND',
+}

package/src/collection/enums/RetryIntentStatus.ts

@@ -0,0 +1,8 @@
+/** Desenlace de un reintento forzado desde el panel de operación. */
+export enum RetryIntentStatus {
+  /** El intent estaba vivo y quedó reagendado para el próximo barrido. */
+  RETRIED = 'RETRIED',
+  /** El intent ya había terminado (cobrado o cancelado). Forzar un reintento sería revivirlo. */
+  ALREADY_TERMINAL = 'ALREADY_TERMINAL',
+  NOT_FOUND = 'NOT_FOUND',
+}

package/src/collection/index.ts

@@ -6,6 +6,9 @@ export * from './enums/CollectionResultStatus';
 export * from './enums/DeregisterChargeStatus';
 export * from './enums/RegisterCollectibleStatus';
 export * from './enums/CollectionFeeMode';
+export * from './enums/RetryIntentStatus';
+export * from './enums/AckIntentStatus';
+export * from './enums/RedriveOutboxStatus';
 
 // DTOs
 export * from './dtos/PendingChargeDto';