@fiado/api-invoker 5.16.0 → 5.17.0

package/bin/container.config.js

@@ -129,6 +129,7 @@ import { AuthBusinessApi } from "./auth-business/index.js";
 // KYC verifications business — lectura confirmatoria server-side del KYC por directoryId (SureKeep F2)
 import { KycVerificationsBusinessApi } from "./kyc/index.js";
 import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js";
+import DomainCallbackApi from "./domain-callback/api/DomainCallbackApi.js";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -274,4 +275,6 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IKycVerificationsBusinessApi").to(KycVerificationsBusinessApi);
     // Collection engine — motor de cobro central multitenant (collect/registerCollectible/deregister)
     bind("ICollectionEngineApi").to(CollectionEngineApi);
+    // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)
+    bind("IDomainCallbackApi").to(DomainCallbackApi);
 });

package/bin/domain-callback/api/DomainCallbackApi.d.ts

@@ -0,0 +1,15 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { ApplyCollectionResultRequest } from "@fiado/type-kit/bin/collection/index.js";
+import { IDomainCallbackApi } from "./interfaces/IDomainCallbackApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Cliente genérico del callback de cobro (motor → dominio). La baseUrl no viene de una env
+ * fija del constructor: el motor la resuelve por `domain` (registry `domain→API`) y la pasa
+ * en cada llamada, así este mismo cliente sirve para cualquier dominio consumidor.
+ */
+export default class DomainCallbackApi implements IDomainCallbackApi {
+    private httpRequest;
+    constructor(httpRequest: IHttpRequest);
+    applyCollectionResult(baseUrl: string, request: ApplyCollectionResultRequest): Promise<FiadoApiResponse<boolean>>;
+}
+export {};

package/bin/domain-callback/api/DomainCallbackApi.js

@@ -0,0 +1,34 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+/**
+ * Cliente genérico del callback de cobro (motor → dominio). La baseUrl no viene de una env
+ * fija del constructor: el motor la resuelve por `domain` (registry `domain→API`) y la pasa
+ * en cada llamada, así este mismo cliente sirve para cualquier dominio consumidor.
+ */
+let DomainCallbackApi = class DomainCallbackApi {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async applyCollectionResult(baseUrl, request) {
+        const url = `${baseUrl.replace(/\/+$/, "")}/collection/apply-result`;
+        return await this.httpRequest.post(url, request);
+    }
+};
+DomainCallbackApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], DomainCallbackApi);
+export default DomainCallbackApi;

package/bin/domain-callback/api/interfaces/IDomainCallbackApi.d.ts

@@ -0,0 +1,19 @@
+import { ApplyCollectionResultRequest } from "@fiado/type-kit/bin/collection/index.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Cliente genérico que usa el motor de cobro central para notificar a cualquier dominio
+ * consumidor (une-credit, surekeep-retail, etc.) el resultado de un cobro (total o parcial).
+ *
+ * A diferencia del resto de los Api de la lib, la baseUrl NO sale de una env fija del
+ * constructor: el dispatcher del outbox la resuelve por `domain` (registry `domain→API`,
+ * SSM/env) y la pasa por llamada — cada dominio consumidor implementa este mismo endpoint.
+ */
+export interface IDomainCallbackApi {
+    /**
+     * Notifica el resultado de un intento de cobro (FULL/PARTIAL/NONE) al dominio dueño
+     * del cargo. El dominio lo aplica idempotente a su ledger (dedupe por `attemptId`).
+     * Backend: POST {baseUrl}/collection/apply-result (privado VPC, expuesto por el dominio).
+     */
+    applyCollectionResult(baseUrl: string, request: ApplyCollectionResultRequest): Promise<FiadoApiResponse<boolean>>;
+}
+export {};

package/bin/domain-callback/api/interfaces/IDomainCallbackApi.js

@@ -0,0 +1 @@
+export {};

package/bin/domain-callback/index.d.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IDomainCallbackApi.js';
+export * from './api/DomainCallbackApi.js';

package/bin/domain-callback/index.js

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IDomainCallbackApi.js';
+export * from './api/DomainCallbackApi.js';

package/bin/index.d.ts

@@ -107,3 +107,4 @@ export * from "./research-sheets/index.js";
 export * from "./auth-business/index.js";
 export * from "./kyc/index.js";
 export * from "./collection-engine/index.js";
+export * from "./domain-callback/index.js";

package/bin/index.js

@@ -107,3 +107,4 @@ export * from "./research-sheets/index.js";
 export * from "./auth-business/index.js";
 export * from "./kyc/index.js";
 export * from "./collection-engine/index.js";
+export * from "./domain-callback/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.16.0",
+  "version": "5.17.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.265.0",
+    "@fiado/type-kit": "^3.272.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -195,6 +195,10 @@ import { IKycVerificationsBusinessApi, KycVerificationsBusinessApi } from "./kyc
 // Collection engine — cliente del motor de cobro central (collect/registerCollectible/deregister)
 import { ICollectionEngineApi } from "./collection-engine/index.js";
 import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js";
+// Domain callback — cliente genérico que usa el motor para notificar a cualquier dominio
+// consumidor el resultado de un cobro (applyCollectionResult); baseUrl viaja por llamada
+import { IDomainCallbackApi } from "./domain-callback/index.js";
+import DomainCallbackApi from "./domain-callback/api/DomainCallbackApi.js";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -364,4 +368,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
 
     // Collection engine — motor de cobro central multitenant (collect/registerCollectible/deregister)
     bind<ICollectionEngineApi>("ICollectionEngineApi").to(CollectionEngineApi);
+
+    // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)
+    bind<IDomainCallbackApi>("IDomainCallbackApi").to(DomainCallbackApi);
 });

package/src/domain-callback/api/DomainCallbackApi.ts

@@ -0,0 +1,23 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { ApplyCollectionResultRequest } from "@fiado/type-kit/bin/collection/index.js";
+import { IDomainCallbackApi } from "./interfaces/IDomainCallbackApi.js";
+
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+/**
+ * Cliente genérico del callback de cobro (motor → dominio). La baseUrl no viene de una env
+ * fija del constructor: el motor la resuelve por `domain` (registry `domain→API`) y la pasa
+ * en cada llamada, así este mismo cliente sirve para cualquier dominio consumidor.
+ */
+@injectable()
+export default class DomainCallbackApi implements IDomainCallbackApi {
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async applyCollectionResult(baseUrl: string, request: ApplyCollectionResultRequest): Promise<FiadoApiResponse<boolean>> {
+        const url = `${baseUrl.replace(/\/+$/, "")}/collection/apply-result`;
+        return await this.httpRequest.post(url, request);
+    }
+}

package/src/domain-callback/api/interfaces/IDomainCallbackApi.ts

@@ -0,0 +1,21 @@
+import { ApplyCollectionResultRequest } from "@fiado/type-kit/bin/collection/index.js";
+
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+/**
+ * Cliente genérico que usa el motor de cobro central para notificar a cualquier dominio
+ * consumidor (une-credit, surekeep-retail, etc.) el resultado de un cobro (total o parcial).
+ *
+ * A diferencia del resto de los Api de la lib, la baseUrl NO sale de una env fija del
+ * constructor: el dispatcher del outbox la resuelve por `domain` (registry `domain→API`,
+ * SSM/env) y la pasa por llamada — cada dominio consumidor implementa este mismo endpoint.
+ */
+export interface IDomainCallbackApi {
+
+    /**
+     * Notifica el resultado de un intento de cobro (FULL/PARTIAL/NONE) al dominio dueño
+     * del cargo. El dominio lo aplica idempotente a su ledger (dedupe por `attemptId`).
+     * Backend: POST {baseUrl}/collection/apply-result (privado VPC, expuesto por el dominio).
+     */
+    applyCollectionResult(baseUrl: string, request: ApplyCollectionResultRequest): Promise<FiadoApiResponse<boolean>>;
+}

package/src/domain-callback/index.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IDomainCallbackApi.js';
+export * from './api/DomainCallbackApi.js';

package/src/index.ts

@@ -107,3 +107,4 @@ export * from "./research-sheets/index.js";
 export * from "./auth-business/index.js";
 export * from "./kyc/index.js";
 export * from "./collection-engine/index.js";
+export * from "./domain-callback/index.js";