@fiado/api-invoker 5.88.0 → 5.89.0

package/bin/benefits-marketplace/api/BenefitsMarketplaceApi.d.ts

@@ -1,7 +1,7 @@
 import { IBenefitsMarketplaceApi } from "./interfaces/IBenefitsMarketplaceApi.js";
-import { IHttpRequest } from "@fiado/http-client";
-import { BenefitPaymentRequest, BenefitPaymentResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import type { IHttpRequest } from "@fiado/http-client";
+import { BenefitPaymentRequest, BenefitPaymentResponse, BenefitSuiteResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import { ApiGatewayResponse, StandardResponse } from "@fiado/gateway-adapter";
 import { RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { BenefitLeafDisplayResponse } from "./dtos/BenefitLeafDisplayResponse.js";
 import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
@@ -15,4 +15,5 @@ export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
     fundingCreate(moduleName: string, request: CreateFundingReferenceRequest): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
     fundingList(moduleName: string, directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
     remittanceOnboardingPrefill(request: RemittanceOnboardingPrefillRequest): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>>;
+    getBenefitSuite(benefitId: string): Promise<StandardResponse<BenefitSuiteResponse>>;
 }

package/bin/benefits-marketplace/api/BenefitsMarketplaceApi.js

@@ -44,6 +44,11 @@ let BenefitsMarketplaceApi = class BenefitsMarketplaceApi {
         const url = `${this.baseUrl}/remittance/onboarding/prefill`;
         return await this.httpRequest.post(url, request);
     }
+    async getBenefitSuite(benefitId) {
+        // La URL de SSM termina en "/": se normaliza para no armar "//benefits".
+        const url = `${this.baseUrl.replace(/\/+$/, "")}/benefits/${encodeURIComponent(benefitId)}/suite`;
+        return await this.httpRequest.get(url);
+    }
 };
 BenefitsMarketplaceApi = __decorate([
     injectable(),

package/bin/benefits-marketplace/api/interfaces/IBenefitsMarketplaceApi.d.ts

@@ -1,5 +1,5 @@
-import { BenefitPaymentRequest, BenefitPaymentResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { BenefitPaymentRequest, BenefitPaymentResponse, BenefitSuiteResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import { ApiGatewayResponse, StandardResponse } from "@fiado/gateway-adapter";
 import { RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { BenefitLeafDisplayResponse } from "../dtos/BenefitLeafDisplayResponse.js";
 import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
@@ -79,4 +79,11 @@ export interface IBenefitsMarketplaceApi {
      * para el reintento de registro desde el backoffice.
      */
     remittanceOnboardingPrefill(request: RemittanceOnboardingPrefillRequest): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>>;
+    /**
+     * Suite del beneficio: status, flow, tenant de FiadoLend/FiadoRetail, nombre e ícono (I1).
+     * Backend: GET /benefits/{benefitId}/suite (privado). No evalúa visibilidad.
+     * Errores: 404 BENEFIT_NOT_FOUND.
+     * @param benefitId id del beneficio en BenefitCatalog_GT
+     */
+    getBenefitSuite(benefitId: string): Promise<StandardResponse<BenefitSuiteResponse>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "./dtos/CreditLifecycleFact.js";
@@ -35,4 +35,14 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
     notifyLifecycleFact(creditId: string, input: CreditLifecycleFactRequest, tenantId: string): Promise<StandardResponse<CreditLifecycleFactResponse>>;
     listMessagingCandidates(input: ListMessagingCandidatesRequest, tenantId: string): Promise<StandardResponse<ListMessagingCandidatesResponse>>;
+    private customerCreditsUrl;
+    listCustomerCredits(directoryId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerCreditItem[]>>;
+    getCustomerCredit(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditDetail>>;
+    listCustomerCreditInstallments(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanInstallmentResponse[]>>;
+    listCustomerCreditPayments(directoryId: string, creditId: string, tenantId: string, page?: {
+        limit?: number;
+        nextToken?: string;
+    }): Promise<StandardResponse<LoanPaymentListResponse>>;
+    listCustomerCreditContracts(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanContractResponse[]>>;
+    getCustomerCreditContractUrl(directoryId: string, creditId: string, contractId: string, tenantId: string): Promise<StandardResponse<LoanContractDownloadUrl>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -86,6 +86,34 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/messaging/candidates?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    // ─── I1 · Lecturas de cliente (retail-loan-connector) ───────────────────────
+    customerCreditsUrl(directoryId, creditId) {
+        const base = `${this.baseUrl}/private/customers/${encodeURIComponent(directoryId)}/credits`;
+        return creditId === undefined ? base : `${base}/${encodeURIComponent(creditId)}`;
+    }
+    async listCustomerCredits(directoryId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId)}?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+    async getCustomerCredit(directoryId, creditId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+    async listCustomerCreditInstallments(directoryId, creditId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/installments?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+    async listCustomerCreditPayments(directoryId, creditId, tenantId, page) {
+        const query = new URLSearchParams({ tenantId });
+        if (page?.limit !== undefined)
+            query.set("limit", String(page.limit));
+        if (page?.nextToken)
+            query.set("nextToken", page.nextToken);
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/payments?${query.toString()}`);
+    }
+    async listCustomerCreditContracts(directoryId, creditId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/contracts?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+    async getCustomerCreditContractUrl(directoryId, creditId, contractId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`);
+    }
 };
 LoanCreditBusinessApi = __decorate([
     injectable(),

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "../dtos/CreditLifecycleFact.js";
@@ -116,4 +116,19 @@ export interface ILoanCreditBusinessApi {
      * recibió su aviso del día no vuelve a salir. `nextCursor` en `null` significa que ya no queda nadie.
      */
     listMessagingCandidates(input: ListMessagingCandidatesRequest, tenantId: string): Promise<StandardResponse<ListMessagingCandidatesResponse>>;
+    /** Créditos del cliente: los de todos sus acreditados en el tenant. `[]` si no tiene. */
+    listCustomerCredits(directoryId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerCreditItem[]>>;
+    /** Detalle de un crédito del cliente. */
+    getCustomerCredit(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditDetail>>;
+    /** Calendario de cuotas de un crédito del cliente, en orden. */
+    listCustomerCreditInstallments(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanInstallmentResponse[]>>;
+    /** Historial de pagos con desglose; `nextToken` opaco de la página anterior. 400 INVALID_NEXT_TOKEN. */
+    listCustomerCreditPayments(directoryId: string, creditId: string, tenantId: string, page?: {
+        limit?: number;
+        nextToken?: string;
+    }): Promise<StandardResponse<LoanPaymentListResponse>>;
+    /** Contratos de un crédito del cliente. */
+    listCustomerCreditContracts(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanContractResponse[]>>;
+    /** URL prefirmada del PDF de un contrato. 404 CONTRACT_NOT_FOUND · 409 CONTRACT_PDF_NOT_READY. */
+    getCustomerCreditContractUrl(directoryId: string, creditId: string, contractId: string, tenantId: string): Promise<StandardResponse<LoanContractDownloadUrl>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.88.0",
+  "version": "5.89.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.441.0",
+    "@fiado/type-kit": "^3.458.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

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

@@ -1,8 +1,8 @@
 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 type {IHttpRequest} from "@fiado/http-client";
+import {BenefitPaymentRequest, BenefitPaymentResponse, BenefitSuiteResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse, StandardResponse} from "@fiado/gateway-adapter";
 import {RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse} from "@fiado/type-kit/bin/remittance/index.js";
 import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse.js";
 import {
@@ -64,4 +64,10 @@ export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
         const url = `${this.baseUrl}/remittance/onboarding/prefill`;
         return await this.httpRequest.post(url, request);
     }
+
+    async getBenefitSuite(benefitId: string): Promise<StandardResponse<BenefitSuiteResponse>> {
+        // La URL de SSM termina en "/": se normaliza para no armar "//benefits".
+        const url = `${this.baseUrl.replace(/\/+$/, "")}/benefits/${encodeURIComponent(benefitId)}/suite`;
+        return await this.httpRequest.get(url);
+    }
 }

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

@@ -1,5 +1,5 @@
-import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
-import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {BenefitPaymentRequest, BenefitPaymentResponse, BenefitSuiteResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse, StandardResponse} from "@fiado/gateway-adapter";
 import {RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse} from "@fiado/type-kit/bin/remittance/index.js";
 import {BenefitLeafDisplayResponse} from "../dtos/BenefitLeafDisplayResponse.js";
 import {
@@ -101,4 +101,12 @@ export interface IBenefitsMarketplaceApi {
     remittanceOnboardingPrefill(
         request: RemittanceOnboardingPrefillRequest,
     ): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>>;
+
+    /**
+     * Suite del beneficio: status, flow, tenant de FiadoLend/FiadoRetail, nombre e ícono (I1).
+     * Backend: GET /benefits/{benefitId}/suite (privado). No evalúa visibilidad.
+     * Errores: 404 BENEFIT_NOT_FOUND.
+     * @param benefitId id del beneficio en BenefitCatalog_GT
+     */
+    getBenefitSuite(benefitId: string): Promise<StandardResponse<BenefitSuiteResponse>>;
 }

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -19,6 +19,12 @@ import {
     SignLoanCreditRequest,
     SignLoanCreditResponse,
     UpsertLoanBorrowerRequest,
+    LoanBorrowerCreditItem,
+    LoanContractDownloadUrl,
+    LoanContractResponse,
+    LoanCreditDetail,
+    LoanInstallmentResponse,
+    LoanPaymentListResponse,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     LoanCreditAnalyticsBatchRequest,
@@ -167,4 +173,69 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/messaging/candidates?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+
+    // ─── I1 · Lecturas de cliente (retail-loan-connector) ───────────────────────
+
+    private customerCreditsUrl(directoryId: string, creditId?: string): string {
+        const base = `${this.baseUrl}/private/customers/${encodeURIComponent(directoryId)}/credits`;
+        return creditId === undefined ? base : `${base}/${encodeURIComponent(creditId)}`;
+    }
+
+    async listCustomerCredits(
+        directoryId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerCreditItem[]>> {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId)}?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+
+    async getCustomerCredit(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditDetail>> {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+
+    async listCustomerCreditInstallments(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanInstallmentResponse[]>> {
+        return await this.httpRequest.get(
+            `${this.customerCreditsUrl(directoryId, creditId)}/installments?tenantId=${encodeURIComponent(tenantId)}`,
+        );
+    }
+
+    async listCustomerCreditPayments(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+        page?: { limit?: number; nextToken?: string },
+    ): Promise<StandardResponse<LoanPaymentListResponse>> {
+        const query = new URLSearchParams({ tenantId });
+        if (page?.limit !== undefined) query.set("limit", String(page.limit));
+        if (page?.nextToken) query.set("nextToken", page.nextToken);
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/payments?${query.toString()}`);
+    }
+
+    async listCustomerCreditContracts(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanContractResponse[]>> {
+        return await this.httpRequest.get(
+            `${this.customerCreditsUrl(directoryId, creditId)}/contracts?tenantId=${encodeURIComponent(tenantId)}`,
+        );
+    }
+
+    async getCustomerCreditContractUrl(
+        directoryId: string,
+        creditId: string,
+        contractId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanContractDownloadUrl>> {
+        return await this.httpRequest.get(
+            `${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`,
+        );
+    }
 }

package/src/loanCredit/api/interfaces/ILoanCreditBusinessApi.ts

@@ -17,6 +17,12 @@ import {
     SignLoanCreditRequest,
     SignLoanCreditResponse,
     UpsertLoanBorrowerRequest,
+    LoanBorrowerCreditItem,
+    LoanContractDownloadUrl,
+    LoanContractResponse,
+    LoanCreditDetail,
+    LoanInstallmentResponse,
+    LoanPaymentListResponse,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     LoanCreditAnalyticsBatchRequest,
@@ -202,4 +208,51 @@ export interface ILoanCreditBusinessApi {
         input: ListMessagingCandidatesRequest,
         tenantId: string,
     ): Promise<StandardResponse<ListMessagingCandidatesResponse>>;
+
+    // ─── I1 · Lecturas de cliente (retail-loan-connector) ───────────────────────
+    // `directoryId` siempre sale del token de la app; loan-credit aplica el control de dueño y
+    // responde 404 CREDIT_NOT_FOUND si el crédito no existe o no es del cliente.
+
+    /** Créditos del cliente: los de todos sus acreditados en el tenant. `[]` si no tiene. */
+    listCustomerCredits(
+        directoryId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerCreditItem[]>>;
+
+    /** Detalle de un crédito del cliente. */
+    getCustomerCredit(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditDetail>>;
+
+    /** Calendario de cuotas de un crédito del cliente, en orden. */
+    listCustomerCreditInstallments(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanInstallmentResponse[]>>;
+
+    /** Historial de pagos con desglose; `nextToken` opaco de la página anterior. 400 INVALID_NEXT_TOKEN. */
+    listCustomerCreditPayments(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+        page?: { limit?: number; nextToken?: string },
+    ): Promise<StandardResponse<LoanPaymentListResponse>>;
+
+    /** Contratos de un crédito del cliente. */
+    listCustomerCreditContracts(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanContractResponse[]>>;
+
+    /** URL prefirmada del PDF de un contrato. 404 CONTRACT_NOT_FOUND · 409 CONTRACT_PDF_NOT_READY. */
+    getCustomerCreditContractUrl(
+        directoryId: string,
+        creditId: string,
+        contractId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanContractDownloadUrl>>;
 }