@fiado/api-invoker 5.51.0 → 5.52.0

package/bin/collection-engine/api/CollectionEngineApi.d.ts

@@ -1,5 +1,5 @@
 import type { IHttpRequest } from "@fiado/http-client";
-import { CollectRequest, CollectResponse, DeregisterChargeResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
@@ -10,6 +10,7 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
     collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
     deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
 }

package/bin/collection-engine/api/CollectionEngineApi.js

@@ -21,6 +21,10 @@ let CollectionEngineApi = class CollectionEngineApi {
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
+    async registerCollectible(request) {
+        const url = `${this.baseUrl}collection/register`;
+        return await this.httpRequest.post(url, request);
+    }
     async collect(request) {
         const url = `${this.baseUrl}collection/collect`;
         return await this.httpRequest.post(url, request);

package/bin/collection-engine/api/interfaces/ICollectionEngineApi.d.ts

@@ -1,4 +1,4 @@
-import { CollectRequest, CollectResponse, DeregisterChargeResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
  * Cliente para invocar los endpoints privados del lambda `collection-engine-business`.
@@ -6,12 +6,22 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
  * El motor es agnóstico de proveedores y cuentas: el dominio dice QUÉ se debe y el motor
  * decide de dónde cobrarlo según la config del producto.
- *
- * El alta explícita de un cargo cobrable (`registerCollectible`) todavía no existe en el
- * motor: hoy `collect` crea el intent si no lo había, derivando su identidad de
- * `domain#chargeId`. El método se reincorporará cuando el motor exponga la ruta.
  */
 export interface ICollectionEngineApi {
+    /**
+     * Alta de un cargo cobrable: el dominio avisa de que hay algo que cobrar, sin decir cuánto.
+     * El importe se le pregunta después, al ir a cobrarlo (`/collection/resolve-charges`), porque
+     * entre el alta y el cobro puede haber cambiado —por mora, o porque el cliente pagó por otra vía.
+     *
+     * A partir del alta, el cargo entra en los reintentos del motor: se cobra en cuanto el titular
+     * tiene saldo, sin que el dominio tenga que volver a pedirlo.
+     *
+     * Idempotente por `domain#chargeId`: repetir el alta devuelve `ALREADY_REGISTERED` con el mismo
+     * `intentId`, sin duplicar nada.
+     *
+     * Backend: POST /collection/register (privado VPC).
+     */
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
     /**
      * Cobro on-demand síncrono. El dominio manda el cargo ya resuelto y el motor recorre la
      * cascada de fuentes configurada para el producto. Idempotente por `domain#chargeId`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.51.0",
+  "version": "5.52.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.373.0",
+    "@fiado/type-kit": "^3.375.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/collection-engine/api/CollectionEngineApi.ts

@@ -4,6 +4,8 @@ import {
     CollectRequest,
     CollectResponse,
     DeregisterChargeResponse,
+    RegisterCollectibleRequest,
+    RegisterCollectibleResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 
@@ -21,6 +23,11 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
     }
 
+    async registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>> {
+        const url = `${this.baseUrl}collection/register`;
+        return await this.httpRequest.post(url, request);
+    }
+
     async collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>> {
         const url = `${this.baseUrl}collection/collect`;
         return await this.httpRequest.post(url, request);

package/src/collection-engine/api/interfaces/ICollectionEngineApi.ts

@@ -2,6 +2,8 @@ import {
     CollectRequest,
     CollectResponse,
     DeregisterChargeResponse,
+    RegisterCollectibleRequest,
+    RegisterCollectibleResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
@@ -12,13 +14,24 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
  * El motor es agnóstico de proveedores y cuentas: el dominio dice QUÉ se debe y el motor
  * decide de dónde cobrarlo según la config del producto.
- *
- * El alta explícita de un cargo cobrable (`registerCollectible`) todavía no existe en el
- * motor: hoy `collect` crea el intent si no lo había, derivando su identidad de
- * `domain#chargeId`. El método se reincorporará cuando el motor exponga la ruta.
  */
 export interface ICollectionEngineApi {
 
+    /**
+     * Alta de un cargo cobrable: el dominio avisa de que hay algo que cobrar, sin decir cuánto.
+     * El importe se le pregunta después, al ir a cobrarlo (`/collection/resolve-charges`), porque
+     * entre el alta y el cobro puede haber cambiado —por mora, o porque el cliente pagó por otra vía.
+     *
+     * A partir del alta, el cargo entra en los reintentos del motor: se cobra en cuanto el titular
+     * tiene saldo, sin que el dominio tenga que volver a pedirlo.
+     *
+     * Idempotente por `domain#chargeId`: repetir el alta devuelve `ALREADY_REGISTERED` con el mismo
+     * `intentId`, sin duplicar nada.
+     *
+     * Backend: POST /collection/register (privado VPC).
+     */
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
+
     /**
      * Cobro on-demand síncrono. El dominio manda el cargo ya resuelto y el motor recorre la
      * cascada de fuentes configurada para el producto. Idempotente por `domain#chargeId`: