alemonjs 2.1.41 → 2.1.42

package/lib/app/message/message-format.js

@@ -0,0 +1,382 @@
+import { BT, MD, Text, Image, Mention, MarkdownOriginal, Attachment, Audio, Video, Link, ImageFile, ImageURL } from './message-format-old.js';
+
+class FormatButtonGroup {
+    #rows = [];
+    #currentRow = null;
+    /**
+     * 获取按钮组数据
+     */
+    get value() {
+        this.#flush();
+        return BT.group(...this.#rows);
+    }
+    /**
+     * 将当前行刷入 rows
+     */
+    #flush() {
+        if (this.#currentRow && this.#currentRow.length > 0) {
+            this.#rows.push(BT.row(...this.#currentRow));
+            this.#currentRow = null;
+        }
+    }
+    /**
+     * 吸收另一个 FormatButtonGroup 的数据
+     * @param group 要吸收的 FormatButtonGroup 实例
+     * @returns 当前实例
+     */
+    absorb(group) {
+        // 如果当前有row且不是空的，则新增一行
+        if (this.#currentRow && this.#currentRow.length > 0) {
+            this.#flush();
+        }
+        // 吸收另一个实例的所有行
+        this.#rows.push(...group.value.value);
+        return this;
+    }
+    /**
+     * 新增一行按钮
+     * @returns 当前实例
+     */
+    addRow() {
+        this.#flush();
+        this.#currentRow = [];
+        return this;
+    }
+    /**
+     * 添加一个按钮到当前行，若无行则自动创建
+     */
+    addButton(...args) {
+        if (!this.#currentRow) {
+            this.#currentRow = [];
+        }
+        this.#currentRow.push(BT(...args));
+        return this;
+    }
+    /**
+     * 清空
+     */
+    clear() {
+        this.#rows = [];
+        this.#currentRow = null;
+        return this;
+    }
+}
+class FormatMarkDown {
+    #data = [];
+    /**
+     * 获取 Markdown 数据
+     */
+    get value() {
+        return MD(...this.#data);
+    }
+    /**
+     * 吸收另一个 FormatMarkDown 的数据
+     * @param md 要吸收的 FormatMarkDown 实例
+     * @returns 当前实例
+     */
+    absorb(md) {
+        this.#data.push(...md.value.value);
+        return this;
+    }
+    /**
+     * 添加原始文本
+     */
+    addContent(...args) {
+        this.#data.push(MD.content(...args));
+        return this;
+    }
+    /**
+     * 添加文本
+     */
+    addText(...args) {
+        this.#data.push(MD.text(...args));
+        return this;
+    }
+    /**
+     * 添加标题
+     */
+    addTitle(...args) {
+        this.#data.push(MD.title(...args));
+        return this;
+    }
+    /**
+     * 添加副标题
+     */
+    addSubtitle(...args) {
+        this.#data.push(MD.subtitle(...args));
+        return this;
+    }
+    /**
+     * 添加粗体
+     */
+    addBold(...args) {
+        this.#data.push(MD.bold(...args));
+        return this;
+    }
+    /**
+     * 添加斜体
+     */
+    addItalic(...args) {
+        this.#data.push(MD.italic(...args));
+        return this;
+    }
+    /**
+     * 添加斜体（星号）
+     */
+    addItalicStar(...args) {
+        this.#data.push(MD.italicStar(...args));
+        return this;
+    }
+    /**
+     * 添加删除线
+     */
+    addStrikethrough(...args) {
+        this.#data.push(MD.strikethrough(...args));
+        return this;
+    }
+    /**
+     * 添加链接
+     */
+    addLink(...args) {
+        this.#data.push(MD.link(...args));
+        return this;
+    }
+    /**
+     * 添加图片
+     */
+    addImage(...args) {
+        this.#data.push(MD.image(...args));
+        return this;
+    }
+    /**
+     * 添加列表
+     */
+    addList(...args) {
+        this.#data.push(MD.list(...args));
+        return this;
+    }
+    /**
+     * 添加引用
+     */
+    addBlockquote(...args) {
+        this.#data.push(MD.blockquote(...args));
+        return this;
+    }
+    /**
+     * 添加分割线
+     */
+    addDivider() {
+        this.#data.push(MD.divider());
+        return this;
+    }
+    /**
+     * 添加换行
+     */
+    addNewline(...args) {
+        this.#data.push(MD.newline(...args));
+        return this;
+    }
+    /**
+     * 添加代码
+     */
+    addCode(...args) {
+        this.#data.push(MD.code(...args));
+        return this;
+    }
+    /**
+     * 换行
+     */
+    addBreak() {
+        this.#data.push(MD.newline());
+        return this;
+    }
+    addMention(...args) {
+        this.#data.push(MD.mention(...args));
+        return this;
+    }
+    addButton(...args) {
+        this.#data.push(MD.button(...args));
+        return this;
+    }
+    /**
+     * 清空
+     */
+    clear() {
+        this.#data = [];
+        return this;
+    }
+}
+/**
+ * 消息格式化构建器
+ *
+ * @example
+ * ```ts
+ * const format = Format.create()
+ * format.addText('hello').addBreak().addText('world')
+ * message.send({ format })
+ * ```
+ */
+class Format {
+    #data = [];
+    /**
+     * 创建一个新的 Format 实例
+     */
+    static create() {
+        return new Format();
+    }
+    /**
+     * 创建一个新的 Markdown Format 实例
+     */
+    static createMarkdown() {
+        return new FormatMarkDown();
+    }
+    /**
+     * 创建一个新的 Button Format 实例
+     */
+    static createButtonGroup() {
+        return new FormatButtonGroup();
+    }
+    /**
+     * 获取内部格式化数据
+     */
+    get value() {
+        return this.#data;
+    }
+    absorb(format) {
+        this.#data.push(...format.value);
+        return this;
+    }
+    /**
+     * 添加文本
+     */
+    addText(...args) {
+        this.#data.push(Text(...args));
+        return this;
+    }
+    /**
+     * 添加图片 (Buffer 或带协议字符串)
+     */
+    addImage(...args) {
+        this.#data.push(Image(...args));
+        return this;
+    }
+    /**
+     * 添加提及
+     */
+    addMention(...args) {
+        this.#data.push(Mention(...args));
+        return this;
+    }
+    addButtonGroup(...args) {
+        if (args[0] instanceof FormatButtonGroup) {
+            this.#data.push(args[0].value);
+        }
+        else {
+            this.#data.push(BT.group(...args));
+        }
+        return this;
+    }
+    addMarkdown(...args) {
+        if (args[0] instanceof FormatMarkDown) {
+            this.#data.push(args[0].value);
+        }
+        else {
+            this.#data.push(MD(...args));
+        }
+        return this;
+    }
+    /**
+     * 添加纯 Markdown 文本
+     */
+    addMarkdownOriginal(...args) {
+        this.#data.push(MarkdownOriginal(...args));
+        return this;
+    }
+    /**
+     * 添加附件
+     */
+    addAttachment(...args) {
+        this.#data.push(Attachment(...args));
+        return this;
+    }
+    /**
+     * 添加音频
+     */
+    addAudio(...args) {
+        this.#data.push(Audio(...args));
+        return this;
+    }
+    /**
+     * 添加视频
+     */
+    addVideo(...args) {
+        this.#data.push(Video(...args));
+        return this;
+    }
+    /**
+     * 添加链接
+     * @deprecated 废弃，这个应该是md语法里的
+     */
+    addLink(...args) {
+        this.#data.push(Link(...args));
+        return this;
+    }
+    /**
+     * 添加图片文件
+     * @deprecated 废弃，推荐使用 addImage
+     */
+    addImageFile(...args) {
+        this.#data.push(ImageFile(...args));
+        return this;
+    }
+    /**
+     * 添加图片链接
+     * @deprecated 废弃，推荐使用 addImage
+     */
+    addImageURL(...args) {
+        this.#data.push(ImageURL(...args));
+        return this;
+    }
+    /**
+     * 清空
+     */
+    clear() {
+        this.#data = [];
+        return this;
+    }
+}
+/**
+ * 创建event
+ * @param options
+ * @returns
+ */
+function createEvent(options) {
+    const { event, selects, regular, prefix, exact } = options;
+    const { name, MessageText } = event || {};
+    const selectsArr = Array.isArray(selects) ? selects : [selects];
+    const o = {
+        selects: false,
+        regular: false,
+        prefix: false,
+        exact: false
+    };
+    // 匹配选择事件类型
+    if (selectsArr.includes(name)) {
+        o.selects = true;
+    }
+    // 精准匹配
+    if (exact && MessageText && MessageText === exact) {
+        o.exact = true;
+    }
+    // 前缀匹配
+    if (prefix && MessageText?.startsWith(prefix)) {
+        o.prefix = true;
+    }
+    // 正则匹配
+    if (regular && MessageText && new RegExp(regular).test(MessageText)) {
+        o.regular = true;
+    }
+    return { ...event, ...o };
+}
+
+export { Format, FormatButtonGroup, FormatMarkDown, createEvent };

package/lib/app/message-api.d.ts

@@ -1,5 +1,6 @@
 import { DataEnums, OnDataFormatFunc } from '../types';
 import { Result } from '../core';
+import { Format } from './message-format';
 type BaseMap = {
     [key: string]: unknown;
 };
@@ -8,6 +9,18 @@ export declare const createEventValue: <T extends keyof R, R extends BaseMap>(ev
 }) => R[T];
 export declare const format: OnDataFormatFunc;
 export declare const createDataFormat: OnDataFormatFunc;
+export declare class MessageDirect {
+    static create(): MessageDirect;
+    sendToChannel(params: {
+        SpaceId: string;
+        format: Format;
+        replyId?: string;
+    }): Promise<Result[]>;
+    sendToUser(params: {
+        OpenID: string;
+        format: Format;
+    }): Promise<Result[]>;
+}
 export declare const sendToChannel: (SpaceId: string, data: DataEnums[]) => Promise<Result[]>;
 export declare const sendToUser: (OpenID: string, data: DataEnums[]) => Promise<Result[]>;
 type IntentResult = {

package/lib/app/message-api.js

@@ -21,6 +21,52 @@ const format = (...data) => {
 };
 global.format = format;
 const createDataFormat = format;
+class MessageDirect {
+    static create() {
+        return new MessageDirect();
+    }
+    async sendToChannel(params) {
+        if (!params.SpaceId || typeof params.SpaceId !== 'string') {
+            logger.error({
+                code: ResultCode.FailParams,
+                message: 'Invalid SpaceId: SpaceId must be a string',
+                data: null
+            });
+            throw new Error('Invalid SpaceId: SpaceId must be a string');
+        }
+        return await sendAction({
+            action: 'message.send.channel',
+            payload: {
+                ChannelId: params.SpaceId,
+                params: {
+                    format: params.format.value,
+                    replyId: params?.replyId
+                }
+            }
+        });
+    }
+    ;
+    async sendToUser(params) {
+        if (!params.OpenID || typeof params.OpenID !== 'string') {
+            logger.error({
+                code: ResultCode.FailParams,
+                message: 'Invalid OpenID: OpenID must be a string',
+                data: null
+            });
+            throw new Error('Invalid OpenID: OpenID must be a string');
+        }
+        return await sendAction({
+            action: 'message.send.user',
+            payload: {
+                UserId: params.OpenID,
+                params: {
+                    format: params.format.value
+                }
+            }
+        });
+    }
+    ;
+}
 const sendToChannel = async (SpaceId, data) => {
     if (!SpaceId || typeof SpaceId !== 'string') {
         logger.error({
@@ -67,4 +113,4 @@ const getMessageIntent = async () => {
     return createResult(ResultCode.Ok, '获取成功', results[0]?.data ?? null);
 };
 
-export { createDataFormat, createEventValue, format, getMessageIntent, sendToChannel, sendToUser };
+export { MessageDirect, createDataFormat, createEventValue, format, getMessageIntent, sendToChannel, sendToUser };

package/lib/app/message-format.old.d.ts

@@ -0,0 +1,50 @@
+import { DataMention, DataImage, DataText, DataImageURL, DataImageFile, ButtonRow, DataButtonGroup, DataButton, DataArkList, DataArkListTip, DataArkListContent, DataArkListItem, DataArkCard, DataArkBigCard, DataMarkdownTemplate, DataMarkDown, DataMarkdownTitle, DataMarkdownSubtitle, DataMarkdownBold, DataMarkdownItalic, DataMarkdownItalicStar, DataMarkdownStrikethrough, DataMarkdownLink, DataMarkdownImage, DataMarkdownList, DataMarkdownListItem, DataMarkdownBlockquote, DataMarkdownDivider, DataMarkdownNewline, DataLink, DataMarkdownText, DataButtonTemplate, DataMarkdownCode } from '../types';
+export declare const Text: (val: DataText["value"], options?: DataText["options"]) => DataText;
+export declare const Link: (val: DataLink["value"], options?: DataText["options"]) => DataText;
+export declare const ImageURL: (val: DataImageURL["value"]) => DataImageURL;
+export declare const ImageFile: (val: DataImageFile["value"]) => DataImageFile;
+declare const Image: {
+    (val: Buffer): DataImage;
+    url: (val: DataImageURL["value"]) => DataImageURL;
+    file: (val: DataImageFile["value"]) => DataImageFile;
+};
+export { Image };
+export declare const Mention: (UserId?: DataMention["value"], options?: DataMention["options"]) => DataMention;
+declare const BT: {
+    (title: string, data: DataButton["options"]["data"], options?: Omit<DataButton["options"], "data">): DataButton;
+    group(...rows: ButtonRow[]): DataButtonGroup;
+    template(templateId: DataButtonTemplate["value"]): DataButtonTemplate;
+    row(...buttons: DataButton[]): ButtonRow;
+};
+export { BT };
+export declare const Ark: {
+    list: (values_0: DataArkListTip, values_1: DataArkListContent) => DataArkList;
+    listTip: (options: DataArkListTip["value"]) => DataArkListTip;
+    listContent: (...values: DataArkListContent["value"]) => DataArkListContent;
+    listItem: (value: DataArkListItem["value"]) => DataArkListItem;
+    Card: (value: DataArkCard["value"]) => DataArkCard;
+    BigCard: (value: DataArkBigCard["value"]) => DataArkBigCard;
+};
+declare const MD: {
+    (...values: DataMarkDown["value"]): DataMarkDown;
+    template(templateId: DataMarkdownTemplate["value"], params?: DataMarkdownTemplate["options"]["params"]): DataMarkdownTemplate;
+    text(text: string): DataMarkdownText;
+    title(text: string): DataMarkdownTitle;
+    subtitle(text: string): DataMarkdownSubtitle;
+    bold(text: string): DataMarkdownBold;
+    italic(text: string): DataMarkdownItalic;
+    italicStar(text: string): DataMarkdownItalicStar;
+    strikethrough(text: string): DataMarkdownStrikethrough;
+    link(text: string, url: string): DataMarkdownLink;
+    image(url: string, options?: {
+        width?: number;
+        height?: number;
+    }): DataMarkdownImage;
+    list(...items: any[]): DataMarkdownList;
+    listItem(indexOrText: number | string, text?: string): DataMarkdownListItem;
+    blockquote(text: string): DataMarkdownBlockquote;
+    divider(): DataMarkdownDivider;
+    newline(value?: boolean): DataMarkdownNewline;
+    code(value: DataMarkdownCode["value"], options?: DataMarkdownCode["options"]): DataMarkdownCode;
+};
+export { MD };