@pmate/chat-sdk 0.7.2 → 0.7.4

package/lib/runtime/chatClient.d.ts

@@ -1,4 +1,5 @@
 import { type ChatPresence } from "./presence.js";
+import { type ChatUpdate } from "./updates.js";
 import { ChatActivityPublisher, type ActivityTarget, type ChatActivity, type ChatActivityState, type ChatActivityUpdate } from "./activity.js";
 import type { ChatMention } from "../mentions/model";
 import { type BotLoginSession } from "./botAuth.js";
@@ -39,6 +40,8 @@ export declare class ChatClient {
     private readonly publishers;
     private readonly pendingAcks;
     private readonly messageHandlers;
+    private readonly updateHandlers;
+    watchUpdates(handler: (update: ChatUpdate) => void): () => void;
     constructor(options: ChatClientOptions);
     connect(): Promise<this>;
     private initialize;
@@ -93,6 +96,7 @@ export declare class ChatClient {
         addMembers?: string[];
         removeMembers?: string[];
         title?: string;
+        avatar?: string;
     }): Promise<ChatRuntimeMessage>;
     sendGroup(input: {
         groupId: string;

package/lib/runtime/chatClient.js

@@ -1,4 +1,5 @@
 import { ChatPresenceClient } from "./presence.js";
+import { parseChatUpdate } from "./updates.js";
 import { ChatActivityStore, ChatActivityPublisher, createActivityMessage, parseChatActivity } from "./activity.js";
 import { loginPmateBot } from "./botAuth.js";
 import { parsePmateBotKeyJson } from "./botKey.js";
@@ -25,6 +26,11 @@ export class ChatClient {
     publishers = new Set();
     pendingAcks = new Map();
     messageHandlers = new Set();
+    updateHandlers = new Set();
+    watchUpdates(handler) {
+        this.updateHandlers.add(handler);
+        return () => { this.updateHandlers.delete(handler); };
+    }
     constructor(options) {
         this.options = options;
         if (options.botKey) {
@@ -221,7 +227,7 @@ export class ChatClient {
         return this.sendChat(input.groupId, {
             kind: "group", threadKind: "group", action: "groupUpdate",
             payload: { appId: this.options.appId, groupId: input.groupId, expectedRevision: input.expectedRevision,
-                addMembers: input.addMembers ?? [], removeMembers: input.removeMembers ?? [], ...(input.title !== undefined ? { title: input.title } : {}) },
+                addMembers: input.addMembers ?? [], removeMembers: input.removeMembers ?? [], ...(input.title !== undefined ? { title: input.title } : {}), ...(input.avatar !== undefined ? { avatar: input.avatar } : {}) },
         });
     }
     async sendGroup(input) {
@@ -288,6 +294,12 @@ export class ChatClient {
         return ack;
     }
     handleIncoming(message) {
+        const update = parseChatUpdate(message, this.options.appId);
+        if (update) {
+            for (const handler of this.updateHandlers)
+                handler(update);
+            return;
+        }
         if (message.opcode === ChatMsgOp.ACK) {
             const ack = message.body;
             const pending = this.pendingAcks.get(ack.ackOf);

package/lib/runtime/index.d.ts

@@ -4,6 +4,8 @@ export * from "./chatClient.js";
 export * from "./protocol.js";
 export * from "./readerClient.js";
 export * from "./thread.js";
+export * from "./updater.js";
+export * from "./updates.js";
 export * from "./activity.js";
 export * from "./call.js";
 export * from "./presence.js";

package/lib/runtime/index.js

@@ -4,6 +4,8 @@ export * from "./chatClient.js";
 export * from "./protocol.js";
 export * from "./readerClient.js";
 export * from "./thread.js";
+export * from "./updater.js";
+export * from "./updates.js";
 export * from "./activity.js";
 export * from "./call.js";
 export * from "./presence.js";

package/lib/runtime/updater.d.ts

@@ -0,0 +1,11 @@
+/** 按资源键合并刷新任务；聊天正文不经过此调度器。 */
+export declare class RefreshUpdater {
+    private readonly windowMs;
+    private readonly onError;
+    private tasks;
+    private closed;
+    constructor(windowMs?: number, onError?: (error: unknown, key: string) => void);
+    invalidate(key: string, refresh: () => Promise<void>): void;
+    close(): void;
+    private run;
+}

package/lib/runtime/updater.js

@@ -0,0 +1,55 @@
+/** 按资源键合并刷新任务；聊天正文不经过此调度器。 */
+export class RefreshUpdater {
+    windowMs;
+    onError;
+    tasks = new Map();
+    closed = false;
+    constructor(windowMs = 3_000, onError = () => { }) {
+        this.windowMs = windowMs;
+        this.onError = onError;
+    }
+    invalidate(key, refresh) {
+        if (this.closed)
+            return;
+        let task = this.tasks.get(key);
+        if (!task) {
+            task = { running: false, due: false, refresh };
+            this.tasks.set(key, task);
+        }
+        task.refresh = refresh;
+        if (task.timer || task.due)
+            return;
+        task.timer = setTimeout(() => {
+            task.timer = undefined;
+            task.due = true;
+            void this.run(key, task);
+        }, this.windowMs);
+    }
+    close() {
+        this.closed = true;
+        for (const task of this.tasks.values())
+            clearTimeout(task.timer);
+        this.tasks.clear();
+    }
+    async run(key, task) {
+        if (this.closed || task.running || !task.due)
+            return;
+        task.running = true;
+        task.due = false;
+        try {
+            await task.refresh();
+        }
+        catch (error) {
+            this.onError(error, key);
+            if (!this.closed)
+                this.invalidate(key, task.refresh);
+        }
+        finally {
+            task.running = false;
+            if (!this.closed && task.due)
+                void this.run(key, task);
+            else if (!task.timer)
+                this.tasks.delete(key);
+        }
+    }
+}

package/lib/runtime/updates.d.ts

@@ -0,0 +1,14 @@
+export type ChatUpdateType = "org.members.changed" | "org.profiles.changed";
+export type ChatUpdate = {
+    eventId: string;
+    appId: string;
+    orgId: string;
+    type: ChatUpdateType;
+    revision: string;
+};
+/** Accept only silent updater deliveries from the trusted Hub notification sender. */
+export declare function parseChatUpdate(message: {
+    opcode: number;
+    from: string;
+    body: unknown;
+}, appId: string): ChatUpdate | null;

package/lib/runtime/updates.js

@@ -0,0 +1,12 @@
+/** Accept only silent updater deliveries from the trusted Hub notification sender. */
+export function parseChatUpdate(message, appId) {
+    if (message.opcode !== 5 || message.from !== "@hub/notifications")
+        return null;
+    const body = message.body;
+    const data = body?.data;
+    if (body?.kind !== "delivery" || body.displayPolicy !== "silent" || !data || data.appId !== appId
+        || !["org.members.changed", "org.profiles.changed"].includes(String(data.type))
+        || typeof body.notificationId !== "string" || typeof data.orgId !== "string" || typeof data.revision !== "string")
+        return null;
+    return { eventId: body.notificationId, appId, orgId: data.orgId, type: data.type, revision: data.revision };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/chat-sdk",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Cross-platform PMate chat input components, voice input primitives, and ASR helpers",
   "type": "module",
   "main": "./lib/index.js",