@fiado/api-invoker 4.79.0 → 5.1.0

package/bin/credit-engine/CreditEngineApi.js

@@ -29,11 +29,18 @@ let CreditEngineApi = class CreditEngineApi {
     }
     async getCreditProfile(directoryId, partnerId) {
         const url = `${this.baseUrl}credit/profile/${directoryId}`;
-        return await this.httpRequest.get(url, { partnerId }, { operationName: "getCreditProfile" });
+        // El endpoint devuelve el envelope de `ApiResponse.createResponse`
+        // (`@fiado/gateway-adapter`): { code, date, data, description, msg }.
+        // Desenvolvemos acá para que el consumer reciba el objeto de dominio
+        // directo — ver docs/TECH_DEBT.md TD-002 en benefits-marketplace-business.
+        const envelope = await this.httpRequest.get(url, { partnerId }, { operationName: "getCreditProfile" });
+        return envelope.data;
     }
     async getActiveCredit(directoryId) {
         const url = `${this.baseUrl}credit/active/${directoryId}`;
-        return await this.httpRequest.get(url, undefined, { operationName: "getActiveCredit" });
+        // Mismo envelope que getCreditProfile — desenvolvemos `.data` acá.
+        const envelope = await this.httpRequest.get(url, undefined, { operationName: "getActiveCredit" });
+        return envelope.data;
     }
     async enrichDirectories(directoryIds) {
         const url = `${this.baseUrl}credit/private/enrich-directories`;

package/bin/credit-engine/interfaces/ICreditEngineApi.d.ts

@@ -18,6 +18,12 @@ export interface ICreditEngineApi {
      * Obtiene el perfil financiero del directorio para un partner específico.
      * Endpoint: `GET /credit/profile/{directoryId}?partnerId={partnerId}`
      *
+     * El envelope HTTP (`{code, date, data, description, msg}` de
+     * `ApiResponse.createResponse`) se desenvuelve internamente — este método
+     * devuelve el objeto de dominio directo, el consumer NUNCA debe leer
+     * `.data` manualmente (ver docs/TECH_DEBT.md TD-002 en
+     * benefits-marketplace-business, resuelto en la raíz por este cambio).
+     *
      * @param directoryId ID del directorio del usuario.
      * @param partnerId   ID del partner (tenant) del perfil a consultar.
      */
@@ -26,6 +32,9 @@ export interface ICreditEngineApi {
      * Obtiene el crédito activo del cliente, si existe.
      * Endpoint: `GET /credit/active/{directoryId}`
      *
+     * El envelope HTTP se desenvuelve internamente (mismo criterio que
+     * `getCreditProfile`) — el consumer recibe el objeto de dominio directo.
+     *
      * @param directoryId ID del directorio del usuario.
      * @returns Detalle del crédito activo, o `null` si no hay crédito activo.
      */

package/bin/kyc/index.d.ts

@@ -1,2 +1,4 @@
 export * from './api/interfaces/IKycVerificationsBusinessApi.js';
 export * from './api/KycVerificationsBusinessApi.js';
+export * from './queue/interfaces/IRetailKycInboundPublisher.js';
+export * from './queue/RetailKycInboundPublisher.js';

package/bin/kyc/index.js

@@ -1,2 +1,4 @@
 export * from './api/interfaces/IKycVerificationsBusinessApi.js';
 export * from './api/KycVerificationsBusinessApi.js';
+export * from './queue/interfaces/IRetailKycInboundPublisher.js';
+export * from './queue/RetailKycInboundPublisher.js';

package/bin/kyc/queue/RetailKycInboundPublisher.d.ts

@@ -0,0 +1,6 @@
+import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { IRetailKycInboundPublisher } from "./interfaces/IRetailKycInboundPublisher.js";
+export declare class RetailKycInboundPublisher implements IRetailKycInboundPublisher {
+    private readonly RETAIL_KYC_INBOUND_QUEUE_URL;
+    publish(message: KycVerificationChangedV1): Promise<void>;
+}

package/bin/kyc/queue/RetailKycInboundPublisher.js

@@ -0,0 +1,32 @@
+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 RetailKycInboundPublisher = class RetailKycInboundPublisher {
+    RETAIL_KYC_INBOUND_QUEUE_URL = process.env.RETAIL_KYC_INBOUND_QUEUE_URL;
+    async publish(message) {
+        try {
+            const client = new SQSClient();
+            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId. La deduplicación
+            // la hace el consumidor con la llave de negocio (directoryId + verificationId + status + result).
+            const sendMessageRequest = {
+                QueueUrl: this.RETAIL_KYC_INBOUND_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            };
+            const command = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to RetailKycInboundQueue: ${errorMessage}`);
+        }
+    }
+};
+RetailKycInboundPublisher = __decorate([
+    injectable()
+], RetailKycInboundPublisher);
+export { RetailKycInboundPublisher };

package/bin/kyc/queue/interfaces/IRetailKycInboundPublisher.d.ts

@@ -0,0 +1,12 @@
+import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+/**
+ * Publisher del resultado del KYC hacia `RetailKycInboundQueue`, que consume
+ * `retail-wizard-business` (SureKeep F2).
+ *
+ * Lo produce `kyc-metamap-webhook` cuando una verificación pasa a COMPLETED. Vive acá —y no como
+ * SDK crudo en el webhook— porque la cola es COMPARTIDA cross-lambda: el estándar Fiado publica a una
+ * cola compartida vía Publisher de `@fiado/api-invoker` (mismo patrón que `ITransactionPublisher`).
+ */
+export interface IRetailKycInboundPublisher {
+    publish(message: KycVerificationChangedV1): Promise<void>;
+}

package/bin/kyc/queue/interfaces/IRetailKycInboundPublisher.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "4.79.0",
+  "version": "5.1.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.204.0",
+    "@fiado/type-kit": "^3.210.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/credit-engine/CreditEngineApi.ts

@@ -4,6 +4,7 @@ import { IHttpRequest } from "@fiado/http-client";
 import { ICreditEngineApi } from "./interfaces/ICreditEngineApi.js";
 import { CreditProfileResponse } from "@fiado/type-kit/bin/credit/dtos/internal/CreditProfileResponse.js";
 import { CreditDetailResponse } from "@fiado/type-kit/bin/creditEngine/index.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 dotenv.config();
 
 /**
@@ -24,20 +25,27 @@ export class CreditEngineApi implements ICreditEngineApi {
 
     public async getCreditProfile(directoryId: string, partnerId: string): Promise<CreditProfileResponse> {
         const url = `${this.baseUrl}credit/profile/${directoryId}`;
-        return await this.httpRequest.get(
+        // El endpoint devuelve el envelope de `ApiResponse.createResponse`
+        // (`@fiado/gateway-adapter`): { code, date, data, description, msg }.
+        // Desenvolvemos acá para que el consumer reciba el objeto de dominio
+        // directo — ver docs/TECH_DEBT.md TD-002 en benefits-marketplace-business.
+        const envelope = await this.httpRequest.get<FiadoApiResponse<CreditProfileResponse>>(
             url,
             { partnerId },
             { operationName: "getCreditProfile" },
         );
+        return envelope.data;
     }
 
     public async getActiveCredit(directoryId: string): Promise<CreditDetailResponse | null> {
         const url = `${this.baseUrl}credit/active/${directoryId}`;
-        return await this.httpRequest.get(
+        // Mismo envelope que getCreditProfile — desenvolvemos `.data` acá.
+        const envelope = await this.httpRequest.get<FiadoApiResponse<CreditDetailResponse | null>>(
             url,
             undefined,
             { operationName: "getActiveCredit" },
         );
+        return envelope.data;
     }
 
     public async enrichDirectories(directoryIds: string[]): Promise<any> {

package/src/credit-engine/interfaces/ICreditEngineApi.ts

@@ -18,6 +18,12 @@ export interface ICreditEngineApi {
      * Obtiene el perfil financiero del directorio para un partner específico.
      * Endpoint: `GET /credit/profile/{directoryId}?partnerId={partnerId}`
      *
+     * El envelope HTTP (`{code, date, data, description, msg}` de
+     * `ApiResponse.createResponse`) se desenvuelve internamente — este método
+     * devuelve el objeto de dominio directo, el consumer NUNCA debe leer
+     * `.data` manualmente (ver docs/TECH_DEBT.md TD-002 en
+     * benefits-marketplace-business, resuelto en la raíz por este cambio).
+     *
      * @param directoryId ID del directorio del usuario.
      * @param partnerId   ID del partner (tenant) del perfil a consultar.
      */
@@ -27,6 +33,9 @@ export interface ICreditEngineApi {
      * Obtiene el crédito activo del cliente, si existe.
      * Endpoint: `GET /credit/active/{directoryId}`
      *
+     * El envelope HTTP se desenvuelve internamente (mismo criterio que
+     * `getCreditProfile`) — el consumer recibe el objeto de dominio directo.
+     *
      * @param directoryId ID del directorio del usuario.
      * @returns Detalle del crédito activo, o `null` si no hay crédito activo.
      */

package/src/kyc/index.ts

@@ -1,2 +1,4 @@
 export * from './api/interfaces/IKycVerificationsBusinessApi.js';
 export * from './api/KycVerificationsBusinessApi.js';
+export * from './queue/interfaces/IRetailKycInboundPublisher.js';
+export * from './queue/RetailKycInboundPublisher.js';

package/src/kyc/queue/RetailKycInboundPublisher.ts

@@ -0,0 +1,26 @@
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { IRetailKycInboundPublisher } from "./interfaces/IRetailKycInboundPublisher.js";
+
+@injectable()
+export class RetailKycInboundPublisher implements IRetailKycInboundPublisher {
+    private readonly RETAIL_KYC_INBOUND_QUEUE_URL = process.env.RETAIL_KYC_INBOUND_QUEUE_URL;
+
+    async publish(message: KycVerificationChangedV1): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId. La deduplicación
+            // la hace el consumidor con la llave de negocio (directoryId + verificationId + status + result).
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.RETAIL_KYC_INBOUND_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            };
+            const command: SendMessageCommand = new SendMessageCommand(sendMessageRequest);
+            await client.send(command);
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error publishing message to RetailKycInboundQueue: ${errorMessage}`);
+        }
+    }
+}

package/src/kyc/queue/interfaces/IRetailKycInboundPublisher.ts

@@ -0,0 +1,13 @@
+import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+
+/**
+ * Publisher del resultado del KYC hacia `RetailKycInboundQueue`, que consume
+ * `retail-wizard-business` (SureKeep F2).
+ *
+ * Lo produce `kyc-metamap-webhook` cuando una verificación pasa a COMPLETED. Vive acá —y no como
+ * SDK crudo en el webhook— porque la cola es COMPARTIDA cross-lambda: el estándar Fiado publica a una
+ * cola compartida vía Publisher de `@fiado/api-invoker` (mismo patrón que `ITransactionPublisher`).
+ */
+export interface IRetailKycInboundPublisher {
+    publish(message: KycVerificationChangedV1): Promise<void>;
+}