@fiado/api-invoker 4.35.0 → 4.37.0

package/bin/container.config.js

@@ -108,6 +108,8 @@ import { TotpSecurityApi } from "./totp-security/index.js";
 import { EqualityConnectorApi } from "./equality-connector/index.js";
 // Contacts business — fuente de verdad de correos verificados (F2 gate UNIR)
 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";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -227,4 +229,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IEqualityConnectorApi").to(EqualityConnectorApi);
     // Contacts business — fuente de verdad de correos verificados (F2 gate UNIR)
     bind("IContactsBusinessApi").to(ContactsBusinessApi);
+    // 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);
 });

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

@@ -3,6 +3,8 @@ 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, GetWalletFundingLimitRequest, GetWalletFundingLimitResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { PublishFiadoTxRequest, PublishFiadoTxResponse } from "@fiado/type-kit/bin/transactionProcessor/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 {
@@ -20,5 +22,7 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
     walletFundingCredit(request: CreditWalletFundingRequest): Promise<ApiGatewayResponse<CreditWalletFundingResponse>>;
     walletFundingReverse(request: ReverseWalletFundingRequest): Promise<ApiGatewayResponse<ReverseWalletFundingResponse>>;
     walletFundingGetLimit(request: GetWalletFundingLimitRequest): Promise<ApiGatewayResponse<GetWalletFundingLimitResponse>>;
+    creditBack(request: RemittanceCreditBackRequest): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
+    publishFiadoTx(request: PublishFiadoTxRequest): Promise<ApiGatewayResponse<PublishFiadoTxResponse>>;
 }
 export {};

package/bin/transactionProcessor/api/TransactionProcessorApi.js

@@ -61,6 +61,14 @@ let TransactionProcessorApi = class TransactionProcessorApi {
         const url = `${this.baseUrl}wallet-funding/limit`;
         return await this.httpRequest.post(url, request);
     }
+    async creditBack(request) {
+        const url = `${this.baseUrl}remittance/credit-back`;
+        return await this.httpRequest.post(url, request);
+    }
+    async publishFiadoTx(request) {
+        const url = `${this.baseUrl}wallet-funding/publish`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 TransactionProcessorApi = __decorate([
     injectable(),

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

@@ -2,6 +2,8 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
 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 { PublishFiadoTxRequest, PublishFiadoTxResponse } from "@fiado/type-kit/bin/transactionProcessor/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 export interface ITransactionProcessorApi {
     authorizeTransaction(request: AuthorizeCreditCardPurchaseRequest): Promise<any>;
@@ -36,5 +38,28 @@ export interface ITransactionProcessorApi {
      * Lo consume benefits-marketplace-business para exponer el dato al wallet-app.
      */
     walletFundingGetLimit(request: GetWalletFundingLimitRequest): Promise<ApiGatewayResponse<GetWalletFundingLimitResponse>>;
+    /**
+     * Credit-back de cancelacion de remesa Uniteller. Lo invoca uniteller-connector
+     * cuando UNIR confirma el outcome terminal. Idempotente por idempotencyKey.
+     * Backend: POST /transaction-processor/remittance/credit-back (privado VPC).
+     */
+    creditBack(request: RemittanceCreditBackRequest): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
+    /**
+     * Publica el evento FiadoTx del wallet-funding cash-in al SQS
+     * TRANSACTION_QUEUE para que transaction-business persista la
+     * tupla EQ_CASH_SA en FiadoTx_GT.
+     *
+     * Ownership del SQS sigue en el processor (el settlement NO publica,
+     * solo ejecuta el TransactWriteItems atómico). Best-effort: status
+     * FAILED indica que sqs.sendMessage falló — el caller debe loggear
+     * y continuar; el reconciler T+0 del connector recupera gaps.
+     *
+     * Backend: POST /transaction-processor/wallet-funding/publish (privado VPC).
+     * Consumido por equality-connector (post-settlement OK) y por su
+     * FiadoTxGapReconcilerCron.
+     *
+     * Ver spec 15 §6.2.
+     */
+    publishFiadoTx(request: PublishFiadoTxRequest): Promise<ApiGatewayResponse<PublishFiadoTxResponse>>;
 }
 export {};

package/bin/walletFundingSettlement/api/WalletFundingSettlementApi.d.ts

@@ -0,0 +1,10 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { SettleWalletFundingRequest, SettleWalletFundingResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IWalletFundingSettlementApi } from "./interfaces/IWalletFundingSettlementApi.js";
+export default class WalletFundingSettlementApi implements IWalletFundingSettlementApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    settle(request: SettleWalletFundingRequest): Promise<ApiGatewayResponse<SettleWalletFundingResponse>>;
+}

package/bin/walletFundingSettlement/api/WalletFundingSettlementApi.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 WalletFundingSettlementApi = class WalletFundingSettlementApi {
+    httpRequest;
+    baseUrl = process.env.WALLET_FUNDING_SETTLEMENT_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async settle(request) {
+        const url = `${this.baseUrl}/settlements`;
+        return await this.httpRequest.post(url, request);
+    }
+};
+WalletFundingSettlementApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], WalletFundingSettlementApi);
+export default WalletFundingSettlementApi;

package/bin/walletFundingSettlement/api/interfaces/IWalletFundingSettlementApi.d.ts

@@ -0,0 +1,25 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { SettleWalletFundingRequest, SettleWalletFundingResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+/**
+ * Cliente hacia `wallet-funding-settlement` (lambda privado VPC).
+ *
+ * Lo consume exclusivamente `equality-connector.WebhookPaymentManager`
+ * post `processor.walletFundingValidate()`. Ningún otro lambda conoce
+ * este cliente — el settlement está dedicado al money path wallet-funding
+ * cash-in.
+ *
+ * Endpoint backend en wallet-funding-settlement:
+ *   - POST /settlements   (privado VPC)
+ *
+ * Ver spec 15 (https://github.com/Fiado-Today/surekeep/blob/main/docs/4_specs/arquitectura/15_wallet_funding_settlement.md).
+ */
+export interface IWalletFundingSettlementApi {
+    /**
+     * Ejecuta el TransactWriteItems atómico (balance + payment status = APPLIED).
+     *
+     * Idempotente: si el payment ya estaba en APPLIED al momento del request,
+     * devuelve `alreadySettled=true` con el `processorTransactionNumber`
+     * cacheado sin re-creditar.
+     */
+    settle(request: SettleWalletFundingRequest): Promise<ApiGatewayResponse<SettleWalletFundingResponse>>;
+}

package/bin/walletFundingSettlement/api/interfaces/IWalletFundingSettlementApi.js

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

package/bin/walletFundingSettlement/index.d.ts

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

package/bin/walletFundingSettlement/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.35.0",
+  "version": "4.37.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": "^2.0.2",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.115.0",
+    "@fiado/type-kit": "^3.123.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -167,6 +167,8 @@ import { ITotpSecurityApi, TotpSecurityApi } from "./totp-security/index.js";
 import { IEqualityConnectorApi, EqualityConnectorApi } from "./equality-connector/index.js";
 // Contacts business — fuente de verdad de correos verificados (F2 gate UNIR)
 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";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -303,4 +305,8 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
 
     // Contacts business — fuente de verdad de correos verificados (F2 gate UNIR)
     bind<IContactsBusinessApi>("IContactsBusinessApi").to(ContactsBusinessApi);
+
+    // Wallet funding settlement — TransactWriteItems atómico del money path cash-in
+    // (consumido por equality-connector post processor.walletFundingValidate). Ver spec 15.
+    bind<IWalletFundingSettlementApi>("IWalletFundingSettlementApi").to(WalletFundingSettlementApi);
 });

package/src/transactionProcessor/api/TransactionProcessorApi.ts

@@ -21,6 +21,8 @@ import {
     GetWalletFundingLimitRequest,
     GetWalletFundingLimitResponse,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { PublishFiadoTxRequest, PublishFiadoTxResponse } from "@fiado/type-kit/bin/transactionProcessor/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>;
 
@@ -94,4 +96,18 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
         const url = `${this.baseUrl}wallet-funding/limit`;
         return await this.httpRequest.post(url, request);
     }
+
+    async creditBack(
+        request: RemittanceCreditBackRequest,
+    ): Promise<FiadoApiResponse<RemittanceCreditBackResponse>> {
+        const url = `${this.baseUrl}remittance/credit-back`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async publishFiadoTx(
+        request: PublishFiadoTxRequest,
+    ): Promise<ApiGatewayResponse<PublishFiadoTxResponse>> {
+        const url = `${this.baseUrl}wallet-funding/publish`;
+        return await this.httpRequest.post(url, request);
+    }
 }

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

@@ -20,6 +20,8 @@ import {
     GetWalletFundingLimitRequest,
     GetWalletFundingLimitResponse,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { RemittanceCreditBackRequest, RemittanceCreditBackResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { PublishFiadoTxRequest, PublishFiadoTxResponse } from "@fiado/type-kit/bin/transactionProcessor/index.js";
 type ProcessUpdateLevelRequest = import("@fiado/type-kit/bin/transactionProcessor/dtos/ProcessUpdateLevelRequest.js").default;
 
 export interface ITransactionProcessorApi {
@@ -74,4 +76,33 @@ export interface ITransactionProcessorApi {
     walletFundingGetLimit(
         request: GetWalletFundingLimitRequest,
     ): Promise<ApiGatewayResponse<GetWalletFundingLimitResponse>>;
+
+    /**
+     * Credit-back de cancelacion de remesa Uniteller. Lo invoca uniteller-connector
+     * cuando UNIR confirma el outcome terminal. Idempotente por idempotencyKey.
+     * Backend: POST /transaction-processor/remittance/credit-back (privado VPC).
+     */
+    creditBack(
+        request: RemittanceCreditBackRequest,
+    ): Promise<FiadoApiResponse<RemittanceCreditBackResponse>>;
+
+    /**
+     * Publica el evento FiadoTx del wallet-funding cash-in al SQS
+     * TRANSACTION_QUEUE para que transaction-business persista la
+     * tupla EQ_CASH_SA en FiadoTx_GT.
+     *
+     * Ownership del SQS sigue en el processor (el settlement NO publica,
+     * solo ejecuta el TransactWriteItems atómico). Best-effort: status
+     * FAILED indica que sqs.sendMessage falló — el caller debe loggear
+     * y continuar; el reconciler T+0 del connector recupera gaps.
+     *
+     * Backend: POST /transaction-processor/wallet-funding/publish (privado VPC).
+     * Consumido por equality-connector (post-settlement OK) y por su
+     * FiadoTxGapReconcilerCron.
+     *
+     * Ver spec 15 §6.2.
+     */
+    publishFiadoTx(
+        request: PublishFiadoTxRequest,
+    ): Promise<ApiGatewayResponse<PublishFiadoTxResponse>>;
 }

package/src/walletFundingSettlement/api/WalletFundingSettlementApi.ts

@@ -0,0 +1,22 @@
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    SettleWalletFundingRequest,
+    SettleWalletFundingResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IWalletFundingSettlementApi } from "./interfaces/IWalletFundingSettlementApi.js";
+
+@injectable()
+export default class WalletFundingSettlementApi implements IWalletFundingSettlementApi {
+    private readonly baseUrl = process.env.WALLET_FUNDING_SETTLEMENT_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async settle(
+        request: SettleWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<SettleWalletFundingResponse>> {
+        const url = `${this.baseUrl}/settlements`;
+        return await this.httpRequest.post(url, request);
+    }
+}

package/src/walletFundingSettlement/api/interfaces/IWalletFundingSettlementApi.ts

@@ -0,0 +1,31 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    SettleWalletFundingRequest,
+    SettleWalletFundingResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+
+/**
+ * Cliente hacia `wallet-funding-settlement` (lambda privado VPC).
+ *
+ * Lo consume exclusivamente `equality-connector.WebhookPaymentManager`
+ * post `processor.walletFundingValidate()`. Ningún otro lambda conoce
+ * este cliente — el settlement está dedicado al money path wallet-funding
+ * cash-in.
+ *
+ * Endpoint backend en wallet-funding-settlement:
+ *   - POST /settlements   (privado VPC)
+ *
+ * Ver spec 15 (https://github.com/Fiado-Today/surekeep/blob/main/docs/4_specs/arquitectura/15_wallet_funding_settlement.md).
+ */
+export interface IWalletFundingSettlementApi {
+    /**
+     * Ejecuta el TransactWriteItems atómico (balance + payment status = APPLIED).
+     *
+     * Idempotente: si el payment ya estaba en APPLIED al momento del request,
+     * devuelve `alreadySettled=true` con el `processorTransactionNumber`
+     * cacheado sin re-creditar.
+     */
+    settle(
+        request: SettleWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<SettleWalletFundingResponse>>;
+}

package/src/walletFundingSettlement/index.ts

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