feat: import Chinese-localized Buzz source snapshot

Signed-off-by: cls_宁波本机 <908705107@qq.com>
2026-08-13 18:34:25 +08:00
parent 61c3fa1df9
commit 9dfa06ffee
3785 changed files with 1085458 additions and 2 deletions
@@ -0,0 +1,90 @@
+import 'dart:async';
+
+import 'package:flutter/foundation.dart';
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+
+import '../../shared/relay/relay.dart';
+
+/// In-memory cache of other users' presence.
+///
+/// Subscribes to kind:20001 presence events over the relay WebSocket for
+/// real-time updates. There is no longer a REST backstop — agents that
+/// publish presence purely over WS are fine, and TTL expiry will be handled
+/// by the relay-side `presence:true` filter extension when that lands.
+class PresenceCacheNotifier extends Notifier<Map<String, String>> {
+  final Set<String> _tracked = {};
+  void Function()? _presenceUnsub;
+  int _subscriptionVersion = 0;
+
+  @override
+  Map<String, String> build() {
+    final sessionState = ref.watch(relaySessionProvider);
+
+    ref.onDispose(() {
+      _presenceUnsub?.call();
+      _presenceUnsub = null;
+    });
+
+    if (sessionState.status == SessionStatus.connected) {
+      _subscribePresenceUpdates();
+    }
+
+    return {};
+  }
+
+  /// Track presence for [pubkeys].
+  ///
+  /// Currently a no-op for the actual fetch — we rely on live kind:20001
+  /// events. The tracked set is still used to filter incoming events so the
+  /// cache doesn't grow unbounded.
+  void track(List<String> pubkeys) {
+    final normalized = pubkeys.map((pk) => pk.toLowerCase()).toList();
+    _tracked.addAll(normalized);
+    // TODO(presence): once the relay supports a `presence:true` filter
+    // extension, issue a one-shot fetch here for the latest known state per
+    // pubkey. Until then, presence is "online whenever they publish".
+  }
+
+  /// Subscribe to kind:20001 presence events over WebSocket.
+  Future<void> _subscribePresenceUpdates() async {
+    _presenceUnsub?.call();
+    _presenceUnsub = null;
+    _subscriptionVersion++;
+    final version = _subscriptionVersion;
+
+    final session = ref.read(relaySessionProvider.notifier);
+    try {
+      final unsub = await session.subscribe(
+        const NostrFilter(kinds: [EventKind.presenceUpdate], limit: 0),
+        _handlePresenceEvent,
+      );
+      // Guard: if build() re-fired while we were awaiting, discard this
+      // subscription to avoid leaking it.
+      if (version != _subscriptionVersion) {
+        unsub();
+        return;
+      }
+      _presenceUnsub = unsub;
+    } catch (error) {
+      debugPrint(
+        '[PresenceCacheNotifier] presence subscription failed: $error',
+      );
+    }
+  }
+
+  void _handlePresenceEvent(NostrEvent event) {
+    final pubkey = event.pubkey.toLowerCase();
+    if (!_tracked.contains(pubkey)) return;
+    final status = event.content;
+    if (status != 'online' && status != 'away' && status != 'offline') return;
+    if (state[pubkey] == status) return;
+    final updated = Map<String, String>.from(state);
+    updated[pubkey] = status;
+    state = updated;
+  }
+}
+
+final presenceCacheProvider =
+    NotifierProvider<PresenceCacheNotifier, Map<String, String>>(
+      PresenceCacheNotifier.new,
+    );