@sunnoy/wecom 1.9.0 → 2.0.0

package/wecom/stream-utils.js

@@ -1,163 +0,0 @@
-import { logger } from "../logger.js";
-import { streamManager } from "../stream-manager.js";
-import { THINKING_PLACEHOLDER } from "./constants.js";
-import { activeStreamHistory, activeStreams, lastStreamByKey, messageBuffers } from "./state.js";
-
-export function getMessageStreamKey(message) {
-  if (!message || typeof message !== "object") {
-    return "";
-  }
-  const chatType = message.chatType || "single";
-  const chatId = message.chatId || "";
-  if (chatType === "group" && chatId) {
-    return chatId;
-  }
-  return message.fromUser || "";
-}
-
-export function registerActiveStream(streamKey, streamId) {
-  if (!streamKey || !streamId) {
-    return;
-  }
-
-  const history = activeStreamHistory.get(streamKey) ?? [];
-  const deduped = history.filter((id) => id !== streamId);
-  deduped.push(streamId);
-  activeStreamHistory.set(streamKey, deduped);
-  activeStreams.set(streamKey, streamId);
-  lastStreamByKey.set(streamKey, streamId);
-  logger.info("registerActiveStream", {
-    streamKey,
-    streamId,
-    historySize: deduped.length,
-    history: deduped,
-  });
-}
-
-export function unregisterActiveStream(streamKey, streamId) {
-  if (!streamKey || !streamId) {
-    return;
-  }
-
-  const history = activeStreamHistory.get(streamKey);
-  if (!history || history.length === 0) {
-    if (activeStreams.get(streamKey) === streamId) {
-      activeStreams.delete(streamKey);
-    }
-    logger.info("unregisterActiveStream (empty history)", { streamKey, streamId });
-    return;
-  }
-
-  const remaining = history.filter((id) => id !== streamId);
-  if (remaining.length === 0) {
-    activeStreamHistory.delete(streamKey);
-    activeStreams.delete(streamKey);
-    logger.info("unregisterActiveStream (last stream)", { streamKey, streamId });
-    return;
-  }
-
-  activeStreamHistory.set(streamKey, remaining);
-  activeStreams.set(streamKey, remaining[remaining.length - 1]);
-  logger.info("unregisterActiveStream", {
-    streamKey,
-    streamId,
-    remainingSize: remaining.length,
-    remaining,
-  });
-}
-
-export function resolveActiveStream(streamKey) {
-  if (!streamKey) {
-    return null;
-  }
-
-  const history = activeStreamHistory.get(streamKey);
-  if (!history || history.length === 0) {
-    activeStreams.delete(streamKey);
-    return null;
-  }
-
-  const remaining = history.filter((id) => streamManager.hasStream(id));
-  if (remaining.length === 0) {
-    activeStreamHistory.delete(streamKey);
-    activeStreams.delete(streamKey);
-    return null;
-  }
-
-  activeStreamHistory.set(streamKey, remaining);
-  const latest = remaining[remaining.length - 1];
-  activeStreams.set(streamKey, latest);
-  lastStreamByKey.set(streamKey, latest);
-  return latest;
-}
-
-/**
- * Resolve a usable stream id for a sender/group.
- * Prefer active history; if that is temporarily empty, fall back to the latest
- * known stream id for the same key (when it still exists).
- */
-export function resolveRecoverableStream(streamKey) {
-  const activeId = resolveActiveStream(streamKey);
-  if (activeId) {
-    return activeId;
-  }
-  if (!streamKey) {
-    return null;
-  }
-  const recentId = lastStreamByKey.get(streamKey);
-  if (!recentId) {
-    return null;
-  }
-  if (!streamManager.hasStream(recentId)) {
-    return null;
-  }
-  return recentId;
-}
-
-export function clearBufferedMessagesForStream(streamKey, reason) {
-  const buffer = messageBuffers.get(streamKey);
-  if (!buffer) {
-    return 0;
-  }
-
-  messageBuffers.delete(streamKey);
-  clearTimeout(buffer.timer);
-
-  const notice = reason || "消息已被高优先级指令中断。";
-  let drained = 0;
-  for (const bufferedStreamId of buffer.streamIds || []) {
-    if (!bufferedStreamId) {
-      continue;
-    }
-    drained += 1;
-    streamManager.replaceIfPlaceholder(bufferedStreamId, notice, THINKING_PLACEHOLDER);
-    streamManager.finishStream(bufferedStreamId).then(() => {
-      unregisterActiveStream(streamKey, bufferedStreamId);
-    }).catch((err) => {
-      logger.warn("WeCom: failed finishing buffered stream", {
-        streamKey,
-        streamId: bufferedStreamId,
-        error: err?.message || String(err),
-      });
-    });
-  }
-
-  return drained;
-}
-
-/**
- * Handle stream error: replace placeholder with error message, finish stream, unregister.
- */
-export async function handleStreamError(streamId, streamKey, errorMessage) {
-  if (!streamId) {
-    return;
-  }
-  const stream = streamManager.getStream(streamId);
-  if (stream && !stream.finished) {
-    if (stream.content.trim() === THINKING_PLACEHOLDER.trim()) {
-      streamManager.replaceIfPlaceholder(streamId, errorMessage, THINKING_PLACEHOLDER);
-    }
-    await streamManager.finishStream(streamId);
-  }
-  unregisterActiveStream(streamKey, streamId);
-}

package/wecom/webhook-targets.js

@@ -1,28 +0,0 @@
-import { webhookTargets } from "./state.js";
-
-export function normalizeWebhookPath(raw) {
-  const trimmed = (raw || "").trim();
-  if (!trimmed) {
-    return "/";
-  }
-  const withSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
-  if (withSlash.length > 1 && withSlash.endsWith("/")) {
-    return withSlash.slice(0, -1);
-  }
-  return withSlash;
-}
-
-export function registerWebhookTarget(target) {
-  const key = normalizeWebhookPath(target.path);
-  const entry = { ...target, path: key };
-  const existing = webhookTargets.get(key) ?? [];
-  webhookTargets.set(key, [...existing, entry]);
-  return () => {
-    const updated = (webhookTargets.get(key) ?? []).filter((e) => e !== entry);
-    if (updated.length > 0) {
-      webhookTargets.set(key, updated);
-    } else {
-      webhookTargets.delete(key);
-    }
-  };
-}

package/wecom/xml-parser.js

@@ -1,126 +0,0 @@
-/**
- * WeCom XML Parser
- *
- * Simple regex-based parser for Agent mode XML callbacks.
- * No external dependencies — WeCom XML has a flat, predictable structure.
- *
- * Typical decrypted XML:
- *   <xml>
- *     <ToUserName><![CDATA[corpId]]></ToUserName>
- *     <FromUserName><![CDATA[zhangsan]]></FromUserName>
- *     <CreateTime>1348831860</CreateTime>
- *     <MsgType><![CDATA[text]]></MsgType>
- *     <Content><![CDATA[hello]]></Content>
- *     <MsgId>1234567890123456</MsgId>
- *     <AgentID>1000002</AgentID>
- *   </xml>
- */
-
-/**
- * Extract the <Encrypt> field from the outer XML envelope.
- * Supports both CDATA and plain text formats.
- *
- * @param {string} xml - Raw XML string from WeCom POST body
- * @returns {string} The encrypted payload
- */
-export function extractEncryptFromXml(xml) {
-  const cdataMatch = /<Encrypt><!\[CDATA\[(.*?)\]\]><\/Encrypt>/s.exec(xml);
-  if (cdataMatch?.[1]) return cdataMatch[1];
-
-  const plainMatch = /<Encrypt>(.*?)<\/Encrypt>/s.exec(xml);
-  if (plainMatch?.[1]) return plainMatch[1];
-
-  throw new Error("Invalid XML: missing Encrypt field");
-}
-
-/**
- * Parse a decrypted WeCom XML message into a flat key-value object.
- * Handles both CDATA-wrapped and plain text values.
- *
- * @param {string} xml - Decrypted XML string
- * @returns {Record<string, string>}
- */
-export function parseXml(xml) {
-  const result = {};
-
-  // Match <TagName><![CDATA[value]]></TagName> (CDATA)
-  const cdataRegex = /<(\w+)><!\[CDATA\[([\s\S]*?)\]\]><\/\1>/g;
-  let match;
-  while ((match = cdataRegex.exec(xml)) !== null) {
-    result[match[1]] = match[2];
-  }
-
-  // Match <TagName>value</TagName> (plain text, skip already-captured CDATA fields)
-  const plainRegex = /<(\w+)>([^<]+)<\/\1>/g;
-  while ((match = plainRegex.exec(xml)) !== null) {
-    if (!(match[1] in result)) {
-      result[match[1]] = match[2].trim();
-    }
-  }
-
-  return result;
-}
-
-/** Extract message type (lowercase). */
-export function extractMsgType(msg) {
-  return String(msg.MsgType ?? "").toLowerCase();
-}
-
-/** Extract sender user ID. */
-export function extractFromUser(msg) {
-  return String(msg.FromUserName ?? "");
-}
-
-/** Extract group chat ID (undefined for DMs). */
-export function extractChatId(msg) {
-  return msg.ChatId ? String(msg.ChatId) : undefined;
-}
-
-/** Extract message ID for deduplication. */
-export function extractMsgId(msg) {
-  const raw = msg.MsgId ?? msg.MsgID ?? msg.msgid ?? msg.msgId;
-  return raw != null ? String(raw) : undefined;
-}
-
-/** Extract file name (for file messages). */
-export function extractFileName(msg) {
-  const raw = msg.FileName ?? msg.Filename ?? msg.fileName ?? msg.filename;
-  return raw != null ? String(raw).trim() || undefined : undefined;
-}
-
-/** Extract media ID (for image/voice/video/file messages). */
-export function extractMediaId(msg) {
-  const raw = msg.MediaId ?? msg.MediaID ?? msg.mediaid ?? msg.mediaId;
-  return raw != null ? String(raw).trim() || undefined : undefined;
-}
-
-/**
- * Extract human-readable content from a parsed message.
- *
- * @param {Record<string, string>} msg - Parsed XML message
- * @returns {string}
- */
-export function extractContent(msg) {
-  const msgType = extractMsgType(msg);
-
-  switch (msgType) {
-    case "text":
-      return String(msg.Content ?? "");
-    case "voice":
-      return String(msg.Recognition ?? "") || "[语音消息]";
-    case "image":
-      return `[图片] ${msg.PicUrl ?? ""}`;
-    case "file":
-      return "[文件消息]";
-    case "video":
-      return "[视频消息]";
-    case "location":
-      return `[位置] ${msg.Label ?? ""} (${msg.Location_X ?? ""}, ${msg.Location_Y ?? ""})`;
-    case "link":
-      return `[链接] ${msg.Title ?? ""}\n${msg.Description ?? ""}\n${msg.Url ?? ""}`;
-    case "event":
-      return `[事件] ${msg.Event ?? ""} - ${msg.EventKey ?? ""}`;
-    default:
-      return `[${msgType || "未知消息类型"}]`;
-  }
-}