@gakr-gakr/feishu 0.1.0

package/src/monitor.comment-notice-handler.ts

@@ -0,0 +1,105 @@
+import type { ClawdbotConfig, RuntimeEnv } from "../runtime-api.js";
+import { handleFeishuCommentEvent } from "./comment-handler.js";
+import {
+  claimUnprocessedFeishuMessage,
+  recordProcessedFeishuMessage,
+  releaseFeishuMessageProcessing,
+} from "./dedup.js";
+import { parseFeishuDriveCommentNoticeEventPayload } from "./monitor.comment.js";
+import { botOpenIds } from "./monitor.state.js";
+import { isFeishuRetryableSyntheticEventError } from "./monitor.synthetic-error.js";
+import { createSequentialQueue } from "./sequential-queue.js";
+
+function buildCommentNoticeQueueKey(event: {
+  notice_meta?: {
+    file_type?: string;
+    file_token?: string;
+  };
+}): string {
+  const fileType = event.notice_meta?.file_type?.trim() || "unknown";
+  const fileToken = event.notice_meta?.file_token?.trim() || "unknown";
+  return `comment-doc:${fileType}:${fileToken}`;
+}
+
+export function createFeishuDriveCommentNoticeHandler(params: {
+  cfg: ClawdbotConfig;
+  accountId: string;
+  runtime?: RuntimeEnv;
+  fireAndForget?: boolean;
+  getBotOpenId?: (accountId: string) => string | undefined;
+}): (data: unknown) => Promise<void> {
+  const { cfg, accountId, runtime, fireAndForget } = params;
+  const log = runtime?.log ?? console.log;
+  const error = runtime?.error ?? console.error;
+  const enqueue = createSequentialQueue();
+  const getBotOpenId = params.getBotOpenId ?? ((id) => botOpenIds.get(id));
+
+  const runFeishuHandler = async (task: () => Promise<void>) => {
+    const promise = task().catch((err) => {
+      error(`feishu[${accountId}]: error handling drive comment notice: ${String(err)}`);
+    });
+    if (!fireAndForget) {
+      await promise;
+    }
+  };
+
+  return async (data: unknown) => {
+    await runFeishuHandler(async () => {
+      const event = parseFeishuDriveCommentNoticeEventPayload(data);
+      if (!event) {
+        error(`feishu[${accountId}]: ignoring malformed drive comment notice payload`);
+        return;
+      }
+      const eventId = event.event_id?.trim();
+      const syntheticMessageId = eventId ? `drive-comment:${eventId}` : undefined;
+      if (syntheticMessageId) {
+        const claim = await claimUnprocessedFeishuMessage({
+          messageId: syntheticMessageId,
+          namespace: accountId,
+          log,
+        });
+        if (claim === "duplicate") {
+          log(`feishu[${accountId}]: dropping duplicate comment event ${syntheticMessageId}`);
+          return;
+        }
+        if (claim === "inflight") {
+          log(`feishu[${accountId}]: dropping in-flight comment event ${syntheticMessageId}`);
+          return;
+        }
+      }
+      log(
+        `feishu[${accountId}]: received drive comment notice ` +
+          `event=${event.event_id ?? "unknown"} ` +
+          `type=${event.notice_meta?.notice_type ?? "unknown"} ` +
+          `file=${event.notice_meta?.file_type ?? "unknown"}:${event.notice_meta?.file_token ?? "unknown"} ` +
+          `comment=${event.comment_id ?? "unknown"} ` +
+          `reply=${event.reply_id ?? "none"} ` +
+          `from=${event.notice_meta?.from_user_id?.open_id ?? "unknown"} ` +
+          `mentioned=${event.is_mentioned === true ? "yes" : "no"}`,
+      );
+      try {
+        await enqueue(buildCommentNoticeQueueKey(event), async () => {
+          await handleFeishuCommentEvent({
+            cfg,
+            accountId,
+            event,
+            botOpenId: getBotOpenId(accountId),
+            runtime,
+          });
+        });
+        if (syntheticMessageId) {
+          await recordProcessedFeishuMessage(syntheticMessageId, accountId, log);
+        }
+      } catch (err) {
+        if (syntheticMessageId && !isFeishuRetryableSyntheticEventError(err)) {
+          await recordProcessedFeishuMessage(syntheticMessageId, accountId, log);
+        }
+        throw err;
+      } finally {
+        if (syntheticMessageId) {
+          releaseFeishuMessageProcessing(syntheticMessageId, accountId);
+        }
+      }
+    });
+  };
+}