chatboty 0.1.0

package/dist/esm/src/chatboty.js

@@ -0,0 +1,200 @@
+/**
+ * Chatboty — 自研机器人主类(零外部框架依赖)。
+ * 封装 ChatbotyClient(发证+连网关传输), 把 wire 事件/结果映射成实体类(Message/Contact/Room/Friendship),
+ * 对外暴露 typed 事件与便捷 API。这是 chatboty 全生态框架的核心。
+ */
+import { ChatbotyClient } from './client.js';
+import { toMessageType, isRoomId, } 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 class Chatboty {
+    constructor(options) {
+        this.listeners = new Map();
+        this.client = new 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(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 = 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: 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(this, payload);
+    }
+    toMemberEvent(w, idList, userList) {
+        return {
+            room: new Room(this, { id: w.roomId }),
+            idList: idList || [],
+            contactList: (userList || []).filter(Boolean).map((u) => new 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(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(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(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(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(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(this, { id, topic }) : undefined;
+    }
+}
+//# sourceMappingURL=chatboty.js.map

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

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

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

@@ -0,0 +1,84 @@
+export interface ChatbotyClientOptions {
+    /**
+     * 长期订阅 token(cbt_...), 由售卖端签发给用户。
+     * 直连/发证模式(fallback)必填; 使用服务发现(serviceToken+serviceAuthority)时可省略。
+     */
+    token?: string;
+    /** 售卖端基址(发证/服务发现)。默认 http://127.0.0.1:8080 */
+    atlasUrl?: string;
+    /** 命令回包超时(ms)。默认 25000 */
+    timeoutMs?: number;
+    /** 调试直连: 跳过发证, 直接给网关地址 */
+    endpoint?: string;
+    /** 调试直连: 直接给接入 JWT(配合 endpoint) */
+    accessToken?: string;
+    /**
+     * 【推荐】服务发现: 长期服务令牌。配合 serviceAuthority 使用。
+     * SDK 会带 `Authorization: Bearer <serviceToken>` POST 到 serviceAuthority,
+     * 换取 { endpoint, accessToken(短TTL RS256), expiresIn }, 用 accessToken 连网关(?access=)。
+     */
+    serviceToken?: string;
+    /**
+     * 【推荐】服务发现端点(权威 URL)。给定时优先走服务发现流程(而非 token 直连/发证)。
+     */
+    serviceAuthority?: string;
+    /** accessToken 过期前提前刷新的秒数。默认 30 */
+    refreshSkewSec?: number;
+}
+export type EventHandler = (payload: Record<string, any>) => void;
+export declare class ChatbotyClient {
+    private readonly opts;
+    private ws?;
+    private accountId?;
+    private reqId;
+    private readonly pending;
+    private readonly handlers;
+    private readyResolve?;
+    private readonly discoveryMode;
+    private stopped;
+    private autoReconnect;
+    private currentAccessToken?;
+    private currentEndpoint?;
+    private refreshTimer?;
+    private reconnectTimer?;
+    private reconnectAttempt;
+    constructor(options: ChatbotyClientOptions);
+    /** 该接入授权的探针实例 id(发证后可知)。 */
+    get account(): string | undefined;
+    /** 服务发现 + 连接网关。resolve 于网关 gateway-ready。 */
+    start(): Promise<void>;
+    /**
+     * 服务发现: POST serviceAuthority(带 Bearer serviceToken)换取接入凭据。
+     * 期望响应 { endpoint, accessToken, expiresIn }(可选 accountId/seatId)。
+     */
+    private discover;
+    /** 应用一次发现结果: 缓存 endpoint/accessToken, 并安排到期前刷新。 */
+    private applyDiscovery;
+    /** 在 accessToken 过期前(提前 refreshSkewSec)重新发现, 刷新缓存的 accessToken。 */
+    private scheduleRefresh;
+    /** 刷新 accessToken; 失败按指数退避重试(封顶 30s)。刷新后的 token 供下次(重)连使用。 */
+    private refresh;
+    /** discovery 模式下断线自愈: 重新发现取新 accessToken 后重连; 失败指数退避。 */
+    private scheduleReconnect;
+    private reconnect;
+    /** 用订阅 token 向售卖端换接入 JWT(发证/服务发现)。 */
+    private grant;
+    /**
+     * 连接网关。queryKey='token' 为直连/发证 fallback(既有行为不变);
+     * queryKey='access' 为服务发现流程(网关验 RS256 accessToken → seatId)。
+     */
+    private connect;
+    private onFrame;
+    /** 订阅事件: message / room-join / room-leave / room-topic / friendship / login / logout / disconnected ... */
+    on(event: string, handler: EventHandler): this;
+    off(event: string, handler: EventHandler): this;
+    private emit;
+    /** 通用命令: 发到网关 → 路由到本接入授权的探针。 */
+    command(cmd: string, args?: Record<string, any>): Promise<any>;
+    roomList(): Promise<any>;
+    contactList(limit?: number): Promise<any>;
+    say(conversationId: string, text: string): Promise<any>;
+    /** 断开。停止刷新/重连定时器。 */
+    stop(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAA;AAQjE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CACE;IACvB,OAAO,CAAC,EAAE,CAAC,CAAW;IACtB,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,YAAY,CAAC,CAAY;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,kBAAkB,CAAC,CAAQ;IACnC,OAAO,CAAC,eAAe,CAAC,CAAQ;IAChC,OAAO,CAAC,YAAY,CAAC,CAA+B;IACpD,OAAO,CAAC,cAAc,CAAC,CAA+B;IACtD,OAAO,CAAC,gBAAgB,CAAI;gBAEf,OAAO,EAAE,qBAAqB;IAgB3C,4BAA4B;IAC5B,IAAI,OAAO,IAAK,MAAM,GAAG,SAAS,CAA0B;IAE5D,6CAA6C;IACvC,KAAK,IAAK,OAAO,CAAC,IAAI,CAAC;IAqB7B;;;OAGG;YACW,QAAQ;IAsBtB,mDAAmD;IACnD,OAAO,CAAC,cAAc;IAOtB,mEAAmE;IACnE,OAAO,CAAC,eAAe;IAOvB,8DAA8D;YAChD,OAAO;IAarB,yDAAyD;IACzD,OAAO,CAAC,iBAAiB;YASX,SAAS;IAyBvB,sCAAsC;YACxB,KAAK;IAkBnB;;;OAGG;IACH,OAAO,CAAC,OAAO;IAuBf,OAAO,CAAC,OAAO;IAoBf,2GAA2G;IAC3G,EAAE,CAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAM/C,GAAG,CAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKhD,OAAO,CAAC,IAAI;IAIZ,gCAAgC;IAChC,OAAO,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAcnE,QAAQ,IAAK,OAAO,CAAC,GAAG,CAAC;IACzB,WAAW,CAAE,KAAK,SAAI,GAAG,OAAO,CAAC,GAAG,CAAC;IACrC,GAAG,CAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAExD,qBAAqB;IACrB,IAAI,IAAK,IAAI;CAOd"}

package/dist/esm/src/client.js

@@ -0,0 +1,291 @@
+/**
+ * ChatbotyClient — P1 身份主线的"薄壳"接入客户端。
+ *
+ * 自研、零外部框架依赖(仅 ws)。职责:
+ *   1) 服务发现+发证: 用长期订阅 token 调售卖端 /api/access/grant 换取
+ *      {endpoint(网关地址), accessToken(短TTL接入JWT), accountId}。
+ *   2) 连网关: endpoint + `/client?token=<accessToken>`; 网关公钥验签后按 accountId 路由+隔离。
+ *   3) 收发: 命令请求/回包关联(带超时) + 事件订阅(message/room-join/room-leave/room-topic/friendship/...)。
+ *
+ * 这是 P2 自研全生态框架(Contact/Room/Message/插件)的传输地基。
+ */
+import WebSocket from 'ws';
+export class ChatbotyClient {
+    constructor(options) {
+        this.reqId = 1;
+        this.pending = new Map();
+        this.handlers = new Map();
+        this.stopped = false;
+        this.autoReconnect = false;
+        this.reconnectAttempt = 0;
+        const hasDiscovery = !!(options && options.serviceToken && options.serviceAuthority);
+        const hasDirect = !!(options && (options.token || (options.endpoint && options.accessToken)));
+        if (!hasDiscovery && !hasDirect) {
+            throw new Error('ChatbotyClient: 需提供 { serviceToken, serviceAuthority } 或 { token, endpoint }');
+        }
+        this.discoveryMode = hasDiscovery;
+        this.opts = {
+            atlasUrl: 'http://127.0.0.1:8080',
+            timeoutMs: 25000,
+            refreshSkewSec: 30,
+            token: '',
+            ...options,
+        };
+    }
+    /** 该接入授权的探针实例 id(发证后可知)。 */
+    get account() { return this.accountId; }
+    /** 服务发现 + 连接网关。resolve 于网关 gateway-ready。 */
+    async start() {
+        this.stopped = false;
+        // 【推荐】服务发现流程: serviceToken/serviceAuthority → 短TTL accessToken → 连网关(?access=) + 到期前刷新。
+        if (this.discoveryMode) {
+            const d = await this.discover();
+            this.applyDiscovery(d);
+            await this.connect(d.endpoint, d.accessToken, 'access');
+            return;
+        }
+        // 直连/发证 fallback: 保持既有 `?token=<accessToken>` 行为不变。
+        let endpoint = this.opts.endpoint;
+        let accessToken = this.opts.accessToken;
+        if (!endpoint || !accessToken) {
+            const g = await this.grant();
+            endpoint = g.endpoint;
+            accessToken = g.accessToken;
+            this.accountId = g.accountId;
+        }
+        await this.connect(endpoint, accessToken);
+    }
+    /**
+     * 服务发现: POST serviceAuthority(带 Bearer serviceToken)换取接入凭据。
+     * 期望响应 { endpoint, accessToken, expiresIn }(可选 accountId/seatId)。
+     */
+    async discover() {
+        const url = this.opts.serviceAuthority;
+        const httpFetch = globalThis.fetch;
+        if (!httpFetch)
+            throw new Error('运行环境无 fetch(需 Node>=18)');
+        const resp = await httpFetch(url, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                authorization: `Bearer ${this.opts.serviceToken ?? ''}`,
+            },
+            body: JSON.stringify({ token: this.opts.serviceToken }),
+        });
+        if (!resp.ok) {
+            const txt = await resp.text().catch(() => '');
+            throw new Error(`服务发现失败 ${resp.status}: ${txt.slice(0, 200)}`);
+        }
+        const j = await resp.json();
+        if (!j.endpoint || !j.accessToken)
+            throw new Error('服务发现响应缺少 endpoint/accessToken');
+        const expiresIn = Number(j.expiresIn) > 0 ? Number(j.expiresIn) : 300;
+        return { endpoint: j.endpoint, accessToken: j.accessToken, expiresIn, accountId: j.accountId ?? j.seatId };
+    }
+    /** 应用一次发现结果: 缓存 endpoint/accessToken, 并安排到期前刷新。 */
+    applyDiscovery(d) {
+        this.currentEndpoint = d.endpoint;
+        this.currentAccessToken = d.accessToken;
+        if (d.accountId)
+            this.accountId = d.accountId;
+        this.scheduleRefresh(d.expiresIn);
+    }
+    /** 在 accessToken 过期前(提前 refreshSkewSec)重新发现, 刷新缓存的 accessToken。 */
+    scheduleRefresh(expiresIn) {
+        if (this.refreshTimer)
+            clearTimeout(this.refreshTimer);
+        if (this.stopped)
+            return;
+        const delayMs = Math.max(1000, (expiresIn - this.opts.refreshSkewSec) * 1000);
+        this.refreshTimer = setTimeout(() => { void this.refresh(0); }, delayMs);
+    }
+    /** 刷新 accessToken; 失败按指数退避重试(封顶 30s)。刷新后的 token 供下次(重)连使用。 */
+    async refresh(attempt) {
+        if (this.stopped)
+            return;
+        try {
+            const d = await this.discover();
+            this.applyDiscovery(d); // 内部会重新 scheduleRefresh
+        }
+        catch {
+            if (this.stopped)
+                return;
+            const backoff = Math.min(30000, 1000 * 2 ** attempt);
+            if (this.refreshTimer)
+                clearTimeout(this.refreshTimer);
+            this.refreshTimer = setTimeout(() => { void this.refresh(attempt + 1); }, backoff);
+        }
+    }
+    /** discovery 模式下断线自愈: 重新发现取新 accessToken 后重连; 失败指数退避。 */
+    scheduleReconnect() {
+        if (this.stopped || this.reconnectTimer)
+            return;
+        const backoff = Math.min(30000, 1000 * 2 ** this.reconnectAttempt);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            void this.reconnect();
+        }, backoff);
+    }
+    async reconnect() {
+        if (this.stopped)
+            return;
+        try {
+            // 优先用刷新循环维护的最新 accessToken(“on reconnect use the fresh one”);
+            // 无缓存(如刚被失败清空)则强制重新发现。
+            let endpoint = this.currentEndpoint;
+            let accessToken = this.currentAccessToken;
+            if (!endpoint || !accessToken) {
+                const d = await this.discover();
+                this.applyDiscovery(d);
+                endpoint = d.endpoint;
+                accessToken = d.accessToken;
+            }
+            await this.connect(endpoint, accessToken, 'access');
+            this.reconnectAttempt = 0;
+        }
+        catch {
+            if (this.stopped)
+                return;
+            this.reconnectAttempt++;
+            // 缓存 token 可能已失效, 清掉 → 下次重连强制重新发现。
+            this.currentAccessToken = undefined;
+            this.currentEndpoint = undefined;
+            this.scheduleReconnect();
+        }
+    }
+    /** 用订阅 token 向售卖端换接入 JWT(发证/服务发现)。 */
+    async grant() {
+        const url = this.opts.atlasUrl.replace(/\/$/, '') + '/api/access/grant';
+        const httpFetch = globalThis.fetch;
+        if (!httpFetch)
+            throw new Error('运行环境无 fetch(需 Node>=18)');
+        const resp = await httpFetch(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ token: this.opts.token }),
+        });
+        if (!resp.ok) {
+            const txt = await resp.text().catch(() => '');
+            throw new Error(`发证失败 ${resp.status}: ${txt.slice(0, 200)}`);
+        }
+        const j = await resp.json();
+        if (!j.endpoint || !j.accessToken)
+            throw new Error('发证响应缺少 endpoint/accessToken');
+        return { endpoint: j.endpoint, accessToken: j.accessToken, accountId: j.accountId };
+    }
+    /**
+     * 连接网关。queryKey='token' 为直连/发证 fallback(既有行为不变);
+     * queryKey='access' 为服务发现流程(网关验 RS256 accessToken → seatId)。
+     */
+    connect(endpoint, accessToken, queryKey = 'token') {
+        const sep = endpoint.includes('/client') ? '' : '/client';
+        const wsUrl = `${endpoint}${sep}?${queryKey}=${encodeURIComponent(accessToken)}`;
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsUrl);
+            this.ws = ws;
+            this.readyResolve = resolve;
+            const onErr = (e) => reject(new Error('连接网关失败: ' + e.message));
+            ws.once('error', onErr);
+            ws.on('open', () => {
+                ws.removeListener('error', onErr);
+                // 首次成功连上后才开启断线自愈, 避免首连失败时把错误吞进后台重连。
+                if (queryKey === 'access')
+                    this.autoReconnect = true;
+            });
+            ws.on('message', (raw) => this.onFrame(raw));
+            ws.on('close', () => {
+                if (this.ws === ws)
+                    this.ws = undefined;
+                this.emit('disconnected', {});
+                if (this.autoReconnect && !this.stopped)
+                    this.scheduleReconnect();
+            });
+        });
+    }
+    onFrame(raw) {
+        let m;
+        try {
+            m = JSON.parse(raw.toString());
+        }
+        catch {
+            return;
+        }
+        if (typeof m.id === 'number' && this.pending.has(m.id)) { // 命令回包
+            const p = this.pending.get(m.id);
+            this.pending.delete(m.id);
+            clearTimeout(p.timer);
+            if (m.ok)
+                p.resolve(m.result);
+            else
+                p.reject(new Error(m.error || 'command failed'));
+            return;
+        }
+        if (m.ev) { // 事件
+            if (m.ev === 'gateway-ready') {
+                if (!this.accountId && Array.isArray(m.accounts) && m.accounts.length)
+                    this.accountId = m.accounts[0];
+                if (this.readyResolve) {
+                    this.readyResolve();
+                    this.readyResolve = undefined;
+                }
+            }
+            this.emit(m.ev, m);
+        }
+    }
+    /** 订阅事件: message / room-join / room-leave / room-topic / friendship / login / logout / disconnected ... */
+    on(event, handler) {
+        if (!this.handlers.has(event))
+            this.handlers.set(event, new Set());
+        this.handlers.get(event).add(handler);
+        return this;
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+        return this;
+    }
+    emit(event, payload) {
+        this.handlers.get(event)?.forEach((h) => { try {
+            h(payload);
+        }
+        catch { /* 隔离回调异常 */ } });
+    }
+    /** 通用命令: 发到网关 → 路由到本接入授权的探针。 */
+    command(cmd, args = {}) {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return Promise.reject(new Error('未连接'));
+        const id = this.reqId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error('命令超时: ' + cmd));
+                }
+            }, this.opts.timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            ws.send(JSON.stringify({ id, accountId: this.accountId, cmd, ...args }));
+        });
+    }
+    // —— 便捷方法(P2 框架前的最小集; 完整 Contact/Room/Message 对象模型见 P2) ——
+    roomList() { return this.command('roomList'); }
+    contactList(limit = 0) { return this.command('contactList', { limit }); }
+    say(conversationId, text) { return this.command('sendText', { conversationId, text }); }
+    /** 断开。停止刷新/重连定时器。 */
+    stop() {
+        this.stopped = true;
+        this.autoReconnect = false;
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = undefined;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        try {
+            this.ws?.close();
+        }
+        catch { /* noop */ }
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { BotApi, ContactPayload, Sayable } from '../types.js';
+import { ContactType } from '../types.js';
+/** 联系人实体(含外部客户)。 */
+export declare class Contact {
+    private readonly bot;
+    readonly payload: ContactPayload;
+    constructor(bot: BotApi, payload: ContactPayload);
+    id(): string;
+    name(): string;
+    alias(): string | undefined;
+    avatar(): string | undefined;
+    phone(): string | undefined;
+    title(): string | undefined;
+    /**
+     * 联系人类别。企微通讯录成员/外部客户都是真人 → 默认 {@link ContactType.Individual}。
+     * (企微不存在微信式"公众号/服务号", 且探针未采集"应用号/机器人"标志, 故不臆造 Official。)
+     */
+    type(): ContactType;
+    /** 单聊会话 id(发消息目标)。 */
+    conversationId(): string | undefined;
+    /** 给该联系人发消息(单聊)。 */
+    say(sayable: Sayable): Promise<any>;
+    toString(): string;
+}
+//# sourceMappingURL=contact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contact.d.ts","sourceRoot":"","sources":["../../../../src/entity/contact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,oBAAoB;AACpB,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;IACb,IAAI,IAAK,MAAM;IACf,KAAK,IAAK,MAAM,GAAG,SAAS;IAC5B,MAAM,IAAK,MAAM,GAAG,SAAS;IAC7B,KAAK,IAAK,MAAM,GAAG,SAAS;IAC5B,KAAK,IAAK,MAAM,GAAG,SAAS;IAE5B;;;OAGG;IACH,IAAI,IAAK,WAAW;IAEpB,sBAAsB;IACtB,cAAc,IAAK,MAAM,GAAG,SAAS;IAErC,oBAAoB;IACd,GAAG,CAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAM1C,QAAQ,IAAK,MAAM;CACpB"}