@fiado/api-invoker 4.14.0 → 4.15.0

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";
-import { RemittanceAddBeneficiaryRequest, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest } from "@fiado/type-kit/bin/remittance";
+import { 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 } from "@fiado/type-kit/bin/remittance";
 import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi";
 export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     private httpRequest;
@@ -44,4 +44,24 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{
         sent: boolean;
     }>>;
+    backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>>;
+    backofficeListUsers(filters?: {
+        status?: string;
+        email?: string;
+        pageSize?: number;
+        index?: string;
+    }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>>;
+    backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>>;
+    backofficeListTransactions(filters?: {
+        txNumber?: string;
+        directoryId?: string;
+        status?: string;
+        countryISO?: string;
+        from?: string;
+        to?: string;
+        pageSize?: number;
+        index?: string;
+    }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>>;
+    backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>>;
+    backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
 }

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

@@ -115,6 +115,30 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/sms`;
         return await this.httpRequest.post(url, { directoryId, ...request });
     }
+    async backofficeDashboard() {
+        const url = `${this.baseUrl}/backoffice/dashboard`;
+        return await this.httpRequest.get(url);
+    }
+    async backofficeListUsers(filters) {
+        const url = `${this.baseUrl}/backoffice/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+    async backofficeUserDetail(directoryId) {
+        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+    async backofficeListTransactions(filters) {
+        const url = `${this.baseUrl}/backoffice/transactions`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+    async backofficeTransactionDetail(txNumber) {
+        const url = `${this.baseUrl}/backoffice/transactions/${encodeURIComponent(txNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+    async backofficeStats(period) {
+        const url = `${this.baseUrl}/backoffice/stats`;
+        return await this.httpRequest.get(url, { period });
+    }
 };
 UnitellerConnectorApi = __decorate([
     (0, inversify_1.injectable)(),
@@ -122,3 +146,10 @@ UnitellerConnectorApi = __decorate([
     __metadata("design:paramtypes", [Object])
 ], UnitellerConnectorApi);
 exports.default = UnitellerConnectorApi;
+/** Quita las keys undefined para no mandar query params vacíos. */
+function dropUndefined(params) {
+    if (!params)
+        return undefined;
+    const clean = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== undefined));
+    return Object.keys(clean).length > 0 ? clean : undefined;
+}

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";
-import { RemittanceAddBeneficiaryRequest, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest } from "@fiado/type-kit/bin/remittance";
+import { 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 } from "@fiado/type-kit/bin/remittance";
 export interface IUnitellerConnectorApi {
     /** Estado del módulo remesas para un directoryId. */
     getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>>;
@@ -81,4 +81,26 @@ export interface IUnitellerConnectorApi {
     smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{
         sent: boolean;
     }>>;
+    backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>>;
+    /** Filtros: status (default ACTIVE en el connector) | email (lookup exacto); pageSize 1-100; index cursor opaco. */
+    backofficeListUsers(filters?: {
+        status?: string;
+        email?: string;
+        pageSize?: number;
+        index?: string;
+    }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>>;
+    backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>>;
+    /** Requiere al menos uno de txNumber | directoryId | status (el connector responde 400 si no). */
+    backofficeListTransactions(filters?: {
+        txNumber?: string;
+        directoryId?: string;
+        status?: string;
+        countryISO?: string;
+        from?: string;
+        to?: string;
+        pageSize?: number;
+        index?: string;
+    }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>>;
+    backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>>;
+    backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.14.0",
+  "version": "4.15.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",
@@ -17,7 +17,7 @@
     "@fiado/gateway-adapter": "^2.0.0",
     "@fiado/http-client": "^2.0.0",
     "@fiado/logger": "^1.0.3",
-    "@fiado/type-kit": "^3.67.0",
+    "@fiado/type-kit": "^3.68.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

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

@@ -4,6 +4,13 @@ import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter";
 import {
     RemittanceAddBeneficiaryRequest,
+    RemittanceBackofficeDashboardSummary,
+    RemittanceBackofficeStats,
+    RemittanceBackofficeStatsPeriod,
+    RemittanceBackofficeTransaction,
+    RemittanceBackofficeTxListResponse,
+    RemittanceBackofficeUserDetail,
+    RemittanceBackofficeUserListResponse,
     RemittanceBeneficiary,
     RemittanceCancelRequest,
     RemittanceCancelResponse,
@@ -154,4 +161,43 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/sms`;
         return await this.httpRequest.post(url, { directoryId, ...request });
     }
+
+    async backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>> {
+        const url = `${this.baseUrl}/backoffice/dashboard`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeListUsers(filters?: { status?: string; email?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>> {
+        const url = `${this.baseUrl}/backoffice/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>> {
+        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeListTransactions(filters?: { txNumber?: string; directoryId?: string; status?: string; countryISO?: string; from?: string; to?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>> {
+        const url = `${this.baseUrl}/backoffice/transactions`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>> {
+        const url = `${this.baseUrl}/backoffice/transactions/${encodeURIComponent(txNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>> {
+        const url = `${this.baseUrl}/backoffice/stats`;
+        return await this.httpRequest.get(url, { period });
+    }
+}
+
+/** Quita las keys undefined para no mandar query params vacíos. */
+function dropUndefined(params?: Record<string, string | number | undefined>): Record<string, string | number> | undefined {
+    if (!params) return undefined;
+    const clean = Object.fromEntries(
+        Object.entries(params).filter(([, value]) => value !== undefined),
+    ) as Record<string, string | number>;
+    return Object.keys(clean).length > 0 ? clean : undefined;
 }

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

@@ -2,6 +2,13 @@ import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter";
 import {
     RemittanceAddBeneficiaryRequest,
+    RemittanceBackofficeDashboardSummary,
+    RemittanceBackofficeStats,
+    RemittanceBackofficeStatsPeriod,
+    RemittanceBackofficeTransaction,
+    RemittanceBackofficeTxListResponse,
+    RemittanceBackofficeUserDetail,
+    RemittanceBackofficeUserListResponse,
     RemittanceBeneficiary,
     RemittanceCancelRequest,
     RemittanceCancelResponse,
@@ -130,4 +137,15 @@ export interface IUnitellerConnectorApi {
 
     /** SMS de UNIR al beneficiario de la tx (max 3 por tx). ⚠ gated por smoke. */
     smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{ sent: boolean }>>;
+
+    // ─── Backoffice (F9, read-only — D2: el backoffice frontend entra por benefits) ─
+
+    backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>>;
+    /** Filtros: status (default ACTIVE en el connector) | email (lookup exacto); pageSize 1-100; index cursor opaco. */
+    backofficeListUsers(filters?: { status?: string; email?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>>;
+    backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>>;
+    /** Requiere al menos uno de txNumber | directoryId | status (el connector responde 400 si no). */
+    backofficeListTransactions(filters?: { txNumber?: string; directoryId?: string; status?: string; countryISO?: string; from?: string; to?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>>;
+    backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>>;
+    backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
 }