@buoy-gg/events 2.1.15 → 3.0.0

package/src/stores/unifiedEventStore.ts

@@ -25,6 +25,8 @@ class UnifiedEventStore {
   private events: UnifiedEvent[] = [];
   private listeners: Set<UnifiedEventListener> = new Set();
   private activeSources: Set<EventSource> = new Set();
+  private clearListeners: Set<() => void> = new Set();
+  private remoteAvailableSources: Set<EventSource> | null = null;
 
   // Track which sources are currently subscribed
   private sourceUnsubscribers: Map<string, () => void> = new Map();
@@ -40,12 +42,50 @@ class UnifiedEventStore {
   }
 
   /**
-   * Get which event source types are available
+   * Get which event source types are available. In remote mirror mode this
+   * reflects the synced device's availability instead of local discovery.
    */
   getAvailableEventSources(): Set<EventSource> {
+    if (this.remoteAvailableSources) {
+      return this.remoteAvailableSources;
+    }
     return getCachedDiscovery().availableEventSources;
   }
 
+  // ===========================================================================
+  // REMOTE MIRROR MODE
+  // ===========================================================================
+
+  /**
+   * Override source availability with the synced device's (auto-discovery
+   * finds nothing on the dashboard — the tool packages live on the device).
+   * Pass null to restore local discovery.
+   */
+  setRemoteAvailableSources(sources: EventSource[] | null): void {
+    this.remoteAvailableSources = sources ? new Set(sources) : null;
+  }
+
+  /**
+   * Replace the entire event list and notify listeners. Used in remote
+   * mirror mode where full snapshots arrive from a synced device.
+   */
+  replaceEvents(events: UnifiedEvent[]): void {
+    this.events = events.slice(0, MAX_EVENTS);
+    this.activeSources = new Set(events.map((event) => event.source));
+    this.notifyListeners();
+  }
+
+  /**
+   * Listen for clearEvents() calls. Used in remote mirror mode to forward a
+   * clear performed in the dashboard UI to the synced device.
+   */
+  onClear(listener: () => void): () => void {
+    this.clearListeners.add(listener);
+    return () => {
+      this.clearListeners.delete(listener);
+    };
+  }
+
   /**
    * Subscribe to all available event sources
    */
@@ -341,6 +381,13 @@ class UnifiedEventStore {
     this.activeSources.clear();
     this.networkEventIdMap.clear();
     this.notifyListeners();
+    this.clearListeners.forEach((listener) => {
+      try {
+        listener();
+      } catch {
+        // Ignore listener errors
+      }
+    });
   }
 
   /**

package/src/sync/eventsSyncAdapter.ts

@@ -0,0 +1,31 @@
+import { unifiedEventStore } from "../stores/unifiedEventStore";
+
+/**
+ * Sync adapter for the events tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Subscribing starts aggregation from every discovered source, so the
+ * unified timeline fills while a dashboard is watching even if the on-device
+ * EventsModal was never opened. The snapshot carries the device's available
+ * sources so the dashboard can render the source filter chips (its own
+ * auto-discovery finds nothing — the tool packages live on the device).
+ */
+export const eventsSyncAdapter = {
+  version: 1,
+  getSnapshot: () => ({
+    events: unifiedEventStore.getEvents(),
+    availableSources: Array.from(unifiedEventStore.getAvailableEventSources()),
+  }),
+  subscribe: (onChange: () => void) => {
+    unifiedEventStore.subscribeToAll();
+    // Source subscriptions are left in place on unwatch — the on-device
+    // EventsModal may also be using them, and aggregation is cheap.
+    return unifiedEventStore.subscribe(() => onChange());
+  },
+  actions: {
+    clearEvents: () => {
+      unifiedEventStore.clearEvents();
+    },
+  },
+};