@yaoqi10012/wechat-kf 0.3.1 → 0.3.3

package/dist/src/bot.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Message processing — pull messages via sync_msg and dispatch to OpenClaw agent.
+ *
+ * Architecture:
+ * - Each openKfId is an independent account with its own cursor and session
+ * - sync_msg is called with open_kfid filter to only pull messages for that kf account
+ * - Plugin layer: download media, save via MediaPaths/MediaTypes
+ * - OpenClaw runner: handles media understanding (transcription, vision, etc.)
+ */
+import type { ChannelLogSink, OpenClawConfig } from "openclaw/plugin-sdk";
+import type { ResolvedWechatKfAccount, WechatKfMessage } from "./types.js";
+/** Minimal runtime shape used only for error logging in the reply dispatcher. */
+export type RuntimeErrorLogger = {
+    error?: (...args: unknown[]) => void;
+    [key: string]: unknown;
+};
+export type BotContext = {
+    cfg: OpenClawConfig;
+    runtime?: RuntimeErrorLogger;
+    stateDir: string;
+    log?: ChannelLogSink;
+};
+declare function isDuplicate(msgid: string): boolean;
+/** Exposed for testing only — do not use in production code. */
+export declare const _testing: {
+    kfLocks: Map<string, Promise<void>>;
+    processedMsgIds: Set<string>;
+    isDuplicate: typeof isDuplicate;
+    DEDUP_MAX_SIZE: number;
+    handleEvent: typeof handleEvent;
+    drainToLatestCursor: typeof drainToLatestCursor;
+    resetState(): void;
+};
+declare function handleEvent(ctx: BotContext, _account: ResolvedWechatKfAccount, msg: WechatKfMessage): Promise<void>;
+declare function drainToLatestCursor(corpId: string, appSecret: string, openKfId: string, syncToken: string, stateDir: string, log?: ChannelLogSink): Promise<void>;
+export declare function handleWebhookEvent(ctx: BotContext, openKfId: string, syncToken: string): Promise<void>;
+export {};