@fiado/api-invoker 4.53.0 → 4.54.0

package/bin/container.config.js

@@ -110,6 +110,8 @@ import { EqualityConnectorApi } from "./equality-connector/index.js";
 import { ContactsBusinessApi } from "./contacts-business/index.js";
 // Wallet funding settlement — TransactWriteItems atómico del money path cash-in (spec 15)
 import { WalletFundingSettlementApi } from "./walletFundingSettlement/index.js";
+// Wallet funding rules — validaciones de riesgo Cash In (cap agregado, exposición, breaker, LFPIORPI)
+import { WalletFundingRulesApi } from "./wallet-funding-rules/index.js";
 // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
 import { SnsSesConnectorApi } from "./sns-ses-connector/index.js";
 // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
@@ -236,6 +238,9 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // Wallet funding settlement — TransactWriteItems atómico del money path cash-in
     // (consumido por equality-connector post processor.walletFundingValidate). Ver spec 15.
     bind("IWalletFundingSettlementApi").to(WalletFundingSettlementApi);
+    // Wallet funding rules — cap agregado + exposición + circuit breaker + LFPIORPI (provider-agnostic).
+    // Lo consume transaction-processor en walletFundingValidate y db-conciliacion al liberar exposición.
+    bind("IWalletFundingRulesApi").to(WalletFundingRulesApi);
     // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
     bind("ISnsSesConnectorApi").to(SnsSesConnectorApi);
     // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)

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

@@ -1,7 +1,7 @@
 import { IHttpRequest } from "@fiado/http-client";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse, ApplyWalletFundingRequest, ApplyWalletFundingResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { IEqualityConnectorApi } from "./interfaces/IEqualityConnectorApi.js";
 export default class EqualityConnectorApi implements IEqualityConnectorApi {
     private httpRequest;
@@ -13,4 +13,5 @@ export default class EqualityConnectorApi implements IEqualityConnectorApi {
         benefitId: string;
         includeDisabled?: boolean;
     }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+    applyFunding(request: ApplyWalletFundingRequest): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
 }

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

@@ -35,6 +35,10 @@ let EqualityConnectorApi = class EqualityConnectorApi {
         const url = `${this.baseUrl}/catalog/standard?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+    async applyFunding(request) {
+        const url = `${this.baseUrl}/funding/apply`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 EqualityConnectorApi = __decorate([
     injectable(),

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

@@ -1,6 +1,6 @@
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse, ApplyWalletFundingRequest, ApplyWalletFundingResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 /**
  * Cliente del marketplace hacia equality-connector (privado, dentro de la VPC).
  *
@@ -33,4 +33,10 @@ export interface IEqualityConnectorApi {
         benefitId: string;
         includeDisabled?: boolean;
     }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+    /**
+     * Dispara el acreditamiento diferido de un pago ya verificado (POST /funding/apply).
+     * Lo invoca `db-conciliacion` cuando la verificación autoritativa contra el portal
+     * resuelve: APPROVED → acredita (processor.credit → settle); REJECTED → revierte.
+     */
+    applyFunding(request: ApplyWalletFundingRequest): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
 }

package/bin/index.d.ts

@@ -82,5 +82,6 @@ export * from "./equality-connector/index.js";
 export * from "./contacts-business/index.js";
 export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
+export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
 export * from "./remittance-business/index.js";

package/bin/index.js

@@ -82,5 +82,6 @@ export * from "./equality-connector/index.js";
 export * from "./contacts-business/index.js";
 export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
+export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
 export * from "./remittance-business/index.js";

package/bin/wallet-funding-rules/api/WalletFundingRulesApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ReserveExposureRequest, ReserveExposureResponse, ReleaseExposureRequest, ReleaseExposureResponse, GetExposureStateResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IWalletFundingRulesApi } from "./interfaces/IWalletFundingRulesApi.js";
+export default class WalletFundingRulesApi implements IWalletFundingRulesApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    reserveExposure(request: ReserveExposureRequest): Promise<ApiGatewayResponse<ReserveExposureResponse>>;
+    releaseExposure(request: ReleaseExposureRequest): Promise<ApiGatewayResponse<ReleaseExposureResponse>>;
+    getExposureState(): Promise<ApiGatewayResponse<GetExposureStateResponse>>;
+}

package/bin/wallet-funding-rules/api/WalletFundingRulesApi.js

@@ -0,0 +1,38 @@
+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 WalletFundingRulesApi = class WalletFundingRulesApi {
+    httpRequest;
+    baseUrl = process.env.WALLET_FUNDING_RULES_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async reserveExposure(request) {
+        const url = `${this.baseUrl}/reserve`;
+        return await this.httpRequest.post(url, request);
+    }
+    async releaseExposure(request) {
+        const url = `${this.baseUrl}/release`;
+        return await this.httpRequest.post(url, request);
+    }
+    async getExposureState() {
+        const url = `${this.baseUrl}/state`;
+        return await this.httpRequest.get(url);
+    }
+};
+WalletFundingRulesApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], WalletFundingRulesApi);
+export default WalletFundingRulesApi;

package/bin/wallet-funding-rules/api/interfaces/IWalletFundingRulesApi.d.ts

@@ -0,0 +1,23 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ReserveExposureRequest, ReserveExposureResponse, ReleaseExposureRequest, ReleaseExposureResponse, GetExposureStateResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+/**
+ * Cliente hacia `wallet-funding-rules-business` (lambda privado VPC).
+ *
+ * Dueño de las validaciones de riesgo del tipo Cash In: cap agregado FSA,
+ * exposición, circuit breaker y LFPIORPI. Provider-agnostic — lo consume el
+ * `transaction-processor` en `walletFundingValidate` (cap gate) y la
+ * conciliación (`db-conciliacion`) al liberar exposición.
+ *
+ * Endpoints backend en wallet-funding-rules:
+ *   - POST /reserve   (privado VPC) — reserva atómica single-region
+ *   - POST /release   (privado VPC)
+ *   - GET  /state     (privado VPC)
+ */
+export interface IWalletFundingRulesApi {
+    /** Reserva monto contra la exposición agregada (cap gate). Atómico single-region. */
+    reserveExposure(request: ReserveExposureRequest): Promise<ApiGatewayResponse<ReserveExposureResponse>>;
+    /** Libera monto de la exposición agregada (liquidación / rechazo). Puede reactivar el servicio. */
+    releaseExposure(request: ReleaseExposureRequest): Promise<ApiGatewayResponse<ReleaseExposureResponse>>;
+    /** Devuelve el estado actual de la exposición agregada + circuit breaker. */
+    getExposureState(): Promise<ApiGatewayResponse<GetExposureStateResponse>>;
+}

package/bin/wallet-funding-rules/api/interfaces/IWalletFundingRulesApi.js

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

package/bin/wallet-funding-rules/index.d.ts

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

package/bin/wallet-funding-rules/index.js

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

package/package.json

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

package/src/container.config.ts

@@ -169,6 +169,8 @@ import { IEqualityConnectorApi, EqualityConnectorApi } from "./equality-connecto
 import { IContactsBusinessApi, ContactsBusinessApi } from "./contacts-business/index.js";
 // Wallet funding settlement — TransactWriteItems atómico del money path cash-in (spec 15)
 import { IWalletFundingSettlementApi, WalletFundingSettlementApi } from "./walletFundingSettlement/index.js";
+// Wallet funding rules — validaciones de riesgo Cash In (cap agregado, exposición, breaker, LFPIORPI)
+import { IWalletFundingRulesApi, WalletFundingRulesApi } from "./wallet-funding-rules/index.js";
 // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
 import { ISnsSesConnectorApi, SnsSesConnectorApi } from "./sns-ses-connector/index.js";
 // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
@@ -314,6 +316,10 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // (consumido por equality-connector post processor.walletFundingValidate). Ver spec 15.
     bind<IWalletFundingSettlementApi>("IWalletFundingSettlementApi").to(WalletFundingSettlementApi);
 
+    // Wallet funding rules — cap agregado + exposición + circuit breaker + LFPIORPI (provider-agnostic).
+    // Lo consume transaction-processor en walletFundingValidate y db-conciliacion al liberar exposición.
+    bind<IWalletFundingRulesApi>("IWalletFundingRulesApi").to(WalletFundingRulesApi);
+
     // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
     bind<ISnsSesConnectorApi>("ISnsSesConnectorApi").to(SnsSesConnectorApi);
 

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

@@ -6,6 +6,8 @@ import {
     CreateFundingReferenceRequest,
     CreateFundingReferenceResponse,
     ListFundingReferencesResponse,
+    ApplyWalletFundingRequest,
+    ApplyWalletFundingResponse,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { IEqualityConnectorApi } from "./interfaces/IEqualityConnectorApi.js";
 
@@ -40,4 +42,11 @@ export default class EqualityConnectorApi implements IEqualityConnectorApi {
         const url = `${this.baseUrl}/catalog/standard?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+
+    async applyFunding(
+        request: ApplyWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>> {
+        const url = `${this.baseUrl}/funding/apply`;
+        return await this.httpRequest.post(url, request);
+    }
 }

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

@@ -4,6 +4,8 @@ import {
     CreateFundingReferenceRequest,
     CreateFundingReferenceResponse,
     ListFundingReferencesResponse,
+    ApplyWalletFundingRequest,
+    ApplyWalletFundingResponse,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
 
 /**
@@ -44,4 +46,13 @@ export interface IEqualityConnectorApi {
     getStandardCatalog(
         query: { benefitId: string; includeDisabled?: boolean },
     ): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+
+    /**
+     * Dispara el acreditamiento diferido de un pago ya verificado (POST /funding/apply).
+     * Lo invoca `db-conciliacion` cuando la verificación autoritativa contra el portal
+     * resuelve: APPROVED → acredita (processor.credit → settle); REJECTED → revierte.
+     */
+    applyFunding(
+        request: ApplyWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
 }

package/src/index.ts

@@ -82,5 +82,6 @@ export * from "./equality-connector/index.js";
 export * from "./contacts-business/index.js";
 export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
+export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
 export * from "./remittance-business/index.js";

package/src/wallet-funding-rules/api/WalletFundingRulesApi.ts

@@ -0,0 +1,37 @@
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    ReserveExposureRequest,
+    ReserveExposureResponse,
+    ReleaseExposureRequest,
+    ReleaseExposureResponse,
+    GetExposureStateResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IWalletFundingRulesApi } from "./interfaces/IWalletFundingRulesApi.js";
+
+@injectable()
+export default class WalletFundingRulesApi implements IWalletFundingRulesApi {
+    private readonly baseUrl = process.env.WALLET_FUNDING_RULES_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async reserveExposure(
+        request: ReserveExposureRequest,
+    ): Promise<ApiGatewayResponse<ReserveExposureResponse>> {
+        const url = `${this.baseUrl}/reserve`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async releaseExposure(
+        request: ReleaseExposureRequest,
+    ): Promise<ApiGatewayResponse<ReleaseExposureResponse>> {
+        const url = `${this.baseUrl}/release`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async getExposureState(): Promise<ApiGatewayResponse<GetExposureStateResponse>> {
+        const url = `${this.baseUrl}/state`;
+        return await this.httpRequest.get(url);
+    }
+}

package/src/wallet-funding-rules/api/interfaces/IWalletFundingRulesApi.ts

@@ -0,0 +1,36 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    ReserveExposureRequest,
+    ReserveExposureResponse,
+    ReleaseExposureRequest,
+    ReleaseExposureResponse,
+    GetExposureStateResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+
+/**
+ * Cliente hacia `wallet-funding-rules-business` (lambda privado VPC).
+ *
+ * Dueño de las validaciones de riesgo del tipo Cash In: cap agregado FSA,
+ * exposición, circuit breaker y LFPIORPI. Provider-agnostic — lo consume el
+ * `transaction-processor` en `walletFundingValidate` (cap gate) y la
+ * conciliación (`db-conciliacion`) al liberar exposición.
+ *
+ * Endpoints backend en wallet-funding-rules:
+ *   - POST /reserve   (privado VPC) — reserva atómica single-region
+ *   - POST /release   (privado VPC)
+ *   - GET  /state     (privado VPC)
+ */
+export interface IWalletFundingRulesApi {
+    /** Reserva monto contra la exposición agregada (cap gate). Atómico single-region. */
+    reserveExposure(
+        request: ReserveExposureRequest,
+    ): Promise<ApiGatewayResponse<ReserveExposureResponse>>;
+
+    /** Libera monto de la exposición agregada (liquidación / rechazo). Puede reactivar el servicio. */
+    releaseExposure(
+        request: ReleaseExposureRequest,
+    ): Promise<ApiGatewayResponse<ReleaseExposureResponse>>;
+
+    /** Devuelve el estado actual de la exposición agregada + circuit breaker. */
+    getExposureState(): Promise<ApiGatewayResponse<GetExposureStateResponse>>;
+}

package/src/wallet-funding-rules/index.ts

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