@fiado/api-invoker 4.17.0 → 4.19.0

package/bin/benefits-marketplace/api/BenefitsMarketplaceApi.d.ts

@@ -3,6 +3,7 @@ import { IHttpRequest } from "@fiado/http-client";
 import { BenefitPaymentRequest, BenefitPaymentResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { BenefitLeafDisplayResponse } from "./dtos/BenefitLeafDisplayResponse.js";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, CancelFundingReferenceRequest, CancelFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
     private httpRequest;
     private readonly baseUrl;
@@ -10,4 +11,7 @@ export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
     pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
     consultPayment(moduleName: string, transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
     getLeafDisplay(benefitId: string, leafId: string): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>>;
+    fundingCreate(moduleName: string, request: CreateFundingReferenceRequest): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+    fundingCancel(moduleName: string, fundingId: string, request: CancelFundingReferenceRequest): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>>;
+    fundingList(moduleName: string, directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
 }

package/bin/benefits-marketplace/api/BenefitsMarketplaceApi.js

@@ -29,6 +29,21 @@ let BenefitsMarketplaceApi = class BenefitsMarketplaceApi {
         const url = `${this.baseUrl}/${encodeURIComponent(benefitId)}/leaves/${encodeURIComponent(leafId)}/display`;
         return await this.httpRequest.get(url);
     }
+    async fundingCreate(moduleName, request) {
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}`;
+        return await this.httpRequest.post(url, request);
+    }
+    async fundingCancel(moduleName, fundingId, request) {
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}/${encodeURIComponent(fundingId)}/cancel`;
+        return await this.httpRequest.post(url, request);
+    }
+    async fundingList(moduleName, directoryId, status) {
+        const params = new URLSearchParams({ directoryId });
+        if (status)
+            params.set("status", status);
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}/references?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 };
 BenefitsMarketplaceApi = __decorate([
     injectable(),

package/bin/benefits-marketplace/api/interfaces/IBenefitsMarketplaceApi.d.ts

@@ -1,6 +1,7 @@
 import { BenefitPaymentRequest, BenefitPaymentResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { BenefitLeafDisplayResponse } from "../dtos/BenefitLeafDisplayResponse.js";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, CancelFundingReferenceRequest, CancelFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 /**
  * Cliente único del procesador hacia benefits-marketplace-business (Fase 2).
  *
@@ -53,4 +54,24 @@ export interface IBenefitsMarketplaceApi {
      * @param leafId     Identificador del leaf (`base64url("<moduleName>::<idServicio>")`).
      */
     getLeafDisplay(benefitId: string, leafId: string): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>>;
+    /**
+     * Genera una referencia de fondeo de wallet via Passport.
+     * Backend: POST /funding/{moduleName} (privado VPC).
+     *
+     * El marketplace resuelve `moduleName` a un EqualityFundingPublisher y delega.
+     * Hoy `moduleName` es siempre `"equality-connector"`; queda extensible para
+     * futuros providers (OpenPay, etc.).
+     */
+    fundingCreate(moduleName: string, request: CreateFundingReferenceRequest): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+    /**
+     * Cancela una referencia ACTIVA.
+     * Backend: POST /funding/{moduleName}/{fundingId}/cancel (privado VPC).
+     * El marketplace delega al connector que verifica ownership por directoryId.
+     */
+    fundingCancel(moduleName: string, fundingId: string, request: CancelFundingReferenceRequest): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>>;
+    /**
+     * Lista las referencias del usuario.
+     * Backend: GET /funding/{moduleName}/references?directoryId=&status=
+     */
+    fundingList(moduleName: string, directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
 }

package/bin/container.config.js

@@ -103,6 +103,8 @@ import { MessagesBusinessApi } from "./messages-business/index.js";
 import MessagesBusinessPublisher from "./messages-business/queue/MessagesBusinessPublisher.js";
 // Totp security — connector HTTP-only síncrono (Fase 2 SureKeep)
 import { TotpSecurityApi } from "./totp-security/index.js";
+// Equality connector — wallet-funding HTTP client (benefits-marketplace → equality-connector)
+import { EqualityConnectorApi } from "./equality-connector/index.js";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -217,4 +219,6 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IMessagesBusinessPublisher").to(MessagesBusinessPublisher);
     // Totp security — connector HTTP-only síncrono (Fase 2 SureKeep)
     bind("ITotpSecurityApi").to(TotpSecurityApi);
+    // Equality connector — wallet-funding (benefits-marketplace → equality-connector)
+    bind("IEqualityConnectorApi").to(EqualityConnectorApi);
 });

package/bin/equality-connector/api/EqualityConnectorApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, CancelFundingReferenceRequest, CancelFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IEqualityConnectorApi } from "./interfaces/IEqualityConnectorApi.js";
+export default class EqualityConnectorApi implements IEqualityConnectorApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    createFundingReference(request: CreateFundingReferenceRequest): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+    cancelFundingReference(fundingId: string, request: CancelFundingReferenceRequest): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>>;
+    listFundingReferences(directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+}

package/bin/equality-connector/api/EqualityConnectorApi.js

@@ -0,0 +1,41 @@
+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";
+let EqualityConnectorApi = class EqualityConnectorApi {
+    httpRequest;
+    baseUrl = process.env.EQUALITY_CONNECTOR_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async createFundingReference(request) {
+        const url = `${this.baseUrl}/funding`;
+        return await this.httpRequest.post(url, request);
+    }
+    async cancelFundingReference(fundingId, request) {
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(fundingId)}/cancel`;
+        return await this.httpRequest.post(url, request);
+    }
+    async listFundingReferences(directoryId, status) {
+        const params = new URLSearchParams({ directoryId });
+        if (status)
+            params.set("status", status);
+        const url = `${this.baseUrl}/funding/references?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+};
+EqualityConnectorApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], EqualityConnectorApi);
+export default EqualityConnectorApi;

package/bin/equality-connector/api/interfaces/IEqualityConnectorApi.d.ts

@@ -0,0 +1,24 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, CancelFundingReferenceRequest, CancelFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+/**
+ * Cliente del marketplace hacia equality-connector (privado, dentro de la VPC).
+ *
+ * Lo consume exclusivamente `EqualityFundingPublisher` del benefits-marketplace-business.
+ * Ningún otro lambda conoce este cliente.
+ *
+ * Endpoints backend en equality-connector:
+ *  - POST /funding                                (privado VPC)
+ *  - POST /funding/{fundingId}/cancel             (privado VPC)
+ *  - GET  /funding/references?directoryId=&status=  (privado VPC)
+ */
+export interface IEqualityConnectorApi {
+    /** Genera una referencia de fondeo en Passport via el connector. */
+    createFundingReference(request: CreateFundingReferenceRequest): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+    /** Cancela una referencia ACTIVA. Verifica ownership por `directoryId`. */
+    cancelFundingReference(fundingId: string, request: CancelFundingReferenceRequest): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>>;
+    /**
+     * Lista las referencias del usuario, opcionalmente filtradas por status.
+     * Status default (cuando no se pasa) lo decide el connector — hoy: ACTIVE.
+     */
+    listFundingReferences(directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+}

package/bin/equality-connector/api/interfaces/IEqualityConnectorApi.js

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

package/bin/equality-connector/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/IEqualityConnectorApi.js";
+export { default as EqualityConnectorApi } from "./api/EqualityConnectorApi.js";

package/bin/equality-connector/index.js

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/IEqualityConnectorApi.js";
+export { default as EqualityConnectorApi } from "./api/EqualityConnectorApi.js";

package/bin/index.d.ts

@@ -77,3 +77,4 @@ export * from "./cognitoBackofficeConnector/index.js";
 export * from "./platformRbac/index.js";
 export * from "./messages-business/index.js";
 export * from "./totp-security/index.js";
+export * from "./equality-connector/index.js";

package/bin/index.js

@@ -77,3 +77,4 @@ export * from "./cognitoBackofficeConnector/index.js";
 export * from "./platformRbac/index.js";
 export * from "./messages-business/index.js";
 export * from "./totp-security/index.js";
+export * from "./equality-connector/index.js";

package/bin/transactionProcessor/api/TransactionProcessorApi.d.ts

@@ -1,6 +1,8 @@
 import { ITransactionProcessorApi } from "./interfaces/ITransactionProcessorApi.js";
 import { 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 } from "@fiado/type-kit/bin/walletFunding/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 {
@@ -14,5 +16,8 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
     authorizePagoConfiadoSpeiTransaction(request: AuthorizeSpeiBankTransferNcRequest): Promise<any>;
     authorizeCollectorOrderTransaction(request: AuthorizeCollectorOrderRequest): Promise<FiadoApiResponse<AuthorizeCollectorOrderResponse>>;
     authorizeRenewalPreAuthTransaction(request: AuthorizeRenewalPreAuthRequest): Promise<FiadoApiResponse<AuthorizeRenewalPreAuthResponse>>;
+    walletFundingValidate(request: ValidateWalletFundingRequest): Promise<ApiGatewayResponse<ValidateWalletFundingResponse>>;
+    walletFundingCredit(request: CreditWalletFundingRequest): Promise<ApiGatewayResponse<CreditWalletFundingResponse>>;
+    walletFundingReverse(request: ReverseWalletFundingRequest): Promise<ApiGatewayResponse<ReverseWalletFundingResponse>>;
 }
 export {};

package/bin/transactionProcessor/api/TransactionProcessorApi.js

@@ -45,6 +45,18 @@ let TransactionProcessorApi = class TransactionProcessorApi {
         const url = `${this.baseUrl}authorize`;
         return await this.httpRequest.post(url, request);
     }
+    async walletFundingValidate(request) {
+        const url = `${this.baseUrl}transaction-processor/wallet-funding/validate`;
+        return await this.httpRequest.post(url, request);
+    }
+    async walletFundingCredit(request) {
+        const url = `${this.baseUrl}transaction-processor/wallet-funding/credit`;
+        return await this.httpRequest.post(url, request);
+    }
+    async walletFundingReverse(request) {
+        const url = `${this.baseUrl}transaction-processor/wallet-funding/reverse`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 TransactionProcessorApi = __decorate([
     injectable(),

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

@@ -1,5 +1,7 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 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 } from "@fiado/type-kit/bin/walletFunding/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 export interface ITransactionProcessorApi {
     authorizeTransaction(request: AuthorizeCreditCardPurchaseRequest): Promise<any>;
@@ -9,5 +11,23 @@ export interface ITransactionProcessorApi {
     authorizePagoConfiadoSpeiTransaction(request: AuthorizeSpeiBankTransferNcRequest): Promise<any>;
     authorizeCollectorOrderTransaction(request: AuthorizeCollectorOrderRequest): Promise<FiadoApiResponse<AuthorizeCollectorOrderResponse>>;
     authorizeRenewalPreAuthTransaction(request: AuthorizeRenewalPreAuthRequest): Promise<FiadoApiResponse<AuthorizeRenewalPreAuthResponse>>;
+    /**
+     * Pre-check de fondeo de wallet (validate antes de COMMIT).
+     * Backend: POST /transaction-processor/wallet-funding/validate (privado VPC).
+     * Lo consume benefits-marketplace-business en outbound (antes de redirigir al provider).
+     */
+    walletFundingValidate(request: ValidateWalletFundingRequest): Promise<ApiGatewayResponse<ValidateWalletFundingResponse>>;
+    /**
+     * Acredita el fondeo confirmado por el provider (webhook PAID).
+     * Backend: POST /transaction-processor/wallet-funding/credit (privado VPC).
+     * Lo consume equality-connector cuando Passport confirma el cobro.
+     */
+    walletFundingCredit(request: CreditWalletFundingRequest): Promise<ApiGatewayResponse<CreditWalletFundingResponse>>;
+    /**
+     * Reversa un fondeo previamente acreditado (webhook REVERSED/REFUNDED).
+     * Backend: POST /transaction-processor/wallet-funding/reverse (privado VPC).
+     * Lo consume equality-connector ante refunds del provider.
+     */
+    walletFundingReverse(request: ReverseWalletFundingRequest): Promise<ApiGatewayResponse<ReverseWalletFundingResponse>>;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.17.0",
+  "version": "4.19.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",
@@ -11,7 +11,14 @@
       "import": "./bin/index.js",
       "default": "./bin/index.js"
     },
-    "./bin/*": "./bin/*.js",
+    "./bin/*.js": {
+      "types": "./bin/*.d.ts",
+      "default": "./bin/*.js"
+    },
+    "./bin/*": {
+      "types": "./bin/*.d.ts",
+      "default": "./bin/*.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {

package/src/benefits-marketplace/api/BenefitsMarketplaceApi.ts

@@ -4,6 +4,13 @@ import {IHttpRequest} from "@fiado/http-client";
 import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {ApiGatewayResponse} from "@fiado/gateway-adapter";
 import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse.js";
+import {
+    CreateFundingReferenceRequest,
+    CreateFundingReferenceResponse,
+    CancelFundingReferenceRequest,
+    CancelFundingReferenceResponse,
+    ListFundingReferencesResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
 
 @injectable()
 export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
@@ -32,4 +39,32 @@ export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
         const url = `${this.baseUrl}/${encodeURIComponent(benefitId)}/leaves/${encodeURIComponent(leafId)}/display`;
         return await this.httpRequest.get(url);
     }
+
+    async fundingCreate(
+        moduleName: string,
+        request: CreateFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>> {
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async fundingCancel(
+        moduleName: string,
+        fundingId: string,
+        request: CancelFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>> {
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}/${encodeURIComponent(fundingId)}/cancel`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async fundingList(
+        moduleName: string,
+        directoryId: string,
+        status?: string,
+    ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>> {
+        const params = new URLSearchParams({ directoryId });
+        if (status) params.set("status", status);
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}/references?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 }

package/src/benefits-marketplace/api/interfaces/IBenefitsMarketplaceApi.ts

@@ -1,6 +1,13 @@
 import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {ApiGatewayResponse} from "@fiado/gateway-adapter";
 import {BenefitLeafDisplayResponse} from "../dtos/BenefitLeafDisplayResponse.js";
+import {
+    CreateFundingReferenceRequest,
+    CreateFundingReferenceResponse,
+    CancelFundingReferenceRequest,
+    CancelFundingReferenceResponse,
+    ListFundingReferencesResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
 
 /**
  * Cliente único del procesador hacia benefits-marketplace-business (Fase 2).
@@ -59,4 +66,38 @@ export interface IBenefitsMarketplaceApi {
         benefitId: string,
         leafId: string,
     ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>>;
+
+    /**
+     * Genera una referencia de fondeo de wallet via Passport.
+     * Backend: POST /funding/{moduleName} (privado VPC).
+     *
+     * El marketplace resuelve `moduleName` a un EqualityFundingPublisher y delega.
+     * Hoy `moduleName` es siempre `"equality-connector"`; queda extensible para
+     * futuros providers (OpenPay, etc.).
+     */
+    fundingCreate(
+        moduleName: string,
+        request: CreateFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+
+    /**
+     * Cancela una referencia ACTIVA.
+     * Backend: POST /funding/{moduleName}/{fundingId}/cancel (privado VPC).
+     * El marketplace delega al connector que verifica ownership por directoryId.
+     */
+    fundingCancel(
+        moduleName: string,
+        fundingId: string,
+        request: CancelFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>>;
+
+    /**
+     * Lista las referencias del usuario.
+     * Backend: GET /funding/{moduleName}/references?directoryId=&status=
+     */
+    fundingList(
+        moduleName: string,
+        directoryId: string,
+        status?: string,
+    ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
 }

package/src/container.config.ts

@@ -162,6 +162,8 @@ import MessagesBusinessPublisher from "./messages-business/queue/MessagesBusines
 import { IMessagesBusinessPublisher } from "./messages-business/queue/interfaces/IMessagesBusinessPublisher.js";
 // Totp security — connector HTTP-only síncrono (Fase 2 SureKeep)
 import { ITotpSecurityApi, TotpSecurityApi } from "./totp-security/index.js";
+// Equality connector — wallet-funding HTTP client (benefits-marketplace → equality-connector)
+import { IEqualityConnectorApi, EqualityConnectorApi } from "./equality-connector/index.js";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -291,4 +293,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
 
     // Totp security — connector HTTP-only síncrono (Fase 2 SureKeep)
     bind<ITotpSecurityApi>("ITotpSecurityApi").to(TotpSecurityApi);
+
+    // Equality connector — wallet-funding (benefits-marketplace → equality-connector)
+    bind<IEqualityConnectorApi>("IEqualityConnectorApi").to(EqualityConnectorApi);
 });

package/src/equality-connector/api/EqualityConnectorApi.ts

@@ -0,0 +1,43 @@
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    CreateFundingReferenceRequest,
+    CreateFundingReferenceResponse,
+    CancelFundingReferenceRequest,
+    CancelFundingReferenceResponse,
+    ListFundingReferencesResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IEqualityConnectorApi } from "./interfaces/IEqualityConnectorApi.js";
+
+@injectable()
+export default class EqualityConnectorApi implements IEqualityConnectorApi {
+    private readonly baseUrl = process.env.EQUALITY_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async createFundingReference(
+        request: CreateFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>> {
+        const url = `${this.baseUrl}/funding`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async cancelFundingReference(
+        fundingId: string,
+        request: CancelFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>> {
+        const url = `${this.baseUrl}/funding/${encodeURIComponent(fundingId)}/cancel`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async listFundingReferences(
+        directoryId: string,
+        status?: string,
+    ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>> {
+        const params = new URLSearchParams({ directoryId });
+        if (status) params.set("status", status);
+        const url = `${this.baseUrl}/funding/references?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+}

package/src/equality-connector/api/interfaces/IEqualityConnectorApi.ts

@@ -0,0 +1,41 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    CreateFundingReferenceRequest,
+    CreateFundingReferenceResponse,
+    CancelFundingReferenceRequest,
+    CancelFundingReferenceResponse,
+    ListFundingReferencesResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+
+/**
+ * Cliente del marketplace hacia equality-connector (privado, dentro de la VPC).
+ *
+ * Lo consume exclusivamente `EqualityFundingPublisher` del benefits-marketplace-business.
+ * Ningún otro lambda conoce este cliente.
+ *
+ * Endpoints backend en equality-connector:
+ *  - POST /funding                                (privado VPC)
+ *  - POST /funding/{fundingId}/cancel             (privado VPC)
+ *  - GET  /funding/references?directoryId=&status=  (privado VPC)
+ */
+export interface IEqualityConnectorApi {
+    /** Genera una referencia de fondeo en Passport via el connector. */
+    createFundingReference(
+        request: CreateFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+
+    /** Cancela una referencia ACTIVA. Verifica ownership por `directoryId`. */
+    cancelFundingReference(
+        fundingId: string,
+        request: CancelFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CancelFundingReferenceResponse>>;
+
+    /**
+     * Lista las referencias del usuario, opcionalmente filtradas por status.
+     * Status default (cuando no se pasa) lo decide el connector — hoy: ACTIVE.
+     */
+    listFundingReferences(
+        directoryId: string,
+        status?: string,
+    ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+}

package/src/equality-connector/index.ts

@@ -0,0 +1,2 @@
+export * from "./api/interfaces/IEqualityConnectorApi.js";
+export { default as EqualityConnectorApi } from "./api/EqualityConnectorApi.js";

package/src/index.ts

@@ -77,3 +77,4 @@ export * from "./cognitoBackofficeConnector/index.js";
 export * from "./platformRbac/index.js";
 export * from "./messages-business/index.js";
 export * from "./totp-security/index.js";
+export * from "./equality-connector/index.js";

package/src/transactionProcessor/api/TransactionProcessorApi.ts

@@ -10,6 +10,15 @@ import {
     AuthorizeRenewalPreAuthRequest,
     AuthorizeRenewalPreAuthResponse
 } from "@fiado/type-kit/bin/transactionProcessor/index.js";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    ValidateWalletFundingRequest,
+    ValidateWalletFundingResponse,
+    CreditWalletFundingRequest,
+    CreditWalletFundingResponse,
+    ReverseWalletFundingRequest,
+    ReverseWalletFundingResponse,
+} from "@fiado/type-kit/bin/walletFunding/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>;
 
@@ -55,4 +64,25 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
         const url: string = `${this.baseUrl}authorize`;
         return await this.httpRequest.post(url, request);
     }
+
+    async walletFundingValidate(
+        request: ValidateWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ValidateWalletFundingResponse>> {
+        const url = `${this.baseUrl}transaction-processor/wallet-funding/validate`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async walletFundingCredit(
+        request: CreditWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<CreditWalletFundingResponse>> {
+        const url = `${this.baseUrl}transaction-processor/wallet-funding/credit`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async walletFundingReverse(
+        request: ReverseWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ReverseWalletFundingResponse>> {
+        const url = `${this.baseUrl}transaction-processor/wallet-funding/reverse`;
+        return await this.httpRequest.post(url, request);
+    }
 }

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

@@ -9,6 +9,15 @@ import {
     AuthorizeRenewalPreAuthRequest,
     AuthorizeRenewalPreAuthResponse
 } from "@fiado/type-kit/bin/transactionProcessor/index.js";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    ValidateWalletFundingRequest,
+    ValidateWalletFundingResponse,
+    CreditWalletFundingRequest,
+    CreditWalletFundingResponse,
+    ReverseWalletFundingRequest,
+    ReverseWalletFundingResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 
 export interface ITransactionProcessorApi {
@@ -26,4 +35,31 @@ export interface ITransactionProcessorApi {
     authorizeCollectorOrderTransaction(request: AuthorizeCollectorOrderRequest): Promise<FiadoApiResponse<AuthorizeCollectorOrderResponse>>;
 
     authorizeRenewalPreAuthTransaction(request: AuthorizeRenewalPreAuthRequest): Promise<FiadoApiResponse<AuthorizeRenewalPreAuthResponse>>;
+
+    /**
+     * Pre-check de fondeo de wallet (validate antes de COMMIT).
+     * Backend: POST /transaction-processor/wallet-funding/validate (privado VPC).
+     * Lo consume benefits-marketplace-business en outbound (antes de redirigir al provider).
+     */
+    walletFundingValidate(
+        request: ValidateWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ValidateWalletFundingResponse>>;
+
+    /**
+     * Acredita el fondeo confirmado por el provider (webhook PAID).
+     * Backend: POST /transaction-processor/wallet-funding/credit (privado VPC).
+     * Lo consume equality-connector cuando Passport confirma el cobro.
+     */
+    walletFundingCredit(
+        request: CreditWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<CreditWalletFundingResponse>>;
+
+    /**
+     * Reversa un fondeo previamente acreditado (webhook REVERSED/REFUNDED).
+     * Backend: POST /transaction-processor/wallet-funding/reverse (privado VPC).
+     * Lo consume equality-connector ante refunds del provider.
+     */
+    walletFundingReverse(
+        request: ReverseWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ReverseWalletFundingResponse>>;
 }