@fiado/api-invoker 5.102.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/bin/retailCards/api/RetailCardsBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { CardDeliveryResponse, RegisterCardDeliveryRequest, ReverseCardMovementRequest } from "@fiado/type-kit/bin/retailCards/index.js";
+import { CardBalanceResponse, CardDeliveryResponse, RegisterCardDeliveryRequest, ReverseCardMovementRequest } from "@fiado/type-kit/bin/retailCards/index.js";
 import { IRetailCardsBusinessApi } from "./interfaces/IRetailCardsBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para sus endpoints
@@ -20,4 +20,5 @@ export default class RetailCardsBusinessApi implements IRetailCardsBusinessApi {
     constructor(httpRequest: IHttpRequest);
     registerDelivery(storeId: string, body: RegisterCardDeliveryRequest, tenantId: string): Promise<StandardResponse<CardDeliveryResponse>>;
     reverseDelivery(storeId: string, body: ReverseCardMovementRequest, tenantId: string): Promise<StandardResponse<void>>;
+    getBalance(storeId: string, tenantId: string): Promise<StandardResponse<CardBalanceResponse>>;
 }

package/bin/retailCards/api/RetailCardsBusinessApi.js

@@ -38,6 +38,10 @@ let RetailCardsBusinessApi = class RetailCardsBusinessApi {
         const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-movements/reverse?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, body);
     }
+    async getBalance(storeId, tenantId) {
+        const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-balance?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
 };
 RetailCardsBusinessApi = __decorate([
     injectable(),

package/bin/retailCards/api/interfaces/IRetailCardsBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { CardDeliveryResponse, RegisterCardDeliveryRequest, ReverseCardMovementRequest } from "@fiado/type-kit/bin/retailCards/index.js";
+import { CardBalanceResponse, CardDeliveryResponse, RegisterCardDeliveryRequest, ReverseCardMovementRequest } from "@fiado/type-kit/bin/retailCards/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para
  * sus endpoints privados del inventario de tarjetas físicas PCF, consumidos por el wizard F2 (paso 09).
@@ -34,4 +34,6 @@ export interface IRetailCardsBusinessApi {
      * cancela (DEC-007 destino). Escribe un contraasiento, no borra el original.
      */
     reverseDelivery(storeId: string, body: ReverseCardMovementRequest, tenantId: string): Promise<StandardResponse<void>>;
+    /** GET `/private/stores/{storeId}/card-balance` — tarjetas disponibles en la tienda; sin saldo, `available: 0`. */
+    getBalance(storeId: string, tenantId: string): Promise<StandardResponse<CardBalanceResponse>>;
 }

package/package.json

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

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

package/src/retailCards/api/RetailCardsBusinessApi.ts

@@ -2,6 +2,7 @@ import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
+    CardBalanceResponse,
     CardDeliveryResponse,
     RegisterCardDeliveryRequest,
     ReverseCardMovementRequest,
@@ -44,4 +45,9 @@ export default class RetailCardsBusinessApi implements IRetailCardsBusinessApi {
         const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-movements/reverse?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, body);
     }
+
+    async getBalance(storeId: string, tenantId: string): Promise<StandardResponse<CardBalanceResponse>> {
+        const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-balance?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
 }

package/src/retailCards/api/interfaces/IRetailCardsBusinessApi.ts

@@ -1,5 +1,6 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
+    CardBalanceResponse,
     CardDeliveryResponse,
     RegisterCardDeliveryRequest,
     ReverseCardMovementRequest,
@@ -48,4 +49,7 @@ export interface IRetailCardsBusinessApi {
         body: ReverseCardMovementRequest,
         tenantId: string,
     ): Promise<StandardResponse<void>>;
+
+    /** GET `/private/stores/{storeId}/card-balance` — tarjetas disponibles en la tienda; sin saldo, `available: 0`. */
+    getBalance(storeId: string, tenantId: string): Promise<StandardResponse<CardBalanceResponse>>;
 }