@fiado/api-invoker 5.103.0 → 5.105.0

package/bin/collection-engine/api/CollectionEngineApi.d.ts

@@ -1,5 +1,5 @@
 import type { IHttpRequest } from "@fiado/http-client";
-import { CollectRequest, CollectResponse, DeregisterChargeResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse, DisburseRequest, DisburseResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
@@ -13,5 +13,6 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
     registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<RegisterCollectibleResponse>>;
     collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
     deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
+    disburse(request: DisburseRequest): Promise<FiadoApiResponse<DisburseResponse>>;
 }
 export {};

package/bin/collection-engine/api/CollectionEngineApi.js

@@ -37,6 +37,11 @@ let CollectionEngineApi = class CollectionEngineApi {
             + `/charges/${encodeURIComponent(chargeId)}/deregister`;
         return await this.httpRequest.post(url, {});
     }
+    async disburse(request) {
+        const url = `${this.baseUrl}collection/disburse`;
+        // Firma de http-client: post(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.post(url, request, {}, undefined, true);
+    }
 };
 CollectionEngineApi = __decorate([
     injectable(),

package/bin/collection-engine/api/interfaces/ICollectionEngineApi.d.ts

@@ -1,4 +1,4 @@
-import { CollectRequest, CollectResponse, DeregisterChargeResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse, DisburseRequest, DisburseResponse, RegisterCollectibleRequest, RegisterCollectibleResponse } from "@fiado/type-kit/bin/collection/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
  * Cliente para invocar los endpoints privados del lambda `collection-engine-business`.
@@ -46,5 +46,10 @@ export interface ICollectionEngineApi {
      * Backend: POST /collection/domains/{domain}/charges/{chargeId}/deregister (privado VPC).
      */
     deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
+    /**
+     * Dispersión síncrona: el motor deposita al titular y contesta si el dinero se movió.
+     * Backend: POST /collection/disburse (privado VPC), con timeout de cliente.
+     */
+    disburse(request: DisburseRequest): Promise<FiadoApiResponse<DisburseResponse>>;
 }
 export {};

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/transactionProcessor/api/TransactionProcessorApi.js

@@ -75,7 +75,8 @@ let TransactionProcessorApi = class TransactionProcessorApi {
     }
     async authorizeWelcomeBonus(request) {
         const url = `${this.baseUrl}bonus/authorize`;
-        return await this.httpRequest.post(url, request);
+        // Firma de http-client: post(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.post(url, request, {}, undefined, true);
     }
 };
 TransactionProcessorApi = __decorate([

package/package.json

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

package/src/collection-engine/api/CollectionEngineApi.ts

@@ -4,6 +4,8 @@ import {
     CollectRequest,
     CollectResponse,
     DeregisterChargeResponse,
+    DisburseRequest,
+    DisburseResponse,
     RegisterCollectibleRequest,
     RegisterCollectibleResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
@@ -41,4 +43,10 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
             + `/charges/${encodeURIComponent(chargeId)}/deregister`;
         return await this.httpRequest.post(url, {});
     }
+
+    async disburse(request: DisburseRequest): Promise<FiadoApiResponse<DisburseResponse>> {
+        const url = `${this.baseUrl}collection/disburse`;
+        // Firma de http-client: post(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.post(url, request, {}, undefined, true);
+    }
 }

package/src/collection-engine/api/interfaces/ICollectionEngineApi.ts

@@ -2,6 +2,8 @@ import {
     CollectRequest,
     CollectResponse,
     DeregisterChargeResponse,
+    DisburseRequest,
+    DisburseResponse,
     RegisterCollectibleRequest,
     RegisterCollectibleResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
@@ -57,4 +59,10 @@ export interface ICollectionEngineApi {
      * Backend: POST /collection/domains/{domain}/charges/{chargeId}/deregister (privado VPC).
      */
     deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
+
+    /**
+     * Dispersión síncrona: el motor deposita al titular y contesta si el dinero se movió.
+     * Backend: POST /collection/disburse (privado VPC), con timeout de cliente.
+     */
+    disburse(request: DisburseRequest): Promise<FiadoApiResponse<DisburseResponse>>;
 }

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/transactionProcessor/api/TransactionProcessorApi.ts

@@ -129,6 +129,7 @@ export default class TransactionProcessorApi implements ITransactionProcessorApi
         request: AuthorizeBonusRequest,
     ): Promise<FiadoApiResponse<TransactionProcessorResponse>> {
         const url = `${this.baseUrl}bonus/authorize`;
-        return await this.httpRequest.post(url, request);
+        // Firma de http-client: post(url, data, headers, basicAuth, enableTimeout).
+        return await this.httpRequest.post(url, request, {}, undefined, true);
     }
 }