@fiado/api-invoker 4.19.0 → 4.20.1

package/bin/milestone-business/api/MilestoneBusinessApi.d.ts

@@ -1,9 +1,10 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import { Milestone, MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
 import { IMilestoneBusinessApi } from "./interfaces/IMilestoneBusinessApi.js";
 export default class MilestoneBusinessApi implements IMilestoneBusinessApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     listByEventKeyAndDateRange(eventKey: string, params: MilestonesByEventKeyDateRangeParams): Promise<any>;
+    listByDirectoryIds(directoryIds: string[]): Promise<Record<string, Milestone[]>>;
 }

package/bin/milestone-business/api/MilestoneBusinessApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+import { MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH, } from "@fiado/type-kit/bin/milestone-business/index.js";
 let MilestoneBusinessApi = class MilestoneBusinessApi {
     httpRequest;
     baseUrl = process.env.MILESTONE_BUSINESS_LAMBDA_URL || "";
@@ -31,6 +32,21 @@ let MilestoneBusinessApi = class MilestoneBusinessApi {
         const url = `${this.baseUrl}private/milestones/by-event-key?${queryParams.toString()}`;
         return await this.httpRequest.get(url);
     }
+    async listByDirectoryIds(directoryIds) {
+        // Dedup preservando el orden de aparición.
+        const uniqueIds = Array.from(new Set(directoryIds));
+        if (uniqueIds.length === 0)
+            return {};
+        const url = `${this.baseUrl}private/milestones/by-directory-ids`;
+        const merged = {};
+        // Chunking en lotes de MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH (cap del endpoint batch).
+        for (let i = 0; i < uniqueIds.length; i += MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH) {
+            const batch = uniqueIds.slice(i, i + MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH);
+            const partial = await this.httpRequest.post(url, { directoryIds: batch });
+            Object.assign(merged, partial);
+        }
+        return merged;
+    }
 };
 MilestoneBusinessApi = __decorate([
     injectable(),

package/bin/milestone-business/api/interfaces/IMilestoneBusinessApi.d.ts

@@ -1,8 +1,15 @@
-import { MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
+import { Milestone, MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
 export interface IMilestoneBusinessApi {
     /**
      * Lista milestones por eventKey filtrados por rango de eventDate.
      * Usado por el flujo de cálculo de comisiones (eventKey=HomeAzul para USA, HomeRosa para MEX).
      */
     listByEventKeyAndDateRange(eventKey: string, params: MilestonesByEventKeyDateRangeParams): Promise<any>;
+    /**
+     * Devuelve, por cada directoryId, el array COMPLETO de milestones (mapa
+     * directoryId -> Milestone[]). Hace POST a `private/milestones/by-directory-ids`.
+     * Parte la lista en lotes de 100 (cap del endpoint batch), deduplica los ids
+     * y mergea los mapas parciales. Una sola llamada por lote (evita N+1).
+     */
+    listByDirectoryIds(directoryIds: string[]): Promise<Record<string, Milestone[]>>;
 }

package/bin/riskProfile/api/RiskProfileApi.d.ts

@@ -4,7 +4,7 @@ import { CreatePrivateAlarm, CreateRiskProfileRequest } from "@fiado/type-kit/bi
 type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
 type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
 import { ResponseOptions } from "@fiado/gateway-adapter";
-import { SetCustomAlarmRequest, SetCustomAlarmResponse, SetDeclaredIncomeRequest, SetDeclaredIncomeResponse, SetManualRiskLevelRequest, SetManualRiskLevelResponse } from "@fiado/type-kit/bin/riskProfile/index.js";
+import { SetCustomAlarmRequest, SetCustomAlarmResponse, SetDeclaredIncomeRequest, SetDeclaredIncomeResponse, SetManualRiskLevelRequest, SetManualRiskLevelResponse, CreateClientFinancialHistoryRequest, ClientFinancialHistoryResponse, ListClientFinancialHistoryResponse } from "@fiado/type-kit/bin/riskProfile/index.js";
 export default class RiskProfileApi implements IRiskProfileApi {
     private httpRequest;
     private readonly baseUrl;
@@ -17,5 +17,18 @@ export default class RiskProfileApi implements IRiskProfileApi {
     setManualRiskLevel(directoryId: string, request: SetManualRiskLevelRequest): Promise<ResponseOptions<SetManualRiskLevelResponse>>;
     setCustomAlarm(directoryId: string, request: SetCustomAlarmRequest): Promise<ResponseOptions<SetCustomAlarmResponse>>;
     setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>>;
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>>;
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     */
+    listClientFinancialHistory(directoryId: string, params?: {
+        limit?: number;
+        continuationToken?: string;
+    }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>>;
 }
 export {};

package/bin/riskProfile/api/RiskProfileApi.js

@@ -49,6 +49,28 @@ let RiskProfileApi = class RiskProfileApi {
         const url = `${this.baseUrl}/profiles/${directoryId}/declared-income`;
         return await this.httpRequest.put(url, request);
     }
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    async createClientFinancialHistory(directoryId, request) {
+        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history`;
+        return await this.httpRequest.post(url, request);
+    }
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     */
+    async listClientFinancialHistory(directoryId, params) {
+        const query = [];
+        if (params?.limit !== undefined)
+            query.push(`limit=${params.limit}`);
+        if (params?.continuationToken)
+            query.push(`continuationToken=${encodeURIComponent(params.continuationToken)}`);
+        const qs = query.length ? `?${query.join("&")}` : "";
+        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history${qs}`;
+        return await this.httpRequest.get(url);
+    }
 };
 RiskProfileApi = __decorate([
     injectable(),

package/bin/riskProfile/api/interfaces/IRiskProfileApi.d.ts

@@ -2,7 +2,7 @@ import { CreatePrivateAlarm, CreateRiskProfileRequest } from "@fiado/type-kit/bi
 type UpdateAlarmProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateAlarmProfileRequest.js").default;
 type UpdateRiskProfileRequest = import("@fiado/type-kit/bin/riskProfile/dtos/UpdateRiskProfileRequest.js").default;
 import { ResponseOptions } from "@fiado/gateway-adapter";
-import { SetCustomAlarmRequest, SetCustomAlarmResponse, SetDeclaredIncomeRequest, SetDeclaredIncomeResponse, SetManualRiskLevelRequest, SetManualRiskLevelResponse } from "@fiado/type-kit/bin/riskProfile/index.js";
+import { SetCustomAlarmRequest, SetCustomAlarmResponse, SetDeclaredIncomeRequest, SetDeclaredIncomeResponse, SetManualRiskLevelRequest, SetManualRiskLevelResponse, CreateClientFinancialHistoryRequest, ClientFinancialHistoryResponse, ListClientFinancialHistoryResponse } from "@fiado/type-kit/bin/riskProfile/index.js";
 export interface IRiskProfileApi {
     createRiskProfile(request: CreateRiskProfileRequest): Promise<any>;
     updateRiskProfile(request: UpdateRiskProfileRequest): Promise<any>;
@@ -34,5 +34,21 @@ export interface IRiskProfileApi {
      * Idempotencia: si previousIncome === newValue, devuelve 200 con noop=true.
      */
     setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>>;
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03, audit log
+     * append-only `ClientFinancialHistory_GT`).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>>;
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     *
+     * Paginación: pasar `continuationToken` de la respuesta previa; `null` = fin.
+     */
+    listClientFinancialHistory(directoryId: string, params?: {
+        limit?: number;
+        continuationToken?: string;
+    }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>>;
 }
 export {};

package/bin/twilio-connector/api/TwilioConnectorApi.d.ts

@@ -0,0 +1,11 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
+import { ITwilioConnectorApi } from "./interfaces/ITwilioConnectorApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export default class TwilioConnectorApi implements ITwilioConnectorApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    send(request: ConnectorSendMessageRequest): Promise<FiadoApiResponse<ConnectorSendMessageResponse>>;
+}
+export {};

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

package/bin/twilio-connector/api/interfaces/ITwilioConnectorApi.d.ts

@@ -0,0 +1,11 @@
+import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export interface ITwilioConnectorApi {
+    /**
+     * Envia un mensaje ya resuelto al twilio-connector (POST /messages/send).
+     * messages-business resuelve plantilla, remitente y `secretRef` desde el
+     * `senderConfig` del `(tenant, channel)`; el connector solo transmite a Twilio.
+     */
+    send(request: ConnectorSendMessageRequest): Promise<FiadoApiResponse<ConnectorSendMessageResponse>>;
+}
+export {};

package/bin/twilio-connector/api/interfaces/ITwilioConnectorApi.js

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

package/bin/twilio-connector/index.d.ts

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

package/bin/twilio-connector/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.19.0",
+  "version": "4.20.1",
   "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.71.0",
+    "@fiado/type-kit": "^3.75.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/milestone-business/api/MilestoneBusinessApi.ts

@@ -1,6 +1,11 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import {
+    Milestone,
+    MilestonesByEventKeyDateRangeParams,
+    MilestonesByDirectoryIdsResponse,
+    MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH,
+} from "@fiado/type-kit/bin/milestone-business/index.js";
 import { IMilestoneBusinessApi } from "./interfaces/IMilestoneBusinessApi.js";
 
 @injectable()
@@ -23,4 +28,22 @@ export default class MilestoneBusinessApi implements IMilestoneBusinessApi {
         const url = `${this.baseUrl}private/milestones/by-event-key?${queryParams.toString()}`;
         return await this.httpRequest.get(url);
     }
+
+    async listByDirectoryIds(directoryIds: string[]): Promise<Record<string, Milestone[]>> {
+        // Dedup preservando el orden de aparición.
+        const uniqueIds = Array.from(new Set(directoryIds));
+        if (uniqueIds.length === 0) return {};
+
+        const url = `${this.baseUrl}private/milestones/by-directory-ids`;
+        const merged: Record<string, Milestone[]> = {};
+
+        // Chunking en lotes de MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH (cap del endpoint batch).
+        for (let i = 0; i < uniqueIds.length; i += MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH) {
+            const batch = uniqueIds.slice(i, i + MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH);
+            const partial = await this.httpRequest.post<MilestonesByDirectoryIdsResponse>(url, { directoryIds: batch });
+            Object.assign(merged, partial);
+        }
+
+        return merged;
+    }
 }

package/src/milestone-business/api/interfaces/IMilestoneBusinessApi.ts

@@ -1,4 +1,4 @@
-import { MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
+import { Milestone, MilestonesByEventKeyDateRangeParams } from "@fiado/type-kit/bin/milestone-business/index.js";
 
 export interface IMilestoneBusinessApi {
     /**
@@ -6,4 +6,12 @@ export interface IMilestoneBusinessApi {
      * Usado por el flujo de cálculo de comisiones (eventKey=HomeAzul para USA, HomeRosa para MEX).
      */
     listByEventKeyAndDateRange(eventKey: string, params: MilestonesByEventKeyDateRangeParams): Promise<any>;
+
+    /**
+     * Devuelve, por cada directoryId, el array COMPLETO de milestones (mapa
+     * directoryId -> Milestone[]). Hace POST a `private/milestones/by-directory-ids`.
+     * Parte la lista en lotes de 100 (cap del endpoint batch), deduplica los ids
+     * y mergea los mapas parciales. Una sola llamada por lote (evita N+1).
+     */
+    listByDirectoryIds(directoryIds: string[]): Promise<Record<string, Milestone[]>>;
 }

package/src/riskProfile/api/RiskProfileApi.ts

@@ -12,6 +12,9 @@ import {
     SetDeclaredIncomeResponse,
     SetManualRiskLevelRequest,
     SetManualRiskLevelResponse,
+    CreateClientFinancialHistoryRequest,
+    ClientFinancialHistoryResponse,
+    ListClientFinancialHistoryResponse,
 } from "@fiado/type-kit/bin/riskProfile/index.js";
 
 @injectable()
@@ -61,4 +64,26 @@ export default class RiskProfileApi implements IRiskProfileApi {
         return await this.httpRequest.put(url, request);
     }
 
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    async createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>> {
+        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     */
+    async listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>> {
+        const query: string[] = [];
+        if (params?.limit !== undefined) query.push(`limit=${params.limit}`);
+        if (params?.continuationToken) query.push(`continuationToken=${encodeURIComponent(params.continuationToken)}`);
+        const qs = query.length ? `?${query.join("&")}` : "";
+        const url = `${this.baseUrl}/profiles/${directoryId}/financial-history${qs}`;
+        return await this.httpRequest.get(url);
+    }
+
 }

package/src/riskProfile/api/interfaces/IRiskProfileApi.ts

@@ -9,6 +9,9 @@ import {
     SetDeclaredIncomeResponse,
     SetManualRiskLevelRequest,
     SetManualRiskLevelResponse,
+    CreateClientFinancialHistoryRequest,
+    ClientFinancialHistoryResponse,
+    ListClientFinancialHistoryResponse,
 } from "@fiado/type-kit/bin/riskProfile/index.js";
 
 export interface IRiskProfileApi {
@@ -49,4 +52,19 @@ export interface IRiskProfileApi {
      * Idempotencia: si previousIncome === newValue, devuelve 200 con noop=true.
      */
     setDeclaredIncome(directoryId: string, request: SetDeclaredIncomeRequest): Promise<ResponseOptions<SetDeclaredIncomeResponse>>;
+
+    /**
+     * Registra un cambio en el historial financiero del perfil (BO-03, audit log
+     * append-only `ClientFinancialHistory_GT`).
+     * Endpoint: `POST /profiles/{directoryId}/financial-history`
+     */
+    createClientFinancialHistory(directoryId: string, request: CreateClientFinancialHistoryRequest): Promise<ResponseOptions<ClientFinancialHistoryResponse>>;
+
+    /**
+     * Lista el historial financiero del perfil, cronológico descendente, paginado.
+     * Endpoint: `GET /profiles/{directoryId}/financial-history?limit=&continuationToken=`
+     *
+     * Paginación: pasar `continuationToken` de la respuesta previa; `null` = fin.
+     */
+    listClientFinancialHistory(directoryId: string, params?: { limit?: number; continuationToken?: string }): Promise<ResponseOptions<ListClientFinancialHistoryResponse>>;
 }

package/src/twilio-connector/api/TwilioConnectorApi.ts

@@ -0,0 +1,18 @@
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
+import { ITwilioConnectorApi } from "./interfaces/ITwilioConnectorApi.js";
+
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+@injectable()
+export default class TwilioConnectorApi implements ITwilioConnectorApi {
+    private readonly baseUrl = process.env.TWILIO_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async send(request: ConnectorSendMessageRequest): Promise<FiadoApiResponse<ConnectorSendMessageResponse>> {
+        const url = `${this.baseUrl}/messages/send`;
+        return await this.httpRequest.post(url, request, { operationName: "privateSendMessage" });
+    }
+}

package/src/twilio-connector/api/interfaces/ITwilioConnectorApi.ts

@@ -0,0 +1,12 @@
+import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
+
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+export interface ITwilioConnectorApi {
+    /**
+     * Envia un mensaje ya resuelto al twilio-connector (POST /messages/send).
+     * messages-business resuelve plantilla, remitente y `secretRef` desde el
+     * `senderConfig` del `(tenant, channel)`; el connector solo transmite a Twilio.
+     */
+    send(request: ConnectorSendMessageRequest): Promise<FiadoApiResponse<ConnectorSendMessageResponse>>;
+}

package/src/twilio-connector/index.ts

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