@fiado/type-kit 3.370.0 → 3.372.0

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

@@ -0,0 +1,24 @@
+/**
+ * Aviso de que a un titular le entró dinero.
+ *
+ * Lo publica el procesador de transacciones al registrar cualquier ingreso, y lo consume el motor de
+ * cobro para reintentar en el acto los cobros que habían quedado esperando fondos. Sin este aviso el
+ * motor sólo se entera cuando su barrido programado vuelve a pasar.
+ *
+ * Es una notificación, no una orden de cobro: dice que hay saldo nuevo, y es el motor quien decide
+ * si eso alcanza para algo y a qué cargos aplicarlo.
+ */
+export declare class MoneyInEvent {
+    /** Titular que recibió el dinero. */
+    ownerRef: string;
+    tenantId: string;
+    /** Proveedor de la wallet donde entró — el motor lo usa para saber qué fuentes reintentar. */
+    provider: string;
+    currencyId: string;
+    /** Importe del ingreso, en la moneda de la wallet. */
+    amount: number;
+    /** Referencia del movimiento que lo originó, para poder seguirle el rastro. */
+    transactionId?: string;
+    /** Momento del ingreso, epoch en milisegundos. */
+    occurredAt?: number;
+}

package/bin/collection/dtos/MoneyInEvent.js

@@ -0,0 +1,56 @@
+"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.MoneyInEvent = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Aviso de que a un titular le entró dinero.
+ *
+ * Lo publica el procesador de transacciones al registrar cualquier ingreso, y lo consume el motor de
+ * cobro para reintentar en el acto los cobros que habían quedado esperando fondos. Sin este aviso el
+ * motor sólo se entera cuando su barrido programado vuelve a pasar.
+ *
+ * Es una notificación, no una orden de cobro: dice que hay saldo nuevo, y es el motor quien decide
+ * si eso alcanza para algo y a qué cargos aplicarlo.
+ */
+class MoneyInEvent {
+}
+exports.MoneyInEvent = MoneyInEvent;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyInEvent.prototype, "ownerRef", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyInEvent.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyInEvent.prototype, "provider", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyInEvent.prototype, "currencyId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], MoneyInEvent.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyInEvent.prototype, "transactionId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], MoneyInEvent.prototype, "occurredAt", void 0);

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

@@ -0,0 +1,12 @@
+/**
+ * El motor pregunta al dominio qué debe un titular ahora mismo.
+ *
+ * No lleva importe: el monto es justo lo que se está preguntando. Puede haber cambiado desde que el
+ * cargo se dio de alta —por mora, o porque el cliente pagó por otra vía— y sólo el dominio, que es
+ * quien aplica sus propias reglas, sabe cuánto queda vivo.
+ */
+export declare class ResolvePendingChargesRequest {
+    domain: string;
+    ownerRef: string;
+    tenantId: string;
+}

package/bin/collection/dtos/ResolvePendingChargesRequest.js

@@ -0,0 +1,35 @@
+"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.ResolvePendingChargesRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * El motor pregunta al dominio qué debe un titular ahora mismo.
+ *
+ * No lleva importe: el monto es justo lo que se está preguntando. Puede haber cambiado desde que el
+ * cargo se dio de alta —por mora, o porque el cliente pagó por otra vía— y sólo el dominio, que es
+ * quien aplica sus propias reglas, sabe cuánto queda vivo.
+ */
+class ResolvePendingChargesRequest {
+}
+exports.ResolvePendingChargesRequest = ResolvePendingChargesRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ResolvePendingChargesRequest.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ResolvePendingChargesRequest.prototype, "ownerRef", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ResolvePendingChargesRequest.prototype, "tenantId", void 0);

package/bin/collection/index.d.ts

@@ -16,6 +16,8 @@ export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
 export * from './dtos/DeregisterChargeResponse';
+export * from './dtos/ResolvePendingChargesRequest';
+export * from './dtos/MoneyInEvent';
 export * from './dtos/CollectionIntentSummaryDto';
 export * from './dtos/CollectionAttemptDto';
 export * from './dtos/CollectionOutboxEventDto';

package/bin/collection/index.js

@@ -34,6 +34,8 @@ __exportStar(require("./dtos/CollectionProductConfigDto"), exports);
 __exportStar(require("./dtos/UpsertProductConfigRequest"), exports);
 __exportStar(require("./dtos/ApplyCollectionResultRequest"), exports);
 __exportStar(require("./dtos/DeregisterChargeResponse"), exports);
+__exportStar(require("./dtos/ResolvePendingChargesRequest"), exports);
+__exportStar(require("./dtos/MoneyInEvent"), exports);
 // DTOs — backoffice de monitoreo
 __exportStar(require("./dtos/CollectionIntentSummaryDto"), exports);
 __exportStar(require("./dtos/CollectionAttemptDto"), exports);

package/package.json

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

package/src/collection/dtos/MoneyInEvent.ts

@@ -0,0 +1,32 @@
+import { IsNumber, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Aviso de que a un titular le entró dinero.
+ *
+ * Lo publica el procesador de transacciones al registrar cualquier ingreso, y lo consume el motor de
+ * cobro para reintentar en el acto los cobros que habían quedado esperando fondos. Sin este aviso el
+ * motor sólo se entera cuando su barrido programado vuelve a pasar.
+ *
+ * Es una notificación, no una orden de cobro: dice que hay saldo nuevo, y es el motor quien decide
+ * si eso alcanza para algo y a qué cargos aplicarlo.
+ */
+export class MoneyInEvent {
+  /** Titular que recibió el dinero. */
+  @IsString() ownerRef!: string;
+
+  @IsString() tenantId!: string;
+
+  /** Proveedor de la wallet donde entró — el motor lo usa para saber qué fuentes reintentar. */
+  @IsString() provider!: string;
+
+  @IsString() currencyId!: string;
+
+  /** Importe del ingreso, en la moneda de la wallet. */
+  @IsNumber() amount!: number;
+
+  /** Referencia del movimiento que lo originó, para poder seguirle el rastro. */
+  @IsOptional() @IsString() transactionId?: string;
+
+  /** Momento del ingreso, epoch en milisegundos. */
+  @IsOptional() @IsNumber() occurredAt?: number;
+}

package/src/collection/dtos/ResolvePendingChargesRequest.ts

@@ -0,0 +1,14 @@
+import { IsString } from 'class-validator';
+
+/**
+ * El motor pregunta al dominio qué debe un titular ahora mismo.
+ *
+ * No lleva importe: el monto es justo lo que se está preguntando. Puede haber cambiado desde que el
+ * cargo se dio de alta —por mora, o porque el cliente pagó por otra vía— y sólo el dominio, que es
+ * quien aplica sus propias reglas, sabe cuánto queda vivo.
+ */
+export class ResolvePendingChargesRequest {
+  @IsString() domain!: string;
+  @IsString() ownerRef!: string;
+  @IsString() tenantId!: string;
+}

package/src/collection/index.ts

@@ -19,6 +19,8 @@ export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
 export * from './dtos/DeregisterChargeResponse';
+export * from './dtos/ResolvePendingChargesRequest';
+export * from './dtos/MoneyInEvent';
 
 // DTOs — backoffice de monitoreo
 export * from './dtos/CollectionIntentSummaryDto';