chatboty 0.1.0

package/dist/esm/src/entity/contact.js

@@ -0,0 +1,30 @@
+import { ContactType } from '../types.js';
+/** 联系人实体(含外部客户)。 */
+export class Contact {
+    constructor(bot, payload) {
+        this.bot = bot;
+        this.payload = payload;
+    }
+    id() { return this.payload.id; }
+    name() { return this.payload.name ?? ''; }
+    alias() { return this.payload.alias; }
+    avatar() { return this.payload.avatar; }
+    phone() { return this.payload.phone; }
+    title() { return this.payload.title; }
+    /**
+     * 联系人类别。企微通讯录成员/外部客户都是真人 → 默认 {@link ContactType.Individual}。
+     * (企微不存在微信式"公众号/服务号", 且探针未采集"应用号/机器人"标志, 故不臆造 Official。)
+     */
+    type() { return this.payload.type ?? ContactType.Individual; }
+    /** 单聊会话 id(发消息目标)。 */
+    conversationId() { return this.payload.conversationId; }
+    /** 给该联系人发消息(单聊)。 */
+    async say(sayable) {
+        const conv = this.payload.conversationId;
+        if (!conv)
+            throw new Error(`Contact ${this.id()} 无单聊会话 id, 无法发送`);
+        return this.bot.sayTo(conv, sayable);
+    }
+    toString() { return `Contact<${this.name() || this.id()}>`; }
+}
+//# sourceMappingURL=contact.js.map

package/dist/esm/src/entity/contact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.js","sourceRoot":"","sources":["../../../../src/entity/contact.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,oBAAoB;AACpB,MAAM,OAAO,OAAO;IAClB,YAA8B,GAAW,EAAW,OAAuB;QAA7C,QAAG,GAAH,GAAG,CAAQ;QAAW,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAE/E,EAAE,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAA,CAAC,CAAC;IACxC,IAAI,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAA,CAAC,CAAC;IAClD,KAAK,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA,CAAC,CAAC;IAC1D,MAAM,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA,CAAC,CAAC;IAC5D,KAAK,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA,CAAC,CAAC;IAC1D,KAAK,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA,CAAC,CAAC;IAE1D;;;OAGG;IACH,IAAI,KAAmB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,UAAU,CAAA,CAAC,CAAC;IAE3E,sBAAsB;IACtB,cAAc,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAA,CAAC,CAAC;IAE5E,oBAAoB;IACpB,KAAK,CAAC,GAAG,CAAE,OAAgB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAA;QACxC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAA;QACjE,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,QAAQ,KAAc,OAAO,WAAW,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAA,CAAC,CAAC;CACtE"}

package/dist/esm/src/entity/friendship.d.ts

@@ -0,0 +1,13 @@
+import type { BotApi, FriendshipPayload, FriendshipKind } from '../types.js';
+import { Contact } from './contact.js';
+/** 好友关系事件实体。 */
+export declare class Friendship {
+    private readonly bot;
+    readonly payload: FriendshipPayload;
+    constructor(bot: BotApi, payload: FriendshipPayload);
+    kind(): FriendshipKind;
+    hello(): string | undefined;
+    contact(): Contact;
+    toString(): string;
+}
+//# sourceMappingURL=friendship.d.ts.map

package/dist/esm/src/entity/friendship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friendship.d.ts","sourceRoot":"","sources":["../../../../src/entity/friendship.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,gBAAgB;AAChB,qBAAa,UAAU;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,QAAQ,CAAC,OAAO,EAAE,iBAAiB;gBAAhD,GAAG,EAAE,MAAM,EAAW,OAAO,EAAE,iBAAiB;IAE9E,IAAI,IAAK,cAAc;IACvB,KAAK,IAAK,MAAM,GAAG,SAAS;IAE5B,OAAO,IAAK,OAAO;IAInB,QAAQ,IAAK,MAAM;CACpB"}

package/dist/esm/src/entity/friendship.js

@@ -0,0 +1,15 @@
+import { Contact } from './contact.js';
+/** 好友关系事件实体。 */
+export class Friendship {
+    constructor(bot, payload) {
+        this.bot = bot;
+        this.payload = payload;
+    }
+    kind() { return this.payload.kind; }
+    hello() { return this.payload.hello; }
+    contact() {
+        return new Contact(this.bot, this.payload.contact ?? { id: this.payload.contactId });
+    }
+    toString() { return `Friendship<${this.kind()}:${this.payload.contactId}>`; }
+}
+//# sourceMappingURL=friendship.js.map

package/dist/esm/src/entity/friendship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friendship.js","sourceRoot":"","sources":["../../../../src/entity/friendship.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,gBAAgB;AAChB,MAAM,OAAO,UAAU;IACrB,YAA8B,GAAW,EAAW,OAA0B;QAAhD,QAAG,GAAH,GAAG,CAAQ;QAAW,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAElF,IAAI,KAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA,CAAC,CAAC;IACpD,KAAK,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA,CAAC,CAAC;IAE1D,OAAO;QACL,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,QAAQ,KAAc,OAAO,cAAc,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,CAAA,CAAC,CAAC;CACtF"}

package/dist/esm/src/entity/message.d.ts

@@ -0,0 +1,61 @@
+import type { BotApi, MessagePayload, Sayable, FileBox } from '../types.js';
+import { MessageType } from '../types.js';
+import { Contact } from './contact.js';
+import { Room } from './room.js';
+/** 消息实体。 */
+export declare class Message {
+    private readonly bot;
+    readonly payload: MessagePayload;
+    constructor(bot: BotApi, payload: MessagePayload);
+    id(): string | undefined;
+    type(): MessageType;
+    text(): string;
+    self(): boolean;
+    timestamp(): number | undefined;
+    file(): FileBox | null | undefined;
+    miniProgram(): Record<string, any> | null | undefined;
+    urlLink(): Record<string, any> | null | undefined;
+    /** 发送者(完整 Contact; 群消息识别客户用)。 */
+    talker(): Contact | undefined;
+    /** 所在群(单聊为 undefined)。 */
+    room(): Room | undefined;
+    /** 回复到原会话(群消息回群, 单聊回该人)。 */
+    say(sayable: Sayable): Promise<any>;
+    /**
+     * 从消息正文解析出的 @ 提及显示名(不含 "@所有人"/"@all")。
+     * 说明: 企微群 @ 消息正文形如 `@张三 内容`, 名字后接普通空格或 U+2005(four-per-em space)分隔。
+     * 这是"从消息 payload 解析"的诚实实现——只用真实的正文文本; 结构化的被@ vid 需进一步逆向(见 RE 计划)。
+     */
+    private mentionNames;
+    /**
+     * 消息中被 @ 的联系人列表(best-effort)。
+     * 先从正文解析出 @显示名, 再用一次 contactList 拉全量通讯录按 name/alias 就近解析成完整 Contact;
+     * 未在已加载通讯录中的成员回退为仅含名字的 Contact(其 id() 为空串)。
+     * @returns 被 @ 的 Contact 数组(无 @ 时为空数组)。
+     */
+    mentionList(): Promise<Contact[]>;
+    /**
+     * 本条消息是否 @ 了当前登录者(self)或 @所有人。
+     * 判定: 正文含 `@所有人`/`@all`(全体含自己) → true; 或含 `@{self 显示名}` → true。
+     * (纯本机文本判定, 不发起网络请求; 依赖 bot 已知 self 名。)
+     */
+    mentionSelf(): boolean;
+    private toFileBoxFromResult;
+    /**
+     * 取本条消息的媒体/文件字节(图片/文件/音视频), 返回 {@link FileBox}(含 base64 data URL)。
+     * - 收到的图片/文件事件通常已附带 file(探针后台已下载解密) → 直接返回。
+     * - 否则按类型冷调探针下载: 图片走 downloadImage, 文件/音视频走 downloadFile(按 msgid+会话+文件名定位缓存)。
+     * @returns FileBox(dataUrl/mime/name/size); 非媒体消息或下载失败返回 null。
+     */
+    toFileBox(): Promise<FileBox | null>;
+    /** {@link toFileBox} 的别名(下载本条消息的媒体字节)。 */
+    download(): Promise<FileBox | null>;
+    /**
+     * 转发本条消息到另一会话(群/单聊 conversationId, 或 Room/Contact)。
+     * ⚠️ 未实现: 企微转发需逆向定位并冷调"转发消息"服务(见 puppet-wework 交付说明的 RE 计划)。
+     * 当前会抛错, 以免静默失败。
+     */
+    forward(_to: string | Room | Contact): Promise<never>;
+    toString(): string;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/esm/src/entity/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../src/entity/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,YAAY;AACZ,qBAAa,OAAO;IACL,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,QAAQ,CAAC,OAAO,EAAE,cAAc;gBAA7C,GAAG,EAAE,MAAM,EAAW,OAAO,EAAE,cAAc;IAE3E,EAAE,IAAK,MAAM,GAAG,SAAS;IACzB,IAAI,IAAK,WAAW;IACpB,IAAI,IAAK,MAAM;IACf,IAAI,IAAK,OAAO;IAChB,SAAS,IAAK,MAAM,GAAG,SAAS;IAChC,IAAI,IAAK,OAAO,GAAG,IAAI,GAAG,SAAS;IACnC,WAAW,IAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;IACtD,OAAO,IAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;IAElD,iCAAiC;IACjC,MAAM,IAAK,OAAO,GAAG,SAAS;IAM9B,0BAA0B;IAC1B,IAAI,IAAK,IAAI,GAAG,SAAS;IAIzB,4BAA4B;IACtB,GAAG,CAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAO1C;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;OAKG;IACG,WAAW,IAAK,OAAO,CAAC,OAAO,EAAE,CAAC;IAoBxC;;;;OAIG;IACH,WAAW,IAAK,OAAO;IAUvB,OAAO,CAAC,mBAAmB;IAO3B;;;;;OAKG;IACG,SAAS,IAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAqB3C,0CAA0C;IACpC,QAAQ,IAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI1C;;;;OAIG;IACG,OAAO,CAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAI5D,QAAQ,IAAK,MAAM;CACpB"}

package/dist/esm/src/entity/message.js

@@ -0,0 +1,146 @@
+import { MessageType } from '../types.js';
+import { Contact } from './contact.js';
+import { Room } from './room.js';
+/** 消息实体。 */
+export class Message {
+    constructor(bot, payload) {
+        this.bot = bot;
+        this.payload = payload;
+    }
+    id() { return this.payload.id; }
+    type() { return this.payload.type; }
+    text() { return this.payload.text ?? ''; }
+    self() { return !!this.payload.self; }
+    timestamp() { return this.payload.timestamp; }
+    file() { return this.payload.file; }
+    miniProgram() { return this.payload.miniProgram; }
+    urlLink() { return this.payload.urlLink; }
+    /** 发送者(完整 Contact; 群消息识别客户用)。 */
+    talker() {
+        if (this.payload.talker)
+            return new Contact(this.bot, this.payload.talker);
+        if (this.payload.talkerId)
+            return new Contact(this.bot, { id: this.payload.talkerId });
+        return undefined;
+    }
+    /** 所在群(单聊为 undefined)。 */
+    room() {
+        return this.payload.roomId ? new Room(this.bot, { id: this.payload.roomId }) : undefined;
+    }
+    /** 回复到原会话(群消息回群, 单聊回该人)。 */
+    async say(sayable) {
+        const target = this.payload.roomId || this.payload.conversationId;
+        return this.bot.sayTo(target, sayable);
+    }
+    /* ---------------- @ 提及 ---------------- */
+    /**
+     * 从消息正文解析出的 @ 提及显示名(不含 "@所有人"/"@all")。
+     * 说明: 企微群 @ 消息正文形如 `@张三 内容`, 名字后接普通空格或 U+2005(four-per-em space)分隔。
+     * 这是"从消息 payload 解析"的诚实实现——只用真实的正文文本; 结构化的被@ vid 需进一步逆向(见 RE 计划)。
+     */
+    mentionNames() {
+        const text = this.payload.text ?? '';
+        if (!text.includes('@'))
+            return [];
+        const out = [];
+        const re = /@([^\s @]+)/g;
+        let m;
+        while ((m = re.exec(text)) !== null) {
+            const n = m[1];
+            if (n && n !== '所有人' && n.toLowerCase() !== 'all')
+                out.push(n);
+        }
+        return out;
+    }
+    /**
+     * 消息中被 @ 的联系人列表(best-effort)。
+     * 先从正文解析出 @显示名, 再用一次 contactList 拉全量通讯录按 name/alias 就近解析成完整 Contact;
+     * 未在已加载通讯录中的成员回退为仅含名字的 Contact(其 id() 为空串)。
+     * @returns 被 @ 的 Contact 数组(无 @ 时为空数组)。
+     */
+    async mentionList() {
+        const names = this.mentionNames();
+        if (names.length === 0)
+            return [];
+        let pool = [];
+        try {
+            const r = await this.bot.command('contactList');
+            pool = (r && (r.contacts || r.list || (Array.isArray(r) ? r : []))) || [];
+        }
+        catch { /* 解析失败不致命: 退回仅名字的 Contact */ }
+        return names.map((nm) => {
+            const u = pool.find((x) => x && (x.name === nm || x.alias === nm || x.realName === nm));
+            if (u) {
+                return new Contact(this.bot, {
+                    id: u.userId ?? u.id ?? '', name: u.name ?? u.realName, alias: u.alias, avatar: u.avatar,
+                    phone: u.phone, title: u.title, corpId: u.corpId, unionId: u.unionId, conversationId: u.conversationId,
+                });
+            }
+            return new Contact(this.bot, { id: '', name: nm });
+        });
+    }
+    /**
+     * 本条消息是否 @ 了当前登录者(self)或 @所有人。
+     * 判定: 正文含 `@所有人`/`@all`(全体含自己) → true; 或含 `@{self 显示名}` → true。
+     * (纯本机文本判定, 不发起网络请求; 依赖 bot 已知 self 名。)
+     */
+    mentionSelf() {
+        const text = this.payload.text ?? '';
+        if (!text.includes('@'))
+            return false;
+        if (/@所有人|@all\b/i.test(text))
+            return true;
+        const selfName = this.bot.selfContact?.()?.name;
+        return !!selfName && this.mentionNames().includes(selfName);
+    }
+    /* ---------------- 媒体下载 ---------------- */
+    toFileBoxFromResult(r) {
+        if (!r)
+            return null;
+        const dataUrl = r.dataUrl || r.base64;
+        if (!dataUrl)
+            return null;
+        return { dataUrl, mime: r.mime, name: r.name, size: r.size };
+    }
+    /**
+     * 取本条消息的媒体/文件字节(图片/文件/音视频), 返回 {@link FileBox}(含 base64 data URL)。
+     * - 收到的图片/文件事件通常已附带 file(探针后台已下载解密) → 直接返回。
+     * - 否则按类型冷调探针下载: 图片走 downloadImage, 文件/音视频走 downloadFile(按 msgid+会话+文件名定位缓存)。
+     * @returns FileBox(dataUrl/mime/name/size); 非媒体消息或下载失败返回 null。
+     */
+    async toFileBox() {
+        if (this.payload.file)
+            return this.payload.file;
+        const msgid = this.payload.id;
+        if (!msgid)
+            return null;
+        const t = this.payload.type;
+        if (t === MessageType.Image) {
+            const r = await this.bot.command('downloadImage', { msgid });
+            return this.toFileBoxFromResult(r);
+        }
+        if (t === MessageType.File || t === MessageType.Video || t === MessageType.Audio) {
+            const r = await this.bot.command('downloadFile', {
+                msgid,
+                conversationId: this.payload.conversationId,
+                timestamp: this.payload.timestamp,
+                name: this.payload.text,
+            });
+            return this.toFileBoxFromResult(r);
+        }
+        return null;
+    }
+    /** {@link toFileBox} 的别名(下载本条消息的媒体字节)。 */
+    async download() { return this.toFileBox(); }
+    /* ---------------- 转发(RE 待定) ---------------- */
+    /**
+     * 转发本条消息到另一会话(群/单聊 conversationId, 或 Room/Contact)。
+     * ⚠️ 未实现: 企微转发需逆向定位并冷调"转发消息"服务(见 puppet-wework 交付说明的 RE 计划)。
+     * 当前会抛错, 以免静默失败。
+     */
+    async forward(_to) {
+        throw new Error('Message.forward 未实现: 需逆向定位企微转发消息服务(ForwardMessage), 见 RE 计划');
+    }
+    toString() { return `Message<${MessageType[this.type()]}:${this.text().slice(0, 30)}>`; }
+}
+//# sourceMappingURL=message.js.map

package/dist/esm/src/entity/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../../src/entity/message.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/entity/room.d.ts

@@ -0,0 +1,21 @@
+import type { BotApi, RoomPayload, Sayable } from '../types.js';
+import { Contact } from './contact.js';
+/** 群实体。 */
+export declare class Room {
+    private readonly bot;
+    readonly payload: RoomPayload;
+    constructor(bot: BotApi, payload: RoomPayload);
+    id(): string;
+    topic(): string | undefined;
+    ownerId(): string | undefined;
+    /** 群发消息。 */
+    say(sayable: Sayable): Promise<any>;
+    /** 改群名(冷改, 内外群通用)。 */
+    rename(topic: string): Promise<any>;
+    /** 群成员(完整 Contact 对象; 受探针成员枚举局限)。 */
+    memberAll(): Promise<Contact[]>;
+    /** 群主(若可解析)。 */
+    owner(): Promise<Contact | undefined>;
+    toString(): string;
+}
+//# sourceMappingURL=room.d.ts.map

package/dist/esm/src/entity/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../../../src/entity/room.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,WAAW;AACX,qBAAa,IAAI;IACF,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,QAAQ,CAAC,OAAO,EAAE,WAAW;gBAA1C,GAAG,EAAE,MAAM,EAAW,OAAO,EAAE,WAAW;IAExE,EAAE,IAAK,MAAM;IACb,KAAK,IAAK,MAAM,GAAG,SAAS;IAC5B,OAAO,IAAK,MAAM,GAAG,SAAS;IAE9B,YAAY;IACN,GAAG,CAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAI1C,sBAAsB;IAChB,MAAM,CAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI1C,qCAAqC;IAC/B,SAAS,IAAK,OAAO,CAAC,OAAO,EAAE,CAAC;IAUtC,gBAAgB;IACV,KAAK,IAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAO5C,QAAQ,IAAK,MAAM;CACpB"}

package/dist/esm/src/entity/room.js

@@ -0,0 +1,39 @@
+import { Contact } from './contact.js';
+/** 群实体。 */
+export class Room {
+    constructor(bot, payload) {
+        this.bot = bot;
+        this.payload = payload;
+    }
+    id() { return this.payload.id; }
+    topic() { return this.payload.topic; }
+    ownerId() { return this.payload.ownerId; }
+    /** 群发消息。 */
+    async say(sayable) {
+        return this.bot.sayTo(this.payload.id, sayable);
+    }
+    /** 改群名(冷改, 内外群通用)。 */
+    async rename(topic) {
+        return this.bot.command('roomTopic', { conversationId: this.payload.id, topic });
+    }
+    /** 群成员(完整 Contact 对象; 受探针成员枚举局限)。 */
+    async memberAll() {
+        const r = await this.bot.command('roomMembers', { conversationId: this.payload.id });
+        const list = (r && (r.memberList || []));
+        return list.map((u) => new Contact(this.bot, {
+            id: u.userId, name: u.name, alias: u.alias, avatar: u.avatar,
+            phone: u.phone, title: u.title, corpId: u.corpId, unionId: u.unionId,
+            conversationId: u.conversationId,
+        }));
+    }
+    /** 群主(若可解析)。 */
+    async owner() {
+        const r = await this.bot.command('roomMembers', { conversationId: this.payload.id });
+        const u = r && r.ownerUser;
+        if (!u || !u.userId)
+            return undefined;
+        return new Contact(this.bot, { id: u.userId, name: u.name, alias: u.alias, avatar: u.avatar, conversationId: u.conversationId });
+    }
+    toString() { return `Room<${this.topic() || this.id()}>`; }
+}
+//# sourceMappingURL=room.js.map

package/dist/esm/src/entity/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../../../src/entity/room.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,WAAW;AACX,MAAM,OAAO,IAAI;IACf,YAA8B,GAAW,EAAW,OAAoB;QAA1C,QAAG,GAAH,GAAG,CAAQ;QAAW,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IAE5E,EAAE,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAA,CAAC,CAAC;IACxC,KAAK,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA,CAAC,CAAC;IAC1D,OAAO,KAA0B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAA,CAAC,CAAC;IAE9D,YAAY;IACZ,KAAK,CAAC,GAAG,CAAE,OAAgB;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,MAAM,CAAE,KAAa;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IAClF,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,SAAS;QACb,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QACpF,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAU,CAAA;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM;YAC5D,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO;YACpE,cAAc,EAAE,CAAC,CAAC,cAAc;SACjC,CAAC,CAAC,CAAA;IACL,CAAC;IAED,gBAAgB;IAChB,KAAK,CAAC,KAAK;QACT,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QACpF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAA;QAC1B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QACrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAA;IAClI,CAAC;IAED,QAAQ,KAAc,OAAO,QAAQ,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAA,CAAC,CAAC;CACpE"}

package/dist/esm/src/mod.d.ts

@@ -0,0 +1,17 @@
+/**
+ * chatboty 公共入口。自研 IM 自动化框架(企业微信), 零外部框架依赖。
+ *
+ *   import { Chatboty } from 'chatboty'
+ *   const bot = new Chatboty({ token: 'cbt_...' })
+ *   bot.on('message', m => { if (!m.self()) m.say('收到: ' + m.text()) })
+ *   await bot.start()
+ */
+export { Chatboty, type ChatbotyOptions } from './chatboty.js';
+export { ChatbotyClient, type ChatbotyClientOptions, type EventHandler } from './client.js';
+export { Message } from './entity/message.js';
+export { Contact } from './entity/contact.js';
+export { Room } from './entity/room.js';
+export { Friendship } from './entity/friendship.js';
+export * from './types.js';
+export { Chatboty as default } from './chatboty.js';
+//# sourceMappingURL=mod.d.ts.map

package/dist/esm/src/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAE3F,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,cAAc,YAAY,CAAA;AAE1B,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/esm/src/mod.js

@@ -0,0 +1,17 @@
+/**
+ * chatboty 公共入口。自研 IM 自动化框架(企业微信), 零外部框架依赖。
+ *
+ *   import { Chatboty } from 'chatboty'
+ *   const bot = new Chatboty({ token: 'cbt_...' })
+ *   bot.on('message', m => { if (!m.self()) m.say('收到: ' + m.text()) })
+ *   await bot.start()
+ */
+export { Chatboty } from './chatboty.js';
+export { ChatbotyClient } from './client.js';
+export { Message } from './entity/message.js';
+export { Contact } from './entity/contact.js';
+export { Room } from './entity/room.js';
+export { Friendship } from './entity/friendship.js';
+export * from './types.js';
+export { Chatboty as default } from './chatboty.js';
+//# sourceMappingURL=mod.js.map

package/dist/esm/src/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAiD,MAAM,aAAa,CAAA;AAE3F,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,cAAc,YAAY,CAAA;AAE1B,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/esm/src/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * chatboty 自研类型(零外部框架依赖)。这些 payload 是实体类的数据底座,
+ * 由网关下发的 wire 事件/命令结果映射而来。
+ */
+/** 消息类型。 */
+export declare enum MessageType {
+    Unknown = 0,
+    Text = 1,
+    Image = 2,
+    Audio = 3,
+    Video = 4,
+    File = 5,
+    Url = 6,// 链接卡片
+    MiniProgram = 7,
+    System = 8
+}
+/**
+ * 联系人类别。企微现实: 通讯录里都是"真人"(个人/同事/外部客户), 没有微信那种"公众号/服务号"构造,
+ * 故探针默认给 Individual。Official/Corporation 预留给未来能可靠区分"应用/机器人/企业主体"时使用。
+ */
+export declare enum ContactType {
+    Unknown = 0,
+    Individual = 1,// 真人(默认; 企微通讯录成员/外部客户)
+    Official = 2,// 应用/机器人号(企微暂无可靠信号, 预留)
+    Corporation = 3
+}
+/** 联系人(含外部客户)。 */
+export interface ContactPayload {
+    id: string;
+    name?: string;
+    alias?: string;
+    avatar?: string;
+    phone?: string;
+    title?: string;
+    corpId?: string;
+    unionId?: string;
+    conversationId?: string;
+    type?: ContactType;
+}
+/** Contact.find/findAll 查询条件: 关键词字符串, 或按字段精确匹配。 */
+export type ContactQueryFilter = string | {
+    name?: string;
+    alias?: string;
+    id?: string;
+};
+/** 群。 */
+export interface RoomPayload {
+    id: string;
+    topic?: string;
+    ownerId?: string;
+    memberIdList?: string[];
+}
+/** 媒体附件(图片/文件)。 */
+export interface FileBox {
+    dataUrl?: string;
+    mime?: string;
+    name?: string;
+    size?: number;
+}
+/** 消息。 */
+export interface MessagePayload {
+    id?: string;
+    type: MessageType;
+    text?: string;
+    talkerId?: string;
+    roomId?: string;
+    conversationId: string;
+    timestamp?: number;
+    self?: boolean;
+    talker?: ContactPayload;
+    file?: FileBox | null;
+    miniProgram?: Record<string, any> | null;
+    urlLink?: Record<string, any> | null;
+}
+/** 好友关系事件。 */
+export type FriendshipKind = 'receive' | 'confirm' | 'add' | 'delete';
+export interface FriendshipPayload {
+    contactId: string;
+    contact?: ContactPayload;
+    kind: FriendshipKind;
+    hello?: string;
+}
+/** 群事件(成员变动/改名) payload。 */
+export interface RoomMemberEventPayload {
+    roomId: string;
+    idList: string[];
+    contactList?: ContactPayload[];
+    operatorId?: string | null;
+    timestamp?: number;
+}
+export interface RoomTopicEventPayload {
+    roomId: string;
+    topic?: string;
+    oldTopic?: string;
+    changerId?: string | null;
+    timestamp?: number;
+}
+/** 可发送内容。文本=字符串; 媒体=带类型的对象(路径/URL/base64 由探针侧解析)。 */
+export type Sayable = string | {
+    image: string;
+} | {
+    file: string;
+} | {
+    url: string;
+    title?: string;
+    description?: string;
+    thumbUrl?: string;
+} | {
+    miniProgram: Record<string, any>;
+};
+/** 实体类回引 bot 的最小接口(避免循环依赖)。Chatboty 主类实现之。 */
+export interface BotApi {
+    command(cmd: string, args?: Record<string, any>): Promise<any>;
+    sayTo(conversationId: string, sayable: Sayable): Promise<any>;
+    /** 当前登录者(self)payload(供 Message.mentionSelf 等做本机判定); 未就绪时 undefined。 */
+    selfContact?(): ContactPayload | undefined;
+}
+/** 会话 id 类型判定(R: 群 / S: 单聊 / 其它)。 */
+export declare function isRoomId(conversationId?: string): boolean;
+/** wire 事件里的字符串/数字消息类型 → MessageType。 */
+export declare function toMessageType(typeStr?: string, typeRaw?: number): MessageType;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/types.js

@@ -0,0 +1,50 @@
+/**
+ * chatboty 自研类型(零外部框架依赖)。这些 payload 是实体类的数据底座,
+ * 由网关下发的 wire 事件/命令结果映射而来。
+ */
+/** 消息类型。 */
+export var MessageType;
+(function (MessageType) {
+    MessageType[MessageType["Unknown"] = 0] = "Unknown";
+    MessageType[MessageType["Text"] = 1] = "Text";
+    MessageType[MessageType["Image"] = 2] = "Image";
+    MessageType[MessageType["Audio"] = 3] = "Audio";
+    MessageType[MessageType["Video"] = 4] = "Video";
+    MessageType[MessageType["File"] = 5] = "File";
+    MessageType[MessageType["Url"] = 6] = "Url";
+    MessageType[MessageType["MiniProgram"] = 7] = "MiniProgram";
+    MessageType[MessageType["System"] = 8] = "System";
+})(MessageType || (MessageType = {}));
+/**
+ * 联系人类别。企微现实: 通讯录里都是"真人"(个人/同事/外部客户), 没有微信那种"公众号/服务号"构造,
+ * 故探针默认给 Individual。Official/Corporation 预留给未来能可靠区分"应用/机器人/企业主体"时使用。
+ */
+export var ContactType;
+(function (ContactType) {
+    ContactType[ContactType["Unknown"] = 0] = "Unknown";
+    ContactType[ContactType["Individual"] = 1] = "Individual";
+    ContactType[ContactType["Official"] = 2] = "Official";
+    ContactType[ContactType["Corporation"] = 3] = "Corporation";
+})(ContactType || (ContactType = {}));
+/** 会话 id 类型判定(R: 群 / S: 单聊 / 其它)。 */
+export function isRoomId(conversationId) {
+    return !!conversationId && conversationId.startsWith('R:');
+}
+/** wire 事件里的字符串/数字消息类型 → MessageType。 */
+export function toMessageType(typeStr, typeRaw) {
+    switch ((typeStr || '').toLowerCase()) {
+        case 'text': return MessageType.Text;
+        case 'image': return MessageType.Image;
+        case 'image/file': return MessageType.Image;
+        case 'voice':
+        case 'audio': return MessageType.Audio;
+        case 'video': return MessageType.Video;
+        case 'file': return MessageType.File;
+        case 'url': return MessageType.Url;
+        case 'miniprogram': return MessageType.MiniProgram;
+        case 'sys':
+        case 'system': return MessageType.System;
+        default: return typeRaw ? MessageType.Unknown : MessageType.Unknown;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY;AACZ,MAAM,CAAN,IAAY,WAUX;AAVD,WAAY,WAAW;IACrB,mDAAW,CAAA;IACX,6CAAI,CAAA;IACJ,+CAAK,CAAA;IACL,+CAAK,CAAA;IACL,+CAAK,CAAA;IACL,6CAAI,CAAA;IACJ,2CAAG,CAAA;IACH,2DAAW,CAAA;IACX,iDAAM,CAAA;AACR,CAAC,EAVW,WAAW,KAAX,WAAW,QAUtB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,mDAAW,CAAA;IACX,yDAAU,CAAA;IACV,qDAAQ,CAAA;IACR,2DAAW,CAAA;AACb,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AA+FD,qCAAqC;AACrC,MAAM,UAAU,QAAQ,CAAE,cAAuB;IAC/C,OAAO,CAAC,CAAC,cAAc,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAE,OAAgB,EAAE,OAAgB;IAC/D,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,CAAC,OAAO,WAAW,CAAC,IAAI,CAAA;QACpC,KAAK,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAA;QACtC,KAAK,YAAY,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAA;QAC3C,KAAK,OAAO,CAAC;QAAC,KAAK,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAA;QACpD,KAAK,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAA;QACtC,KAAK,MAAM,CAAC,CAAC,OAAO,WAAW,CAAC,IAAI,CAAA;QACpC,KAAK,KAAK,CAAC,CAAC,OAAO,WAAW,CAAC,GAAG,CAAA;QAClC,KAAK,aAAa,CAAC,CAAC,OAAO,WAAW,CAAC,WAAW,CAAA;QAClD,KAAK,KAAK,CAAC;QAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,WAAW,CAAC,MAAM,CAAA;QACpD,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAA;IACrE,CAAC;AACH,CAAC"}