@fiado/api-invoker 5.103.0 → 5.104.0

package/bin/container.config.js

@@ -67,6 +67,7 @@ import { DirectorySettingApi } from "./directorySetting/index.js";
 import { FirebaseConnectorApi } from "./firebase-connector/index.js";
 import OnboardingApi from "./onboarding/api/OnboardingApi.js";
 import OnboardingBusinessApi from "./onboarding-business/api/OnboardingBusinessApi.js";
+import { ExpedienteUpdatedPublisher } from "./onboarding-business/index.js";
 import { PayrollApi } from "./payroll-business/index.js";
 import { ReferralBusinessApi } from "./referral-business/index.js";
 import { EventHistoryApi } from "./event-history-business/index.js";
@@ -198,6 +199,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("ICognitoV2Api").to(CognitoApi);
     bind("IZendeskApi").to(ZendeskApi);
     bind("IZendeskAlertsPublisher").to(ZendeskAlertsPublisher);
+    bind("IExpedienteUpdatedPublisher").to(ExpedienteUpdatedPublisher);
     bind("IBlackListApi").to(BlackListApi);
     bind("IDeviceApi").to(DeviceApi);
     bind("IObservationsApi").to(ObservationsApi);

package/bin/onboarding-business/index.d.ts

@@ -1,2 +1,4 @@
 export * from './api/OnboardingBusinessApi.js';
 export * from './api/interfaces/IOnboardingBusinessApi.js';
+export * from './queue/interfaces/IExpedienteUpdatedPublisher.js';
+export * from './queue/ExpedienteUpdatedPublisher.js';

package/bin/onboarding-business/index.js

@@ -1,2 +1,4 @@
 export * from './api/OnboardingBusinessApi.js';
 export * from './api/interfaces/IOnboardingBusinessApi.js';
+export * from './queue/interfaces/IExpedienteUpdatedPublisher.js';
+export * from './queue/ExpedienteUpdatedPublisher.js';

package/bin/onboarding-business/queue/ExpedienteUpdatedPublisher.d.ts

@@ -0,0 +1,10 @@
+import type { ExpedienteUpdatedSourceEnum } from "@fiado/type-kit/bin/onboarding/index.js";
+import type { IExpedienteUpdatedPublisher } from "./interfaces/IExpedienteUpdatedPublisher.js";
+/**
+ * Marcador fijo del log de fallo: la alarma de CloudWatch del productor filtra por este texto
+ * (mismo marcador que usa fiado-identity-lambda, TD-025 de onboarding-business).
+ */
+export declare const EXPEDIENTE_PUBLISH_FAILED = "EXPEDIENTE_UPDATED publish failed";
+export declare class ExpedienteUpdatedPublisher implements IExpedienteUpdatedPublisher {
+    publish(directoryId: string, peopleId: string, source: ExpedienteUpdatedSourceEnum): Promise<void>;
+}

package/bin/onboarding-business/queue/ExpedienteUpdatedPublisher.js

@@ -0,0 +1,43 @@
+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 { randomUUID } from "node:crypto";
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+import { log } from "@fiado/logger";
+/**
+ * Marcador fijo del log de fallo: la alarma de CloudWatch del productor filtra por este texto
+ * (mismo marcador que usa fiado-identity-lambda, TD-025 de onboarding-business).
+ */
+export const EXPEDIENTE_PUBLISH_FAILED = "EXPEDIENTE_UPDATED publish failed";
+let ExpedienteUpdatedPublisher = class ExpedienteUpdatedPublisher {
+    async publish(directoryId, peopleId, source) {
+        try {
+            // Mensaje anémico a propósito: el consumidor SIEMPRE lee el expediente fresco.
+            const message = {
+                eventType: "EXPEDIENTE_UPDATED",
+                eventId: randomUUID(),
+                directoryId,
+                peopleId,
+                source,
+                occurredAt: new Date().toISOString(),
+            };
+            // Cola estándar: sin MessageGroupId. El evaluador del consumidor es idempotente.
+            await new SQSClient().send(new SendMessageCommand({
+                QueueUrl: process.env.ONBOARDING_READINESS_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            }));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            log.error(`${EXPEDIENTE_PUBLISH_FAILED}: ${errorMessage}`, { directoryId, peopleId, source });
+        }
+    }
+};
+ExpedienteUpdatedPublisher = __decorate([
+    injectable()
+], ExpedienteUpdatedPublisher);
+export { ExpedienteUpdatedPublisher };

package/bin/onboarding-business/queue/interfaces/IExpedienteUpdatedPublisher.d.ts

@@ -0,0 +1,14 @@
+import type { ExpedienteUpdatedSourceEnum } from "@fiado/type-kit/bin/onboarding/index.js";
+/**
+ * Publisher de EXPEDIENTE_UPDATED hacia OnboardingReadinessQueue (DEC-025), que consume
+ * onboarding-business para re-evaluar si algún lado del expediente ya cumple sus requisitos y
+ * disparar la emisión reactiva. Lo produce quien escribe el expediente (People / ARC / documentos):
+ * fiado-identity-lambda y, desde la migración del backoffice, people-business.
+ *
+ * El productor necesita `ONBOARDING_READINESS_QUEUE_URL` (`!ImportValue SqsOnboardingReadinessQueueUrl`)
+ * y `sqs:SendMessage` sobre `SqsOnboardingReadinessQueueArn`.
+ */
+export interface IExpedienteUpdatedPublisher {
+    /** Fire-and-forget: JAMÁS lanza. Una falla de SQS no debe tumbar la escritura del expediente. */
+    publish(directoryId: string, peopleId: string, source: ExpedienteUpdatedSourceEnum): Promise<void>;
+}

package/bin/onboarding-business/queue/interfaces/IExpedienteUpdatedPublisher.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.103.0",
+  "version": "5.104.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",

package/src/container.config.ts

@@ -98,7 +98,7 @@ import { FirebaseConnectorApi, IFirebaseConnectorApi } from "./firebase-connecto
 import { IOnboardingApi } from "./onboarding/index.js";
 import OnboardingApi from "./onboarding/api/OnboardingApi.js";
 import OnboardingBusinessApi from "./onboarding-business/api/OnboardingBusinessApi.js";
-import { IOnboardingBusinessApi } from "./onboarding-business/index.js";
+import { IOnboardingBusinessApi, IExpedienteUpdatedPublisher, ExpedienteUpdatedPublisher } from "./onboarding-business/index.js";
 import { IPayrollApi, PayrollApi } from "./payroll-business/index.js";
 import { IReferralBusinessApi, ReferralBusinessApi } from "./referral-business/index.js";
 import { EventHistoryApi, IEventHistoryApi } from "./event-history-business/index.js";
@@ -271,6 +271,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<ICognitoV2Api>("ICognitoV2Api").to(CognitoApi);
     bind<IZendeskApi>("IZendeskApi").to(ZendeskApi);
     bind<IZendeskAlertsPublisher>("IZendeskAlertsPublisher").to(ZendeskAlertsPublisher);
+    bind<IExpedienteUpdatedPublisher>("IExpedienteUpdatedPublisher").to(ExpedienteUpdatedPublisher);
     bind<IBlackListApi>("IBlackListApi").to(BlackListApi);
     bind<IDeviceApi>("IDeviceApi").to(DeviceApi);
     bind<IObservationsApi>("IObservationsApi").to(ObservationsApi);

package/src/onboarding-business/index.ts

@@ -1,2 +1,4 @@
 export * from './api/OnboardingBusinessApi.js';
-export * from './api/interfaces/IOnboardingBusinessApi.js';
+export * from './api/interfaces/IOnboardingBusinessApi.js';
+export * from './queue/interfaces/IExpedienteUpdatedPublisher.js';
+export * from './queue/ExpedienteUpdatedPublisher.js';

package/src/onboarding-business/queue/ExpedienteUpdatedPublisher.ts

@@ -0,0 +1,38 @@
+import { randomUUID } from "node:crypto";
+import { SendMessageCommand, SQSClient } from "@aws-sdk/client-sqs";
+import { injectable } from "inversify";
+import { log } from "@fiado/logger";
+import type { ExpedienteUpdatedMessage, ExpedienteUpdatedSourceEnum } from "@fiado/type-kit/bin/onboarding/index.js";
+import type { IExpedienteUpdatedPublisher } from "./interfaces/IExpedienteUpdatedPublisher.js";
+
+/**
+ * Marcador fijo del log de fallo: la alarma de CloudWatch del productor filtra por este texto
+ * (mismo marcador que usa fiado-identity-lambda, TD-025 de onboarding-business).
+ */
+export const EXPEDIENTE_PUBLISH_FAILED = "EXPEDIENTE_UPDATED publish failed";
+
+@injectable()
+export class ExpedienteUpdatedPublisher implements IExpedienteUpdatedPublisher {
+
+    async publish(directoryId: string, peopleId: string, source: ExpedienteUpdatedSourceEnum): Promise<void> {
+        try {
+            // Mensaje anémico a propósito: el consumidor SIEMPRE lee el expediente fresco.
+            const message: ExpedienteUpdatedMessage = {
+                eventType: "EXPEDIENTE_UPDATED",
+                eventId: randomUUID(),
+                directoryId,
+                peopleId,
+                source,
+                occurredAt: new Date().toISOString(),
+            } as ExpedienteUpdatedMessage;
+            // Cola estándar: sin MessageGroupId. El evaluador del consumidor es idempotente.
+            await new SQSClient().send(new SendMessageCommand({
+                QueueUrl: process.env.ONBOARDING_READINESS_QUEUE_URL,
+                MessageBody: JSON.stringify(message),
+            }));
+        } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            log.error(`${EXPEDIENTE_PUBLISH_FAILED}: ${errorMessage}`, { directoryId, peopleId, source });
+        }
+    }
+}

package/src/onboarding-business/queue/interfaces/IExpedienteUpdatedPublisher.ts

@@ -0,0 +1,15 @@
+import type { ExpedienteUpdatedSourceEnum } from "@fiado/type-kit/bin/onboarding/index.js";
+
+/**
+ * Publisher de EXPEDIENTE_UPDATED hacia OnboardingReadinessQueue (DEC-025), que consume
+ * onboarding-business para re-evaluar si algún lado del expediente ya cumple sus requisitos y
+ * disparar la emisión reactiva. Lo produce quien escribe el expediente (People / ARC / documentos):
+ * fiado-identity-lambda y, desde la migración del backoffice, people-business.
+ *
+ * El productor necesita `ONBOARDING_READINESS_QUEUE_URL` (`!ImportValue SqsOnboardingReadinessQueueUrl`)
+ * y `sqs:SendMessage` sobre `SqsOnboardingReadinessQueueArn`.
+ */
+export interface IExpedienteUpdatedPublisher {
+    /** Fire-and-forget: JAMÁS lanza. Una falla de SQS no debe tumbar la escritura del expediente. */
+    publish(directoryId: string, peopleId: string, source: ExpedienteUpdatedSourceEnum): Promise<void>;
+}