@fiado/api-invoker 5.151.0 → 5.153.0

package/README.md

@@ -266,6 +266,7 @@ Para comunicación asíncrona, la librería provee publishers que envían mensaj
 | `ITransactionPublisher` | Eventos de transacción | `TRANSACTION_QUEUE` |
 | `IActivityPublisher` | Eventos de actividad | `ACTIVITY_QUEUE` |
 | `ITransactionAlarmPublisher` | Alarmas de transacción | `TRANSACTION_ALARM_QUEUE` |
+| `IGsfSyncPublisher` | Alta del crédito y pagos hacia GSF (`GsfSyncQueue.fifo`) | `GSF_SYNC_QUEUE_URL` |
 | `IPublisher` | Publisher genérico | Configurable |
 
 ### Ejemplo de Publisher

package/bin/container.config.js

@@ -153,6 +153,8 @@ import { RewardsEligibilityPublisher, RewardsEligibilityBusinessApi } from "./re
 import { RulesApi } from "./rules-business/index.js";
 import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js";
 import DomainCallbackApi from "./domain-callback/api/DomainCallbackApi.js";
+// GSF connector — publisher de la cola FIFO de sincronización de créditos y pagos
+import { GsfSyncPublisher } from "./gsf-connector/index.js";
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
     bind("InvokerUtils").to(InvokerUtils);
@@ -329,4 +331,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("ICollectionEngineApi").to(CollectionEngineApi);
     // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)
     bind("IDomainCallbackApi").to(DomainCallbackApi);
+    // GSF connector — alta del crédito y pagos hacia GsfSyncQueue.fifo.
+    // El productor necesita GSF_SYNC_QUEUE_URL y sqs:SendMessage sobre la cola.
+    bind("IGsfSyncPublisher").to(GsfSyncPublisher);
 });

package/bin/gsf-connector/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./queue/interfaces/IGsfSyncPublisher.js";
+export * from "./queue/GsfSyncPublisher.js";

package/bin/gsf-connector/index.js

@@ -0,0 +1,2 @@
+export * from "./queue/interfaces/IGsfSyncPublisher.js";
+export * from "./queue/GsfSyncPublisher.js";

package/bin/gsf-connector/queue/GsfSyncPublisher.d.ts

@@ -0,0 +1,6 @@
+import type { GsfCreateCreditMessage, GsfPaymentMessage } from "@fiado/type-kit/bin/gsfConnector/index.js";
+import { IGsfSyncPublisher } from "./interfaces/IGsfSyncPublisher.js";
+export declare class GsfSyncPublisher implements IGsfSyncPublisher {
+    private readonly GSF_SYNC_QUEUE_URL;
+    publish(message: GsfCreateCreditMessage | GsfPaymentMessage): Promise<void>;
+}

package/bin/gsf-connector/queue/GsfSyncPublisher.js

@@ -0,0 +1,36 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+let GsfSyncPublisher = class GsfSyncPublisher {
+    GSF_SYNC_QUEUE_URL = process.env.GSF_SYNC_QUEUE_URL;
+    async publish(message) {
+        if (!this.GSF_SYNC_QUEUE_URL) {
+            throw new Error("Error publishing message to GsfSyncQueue.fifo: GSF_SYNC_QUEUE_URL no está configurada");
+        }
+        try {
+            const client = new SQSClient();
+            // FIFO: un grupo por crédito para que los pagos lleguen después de su alta.
+            const sendMessageRequest = {
+                QueueUrl: this.GSF_SYNC_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+                MessageGroupId: message.externalCreditId,
+                MessageDeduplicationId: message.messageId,
+            };
+            await client.send(new SendMessageCommand(sendMessageRequest));
+        }
+        catch (error) {
+            // El cuerpo lleva datos personales: el error solo nombra la cola y el motivo.
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to GsfSyncQueue.fifo: ${errorMessage}`);
+        }
+    }
+};
+GsfSyncPublisher = __decorate([
+    injectable()
+], GsfSyncPublisher);
+export { GsfSyncPublisher };

package/bin/gsf-connector/queue/interfaces/IGsfSyncPublisher.d.ts

@@ -0,0 +1,9 @@
+import type { GsfCreateCreditMessage, GsfPaymentMessage } from "@fiado/type-kit/bin/gsfConnector/index.js";
+/**
+ * Publisher hacia `GsfSyncQueue.fifo`, que consume `gsf-connector`: alta del crédito y sus pagos.
+ * El productor necesita la env var `GSF_SYNC_QUEUE_URL` (export `GsfSyncQueueUrl`) y `sqs:SendMessage`
+ * sobre la cola (export `GsfSyncQueueArn`).
+ */
+export interface IGsfSyncPublisher {
+    publish(message: GsfCreateCreditMessage | GsfPaymentMessage): Promise<void>;
+}

package/bin/gsf-connector/queue/interfaces/IGsfSyncPublisher.js

@@ -0,0 +1 @@
+export {};

package/bin/index.d.ts

@@ -132,3 +132,4 @@ export * from "./motosafeConnector/index.js";
 export * from "./rewards-business/index.js";
 export * from "./rewards-eligibility-business/index.js";
 export * from "./rules-business/index.js";
+export * from "./gsf-connector/index.js";

package/bin/index.js

@@ -132,3 +132,4 @@ export * from "./motosafeConnector/index.js";
 export * from "./rewards-business/index.js";
 export * from "./rewards-eligibility-business/index.js";
 export * from "./rules-business/index.js";
+export * from "./gsf-connector/index.js";

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, CancelLoanCreditRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, PreviewLoanContractRequest, LoanContractPreview, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CancelLoanCreditRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, PreviewLoanContractRequest, LoanContractPreview, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, ContractTypeEnum, LoanCustomerCreditDocument, LoanCustomerCreditDocumentUrl, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "./dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import type { GetCreditOptions } from "./dtos/GetCreditOptions.js";
@@ -51,6 +51,8 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     }): 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>>;
+    listCustomerCreditDocuments(directoryId: string, creditId: string, type: ContractTypeEnum, tenantId: string): Promise<StandardResponse<LoanCustomerCreditDocument[]>>;
+    getCustomerCreditDocumentUrl(directoryId: string, creditId: string, documentType: ContractTypeEnum, documentKey: string, tenantId: string): Promise<StandardResponse<LoanCustomerCreditDocumentUrl>>;
     getCustomerPaymentOptions(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
     createCustomerPayment(directoryId: string, creditId: string, tenantId: string, body: CreateCustomerPaymentRequest): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -136,6 +136,13 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
     async getCustomerCreditContractUrl(directoryId, creditId, contractId, tenantId) {
         return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`);
     }
+    async listCustomerCreditDocuments(directoryId, creditId, type, tenantId) {
+        const query = new URLSearchParams({ tenantId, type });
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/documents?${query.toString()}`);
+    }
+    async getCustomerCreditDocumentUrl(directoryId, creditId, documentType, documentKey, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/documents/${encodeURIComponent(documentType)}/${encodeURIComponent(documentKey)}/url?tenantId=${encodeURIComponent(tenantId)}`);
+    }
     // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
     async getCustomerPaymentOptions(directoryId, creditId, tenantId) {
         return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/payment-options?tenantId=${encodeURIComponent(tenantId)}`);

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, CancelLoanCreditRequest, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, PreviewLoanContractRequest, LoanContractPreview, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, CancelLoanCreditRequest, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, PreviewLoanContractRequest, LoanContractPreview, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, ContractTypeEnum, LoanCustomerCreditDocument, LoanCustomerCreditDocumentUrl, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "../dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import type { GetCreditOptions } from "../dtos/GetCreditOptions.js";
@@ -156,6 +156,10 @@ export interface ILoanCreditBusinessApi {
     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>>;
+    /** Documentos de un tipo del ciclo de vida del crédito (comprobantes, estados de cuenta), el más reciente primero. */
+    listCustomerCreditDocuments(directoryId: string, creditId: string, type: ContractTypeEnum, tenantId: string): Promise<StandardResponse<LoanCustomerCreditDocument[]>>;
+    /** URL prefirmada del PDF de un documento del ciclo de vida. 404 CREDIT_DOCUMENT_NOT_FOUND si no existe o no tiene PDF. */
+    getCustomerCreditDocumentUrl(directoryId: string, creditId: string, documentType: ContractTypeEnum, documentKey: string, tenantId: string): Promise<StandardResponse<LoanCustomerCreditDocumentUrl>>;
     /** Opciones de pago de un crédito del cliente, con montos ya calculados. */
     getCustomerPaymentOptions(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.151.0",
+  "version": "5.153.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.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.594.0",
+    "@fiado/type-kit": "^3.612.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -226,6 +226,8 @@ import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js"
 // consumidor el resultado de un cobro (applyCollectionResult); baseUrl viaja por llamada
 import { IDomainCallbackApi } from "./domain-callback/index.js";
 import DomainCallbackApi from "./domain-callback/api/DomainCallbackApi.js";
+// GSF connector — publisher de la cola FIFO de sincronización de créditos y pagos
+import { IGsfSyncPublisher, GsfSyncPublisher } from "./gsf-connector/index.js";
 
 export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // UTILS bindings
@@ -432,4 +434,8 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
 
     // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)
     bind<IDomainCallbackApi>("IDomainCallbackApi").to(DomainCallbackApi);
+
+    // GSF connector — alta del crédito y pagos hacia GsfSyncQueue.fifo.
+    // El productor necesita GSF_SYNC_QUEUE_URL y sqs:SendMessage sobre la cola.
+    bind<IGsfSyncPublisher>("IGsfSyncPublisher").to(GsfSyncPublisher);
 });

package/src/gsf-connector/index.ts

@@ -0,0 +1,2 @@
+export * from "./queue/interfaces/IGsfSyncPublisher.js";
+export * from "./queue/GsfSyncPublisher.js";

package/src/gsf-connector/queue/GsfSyncPublisher.ts

@@ -0,0 +1,30 @@
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+import type { GsfCreateCreditMessage, GsfPaymentMessage } from "@fiado/type-kit/bin/gsfConnector/index.js";
+import { IGsfSyncPublisher } from "./interfaces/IGsfSyncPublisher.js";
+
+@injectable()
+export class GsfSyncPublisher implements IGsfSyncPublisher {
+    private readonly GSF_SYNC_QUEUE_URL = process.env.GSF_SYNC_QUEUE_URL;
+
+    async publish(message: GsfCreateCreditMessage | GsfPaymentMessage): Promise<void> {
+        if (!this.GSF_SYNC_QUEUE_URL) {
+            throw new Error("Error publishing message to GsfSyncQueue.fifo: GSF_SYNC_QUEUE_URL no está configurada");
+        }
+        try {
+            const client: SQSClient = new SQSClient();
+            // FIFO: un grupo por crédito para que los pagos lleguen después de su alta.
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.GSF_SYNC_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+                MessageGroupId: message.externalCreditId,
+                MessageDeduplicationId: message.messageId,
+            };
+            await client.send(new SendMessageCommand(sendMessageRequest));
+        } catch (error) {
+            // El cuerpo lleva datos personales: el error solo nombra la cola y el motivo.
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to GsfSyncQueue.fifo: ${errorMessage}`);
+        }
+    }
+}

package/src/gsf-connector/queue/interfaces/IGsfSyncPublisher.ts

@@ -0,0 +1,10 @@
+import type { GsfCreateCreditMessage, GsfPaymentMessage } from "@fiado/type-kit/bin/gsfConnector/index.js";
+
+/**
+ * Publisher hacia `GsfSyncQueue.fifo`, que consume `gsf-connector`: alta del crédito y sus pagos.
+ * El productor necesita la env var `GSF_SYNC_QUEUE_URL` (export `GsfSyncQueueUrl`) y `sqs:SendMessage`
+ * sobre la cola (export `GsfSyncQueueArn`).
+ */
+export interface IGsfSyncPublisher {
+    publish(message: GsfCreateCreditMessage | GsfPaymentMessage): Promise<void>;
+}

package/src/index.ts

@@ -132,3 +132,4 @@ export * from "./motosafeConnector/index.js";
 export * from "./rewards-business/index.js";
 export * from "./rewards-eligibility-business/index.js";
 export * from "./rules-business/index.js";
+export * from "./gsf-connector/index.js";

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -26,6 +26,9 @@ import {
     LoanBorrowerCreditItem,
     LoanContractDownloadUrl,
     LoanContractResponse,
+    ContractTypeEnum,
+    LoanCustomerCreditDocument,
+    LoanCustomerCreditDocumentUrl,
     LoanCreditDetail,
     LoanInstallmentResponse,
     LoanPaymentListResponse,
@@ -294,6 +297,28 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         );
     }
 
+    async listCustomerCreditDocuments(
+        directoryId: string,
+        creditId: string,
+        type: ContractTypeEnum,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerCreditDocument[]>> {
+        const query = new URLSearchParams({ tenantId, type });
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/documents?${query.toString()}`);
+    }
+
+    async getCustomerCreditDocumentUrl(
+        directoryId: string,
+        creditId: string,
+        documentType: ContractTypeEnum,
+        documentKey: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerCreditDocumentUrl>> {
+        return await this.httpRequest.get(
+            `${this.customerCreditsUrl(directoryId, creditId)}/documents/${encodeURIComponent(documentType)}/${encodeURIComponent(documentKey)}/url?tenantId=${encodeURIComponent(tenantId)}`,
+        );
+    }
+
     // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
 
     async getCustomerPaymentOptions(

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

@@ -24,6 +24,9 @@ import {
     LoanBorrowerCreditItem,
     LoanContractDownloadUrl,
     LoanContractResponse,
+    ContractTypeEnum,
+    LoanCustomerCreditDocument,
+    LoanCustomerCreditDocumentUrl,
     LoanCreditDetail,
     LoanInstallmentResponse,
     LoanPaymentListResponse,
@@ -311,6 +314,23 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<LoanContractDownloadUrl>>;
 
+    /** Documentos de un tipo del ciclo de vida del crédito (comprobantes, estados de cuenta), el más reciente primero. */
+    listCustomerCreditDocuments(
+        directoryId: string,
+        creditId: string,
+        type: ContractTypeEnum,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerCreditDocument[]>>;
+
+    /** URL prefirmada del PDF de un documento del ciclo de vida. 404 CREDIT_DOCUMENT_NOT_FOUND si no existe o no tiene PDF. */
+    getCustomerCreditDocumentUrl(
+        directoryId: string,
+        creditId: string,
+        documentType: ContractTypeEnum,
+        documentKey: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerCreditDocumentUrl>>;
+
     // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
 
     /** Opciones de pago de un crédito del cliente, con montos ya calculados. */