@fiado/api-invoker 4.42.0 → 4.44.0

package/bin/group/GroupApi.d.ts

@@ -17,5 +17,6 @@ export declare class GroupApi implements IGroupApi {
     }): Promise<any>;
     members(params: GroupAddDirectoryRequest): Promise<any>;
     findById(id: string): Promise<any>;
+    findAllWithCounts(): Promise<any>;
 }
 export {};

package/bin/group/GroupApi.js

@@ -60,6 +60,10 @@ let GroupApi = class GroupApi {
         const url = `${this.baseUrl}groups/getById/${id}`;
         return await this.httpRequest.get(`${url}`);
     }
+    async findAllWithCounts() {
+        const url = `${this.baseUrl}groups/counts`;
+        return await this.httpRequest.get(`${url}`);
+    }
 };
 GroupApi = __decorate([
     injectable(),

package/bin/group/interfaces/IGroupApi.d.ts

@@ -1,5 +1,5 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-import { GroupAddDirectoryRequest, GroupResponse } from "@fiado/type-kit/bin/group/index.js";
+import { GroupAddDirectoryRequest, GroupCountsResponse, GroupResponse } from "@fiado/type-kit/bin/group/index.js";
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
  */
@@ -31,5 +31,10 @@ export interface IGroupApi {
      * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
      */
     findById(id: string): Promise<FiadoApiResponse<GroupResponse>>;
+    /**
+     * Dashboard Ops Segmentos — todos los grupos con su # de miembros
+     * (GET groups/counts, privado en fiado-group-business).
+     */
+    findAllWithCounts(): Promise<FiadoApiResponse<GroupCountsResponse>>;
 }
 export {};

package/bin/onboarding-business/api/OnboardingBusinessApi.d.ts

@@ -25,4 +25,6 @@ export default class OnboardingBusinessApi implements IOnboardingBusinessApi {
         pageSize?: string;
     }): Promise<any>;
     getBatchByIds(ids: string[]): Promise<any>;
+    tagsSummary(): Promise<any>;
+    tagsByDirectories(directoryIds: string[]): Promise<any>;
 }

package/bin/onboarding-business/api/OnboardingBusinessApi.js

@@ -93,6 +93,14 @@ let OnboardingBusinessApi = class OnboardingBusinessApi {
         const url = `${this.baseUrl}private/getBatchByIds`;
         return await this.httpRequest.get(`${url}`, { ids });
     }
+    async tagsSummary() {
+        const url = `${this.baseUrl}private/tags/summary`;
+        return await this.httpRequest.get(`${url}`);
+    }
+    async tagsByDirectories(directoryIds) {
+        const url = `${this.baseUrl}private/tags/by-directories`;
+        return await this.httpRequest.post(`${url}`, { directoryIds });
+    }
 };
 OnboardingBusinessApi = __decorate([
     injectable(),

package/bin/onboarding-business/api/interfaces/IOnboardingBusinessApi.d.ts

@@ -20,4 +20,8 @@ export interface IOnboardingBusinessApi {
         pageSize?: string;
     }): Promise<any>;
     getBatchByIds(ids: string[]): Promise<any>;
+    /** Dashboard Ops Segmentos — tags distintos + count c/u (TagsSummaryResponse en data). */
+    tagsSummary(): Promise<any>;
+    /** Dashboard Ops Segmentos — tags por usuario para un batch de directoryIds (TagsByDirectoriesResponse en data). */
+    tagsByDirectories(directoryIds: string[]): Promise<any>;
 }

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 { 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, SegmentMetricsRequest, SegmentMetricsResponse, 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;
@@ -75,4 +75,6 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
     kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
     kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
+    cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
+    segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
 }

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

@@ -161,6 +161,14 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         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);
+    }
+    async segmentMetrics(request) {
+        const url = `${this.baseUrl}/backoffice/config/segments/metrics`;
+        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 { 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, SegmentMetricsRequest, SegmentMetricsResponse, 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>>;
@@ -123,4 +123,8 @@ export interface IUnitellerConnectorApi {
     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>>;
+    /** {clientCount, volMonthUSD} para el subconjunto de RemittanceUsers del segmento (mes calendario, sin canceladas). */
+    segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.42.0",
+  "version": "4.44.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.138.0",
+    "@fiado/type-kit": "^3.145.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/group/GroupApi.ts

@@ -67,4 +67,9 @@ export class GroupApi implements IGroupApi {
         const url = `${this.baseUrl}groups/getById/${id}`;
         return await this.httpRequest.get(`${url}`);
     }
+
+    async findAllWithCounts(): Promise<any> {
+        const url = `${this.baseUrl}groups/counts`;
+        return await this.httpRequest.get(`${url}`);
+    }
 }

package/src/group/interfaces/IGroupApi.ts

@@ -1,5 +1,5 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-import { GroupAddDirectoryRequest, GroupResponse } from "@fiado/type-kit/bin/group/index.js";
+import { GroupAddDirectoryRequest, GroupCountsResponse, GroupResponse } from "@fiado/type-kit/bin/group/index.js";
 
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
@@ -37,4 +37,11 @@ export interface IGroupApi {
      * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
      */
     findById(id: string): Promise<FiadoApiResponse<GroupResponse>>;
+
+
+    /**
+     * Dashboard Ops Segmentos — todos los grupos con su # de miembros
+     * (GET groups/counts, privado en fiado-group-business).
+     */
+    findAllWithCounts(): Promise<FiadoApiResponse<GroupCountsResponse>>;
 }

package/src/onboarding-business/api/OnboardingBusinessApi.ts

@@ -89,8 +89,18 @@ export default class OnboardingBusinessApi implements IOnboardingBusinessApi {
     async getBatchByIds(ids: string[]): Promise<any> {
         const url = `${this.baseUrl}private/getBatchByIds`;
         return await this.httpRequest.get(`${url}`, { ids });
-    }  
- 
+    }
+
+    async tagsSummary(): Promise<any> {
+        const url = `${this.baseUrl}private/tags/summary`;
+        return await this.httpRequest.get(`${url}`);
+    }
+
+    async tagsByDirectories(directoryIds: string[]): Promise<any> {
+        const url = `${this.baseUrl}private/tags/by-directories`;
+        return await this.httpRequest.post(`${url}`, { directoryIds });
+    }
+
 }
 
 

package/src/onboarding-business/api/interfaces/IOnboardingBusinessApi.ts

@@ -7,4 +7,9 @@ export interface IOnboardingBusinessApi {
     getList(params:{index?: string; pageSize?: string; }): Promise<any>
 
     getBatchByIds(ids: string[]): Promise<any>
+
+    /** Dashboard Ops Segmentos — tags distintos + count c/u (TagsSummaryResponse en data). */
+    tagsSummary(): Promise<any>
+    /** Dashboard Ops Segmentos — tags por usuario para un batch de directoryIds (TagsByDirectoriesResponse en data). */
+    tagsByDirectories(directoryIds: string[]): Promise<any>
 }

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

@@ -3,6 +3,10 @@ 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,
+    SegmentMetricsRequest,
+    SegmentMetricsResponse,
     KycUserDetail,
     KycUsersListResponse,
     RefreshUserProfileResponse,
@@ -229,6 +233,16 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         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);
+    }
+
+    async segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/segments/metrics`;
+        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,10 @@
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {
+    CohortCountRequest,
+    CohortCountResponse,
+    SegmentMetricsRequest,
+    SegmentMetricsResponse,
     KycUserDetail,
     KycUsersListResponse,
     RefreshUserProfileResponse,
@@ -174,4 +178,12 @@ export interface IUnitellerConnectorApi {
     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>>;
+
+    // ─── Segmentos (Dashboard Ops — puente de métricas Opción A) ────────────────────
+    /** {clientCount, volMonthUSD} para el subconjunto de RemittanceUsers del segmento (mes calendario, sin canceladas). */
+    segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
 }