@fiado/api-invoker 4.45.0 → 4.48.0

package/bin/identity/IdentityApi.d.ts

@@ -1,6 +1,6 @@
 import { IIdentityApi } from "./interfaces/IIdentityApi.js";
 import { IHttpRequest } from "@fiado/http-client";
-import { PeopleUpdateRequest, UploadDocumentRequest } from "@fiado/type-kit/bin/identity/index.js";
+import { PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse, PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse } from "@fiado/type-kit/bin/identity/index.js";
 export declare class IdentityApi implements IIdentityApi {
     private httpRequest;
     private readonly baseUrl;
@@ -13,4 +13,8 @@ export declare class IdentityApi implements IIdentityApi {
     getPeopleByFullName(fullName: string): Promise<any>;
     privateGetDocumentsUrlSigned(directoryId: string, documentNames: string[]): Promise<any>;
     getUserDocuments(directoryId: string): Promise<any>;
+    privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse>;
+    privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]>;
+    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse>;
+    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void>;
 }

package/bin/identity/IdentityApi.js

@@ -75,6 +75,38 @@ let IdentityApi = class IdentityApi {
         const url = `${this.baseUrl}identities/private/people/${directoryId}/documents`;
         return await this.httpRequest.get(url);
     }
+    // ── Gemelos PRIVATE de los endpoints de agentes (proxy RBAC v2, DEC-PROT-011) ──
+    async privateGetPeopleByDirectoryId(directoryId) {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.");
+        }
+        const url = `${this.baseUrl}identities/private/agents/people/${directoryId}`;
+        return await this.httpRequest.get(url);
+    }
+    async privateGetLastAgentDocument(directoryId) {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.");
+        }
+        const url = `${this.baseUrl}identities/private/agents/documents/${directoryId}/last`;
+        return await this.httpRequest.get(url);
+    }
+    async privateUploadAgentDocument(directoryId, actorDirectoryId, document) {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.");
+        }
+        if (!actorDirectoryId) {
+            throw new Error("actorDirectoryId is required.");
+        }
+        const url = `${this.baseUrl}identities/private/agents/documents/${directoryId}/upload?actorDirectoryId=${encodeURIComponent(actorDirectoryId)}`;
+        return await this.httpRequest.put(url, document);
+    }
+    async privateUpdatePeopleSelfVerified(directoryId, data) {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.");
+        }
+        const url = `${this.baseUrl}identities/private/agents/people/${directoryId}/selfverified`;
+        await this.httpRequest.put(url, data);
+    }
 };
 IdentityApi = __decorate([
     injectable(),

package/bin/identity/interfaces/IIdentityApi.d.ts

@@ -1,4 +1,4 @@
-import { PeopleUpdateRequest, UploadDocumentRequest } from "@fiado/type-kit/bin/identity/index.js";
+import { PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse, PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse } from "@fiado/type-kit/bin/identity/index.js";
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
  */
@@ -35,4 +35,12 @@ export interface IIdentityApi {
      * Retorna { directoryId, keys: string[] }.
      */
     getUserDocuments(directoryId: string): Promise<any>;
+    /** Gemelo private de agentGetPeopleByDirectoryId (con masking del manager). */
+    privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse>;
+    /** Gemelo private de getUserDocumentsAgents (último documento). */
+    privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]>;
+    /** Gemelo private de uploadDocumentAgent. actorDirectoryId = autor de la observación (DEC-PROT-012). */
+    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse>;
+    /** Gemelo private de agentPutPeoplePeopleIdSelfVerified. */
+    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void>;
 }

package/bin/onboarding/api/OnboardingApi.d.ts

@@ -1,9 +1,10 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { IOnboardingApi } from "./interfaces/IOnboardingApi.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import { IOnboardingApi, OnboardingStepsEnvelope } from "./interfaces/IOnboardingApi.js";
 export default class OnboardingApi implements IOnboardingApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     getByReferralDirectoryId(referralDirectoryId: string): Promise<any>;
     delete(id: string): Promise<any>;
+    getOnboardingSteps(directoryId: string, countryId: string): Promise<OnboardingStepsEnvelope>;
 }

package/bin/onboarding/api/OnboardingApi.js

@@ -25,6 +25,11 @@ let OnboardingApi = class OnboardingApi {
         const url = `${this.baseUrl}onboarding/${id}`;
         return await this.httpRequest.delete(`${url}`);
     }
+    async getOnboardingSteps(directoryId, countryId) {
+        return await this.httpRequest.get(`${this.baseUrl}agents/steps`, {
+            directoryId, countryId, typeOfDirectoryId: "USER",
+        });
+    }
 };
 OnboardingApi = __decorate([
     injectable(),

package/bin/onboarding/api/interfaces/IOnboardingApi.d.ts

@@ -1,4 +1,13 @@
+export interface OnboardingStepsEnvelope {
+    code: string;
+    data: Record<string, unknown> | null;
+    msg?: string;
+    description?: string;
+    date?: string;
+    httpCode?: number;
+}
 export interface IOnboardingApi {
     delete(id: string): Promise<any>;
     getByReferralDirectoryId(referralDirectoryId: string): Promise<any>;
+    getOnboardingSteps(directoryId: string, countryId: string): Promise<OnboardingStepsEnvelope>;
 }

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, 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, 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;
@@ -79,4 +79,5 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
     wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>>;
     pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>>;
+    promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>>;
 }

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

@@ -177,6 +177,10 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/config/pricing/metrics`;
         return await this.httpRequest.post(url, request);
     }
+    async promotionReach(request) {
+        const url = `${this.baseUrl}/backoffice/config/promotions/reach`;
+        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 { CohortCountRequest, CohortCountResponse, PricingMetricsRequest, PricingMetricsResponse, 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, 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>>;
@@ -131,4 +131,6 @@ export interface IUnitellerConnectorApi {
     wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>>;
     /** {clientCount, volMonthUSD} del subconjunto de directoryIds FILTRADO por corredor (countryISO). */
     pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>>;
+    /** Alcance {reach, total} de una audiencia: directoryIds × conditions × corridor (dimensión ausente = no filtra). */
+    promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.45.0",
+  "version": "4.48.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.153.0",
+    "@fiado/type-kit": "^3.156.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/identity/IdentityApi.ts

@@ -2,7 +2,10 @@ import {inject, injectable} from "inversify";
 import {IIdentityApi} from "./interfaces/IIdentityApi.js";
 import {IHttpRequest} from "@fiado/http-client";
 import dotenv from 'dotenv';
-import {PeopleUpdateRequest, UploadDocumentRequest} from "@fiado/type-kit/bin/identity/index.js";
+import {
+    PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse,
+    PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse,
+} from "@fiado/type-kit/bin/identity/index.js";
 
 dotenv.config();
 
@@ -93,4 +96,40 @@ export class IdentityApi implements IIdentityApi {
         const url = `${this.baseUrl}identities/private/people/${directoryId}/documents`;
         return await this.httpRequest.get(url);
     }
+
+    // ── Gemelos PRIVATE de los endpoints de agentes (proxy RBAC v2, DEC-PROT-011) ──
+    async privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse> {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.")
+        }
+        const url = `${this.baseUrl}identities/private/agents/people/${directoryId}`;
+        return await this.httpRequest.get<PeopleResponse>(url);
+    }
+
+    async privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]> {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.")
+        }
+        const url = `${this.baseUrl}identities/private/agents/documents/${directoryId}/last`;
+        return await this.httpRequest.get<AgentDocumentKeyResponse[]>(url);
+    }
+
+    async privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse> {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.")
+        }
+        if (!actorDirectoryId) {
+            throw new Error("actorDirectoryId is required.")
+        }
+        const url = `${this.baseUrl}identities/private/agents/documents/${directoryId}/upload?actorDirectoryId=${encodeURIComponent(actorDirectoryId)}`;
+        return await this.httpRequest.put<DocumentUploadResponse>(url, document);
+    }
+
+    async privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void> {
+        if (!directoryId) {
+            throw new Error("Directory ID is required.")
+        }
+        const url = `${this.baseUrl}identities/private/agents/people/${directoryId}/selfverified`;
+        await this.httpRequest.put<void>(url, data);
+    }
 }

package/src/identity/interfaces/IIdentityApi.ts

@@ -1,4 +1,7 @@
-import {PeopleUpdateRequest, UploadDocumentRequest} from "@fiado/type-kit/bin/identity/index.js";
+import {
+    PeopleUpdateRequest, UploadDocumentRequest, PeopleResponse,
+    PeopleSelfVerifiedRequest, AgentDocumentKeyResponse, DocumentUploadResponse,
+} from "@fiado/type-kit/bin/identity/index.js";
 
 /**
  * Interfaz para el servicio Directory que permite operaciones sobre directorios.
@@ -43,4 +46,14 @@ export interface IIdentityApi {
      * Retorna { directoryId, keys: string[] }.
      */
     getUserDocuments(directoryId: string): Promise<any>
+
+    // ── Gemelos PRIVATE de los endpoints de agentes (proxy RBAC v2, DEC-PROT-011) ──
+    /** Gemelo private de agentGetPeopleByDirectoryId (con masking del manager). */
+    privateGetPeopleByDirectoryId(directoryId: string): Promise<PeopleResponse>;
+    /** Gemelo private de getUserDocumentsAgents (último documento). */
+    privateGetLastAgentDocument(directoryId: string): Promise<AgentDocumentKeyResponse[]>;
+    /** Gemelo private de uploadDocumentAgent. actorDirectoryId = autor de la observación (DEC-PROT-012). */
+    privateUploadAgentDocument(directoryId: string, actorDirectoryId: string, document: UploadDocumentRequest): Promise<DocumentUploadResponse>;
+    /** Gemelo private de agentPutPeoplePeopleIdSelfVerified. */
+    privateUpdatePeopleSelfVerified(directoryId: string, data: PeopleSelfVerifiedRequest): Promise<void>;
 }

package/src/onboarding/api/OnboardingApi.ts

@@ -1,6 +1,6 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { IOnboardingApi } from "./interfaces/IOnboardingApi.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import { IOnboardingApi, OnboardingStepsEnvelope } from "./interfaces/IOnboardingApi.js";
 
 
 @injectable()
@@ -20,4 +20,10 @@ export default class OnboardingApi implements IOnboardingApi {
         const url = `${this.baseUrl}onboarding/${id}`;
         return await this.httpRequest.delete(`${url}`);
     }
+
+    async getOnboardingSteps(directoryId: string, countryId: string): Promise<OnboardingStepsEnvelope> {
+        return await this.httpRequest.get<OnboardingStepsEnvelope>(`${this.baseUrl}agents/steps`, {
+            directoryId, countryId, typeOfDirectoryId: "USER",
+        });
+    }
 }

package/src/onboarding/api/interfaces/IOnboardingApi.ts

@@ -1,4 +1,14 @@
+export interface OnboardingStepsEnvelope {
+    code: string;
+    data: Record<string, unknown> | null;
+    msg?: string;
+    description?: string;
+    date?: string;
+    httpCode?: number;
+}
+
 export interface IOnboardingApi {
     delete(id: string): Promise<any>
     getByReferralDirectoryId(referralDirectoryId: string): Promise<any>
-}
+    getOnboardingSteps(directoryId: string, countryId: string): Promise<OnboardingStepsEnvelope>
+}

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

@@ -7,6 +7,8 @@ import {
     CohortCountResponse,
     PricingMetricsRequest,
     PricingMetricsResponse,
+    PromotionReachRequest,
+    PromotionReachResponse,
     SegmentMetricsRequest,
     SegmentMetricsResponse,
     WholesaleRateRequest,
@@ -257,6 +259,11 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/config/pricing/metrics`;
         return await this.httpRequest.post(url, request);
     }
+
+    async promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/promotions/reach`;
+        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

@@ -5,6 +5,8 @@ import {
     CohortCountResponse,
     PricingMetricsRequest,
     PricingMetricsResponse,
+    PromotionReachRequest,
+    PromotionReachResponse,
     SegmentMetricsRequest,
     SegmentMetricsResponse,
     WholesaleRateRequest,
@@ -196,4 +198,8 @@ export interface IUnitellerConnectorApi {
     wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>>;
     /** {clientCount, volMonthUSD} del subconjunto de directoryIds FILTRADO por corredor (countryISO). */
     pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>>;
+
+    // ─── Promociones (Dashboard Ops · Variables Operativas — puente Fase A) ─────────
+    /** Alcance {reach, total} de una audiencia: directoryIds × conditions × corridor (dimensión ausente = no filtra). */
+    promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>>;
 }