@adatechnology/meta-whatsapp-module 0.2.0-rc.29 → 0.2.0-rc.30

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(index_exports, {
   FlowMediaRepository: () => FlowMediaRepository,
   GetFlowGraphUseCase: () => GetFlowGraphUseCase,
   GetLiveFlowPositionsUseCase: () => GetLiveFlowPositionsUseCase,
+  InboundEffectsDispatcher: () => InboundEffectsDispatcher,
   IngestInboundMediaUseCase: () => IngestInboundMediaUseCase,
   InvalidFlowGraphError: () => InvalidFlowGraphError,
   ListCompanyDocumentsUseCase: () => ListCompanyDocumentsUseCase,
@@ -46,6 +47,7 @@ __export(index_exports, {
   OptimisticLockError: () => OptimisticLockError,
   PREVIEW_MEDIA_ID_PREFIX: () => import_meta_whatsapp_contracts8.PREVIEW_MEDIA_ID_PREFIX,
   PRODUCT_LIST_LIMIT: () => PRODUCT_LIST_LIMIT,
+  ProcessInboundDispatchUseCase: () => ProcessInboundDispatchUseCase,
   PurgeExpiredDocumentsUseCase: () => PurgeExpiredDocumentsUseCase,
   ReceiveWebhookUseCase: () => ReceiveWebhookUseCase,
   ReleaseConversationUseCase: () => ReleaseConversationUseCase,
@@ -59,9 +61,12 @@ __export(index_exports, {
   TRANSCRIPTION_STATUS: () => TRANSCRIPTION_STATUS,
   TakeoverConversationUseCase: () => TakeoverConversationUseCase,
   TranscribeAudioUseCase: () => TranscribeAudioUseCase,
+  WEBHOOK_CLAIM_TTL_SECONDS: () => import_meta_graph_core2.WEBHOOK_CLAIM_TTL_SECONDS,
   WEBHOOK_NONCE_TTL_SECONDS: () => import_meta_graph_core2.WEBHOOK_NONCE_TTL_SECONDS,
   WhatsAppChannelAdapter: () => WhatsAppChannelAdapter,
+  buildInboundJobId: () => buildInboundJobId,
   claimWebhookDelivery: () => claimWebhookDelivery,
+  confirmWebhookDelivery: () => confirmWebhookDelivery,
   createMetaWhatsAppModule: () => createMetaWhatsAppModule,
   createSendMediaAction: () => createSendMediaAction,
   createSendProductListAction: () => createSendProductListAction,
@@ -84,6 +89,7 @@ __export(index_exports, {
   sessions: () => sessions,
   settings: () => settings,
   toPreviewMediaId: () => import_meta_whatsapp_contracts8.toPreviewMediaId,
+  toSessionContract: () => toSessionContract,
   transcriptionRetryAfterSeconds: () => transcriptionRetryAfterSeconds,
   verifyWebhookChallenge: () => verifyWebhookChallenge,
   verifyWebhookSignature: () => verifyWebhookSignature
@@ -2099,14 +2105,21 @@ function verifyWebhookSignature(params) {
   if (!(0, import_meta_graph_core2.isValidWebhookSignature)(params)) throw new import_meta_whatsapp_contracts10.InvalidWebhookSignatureError();
 }
 __name(verifyWebhookSignature, "verifyWebhookSignature");
-async function claimWebhookDelivery(params) {
-  const key = (0, import_meta_graph_core2.buildWebhookDeliveryKey)({
+function deliveryKey(signatureHeader) {
+  return (0, import_meta_graph_core2.buildWebhookDeliveryKey)({
     namespace: WEBHOOK_NONCE_NAMESPACE,
-    signatureHeader: params.signatureHeader
+    signatureHeader
   });
-  return params.nonceStore.setIfAbsent(key, params.ttlSeconds ?? import_meta_graph_core2.WEBHOOK_NONCE_TTL_SECONDS);
+}
+__name(deliveryKey, "deliveryKey");
+async function claimWebhookDelivery(params) {
+  return params.nonceStore.setIfAbsent(deliveryKey(params.signatureHeader), params.ttlSeconds ?? import_meta_graph_core2.WEBHOOK_CLAIM_TTL_SECONDS);
 }
 __name(claimWebhookDelivery, "claimWebhookDelivery");
+async function confirmWebhookDelivery(params) {
+  await params.nonceStore.confirm?.(deliveryKey(params.signatureHeader), params.ttlSeconds ?? import_meta_graph_core2.WEBHOOK_NONCE_TTL_SECONDS);
+}
+__name(confirmWebhookDelivery, "confirmWebhookDelivery");
 
 // src/channel/IngestInboundMedia.use-case.ts
 var import_drizzle_orm8 = require("drizzle-orm");
@@ -2427,7 +2440,11 @@ function extractMediaDescriptor(message) {
 }
 __name(extractMediaDescriptor, "extractMediaDescriptor");
 
-// src/channel/ReceiveWebhook.use-case.ts
+// src/channel/inboundDispatch.ts
+function buildInboundJobId(job) {
+  return job.kind === "message" ? `wa-inbound-message:${job.message.id}` : `wa-inbound-status:${job.status.id}:${job.status.status}`;
+}
+__name(buildInboundJobId, "buildInboundJobId");
 function toSessionContract(row) {
   return {
     id: row.id,
@@ -2448,6 +2465,65 @@ function toSessionContract(row) {
   };
 }
 __name(toSessionContract, "toSessionContract");
+function extractAnswer(message) {
+  const interactive = message.interactive;
+  if (interactive?.button_reply) return interactive.button_reply.id;
+  if (interactive?.list_reply) return interactive.list_reply.id;
+  return message.text?.body;
+}
+__name(extractAnswer, "extractAnswer");
+var InboundEffectsDispatcher = class {
+  static {
+    __name(this, "InboundEffectsDispatcher");
+  }
+  params;
+  constructor(params) {
+    this.params = params;
+  }
+  async run(job) {
+    if (job.kind === "message") return this.runMessageEffects(job);
+    return this.runStatusEffects(job);
+  }
+  async runMessageEffects(job) {
+    const { companyId, message, savedMessageId, media } = job;
+    if (media) {
+      await this.params.hooks?.onMediaReceived?.({
+        companyId,
+        messageId: savedMessageId,
+        whatsappNumber: message.from,
+        sourceMediaId: media.sourceMediaId,
+        mimeType: media.mimeType,
+        ...media.filename ? {
+          filename: media.filename
+        } : {}
+      });
+    }
+    const sessionRow = await this.params.sessionRepository.getContext(companyId, message.from);
+    if (!sessionRow) return;
+    if (sessionRow.mode === "human") return;
+    const outcome = await this.params.hooks?.onMessageReceived?.(message, toSessionContract(sessionRow));
+    if (outcome?.outcome === "handled") return;
+    void extractAnswer(message);
+  }
+  async runStatusEffects(job) {
+    const sessionRow = await this.params.sessionRepository.getContext(job.companyId, job.whatsappNumber);
+    await this.params.hooks?.onStatusUpdate?.(job.status, sessionRow ? toSessionContract(sessionRow) : null);
+  }
+};
+var ProcessInboundDispatchUseCase = class {
+  static {
+    __name(this, "ProcessInboundDispatchUseCase");
+  }
+  dispatcher;
+  constructor(dispatcher) {
+    this.dispatcher = dispatcher;
+  }
+  async execute(job) {
+    await this.dispatcher.run(job);
+  }
+};
+
+// src/channel/ReceiveWebhook.use-case.ts
 function extractContent(message) {
   if (message.text?.body) return message.text.body;
   const interactive = message.interactive;
@@ -2460,13 +2536,6 @@ function extractContent(message) {
   return message.image?.caption ?? message.document?.caption ?? null;
 }
 __name(extractContent, "extractContent");
-function extractAnswer(message) {
-  const interactive = message.interactive;
-  if (interactive?.button_reply) return interactive.button_reply.id;
-  if (interactive?.list_reply) return interactive.list_reply.id;
-  return message.text?.body;
-}
-__name(extractAnswer, "extractAnswer");
 function extractPayload(message) {
   const payload = {};
   if (message.interactive) payload["interactive"] = message.interactive;
@@ -2487,7 +2556,17 @@ var ReceiveWebhookUseCase = class {
   params;
   constructor(params) {
     this.params = params;
+    this.dispatcher = new InboundEffectsDispatcher({
+      sessionRepository: params.sessionRepository,
+      ...params.hooks ? {
+        hooks: params.hooks
+      } : {},
+      ...params.realtime ? {
+        realtime: params.realtime
+      } : {}
+    });
   }
+  dispatcher;
   async execute(input) {
     verifyWebhookSignature({
       rawBody: input.rawBody,
@@ -2526,6 +2605,10 @@ var ReceiveWebhookUseCase = class {
         }
       }
     }
+    await confirmWebhookDelivery({
+      nonceStore: this.params.nonceStore,
+      signatureHeader: input.signatureHeader
+    });
     return {
       duplicate: false,
       messagesProcessed,
@@ -2548,24 +2631,16 @@ var ReceiveWebhookUseCase = class {
     });
     if (!saved) return;
     const media = extractMediaDescriptor(saved);
-    if (media) {
-      await this.params.hooks?.onMediaReceived?.({
-        companyId,
-        messageId: saved.id,
-        whatsappNumber: message.from,
-        sourceMediaId: media.sourceMediaId,
-        mimeType: media.mimeType,
-        ...media.filename ? {
-          filename: media.filename
-        } : {}
-      });
-    }
-    const sessionRow = await this.params.sessionRepository.getContext(companyId, message.from);
-    if (!sessionRow) return;
-    if (sessionRow.mode === "human") return;
-    const outcome = await this.params.hooks?.onMessageReceived?.(message, toSessionContract(sessionRow));
-    if (outcome?.outcome === "handled") return;
-    void extractAnswer(message);
+    await this.dispatch({
+      kind: "message",
+      companyId,
+      message,
+      savedMessageId: saved.id,
+      ...media ? {
+        media
+      } : {},
+      receivedAt: Date.now()
+    });
   }
   async handleStatus(companyId, status) {
     const updated = await this.params.messageRepository.updateMessageStatus(companyId, status.id, status.status);
@@ -2574,8 +2649,24 @@ var ReceiveWebhookUseCase = class {
       waMessageId: status.id,
       status: status.status
     });
-    const sessionRow = await this.params.sessionRepository.getContext(companyId, updated.whatsappNumber);
-    await this.params.hooks?.onStatusUpdate?.(status, sessionRow ? toSessionContract(sessionRow) : null);
+    await this.dispatch({
+      kind: "status",
+      companyId,
+      status,
+      whatsappNumber: updated.whatsappNumber,
+      receivedAt: Date.now()
+    });
+  }
+  // Com fila configurada, os efeitos saem da requisição do webhook; sem ela, rodam aqui mesmo e o
+  // comportamento é o de sempre. É o mesmo `InboundEffectsDispatcher` nos dois caminhos.
+  async dispatch(job) {
+    if (this.params.inboundQueue) {
+      await this.params.inboundQueue.enqueue(job, {
+        jobId: buildInboundJobId(job)
+      });
+      return;
+    }
+    await this.dispatcher.run(job);
   }
 };
 
@@ -2889,6 +2980,7 @@ __name(redeemSseTicket, "redeemSseTicket");
   FlowMediaRepository,
   GetFlowGraphUseCase,
   GetLiveFlowPositionsUseCase,
+  InboundEffectsDispatcher,
   IngestInboundMediaUseCase,
   InvalidFlowGraphError,
   ListCompanyDocumentsUseCase,
@@ -2902,6 +2994,7 @@ __name(redeemSseTicket, "redeemSseTicket");
   OptimisticLockError,
   PREVIEW_MEDIA_ID_PREFIX,
   PRODUCT_LIST_LIMIT,
+  ProcessInboundDispatchUseCase,
   PurgeExpiredDocumentsUseCase,
   ReceiveWebhookUseCase,
   ReleaseConversationUseCase,
@@ -2915,9 +3008,12 @@ __name(redeemSseTicket, "redeemSseTicket");
   TRANSCRIPTION_STATUS,
   TakeoverConversationUseCase,
   TranscribeAudioUseCase,
+  WEBHOOK_CLAIM_TTL_SECONDS,
   WEBHOOK_NONCE_TTL_SECONDS,
   WhatsAppChannelAdapter,
+  buildInboundJobId,
   claimWebhookDelivery,
+  confirmWebhookDelivery,
   createMetaWhatsAppModule,
   createSendMediaAction,
   createSendProductListAction,
@@ -2940,6 +3036,7 @@ __name(redeemSseTicket, "redeemSseTicket");
   sessions,
   settings,
   toPreviewMediaId,
+  toSessionContract,
   transcriptionRetryAfterSeconds,
   verifyWebhookChallenge,
   verifyWebhookSignature