@agentunion/fastaun-browser 0.5.0 → 0.5.2

package/dist/client/delivery.d.ts

@@ -40,7 +40,9 @@ export declare class MessageDeliveryEngine {
     onRawGroupMessageCreated(data: EventPayload): void;
     processAndPublishGroupMessage(data: EventPayload): Promise<void>;
     autoPullGroupMessages(notification: Message): Promise<void>;
-    fillP2pGap(): Promise<void>;
+    private scheduleP2pGapRetry;
+    fillP2pGap(retryAttempt?: number): Promise<void>;
+    private fillP2pGapWithPlainPull;
     fillGroupGap(groupId: string): Promise<void>;
     fillGroupEventGap(groupId: string): Promise<void>;
     handleGroupChangedEventSeq(data: JsonObject, groupId: string): Promise<void>;
@@ -51,7 +53,16 @@ export declare class MessageDeliveryEngine {
     onV2PushNotification(data: EventPayload): Promise<void>;
     restoreSeqTrackerState(): Promise<void>;
     migrateSeqStateGroupIds(state: Record<string, number>): Promise<Record<string, number>>;
-    saveSeqTrackerState(): void;
+    saveSeqTrackerState(): Promise<void>;
+    persistSeq(ns: string, forceSeq?: number): void;
+    flushSeqTrackerPending(): Promise<void>;
+    private dropSeqTrackerPending;
+    private currentSeqTrackerContext;
+    private seqTrackerPending;
+    private mergeSeqTrackerPending;
+    private scheduleSeqTrackerFlush;
+    private cancelSeqTrackerFlushTimer;
+    private writeSeqTrackerState;
     persistRepairedSeq(ns: string): void;
     clampAckSeq(method: string, field: string, ns: string, seq: number): number;
     clampAckParams(method: string, params: RpcParams): RpcParams;

package/dist/client/delivery.d.ts.map

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

package/dist/client/delivery.js

@@ -1,9 +1,13 @@
 import { slotIsolationKey } from '../config.js';
 import { normalizeGroupId } from '../group-id.js';
-import { isJsonObject } from '../types.js';
+import { ConnectionState, isJsonObject } from '../types.js';
 const PUSHED_SEQS_LIMIT = 50_000;
 const PENDING_ORDERED_LIMIT = 50_000;
 const GROUP_RECALL_SEEN_LIMIT = 10_000;
+const SEQ_TRACKER_PERSIST_FLUSH_DELAY_MS = 200;
+const P2P_GAP_FILL_RETRY_LIMIT = 12;
+const P2P_GAP_FILL_RETRY_BASE_MS = 1000;
+const P2P_GAP_FILL_RETRY_MAX_MS = 5000;
 const APP_MESSAGE_ENVELOPE_KEYS = [
     'module_id', 'message_type', 'type', 'kind', 'version',
     'from', 'from_aid', 'sender_aid', 'to', 'to_aid', 'group_id',
@@ -24,6 +28,33 @@ const APP_GROUP_EVENT_ENVELOPE_KEYS = [
 function formatDeliveryError(error) {
     return error instanceof Error ? error : String(error);
 }
+function isTransientGapFillError(error) {
+    const text = (error instanceof Error ? error.message : String(error)).toLowerCase();
+    return text.includes('no_service')
+        || text.includes('service plane unavailable')
+        || text.includes('transport not connected')
+        || text.includes('transport closed')
+        || text.includes('websocket closed')
+        || text.includes('websocket is not open')
+        || text.includes('connection closed')
+        || text.includes('socket closed');
+}
+function p2pAppEventFromPlainPullMessage(message) {
+    const payload = message.payload;
+    const payloadType = isJsonObject(payload)
+        ? String(payload.type ?? '').trim()
+        : '';
+    if (payloadType === 'message.recalled' || payloadType === 'message.recall' || message.type === 'message.recalled') {
+        return {
+            event: 'message.recalled',
+            payload: {
+                ...message,
+                ...(isJsonObject(payload) ? payload : {}),
+            },
+        };
+    }
+    return { event: 'message.received', payload: message };
+}
 export class MessageDeliveryEngine {
     runtime;
     constructor(runtime) {
@@ -111,7 +142,8 @@ export class MessageDeliveryEngine {
             const eventPayload = payload;
             client._groupState?.handleGroupChangedV2Membership?.(eventPayload);
             if (eventPayload.action === 'dissolved') {
-                const groupId = normalizeGroupId(String(eventPayload.group_id ?? '')) || String(eventPayload.group_id ?? '').trim();
+                const rawGroupId = eventPayload.group_aid ?? eventPayload.group_id ?? '';
+                const groupId = normalizeGroupId(String(rawGroupId)) || String(rawGroupId).trim();
                 if (groupId)
                     client._cleanupDissolvedGroup?.(groupId);
             }
@@ -510,7 +542,7 @@ export class MessageDeliveryEngine {
             }).catch((e) => { client._clientLog.warn('group recall auto-ack failed: group=' + groupId, e); });
         }
         if (contig !== contigBefore)
-            this.saveSeqTrackerState();
+            this.persistSeq(ns);
     }
     async publishAppEvent(event, payload) {
         const client = this.runtime.client;
@@ -597,7 +629,7 @@ export class MessageDeliveryEngine {
                     }).catch((e) => { client._clientLog.warn(`P2P auto-ack failed:${String(e)}`); });
                 }
                 if (contigAfter !== contigBefore)
-                    this.saveSeqTrackerState();
+                    this.persistSeq(ns);
                 if (encryptedPush)
                     return;
             }
@@ -675,7 +707,7 @@ export class MessageDeliveryEngine {
                         }).catch((e) => { client._clientLog.warn('group recall auto-ack failed: group=' + groupId, e); });
                     }
                     if (contigAfter !== contigBefore)
-                        this.saveSeqTrackerState();
+                        this.persistSeq(ns);
                     return;
                 }
                 const published = encryptedPush
@@ -698,7 +730,7 @@ export class MessageDeliveryEngine {
                     }).catch((e) => { client._clientLog.warn('group message auto-ack failed: group=' + groupId, e); });
                 }
                 if (contigAfter !== contigBefore)
-                    this.saveSeqTrackerState();
+                    this.persistSeq(ns);
                 if (encryptedPush)
                     return;
             }
@@ -785,9 +817,26 @@ export class MessageDeliveryEngine {
         }
         await client._publishAppEvent('group.message_created', notification);
     }
-    async fillP2pGap() {
+    scheduleP2pGapRetry(ns, retryAttempt) {
         const client = this.runtime.client;
-        if (client._state !== 'connected' || client._closing)
+        if (retryAttempt > P2P_GAP_FILL_RETRY_LIMIT)
+            return;
+        const retryKey = `p2p_pull_retry:${ns}`;
+        if (client._gapFillDone.has(retryKey))
+            return;
+        const delayMs = Math.min(P2P_GAP_FILL_RETRY_BASE_MS * retryAttempt, P2P_GAP_FILL_RETRY_MAX_MS);
+        client._gapFillDone.add(retryKey);
+        client._clientLog.debug(`P2P message gap-fill retry scheduled: ns=${ns} attempt=${retryAttempt} delay_ms=${delayMs}`);
+        globalThis.setTimeout(() => {
+            client._gapFillDone.delete(retryKey);
+            if (client.state !== ConnectionState.READY || client._closing)
+                return;
+            client._safeAsync(this.fillP2pGap(retryAttempt));
+        }, delayMs);
+    }
+    async fillP2pGap(retryAttempt = 0) {
+        const client = this.runtime.client;
+        if (client.state !== ConnectionState.READY || client._closing)
             return;
         if (!client._aid)
             return;
@@ -805,19 +854,59 @@ export class MessageDeliveryEngine {
             this.prunePushedSeqs(ns);
         }
         catch (exc) {
-            client._clientLog.warn(`P2P message gap-fill failed:${String(formatDeliveryError(exc))}`);
+            const transient = isTransientGapFillError(exc);
+            if (transient) {
+                try {
+                    filled = await this.fillP2pGapWithPlainPull(ns, afterSeq);
+                    this.prunePushedSeqs(ns);
+                    client._clientLog.warn(`P2P message gap-fill V2 unavailable, used plain pull fallback:${String(formatDeliveryError(exc))}`);
+                }
+                catch (fallbackExc) {
+                    client._clientLog.warn(`P2P message gap-fill plain fallback failed:${String(formatDeliveryError(fallbackExc))}`);
+                    this.scheduleP2pGapRetry(ns, retryAttempt + 1);
+                }
+            }
+            else {
+                client._clientLog.warn(`P2P message gap-fill failed:${String(formatDeliveryError(exc))}`);
+            }
         }
         finally {
             client._gapFillDone.delete(dedupKey);
             this.runtime.delivery.setGapFillActive(false);
-            if (filled > 0 && client._seqTracker.getContiguousSeq(ns) > afterSeq) {
-                client._safeAsync(this.fillP2pGap());
+        }
+    }
+    async fillP2pGapWithPlainPull(ns, afterSeq) {
+        const client = this.runtime.client;
+        const params = {
+            after_seq: afterSeq,
+            limit: 50,
+            device_id: client._deviceId,
+            slot_id: client._slotId,
+            _rpc_background: true,
+        };
+        const raw = await client._transport.call('message.pull', params, undefined, undefined, true);
+        const result = typeof client._rpcPipeline?.postprocessResult === 'function'
+            ? await client._rpcPipeline.postprocessResult('message.pull', params, raw)
+            : raw;
+        const messages = (isJsonObject(result) && Array.isArray(result.messages))
+            ? result.messages
+            : [];
+        let published = 0;
+        for (const item of messages) {
+            if (!isJsonObject(item))
+                continue;
+            const msg = item;
+            const seq = Number(msg.seq ?? 0);
+            const appEvent = p2pAppEventFromPlainPullMessage(msg);
+            if (await this.publishPulledMessage(appEvent.event, ns, seq, appEvent.payload)) {
+                published += 1;
             }
         }
+        return published;
     }
     async fillGroupGap(groupId) {
         const client = this.runtime.client;
-        if (client._state !== 'connected' || client._closing)
+        if (client.state !== ConnectionState.READY || client._closing)
             return;
         groupId = normalizeGroupId(groupId) || String(groupId ?? '').trim();
         if (!groupId)
@@ -848,7 +937,10 @@ export class MessageDeliveryEngine {
     }
     async fillGroupEventGap(groupId) {
         const client = this.runtime.client;
-        if (client._state !== 'connected' || client._closing)
+        if (client.state !== ConnectionState.READY || client._closing)
+            return;
+        groupId = normalizeGroupId(groupId) || String(groupId ?? '').trim();
+        if (!groupId)
             return;
         const ns = `group_event:${groupId}`;
         const afterSeq = client._seqTracker.getContiguousSeq(ns);
@@ -918,7 +1010,7 @@ export class MessageDeliveryEngine {
                 const ackContig = client._seqTracker.getContiguousSeq(ns);
                 await this.drainOrderedMessages(ns);
                 if (ackContig !== pageContigBefore && !hasDissolvedEvent) {
-                    this.saveSeqTrackerState();
+                    this.persistSeq(ns);
                 }
                 if (eventObjects.length > 0 && ackContig > 0 && ackContig !== pageContigBefore) {
                     const ackSeq = this.clampAckSeq('group.ack_events', 'event_seq', ns, ackContig);
@@ -949,6 +1041,7 @@ export class MessageDeliveryEngine {
     }
     async handleGroupChangedEventSeq(data, groupId) {
         const client = this.runtime.client;
+        groupId = normalizeGroupId(groupId) || String(groupId ?? '').trim();
         let needPull = false;
         const rawEventSeq = data.event_seq;
         const eventSeq = Number(rawEventSeq);
@@ -983,7 +1076,7 @@ export class MessageDeliveryEngine {
         await this.drainOrderedMessages(ns);
         if (ackContig > 0 && ackContig !== contigBefore) {
             if (data.action !== 'dissolved')
-                this.saveSeqTrackerState();
+                this.persistSeq(ns);
             const ackSeq = this.clampAckSeq('group.ack_events', 'event_seq', ns, ackContig);
             client._transport.call('group.ack_events', {
                 group_id: groupId,
@@ -1033,7 +1126,7 @@ export class MessageDeliveryEngine {
         this.runtime.delivery.setOnlineUnreadHintDrainActive(true);
         try {
             while (client._onlineUnreadHintQueue.size > 0) {
-                if (client.state !== 'ready')
+                if (client.state !== ConnectionState.READY)
                     return;
                 if (client._sessionOptions?.background_sync === false)
                     return;
@@ -1147,7 +1240,7 @@ export class MessageDeliveryEngine {
                     const published = await client._publishOrderedMessage('message.received', ns, pushSeq, decrypted);
                     const newContig = client._seqTracker.getContiguousSeq(ns);
                     if (newContig !== contigBefore) {
-                        client._saveSeqTrackerState();
+                        this.persistSeq(ns);
                     }
                     if (newContig > 0 && newContig !== contigBefore) {
                         const ackSeq = this.clampAckSeq('message.v2.ack', 'up_to_seq', ns, newContig);
@@ -1309,50 +1402,141 @@ export class MessageDeliveryEngine {
         }
         return newState;
     }
-    saveSeqTrackerState() {
+    async saveSeqTrackerState() {
         const client = this.runtime.client;
-        if (!client._aid)
+        const context = this.currentSeqTrackerContext();
+        if (!context) {
+            await this.flushSeqTrackerPending();
             return;
+        }
         const state = client._seqTracker.exportState();
-        if (Object.keys(state).length === 0)
+        const pending = this.seqTrackerPending();
+        if (pending.size > 0 && client._seqTrackerPendingPersistContext === context) {
+            const liveNamespaces = new Set(Object.keys(state));
+            for (const ns of [...pending.keys()]) {
+                if (!liveNamespaces.has(ns))
+                    pending.delete(ns);
+            }
+            if (pending.size === 0)
+                client._seqTrackerPendingPersistContext = null;
+        }
+        if (Object.keys(state).length > 0)
+            this.mergeSeqTrackerPending(context, state);
+        await this.flushSeqTrackerPending();
+    }
+    persistSeq(ns, forceSeq) {
+        const client = this.runtime.client;
+        const context = this.currentSeqTrackerContext();
+        if (!context) {
+            void this.flushSeqTrackerPending();
+            return;
+        }
+        const seq = forceSeq ?? client._seqTracker.getContiguousSeq(ns);
+        if (!ns || !Number.isFinite(seq) || seq <= 0)
+            return;
+        if (forceSeq !== undefined) {
+            client._seqTracker.forceContiguousSeq(ns, seq);
+        }
+        this.mergeSeqTrackerPending(context, { [ns]: seq });
+        this.scheduleSeqTrackerFlush();
+    }
+    async flushSeqTrackerPending() {
+        const client = this.runtime.client;
+        this.cancelSeqTrackerFlushTimer();
+        const context = client._seqTrackerPendingPersistContext;
+        const pending = this.seqTrackerPending();
+        if (!context || pending.size === 0) {
+            client._seqTrackerPendingPersistContext = null;
+            return;
+        }
+        const [aid, deviceId, slotId] = JSON.parse(context);
+        const state = Object.fromEntries(pending.entries());
+        pending.clear();
+        client._seqTrackerPendingPersistContext = null;
+        await this.writeSeqTrackerState(aid, deviceId, slotId, state);
+    }
+    dropSeqTrackerPending(ns) {
+        const client = this.runtime.client;
+        const pending = this.seqTrackerPending();
+        pending.delete(ns);
+        if (pending.size === 0) {
+            client._seqTrackerPendingPersistContext = null;
+            this.cancelSeqTrackerFlushTimer();
+        }
+    }
+    currentSeqTrackerContext() {
+        const client = this.runtime.client;
+        if (!client._aid)
+            return null;
+        return JSON.stringify([client._aid, client._deviceId, client._slotId]);
+    }
+    seqTrackerPending() {
+        const client = this.runtime.client;
+        if (!(client._seqTrackerPendingPersist instanceof Map)) {
+            client._seqTrackerPendingPersist = new Map();
+        }
+        return client._seqTrackerPendingPersist;
+    }
+    mergeSeqTrackerPending(context, state) {
+        const client = this.runtime.client;
+        const pending = this.seqTrackerPending();
+        const pendingContext = client._seqTrackerPendingPersistContext;
+        if (pendingContext && pendingContext !== context && pending.size > 0) {
+            void this.flushSeqTrackerPending();
+        }
+        client._seqTrackerPendingPersistContext = context;
+        for (const [ns, seq] of Object.entries(state)) {
+            const seqNum = Number(seq);
+            if (ns && Number.isFinite(seqNum) && seqNum > 0) {
+                pending.set(ns, seqNum);
+            }
+        }
+    }
+    scheduleSeqTrackerFlush() {
+        const client = this.runtime.client;
+        const pending = this.seqTrackerPending();
+        if (pending.size === 0)
+            return;
+        if (client._seqTrackerFlushTimer)
+            return;
+        client._seqTrackerFlushTimer = setTimeout(() => {
+            client._seqTrackerFlushTimer = null;
+            void this.flushSeqTrackerPending();
+        }, SEQ_TRACKER_PERSIST_FLUSH_DELAY_MS);
+    }
+    cancelSeqTrackerFlushTimer() {
+        const client = this.runtime.client;
+        if (client._seqTrackerFlushTimer) {
+            clearTimeout(client._seqTrackerFlushTimer);
+            client._seqTrackerFlushTimer = null;
+        }
+    }
+    async writeSeqTrackerState(aid, deviceId, slotId, state) {
+        const client = this.runtime.client;
+        if (!aid || Object.keys(state).length === 0)
             return;
         try {
             const saveFn = client._tokenStore.saveSeq?.bind(client._tokenStore);
             if (typeof saveFn === 'function') {
-                for (const [ns, seq] of Object.entries(state)) {
-                    saveFn(client._aid, client._deviceId, client._slotId, ns, seq).catch((exc) => {
-                        client._dispatcher.publish('seq_tracker.persist_error', {
-                            phase: 'save',
-                            aid: client._aid,
-                            device_id: client._deviceId,
-                            slot_id: client._slotId,
-                            error: String(exc),
-                        }).catch(() => { });
-                    });
-                }
+                await Promise.all(Object.entries(state).map(([ns, seq]) => saveFn(aid, deviceId, slotId, ns, seq)));
                 return;
             }
             if (typeof client._tokenStore.updateInstanceState === 'function') {
-                client._tokenStore.updateInstanceState(client._aid, client._deviceId, client._slotId, (current) => {
-                    current.seq_tracker_state = state;
+                await client._tokenStore.updateInstanceState(aid, deviceId, slotId, (current) => {
+                    const existing = isJsonObject(current.seq_tracker_state)
+                        ? { ...current.seq_tracker_state }
+                        : {};
+                    current.seq_tracker_state = { ...existing, ...state };
                     return current;
-                }).catch((exc) => {
-                    client._dispatcher.publish('seq_tracker.persist_error', {
-                        phase: 'save',
-                        aid: client._aid,
-                        device_id: client._deviceId,
-                        slot_id: client._slotId,
-                        error: String(exc),
-                    }).catch(() => { });
                 });
             }
         }
         catch (exc) {
             client._dispatcher.publish('seq_tracker.persist_error', {
                 phase: 'save',
-                aid: client._aid,
-                device_id: client._deviceId,
-                slot_id: client._slotId,
+                aid,
+                device_id: deviceId,
+                slot_id: slotId,
                 error: String(exc),
             }).catch(() => { });
         }
@@ -1362,6 +1546,7 @@ export class MessageDeliveryEngine {
         if (!client._aid || !ns)
             return;
         const seq = client._seqTracker.getContiguousSeq(ns);
+        this.dropSeqTrackerPending(ns);
         try {
             if (seq > 0 && typeof client._tokenStore.saveSeq === 'function') {
                 client._tokenStore.saveSeq(client._aid, client._deviceId, client._slotId, ns, seq).catch((exc) => {
@@ -1376,8 +1561,21 @@ export class MessageDeliveryEngine {
                 });
                 return;
             }
+            if (seq <= 0 && typeof client._tokenStore.updateInstanceState === 'function') {
+                Promise.resolve(client._tokenStore.updateInstanceState(client._aid, client._deviceId, client._slotId, (current) => {
+                    if (isJsonObject(current.seq_tracker_state)) {
+                        const next = { ...current.seq_tracker_state };
+                        delete next[ns];
+                        current.seq_tracker_state = next;
+                    }
+                    return current;
+                })).catch((exc) => {
+                    client._clientLog.debug(`delete repaired seq failed: ns=${ns} err=${formatDeliveryError(exc)}`);
+                });
+                return;
+            }
             if (seq > 0) {
-                this.saveSeqTrackerState();
+                void this.saveSeqTrackerState();
             }
         }
         catch (exc) {
@@ -1439,6 +1637,7 @@ export class MessageDeliveryEngine {
         const ready = [...queue.keys()]
             .filter((seq) => seq <= contig && (beforeSeq === undefined || seq < beforeSeq))
             .sort((a, b) => a - b);
+        let delivered = false;
         for (const seq of ready) {
             const item = queue.get(seq);
             queue.delete(seq);
@@ -1446,9 +1645,13 @@ export class MessageDeliveryEngine {
                 continue;
             await this.publishOrderedQueueItem(ns, item.event, seq, item.payload);
             this.markPublishedSeq(ns, seq);
+            delivered = true;
         }
-        if (queue.size === 0)
+        if (queue.size === 0) {
             client._pendingOrderedMsgs.delete(ns);
+            if (delivered)
+                await this.saveSeqTrackerState();
+        }
     }
     async publishOrderedMessage(event, ns, seq, payload) {
         const client = this.runtime.client;
@@ -1479,6 +1682,8 @@ export class MessageDeliveryEngine {
         await this.publishOrderedQueueItem(ns, event, seqNum, payload);
         this.markPublishedSeq(ns, seqNum);
         await this.drainOrderedMessages(ns);
+        if (!client._pendingOrderedMsgs.get(ns))
+            await this.saveSeqTrackerState();
         return true;
     }
     async publishPulledMessage(event, ns, seq, payload) {