@alemonjs/qq-bot 2.1.35 → 2.1.37

package/lib/config.d.ts

@@ -3,6 +3,8 @@ import { Options as Options$1 } from "./sdk/typing.js";
 declare const platform = "qq-bot";
 declare const platformFullName = "@alemonjs/qq-bot";
 type Options = {
+  /** 按钮/快捷菜单自动 ACK。设为 false 后由应用 useInteraction().ack() 回应。 */
+  autoInteractionAck?: boolean;
   /**
    * 主人-用户KEY
    */

package/lib/format.d.ts

@@ -1,5 +1,7 @@
 import { DataEnums, DataMarkDown } from "alemonjs";
 //#region src/format.d.ts
+/** 群聊、私聊和频道共用有序正文；提及等原生文本由发送上下文提供。 */
+declare const formatQQContent: (items: DataEnums[], renderNative: (item: DataEnums) => string, plain?: boolean, hideUnsupported?: boolean | number) => string;
 /**
  * 将结构化 Markdown 子元素数组转为可读纯文本
  */
@@ -22,5 +24,6 @@ declare const markdownRawToText: (raw: string, hideUnsupported?: boolean | numbe
  * 其余类型降级为文本
  */
 declare const dataEnumToText: (item: DataEnums, hideUnsupported?: boolean | number) => string;
+declare const createMarkdownText: (data: DataMarkDown['value']) => string;
 //#endregion
-export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };
+export { buttonsToText, createMarkdownText, dataEnumToText, formatQQContent, markdownRawToText, markdownToText };

package/lib/format.js

@@ -1,10 +1,32 @@
+import { joinMarkdownParts, renderMarkdownBlockquote } from "alemonjs/markdown";
+
 //#region src/format.ts
+/** 群聊、私聊和频道共用有序正文；提及等原生文本由发送上下文提供。 */
+const formatQQContent = (items, renderNative, plain = false, hideUnsupported) => {
+	return items.map((item) => {
+		if (item.type === "Markdown") return plain ? markdownToText(item.value, hideUnsupported) : createMarkdownText(item.value);
+		if (item.type === "MarkdownOriginal") {
+			const text = plain ? markdownRawToText(item.value, hideUnsupported) : item.value;
+			return text ? `\n\n${text}\n\n` : "";
+		}
+		if (item.type === "BT.group") {
+			if (!plain || Number(hideUnsupported) >= 4) return "";
+			const text = item.value.map((row) => row.value.map((button) => {
+				if (Number(hideUnsupported) >= 3) return "";
+				if (Number(hideUnsupported) >= 2) return button.options?.data || button.value;
+				return hideUnsupported ? button.value : `[${button.value}]`;
+			}).filter(Boolean).join(" ")).filter(Boolean).join("\n");
+			return text ? `\n\n${text}\n\n` : "";
+		}
+		return renderNative(item);
+	}).join("");
+};
 /**
 * 将结构化 Markdown 子元素数组转为可读纯文本
 */
 const markdownToText = (items, hideUnsupported) => {
 	if (Number(hideUnsupported) >= 4) return "";
-	return items.map((item) => {
+	return joinMarkdownParts(items, items.map((item) => {
 		switch (item.type) {
 			case "MD.text": return item.value;
 			case "MD.title": return hideUnsupported ? `${item.value}\n` : `【${item.value}】\n`;
@@ -16,6 +38,7 @@ const markdownToText = (items, hideUnsupported) => {
 			case "MD.link": {
 				const v = item.value;
 				if (Number(hideUnsupported) >= 3) return "";
+				if (!v.url) return v.text;
 				return Number(hideUnsupported) >= 2 ? v.url : `${v.text}( ${v.url} )`;
 			}
 			case "MD.image": return hideUnsupported ? "" : "[图片]";
@@ -23,7 +46,7 @@ const markdownToText = (items, hideUnsupported) => {
 				if (typeof li.value === "object") return `${li.value.index}. ${li.value.text ?? ""}`;
 				return `· ${li.value}`;
 			}).join("\n") + "\n";
-			case "MD.blockquote": return `> ${item.value}\n`;
+			case "MD.blockquote": return renderMarkdownBlockquote(item.value, (children) => markdownToText(children, hideUnsupported));
 			case "MD.divider": return hideUnsupported ? "" : "————————\n";
 			case "MD.newline": return "\n";
 			case "MD.code": return item.value;
@@ -37,7 +60,7 @@ const markdownToText = (items, hideUnsupported) => {
 				return hideUnsupported ? String(item.value) : `[${item.value}]`;
 			default: return String(item?.value ?? "");
 		}
-	}).join("");
+	}));
 };
 /**
 * 将按钮组转为可读纯文本
@@ -88,6 +111,47 @@ const dataEnumToText = (item, hideUnsupported) => {
 		default: return "";
 	}
 };
+const mdFormatters = {
+	"MD.title": (value) => `# ${value} `,
+	"MD.subtitle": (value) => `## ${value} `,
+	"MD.text": (value) => `${value} `,
+	"MD.bold": (value) => `**${value}** `,
+	"MD.divider": () => "\n***\n",
+	"MD.italic": (value) => `__${value}__ `,
+	"MD.italicStar": (value) => `*${value}* `,
+	"MD.strikethrough": (value) => `~~${value}~~ `,
+	"MD.blockquote": (value) => renderMarkdownBlockquote(value, createMarkdownText),
+	"MD.newline": () => "\n",
+	"MD.link": (value) => {
+		if (!value?.text && !value?.url) return "";
+		if (!value?.text || !value?.url) return `<${value?.url ?? value?.text}> `;
+		return `[🔗${value?.text}](${value?.url}) `;
+	},
+	"MD.image": (value, options) => `\n![text #${options?.width || 208}px #${options?.height || 320}px](${value})\n`,
+	"MD.mention": (value, options) => {
+		const { belong } = options || {};
+		if (belong === "channel") return "";
+		if (value === "everyone") return "<qqbot-at-everyone />";
+		if (belong === "user") return `<qqbot-at-user id="${value}" />`;
+		return `<qqbot-at-user id="${value}" />`;
+	},
+	"MD.content": (value) => `${value}`,
+	"MD.button": (title, options) => {
+		const { data, autoEnter } = options || {};
+		if (autoEnter) return `<qqbot-cmd-enter text="${data}" show="${title}" />`;
+		return `<qqbot-cmd-input text="${data}" show="${title}" />`;
+	}
+};
+const createMarkdownText = (data) => {
+	return joinMarkdownParts(data, data.map((mdItem) => {
+		if (mdFormatters[mdItem.type]) return mdFormatters[mdItem.type](mdItem?.value, mdItem?.options);
+		if (mdItem.type === "MD.list" && typeof mdItem.value !== "string") return `${mdItem.value.map((listItem) => {
+			return typeof listItem.value === "object" ? `\n${listItem.value.index}. ${listItem.value.text}` : `\n- ${listItem.value}`;
+		}).join("")}\n`;
+		if (mdItem.type === "MD.code") return `\n\`\`\`${mdItem?.options?.language || ""}\n${mdItem.value}\n\`\`\`\n`;
+		return String(mdItem["value"] || "");
+	}));
+};
 
 //#endregion
-export { buttonsToText, dataEnumToText, markdownRawToText, markdownToText };
+export { buttonsToText, createMarkdownText, dataEnumToText, formatQQContent, markdownRawToText, markdownToText };

package/lib/framework-actions.d.ts

@@ -0,0 +1,75 @@
+import { QQBotAPI } from "./sdk/api.js";
+import { OutgoingMessage } from "alemonjs";
+//#region src/framework-actions.d.ts
+declare const toQQMessage: (content: OutgoingMessage) => {
+  msg_type: 0 | 2 | 3 | 7;
+  content: string;
+  markdown: {
+    content: string;
+    custom_template_id: string;
+    template_id: number;
+    params: {
+      key: string;
+      values: string[];
+    }[];
+    force_verify_image_resource: boolean;
+  };
+  media: {
+    file_info: string;
+  };
+  ark: {
+    template_id: number;
+    kv: {
+      key: string;
+      value: string;
+      obj: {
+        obj_kv: {
+          key: string;
+          value: string;
+        }[];
+      }[];
+    }[];
+  };
+  keyboard: {
+    id: string;
+    content: {
+      rows: {
+        buttons: {
+          id: string;
+          group_id: string;
+          render_data: {
+            label: string;
+            visited_label: string;
+            style: number;
+          };
+          action: {
+            type: number;
+            data: string;
+            permission: {
+              type: number;
+              specify_user_ids: string[];
+              specify_role_ids: string[];
+            };
+            enter: boolean;
+            reply: boolean;
+            unsupport_tips: string;
+            anchor: number;
+            click_limit: number;
+            modal: {
+              content: string;
+              confirm_text: string;
+              cancel_text: string;
+            };
+          };
+        }[];
+      }[];
+    };
+  };
+};
+/** Translate semantic framework actions. Undefined means a legacy/channel action. */
+declare const handleFrameworkAction: (client: QQBotAPI, data: {
+  action: string;
+  payload: any;
+}, botId: string) => Promise<import("alemonjs/common").Result<any>[]>;
+//#endregion
+export { handleFrameworkAction, toQQMessage };