@fiado/api-invoker 5.2.0 → 5.3.0

package/bin/kyc/queue/RetailKycInboundPublisher.d.ts

@@ -1,6 +1,5 @@
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
-import { IRetailKycInboundPublisher } from "./interfaces/IRetailKycInboundPublisher.js";
+import { IRetailKycInboundPublisher, RetailKycInboundMessage } from "./interfaces/IRetailKycInboundPublisher.js";
 export declare class RetailKycInboundPublisher implements IRetailKycInboundPublisher {
     private readonly RETAIL_KYC_INBOUND_QUEUE_URL;
-    publish(message: KycVerificationChangedV1): Promise<void>;
+    publish(message: RetailKycInboundMessage): Promise<void>;
 }

package/bin/kyc/queue/RetailKycInboundPublisher.js

@@ -11,8 +11,11 @@ let RetailKycInboundPublisher = class RetailKycInboundPublisher {
     async publish(message) {
         try {
             const client = new SQSClient();
-            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId. La deduplicación
-            // la hace el consumidor con la llave de negocio (directoryId + verificationId + status + result).
+            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId, y por lo tanto SIN
+            // orden garantizado. La deduplicación la hace el consumidor con la llave de negocio: el
+            // cierre por (directoryId + verificationId + status + result), la estación por
+            // (verificationId + step) — su escritura ya es idempotente. El reordenamiento lo resuelve
+            // el `occurredAt` de cada estación, no la cola.
             const sendMessageRequest = {
                 QueueUrl: this.RETAIL_KYC_INBOUND_QUEUE_URL,
                 MessageBody: JSON.stringify(message),

package/bin/kyc/queue/interfaces/IRetailKycInboundPublisher.d.ts

@@ -1,12 +1,22 @@
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { KycVerificationChangedV1, KycStepCompletedV1 } from "@fiado/type-kit/bin/kyc/index.js";
 /**
- * Publisher del resultado del KYC hacia `RetailKycInboundQueue`, que consume
- * `retail-wizard-business` (SureKeep F2).
+ * Todo lo que `RetailKycInboundQueue` transporta:
+ * - `KycVerificationChangedV1` — el CIERRE de la verificación, con el resultado consolidado.
+ * - `KycStepCompletedV1` — el resultado de UNA estación, en cuanto Metamap la cierra.
  *
- * Lo produce `kyc-metamap-webhook` cuando una verificación pasa a COMPLETED. Vive acá —y no como
- * SDK crudo en el webhook— porque la cola es COMPARTIDA cross-lambda: el estándar Fiado publica a una
- * cola compartida vía Publisher de `@fiado/api-invoker` (mismo patrón que `ITransactionPublisher`).
+ * Es una unión cerrada y no un `unknown` a propósito: el consumidor rutea por `eventType`, así que
+ * agregar un tipo acá obliga a tocar también el consumidor — que es exactamente la conversación que
+ * tiene que pasar antes de meter un mensaje nuevo en una cola compartida.
+ */
+export type RetailKycInboundMessage = KycVerificationChangedV1 | KycStepCompletedV1;
+/**
+ * Publisher del KYC hacia `RetailKycInboundQueue`, que consume `retail-wizard-business` (SureKeep F2).
+ *
+ * Lo produce `kyc-metamap-webhook`: el cierre cuando la verificación pasa a COMPLETED, y una estación
+ * por cada `step_completed`. Vive acá —y no como SDK crudo en el webhook— porque la cola es COMPARTIDA
+ * cross-lambda: el estándar Fiado publica a una cola compartida vía Publisher de `@fiado/api-invoker`
+ * (mismo patrón que `ITransactionPublisher`).
  */
 export interface IRetailKycInboundPublisher {
-    publish(message: KycVerificationChangedV1): Promise<void>;
+    publish(message: RetailKycInboundMessage): Promise<void>;
 }

package/package.json

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

package/src/kyc/queue/RetailKycInboundPublisher.ts

@@ -1,17 +1,19 @@
 import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
 import { injectable } from "inversify";
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
-import { IRetailKycInboundPublisher } from "./interfaces/IRetailKycInboundPublisher.js";
+import { IRetailKycInboundPublisher, RetailKycInboundMessage } from "./interfaces/IRetailKycInboundPublisher.js";
 
 @injectable()
 export class RetailKycInboundPublisher implements IRetailKycInboundPublisher {
     private readonly RETAIL_KYC_INBOUND_QUEUE_URL = process.env.RETAIL_KYC_INBOUND_QUEUE_URL;
 
-    async publish(message: KycVerificationChangedV1): Promise<void> {
+    async publish(message: RetailKycInboundMessage): Promise<void> {
         try {
             const client: SQSClient = new SQSClient();
-            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId. La deduplicación
-            // la hace el consumidor con la llave de negocio (directoryId + verificationId + status + result).
+            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId, y por lo tanto SIN
+            // orden garantizado. La deduplicación la hace el consumidor con la llave de negocio: el
+            // cierre por (directoryId + verificationId + status + result), la estación por
+            // (verificationId + step) — su escritura ya es idempotente. El reordenamiento lo resuelve
+            // el `occurredAt` de cada estación, no la cola.
             const sendMessageRequest: SendMessageRequest = {
                 QueueUrl: this.RETAIL_KYC_INBOUND_QUEUE_URL,
                 MessageBody: JSON.stringify(message),

package/src/kyc/queue/interfaces/IRetailKycInboundPublisher.ts

@@ -1,13 +1,24 @@
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { KycVerificationChangedV1, KycStepCompletedV1 } from "@fiado/type-kit/bin/kyc/index.js";
 
 /**
- * Publisher del resultado del KYC hacia `RetailKycInboundQueue`, que consume
- * `retail-wizard-business` (SureKeep F2).
+ * Todo lo que `RetailKycInboundQueue` transporta:
+ * - `KycVerificationChangedV1` — el CIERRE de la verificación, con el resultado consolidado.
+ * - `KycStepCompletedV1` — el resultado de UNA estación, en cuanto Metamap la cierra.
  *
- * Lo produce `kyc-metamap-webhook` cuando una verificación pasa a COMPLETED. Vive acá —y no como
- * SDK crudo en el webhook— porque la cola es COMPARTIDA cross-lambda: el estándar Fiado publica a una
- * cola compartida vía Publisher de `@fiado/api-invoker` (mismo patrón que `ITransactionPublisher`).
+ * Es una unión cerrada y no un `unknown` a propósito: el consumidor rutea por `eventType`, así que
+ * agregar un tipo acá obliga a tocar también el consumidor — que es exactamente la conversación que
+ * tiene que pasar antes de meter un mensaje nuevo en una cola compartida.
+ */
+export type RetailKycInboundMessage = KycVerificationChangedV1 | KycStepCompletedV1;
+
+/**
+ * Publisher del KYC hacia `RetailKycInboundQueue`, que consume `retail-wizard-business` (SureKeep F2).
+ *
+ * Lo produce `kyc-metamap-webhook`: el cierre cuando la verificación pasa a COMPLETED, y una estación
+ * por cada `step_completed`. Vive acá —y no como SDK crudo en el webhook— porque la cola es COMPARTIDA
+ * cross-lambda: el estándar Fiado publica a una cola compartida vía Publisher de `@fiado/api-invoker`
+ * (mismo patrón que `ITransactionPublisher`).
  */
 export interface IRetailKycInboundPublisher {
-    publish(message: KycVerificationChangedV1): Promise<void>;
+    publish(message: RetailKycInboundMessage): Promise<void>;
 }