@fiado/api-invoker 4.11.1 → 4.13.0

package/src/multicommServicePayment/api/interfaces/IMulticommServicePaymentApi.ts

@@ -1,45 +1,53 @@
-import {GetCatalogParams, GetFavoritesParams, GetFavoritesResponse, ServicePaymentRequest} from "@fiado/type-kit/bin/servicePayment";
-import {BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse} from "@fiado/type-kit/bin/benefitCenter";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-
-export interface IMulticommServicePaymentApi {
-    pay(request: ServicePaymentRequest): Promise<ApiGatewayResponse<any>>;
-
-    getTransaction(transactionNumber: string): Promise<ApiGatewayResponse<any>>;
-
-    getPaymentValidation(transactionNumber: string): Promise<ApiGatewayResponse<any>>
-
-    getCatalog(params: GetCatalogParams): Promise<ApiGatewayResponse<any>>;
-
-    getById(id: string): Promise<ApiGatewayResponse<any>>;
-
-    getSTPTransactionDownload(params: {date: string,index?:string,pageSize?:number, sort?:string}): Promise<ApiGatewayResponse<any>>;
-
-    consultTransaction(params: {transactionNumber: string, date: string, serviceId: string}): Promise<ApiGatewayResponse<any>>;
-
-    getTransactions(params: GetFavoritesParams): Promise<FiadoApiResponse<GetFavoritesResponse>>;
-
-    // Agregado en v3.1.0 — consume GET /catalog/standard del conector.
-    // Consumido por CatalogTreeBuilder en benefits-marketplace-business.
-    getStandardCatalog(params?: { benefitId?: string; includeDisabled?: boolean }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
-
-    // Agregado en v3.5.0 (Fase 2) — consume POST /pay/standard del conector con DTO estandarizado.
-    // Lo invoca el PaymentRouter de benefits-marketplace-business.
-    payStandard(request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
-
-    // Agregado en v3.6.0 (Fase 2.5) — consume GET /pay/standard/transactions/{transactionNumber}
-    // del conector. Devuelve el estado actual mapeado a BenefitPaymentResponse (el conector
-    // hace el mapping legacy → estándar internamente). Usado por el cron de timeout
-    // reconciliation del marketplace para consultar transacciones async sin ver shapes legacy.
-    consultStandard(transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
-
-    // Agregado en v3.8.0 — consume PUT /backoffice/services/{idServicio} del conector
-    // admin. Consumido por LeafAdminManager de benefits-marketplace-business para
-    // edición editorial in-place (admin-leaves v2).
-    updateService(idServicio: number, patch: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
-
-    // POST /internal/services — alta manual de un servicio nuevo (admin-leaves v2).
-    // Consumido por LeafAdminManager de benefits-marketplace-business.
-    createService(payload: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+import {GetCatalogParams, GetFavoritesParams, GetFavoritesResponse, ServicePaymentRequest} from "@fiado/type-kit/bin/servicePayment";
+import {BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse} from "@fiado/type-kit/bin/benefitCenter";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import {TransactionMetrics, TransactionMetricsRequest, TransactionQueryRequest, TransactionQueryResponse} from "@fiado/type-kit/bin/transactionAnalytics";
+
+export interface IMulticommServicePaymentApi {
+    pay(request: ServicePaymentRequest): Promise<ApiGatewayResponse<any>>;
+
+    getTransaction(transactionNumber: string): Promise<ApiGatewayResponse<any>>;
+
+    getPaymentValidation(transactionNumber: string): Promise<ApiGatewayResponse<any>>
+
+    getCatalog(params: GetCatalogParams): Promise<ApiGatewayResponse<any>>;
+
+    getById(id: string): Promise<ApiGatewayResponse<any>>;
+
+    getSTPTransactionDownload(params: {date: string,index?:string,pageSize?:number, sort?:string}): Promise<ApiGatewayResponse<any>>;
+
+    consultTransaction(params: {transactionNumber: string, date: string, serviceId: string}): Promise<ApiGatewayResponse<any>>;
+
+    getTransactions(params: GetFavoritesParams): Promise<FiadoApiResponse<GetFavoritesResponse>>;
+
+    // Agregado en v3.1.0 — consume GET /catalog/standard del conector.
+    // Consumido por CatalogTreeBuilder en benefits-marketplace-business.
+    getStandardCatalog(params?: { benefitId?: string; includeDisabled?: boolean }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+
+    // Agregado en v3.5.0 (Fase 2) — consume POST /pay/standard del conector con DTO estandarizado.
+    // Lo invoca el PaymentRouter de benefits-marketplace-business.
+    payStandard(request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+
+    // Agregado en v3.6.0 (Fase 2.5) — consume GET /pay/standard/transactions/{transactionNumber}
+    // del conector. Devuelve el estado actual mapeado a BenefitPaymentResponse (el conector
+    // hace el mapping legacy → estándar internamente). Usado por el cron de timeout
+    // reconciliation del marketplace para consultar transacciones async sin ver shapes legacy.
+    consultStandard(transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+
+    // Agregado en v3.8.0 — consume PUT /backoffice/services/{idServicio} del conector
+    // admin. Consumido por LeafAdminManager de benefits-marketplace-business para
+    // edición editorial in-place (admin-leaves v2).
+    updateService(idServicio: number, patch: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+
+    // POST /internal/services — alta manual de un servicio nuevo (admin-leaves v2).
+    // Consumido por LeafAdminManager de benefits-marketplace-business.
+    createService(payload: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+
+    // Agregado en v4.12.0 — consume GET /analytics/metrics del conector (analítica read-only).
+    // Consumido por TransactionAnalyticsManager de benefits-marketplace-business.
+    getTransactionMetrics(params?: TransactionMetricsRequest): Promise<ApiGatewayResponse<TransactionMetrics>>;
+
+    // Agregado en v4.12.0 — consume GET /analytics/query del conector (filas normalizadas paginadas).
+    queryTransactions(params?: TransactionQueryRequest): Promise<ApiGatewayResponse<TransactionQueryResponse>>;
 }

package/src/multicommServicePayment/index.ts

@@ -1,2 +1,2 @@
-export * from './api/interfaces/IMulticommServicePaymentApi';
+export * from './api/interfaces/IMulticommServicePaymentApi';
 export * from './api/MulticommServicePaymentApi';

package/src/notificationMessages/index.ts

@@ -1,2 +1,2 @@
-export * from './queue/NotificationMessagePublisher';
+export * from './queue/NotificationMessagePublisher';
 export * from './queue/interfaces/INotificationMessagesPublisher';

package/src/notificationMessages/queue/NotificationMessagePublisher.ts

@@ -1,43 +1,43 @@
-import {INotificationMessagesPublisher} from "./interfaces/INotificationMessagesPublisher";
-import {NotificationQueueMessageRequest, NotificationTemplate} from "@fiado/type-kit/bin/notificationMessages";
-import {SendMessageCommand, SendMessageRequest, SQSClient} from "@aws-sdk/client-sqs";
-import {inject, injectable} from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-
-@injectable()
-export default class NotificationMessagePublisher implements INotificationMessagesPublisher {
-
-    constructor(
-        @inject("IHttpRequest") private httpRequest: IHttpRequest
-    ) {}
-
-
-    private readonly NOTIFICATION_MESSAGES_QUEUE = process.env.NOTIFICATION_MESSAGES_QUEUE
-    private readonly NOTIFICATION_MESSAGES_URL = process.env.NOTIFICATION_MESSAGES_URL;
-
-    async publish(message: NotificationQueueMessageRequest): Promise<void> {
-        try {
-            const client: SQSClient = new SQSClient();
-            const sendMessageRequest: SendMessageRequest = {
-                QueueUrl: this.NOTIFICATION_MESSAGES_QUEUE,
-                MessageBody: JSON.stringify(message)
-            };
-            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
-            await client.send(command);
-        } catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
-        }
-    }
-
-    async getTemplateById(templateId: string): Promise<FiadoApiResponse<NotificationTemplate>> {
-        const url = `${this.NOTIFICATION_MESSAGES_URL}notification-messages/private/templates/${templateId}`;
-        return await this.httpRequest.get(`${url}`);
-    }
-
-    async deleteByDirectoryId(directoryId: string): Promise<void> {
-        const url = `${this.NOTIFICATION_MESSAGES_URL}notification-messages/private/directory/${directoryId}`;
-        return await this.httpRequest.delete(`${url}`);
-    }
+import {INotificationMessagesPublisher} from "./interfaces/INotificationMessagesPublisher";
+import {NotificationQueueMessageRequest, NotificationTemplate} from "@fiado/type-kit/bin/notificationMessages";
+import {SendMessageCommand, SendMessageRequest, SQSClient} from "@aws-sdk/client-sqs";
+import {inject, injectable} from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+
+@injectable()
+export default class NotificationMessagePublisher implements INotificationMessagesPublisher {
+
+    constructor(
+        @inject("IHttpRequest") private httpRequest: IHttpRequest
+    ) {}
+
+
+    private readonly NOTIFICATION_MESSAGES_QUEUE = process.env.NOTIFICATION_MESSAGES_QUEUE
+    private readonly NOTIFICATION_MESSAGES_URL = process.env.NOTIFICATION_MESSAGES_URL;
+
+    async publish(message: NotificationQueueMessageRequest): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.NOTIFICATION_MESSAGES_QUEUE,
+                MessageBody: JSON.stringify(message)
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
+        }
+    }
+
+    async getTemplateById(templateId: string): Promise<FiadoApiResponse<NotificationTemplate>> {
+        const url = `${this.NOTIFICATION_MESSAGES_URL}notification-messages/private/templates/${templateId}`;
+        return await this.httpRequest.get(`${url}`);
+    }
+
+    async deleteByDirectoryId(directoryId: string): Promise<void> {
+        const url = `${this.NOTIFICATION_MESSAGES_URL}notification-messages/private/directory/${directoryId}`;
+        return await this.httpRequest.delete(`${url}`);
+    }
 }

package/src/notificationMessages/queue/interfaces/INotificationMessagesPublisher.ts

@@ -1,8 +1,8 @@
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-import {NotificationQueueMessageRequest, NotificationTemplate} from "@fiado/type-kit/bin/notificationMessages";
-
-export interface INotificationMessagesPublisher {
-    publish(message: NotificationQueueMessageRequest): Promise<void>;
-    getTemplateById(templateId: string): Promise<FiadoApiResponse<NotificationTemplate>>;
-    deleteByDirectoryId(directoryId: string): Promise<void>;
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import {NotificationQueueMessageRequest, NotificationTemplate} from "@fiado/type-kit/bin/notificationMessages";
+
+export interface INotificationMessagesPublisher {
+    publish(message: NotificationQueueMessageRequest): Promise<void>;
+    getTemplateById(templateId: string): Promise<FiadoApiResponse<NotificationTemplate>>;
+    deleteByDirectoryId(directoryId: string): Promise<void>;
 }

package/src/notificationWebsockets/index.ts

@@ -1,2 +1,2 @@
-export * from './queue/NotificationWSMessagePublisher';
+export * from './queue/NotificationWSMessagePublisher';
 export * from './queue/interfaces/INotificationWSMessagesPublisher';

package/src/notificationWebsockets/queue/NotificationWSMessagePublisher.ts

@@ -1,30 +1,30 @@
-import {INotificationWSMessagesPublisher} from "./interfaces/INotificationWSMessagesPublisher";
-import {NotificationWSQueueMessageRequest} from "@fiado/type-kit/bin/notificationWS";
-import {SendMessageCommand, SendMessageRequest, SQSClient} from "@aws-sdk/client-sqs";
-import {injectable} from "inversify";
-import crypto from "crypto";
-
-
-@injectable()
-export default class NotificationWSMessagePublisher implements INotificationWSMessagesPublisher {
-
-    constructor() {}
-
-    private readonly NOTIFICATION_WS_MESSAGES_QUEUE = process.env.NOTIFICATION_WS_MESSAGES_QUEUE
-
-    async publish(message: NotificationWSQueueMessageRequest<any>): Promise<void> {
-        try {
-            const client: SQSClient = new SQSClient();
-            const sendMessageRequest: SendMessageRequest = {
-                QueueUrl: this.NOTIFICATION_WS_MESSAGES_QUEUE,
-                MessageBody: JSON.stringify(message),
-                MessageGroupId: "NotificationWSGroup",
-                MessageDeduplicationId: crypto.randomUUID()
-            };
-            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
-            await client.send(command);
-        } catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
-        }
+import {INotificationWSMessagesPublisher} from "./interfaces/INotificationWSMessagesPublisher";
+import {NotificationWSQueueMessageRequest} from "@fiado/type-kit/bin/notificationWS";
+import {SendMessageCommand, SendMessageRequest, SQSClient} from "@aws-sdk/client-sqs";
+import {injectable} from "inversify";
+import crypto from "crypto";
+
+
+@injectable()
+export default class NotificationWSMessagePublisher implements INotificationWSMessagesPublisher {
+
+    constructor() {}
+
+    private readonly NOTIFICATION_WS_MESSAGES_QUEUE = process.env.NOTIFICATION_WS_MESSAGES_QUEUE
+
+    async publish(message: NotificationWSQueueMessageRequest<any>): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.NOTIFICATION_WS_MESSAGES_QUEUE,
+                MessageBody: JSON.stringify(message),
+                MessageGroupId: "NotificationWSGroup",
+                MessageDeduplicationId: crypto.randomUUID()
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to queue ${': ' + errorMessage}`);
+        }
     }}

package/src/notificationWebsockets/queue/interfaces/INotificationWSMessagesPublisher.ts

@@ -1,5 +1,5 @@
-import { NotificationWSQueueMessageRequest } from "@fiado/type-kit/bin/notificationWS";
-
-export interface INotificationWSMessagesPublisher {
-    publish(message: NotificationWSQueueMessageRequest<any>): Promise<void>;
+import { NotificationWSQueueMessageRequest } from "@fiado/type-kit/bin/notificationWS";
+
+export interface INotificationWSMessagesPublisher {
+    publish(message: NotificationWSQueueMessageRequest<any>): Promise<void>;
 }

package/src/observations/ObservationsApi.ts

@@ -1,23 +1,23 @@
-import dotenv from 'dotenv';
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { IObservationsApi } from "./interfaces/IObservationsApi";
-import FiadoApiResponse from '@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse';
-import { ObservationCreateRequest } from '@fiado/type-kit/bin/observations';
-dotenv.config();
-
-@injectable()
-export class ObservationsApi implements IObservationsApi {
-
-    private readonly baseUrl = process.env.OBSERVATION_BUSINESS || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
-    
-    async create(data: ObservationCreateRequest, author?:string): Promise<FiadoApiResponse<any>> {
-        const url: string = `${this.baseUrl}observations/create`;
-        const objectData = JSON.parse(JSON.stringify(data));
-        objectData.author = author;
-        return await this.httpRequest.post(url,objectData);
-    }
-
-}
+import dotenv from 'dotenv';
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { IObservationsApi } from "./interfaces/IObservationsApi";
+import FiadoApiResponse from '@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse';
+import { ObservationCreateRequest } from '@fiado/type-kit/bin/observations';
+dotenv.config();
+
+@injectable()
+export class ObservationsApi implements IObservationsApi {
+
+    private readonly baseUrl = process.env.OBSERVATION_BUSINESS || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+    
+    async create(data: ObservationCreateRequest, author?:string): Promise<FiadoApiResponse<any>> {
+        const url: string = `${this.baseUrl}observations/create`;
+        const objectData = JSON.parse(JSON.stringify(data));
+        objectData.author = author;
+        return await this.httpRequest.post(url,objectData);
+    }
+
+}

package/src/observations/index.ts

@@ -1,3 +1,3 @@
-
-export * from './interfaces/IObservationsApi';
-export * from './ObservationsApi';
+
+export * from './interfaces/IObservationsApi';
+export * from './ObservationsApi';

package/src/observations/interfaces/IObservationsApi.ts

@@ -1,9 +1,9 @@
-import FiadoApiResponse from '@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse';
-import { ObservationCreateRequest } from '@fiado/type-kit/bin/observations';
-
-/**
- * Interfaz para el servicio de Observations
- */
-export interface IObservationsApi {
-    create(data: ObservationCreateRequest ,author?:string): Promise<FiadoApiResponse<any>>;
-}
+import FiadoApiResponse from '@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse';
+import { ObservationCreateRequest } from '@fiado/type-kit/bin/observations';
+
+/**
+ * Interfaz para el servicio de Observations
+ */
+export interface IObservationsApi {
+    create(data: ObservationCreateRequest ,author?:string): Promise<FiadoApiResponse<any>>;
+}

package/src/onboarding/api/OnboardingApi.ts

@@ -1,23 +1,23 @@
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { IOnboardingApi } from "./interfaces/IOnboardingApi";
-
-
-@injectable()
-export default class OnboardingApi implements IOnboardingApi {
-
-    private readonly baseUrl = process.env.ONBOARDING_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-    
-    async getByReferralDirectoryId(referralDirectoryId: string): Promise<any> {
-        const url = `${this.baseUrl}all?referralDirectoryId=${referralDirectoryId}`;
-        return await this.httpRequest.get(`${url}`);
-    }
-    
-    async delete(id: string): Promise<any> {
-        const url = `${this.baseUrl}onboarding/${id}`;
-        return await this.httpRequest.delete(`${url}`);
-    }
-}
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { IOnboardingApi } from "./interfaces/IOnboardingApi";
+
+
+@injectable()
+export default class OnboardingApi implements IOnboardingApi {
+
+    private readonly baseUrl = process.env.ONBOARDING_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+    
+    async getByReferralDirectoryId(referralDirectoryId: string): Promise<any> {
+        const url = `${this.baseUrl}all?referralDirectoryId=${referralDirectoryId}`;
+        return await this.httpRequest.get(`${url}`);
+    }
+    
+    async delete(id: string): Promise<any> {
+        const url = `${this.baseUrl}onboarding/${id}`;
+        return await this.httpRequest.delete(`${url}`);
+    }
+}

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

@@ -1,4 +1,4 @@
-export interface IOnboardingApi {
-    delete(id: string): Promise<any>
-    getByReferralDirectoryId(referralDirectoryId: string): Promise<any>
+export interface IOnboardingApi {
+    delete(id: string): Promise<any>
+    getByReferralDirectoryId(referralDirectoryId: string): Promise<any>
 }

package/src/onboarding/index.ts

@@ -1,2 +1,2 @@
-export * from './api/OnboardingApi';
+export * from './api/OnboardingApi';
 export * from './api/interfaces/IOnboardingApi';