@agentunion/fastaun-browser 0.5.2 → 0.5.4

package/dist/client.js

@@ -30,6 +30,7 @@ import { decryptMessage, } from './v2/e2ee/index.js';
 import { ecdsaVerifyRaw } from './v2/crypto/ecdsa.js';
 import { AUNLogger } from './logger.js';
 import { AgentMdManager } from './agent-md.js';
+import { GroupIndexMetaCache } from './group-index.js';
 import { certMatchesFingerprint, normalizeFingerprintHex } from './cert-utils.js';
 import { AUNError, AuthError, ConnectionError, E2EEError, NotFoundError, PermissionError, StateError, TimeoutError, ValidationError, } from './errors.js';
 import { isJsonObject, ConnectionState, STATE_TO_PUBLIC, } from './types.js';
@@ -67,6 +68,14 @@ function attachGatewayProximity(message, source) {
         }
     }
 }
+function groupIndexBodyText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && !Array.isArray(value) && 'body' in value) {
+        return String(value.body ?? '');
+    }
+    return '';
+}
 const DEFAULT_SESSION_OPTIONS = {
     auto_reconnect: true,
     heartbeat_interval: 30.0,
@@ -565,6 +574,8 @@ export class AUNClient {
     _v2LazyProposeTriggered = new Map();
     /** agent.md 运行时管理器，负责上传、下载、缓存和 RPC 元数据观察。 */
     _agentMdManager;
+    _groupIndexMetaCache = new GroupIndexMetaCache();
+    _groupIndexCacheLoaded = new Set();
     /** 消息序列号跟踪器（群消息 + P2P 空洞检测） */
     _seqTracker = new SeqTracker();
     _seqTrackerContext = null;
@@ -574,9 +585,13 @@ export class AUNClient {
     _pushedSeqs = new Map();
     /** 已解密但因 seq 空洞暂缓发布的应用层消息（按 namespace -> seq） */
     _pendingOrderedMsgs = new Map();
+    /** push 处理队列：按 P2P / group namespace 串行化异步解密与有序投递。 */
+    _pushProcessQueues = new Map();
     /** Lazy group sync：首次发送群消息前自动拉取历史 */
     _groupSynced = new Set();
-    /** 群撤回去重：group_id|sorted(message_ids)|recalled_at -> 时间戳，保证应用层只回调一次 */
+    /** P2P 撤回去重：原始 message_id -> 时间戳，保证应用层只回调一次 */
+    _messageRecallSeen = new Map();
+    /** 群撤回去重：group_id|sorted(message_ids) -> 时间戳，保证应用层只回调一次 */
     _groupRecallSeen = new Map();
     /** 在线未读 hint 队列：同一 group 只保留最后一条，延迟 drain 降低登录瞬时拉取压力。 */
     _onlineUnreadHintQueue = new Map();
@@ -693,11 +708,9 @@ export class AUNClient {
             timeout: DEFAULT_SESSION_OPTIONS.timeouts.call,
             onDisconnect: (error, closeCode) => this._handleTransportDisconnect(error, closeCode),
         });
-        this._transport.setMetaObserver((meta) => {
-            void this._observeRpcMeta(meta).catch((exc) => {
-                this._clientLog.debug(`agent.md meta observer skipped: ${String(exc)}`);
-            });
-        });
+        this._transport.setMetaObserver((meta) => this._observeRpcMeta(meta).catch((exc) => {
+            this._clientLog.debug(`rpc meta observer skipped: ${String(exc)}`);
+        }));
         this._runtime = new ClientRuntime(this);
         this._identityRuntime = new IdentityRuntimeManager(this._runtime);
         this._peerDirectory = new PeerDirectory(this._runtime);
@@ -733,6 +746,9 @@ export class AUNClient {
         this._dispatcher.subscribe('_raw.message.received', (data) => {
             this._onRawMessageReceived(data);
         });
+        this._dispatcher.subscribe('_raw.message.recalled', (data) => {
+            this._safeAsync(this._onRawMessageRecalled(data));
+        });
         // 群组消息推送：re-publish（V2 加密消息走 V2 push 路径）
         this._dispatcher.subscribe('_raw.group.message_created', (data) => {
             this._onRawGroupMessageCreated(data);
@@ -766,7 +782,7 @@ export class AUNClient {
             this._safeAsync(this._onGroupStateCommitted(data));
         });
         // 其他事件直接透传
-        for (const evt of ['message.recalled', 'message.ack', 'storage.object_changed']) {
+        for (const evt of ['message.ack', 'storage.object_changed']) {
             this._dispatcher.subscribe(`_raw.${evt}`, (data) => {
                 this._dispatcher.publish(evt, data);
             });
@@ -815,7 +831,96 @@ export class AUNClient {
     }
     /** transport 的 meta observer：吸收 gateway 注入的 _meta 字段。失败不影响业务。 */
     async _observeRpcMeta(meta) {
+        const groupIndexes = isJsonObject(meta.group_indexes)
+            ? meta.group_indexes
+            : {};
+        for (const groupAid of Object.keys(groupIndexes)) {
+            await this._loadGroupIndexCache(groupAid);
+        }
+        this._groupIndexMetaCache.observeRpcMeta(meta, { localAid: this._aid ?? '' });
         await this._agentMdManager.observeRpcMeta(meta, this._aid);
+        for (const groupAid of Object.keys(groupIndexes)) {
+            await this._persistGroupIndexCache(groupAid, {
+                remote_meta: this._groupIndexMetaCache.remoteMeta(this._aid ?? '', groupAid) ?? {},
+                local_etag: this._groupIndexMetaCache.localEtag(this._aid ?? '', groupAid),
+            });
+        }
+    }
+    isGroupIndexStale(groupAid) {
+        return this._groupIndexMetaCache.isStale(this._aid ?? '', groupAid);
+    }
+    markGroupIndexFresh(groupAid, options) {
+        this._groupIndexMetaCache.markFresh(this._aid ?? '', groupAid, options);
+        void this._persistGroupIndexCache(groupAid, { local_etag: String(options.etag ?? '') });
+    }
+    getGroupIndexRemoteMeta(groupAid) {
+        return this._groupIndexMetaCache.remoteMeta(this._aid ?? '', groupAid);
+    }
+    getGroupIndexLocalEtag(groupAid) {
+        return this._groupIndexMetaCache.localEtag(this._aid ?? '', groupAid);
+    }
+    async getGroupIndexCachedSettings(groupAid, keys) {
+        await this._loadGroupIndexCache(groupAid);
+        return this._groupIndexMetaCache.cachedSettings(this._aid ?? '', groupAid, keys.map((item) => String(item)));
+    }
+    async getGroupIndexCachedSettingsByEntries(groupAid, keys, entries) {
+        await this._loadGroupIndexCache(groupAid);
+        return this._groupIndexMetaCache.cachedSettingsByEntries(this._aid ?? '', groupAid, keys.map((item) => String(item)), entries);
+    }
+    cacheGroupIndexSettings(groupAid, settings, options) {
+        this._groupIndexMetaCache.cacheSettings(this._aid ?? '', groupAid, settings, options);
+        const entryEtags = {};
+        for (const item of options?.entries ?? []) {
+            const key = String(item.key ?? '');
+            if (key)
+                entryEtags[key] = String(item.etag ?? '');
+        }
+        const fields = {
+            settings,
+            entry_etags: entryEtags,
+            remote_meta: this._groupIndexMetaCache.remoteMeta(this._aid ?? '', groupAid) ?? {},
+            local_etag: String(options?.etag ?? this._groupIndexMetaCache.localEtag(this._aid ?? '', groupAid) ?? ''),
+        };
+        const indexJsonl = groupIndexBodyText(options?.groupIndex);
+        if (indexJsonl)
+            fields.index_jsonl = indexJsonl;
+        return this._persistGroupIndexCache(groupAid, fields);
+    }
+    _groupIndexCacheKey(groupAid) {
+        return `${this._aid ?? ''}\x00${String(groupAid ?? '')}`;
+    }
+    async _loadGroupIndexCache(groupAid) {
+        const localAid = String(this._aid ?? '').trim();
+        const group = String(groupAid ?? '').trim();
+        if (!localAid || !group || typeof this._tokenStore.loadGroupIndexCache !== 'function')
+            return;
+        const key = this._groupIndexCacheKey(group);
+        if (this._groupIndexCacheLoaded.has(key))
+            return;
+        this._groupIndexCacheLoaded.add(key);
+        const record = await this._tokenStore.loadGroupIndexCache(localAid, group);
+        if (!record)
+            return;
+        this._groupIndexMetaCache.restore(localAid, group, {
+            remote_meta: record.remote_meta,
+            local_etag: record.local_etag,
+            settings: record.settings,
+            entry_etags: record.entry_etags,
+        });
+    }
+    async _persistGroupIndexCache(groupAid, fields) {
+        const localAid = String(this._aid ?? '').trim();
+        const group = String(groupAid ?? '').trim();
+        if (!localAid || !group || typeof this._tokenStore.upsertGroupIndexCache !== 'function')
+            return;
+        const record = await this._tokenStore.upsertGroupIndexCache(localAid, group, fields);
+        this._groupIndexCacheLoaded.add(this._groupIndexCacheKey(group));
+        this._groupIndexMetaCache.restore(localAid, group, {
+            remote_meta: record.remote_meta,
+            local_etag: record.local_etag,
+            settings: record.settings,
+            entry_etags: record.entry_etags,
+        });
     }
     get state() {
         return this._publicState(this._state);
@@ -968,11 +1073,9 @@ export class AUNClient {
             timeout: DEFAULT_SESSION_OPTIONS.timeouts.call,
             onDisconnect: (error, closeCode) => this._handleTransportDisconnect(error, closeCode),
         });
-        this._transport.setMetaObserver((meta) => {
-            void this._observeRpcMeta(meta).catch((exc) => {
-                this._clientLog.debug(`agent.md meta observer skipped: ${String(exc)}`);
-            });
-        });
+        this._transport.setMetaObserver((meta) => this._observeRpcMeta(meta).catch((exc) => {
+            this._clientLog.debug(`rpc meta observer skipped: ${String(exc)}`);
+        }));
         this._auth.setLogger(this._logAuth);
         this._transport.setLogger(this._logTransport);
         this._dispatcher.setLogger(this._logEvents);
@@ -1506,6 +1609,9 @@ export class AUNClient {
     _onRawMessageReceived(data) {
         this._delivery.onRawMessageReceived(data);
     }
+    async _onRawMessageRecalled(data) {
+        return this._delivery.onRawMessageRecalled(data);
+    }
     /** 处理群组消息推送：re-publish（V2 加密消息走 V2 push 路径） */
     _onRawGroupMessageCreated(data) {
         return this._delivery.onRawGroupMessageCreated(data);