@fiado/api-invoker 5.14.0 → 5.15.0

package/bin/container.config.js

@@ -48,6 +48,7 @@ import TransactionAlertApi from "./riskProfile/api/TransactionAlertApi.js";
 import { DirectoriesApi } from "./directories/index.js";
 import CognitoConnectorApi from "./cognitoConnector/CognitoConnectorApi.js";
 import { ZendeskApi } from "./zendesk/index.js";
+import ZendeskAlertsPublisher from "./zendesk/queue/ZendeskAlertsPublisher.js";
 import { BlackListApi } from "./blacklist/index.js";
 import { DeviceApi } from "./device/index.js";
 import { ObservationsApi } from "./observations/index.js";
@@ -182,6 +183,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("ICognitoConnectorApi").to(CognitoConnectorApi);
     bind("ICognitoV2Api").to(CognitoApi);
     bind("IZendeskApi").to(ZendeskApi);
+    bind("IZendeskAlertsPublisher").to(ZendeskAlertsPublisher);
     bind("IBlackListApi").to(BlackListApi);
     bind("IDeviceApi").to(DeviceApi);
     bind("IObservationsApi").to(ObservationsApi);

package/bin/zendesk/index.d.ts

@@ -1,2 +1,4 @@
 export * from './interfaces/IZendeskApi.js';
 export * from './ZendeskApi.js';
+export * from './queue/interfaces/IZendeskAlertsPublisher.js';
+export { default as ZendeskAlertsPublisher } from './queue/ZendeskAlertsPublisher.js';

package/bin/zendesk/index.js

@@ -1,2 +1,4 @@
 export * from './interfaces/IZendeskApi.js';
 export * from './ZendeskApi.js';
+export * from './queue/interfaces/IZendeskAlertsPublisher.js';
+export { default as ZendeskAlertsPublisher } from './queue/ZendeskAlertsPublisher.js';

package/bin/zendesk/queue/ZendeskAlertsPublisher.d.ts

@@ -0,0 +1,9 @@
+import { ZendeskInternalAlertRequest } from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+import { IZendeskAlertsPublisher } from "./interfaces/IZendeskAlertsPublisher.js";
+export default class ZendeskAlertsPublisher implements IZendeskAlertsPublisher {
+    private readonly ZENDESK_ALERTS_QUEUE;
+    createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void>;
+    sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void>;
+    private publish;
+}

package/bin/zendesk/queue/ZendeskAlertsPublisher.js

@@ -0,0 +1,37 @@
+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 { injectable } from "inversify";
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { ZendeskAlertKind } from "@fiado/type-kit/bin/helpdesk/index.js";
+let ZendeskAlertsPublisher = class ZendeskAlertsPublisher {
+    ZENDESK_ALERTS_QUEUE = process.env.ZENDESK_ALERTS_QUEUE;
+    async createInternalNote(alert) {
+        await this.publish({ kind: ZendeskAlertKind.INTERNAL_NOTE, payload: alert });
+    }
+    async sendProactiveMessage(message) {
+        await this.publish({ kind: ZendeskAlertKind.PROACTIVE_MESSAGE, payload: message });
+    }
+    async publish(message) {
+        try {
+            const client = new SQSClient();
+            const sendMessageRequest = {
+                QueueUrl: this.ZENDESK_ALERTS_QUEUE,
+                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 queue ${': ' + errorMessage}`);
+        }
+    }
+};
+ZendeskAlertsPublisher = __decorate([
+    injectable()
+], ZendeskAlertsPublisher);
+export default ZendeskAlertsPublisher;

package/bin/zendesk/queue/interfaces/IZendeskAlertsPublisher.d.ts

@@ -0,0 +1,15 @@
+import { ZendeskInternalAlertRequest } from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+/**
+ * Publica alertas hacia Zendesk sin pagar su latencia: el caller encola y sigue.
+ * Consume zendesk-business.
+ */
+export interface IZendeskAlertsPublisher {
+    /** Nota interna sobre un usuario. Solo la ven los agentes. */
+    createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void>;
+    /**
+     * Mensaje al chat del usuario. Si el usuario está esperando la respuesta ahora, conviene
+     * el endpoint síncrono `IZendeskApi.sendProactiveMessage`: acá el fallo no es inmediato.
+     */
+    sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void>;
+}

package/bin/zendesk/queue/interfaces/IZendeskAlertsPublisher.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.14.0",
+  "version": "5.15.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.258.0",
+    "@fiado/type-kit": "^3.260.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -75,6 +75,8 @@ import { DirectoriesApi, IDirectoriesApi } from "./directories/index.js";
 import { ICognitoConnectorApi, ICognitoV2Api } from "./cognitoConnector/index.js";
 import CognitoConnectorApi from "./cognitoConnector/CognitoConnectorApi.js";
 import { IZendeskApi, ZendeskApi } from "./zendesk/index.js";
+import ZendeskAlertsPublisher from "./zendesk/queue/ZendeskAlertsPublisher.js";
+import { IZendeskAlertsPublisher } from "./zendesk/queue/interfaces/IZendeskAlertsPublisher.js";
 import { BlackListApi, IBlackListApi } from "./blacklist/index.js";
 import { DeviceApi, IDeviceApi } from "./device/index.js";
 import { IObservationsApi, ObservationsApi } from "./observations/index.js";
@@ -247,6 +249,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<ICognitoConnectorApi>("ICognitoConnectorApi").to(CognitoConnectorApi);
     bind<ICognitoV2Api>("ICognitoV2Api").to(CognitoApi);
     bind<IZendeskApi>("IZendeskApi").to(ZendeskApi);
+    bind<IZendeskAlertsPublisher>("IZendeskAlertsPublisher").to(ZendeskAlertsPublisher);
     bind<IBlackListApi>("IBlackListApi").to(BlackListApi);
     bind<IDeviceApi>("IDeviceApi").to(DeviceApi);
     bind<IObservationsApi>("IObservationsApi").to(ObservationsApi);

package/src/zendesk/index.ts

@@ -1,3 +1,5 @@
 
 export * from './interfaces/IZendeskApi.js';
 export * from './ZendeskApi.js';
+export * from './queue/interfaces/IZendeskAlertsPublisher.js';
+export { default as ZendeskAlertsPublisher } from './queue/ZendeskAlertsPublisher.js';

package/src/zendesk/queue/ZendeskAlertsPublisher.ts

@@ -0,0 +1,38 @@
+import { injectable } from "inversify";
+import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
+import {
+    IZendeskAlertMessage,
+    ZendeskAlertKind,
+    ZendeskInternalAlertRequest
+} from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+import { IZendeskAlertsPublisher } from "./interfaces/IZendeskAlertsPublisher.js";
+
+@injectable()
+export default class ZendeskAlertsPublisher implements IZendeskAlertsPublisher {
+
+    private readonly ZENDESK_ALERTS_QUEUE = process.env.ZENDESK_ALERTS_QUEUE;
+
+    async createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void> {
+        await this.publish({ kind: ZendeskAlertKind.INTERNAL_NOTE, payload: alert });
+    }
+
+    async sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void> {
+        await this.publish({ kind: ZendeskAlertKind.PROACTIVE_MESSAGE, payload: message });
+    }
+
+    private async publish(message: IZendeskAlertMessage): Promise<void> {
+        try {
+            const client: SQSClient = new SQSClient();
+            const sendMessageRequest: SendMessageRequest = {
+                QueueUrl: this.ZENDESK_ALERTS_QUEUE,
+                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 queue ${': ' + errorMessage}`);
+        }
+    }
+}

package/src/zendesk/queue/interfaces/IZendeskAlertsPublisher.ts

@@ -0,0 +1,17 @@
+import { ZendeskInternalAlertRequest } from "@fiado/type-kit/bin/helpdesk/index.js";
+import { SendProactiveMessageRequest } from "@fiado/type-kit/bin/zendeskMessaging/index.js";
+
+/**
+ * Publica alertas hacia Zendesk sin pagar su latencia: el caller encola y sigue.
+ * Consume zendesk-business.
+ */
+export interface IZendeskAlertsPublisher {
+    /** Nota interna sobre un usuario. Solo la ven los agentes. */
+    createInternalNote(alert: ZendeskInternalAlertRequest): Promise<void>;
+
+    /**
+     * Mensaje al chat del usuario. Si el usuario está esperando la respuesta ahora, conviene
+     * el endpoint síncrono `IZendeskApi.sendProactiveMessage`: acá el fallo no es inmediato.
+     */
+    sendProactiveMessage(message: SendProactiveMessageRequest): Promise<void>;
+}