@fiado/api-invoker 4.41.0 → 4.43.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/index.js";
-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, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { CohortCountRequest, CohortCountResponse, 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;
@@ -67,4 +67,13 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
     backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
     backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>>;
+    kycListUsers(filters?: {
+        status?: string;
+        search?: string;
+        pageSize?: number;
+        index?: string;
+    }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
+    kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
+    kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
+    cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
 }

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

@@ -149,6 +149,22 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/users/limits`;
         return await this.httpRequest.get(url, { directoryIds: directoryIds.join(",") });
     }
+    async kycListUsers(filters) {
+        const url = `${this.baseUrl}/backoffice/kyc/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+    async kycUserDetail(directoryId) {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+    async kycRefreshUser(directoryId) {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/refresh`;
+        return await this.httpRequest.post(url, {});
+    }
+    async cohortCount(request) {
+        const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 UnitellerConnectorApi = __decorate([
     injectable(),

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 { 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, 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>>;
@@ -112,4 +112,17 @@ export interface IUnitellerConnectorApi {
     backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
     /** Batch de límites para la tabla de Límites (CSV de directoryIds). */
     backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>>;
+    /** Lista de usuarios KYC. Filtros: status (default PENDING en el connector) | search (email o directoryId); pageSize; index cursor opaco. */
+    kycListUsers(filters?: {
+        status?: string;
+        search?: string;
+        pageSize?: number;
+        index?: string;
+    }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
+    /** Detalle 360 KYC (identidad + snapshot UNIR + último rechazo). 404 si no existe. */
+    kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
+    /** Refresca el perfil del usuario desde UNIR (EP-34). Rate-limited 5/min por directoryId en el connector. */
+    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>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.41.0",
+  "version": "4.43.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.133.0",
+    "@fiado/type-kit": "^3.141.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {
@@ -45,6 +45,8 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^25.9.1",
     "aws-sdk-client-mock": "^4.1.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.4",
     "inversify": "^8.1.0",
     "jest": "^30.4.2",
     "reflect-metadata": "^0.2.2",

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

@@ -3,6 +3,11 @@ 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,
+    KycUserDetail,
+    KycUsersListResponse,
+    RefreshUserProfileResponse,
     RemittanceAddBeneficiaryRequest,
     RemittanceBackofficeDashboardSummary,
     RemittanceBackofficeStats,
@@ -211,6 +216,26 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/users/limits`;
         return await this.httpRequest.get(url, { directoryIds: directoryIds.join(",") });
     }
+
+    async kycListUsers(filters?: { status?: string; search?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<KycUsersListResponse>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/refresh`;
+        return await this.httpRequest.post(url, {});
+    }
+
+    async cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
+        return await this.httpRequest.post(url, request);
+    }
 }
 
 /** Quita las keys undefined para no mandar query params vacíos. */

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

@@ -1,6 +1,11 @@
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {
+    CohortCountRequest,
+    CohortCountResponse,
+    KycUserDetail,
+    KycUsersListResponse,
+    RefreshUserProfileResponse,
     RemittanceAddBeneficiaryRequest,
     RemittanceBackofficeDashboardSummary,
     RemittanceBackofficeStats,
@@ -163,4 +168,16 @@ export interface IUnitellerConnectorApi {
     backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
     /** Batch de límites para la tabla de Límites (CSV de directoryIds). */
     backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>>;
+
+    // ─── Aceptación (KYC monitoring, SPEC_06 — read-only + refresh on-demand) ──────
+    /** Lista de usuarios KYC. Filtros: status (default PENDING en el connector) | search (email o directoryId); pageSize; index cursor opaco. */
+    kycListUsers(filters?: { status?: string; search?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
+    /** Detalle 360 KYC (identidad + snapshot UNIR + último rechazo). 404 si no existe. */
+    kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
+    /** Refresca el perfil del usuario desde UNIR (EP-34). Rate-limited 5/min por directoryId en el connector. */
+    kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
+
+    // ─── 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>>;
 }