@fiado/api-invoker 4.13.0 → 4.15.0

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

@@ -1,125 +1,203 @@
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter";
-import {
-    RemittanceAddBeneficiaryRequest,
-    RemittanceBeneficiary,
-    RemittanceHomeResponse,
-    RemittanceListBeneficiariesResponse,
-    RemittanceOnboardRequest,
-    RemittanceOnboardResponse,
-    RemittancePayRequest,
-    RemittancePayResponse,
-    RemittancePayerAdditionalFieldDto,
-    RemittancePayerBranchDto,
-    RemittancePayerDto,
-    RemittanceQuoteRequest,
-    RemittanceQuoteResponse,
-    RemittanceSecurityQuestionsResponse,
-    RemittanceSendPreviewRequest,
-    RemittanceSendPreviewResponse,
-    RemittanceStateDto,
-    RemittanceUpdateBeneficiaryRequest,
-} from "@fiado/type-kit/bin/remittance";
-import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi";
-
-@injectable()
-export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
-    private readonly baseUrl = process.env.UNITELLER_CONNECTOR_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
-
-    async getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>> {
-        const url = `${this.baseUrl}/home`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async getSecurityQuestions(): Promise<ApiGatewayResponse<RemittanceSecurityQuestionsResponse>> {
-        const url = `${this.baseUrl}/onboard/security-questions`;
-        return await this.httpRequest.get(url);
-    }
-
-    async onboard(request: RemittanceOnboardRequest): Promise<ApiGatewayResponse<RemittanceOnboardResponse>> {
-        const url = `${this.baseUrl}/onboard`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async getStandardCatalog(): Promise<ApiGatewayResponse<ConnectorCatalogItem[]>> {
-        const url = `${this.baseUrl}/catalog/standard`;
-        return await this.httpRequest.get(url);
-    }
-
-    async countryStates(countryISO: string): Promise<ApiGatewayResponse<RemittanceStateDto[]>> {
-        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/states`;
-        return await this.httpRequest.get(url);
-    }
-
-    async countryPayers(countryISO: string, currencyISO: string): Promise<ApiGatewayResponse<RemittancePayerDto[]>> {
-        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/payers`;
-        return await this.httpRequest.get(url, { currencyISO });
-    }
-
-    async payerBranches(params: { payerCode: string; receptionMethodName: string; countryISO: string; currencyISO: string; stateISO: string }): Promise<ApiGatewayResponse<RemittancePayerBranchDto[]>> {
-        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/branches`;
-        return await this.httpRequest.get(url, {
-            receptionMethodName: params.receptionMethodName,
-            countryISO: params.countryISO,
-            currencyISO: params.currencyISO,
-            stateISO: params.stateISO,
-        });
-    }
-
-    async payerAdditionalFields(params: { payerCode: string; currencyISO: string; receptionMethodName: string }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>> {
-        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/fields`;
-        return await this.httpRequest.get(url, {
-            currencyISO: params.currencyISO,
-            receptionMethodName: params.receptionMethodName,
-        });
-    }
-
-    async listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>> {
-        const url = `${this.baseUrl}/beneficiaries/list`;
-        return await this.httpRequest.post(url, { directoryId, includeDeactivated });
-    }
-
-    async getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
-        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
-        const url = `${this.baseUrl}/beneficiaries`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
-        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
-        return await this.httpRequest.put(url, { directoryId, ...request });
-    }
-
-    async deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>> {
-        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>> {
-        const url = `${this.baseUrl}/quote`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>> {
-        const url = `${this.baseUrl}/send/preview`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>> {
-        const url = `${this.baseUrl}/pay`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>> {
-        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}`;
-        return await this.httpRequest.get(url);
-    }
-}
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter";
+import {
+    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,
+} from "@fiado/type-kit/bin/remittance";
+import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi";
+
+@injectable()
+export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
+    private readonly baseUrl = process.env.UNITELLER_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>> {
+        const url = `${this.baseUrl}/home`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async getSecurityQuestions(): Promise<ApiGatewayResponse<RemittanceSecurityQuestionsResponse>> {
+        const url = `${this.baseUrl}/onboard/security-questions`;
+        return await this.httpRequest.get(url);
+    }
+
+    async onboard(request: RemittanceOnboardRequest): Promise<ApiGatewayResponse<RemittanceOnboardResponse>> {
+        const url = `${this.baseUrl}/onboard`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async getStandardCatalog(): Promise<ApiGatewayResponse<ConnectorCatalogItem[]>> {
+        const url = `${this.baseUrl}/catalog/standard`;
+        return await this.httpRequest.get(url);
+    }
+
+    async countryStates(countryISO: string): Promise<ApiGatewayResponse<RemittanceStateDto[]>> {
+        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/states`;
+        return await this.httpRequest.get(url);
+    }
+
+    async countryPayers(countryISO: string, currencyISO: string): Promise<ApiGatewayResponse<RemittancePayerDto[]>> {
+        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/payers`;
+        return await this.httpRequest.get(url, { currencyISO });
+    }
+
+    async payerBranches(params: { payerCode: string; receptionMethodName: string; countryISO: string; currencyISO: string; stateISO: string }): Promise<ApiGatewayResponse<RemittancePayerBranchDto[]>> {
+        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/branches`;
+        return await this.httpRequest.get(url, {
+            receptionMethodName: params.receptionMethodName,
+            countryISO: params.countryISO,
+            currencyISO: params.currencyISO,
+            stateISO: params.stateISO,
+        });
+    }
+
+    async payerAdditionalFields(params: { payerCode: string; currencyISO: string; receptionMethodName: string }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>> {
+        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/fields`;
+        return await this.httpRequest.get(url, {
+            currencyISO: params.currencyISO,
+            receptionMethodName: params.receptionMethodName,
+        });
+    }
+
+    async listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>> {
+        const url = `${this.baseUrl}/beneficiaries/list`;
+        return await this.httpRequest.post(url, { directoryId, includeDeactivated });
+    }
+
+    async getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+        const url = `${this.baseUrl}/beneficiaries`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
+        return await this.httpRequest.put(url, { directoryId, ...request });
+    }
+
+    async deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>> {
+        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>> {
+        const url = `${this.baseUrl}/quote`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>> {
+        const url = `${this.baseUrl}/send/preview`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>> {
+        const url = `${this.baseUrl}/pay`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>> {
+        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async listTransactions(directoryId: string, filters?: RemittanceTransactionsListRequest): Promise<ApiGatewayResponse<RemittanceTransactionsListResponse>> {
+        const url = `${this.baseUrl}/transactions/list`;
+        return await this.httpRequest.post(url, { directoryId, ...(filters ?? {}) });
+    }
+
+    async getTransaction(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionDetail>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async getTransactionReceipt(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/receipt`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async cancelTransaction(directoryId: string, txNumber: string, request: RemittanceCancelRequest): Promise<ApiGatewayResponse<RemittanceCancelResponse>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/cancel`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{ sent: boolean }>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/sms`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>> {
+        const url = `${this.baseUrl}/backoffice/dashboard`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeListUsers(filters?: { status?: string; email?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>> {
+        const url = `${this.baseUrl}/backoffice/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>> {
+        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeListTransactions(filters?: { txNumber?: string; directoryId?: string; status?: string; countryISO?: string; from?: string; to?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>> {
+        const url = `${this.baseUrl}/backoffice/transactions`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>> {
+        const url = `${this.baseUrl}/backoffice/transactions/${encodeURIComponent(txNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>> {
+        const url = `${this.baseUrl}/backoffice/stats`;
+        return await this.httpRequest.get(url, { period });
+    }
+}
+
+/** Quita las keys undefined para no mandar query params vacíos. */
+function dropUndefined(params?: Record<string, string | number | undefined>): Record<string, string | number> | undefined {
+    if (!params) return undefined;
+    const clean = Object.fromEntries(
+        Object.entries(params).filter(([, value]) => value !== undefined),
+    ) as Record<string, string | number>;
+    return Object.keys(clean).length > 0 ? clean : undefined;
+}

package/src/uniteller-connector/api/interfaces/IUnitellerConnectorApi.ts

@@ -1,102 +1,151 @@
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter";
-import {
-    RemittanceAddBeneficiaryRequest,
-    RemittanceBeneficiary,
-    RemittanceHomeResponse,
-    RemittanceListBeneficiariesResponse,
-    RemittanceOnboardRequest,
-    RemittanceOnboardResponse,
-    RemittancePayRequest,
-    RemittancePayResponse,
-    RemittancePayerAdditionalFieldDto,
-    RemittancePayerBranchDto,
-    RemittancePayerDto,
-    RemittanceQuoteRequest,
-    RemittanceQuoteResponse,
-    RemittanceSecurityQuestionsResponse,
-    RemittanceSendPreviewRequest,
-    RemittanceSendPreviewResponse,
-    RemittanceStateDto,
-    RemittanceUpdateBeneficiaryRequest,
-} from "@fiado/type-kit/bin/remittance";
-
-export interface IUnitellerConnectorApi {
-    /** Estado del módulo remesas para un directoryId. */
-    getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>>;
-
-    /** Lista de preguntas de seguridad UNIR (compliance — no consumido por mobile bajo DP-05). */
-    getSecurityQuestions(): Promise<ApiGatewayResponse<RemittanceSecurityQuestionsResponse>>;
-
-    /** Activa el servicio de remesas (silent signup en UNIR). */
-    onboard(request: RemittanceOnboardRequest): Promise<ApiGatewayResponse<RemittanceOnboardResponse>>;
-
-    /**
-     * Catálogo en formato estándar ConnectorCatalogItem[] que el
-     * CatalogTreeBuilder de benefits-marketplace consume para armar el árbol
-     * del benefit Remittance (D-F3.7).
-     */
-    getStandardCatalog(): Promise<ApiGatewayResponse<ConnectorCatalogItem[]>>;
-
-    // ─── Catálogo lazy para el wizard del frontend (F3.6) ──────────────────────
-
-    /** Estados / departamentos del país destino (ej. GT-GU, SV-SS). */
-    countryStates(countryISO: string): Promise<ApiGatewayResponse<RemittanceStateDto[]>>;
-
-    /**
-     * Payers disponibles para el país+currency (deduplicado por payerSpecificCode),
-     * con `beneAccountRegex`, `isPayerBranchRequired` y `isAdditionalFieldRequired`
-     * para que el cliente decida los pasos del wizard.
-     */
-    countryPayers(countryISO: string, currencyISO: string): Promise<ApiGatewayResponse<RemittancePayerDto[]>>;
-
-    /** Sucursales del payer (cuando isPayerBranchRequired = YES y receptionMethod = Cash Pickup). */
-    payerBranches(params: {
-        payerCode: string;
-        receptionMethodName: string;
-        countryISO: string;
-        currencyISO: string;
-        stateISO: string;
-    }): Promise<ApiGatewayResponse<RemittancePayerBranchDto[]>>;
-
-    /** Additional fields requeridos por el payer (cuando isAdditionalFieldRequired = YES). */
-    payerAdditionalFields(params: {
-        payerCode: string;
-        currencyISO: string;
-        receptionMethodName: string;
-    }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>>;
-
-    // ─── Beneficiarios (F4) ──────────────────────────────────────────────────────
-
-    listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>>;
-    getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>>;
-
-    // ─── Quote + Preview (F5) ────────────────────────────────────────────────────
-
-    /** Cotización rápida (debounce). Read-only. */
-    quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>>;
-
-    /**
-     * Preview formal con previewRef. El previewRef se reusa en F6 al confirmar.
-     * Cache 10 min en RemittanceCache_GT (D-F5.4).
-     */
-    sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>>;
-
-    // ─── Send confirm (F6) ────────────────────────────────────────────────────────
-
-    /**
-     * Confirma la remesa previamente previsualizada (UNIR SendMoneyConfirm) y persiste
-     * la tx en el connector. Lo invoca el UniTellerConnectorPaymentPublisher de
-     * benefits-marketplace cuando el procesador delega el pago.
-     */
-    pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>>;
-
-    /**
-     * Lookup de una tx por el transactionNumber del procesador (consult/reconciliación).
-     * Lo consume el consult() de benefits-marketplace para el cron de timeout.
-     */
-    getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>>;
-}
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter";
+import {
+    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,
+} from "@fiado/type-kit/bin/remittance";
+
+export interface IUnitellerConnectorApi {
+    /** Estado del módulo remesas para un directoryId. */
+    getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>>;
+
+    /** Lista de preguntas de seguridad UNIR (compliance — no consumido por mobile bajo DP-05). */
+    getSecurityQuestions(): Promise<ApiGatewayResponse<RemittanceSecurityQuestionsResponse>>;
+
+    /** Activa el servicio de remesas (silent signup en UNIR). */
+    onboard(request: RemittanceOnboardRequest): Promise<ApiGatewayResponse<RemittanceOnboardResponse>>;
+
+    /**
+     * Catálogo en formato estándar ConnectorCatalogItem[] que el
+     * CatalogTreeBuilder de benefits-marketplace consume para armar el árbol
+     * del benefit Remittance (D-F3.7).
+     */
+    getStandardCatalog(): Promise<ApiGatewayResponse<ConnectorCatalogItem[]>>;
+
+    // ─── Catálogo lazy para el wizard del frontend (F3.6) ──────────────────────
+
+    /** Estados / departamentos del país destino (ej. GT-GU, SV-SS). */
+    countryStates(countryISO: string): Promise<ApiGatewayResponse<RemittanceStateDto[]>>;
+
+    /**
+     * Payers disponibles para el país+currency (deduplicado por payerSpecificCode),
+     * con `beneAccountRegex`, `isPayerBranchRequired` y `isAdditionalFieldRequired`
+     * para que el cliente decida los pasos del wizard.
+     */
+    countryPayers(countryISO: string, currencyISO: string): Promise<ApiGatewayResponse<RemittancePayerDto[]>>;
+
+    /** Sucursales del payer (cuando isPayerBranchRequired = YES y receptionMethod = Cash Pickup). */
+    payerBranches(params: {
+        payerCode: string;
+        receptionMethodName: string;
+        countryISO: string;
+        currencyISO: string;
+        stateISO: string;
+    }): Promise<ApiGatewayResponse<RemittancePayerBranchDto[]>>;
+
+    /** Additional fields requeridos por el payer (cuando isAdditionalFieldRequired = YES). */
+    payerAdditionalFields(params: {
+        payerCode: string;
+        currencyISO: string;
+        receptionMethodName: string;
+    }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>>;
+
+    // ─── Beneficiarios (F4) ──────────────────────────────────────────────────────
+
+    listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>>;
+    getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>>;
+
+    // ─── Quote + Preview (F5) ────────────────────────────────────────────────────
+
+    /** Cotización rápida (debounce). Read-only. */
+    quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>>;
+
+    /**
+     * Preview formal con previewRef. El previewRef se reusa en F6 al confirmar.
+     * Cache 10 min en RemittanceCache_GT (D-F5.4).
+     */
+    sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>>;
+
+    // ─── Send confirm (F6) ────────────────────────────────────────────────────────
+
+    /**
+     * Confirma la remesa previamente previsualizada (UNIR SendMoneyConfirm) y persiste
+     * la tx en el connector. Lo invoca el UniTellerConnectorPaymentPublisher de
+     * benefits-marketplace cuando el procesador delega el pago.
+     */
+    pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>>;
+
+    /**
+     * Lookup de una tx por el transactionNumber del procesador (consult/reconciliación).
+     * Lo consume el consult() de benefits-marketplace para el cron de timeout.
+     */
+    getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>>;
+
+    // ─── Historial + Cancel + Recibo + SMS (F7) ─────────────────────────────────
+
+    /**
+     * Historial paginado del usuario (lee RemittanceTransactions_GT, D-F7.1).
+     * Cursor estándar Fiado: `filters.index` opaco; el siguiente viene en
+     * `response.index`.
+     */
+    listTransactions(directoryId: string, filters?: RemittanceTransactionsListRequest): Promise<ApiGatewayResponse<RemittanceTransactionsListResponse>>;
+
+    /** Detalle de una tx (status reconciliado contra UNIR, D-F7.2). */
+    getTransaction(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionDetail>>;
+
+    /** Recibo HTML-APP de una tx (UNIR TransactionReceipt). */
+    getTransactionReceipt(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>>;
+
+    /**
+     * Cancela una tx (UNIR v2/CancelTransaction + status local CANCELLED).
+     * NO reintegra el wallet (procesador diferido — TODO F7).
+     */
+    cancelTransaction(directoryId: string, txNumber: string, request: RemittanceCancelRequest): Promise<ApiGatewayResponse<RemittanceCancelResponse>>;
+
+    /** SMS de UNIR al beneficiario de la tx (max 3 por tx). ⚠ gated por smoke. */
+    smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{ sent: boolean }>>;
+
+    // ─── Backoffice (F9, read-only — D2: el backoffice frontend entra por benefits) ─
+
+    backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>>;
+    /** Filtros: status (default ACTIVE en el connector) | email (lookup exacto); pageSize 1-100; index cursor opaco. */
+    backofficeListUsers(filters?: { status?: string; email?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>>;
+    backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>>;
+    /** Requiere al menos uno de txNumber | directoryId | status (el connector responde 400 si no). */
+    backofficeListTransactions(filters?: { txNumber?: string; directoryId?: string; status?: string; countryISO?: string; from?: string; to?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>>;
+    backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>>;
+    backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
+}

package/src/uniteller-connector/index.ts

@@ -1,2 +1,2 @@
-export * from "./api/interfaces/IUnitellerConnectorApi";
-export { default as UnitellerConnectorApi } from "./api/UnitellerConnectorApi";
+export * from "./api/interfaces/IUnitellerConnectorApi";
+export { default as UnitellerConnectorApi } from "./api/UnitellerConnectorApi";

package/src/utils/InvokerUtils.ts

@@ -1,19 +1,19 @@
-import {injectable} from "inversify";
-
-@injectable()
-export class InvokerUtils {
-    constructor() {
-    }
-
-    toQueryStringParameters(object: any): string {
-        const records: Record<string, string> = Object.entries(object).reduce((acc, [key, value]) => {
-            if (Array.isArray(value)) {
-                acc[key] = value.join(','); // Convierte arrays a una cadena separada por comas
-            } else {
-                acc[key] = String(value); // Convierte todos los demás valores a string
-            }
-            return acc;
-        }, {} as Record<string, string>);
-        return new URLSearchParams(records).toString();
-    }
+import {injectable} from "inversify";
+
+@injectable()
+export class InvokerUtils {
+    constructor() {
+    }
+
+    toQueryStringParameters(object: any): string {
+        const records: Record<string, string> = Object.entries(object).reduce((acc, [key, value]) => {
+            if (Array.isArray(value)) {
+                acc[key] = value.join(','); // Convierte arrays a una cadena separada por comas
+            } else {
+                acc[key] = String(value); // Convierte todos los demás valores a string
+            }
+            return acc;
+        }, {} as Record<string, string>);
+        return new URLSearchParams(records).toString();
+    }
 }