@fiado/api-invoker 4.59.0 → 4.61.0

package/src/stpServicePayment/api/interfaces/IStpServicePaymentApi.ts

@@ -1,53 +1,53 @@
-import {GetCatalogParams, ServicePaymentRequest, ReferenceVerificationRequest, ReferenceVerificationResponse, GetFavoritesParams, GetFavoritesResponse} from "@fiado/type-kit/bin/servicePayment/index.js";
-import {BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
-type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-import {TransactionMetrics, TransactionMetricsRequest, TransactionQueryRequest, TransactionQueryResponse} from "@fiado/type-kit/bin/transactionAnalytics/index.js";
-
-export interface IStpServicePaymentApi {
-    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>>;
-
-    verificateReference(request: ReferenceVerificationRequest): Promise<ApiGatewayResponse<ReferenceVerificationResponse>>;
-
-    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>>;
+import {GetCatalogParams, ServicePaymentRequest, ReferenceVerificationRequest, ReferenceVerificationResponse, GetFavoritesParams, GetFavoritesResponse} from "@fiado/type-kit/bin/servicePayment/index.js";
+import {BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+import {TransactionMetrics, TransactionMetricsRequest, TransactionQueryRequest, TransactionQueryResponse} from "@fiado/type-kit/bin/transactionAnalytics/index.js";
+
+export interface IStpServicePaymentApi {
+    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>>;
+
+    verificateReference(request: ReferenceVerificationRequest): Promise<ApiGatewayResponse<ReferenceVerificationResponse>>;
+
+    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/stpServicePayment/index.ts

@@ -1,2 +1,2 @@
-export * from './api/interfaces/IStpServicePaymentApi.js';
+export * from './api/interfaces/IStpServicePaymentApi.js';
 export * from './api/StpServicePaymentApi.js';

package/src/stpSpei/api/StpSpeiApi.ts

@@ -1,33 +1,33 @@
-import {IStpSpeiApi} from "./interfaces/IStpSpeiApi.js";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {BusinessNameEnum, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
-
-@injectable()
-export class StpSpeiApi implements IStpSpeiApi {
-    private readonly baseUrl = process.env.STP_SPEI_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async putStpOrder(request: PutStpOrderRequest): Promise<any> {
-        const url = `${this.baseUrl}`;
-        const headers = {
-            'Content-Type': 'application/json',
-            operationName: "putConnectorStpOrders"
-        }
-        return await this.httpRequest.post(url, request, headers);
-    }
-
-    async getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any> {
-        const url: string = `${this.baseUrl}`;
-        const request = {
-            business: businessName
-        }
-        const headers = {
-            'Content-Type': 'application/json',
-            operationName: "getBusinessAccountBalance"
-        }
-        return await this.httpRequest.post(url, request, headers);
-    }
+import {IStpSpeiApi} from "./interfaces/IStpSpeiApi.js";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {BusinessNameEnum, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
+
+@injectable()
+export class StpSpeiApi implements IStpSpeiApi {
+    private readonly baseUrl = process.env.STP_SPEI_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async putStpOrder(request: PutStpOrderRequest): Promise<any> {
+        const url = `${this.baseUrl}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            operationName: "putConnectorStpOrders"
+        }
+        return await this.httpRequest.post(url, request, headers);
+    }
+
+    async getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any> {
+        const url: string = `${this.baseUrl}`;
+        const request = {
+            business: businessName
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+            operationName: "getBusinessAccountBalance"
+        }
+        return await this.httpRequest.post(url, request, headers);
+    }
 }

package/src/stpSpei/api/interfaces/IStpSpeiApi.ts

@@ -1,7 +1,7 @@
-import {BusinessNameEnum, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
-
-export interface IStpSpeiApi {
-    putStpOrder(request: PutStpOrderRequest): Promise<any>;
-
-    getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any>;
+import {BusinessNameEnum, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
+
+export interface IStpSpeiApi {
+    putStpOrder(request: PutStpOrderRequest): Promise<any>;
+
+    getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any>;
 }

package/src/stpSpei/index.ts

@@ -1,2 +1,2 @@
-export * from './api/interfaces/IStpSpeiApi.js';
+export * from './api/interfaces/IStpSpeiApi.js';
 export * from './api/StpSpeiApi.js';

package/src/synergypay-connector/api/SynergyPayConnectorApi.ts

@@ -0,0 +1,52 @@
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {
+    CreateFundingReferenceRequest,
+    CreateFundingReferenceResponse,
+    ListFundingReferencesResponse,
+    ApplyWalletFundingRequest,
+    ApplyWalletFundingResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+import { ISynergyPayConnectorApi } from "./interfaces/ISynergyPayConnectorApi.js";
+
+@injectable()
+export default class SynergyPayConnectorApi implements ISynergyPayConnectorApi {
+    private readonly baseUrl = process.env.SYNERGYPAY_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async createFundingReference(
+        request: CreateFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>> {
+        const url = `${this.baseUrl}/funding`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async listFundingReferences(
+        directoryId: string,
+        status?: string,
+    ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>> {
+        const params = new URLSearchParams({ directoryId });
+        if (status) params.set("status", status);
+        const url = `${this.baseUrl}/funding/references?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getStandardCatalog(
+        query: { benefitId: string; includeDisabled?: boolean },
+    ): Promise<ApiGatewayResponse<ConnectorCatalogResponse>> {
+        const params = new URLSearchParams({ benefitId: query.benefitId });
+        if (query.includeDisabled) params.set("includeDisabled", "true");
+        const url = `${this.baseUrl}/catalog/standard?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async applyFunding(
+        request: ApplyWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>> {
+        const url = `${this.baseUrl}/funding/apply`;
+        return await this.httpRequest.post(url, request);
+    }
+}

package/src/synergypay-connector/api/interfaces/ISynergyPayConnectorApi.ts

@@ -0,0 +1,61 @@
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {
+    CreateFundingReferenceRequest,
+    CreateFundingReferenceResponse,
+    ListFundingReferencesResponse,
+    ApplyWalletFundingRequest,
+    ApplyWalletFundingResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+
+/**
+ * Cliente del marketplace hacia synergypay-connector (privado, dentro de la VPC).
+ *
+ * Segundo proveedor de Cash In (SinergyPay). Lo consume `SynergyPayFundingPublisher`
+ * + `SynergyPayCatalogPublisher` del benefits-marketplace-business. Mismo contrato
+ * provider-agnostic que `IEqualityConnectorApi` — el marketplace no sabe con qué
+ * proveedor habla.
+ *
+ * Endpoints backend en synergypay-connector (privado VPC):
+ *  - POST /funding
+ *  - GET  /funding/references?directoryId=&status=
+ *  - GET  /catalog/standard?benefitId=&includeDisabled=
+ *  - POST /funding/apply
+ *
+ * NOTA: los endpoints `/passport/*` del BackOffice (SPEC 1.3) NO están incluidos —
+ * el synergypay-connector aún no los expone (F6.1 construyó solo el money-path).
+ * Se agregan en F6.4 junto con `SynergyPayPassportBackofficePublisher`.
+ */
+export interface ISynergyPayConnectorApi {
+    /** Genera una referencia de fondeo en SinergyPay via el connector. */
+    createFundingReference(
+        request: CreateFundingReferenceRequest,
+    ): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
+
+    /**
+     * Lista las referencias del usuario, opcionalmente filtradas por status.
+     * Status default (cuando no se pasa) lo decide el connector.
+     */
+    listFundingReferences(
+        directoryId: string,
+        status?: string,
+    ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+
+    /**
+     * Devuelve el catalogo standard de productos de wallet-funding del connector.
+     * Patron canonico del Centro de Beneficios — el marketplace lo consume via
+     * `IConnectorCatalogPublisher.getStandardCatalog` (mismo flow que Equality).
+     */
+    getStandardCatalog(
+        query: { benefitId: string; includeDisabled?: boolean },
+    ): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+
+    /**
+     * Aplica el resultado de la conciliación de un pago (POST /funding/apply).
+     * En SinergyPay el crédito se hace inline en el webhook firmado; este endpoint
+     * queda para el cierre SETTLED (conciliación bancaria) — mismo contrato canónico.
+     */
+    applyFunding(
+        request: ApplyWalletFundingRequest,
+    ): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
+}

package/src/synergypay-connector/index.ts

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

package/src/teams-connector/index.ts

@@ -1,2 +1,2 @@
-export * from './queue/TeamsNotificationPublisher.js';
-export * from './queue/interfaces/ITeamsNotificationPublisher.js';
+export * from './queue/TeamsNotificationPublisher.js';
+export * from './queue/interfaces/ITeamsNotificationPublisher.js';

package/src/teams-connector/queue/TeamsNotificationPublisher.ts

@@ -1,24 +1,24 @@
-import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
-import { ITeamsNotificationPublisher } from "./interfaces/ITeamsNotificationPublisher.js";
-import { TeamsNotificationRequest } from "@fiado/type-kit/bin/teamsConnector/index.js";
-import { injectable } from "inversify";
-
-@injectable()
-export default class TeamsNotificationPublisher implements ITeamsNotificationPublisher {
-    private readonly TEAMS_NOTIFICATION_QUEUE = process.env.TEAMS_NOTIFICATION_QUEUE;
-
-    async publish(message: TeamsNotificationRequest): Promise<void> {
-        try {
-            const client: SQSClient = new SQSClient();
-            const sendMessageRequest: SendMessageRequest = {
-                QueueUrl: this.TEAMS_NOTIFICATION_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 TeamsNotificationQueue${': ' + errorMessage}`);
-        }
-    }
-}
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import { ITeamsNotificationPublisher } from "./interfaces/ITeamsNotificationPublisher.js";
+import { TeamsNotificationRequest } from "@fiado/type-kit/bin/teamsConnector/index.js";
+import { injectable } from "inversify";
+
+@injectable()
+export default class TeamsNotificationPublisher implements ITeamsNotificationPublisher {
+    private readonly TEAMS_NOTIFICATION_QUEUE = process.env.TEAMS_NOTIFICATION_QUEUE;
+
+    async publish(message: TeamsNotificationRequest): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.TEAMS_NOTIFICATION_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 TeamsNotificationQueue${': ' + errorMessage}`);
+        }
+    }
+}

package/src/teams-connector/queue/interfaces/ITeamsNotificationPublisher.ts

@@ -1,5 +1,5 @@
-import { TeamsNotificationRequest } from "@fiado/type-kit/bin/teamsConnector/index.js";
-
-export interface ITeamsNotificationPublisher {
-    publish(message: TeamsNotificationRequest): Promise<void>;
-}
+import { TeamsNotificationRequest } from "@fiado/type-kit/bin/teamsConnector/index.js";
+
+export interface ITeamsNotificationPublisher {
+    publish(message: TeamsNotificationRequest): Promise<void>;
+}