@fiado/api-invoker 4.1.0 → 4.1.1

package/src/address/index.ts

@@ -1,4 +1,4 @@
-
-
-export * from './interfaces/IAddressApi';
-export * from './AddressApi';
+
+
+export * from './interfaces/IAddressApi.js';
+export * from './AddressApi.js';

package/src/address/interfaces/IAddressApi.ts

@@ -1,31 +1,31 @@
-import { AddressCreateRequest, AddressResponse, AddressShippingCardResponse } from "@fiado/type-kit/bin/address";
-
-export interface IAddressApi {
-
-    /**
-     * Obtiene una lista de direcciones por su ID de directorio.
-     * @param directoryId ID de directorio (UUID) a buscar.
-     * @returns Una promesa que resuelve a un arreglo de objetos de dirección.
-     * Puede devolver un arreglo vacío si no se encuentran coincidencias.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    getByDirectoryId(directoryId: string): Promise<AddressResponse[]>;
-
-    /**
-     * Crea una nueva dirección para un directorio.
-     * @param directoryId ID de directorio (UUID) a buscar.
-     * @param address Objeto de dirección a crear.
-     * @returns Una promesa que resuelve a void.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    create(directoryId: string, address: AddressCreateRequest): Promise<void>;
-
-    /**
-     * Obtiene la dirección de envío de una tarjeta.
-     * @param input Objeto de solicitud de dirección de envío.
-     * @returns Una promesa que resuelve a un objeto de respuesta de dirección de envío.
-     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
-     */
-    getAddressLocationShipping(directoryId: string): Promise<AddressShippingCardResponse> 
-
+import { AddressCreateRequest, AddressResponse, AddressShippingCardResponse } from "@fiado/type-kit/bin/address/index.js";
+
+export interface IAddressApi {
+
+    /**
+     * Obtiene una lista de direcciones por su ID de directorio.
+     * @param directoryId ID de directorio (UUID) a buscar.
+     * @returns Una promesa que resuelve a un arreglo de objetos de dirección.
+     * Puede devolver un arreglo vacío si no se encuentran coincidencias.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    getByDirectoryId(directoryId: string): Promise<AddressResponse[]>;
+
+    /**
+     * Crea una nueva dirección para un directorio.
+     * @param directoryId ID de directorio (UUID) a buscar.
+     * @param address Objeto de dirección a crear.
+     * @returns Una promesa que resuelve a void.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    create(directoryId: string, address: AddressCreateRequest): Promise<void>;
+
+    /**
+     * Obtiene la dirección de envío de una tarjeta.
+     * @param input Objeto de solicitud de dirección de envío.
+     * @returns Una promesa que resuelve a un objeto de respuesta de dirección de envío.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    getAddressLocationShipping(directoryId: string): Promise<AddressShippingCardResponse> 
+
 }

package/src/ai-engine-connector/AiEngineApi.ts

@@ -1,9 +1,9 @@
 import dotenv from 'dotenv';
 import { inject, injectable } from "inversify";
 import { IHttpRequest } from "@fiado/http-client";
-import { IAiEngineApi } from "./interfaces/IAiEngineApi";
-import { AiAnalyzeRequest, AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import { IAiEngineApi } from "./interfaces/IAiEngineApi.js";
+import { AiAnalyzeRequest, AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine/index.js";
+import type { FiadoApiResponse } from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js";
 import { log } from "@fiado/logger";
 dotenv.config();
 

package/src/ai-engine-connector/index.ts

@@ -1,2 +1,2 @@
-export * from './interfaces/IAiEngineApi';
-export * from './AiEngineApi';
+export * from './interfaces/IAiEngineApi.js';
+export * from './AiEngineApi.js';

package/src/ai-engine-connector/interfaces/IAiEngineApi.ts

@@ -1,5 +1,5 @@
-import { AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import { AiAnalyzeResponse } from "@fiado/type-kit/bin/aiEngine/index.js";
+import type { FiadoApiResponse } from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js";
 
 export interface IAiEngineApi {
     analyze(prompt: string, systemPrompt?: string, modelId?: string): Promise<FiadoApiResponse<AiAnalyzeResponse>>;

package/src/appselectondata/AppSelectionDataApi.ts

@@ -1,33 +1,33 @@
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import dotenv from 'dotenv';
-import { IdentificationParameter } from "@fiado/type-kit/bin/blacklist";
-import { IAppSelectionDataApi } from "./interfaces/IAppSelectionDataApi";
-dotenv.config();
-
-@injectable()
-export class AppSelectionDataApi implements IAppSelectionDataApi {
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-    private readonly baseUrl = process.env.APP_SELECTION_DATA_URL || "";
-
-    async getList(params: {pageSize?:number,index?:string,dataType?:string}): Promise<any> {
-        const queryParams = []
-
-        if (params?.pageSize) {
-            queryParams.push(`pageSize=${params.pageSize}`)
-        }
-
-        if (params?.index) {
-            queryParams.push(`index=${params.index}`)
-        }
-
-        if (params?.dataType) {
-            queryParams.push(`dataType=${params.dataType}`)
-        }
-
-        const url = `${this.baseUrl}appselectiondata?${queryParams.join('&')}`;
-        return await this.httpRequest.get(`${url}`);
-    }
-    
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import dotenv from 'dotenv';
+import { IdentificationParameter } from "@fiado/type-kit/bin/blacklist/index.js";
+import { IAppSelectionDataApi } from "./interfaces/IAppSelectionDataApi.js";
+dotenv.config();
+
+@injectable()
+export class AppSelectionDataApi implements IAppSelectionDataApi {
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+    private readonly baseUrl = process.env.APP_SELECTION_DATA_URL || "";
+
+    async getList(params: {pageSize?:number,index?:string,dataType?:string}): Promise<any> {
+        const queryParams = []
+
+        if (params?.pageSize) {
+            queryParams.push(`pageSize=${params.pageSize}`)
+        }
+
+        if (params?.index) {
+            queryParams.push(`index=${params.index}`)
+        }
+
+        if (params?.dataType) {
+            queryParams.push(`dataType=${params.dataType}`)
+        }
+
+        const url = `${this.baseUrl}appselectiondata?${queryParams.join('&')}`;
+        return await this.httpRequest.get(`${url}`);
+    }
+    
 }

package/src/appselectondata/index.ts

@@ -1,3 +1,3 @@
-
-export * from './interfaces/IAppSelectionDataApi';
-export * from './AppSelectionDataApi';
+
+export * from './interfaces/IAppSelectionDataApi.js';
+export * from './AppSelectionDataApi.js';

package/src/appselectondata/interfaces/IAppSelectionDataApi.ts

@@ -1,4 +1,4 @@
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
+import type { FiadoApiResponse } from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js";
 
 /**
  * Interfaz que define las operaciones que se pueden realizar en el servicio de black list.

package/src/authentication/AuthenticationApi.ts

@@ -1,30 +1,30 @@
-import { IHttpRequest } from "@fiado/http-client";
-import { SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication";
-import { inject, injectable } from "inversify";
-import { IAuthenticationApi } from "./interfaces/IAuthenticationApi";
-
-@injectable()
-export class AuthenticationApi implements IAuthenticationApi {
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
-
-    async signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any> {
-        const url = `${process.env.AUTH_LAMBDA_URL}`;
-        const operation = "postSignUpAdditionalCard";
-
-        return await this.httpRequest.post(url, createAdditionalCard, { 'operationName': operation });
-    }
-
-    async deleteAuthSessionByDirectoryId    (directoryId: string): Promise<any> {
-        const url = `${process.env.AUTH_LAMBDA_URL}`;
-        const operation = "deleteAuthSessionByDirectoryId";
-
-        return await this.httpRequest.post(url, {directoryId}, { 'operationName': operation });
-    }
-
-    async signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<any> {
-        const url = `${process.env.AUTH_LAMBDA_URL}`;
-        const operation = "postSignUpBackofficeBulk";
-        return await this.httpRequest.post(url, input, { 'operationName': operation });
-    }
+import { IHttpRequest } from "@fiado/http-client";
+import { SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication/index.js";
+import { inject, injectable } from "inversify";
+import { IAuthenticationApi } from "./interfaces/IAuthenticationApi.js";
+
+@injectable()
+export class AuthenticationApi implements IAuthenticationApi {
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) { }
+
+    async signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any> {
+        const url = `${process.env.AUTH_LAMBDA_URL}`;
+        const operation = "postSignUpAdditionalCard";
+
+        return await this.httpRequest.post(url, createAdditionalCard, { 'operationName': operation });
+    }
+
+    async deleteAuthSessionByDirectoryId    (directoryId: string): Promise<any> {
+        const url = `${process.env.AUTH_LAMBDA_URL}`;
+        const operation = "deleteAuthSessionByDirectoryId";
+
+        return await this.httpRequest.post(url, {directoryId}, { 'operationName': operation });
+    }
+
+    async signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<any> {
+        const url = `${process.env.AUTH_LAMBDA_URL}`;
+        const operation = "postSignUpBackofficeBulk";
+        return await this.httpRequest.post(url, input, { 'operationName': operation });
+    }
 }

package/src/authentication/index.ts

@@ -1,5 +1,5 @@
-
-
-
-export * from './interfaces/IAuthenticationApi';
-export * from './AuthenticationApi';
+
+
+
+export * from './interfaces/IAuthenticationApi.js';
+export * from './AuthenticationApi.js';

package/src/authentication/interfaces/IAuthenticationApi.ts

@@ -1,9 +1,9 @@
-import { DirectoryBatchSummaryResponse, SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication";
-
-export interface IAuthenticationApi {
-
-    signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any>;
-    deleteAuthSessionByDirectoryId(directoryId: string): Promise<any>;
-
-    signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<DirectoryBatchSummaryResponse>;
+import { DirectoryBatchSummaryResponse, SignUpAdditionalRequest, SignUpUserBackofficeRequest } from "@fiado/type-kit/bin/authentication/index.js";
+
+export interface IAuthenticationApi {
+
+    signUpAdditionalCard(createAdditionalCard: SignUpAdditionalRequest): Promise<any>;
+    deleteAuthSessionByDirectoryId(directoryId: string): Promise<any>;
+
+    signUpBackofficeBulk(input: SignUpUserBackofficeRequest[]): Promise<DirectoryBatchSummaryResponse>;
 }

package/src/bankAccount/BankAccountApi.ts

@@ -1,10 +1,10 @@
 import { ApiResponse } from "@fiado/gateway-adapter";
 import { IHttpRequest } from "@fiado/http-client";
 import { inject, injectable } from "inversify";
-import { IBankAccountApi } from "./interfaces/IBankAccountApi";
-import GetExternalBankAccountResponse from "@fiado/type-kit/bin/bankAccount/dtos/GetExternalBankAccountResponse";
-import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse";
-import { GetExternalBankResponse } from "@fiado/type-kit/bin/bankAccount";
+import { IBankAccountApi } from "./interfaces/IBankAccountApi.js";
+import { GetExternalBankAccountResponse } from "@fiado/type-kit/bin/bankAccount/dtos/GetExternalBankAccountResponse.js";
+import type { FiadoApiResponse } from "@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js";
+import { GetExternalBankResponse } from "@fiado/type-kit/bin/bankAccount/index.js";
 
 
 @injectable()

package/src/bankAccount/index.ts

@@ -1,2 +1,2 @@
-export * from './interfaces/IBankAccountApi';
-export * from './BankAccountApi';
+export * from './interfaces/IBankAccountApi.js';
+export * from './BankAccountApi.js';

package/src/bankAccount/interfaces/IBankAccountApi.ts

@@ -1,7 +1,7 @@
-export interface IBankAccountApi {
-    getBankAccountById(bankAccountId: string): Promise<any>;
-
-    getBankById(bankId: string): Promise<any>;
-
-    getBankByCode(bankCode?: string, shortBankCode?: string): Promise<any>;
+export interface IBankAccountApi {
+    getBankAccountById(bankAccountId: string): Promise<any>;
+
+    getBankById(bankId: string): Promise<any>;
+
+    getBankByCode(bankCode?: string, shortBankCode?: string): Promise<any>;
 }

package/src/bbvaRst/api/BBVARstApi.ts

@@ -1,17 +1,17 @@
-import {IBBVARstApi} from "./interfaces/IBBVARstApi";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst";
-
-@injectable()
-export class BBVARstApi implements IBBVARstApi {
-    private readonly baseUrl = process.env.BBVA_RSTA_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async create(request: CreateRSTTransactionRequest): Promise<any> {
-        const url = `${this.baseUrl}/create`;
-        return await this.httpRequest.post(url, request);
-    }
+import {IBBVARstApi} from "./interfaces/IBBVARstApi.js";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst/index.js";
+
+@injectable()
+export class BBVARstApi implements IBBVARstApi {
+    private readonly baseUrl = process.env.BBVA_RSTA_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async create(request: CreateRSTTransactionRequest): Promise<any> {
+        const url = `${this.baseUrl}/create`;
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/bbvaRst/api/interfaces/IBBVARstApi.ts

@@ -1,5 +1,5 @@
-import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst";
-
-export interface IBBVARstApi {
-    create(request: CreateRSTTransactionRequest): Promise<any>;
+import {CreateRSTTransactionRequest} from "@fiado/type-kit/bin/bbvaRst/index.js";
+
+export interface IBBVARstApi {
+    create(request: CreateRSTTransactionRequest): Promise<any>;
 }

package/src/bbvaRst/index.ts

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

package/src/benefits-marketplace/api/BenefitsMarketplaceApi.ts

@@ -1,35 +1,35 @@
-import {IBenefitsMarketplaceApi} from "./interfaces/IBenefitsMarketplaceApi";
-import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
-import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
-import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse";
-
-@injectable()
-export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
-    private readonly baseUrl = process.env.BENEFITS_MARKETPLACE_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
-    }
-
-    async pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
-        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async consultPayment(
-        moduleName: string,
-        transactionNumber: string,
-    ): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
-        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}/transactions/${encodeURIComponent(transactionNumber)}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getLeafDisplay(
-        benefitId: string,
-        leafId: string,
-    ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>> {
-        const url = `${this.baseUrl}/${encodeURIComponent(benefitId)}/leaves/${encodeURIComponent(leafId)}/display`;
-        return await this.httpRequest.get(url);
-    }
-}
+import {IBenefitsMarketplaceApi} from "./interfaces/IBenefitsMarketplaceApi.js";
+import {inject, injectable} from "inversify";
+import {IHttpRequest} from "@fiado/http-client";
+import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse.js";
+
+@injectable()
+export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
+    private readonly baseUrl = process.env.BENEFITS_MARKETPLACE_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
+        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async consultPayment(
+        moduleName: string,
+        transactionNumber: string,
+    ): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
+        const url = `${this.baseUrl}/pay/${encodeURIComponent(moduleName)}/transactions/${encodeURIComponent(transactionNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getLeafDisplay(
+        benefitId: string,
+        leafId: string,
+    ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>> {
+        const url = `${this.baseUrl}/${encodeURIComponent(benefitId)}/leaves/${encodeURIComponent(leafId)}/display`;
+        return await this.httpRequest.get(url);
+    }
+}

package/src/benefits-marketplace/api/dtos/BenefitLeafDisplayResponse.ts

@@ -1,21 +1,21 @@
-/**
- * Respuesta del endpoint privado `GET /{benefitId}/leaves/{leafId}/display`
- * del marketplace. Pensado para que el procesador resuelva nombres legibles
- * (categoria/servicio) al armar la transacción, sin descargar el árbol entero
- * del catálogo.
- *
- * Equivalente conceptual al `subcategoria`/`servicio` que el procesador lee
- * del catálogo SPEI cuando arma `productDetail.targetName`.
- */
-export interface BenefitLeafDisplayResponse {
-    /**
-     * Nombre de la subcategoría a la que pertenece el leaf (ej. "TELMEX", "CFE").
-     * El procesador lo usa como `targetName` con `.toUpperCase()`, paridad con SPEI.
-     */
-    subcategoryName: string;
-    /**
-     * Nombre del servicio específico dentro de la subcategoría (ej. "Telmex Hogar Plan 500").
-     * Disponible para descripciones / detalle de transacción si el caller lo necesita.
-     */
-    serviceName: string;
-}
+/**
+ * Respuesta del endpoint privado `GET /{benefitId}/leaves/{leafId}/display`
+ * del marketplace. Pensado para que el procesador resuelva nombres legibles
+ * (categoria/servicio) al armar la transacción, sin descargar el árbol entero
+ * del catálogo.
+ *
+ * Equivalente conceptual al `subcategoria`/`servicio` que el procesador lee
+ * del catálogo SPEI cuando arma `productDetail.targetName`.
+ */
+export interface BenefitLeafDisplayResponse {
+    /**
+     * Nombre de la subcategoría a la que pertenece el leaf (ej. "TELMEX", "CFE").
+     * El procesador lo usa como `targetName` con `.toUpperCase()`, paridad con SPEI.
+     */
+    subcategoryName: string;
+    /**
+     * Nombre del servicio específico dentro de la subcategoría (ej. "Telmex Hogar Plan 500").
+     * Disponible para descripciones / detalle de transacción si el caller lo necesita.
+     */
+    serviceName: string;
+}

package/src/benefits-marketplace/api/interfaces/IBenefitsMarketplaceApi.ts

@@ -1,62 +1,62 @@
-import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
-import {BenefitLeafDisplayResponse} from "../dtos/BenefitLeafDisplayResponse";
-
-/**
- * Cliente único del procesador hacia benefits-marketplace-business (Fase 2).
- *
- * Lo consume exclusivamente BenefitsMarketplaceTransactionService dentro de
- * transaction-processor-business. Ningún otro service del procesador conoce
- * este cliente.
- *
- * Endpoint backend: POST /pay/{moduleName} (privado, dentro de la VPC).
- * El marketplace resuelve `moduleName` a un publisher y reenvía la request
- * tal cual al conector correspondiente con `BenefitPaymentRequest`.
- */
-export interface IBenefitsMarketplaceApi {
-    /**
-     * Invoca el pago contra el marketplace. Backend: POST /pay/{moduleName}.
-     *
-     * @param moduleName  Nombre del conector destino (ej. "stp-service-pay-connector",
-     *                    "multicomm-service-pay-connector", "donations-pay-connector").
-     *                    Se transmite como path-param y NO debe llevar slashes ni codificación
-     *                    extra: el cliente lo aplica directamente en la URL.
-     * @param request     Cuerpo estandarizado de la transacción.
-     */
-    pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
-
-    /**
-     * Consulta el estado actual de un pago previamente enviado al marketplace.
-     * Backend: GET /pay/{moduleName}/transactions/{transactionNumber}.
-     *
-     * Lo consume el cron de timeout reconciliation del procesador
-     * (BenefitsMarketplaceTimeOutService) para decidir si publicar la
-     * transacción a la cola (cuando el marketplace confirma APPROVED) o
-     * reversar el débito ya hecho (cuando confirma REJECTED).
-     *
-     * @param moduleName         Mismo identificador del conector usado en pay().
-     * @param transactionNumber  Identificador único de la transacción del lado
-     *                           del procesador. Es el mismo `transactionNumber`
-     *                           que viajó en el `BenefitPaymentRequest` original.
-     */
-    consultPayment(moduleName: string, transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
-
-    /**
-     * Resuelve los nombres legibles del leaf (subcategoría y servicio) para que
-     * el procesador arme `productDetail.targetName` con paridad al flujo SPEI.
-     * Backend: GET /{benefitId}/leaves/{leafId}/display.
-     *
-     * Endpoint dedicado y barato: solo trae los dos nombres necesarios, sin
-     * descargar el árbol completo del catálogo. El procesador lo invoca dentro
-     * de `authorize()`, antes de cualquier débito, y aborta la operación si la
-     * respuesta no es válida.
-     *
-     * @param benefitId  Identificador del beneficio (filtro requerido por el
-     *                   resolver del marketplace para invocar al conector correcto).
-     * @param leafId     Identificador del leaf (`base64url("<moduleName>::<idServicio>")`).
-     */
-    getLeafDisplay(
-        benefitId: string,
-        leafId: string,
-    ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>>;
-}
+import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {BenefitLeafDisplayResponse} from "../dtos/BenefitLeafDisplayResponse.js";
+
+/**
+ * Cliente único del procesador hacia benefits-marketplace-business (Fase 2).
+ *
+ * Lo consume exclusivamente BenefitsMarketplaceTransactionService dentro de
+ * transaction-processor-business. Ningún otro service del procesador conoce
+ * este cliente.
+ *
+ * Endpoint backend: POST /pay/{moduleName} (privado, dentro de la VPC).
+ * El marketplace resuelve `moduleName` a un publisher y reenvía la request
+ * tal cual al conector correspondiente con `BenefitPaymentRequest`.
+ */
+export interface IBenefitsMarketplaceApi {
+    /**
+     * Invoca el pago contra el marketplace. Backend: POST /pay/{moduleName}.
+     *
+     * @param moduleName  Nombre del conector destino (ej. "stp-service-pay-connector",
+     *                    "multicomm-service-pay-connector", "donations-pay-connector").
+     *                    Se transmite como path-param y NO debe llevar slashes ni codificación
+     *                    extra: el cliente lo aplica directamente en la URL.
+     * @param request     Cuerpo estandarizado de la transacción.
+     */
+    pay(moduleName: string, request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+
+    /**
+     * Consulta el estado actual de un pago previamente enviado al marketplace.
+     * Backend: GET /pay/{moduleName}/transactions/{transactionNumber}.
+     *
+     * Lo consume el cron de timeout reconciliation del procesador
+     * (BenefitsMarketplaceTimeOutService) para decidir si publicar la
+     * transacción a la cola (cuando el marketplace confirma APPROVED) o
+     * reversar el débito ya hecho (cuando confirma REJECTED).
+     *
+     * @param moduleName         Mismo identificador del conector usado en pay().
+     * @param transactionNumber  Identificador único de la transacción del lado
+     *                           del procesador. Es el mismo `transactionNumber`
+     *                           que viajó en el `BenefitPaymentRequest` original.
+     */
+    consultPayment(moduleName: string, transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+
+    /**
+     * Resuelve los nombres legibles del leaf (subcategoría y servicio) para que
+     * el procesador arme `productDetail.targetName` con paridad al flujo SPEI.
+     * Backend: GET /{benefitId}/leaves/{leafId}/display.
+     *
+     * Endpoint dedicado y barato: solo trae los dos nombres necesarios, sin
+     * descargar el árbol completo del catálogo. El procesador lo invoca dentro
+     * de `authorize()`, antes de cualquier débito, y aborta la operación si la
+     * respuesta no es válida.
+     *
+     * @param benefitId  Identificador del beneficio (filtro requerido por el
+     *                   resolver del marketplace para invocar al conector correcto).
+     * @param leafId     Identificador del leaf (`base64url("<moduleName>::<idServicio>")`).
+     */
+    getLeafDisplay(
+        benefitId: string,
+        leafId: string,
+    ): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>>;
+}

package/src/benefits-marketplace/index.ts

@@ -1,3 +1,3 @@
-export * from './api/interfaces/IBenefitsMarketplaceApi';
-export * from './api/BenefitsMarketplaceApi';
-export * from './api/dtos/BenefitLeafDisplayResponse';
+export * from './api/interfaces/IBenefitsMarketplaceApi.js';
+export * from './api/BenefitsMarketplaceApi.js';
+export * from './api/dtos/BenefitLeafDisplayResponse.js';