@fiado/api-invoker 4.52.0 → 4.54.0

package/bin/container.config.js

@@ -110,8 +110,12 @@ 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)
+import { RemittanceBusinessApi } from "./remittance-business/index.js";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -234,6 +238,11 @@ 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)
+    bind("IRemittanceBusinessApi").to(RemittanceBusinessApi);
 });

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,4 +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,4 +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/remittance-business/api/RemittanceBusinessApi.d.ts

@@ -0,0 +1,10 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { PricingResolveRequest, PricingResolveResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { IRemittanceBusinessApi } from "./interfaces/IRemittanceBusinessApi.js";
+export default class RemittanceBusinessApi implements IRemittanceBusinessApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    pricingResolve(request: PricingResolveRequest): Promise<ApiGatewayResponse<PricingResolveResponse>>;
+}

package/bin/remittance-business/api/RemittanceBusinessApi.js

@@ -0,0 +1,30 @@
+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 RemittanceBusinessApi = class RemittanceBusinessApi {
+    httpRequest;
+    baseUrl = process.env.REMITTANCE_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async pricingResolve(request) {
+        const url = `${this.baseUrl}/private/pricing/resolve`;
+        return await this.httpRequest.post(url, request);
+    }
+};
+RemittanceBusinessApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], RemittanceBusinessApi);
+export default RemittanceBusinessApi;

package/bin/remittance-business/api/interfaces/IRemittanceBusinessApi.d.ts

@@ -0,0 +1,5 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { PricingResolveRequest, PricingResolveResponse } from "@fiado/type-kit/bin/remittance/index.js";
+export interface IRemittanceBusinessApi {
+    pricingResolve(request: PricingResolveRequest): Promise<ApiGatewayResponse<PricingResolveResponse>>;
+}

package/bin/remittance-business/api/interfaces/IRemittanceBusinessApi.js

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

package/bin/remittance-business/index.d.ts

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

package/bin/remittance-business/index.js

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

package/bin/uniteller-connector/api/UnitellerConnectorApi.d.ts

@@ -1,7 +1,7 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CohortCountRequest, CohortCountResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, RefreshUserProfileResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsPeriod, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, RefreshUserProfileResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsPeriod, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
 export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     private httpRequest;
@@ -76,6 +76,7 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
     kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
     cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
+    cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>>;
     segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
     wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>>;
     pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>>;

package/bin/uniteller-connector/api/UnitellerConnectorApi.js

@@ -165,6 +165,10 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
         return await this.httpRequest.post(url, request);
     }
+    async cohortUserMatch(request) {
+        const url = `${this.baseUrl}/backoffice/config/cohorts/user-match`;
+        return await this.httpRequest.post(url, request);
+    }
     async segmentMetrics(request) {
         const url = `${this.baseUrl}/backoffice/config/segments/metrics`;
         return await this.httpRequest.post(url, request);

package/bin/uniteller-connector/api/interfaces/IUnitellerConnectorApi.d.ts

@@ -1,6 +1,6 @@
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CohortCountRequest, CohortCountResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, RefreshUserProfileResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsPeriod, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, RefreshUserProfileResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsPeriod, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
 export interface IUnitellerConnectorApi {
     /** Estado del módulo remesas para un directoryId. */
     getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>>;
@@ -125,6 +125,8 @@ export interface IUnitellerConnectorApi {
     kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
     /** Cuenta usuarios que cumplen las condiciones (AND) + universo total. Lo consume remittance-business al recalcular un cohort. */
     cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
+    /** Determina si un usuario puntual matchea las condiciones (AND) de un cohort. Lo consume remittance-business. */
+    cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>>;
     /** {clientCount, volMonthUSD} para el subconjunto de RemittanceUsers del segmento (mes calendario, sin canceladas). */
     segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
     /** Wholesale vivo (ExternalQuickQuotes) del corredor — Simulador de Precio Base. */

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.52.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.156.0",
+    "@fiado/type-kit": "^3.163.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -169,8 +169,12 @@ 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)
+import { IRemittanceBusinessApi, RemittanceBusinessApi } from "./remittance-business/index.js";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -312,6 +316,13 @@ 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);
+
+    // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
+    bind<IRemittanceBusinessApi>("IRemittanceBusinessApi").to(RemittanceBusinessApi);
 });

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,4 +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/remittance-business/api/RemittanceBusinessApi.ts

@@ -0,0 +1,17 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { PricingResolveRequest, PricingResolveResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { IRemittanceBusinessApi } from "./interfaces/IRemittanceBusinessApi.js";
+
+@injectable()
+export default class RemittanceBusinessApi implements IRemittanceBusinessApi {
+    private readonly baseUrl = process.env.REMITTANCE_BUSINESS_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async pricingResolve(request: PricingResolveRequest): Promise<ApiGatewayResponse<PricingResolveResponse>> {
+        const url = `${this.baseUrl}/private/pricing/resolve`;
+        return await this.httpRequest.post(url, request);
+    }
+}

package/src/remittance-business/api/interfaces/IRemittanceBusinessApi.ts

@@ -0,0 +1,6 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { PricingResolveRequest, PricingResolveResponse } from "@fiado/type-kit/bin/remittance/index.js";
+
+export interface IRemittanceBusinessApi {
+    pricingResolve(request: PricingResolveRequest): Promise<ApiGatewayResponse<PricingResolveResponse>>;
+}

package/src/remittance-business/index.ts

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

package/src/uniteller-connector/api/UnitellerConnectorApi.ts

@@ -5,6 +5,8 @@ import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js
 import {
     CohortCountRequest,
     CohortCountResponse,
+    CohortUserMatchRequest,
+    CohortUserMatchResponse,
     PricingMetricsRequest,
     PricingMetricsResponse,
     PromotionReachRequest,
@@ -245,6 +247,11 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         return await this.httpRequest.post(url, request);
     }
 
+    async cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/cohorts/user-match`;
+        return await this.httpRequest.post(url, request);
+    }
+
     async segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>> {
         const url = `${this.baseUrl}/backoffice/config/segments/metrics`;
         return await this.httpRequest.post(url, request);

package/src/uniteller-connector/api/interfaces/IUnitellerConnectorApi.ts

@@ -3,6 +3,8 @@ import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js
 import {
     CohortCountRequest,
     CohortCountResponse,
+    CohortUserMatchRequest,
+    CohortUserMatchResponse,
     PricingMetricsRequest,
     PricingMetricsResponse,
     PromotionReachRequest,
@@ -188,6 +190,8 @@ export interface IUnitellerConnectorApi {
     // ─── Cohorts (Dashboard Ops · B2 — puente de recálculo Opción A) ────────────────
     /** Cuenta usuarios que cumplen las condiciones (AND) + universo total. Lo consume remittance-business al recalcular un cohort. */
     cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
+    /** Determina si un usuario puntual matchea las condiciones (AND) de un cohort. Lo consume remittance-business. */
+    cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>>;
 
     // ─── Segmentos (Dashboard Ops — puente de métricas Opción A) ────────────────────
     /** {clientCount, volMonthUSD} para el subconjunto de RemittanceUsers del segmento (mes calendario, sin canceladas). */

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";