@fiado/api-invoker 5.15.0 → 5.17.0

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

@@ -0,0 +1,17 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { CollectRequest, CollectResponse, RegisterCollectibleRequest } 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>;
+/**
+ * Cliente concreto para los endpoints privados del `collection-engine-business` Lambda.
+ * Base URL viene de `COLLECTION_ENGINE_LAMBDA_URL`.
+ */
+export default class CollectionEngineApi implements ICollectionEngineApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>>;
+    deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>>;
+}
+export {};

package/bin/{membership/MembershipApi.js → collection-engine/api/CollectionEngineApi.js}

@@ -11,22 +11,32 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
-import dotenv from 'dotenv';
-dotenv.config();
-let MembershipApi = class MembershipApi {
+/**
+ * Cliente concreto para los endpoints privados del `collection-engine-business` Lambda.
+ * Base URL viene de `COLLECTION_ENGINE_LAMBDA_URL`.
+ */
+let CollectionEngineApi = class CollectionEngineApi {
     httpRequest;
-    baseUrl = process.env.MEMBERSHIP_BUSINESS_LAMBDA_URL || "";
+    baseUrl = process.env.COLLECTION_ENGINE_LAMBDA_URL || "";
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
-    async deleteByDirectoryId(directoryId) {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
-        return await this.httpRequest.delete(url);
+    async collect(request) {
+        const url = `${this.baseUrl}collection/collect`;
+        return await this.httpRequest.post(url, request);
+    }
+    async registerCollectible(request) {
+        const url = `${this.baseUrl}collection/register`;
+        return await this.httpRequest.post(url, request);
+    }
+    async deregister(ownerRef, productId, chargeId) {
+        const url = `${this.baseUrl}collection/deregister`;
+        return await this.httpRequest.post(url, { ownerRef, productId, chargeId });
     }
 };
-MembershipApi = __decorate([
+CollectionEngineApi = __decorate([
     injectable(),
     __param(0, inject("IHttpRequest")),
     __metadata("design:paramtypes", [Object])
-], MembershipApi);
-export { MembershipApi };
+], CollectionEngineApi);
+export default CollectionEngineApi;

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

@@ -0,0 +1,30 @@
+import { CollectRequest, CollectResponse, RegisterCollectibleRequest } 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`.
+ *
+ * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
+ * El motor es agnóstico de proveedores/cuentas — los dominios (une-credit,
+ * surekeep-retail, etc.) sólo hablan el contrato genérico de `PendingCharge`.
+ */
+export interface ICollectionEngineApi {
+    /**
+     * Cobro on-demand síncrono. El dominio pide al motor que intente cobrar
+     * un cargo puntual (fuera del barrido normal de la cascada).
+     * Backend: POST /collection/collect (privado VPC).
+     */
+    collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
+    /**
+     * Alta de un cargo cobrable en el índice del motor. Lo invoca el dominio
+     * dueño cuando nace una deuda cobrable (installment, cuota, etc.).
+     * Backend: POST /collection/register (privado VPC).
+     */
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>>;
+    /**
+     * Baja de un cargo del índice del motor (equivalente a cancelar el intent
+     * en curso). Lo invoca el dominio dueño cuando el cargo deja de ser cobrable.
+     * Backend: POST /collection/deregister (privado VPC).
+     */
+    deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>>;
+}
+export {};

package/bin/collection-engine/index.d.ts

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

package/bin/collection-engine/index.js

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

package/bin/container.config.js

@@ -128,6 +128,8 @@ import { ResearchSheetsApi } from "./research-sheets/index.js";
 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);
@@ -271,4 +273,8 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // KYC verifications business — lectura confirmatoria server-side del KYC por directoryId.
     // La consume el wizard de SureKeep F2 tras el aviso async del stream de `KycVerifications`.
     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/{notificationWebsockets/NotificationWebsocketApi.js → domain-callback/api/DomainCallbackApi.js}

@@ -11,22 +11,24 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
-import dotenv from 'dotenv';
-dotenv.config();
-let NotificationWebsocketApi = class NotificationWebsocketApi {
+/**
+ * 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;
-    baseUrl = process.env.NOTIFICATIONS_WEBSOCKET_LAMBDA_URL || "";
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
-    async deleteByDirectoryId(directoryId) {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
-        return await this.httpRequest.delete(url);
+    async applyCollectionResult(baseUrl, request) {
+        const url = `${baseUrl.replace(/\/+$/, "")}/collection/apply-result`;
+        return await this.httpRequest.post(url, request);
     }
 };
-NotificationWebsocketApi = __decorate([
+DomainCallbackApi = __decorate([
     injectable(),
     __param(0, inject("IHttpRequest")),
     __metadata("design:paramtypes", [Object])
-], NotificationWebsocketApi);
-export { NotificationWebsocketApi };
+], 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/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

@@ -106,3 +106,5 @@ export * from "./beneficiary/index.js";
 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

@@ -106,3 +106,5 @@ export * from "./beneficiary/index.js";
 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/transactionProcessor/api/TransactionProcessorApi.d.ts

@@ -1,9 +1,10 @@
 import { ITransactionProcessorApi } from "./interfaces/ITransactionProcessorApi.js";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { AuthorizeCollectorOrderRequest, AuthorizeCollectorOrderResponse, AuthorizeCollectorTransactionRequest, AuthorizeCreditCardPurchaseRequest, AuthorizeSpeiBankTransferNcRequest, AuthorizeSpeiMexBankTransferInRequest, AuthorizeRenewalPreAuthRequest, AuthorizeRenewalPreAuthResponse } from "@fiado/type-kit/bin/transactionProcessor/index.js";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ValidateWalletFundingRequest, ValidateWalletFundingResponse, CreditWalletFundingRequest, CreditWalletFundingResponse, ReverseWalletFundingRequest, ReverseWalletFundingResponse, GetWalletFundingLimitRequest, GetWalletFundingLimitResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { AuthorizeCollectionMovementRequest, AuthorizeCollectionMovementResponse } from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 export default class TransactionProcessorApi implements ITransactionProcessorApi {
@@ -22,5 +23,6 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
     walletFundingReverse(request: ReverseWalletFundingRequest): Promise<ApiGatewayResponse<ReverseWalletFundingResponse>>;
     walletFundingGetLimit(request: GetWalletFundingLimitRequest): Promise<ApiGatewayResponse<GetWalletFundingLimitResponse>>;
     creditBack(request: RemittanceCreditBackRequest): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
+    authorizeCollectionMovement(request: AuthorizeCollectionMovementRequest): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>>;
 }
 export {};

package/bin/transactionProcessor/api/TransactionProcessorApi.js

@@ -65,6 +65,10 @@ let TransactionProcessorApi = class TransactionProcessorApi {
         const url = `${this.baseUrl}remittance/credit-back`;
         return await this.httpRequest.post(url, request);
     }
+    async authorizeCollectionMovement(request) {
+        const url = `${this.baseUrl}collection/authorize`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 TransactionProcessorApi = __decorate([
     injectable(),

package/bin/transactionProcessor/api/interfaces/ITransactionProcessorApi.d.ts

@@ -3,6 +3,7 @@ import { AuthorizeCollectorOrderRequest, AuthorizeCollectorOrderResponse, Author
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ValidateWalletFundingRequest, ValidateWalletFundingResponse, CreditWalletFundingRequest, CreditWalletFundingResponse, ReverseWalletFundingRequest, ReverseWalletFundingResponse, GetWalletFundingLimitRequest, GetWalletFundingLimitResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { AuthorizeCollectionMovementRequest, AuthorizeCollectionMovementResponse } from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 export interface ITransactionProcessorApi {
     authorizeTransaction(request: AuthorizeCreditCardPurchaseRequest): Promise<any>;
@@ -43,5 +44,15 @@ export interface ITransactionProcessorApi {
      * Backend: POST /transaction-processor/remittance/credit-back (privado VPC).
      */
     creditBack(request: RemittanceCreditBackRequest): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
+    /**
+     * Autoriza un movimiento de cobro pedido por el motor de cobro central
+     * (collection-engine-business). Endpoint nuevo y aditivo — reusa
+     * internamente los ejecutores ya existentes (executeFinancialOperation
+     * para el lock del pocket USD preauth, updateAccountBalance para
+     * principal USD/MXN). No altera los rails existentes de la app.
+     * Backend: POST /transaction-processor/collection/authorize (privado VPC).
+     * Idempotente por `executionId` (@IdempotencyController).
+     */
+    authorizeCollectionMovement(request: AuthorizeCollectionMovementRequest): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>>;
 }
 export {};

package/package.json

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

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

@@ -0,0 +1,38 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import {
+    CollectRequest,
+    CollectResponse,
+    RegisterCollectibleRequest,
+} 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>;
+
+/**
+ * Cliente concreto para los endpoints privados del `collection-engine-business` Lambda.
+ * Base URL viene de `COLLECTION_ENGINE_LAMBDA_URL`.
+ */
+@injectable()
+export default class CollectionEngineApi implements ICollectionEngineApi {
+
+    private readonly baseUrl = process.env.COLLECTION_ENGINE_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>> {
+        const url = `${this.baseUrl}collection/collect`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>> {
+        const url = `${this.baseUrl}collection/register`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>> {
+        const url = `${this.baseUrl}collection/deregister`;
+        return await this.httpRequest.post(url, { ownerRef, productId, chargeId });
+    }
+}

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

@@ -0,0 +1,38 @@
+import {
+    CollectRequest,
+    CollectResponse,
+    RegisterCollectibleRequest,
+} 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`.
+ *
+ * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
+ * El motor es agnóstico de proveedores/cuentas — los dominios (une-credit,
+ * surekeep-retail, etc.) sólo hablan el contrato genérico de `PendingCharge`.
+ */
+export interface ICollectionEngineApi {
+
+    /**
+     * Cobro on-demand síncrono. El dominio pide al motor que intente cobrar
+     * un cargo puntual (fuera del barrido normal de la cascada).
+     * Backend: POST /collection/collect (privado VPC).
+     */
+    collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
+
+    /**
+     * Alta de un cargo cobrable en el índice del motor. Lo invoca el dominio
+     * dueño cuando nace una deuda cobrable (installment, cuota, etc.).
+     * Backend: POST /collection/register (privado VPC).
+     */
+    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>>;
+
+    /**
+     * Baja de un cargo del índice del motor (equivalente a cancelar el intent
+     * en curso). Lo invoca el dominio dueño cuando el cargo deja de ser cobrable.
+     * Backend: POST /collection/deregister (privado VPC).
+     */
+    deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>>;
+}

package/src/collection-engine/index.ts

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

package/src/container.config.ts

@@ -192,6 +192,13 @@ import { IResearchSheetsApi, ResearchSheetsApi } from "./research-sheets/index.j
 import { IAuthBusinessApi, AuthBusinessApi } from "./auth-business/index.js";
 // KYC verifications business — lectura confirmatoria server-side del KYC por directoryId (SureKeep F2)
 import { IKycVerificationsBusinessApi, KycVerificationsBusinessApi } from "./kyc/index.js";
+// 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
@@ -358,4 +365,10 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // KYC verifications business — lectura confirmatoria server-side del KYC por directoryId.
     // La consume el wizard de SureKeep F2 tras el aviso async del stream de `KycVerifications`.
     bind<IKycVerificationsBusinessApi>("IKycVerificationsBusinessApi").to(KycVerificationsBusinessApi);
+
+    // 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

@@ -106,3 +106,5 @@ export * from "./beneficiary/index.js";
 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/src/transactionProcessor/api/TransactionProcessorApi.ts

@@ -1,6 +1,6 @@
 import { ITransactionProcessorApi } from "./interfaces/ITransactionProcessorApi.js";
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import {
     AuthorizeCollectorOrderRequest,
     AuthorizeCollectorOrderResponse,
@@ -22,6 +22,10 @@ import {
     GetWalletFundingLimitResponse,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import {
+    AuthorizeCollectionMovementRequest,
+    AuthorizeCollectionMovementResponse,
+} from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 
@@ -102,4 +106,11 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
         const url = `${this.baseUrl}remittance/credit-back`;
         return await this.httpRequest.post(url, request);
     }
+
+    async authorizeCollectionMovement(
+        request: AuthorizeCollectionMovementRequest,
+    ): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>> {
+        const url = `${this.baseUrl}collection/authorize`;
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/transactionProcessor/api/interfaces/ITransactionProcessorApi.ts

@@ -21,6 +21,10 @@ import {
     GetWalletFundingLimitResponse,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import {
+    AuthorizeCollectionMovementRequest,
+    AuthorizeCollectionMovementResponse,
+} from "@fiado/type-kit/bin/collection/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 
 export interface ITransactionProcessorApi {
@@ -84,4 +88,17 @@ export interface ITransactionProcessorApi {
     creditBack(
         request: RemittanceCreditBackRequest,
     ): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
+
+    /**
+     * Autoriza un movimiento de cobro pedido por el motor de cobro central
+     * (collection-engine-business). Endpoint nuevo y aditivo — reusa
+     * internamente los ejecutores ya existentes (executeFinancialOperation
+     * para el lock del pocket USD preauth, updateAccountBalance para
+     * principal USD/MXN). No altera los rails existentes de la app.
+     * Backend: POST /transaction-processor/collection/authorize (privado VPC).
+     * Idempotente por `executionId` (@IdempotencyController).
+     */
+    authorizeCollectionMovement(
+        request: AuthorizeCollectionMovementRequest,
+    ): Promise<FiadoApiResponse<AuthorizeCollectionMovementResponse>>;
 }

package/bin/membership/MembershipApi.d.ts

@@ -1,12 +0,0 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { IMembershipApi } from "./interfaces/IMembershipApi.js";
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-export declare class MembershipApi implements IMembershipApi {
-    private httpRequest;
-    private readonly baseUrl;
-    constructor(httpRequest: IHttpRequest);
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/membership/index.d.ts

@@ -1,2 +0,0 @@
-export * from './interfaces/IMembershipApi.js';
-export * from './MembershipApi.js';

package/bin/membership/index.js

@@ -1,2 +0,0 @@
-export * from './interfaces/IMembershipApi.js';
-export * from './MembershipApi.js';

package/bin/membership/interfaces/IMembershipApi.d.ts

@@ -1,15 +0,0 @@
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-/**
- * Interfaz para el servicio Membership (membership-business).
- */
-export interface IMembershipApi {
-    /**
-     * Borra en cascada las membresías asociadas a un directoryId.
-     * @param directoryId ID del directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/notificationWebsockets/NotificationWebsocketApi.d.ts

@@ -1,12 +0,0 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { INotificationWebsocketApi } from "./interfaces/INotificationWebsocketApi.js";
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-export declare class NotificationWebsocketApi implements INotificationWebsocketApi {
-    private httpRequest;
-    private readonly baseUrl;
-    constructor(httpRequest: IHttpRequest);
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.d.ts

@@ -1,15 +0,0 @@
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-/**
- * Interfaz para el servicio Notifications Websocket (notifications-websocket).
- */
-export interface INotificationWebsocketApi {
-    /**
-     * Borra en cascada las conexiones/notificaciones WS asociadas a un directoryId.
-     * @param directoryId ID del directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/performance-profile/PerformanceProfileApi.d.ts

@@ -1,12 +0,0 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { IPerformanceProfileApi } from "./interfaces/IPerformanceProfileApi.js";
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-export declare class PerformanceProfileApi implements IPerformanceProfileApi {
-    private httpRequest;
-    private readonly baseUrl;
-    constructor(httpRequest: IHttpRequest);
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/performance-profile/PerformanceProfileApi.js

@@ -1,32 +0,0 @@
-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";
-import dotenv from 'dotenv';
-dotenv.config();
-let PerformanceProfileApi = class PerformanceProfileApi {
-    httpRequest;
-    baseUrl = process.env.PERFORMANCE_PROFILE_BUSINESS_LAMBDA_URL || "";
-    constructor(httpRequest) {
-        this.httpRequest = httpRequest;
-    }
-    async deleteByDirectoryId(directoryId) {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
-        return await this.httpRequest.delete(url);
-    }
-};
-PerformanceProfileApi = __decorate([
-    injectable(),
-    __param(0, inject("IHttpRequest")),
-    __metadata("design:paramtypes", [Object])
-], PerformanceProfileApi);
-export { PerformanceProfileApi };

package/bin/performance-profile/index.d.ts

@@ -1,2 +0,0 @@
-export * from './interfaces/IPerformanceProfileApi.js';
-export * from './PerformanceProfileApi.js';

package/bin/performance-profile/index.js

@@ -1,2 +0,0 @@
-export * from './interfaces/IPerformanceProfileApi.js';
-export * from './PerformanceProfileApi.js';

package/bin/performance-profile/interfaces/IPerformanceProfileApi.d.ts

@@ -1,15 +0,0 @@
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-/**
- * Interfaz para el servicio Performance Profile (performance-profile-business).
- */
-export interface IPerformanceProfileApi {
-    /**
-     * Borra en cascada los perfiles de desempeño asociados a un directoryId.
-     * @param directoryId ID del directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/performance-profile/interfaces/IPerformanceProfileApi.js

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

package/bin/presence-websocket/PresenceWebsocketApi.d.ts

@@ -1,12 +0,0 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { IPresenceWebsocketApi } from "./interfaces/IPresenceWebsocketApi.js";
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-export declare class PresenceWebsocketApi implements IPresenceWebsocketApi {
-    private httpRequest;
-    private readonly baseUrl;
-    constructor(httpRequest: IHttpRequest);
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/presence-websocket/PresenceWebsocketApi.js

@@ -1,32 +0,0 @@
-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";
-import dotenv from 'dotenv';
-dotenv.config();
-let PresenceWebsocketApi = class PresenceWebsocketApi {
-    httpRequest;
-    baseUrl = process.env.PRESENCE_WEBSOCKET_LAMBDA_URL || "";
-    constructor(httpRequest) {
-        this.httpRequest = httpRequest;
-    }
-    async deleteByDirectoryId(directoryId) {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
-        return await this.httpRequest.delete(url);
-    }
-};
-PresenceWebsocketApi = __decorate([
-    injectable(),
-    __param(0, inject("IHttpRequest")),
-    __metadata("design:paramtypes", [Object])
-], PresenceWebsocketApi);
-export { PresenceWebsocketApi };

package/bin/presence-websocket/index.d.ts

@@ -1,2 +0,0 @@
-export * from './interfaces/IPresenceWebsocketApi.js';
-export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/index.js

@@ -1,2 +0,0 @@
-export * from './interfaces/IPresenceWebsocketApi.js';
-export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.d.ts

@@ -1,15 +0,0 @@
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-/**
- * Interfaz para el servicio Presence Websocket (presence-websocket).
- */
-export interface IPresenceWebsocketApi {
-    /**
-     * Borra en cascada los registros de presencia asociados a un directoryId.
-     * @param directoryId ID del directorio.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
-        deletedCount: number;
-    }>>;
-}
-export {};

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.js

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