chatboty 0.1.0

package/LICENSE

@@ -0,0 +1,162 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or agreed
+      to in writing, Licensor provides the Work (and each Contributor
+      provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
+      OR CONDITIONS OF ANY KIND, either express or implied, including,
+      without limitation, any warranties or conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 chatboty
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,119 @@
+# chatboty
+
+企业微信(WeCom)IM 自动化 SDK —— **自研全生态框架**，零外部框架依赖。
+
+用一个订阅 token，即可在 Node 里收发消息、管理群、监听群事件、读联系人。SDK 自动向平台发证、连接到分配给你的探针实例。
+
+> 概念（Contact / Room / Message / 事件）类似业界常见的聊天机器人框架，但 chatboty 为**完全自研实现**。
+
+## 安装
+
+```bash
+npm install chatboty
+```
+
+要求 Node.js >= 18。
+
+## 快速上手
+
+```ts
+import { Chatboty } from 'chatboty'
+
+const bot = new Chatboty({
+  token: 'cbt_你的订阅token',          // 来自 chatboty 控制台
+  // atlasUrl: 'https://api.chatboty.ai', // 平台地址(默认本地开发地址)
+})
+
+bot.on('message', async (m) => {
+  if (m.self()) return                  // 跳过自己发的
+  console.log(`${m.talker()?.name()}: ${m.text()}`)
+  if (m.text() === 'ping') await m.say('pong')
+})
+
+bot.on('room-join', (e) => {
+  const names = e.contactList.map(c => c.name()).join('、')
+  e.room.say(`欢迎 ${names} 加入！`)
+})
+
+await bot.start()
+```
+
+就这样——`token` 决定连到哪个企业微信实例，平台负责路由与隔离。
+
+## 事件
+
+| 事件 | 回调参数 | 说明 |
+|---|---|---|
+| `message` | `Message` | 收到消息(文本/图片/文件/链接/小程序/系统) |
+| `room-join` | `{ room, contactList, idList, timestamp }` | 有人进群(含外部客户完整信息) |
+| `room-leave` | `{ room, contactList, idList, timestamp }` | 有人退群/被移除 |
+| `room-topic` | `{ room, topic, oldTopic, timestamp }` | 群改名 |
+| `friendship` | `Friendship` | 加好友/删好友 |
+| `login` / `logout` | `self?` / — | 登录态变化 |
+| `scan` | `{ qrcode, status }` | 登录二维码 |
+| `error` | `{ error }` | 探针/代理侧错误信号(不中断运行, 仅上报) |
+| `heartbeat` | `{ state }` | 探针心跳(~30s), 供存活/掉线判定 |
+
+## 实体 API（节选）
+
+```ts
+// Message
+m.text(); m.type(); m.self(); m.talker(); m.room(); m.file(); m.say(sayable)
+m.mentionSelf();          // 本条是否 @ 了我/@所有人(布尔, 纯文本判定)
+await m.mentionList();    // 被 @ 的 Contact[](best-effort: 解析正文@名→就近解析通讯录)
+await m.toFileBox();      // 取媒体/文件字节 → FileBox{dataUrl,mime,name,size}; 别名 m.download()
+// await m.forward(to);   // ⚠️ 未实现(需逆向企微转发服务), 调用抛错
+
+// Contact
+c.id(); c.name(); c.alias(); c.avatar(); c.type(); c.say(sayable)
+// 注: 企微通讯录未采集性别 → 不提供 gender()
+
+// Room
+r.id(); r.topic(); r.say(sayable); r.rename(topic); r.memberAll(); r.owner()
+
+// Bot
+bot.roomList(); bot.contactList(); bot.roomCreate(memberIds, topic)
+await bot.contactFind({ name: '张三' });   // 或 contactFind('关键词') → Contact | undefined
+await bot.contactFindAll('关键词');        // → Contact[](本地通讯录过滤)
+await bot.currentUser(); bot.self;         // 当前登录者(Contact) / 缓存的 self getter
+await bot.logout();                        // 干净登出(回扫码页, 不重启探针)
+```
+
+## 发送内容（Sayable）
+
+```ts
+await contact.say('纯文本')
+await room.say({ image: 'https://.../pic.png' })   // 图片(URL/本地路径/base64)
+await room.say({ file: '/path/to/doc.pdf' })       // 文件
+await room.say({ url: 'https://...', title: '标题', description: '摘要', thumbUrl: '...' })  // 链接卡片
+await room.say({ miniProgram: { appid: '...', title: '...', path: '...', thumb: '...' } })   // 小程序卡片
+```
+
+## 服务发现接入（推荐）
+
+除 `token` 直连外，也可用**服务令牌 + 服务发现端点**接入。SDK 会先向发现端点换取一个短 TTL 的接入凭据，再连网关，并在过期前自动刷新：
+
+```ts
+const bot = new Chatboty({
+  serviceToken: '你的服务令牌',                      // 长期令牌
+  serviceAuthority: 'https://discovery.chatboty.ai', // 发现端点(权威 URL)
+})
+await bot.start()
+```
+
+流程：`POST {serviceAuthority}`（`Authorization: Bearer {serviceToken}`）→ `{ endpoint, accessToken, expiresIn }` → 连 `wss://{endpoint}/client?access={accessToken}`（网关验 RS256 → seatId）。accessToken 到期前约 30s 自动重新发现刷新；断线按指数退避自愈重连。仅给 `{ token, endpoint }` 时维持既有 `?token=` 直连行为不变。
+
+## 仅用传输层（高级）
+
+不想要框架封装，只要底层连接？
+
+```ts
+import { ChatbotyClient } from 'chatboty/client'
+const c = new ChatbotyClient({ token: 'cbt_...' })
+await c.start()
+const rooms = await c.roomList()
+```
+
+## License
+
+Apache-2.0

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/src/chatboty.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Chatboty — 自研机器人主类(零外部框架依赖)。
+ * 封装 ChatbotyClient(发证+连网关传输), 把 wire 事件/结果映射成实体类(Message/Contact/Room/Friendship),
+ * 对外暴露 typed 事件与便捷 API。这是 chatboty 全生态框架的核心。
+ */
+import { type ChatbotyClientOptions } from './client.js';
+import { type BotApi, type Sayable, type ContactPayload, type ContactQueryFilter } from './types.js';
+import { Message } from './entity/message.js';
+import { Contact } from './entity/contact.js';
+import { Room } from './entity/room.js';
+import { Friendship } from './entity/friendship.js';
+export type ChatbotyOptions = ChatbotyClientOptions;
+export declare class Chatboty implements BotApi {
+    private readonly client;
+    private readonly listeners;
+    private _self?;
+    constructor(options: ChatbotyOptions);
+    /** 该接入授权的探针实例 id。 */
+    get accountId(): string | undefined;
+    /** 当前登录者(self)。start 后异步热身; 未就绪时 undefined(用 {@link currentUser} 主动拉取)。 */
+    get self(): Contact | undefined;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    on(event: 'message', l: (m: Message) => void): this;
+    on(event: 'friendship', l: (f: Friendship) => void): this;
+    on(event: 'room-join' | 'room-leave', l: (p: {
+        room: Room;
+        contactList: Contact[];
+        idList: string[];
+        timestamp?: number;
+    }) => void): this;
+    on(event: 'room-topic', l: (p: {
+        room: Room;
+        topic?: string;
+        oldTopic?: string;
+        timestamp?: number;
+    }) => void): this;
+    on(event: 'login', l: (self?: any) => void): this;
+    on(event: 'scan', l: (p: {
+        qrcode?: string;
+        status?: any;
+    }) => void): this;
+    on(event: 'login-phase', l: (p: {
+        phase: string;
+        label?: string;
+    }) => void): this;
+    on(event: 'error', l: (p: {
+        error: string;
+    }) => void): this;
+    on(event: 'heartbeat', l: (p: {
+        state?: string;
+    }) => void): this;
+    on(event: 'logout' | 'ready' | 'stop' | 'disconnected', l: () => void): this;
+    private emit;
+    private wire;
+    private toContactPayload;
+    private toMessage;
+    private toMemberEvent;
+    private toFriendship;
+    command(cmd: string, args?: Record<string, any>): Promise<any>;
+    /** 登录扫码后若企微要求验证码, 用此提交(配合 on('login-phase') 的 need-verify 阶段)。 */
+    enterVerifyCode(code: string): Promise<any>;
+    /** BotApi: 当前登录者 payload(供实体做本机 self 判定, 如 Message.mentionSelf)。 */
+    selfContact(): ContactPayload | undefined;
+    /**
+     * 干净登出(回到扫码页, 不重启探针进程)。冷调 LoginServiceImpl 登出链,
+     * 完成后探针会推 'logout' 事件并转为出新二维码的扫码态。
+     */
+    logout(): Promise<void>;
+    /**
+     * 拉取当前登录者(self)为完整 Contact, 并缓存到 {@link self}。
+     * @returns 当前登录者 Contact; 未登录/会话未加载时 undefined。
+     */
+    currentUser(): Promise<Contact | undefined>;
+    sayTo(conversationId: string, sayable: Sayable): Promise<any>;
+    roomList(): Promise<Room[]>;
+    contactList(): Promise<Contact[]>;
+    /**
+     * 在【已加载的全量通讯录】按条件查找联系人(本地过滤, 非服务端搜陌生人)。
+     * @param query 关键词字符串(匹配 name/alias/phone/title/vid 子串), 或 { name?, alias?, id? } 精确匹配。
+     * @returns 命中的 Contact 列表(可能为空)。
+     */
+    contactFindAll(query?: ContactQueryFilter): Promise<Contact[]>;
+    /**
+     * 查找单个联系人(取 {@link contactFindAll} 第一个命中)。
+     * @param query 关键词字符串或 { name?, alias?, id? }。
+     * @returns 命中的第一个 Contact; 无则 undefined。
+     */
+    contactFind(query: ContactQueryFilter): Promise<Contact | undefined>;
+    /** 建群(成员 vid 列表)。 */
+    roomCreate(memberIdList: string[], topic?: string): Promise<Room | undefined>;
+}
+//# sourceMappingURL=chatboty.d.ts.map

package/dist/cjs/src/chatboty.d.ts.map

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

package/dist/cjs/src/chatboty.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chatboty = void 0;
+/**
+ * Chatboty — 自研机器人主类(零外部框架依赖)。
+ * 封装 ChatbotyClient(发证+连网关传输), 把 wire 事件/结果映射成实体类(Message/Contact/Room/Friendship),
+ * 对外暴露 typed 事件与便捷 API。这是 chatboty 全生态框架的核心。
+ */
+const client_js_1 = require("./client.js");
+const types_js_1 = require("./types.js");
+const message_js_1 = require("./entity/message.js");
+const contact_js_1 = require("./entity/contact.js");
+const room_js_1 = require("./entity/room.js");
+const friendship_js_1 = require("./entity/friendship.js");
+class Chatboty {
+    constructor(options) {
+        this.listeners = new Map();
+        this.client = new client_js_1.ChatbotyClient(options);
+    }
+    /** 该接入授权的探针实例 id。 */
+    get accountId() { return this.client.account; }
+    /** 当前登录者(self)。start 后异步热身; 未就绪时 undefined(用 {@link currentUser} 主动拉取)。 */
+    get self() { return this._self; }
+    async start() {
+        this.wire();
+        await this.client.start();
+        this.emit('ready');
+        // 热身 self(供 message.mentionSelf/self 判定); 失败不致命(未登录时拉不到)。
+        void this.currentUser().catch(() => undefined);
+    }
+    async stop() { this.client.stop(); this.emit('stop'); }
+    on(event, l) {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        this.listeners.get(event).add(l);
+        return this;
+    }
+    emit(event, ...args) {
+        this.listeners.get(event)?.forEach((l) => { try {
+            l(...args);
+        }
+        catch { /* 隔离回调异常 */ } });
+    }
+    wire() {
+        this.client.on('message', (w) => this.emit('message', this.toMessage(w)));
+        this.client.on('room-join', (w) => this.emit('room-join', this.toMemberEvent(w, w.inviteeIdList, w.inviteeList)));
+        this.client.on('room-leave', (w) => this.emit('room-leave', this.toMemberEvent(w, w.removeeIdList, w.removeeList)));
+        this.client.on('room-topic', (w) => this.emit('room-topic', {
+            room: new room_js_1.Room(this, { id: w.roomId, topic: w.topic }), topic: w.topic, oldTopic: w.oldTopic, timestamp: w.timestamp,
+        }));
+        this.client.on('friendship', (w) => this.emit('friendship', this.toFriendship(w)));
+        this.client.on('login', (w) => this.emit('login', w.self));
+        this.client.on('logout', () => { this._self = undefined; this.emit('logout'); });
+        this.client.on('scan', (w) => this.emit('scan', { qrcode: w.qrcode, status: w.status }));
+        this.client.on('login-phase', (w) => this.emit('login-phase', { phase: w.phase, label: w.label }));
+        this.client.on('disconnected', () => this.emit('disconnected'));
+        this.client.on('error', (w) => this.emit('error', { error: w.error }));
+        this.client.on('heartbeat', (w) => this.emit('heartbeat', { state: w.state }));
+    }
+    /* ---------------- wire → 实体 ---------------- */
+    toContactPayload(u) {
+        return {
+            id: u.userId ?? u.id, name: u.name, alias: u.alias, avatar: u.avatar,
+            phone: u.phone, title: u.title, corpId: u.corpId, unionId: u.unionId, conversationId: u.conversationId,
+        };
+    }
+    toMessage(w) {
+        const conv = w.conversationId;
+        const room = (0, types_js_1.isRoomId)(conv);
+        const talker = w.talkerUser
+            ? this.toContactPayload(w.talkerUser)
+            : (w.talkerId ? { id: w.talkerId, name: w.talker } : undefined);
+        const payload = {
+            id: w.msgId,
+            type: (0, types_js_1.toMessageType)(w.type, w.typeRaw),
+            text: w.text,
+            talkerId: talker?.id ?? w.talkerId,
+            roomId: room ? conv : undefined,
+            conversationId: conv,
+            timestamp: w.timestamp,
+            self: !!w.self,
+            talker,
+            file: w.file ?? null,
+            miniProgram: w.miniProgram ?? null,
+            urlLink: w.urlLink ?? null,
+        };
+        return new message_js_1.Message(this, payload);
+    }
+    toMemberEvent(w, idList, userList) {
+        return {
+            room: new room_js_1.Room(this, { id: w.roomId }),
+            idList: idList || [],
+            contactList: (userList || []).filter(Boolean).map((u) => new contact_js_1.Contact(this, this.toContactPayload(u))),
+            timestamp: w.timestamp,
+        };
+    }
+    toFriendship(w) {
+        const kind = w.kind === 'add' ? 'add' : w.kind === 'delete' ? 'delete' : w.kind === 'receive' ? 'receive' : 'confirm';
+        return new friendship_js_1.Friendship(this, {
+            contactId: w.vid || w.contactId,
+            contact: w.user ? this.toContactPayload(w.user) : undefined,
+            kind,
+            hello: w.hello,
+        });
+    }
+    /* ---------------- BotApi(实体动作底座) ---------------- */
+    async command(cmd, args = {}) {
+        return this.client.command(cmd, args);
+    }
+    /** 登录扫码后若企微要求验证码, 用此提交(配合 on('login-phase') 的 need-verify 阶段)。 */
+    async enterVerifyCode(code) {
+        return this.client.command('enterVerifyCode', { code });
+    }
+    /** BotApi: 当前登录者 payload(供实体做本机 self 判定, 如 Message.mentionSelf)。 */
+    selfContact() { return this._self?.payload; }
+    /**
+     * 干净登出(回到扫码页, 不重启探针进程)。冷调 LoginServiceImpl 登出链,
+     * 完成后探针会推 'logout' 事件并转为出新二维码的扫码态。
+     */
+    async logout() {
+        await this.command('logout');
+        this._self = undefined;
+    }
+    /**
+     * 拉取当前登录者(self)为完整 Contact, 并缓存到 {@link self}。
+     * @returns 当前登录者 Contact; 未登录/会话未加载时 undefined。
+     */
+    async currentUser() {
+        let r;
+        try {
+            r = await this.command('self');
+        }
+        catch {
+            return this._self;
+        }
+        if (!r || !(r.userId || r.id))
+            return this._self;
+        this._self = new contact_js_1.Contact(this, this.toContactPayload(r));
+        return this._self;
+    }
+    async sayTo(conversationId, sayable) {
+        if (typeof sayable === 'string')
+            return this.client.command('sendText', { conversationId, text: sayable });
+        if ('image' in sayable)
+            return this.client.command('sendImage', { conversationId, url: sayable.image });
+        if ('file' in sayable)
+            return this.client.command('sendFile', { conversationId, url: sayable.file });
+        if ('url' in sayable)
+            return this.client.command('sendUrlLink', { conversationId, url: sayable.url, title: sayable.title, desc: sayable.description, thumb: sayable.thumbUrl });
+        if ('miniProgram' in sayable)
+            return this.client.command('sendWeAppCard', { conversationId, ...sayable.miniProgram });
+        throw new Error('不支持的发送内容');
+    }
+    /* ---------------- 查询/工厂 ---------------- */
+    async roomList() {
+        const r = await this.command('roomList');
+        const arr = (r && (r.rooms || r.list || (Array.isArray(r) ? r : []))) || [];
+        return arr.map((x) => new room_js_1.Room(this, { id: x.conversationId || x.id, topic: x.name || x.topic }));
+    }
+    async contactList() {
+        const r = await this.command('contactList');
+        const arr = (r && (r.contacts || r.list || (Array.isArray(r) ? r : []))) || [];
+        return arr.map((u) => new contact_js_1.Contact(this, this.toContactPayload(u)));
+    }
+    /**
+     * 在【已加载的全量通讯录】按条件查找联系人(本地过滤, 非服务端搜陌生人)。
+     * @param query 关键词字符串(匹配 name/alias/phone/title/vid 子串), 或 { name?, alias?, id? } 精确匹配。
+     * @returns 命中的 Contact 列表(可能为空)。
+     */
+    async contactFindAll(query) {
+        const keyword = typeof query === 'string'
+            ? query
+            : (query?.name ?? query?.alias ?? query?.id ?? '');
+        const r = await this.command('contactSearch', { keyword });
+        const arr = (r && (r.contacts || r.list || (Array.isArray(r) ? r : []))) || [];
+        let list = arr.map((u) => new contact_js_1.Contact(this, this.toContactPayload(u)));
+        if (query && typeof query !== 'string') { // 对象条件: 在子串命中基础上再做精确收窄
+            if (query.id)
+                list = list.filter((c) => c.id() === query.id);
+            if (query.alias)
+                list = list.filter((c) => c.alias() === query.alias);
+            if (query.name)
+                list = list.filter((c) => c.name() === query.name);
+        }
+        return list;
+    }
+    /**
+     * 查找单个联系人(取 {@link contactFindAll} 第一个命中)。
+     * @param query 关键词字符串或 { name?, alias?, id? }。
+     * @returns 命中的第一个 Contact; 无则 undefined。
+     */
+    async contactFind(query) {
+        const all = await this.contactFindAll(query);
+        return all[0];
+    }
+    /** 建群(成员 vid 列表)。 */
+    async roomCreate(memberIdList, topic) {
+        const r = await this.command('roomCreate', { userList: memberIdList, topic });
+        const id = r && (r.conversationId || r.roomId || r.id);
+        return id ? new room_js_1.Room(this, { id, topic }) : undefined;
+    }
+}
+exports.Chatboty = Chatboty;
+//# sourceMappingURL=chatboty.js.map

package/dist/cjs/src/chatboty.js.map

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