@fiado/api-invoker 5.13.1 → 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/platformRbac/api/PlatformRbacBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { ApiGatewayResponse, ResolvedPermissions, ResolveInput } from "@fiado/gateway-adapter";
-import { DefineNextChallengeRequest, DefineNextChallengeResponse, PrepareChallengeRequest, PrepareChallengeResponse, VerifyChallengeRequest, VerifyChallengeResponse, AuthorizeRequest, AuthorizeResponse, EffectivePermissionsResponse, InjectableUserAttributesResponse, PermissionScope, CreateLevelEntityRequest, CreateLevelEntityResponse, CreateTenantUserRequest, CreateTenantUserResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
+import { DefineNextChallengeRequest, DefineNextChallengeResponse, PrepareChallengeRequest, PrepareChallengeResponse, VerifyChallengeRequest, VerifyChallengeResponse, AuthorizeRequest, AuthorizeResponse, EffectivePermissionsResponse, InjectableUserAttributesResponse, PermissionScope, CreateLevelEntityRequest, CreateLevelEntityResponse, CreateTenantUserRequest, CreateTenantUserResponse, UserProfileResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
 import { IPlatformRbacBusinessApi } from "./interfaces/IPlatformRbacBusinessApi.js";
 /**
  * Publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
@@ -28,4 +28,5 @@ export default class PlatformRbacBusinessApi implements IPlatformRbacBusinessApi
     resolvePermissions(input: ResolveInput): Promise<ApiGatewayResponse<ResolvedPermissions>>;
     createLevelEntity(tenantId: string, level: PermissionScope, input: CreateLevelEntityRequest): Promise<ApiGatewayResponse<CreateLevelEntityResponse>>;
     createTenantUser(tenantId: string, input: CreateTenantUserRequest): Promise<ApiGatewayResponse<CreateTenantUserResponse>>;
+    getUserProfile(cognitoSub: string, tenantId: string): Promise<ApiGatewayResponse<UserProfileResponse>>;
 }

package/bin/platformRbac/api/PlatformRbacBusinessApi.js

@@ -76,6 +76,10 @@ let PlatformRbacBusinessApi = class PlatformRbacBusinessApi {
         const url = `${this.baseUrl}/internal/tenants/${encodeURIComponent(tenantId)}/users`;
         return await this.httpRequest.post(url, input);
     }
+    async getUserProfile(cognitoSub, tenantId) {
+        const url = `${this.baseUrl}/internal/users/${encodeURIComponent(cognitoSub)}/profile?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
 };
 PlatformRbacBusinessApi = __decorate([
     injectable(),

package/bin/platformRbac/api/interfaces/IPlatformRbacBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { ApiGatewayResponse, ResolvedPermissions, ResolveInput } from "@fiado/gateway-adapter";
-import { DefineNextChallengeRequest, DefineNextChallengeResponse, PrepareChallengeRequest, PrepareChallengeResponse, VerifyChallengeRequest, VerifyChallengeResponse, AuthorizeRequest, AuthorizeResponse, EffectivePermissionsResponse, InjectableUserAttributesResponse, PermissionScope, CreateLevelEntityRequest, CreateLevelEntityResponse, CreateTenantUserRequest, CreateTenantUserResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
+import { DefineNextChallengeRequest, DefineNextChallengeResponse, PrepareChallengeRequest, PrepareChallengeResponse, VerifyChallengeRequest, VerifyChallengeResponse, AuthorizeRequest, AuthorizeResponse, EffectivePermissionsResponse, InjectableUserAttributesResponse, PermissionScope, CreateLevelEntityRequest, CreateLevelEntityResponse, CreateTenantUserRequest, CreateTenantUserResponse, UserProfileResponse } from "@fiado/type-kit/bin/platformRbac/index.js";
 /**
  * Contrato del publisher HTTP del lambda `platform-rbac-business` (componente 06 SureKeep Fase 0)
  * para los 3 endpoints internos del Custom Auth Challenge flow (MFA).
@@ -75,4 +75,6 @@ export interface IPlatformRbacBusinessApi {
      * queda INVITED (mitiga orphan) y retail-org guarda el `cognitoSub` retornado. Idempotente por identidad Cognito.
      */
     createTenantUser(tenantId: string, input: CreateTenantUserRequest): Promise<ApiGatewayResponse<CreateTenantUserResponse>>;
+    /** GET /internal/users/{cognitoSub}/profile?tenantId= — perfil básico del SharedUser (displayName, email, phone, status). */
+    getUserProfile(cognitoSub: string, tenantId: string): Promise<ApiGatewayResponse<UserProfileResponse>>;
 }

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.13.1",
+  "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.253.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/platformRbac/api/PlatformRbacBusinessApi.ts

@@ -18,6 +18,7 @@ import {
     CreateLevelEntityResponse,
     CreateTenantUserRequest,
     CreateTenantUserResponse,
+    UserProfileResponse,
 } from "@fiado/type-kit/bin/platformRbac/index.js";
 import { IPlatformRbacBusinessApi } from "./interfaces/IPlatformRbacBusinessApi.js";
 
@@ -117,4 +118,12 @@ export default class PlatformRbacBusinessApi implements IPlatformRbacBusinessApi
         const url = `${this.baseUrl}/internal/tenants/${encodeURIComponent(tenantId)}/users`;
         return await this.httpRequest.post(url, input);
     }
+
+    async getUserProfile(
+        cognitoSub: string,
+        tenantId: string,
+    ): Promise<ApiGatewayResponse<UserProfileResponse>> {
+        const url = `${this.baseUrl}/internal/users/${encodeURIComponent(cognitoSub)}/profile?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
 }

package/src/platformRbac/api/interfaces/IPlatformRbacBusinessApi.ts

@@ -15,6 +15,7 @@ import {
     CreateLevelEntityResponse,
     CreateTenantUserRequest,
     CreateTenantUserResponse,
+    UserProfileResponse,
 } from "@fiado/type-kit/bin/platformRbac/index.js";
 
 /**
@@ -121,4 +122,10 @@ export interface IPlatformRbacBusinessApi {
         tenantId: string,
         input: CreateTenantUserRequest,
     ): Promise<ApiGatewayResponse<CreateTenantUserResponse>>;
+
+    /** GET /internal/users/{cognitoSub}/profile?tenantId= — perfil básico del SharedUser (displayName, email, phone, status). */
+    getUserProfile(
+        cognitoSub: string,
+        tenantId: string,
+    ): Promise<ApiGatewayResponse<UserProfileResponse>>;
 }

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>;
+}