@fiado/api-invoker 4.54.0 → 4.56.0

package/bin/uniteller-connector/api/UnitellerConnectorApi.d.ts

@@ -1,7 +1,7 @@
 import type { IHttpRequest } from "@fiado/http-client";
 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, KycUserDetail, KycUsersListResponse, RefreshUserProfileResponse, 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";
+import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, 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";
 import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
 export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     private httpRequest;
@@ -38,6 +38,7 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>>;
     getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>>;
     getTransactionDetailByMarketplaceRef(directoryId: string, ref: string): Promise<ApiGatewayResponse<RemittanceTransactionDetail>>;
+    getTransactionReceiptByMarketplaceRef(directoryId: string, ref: string): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>>;
     listTransactions(directoryId: string, filters?: RemittanceTransactionsListRequest): Promise<ApiGatewayResponse<RemittanceTransactionsListResponse>>;
     getTransaction(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionDetail>>;
     getTransactionReceipt(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>>;
@@ -75,6 +76,8 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     }): Promise<ApiGatewayResponse<KycUsersListResponse>>;
     kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>>;
     kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>>;
+    kycOnboardingAttempts(directoryId: string): Promise<ApiGatewayResponse<KycOnboardingAttemptsResponse>>;
+    registerOnboardingBlock(request: RegisterOnboardingBlockRequest): Promise<ApiGatewayResponse<RegisterOnboardingBlockResponse>>;
     cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>>;
     cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>>;
     segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>>;

package/bin/uniteller-connector/api/UnitellerConnectorApi.js

@@ -97,6 +97,10 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/detail`;
         return await this.httpRequest.post(url, { directoryId });
     }
+    async getTransactionReceiptByMarketplaceRef(directoryId, ref) {
+        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/receipt`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
     async listTransactions(directoryId, filters) {
         const url = `${this.baseUrl}/transactions/list`;
         return await this.httpRequest.post(url, { directoryId, ...(filters ?? {}) });
@@ -161,6 +165,14 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/refresh`;
         return await this.httpRequest.post(url, {});
     }
+    async kycOnboardingAttempts(directoryId) {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/onboarding-attempts`;
+        return await this.httpRequest.get(url);
+    }
+    async registerOnboardingBlock(request) {
+        const url = `${this.baseUrl}/onboard/block`;
+        return await this.httpRequest.post(url, request);
+    }
     async cohortCount(request) {
         const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
         return await this.httpRequest.post(url, request);

package/bin/uniteller-connector/api/interfaces/IUnitellerConnectorApi.d.ts

@@ -1,6 +1,6 @@
 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, KycUserDetail, KycUsersListResponse, RefreshUserProfileResponse, 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";
+import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, 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>>;
@@ -67,6 +67,13 @@ export interface IUnitellerConnectorApi {
      * 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 paginado del usuario (lee RemittanceTransactions_GT, D-F7.1).
      * Cursor estándar Fiado: `filters.index` opaco; el siguiente viene en
@@ -123,6 +130,10 @@ export interface IUnitellerConnectorApi {
     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>>;
     /** 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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.54.0",
+  "version": "4.56.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.163.0",
+    "@fiado/type-kit": "^3.173.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

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

@@ -17,7 +17,10 @@ import {
     WholesaleRateResponse,
     KycUserDetail,
     KycUsersListResponse,
+    KycOnboardingAttemptsResponse,
     RefreshUserProfileResponse,
+    RegisterOnboardingBlockRequest,
+    RegisterOnboardingBlockResponse,
     RemittanceAddBeneficiaryRequest,
     RemittanceBackofficeDashboardSummary,
     RemittanceBackofficeStats,
@@ -162,6 +165,14 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         return await this.httpRequest.post(url, { directoryId });
     }
 
+    async getTransactionReceiptByMarketplaceRef(
+        directoryId: string,
+        ref: string,
+    ): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>> {
+        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/receipt`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
     async listTransactions(directoryId: string, filters?: RemittanceTransactionsListRequest): Promise<ApiGatewayResponse<RemittanceTransactionsListResponse>> {
         const url = `${this.baseUrl}/transactions/list`;
         return await this.httpRequest.post(url, { directoryId, ...(filters ?? {}) });
@@ -242,6 +253,16 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         return await this.httpRequest.post(url, {});
     }
 
+    async kycOnboardingAttempts(directoryId: string): Promise<ApiGatewayResponse<KycOnboardingAttemptsResponse>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/onboarding-attempts`;
+        return await this.httpRequest.get(url);
+    }
+
+    async registerOnboardingBlock(request: RegisterOnboardingBlockRequest): Promise<ApiGatewayResponse<RegisterOnboardingBlockResponse>> {
+        const url = `${this.baseUrl}/onboard/block`;
+        return await this.httpRequest.post(url, request);
+    }
+
     async cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>> {
         const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
         return await this.httpRequest.post(url, request);

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

@@ -15,7 +15,10 @@ import {
     WholesaleRateResponse,
     KycUserDetail,
     KycUsersListResponse,
+    KycOnboardingAttemptsResponse,
     RefreshUserProfileResponse,
+    RegisterOnboardingBlockRequest,
+    RegisterOnboardingBlockResponse,
     RemittanceAddBeneficiaryRequest,
     RemittanceBackofficeDashboardSummary,
     RemittanceBackofficeStats,
@@ -140,6 +143,17 @@ export interface IUnitellerConnectorApi {
         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) ─────────────────────────────────
 
     /**
@@ -186,6 +200,10 @@ export interface IUnitellerConnectorApi {
     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. */