@fiado/api-invoker 4.59.0 → 4.61.0

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

@@ -1,231 +1,231 @@
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import {
-    CohortCountRequest,
-    CohortCountResponse,
-    CohortUserMatchRequest,
-    CohortUserMatchResponse,
-    PricingMetricsRequest,
-    PricingMetricsResponse,
-    PromotionReachRequest,
-    PromotionReachResponse,
-    SegmentMetricsRequest,
-    SegmentMetricsResponse,
-    WholesaleRateRequest,
-    WholesaleRateResponse,
-    RemittanceCorridor,
-    PricingScheduleResponse,
-    KycUserDetail,
-    KycUsersListResponse,
-    KycOnboardingAttemptsResponse,
-    RefreshUserProfileResponse,
-    RegisterOnboardingBlockRequest,
-    RegisterOnboardingBlockResponse,
-    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,
-    RemittanceUserLimits,
-    RemittanceUserLimitsBatchResponse,
-} from "@fiado/type-kit/bin/remittance/index.js";
-
-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 }>>;
-    /** Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule. */
-    pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
-
-    // ─── 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>>;
-
-    /**
-     * Detalle completo de una tx por el transactionNumber del procesador.
-     * Requiere directoryId para validar ownership y reconciliar status contra UNIR.
-     */
-    getTransactionDetailByMarketplaceRef(
-        directoryId: string,
-        ref: string,
-    ): Promise<ApiGatewayResponse<RemittanceTransactionDetail>>;
-
-    /**
-     * Recibo HTML-APP de una tx resolviendo el txNumber desde el transactionNumber
-     * del procesador (marketplace ref). La app pide el recibo con 1 llamada usando
-     * el transactionNumber que ya recibe del authorize. 404 REMITTANCE_TX_NOT_READY
-     * si la row de remesa aún no existe (pago diferido/timeout).
-     */
-    getTransactionReceiptByMarketplaceRef(
-        directoryId: string,
-        ref: string,
-    ): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>>;
-
-    // ─── 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>>;
-    /** Límites por usuario (Operación · read-only): ventanas (límite del provider + usage) + nivel + discrepancia. */
-    backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
-    /** Batch de límites para la tabla de Límites (CSV de directoryIds). */
-    backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>>;
-
-    // ─── Aceptación (KYC monitoring, SPEC_06 — read-only + refresh on-demand) ──────
-    /** Lista de usuarios KYC. Filtros: status (default PENDING en el connector) | search (email o directoryId); pageSize; index cursor opaco. */
-    kycListUsers(filters?: { status?: string; search?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
-    /** Detalle 360 KYC (identidad + snapshot UNIR + último rechazo). 404 si no existe. */
-    kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
-    /** Refresca el perfil del usuario desde UNIR (EP-34). Rate-limited 5/min por directoryId en el connector. */
-    kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
-    /** #6 — Historial de intentos de onboarding (request/response del SignUp, verbatim) de un usuario. */
-    kycOnboardingAttempts(directoryId: string): Promise<ApiGatewayResponse<KycOnboardingAttemptsResponse>>;
-    /** #3 — Registra un onboarding bloqueado por dirección (deja el usuario PENDING + rejection en el connector). Lo consume benefits. */
-    registerOnboardingBlock(request: RegisterOnboardingBlockRequest): Promise<ApiGatewayResponse<RegisterOnboardingBlockResponse>>;
-
-    // ─── Cohorts (Dashboard Ops · B2 — puente de recálculo Opción A) ────────────────
-    /** Cuenta usuarios que cumplen las condiciones (AND) + universo total. Lo consume remittance-business al recalcular un cohort. */
-    cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
-    /** Determina si un usuario puntual matchea las condiciones (AND) de un cohort. Lo consume remittance-business. */
-    cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>>;
-
-    // ─── Segmentos (Dashboard Ops — puente de métricas Opción A) ────────────────────
-    /** {clientCount, volMonthUSD} para el subconjunto de RemittanceUsers del segmento (mes calendario, sin canceladas). */
-    segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
-
-    // ─── Precio Base (Dashboard Ops · Variables Operativas — puente Fase A) ─────────
-    /** Wholesale vivo (ExternalQuickQuotes) del corredor — Simulador de Precio Base. */
-    wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>>;
-    /** {clientCount, volMonthUSD} del subconjunto de directoryIds FILTRADO por corredor (countryISO). */
-    pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>>;
-
-    // ─── Promociones (Dashboard Ops · Variables Operativas — puente Fase A) ─────────
-    /** Alcance {reach, total} de una audiencia: directoryIds × conditions × corridor (dimensión ausente = no filtra). */
-    promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>>;
-}
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {
+    CohortCountRequest,
+    CohortCountResponse,
+    CohortUserMatchRequest,
+    CohortUserMatchResponse,
+    PricingMetricsRequest,
+    PricingMetricsResponse,
+    PromotionReachRequest,
+    PromotionReachResponse,
+    SegmentMetricsRequest,
+    SegmentMetricsResponse,
+    WholesaleRateRequest,
+    WholesaleRateResponse,
+    RemittanceCorridor,
+    PricingScheduleResponse,
+    KycUserDetail,
+    KycUsersListResponse,
+    KycOnboardingAttemptsResponse,
+    RefreshUserProfileResponse,
+    RegisterOnboardingBlockRequest,
+    RegisterOnboardingBlockResponse,
+    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,
+    RemittanceUserLimits,
+    RemittanceUserLimitsBatchResponse,
+} from "@fiado/type-kit/bin/remittance/index.js";
+
+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 }>>;
+    /** Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule. */
+    pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
+
+    // ─── 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>>;
+
+    /**
+     * Detalle completo de una tx por el transactionNumber del procesador.
+     * Requiere directoryId para validar ownership y reconciliar status contra UNIR.
+     */
+    getTransactionDetailByMarketplaceRef(
+        directoryId: string,
+        ref: string,
+    ): Promise<ApiGatewayResponse<RemittanceTransactionDetail>>;
+
+    /**
+     * Recibo HTML-APP de una tx resolviendo el txNumber desde el transactionNumber
+     * del procesador (marketplace ref). La app pide el recibo con 1 llamada usando
+     * el transactionNumber que ya recibe del authorize. 404 REMITTANCE_TX_NOT_READY
+     * si la row de remesa aún no existe (pago diferido/timeout).
+     */
+    getTransactionReceiptByMarketplaceRef(
+        directoryId: string,
+        ref: string,
+    ): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>>;
+
+    // ─── 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>>;
+    /** Límites por usuario (Operación · read-only): ventanas (límite del provider + usage) + nivel + discrepancia. */
+    backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
+    /** Batch de límites para la tabla de Límites (CSV de directoryIds). */
+    backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>>;
+
+    // ─── Aceptación (KYC monitoring, SPEC_06 — read-only + refresh on-demand) ──────
+    /** Lista de usuarios KYC. Filtros: status (default PENDING en el connector) | search (email o directoryId); pageSize; index cursor opaco. */
+    kycListUsers(filters?: { status?: string; search?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
+    /** Detalle 360 KYC (identidad + snapshot UNIR + último rechazo). 404 si no existe. */
+    kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
+    /** Refresca el perfil del usuario desde UNIR (EP-34). Rate-limited 5/min por directoryId en el connector. */
+    kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
+    /** #6 — Historial de intentos de onboarding (request/response del SignUp, verbatim) de un usuario. */
+    kycOnboardingAttempts(directoryId: string): Promise<ApiGatewayResponse<KycOnboardingAttemptsResponse>>;
+    /** #3 — Registra un onboarding bloqueado por dirección (deja el usuario PENDING + rejection en el connector). Lo consume benefits. */
+    registerOnboardingBlock(request: RegisterOnboardingBlockRequest): Promise<ApiGatewayResponse<RegisterOnboardingBlockResponse>>;
+
+    // ─── Cohorts (Dashboard Ops · B2 — puente de recálculo Opción A) ────────────────
+    /** Cuenta usuarios que cumplen las condiciones (AND) + universo total. Lo consume remittance-business al recalcular un cohort. */
+    cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
+    /** Determina si un usuario puntual matchea las condiciones (AND) de un cohort. Lo consume remittance-business. */
+    cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>>;
+
+    // ─── Segmentos (Dashboard Ops — puente de métricas Opción A) ────────────────────
+    /** {clientCount, volMonthUSD} para el subconjunto de RemittanceUsers del segmento (mes calendario, sin canceladas). */
+    segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;
+
+    // ─── Precio Base (Dashboard Ops · Variables Operativas — puente Fase A) ─────────
+    /** Wholesale vivo (ExternalQuickQuotes) del corredor — Simulador de Precio Base. */
+    wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>>;
+    /** {clientCount, volMonthUSD} del subconjunto de directoryIds FILTRADO por corredor (countryISO). */
+    pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>>;
+
+    // ─── Promociones (Dashboard Ops · Variables Operativas — puente Fase A) ─────────
+    /** Alcance {reach, total} de una audiencia: directoryIds × conditions × corridor (dimensión ausente = no filtra). */
+    promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>>;
+}

package/src/uniteller-connector/index.ts

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

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();
+    }
 }

package/src/wallet-funding-rules/api/WalletFundingRulesApi.ts

@@ -1,37 +1,37 @@
-import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import {
-    ReserveExposureRequest,
-    ReserveExposureResponse,
-    ReleaseExposureRequest,
-    ReleaseExposureResponse,
-    GetExposureStateResponse,
-} from "@fiado/type-kit/bin/walletFunding/index.js";
-import { IWalletFundingRulesApi } from "./interfaces/IWalletFundingRulesApi.js";
-
-@injectable()
-export default class WalletFundingRulesApi implements IWalletFundingRulesApi {
-    private readonly baseUrl = process.env.WALLET_FUNDING_RULES_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
-
-    async reserveExposure(
-        request: ReserveExposureRequest,
-    ): Promise<ApiGatewayResponse<ReserveExposureResponse>> {
-        const url = `${this.baseUrl}/reserve`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async releaseExposure(
-        request: ReleaseExposureRequest,
-    ): Promise<ApiGatewayResponse<ReleaseExposureResponse>> {
-        const url = `${this.baseUrl}/release`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async getExposureState(): Promise<ApiGatewayResponse<GetExposureStateResponse>> {
-        const url = `${this.baseUrl}/state`;
-        return await this.httpRequest.get(url);
-    }
-}
+import { inject, injectable } from "inversify";
+import { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import {
+    ReserveExposureRequest,
+    ReserveExposureResponse,
+    ReleaseExposureRequest,
+    ReleaseExposureResponse,
+    GetExposureStateResponse,
+} from "@fiado/type-kit/bin/walletFunding/index.js";
+import { IWalletFundingRulesApi } from "./interfaces/IWalletFundingRulesApi.js";
+
+@injectable()
+export default class WalletFundingRulesApi implements IWalletFundingRulesApi {
+    private readonly baseUrl = process.env.WALLET_FUNDING_RULES_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async reserveExposure(
+        request: ReserveExposureRequest,
+    ): Promise<ApiGatewayResponse<ReserveExposureResponse>> {
+        const url = `${this.baseUrl}/reserve`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async releaseExposure(
+        request: ReleaseExposureRequest,
+    ): Promise<ApiGatewayResponse<ReleaseExposureResponse>> {
+        const url = `${this.baseUrl}/release`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async getExposureState(): Promise<ApiGatewayResponse<GetExposureStateResponse>> {
+        const url = `${this.baseUrl}/state`;
+        return await this.httpRequest.get(url);
+    }
+}