@fiado/api-invoker 5.14.0 → 5.16.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/{notificationWebsockets/NotificationWebsocketApi.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 NotificationWebsocketApi = class NotificationWebsocketApi {
+/**
+ * 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.NOTIFICATIONS_WEBSOCKET_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 });
     }
 };
-NotificationWebsocketApi = __decorate([
+CollectionEngineApi = __decorate([
     injectable(),
     __param(0, inject("IHttpRequest")),
     __metadata("design:paramtypes", [Object])
-], NotificationWebsocketApi);
-export { NotificationWebsocketApi };
+], 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

@@ -48,6 +48,7 @@ import TransactionAlertApi from "./riskProfile/api/TransactionAlertApi.js";
 import { DirectoriesApi } from "./directories/index.js";
 import CognitoConnectorApi from "./cognitoConnector/CognitoConnectorApi.js";
 import { ZendeskApi } from "./zendesk/index.js";
+import ZendeskAlertsPublisher from "./zendesk/queue/ZendeskAlertsPublisher.js";
 import { BlackListApi } from "./blacklist/index.js";
 import { DeviceApi } from "./device/index.js";
 import { ObservationsApi } from "./observations/index.js";
@@ -127,6 +128,7 @@ 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";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -182,6 +184,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("ICognitoConnectorApi").to(CognitoConnectorApi);
     bind("ICognitoV2Api").to(CognitoApi);
     bind("IZendeskApi").to(ZendeskApi);
+    bind("IZendeskAlertsPublisher").to(ZendeskAlertsPublisher);
     bind("IBlackListApi").to(BlackListApi);
     bind("IDeviceApi").to(DeviceApi);
     bind("IObservationsApi").to(ObservationsApi);
@@ -269,4 +272,6 @@ 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);
 });

package/bin/index.d.ts

@@ -106,3 +106,4 @@ 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";

package/bin/index.js

@@ -106,3 +106,4 @@ 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";

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/bin/zendesk/index.d.ts

@@ -1,2 +1,4 @@
 export * from './interfaces/IZendeskApi.js';
 export * from './ZendeskApi.js';
+export * from './queue/interfaces/IZendeskAlertsPublisher.js';
+export { default as ZendeskAlertsPublisher } from './queue/ZendeskAlertsPublisher.js';

package/bin/zendesk/index.js

@@ -1,2 +1,4 @@
 export * from './interfaces/IZendeskApi.js';
 export * from './ZendeskApi.js';
+export * from './queue/interfaces/IZendeskAlertsPublisher.js';
+export { default as ZendeskAlertsPublisher } from './queue/ZendeskAlertsPublisher.js';

package/bin/zendesk/queue/ZendeskAlertsPublisher.d.ts

@@ -0,0 +1,9 @@
+import { ZendeskInternalAlertRequest } from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+import { IZendeskAlertsPublisher } from "./interfaces/IZendeskAlertsPublisher.js";
+export default class ZendeskAlertsPublisher implements IZendeskAlertsPublisher {
+    private readonly ZENDESK_ALERTS_QUEUE;
+    createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void>;
+    sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void>;
+    private publish;
+}

package/bin/zendesk/queue/ZendeskAlertsPublisher.js

@@ -0,0 +1,37 @@
+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;
+};
+import { injectable } from "inversify";
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { ZendeskAlertKind } from "@fiado/type-kit/bin/helpdesk/index.js";
+let ZendeskAlertsPublisher = class ZendeskAlertsPublisher {
+    ZENDESK_ALERTS_QUEUE = process.env.ZENDESK_ALERTS_QUEUE;
+    async createInternalNote(alert) {
+        await this.publish({ kind: ZendeskAlertKind.INTERNAL_NOTE, payload: alert });
+    }
+    async sendProactiveMessage(message) {
+        await this.publish({ kind: ZendeskAlertKind.PROACTIVE_MESSAGE, payload: message });
+    }
+    async publish(message) {
+        try {
+            const client = new SQSClient();
+            const sendMessageRequest = {
+                QueueUrl: this.ZENDESK_ALERTS_QUEUE,
+                MessageBody: JSON.stringify(message)
+            };
+            const command = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
+        }
+    }
+};
+ZendeskAlertsPublisher = __decorate([
+    injectable()
+], ZendeskAlertsPublisher);
+export default ZendeskAlertsPublisher;

package/bin/zendesk/queue/interfaces/IZendeskAlertsPublisher.d.ts

@@ -0,0 +1,15 @@
+import { ZendeskInternalAlertRequest } from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+/**
+ * Publica alertas hacia Zendesk sin pagar su latencia: el caller encola y sigue.
+ * Consume zendesk-business.
+ */
+export interface IZendeskAlertsPublisher {
+    /** Nota interna sobre un usuario. Solo la ven los agentes. */
+    createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void>;
+    /**
+     * Mensaje al chat del usuario. Si el usuario está esperando la respuesta ahora, conviene
+     * el endpoint síncrono `IZendeskApi.sendProactiveMessage`: acá el fallo no es inmediato.
+     */
+    sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.14.0",
+  "version": "5.16.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.258.0",
+    "@fiado/type-kit": "^3.265.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

@@ -75,6 +75,8 @@ import { DirectoriesApi, IDirectoriesApi } from "./directories/index.js";
 import { ICognitoConnectorApi, ICognitoV2Api } from "./cognitoConnector/index.js";
 import CognitoConnectorApi from "./cognitoConnector/CognitoConnectorApi.js";
 import { IZendeskApi, ZendeskApi } from "./zendesk/index.js";
+import ZendeskAlertsPublisher from "./zendesk/queue/ZendeskAlertsPublisher.js";
+import { IZendeskAlertsPublisher } from "./zendesk/queue/interfaces/IZendeskAlertsPublisher.js";
 import { BlackListApi, IBlackListApi } from "./blacklist/index.js";
 import { DeviceApi, IDeviceApi } from "./device/index.js";
 import { IObservationsApi, ObservationsApi } from "./observations/index.js";
@@ -190,6 +192,9 @@ 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";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -247,6 +252,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<ICognitoConnectorApi>("ICognitoConnectorApi").to(CognitoConnectorApi);
     bind<ICognitoV2Api>("ICognitoV2Api").to(CognitoApi);
     bind<IZendeskApi>("IZendeskApi").to(ZendeskApi);
+    bind<IZendeskAlertsPublisher>("IZendeskAlertsPublisher").to(ZendeskAlertsPublisher);
     bind<IBlackListApi>("IBlackListApi").to(BlackListApi);
     bind<IDeviceApi>("IDeviceApi").to(DeviceApi);
     bind<IObservationsApi>("IObservationsApi").to(ObservationsApi);
@@ -355,4 +361,7 @@ 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);
 });

package/src/index.ts

@@ -106,3 +106,4 @@ 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";

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/src/zendesk/index.ts

@@ -1,3 +1,5 @@
 
 export * from './interfaces/IZendeskApi.js';
 export * from './ZendeskApi.js';
+export * from './queue/interfaces/IZendeskAlertsPublisher.js';
+export { default as ZendeskAlertsPublisher } from './queue/ZendeskAlertsPublisher.js';

package/src/zendesk/queue/ZendeskAlertsPublisher.ts

@@ -0,0 +1,38 @@
+import { injectable } from "inversify";
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import {
+    IZendeskAlertMessage,
+    ZendeskAlertKind,
+    ZendeskInternalAlertRequest
+} from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+import { IZendeskAlertsPublisher } from "./interfaces/IZendeskAlertsPublisher.js";
+
+@injectable()
+export default class ZendeskAlertsPublisher implements IZendeskAlertsPublisher {
+
+    private readonly ZENDESK_ALERTS_QUEUE = process.env.ZENDESK_ALERTS_QUEUE;
+
+    async createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void> {
+        await this.publish({ kind: ZendeskAlertKind.INTERNAL_NOTE, payload: alert });
+    }
+
+    async sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void> {
+        await this.publish({ kind: ZendeskAlertKind.PROACTIVE_MESSAGE, payload: message });
+    }
+
+    private async publish(message: IZendeskAlertMessage): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.ZENDESK_ALERTS_QUEUE,
+                MessageBody: JSON.stringify(message)
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
+        }
+    }
+}

package/src/zendesk/queue/interfaces/IZendeskAlertsPublisher.ts

@@ -0,0 +1,17 @@
+import { ZendeskInternalAlertRequest } from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+
+/**
+ * Publica alertas hacia Zendesk sin pagar su latencia: el caller encola y sigue.
+ * Consume zendesk-business.
+ */
+export interface IZendeskAlertsPublisher {
+    /** Nota interna sobre un usuario. Solo la ven los agentes. */
+    createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void>;
+
+    /**
+     * Mensaje al chat del usuario. Si el usuario está esperando la respuesta ahora, conviene
+     * el endpoint síncrono `IZendeskApi.sendProactiveMessage`: acá el fallo no es inmediato.
+     */
+    sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void>;
+}

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/MembershipApi.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 MembershipApi = class MembershipApi {
-    httpRequest;
-    baseUrl = process.env.MEMBERSHIP_BUSINESS_LAMBDA_URL || "";
-    constructor(httpRequest) {
-        this.httpRequest = httpRequest;
-    }
-    async deleteByDirectoryId(directoryId) {
-        const url = `${this.baseUrl}private/directory/${directoryId}`;
-        return await this.httpRequest.delete(url);
-    }
-};
-MembershipApi = __decorate([
-    injectable(),
-    __param(0, inject("IHttpRequest")),
-    __metadata("design:paramtypes", [Object])
-], MembershipApi);
-export { MembershipApi };

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 {};