@buoy-gg/shared-ui 7.0.41 → 7.0.43

package/lib/module/stores/BaseEventStore.js

@@ -1,339 +1 @@
-"use strict";
-
-import { getAccountAccess, hasAccountAccess, subscribeAccountAccess } from "../license/licenseModule.js";
-/**
- * BaseEventStore - Abstract base class for event aggregation stores
- *
- * Handles dual subscription patterns (array listeners + individual event callbacks)
- * and automatically manages start/stop lifecycle based on subscriber count.
- *
- * Follows TanStack Query's Subscribable pattern with extensions for:
- * - Array subscriptions (get full event list on each update)
- * - Individual event subscriptions (get each event as it occurs)
- * - Auto-start capturing when first subscriber joins
- * - Auto-stop capturing when last subscriber leaves
- * - Subscriber count notifications for debugging UI
- *
- * @example
- * ```typescript
- * class StorageEventStore extends BaseEventStore<StorageEvent> {
- *   protected storeName = 'storage';
- *
- *   protected startCapturing(): void {
- *     // Start listening to storage changes
- *   }
- *
- *   protected stopCapturing(): void {
- *     // Stop listening to storage changes
- *   }
- *
- *   isCapturing(): boolean {
- *     return this.unsubscribe !== null;
- *   }
- * }
- * ```
- */
-
-import { Subscribable } from "../utils/subscribable.js";
-import { notifySubscriberCountChange } from "../utils/subscriberCountNotifier.js";
-
-/**
- * Callback type for receiving full events array
- */
-
-/**
- * Callback type for receiving individual events
- */
-
-/**
- * Configuration options for BaseEventStore
- */
-
-/**
- * Abstract base class for event stores.
- *
- * Subclasses must implement:
- * - `startCapturing()` - Begin listening to the underlying event source
- * - `stopCapturing()` - Stop listening to the underlying event source
- * - `isCapturing()` - Check if currently capturing events
- */
-export class BaseEventStore extends Subscribable {
-  events = [];
-  arrayListeners = new Set();
-  captureSuppressed = false;
-  clearListeners = new Set();
-  constructor(options) {
-    super();
-    this.maxEvents = options.maxEvents ?? 500;
-    this.storeName = options.storeName;
-    // Defer until subclass fields are initialized before invoking lifecycle hooks.
-    Promise.resolve().then(() => {
-      const reconcile = () => {
-        if (getAccountAccess().status === "locked") {
-          this.stopCapturing();
-          this.events = [];
-          this.notifyArrayListeners();
-        } else if (this.getTotalSubscriberCount() > 0 && !this.captureSuppressed && !this.isCapturing()) {
-          this.startCapturing();
-        }
-      };
-      subscribeAccountAccess(reconcile);
-      reconcile();
-    });
-  }
-
-  // ===========================================================================
-  // ABSTRACT METHODS - Must be implemented by subclasses
-  // ===========================================================================
-
-  /**
-   * Start capturing events from the underlying source.
-   * Called automatically when first subscriber joins.
-   */
-
-  /**
-   * Stop capturing events from the underlying source.
-   * Called automatically when last subscriber leaves.
-   */
-
-  /**
-   * Check if the store is actively capturing events.
-   */
-
-  // ===========================================================================
-  // LIFECYCLE HOOKS - Called by Subscribable base class
-  // ===========================================================================
-
-  /**
-   * Called when first subscriber joins (via onEvent).
-   * Starts capturing if no one was subscribed.
-   */
-  onSubscribe() {
-    if (this.getTotalSubscriberCount() === 1 && !this.captureSuppressed && getAccountAccess().status !== "locked") {
-      this.startCapturing();
-    }
-    notifySubscriberCountChange(this.storeName);
-  }
-
-  /**
-   * Called when a subscriber leaves (via onEvent unsubscribe).
-   * Stops capturing if no one is subscribed anymore.
-   */
-  onUnsubscribe() {
-    if (this.getTotalSubscriberCount() === 0) {
-      this.stopCapturing();
-    }
-    notifySubscriberCountChange(this.storeName);
-  }
-
-  // ===========================================================================
-  // SUBSCRIPTION METHODS
-  // ===========================================================================
-
-  /**
-   * Get total count of all subscribers (both individual and array listeners)
-   */
-  getTotalSubscriberCount() {
-    return this.listeners.size + this.arrayListeners.size;
-  }
-
-  /**
-   * Subscribe to the full events array.
-   * Automatically starts capturing when first subscriber joins.
-   *
-   * @param listener - Callback that receives the full events array on each update
-   * @returns Unsubscribe function
-   */
-  subscribeToEvents(listener) {
-    const wasEmpty = this.getTotalSubscriberCount() === 0;
-    this.arrayListeners.add(listener);
-
-    // Start capturing if this is the first subscriber
-    if (wasEmpty && !this.captureSuppressed && getAccountAccess().status !== "locked") {
-      this.startCapturing();
-    }
-
-    // Notify subscriber count change
-    notifySubscriberCountChange(this.storeName);
-
-    // Immediately call with current events
-    listener(this.getEvents());
-
-    // Return unsubscribe function
-    return () => {
-      this.arrayListeners.delete(listener);
-
-      // Stop capturing if no one is subscribed anymore
-      if (this.getTotalSubscriberCount() === 0) {
-        this.stopCapturing();
-      }
-
-      // Notify subscriber count change
-      notifySubscriberCountChange(this.storeName);
-    };
-  }
-
-  /**
-   * Subscribe to individual events as they occur.
-   * Automatically starts capturing when first subscriber joins.
-   *
-   * @param callback - Callback that receives each event as it occurs
-   * @returns Unsubscribe function
-   */
-  onEvent(callback) {
-    // Use Subscribable's subscribe method (triggers onSubscribe hook)
-    return this.subscribe(callback);
-  }
-
-  // ===========================================================================
-  // EVENT MANAGEMENT
-  // ===========================================================================
-
-  /**
-   * Add an event to the store.
-   * Call this from subclasses when a new event is received.
-   *
-   * @param event - The event to add
-   */
-  addEvent(event) {
-    if (getAccountAccess().status === "locked") return;
-    // Add to beginning (newest first) and limit to maxEvents
-    this.events = [event, ...this.events].slice(0, this.maxEvents);
-
-    // Notify individual event callbacks (via Subscribable)
-    if (hasAccountAccess()) this.notify(event);
-
-    // Notify array listeners
-    this.notifyArrayListeners();
-  }
-
-  /**
-   * Notify all array listeners of changes
-   */
-  notifyArrayListeners() {
-    const events = this.getEvents();
-    this.arrayListeners.forEach(listener => {
-      try {
-        listener(events);
-      } catch {
-        // Ignore listener errors
-      }
-    });
-  }
-
-  /**
-   * Get all events (newest first)
-   */
-  getEvents() {
-    return hasAccountAccess() ? this.events : [];
-  }
-
-  /**
-   * Get event count
-   */
-  getEventCount() {
-    return hasAccountAccess() ? this.events.length : 0;
-  }
-
-  /**
-   * Clear all events
-   */
-  clearEvents() {
-    this.events = [];
-    this.notifyArrayListeners();
-    this.clearListeners.forEach(listener => {
-      try {
-        listener();
-      } catch {
-        // Ignore listener errors
-      }
-    });
-  }
-
-  /**
-   * Listen for clearEvents() calls. Used in remote mirror mode to forward a
-   * clear performed in the dashboard UI to the synced device.
-   */
-  onClear(listener) {
-    this.clearListeners.add(listener);
-    return () => {
-      this.clearListeners.delete(listener);
-    };
-  }
-
-  // ===========================================================================
-  // REMOTE MIRROR MODE
-  // ===========================================================================
-
-  /**
-   * Suppress the auto start/stop capture lifecycle. Use when this store acts
-   * as a mirror of a remote device's events (e.g. the desktop dashboard):
-   * events arrive via replaceEvents() and the local interceptors must never
-   * start — on the dashboard they would capture the dashboard's own traffic.
-   */
-  disableCapture() {
-    this.captureSuppressed = true;
-    if (this.isCapturing()) {
-      this.stopCapturing();
-    }
-  }
-
-  /**
-   * Replace the entire event list and notify array listeners. Used in remote
-   * mirror mode where full snapshots arrive from a synced device.
-   */
-  replaceEvents(events) {
-    this.events = this.dedupeById(events).slice(0, this.maxEvents);
-    this.notifyArrayListeners();
-  }
-
-  /**
-   * Drop events that share an `id` with an earlier event, keeping the first
-   * (newest, since events are newest-first) occurrence. Remote snapshots can
-   * momentarily carry duplicate ids — e.g. a device's request counter resets
-   * on reload while older events with the same id are still in the buffer —
-   * which makes React list keys (keyed on `id`) collide. Events without an
-   * `id` are passed through untouched.
-   */
-  dedupeById(events) {
-    const seen = new Set();
-    const result = [];
-    for (const event of events) {
-      const id = event?.id;
-      if (id == null) {
-        result.push(event);
-        continue;
-      }
-      if (seen.has(id)) continue;
-      seen.add(id);
-      result.push(event);
-    }
-    return result;
-  }
-
-  /**
-   * Set maximum number of events to keep
-   */
-  setMaxEvents(max) {
-    this.maxEvents = max;
-    if (this.events.length > max) {
-      this.events = this.events.slice(0, max);
-      this.notifyArrayListeners();
-    }
-  }
-
-  // ===========================================================================
-  // DEBUGGING
-  // ===========================================================================
-
-  /**
-   * Get current subscriber counts for debugging
-   */
-  getSubscriberCounts() {
-    return {
-      eventCallbacks: this.listeners.size,
-      arrayListeners: this.arrayListeners.size,
-      total: this.getTotalSubscriberCount()
-    };
-  }
-}
+"use strict";import{getAccountAccess as e,hasAccountAccess as u,subscribeAccountAccess as o}from"../license/licenseModule.js";import{Subscribable as h}from"../utils/subscribable.js";import{notifySubscriberCountChange as r}from"../utils/subscriberCountNotifier.js";export class BaseEventStore extends h{events=[];arrayListeners=new Set;captureSuppressed=false;clearListeners=new Set;constructor(t){super();this.maxEvents=t.maxEvents??500;this.storeName=t.storeName;Promise.resolve().then(()=>{const s=()=>{if(e().status==="locked"){this.stopCapturing();this.events=[];this.notifyArrayListeners()}else if(this.getTotalSubscriberCount()>0&&!this.captureSuppressed&&!this.isCapturing()){this.startCapturing()}};o(s);s()})}onSubscribe(){if(this.getTotalSubscriberCount()===1&&!this.captureSuppressed&&e().status!=="locked"){this.startCapturing()}r(this.storeName)}onUnsubscribe(){if(this.getTotalSubscriberCount()===0){this.stopCapturing()}r(this.storeName)}getTotalSubscriberCount(){return this.listeners.size+this.arrayListeners.size}subscribeToEvents(t){const s=this.getTotalSubscriberCount()===0;this.arrayListeners.add(t);if(s&&!this.captureSuppressed&&e().status!=="locked"){this.startCapturing()}r(this.storeName);t(this.getEvents());return()=>{this.arrayListeners.delete(t);if(this.getTotalSubscriberCount()===0){this.stopCapturing()}r(this.storeName)}}onEvent(t){return this.subscribe(t)}addEvent(t){if(e().status==="locked")return;this.events=[t,...this.events].slice(0,this.maxEvents);if(u())this.notify(t);this.notifyArrayListeners()}notifyArrayListeners(){const t=this.getEvents();this.arrayListeners.forEach(s=>{try{s(t)}catch{}})}getEvents(){return u()?this.events:[]}getEventCount(){return u()?this.events.length:0}clearEvents(){this.events=[];this.notifyArrayListeners();this.clearListeners.forEach(t=>{try{t()}catch{}})}onClear(t){this.clearListeners.add(t);return()=>{this.clearListeners.delete(t)}}disableCapture(){this.captureSuppressed=true;if(this.isCapturing()){this.stopCapturing()}}replaceEvents(t){this.events=this.dedupeById(t).slice(0,this.maxEvents);this.notifyArrayListeners()}dedupeById(t){const s=new Set;const i=[];for(const n of t){const a=n?.id;if(a==null){i.push(n);continue}if(s.has(a))continue;s.add(a);i.push(n)}return i}setMaxEvents(t){this.maxEvents=t;if(this.events.length>t){this.events=this.events.slice(0,t);this.notifyArrayListeners()}}getSubscriberCounts(){return{eventCallbacks:this.listeners.size,arrayListeners:this.arrayListeners.size,total:this.getTotalSubscriberCount()}}}

package/lib/module/stores/ChangeLog.js

@@ -1,192 +1 @@
-"use strict";
-
-/**
- * ChangeLog — the class-shaped event log the state tools share.
- *
- * redux (`ReduxActionStore`), zustand (`ZustandStateStore`), jotai
- * (`JotaiStateStore`) and react-query (`ReactQueryEventStore`) each carried
- * the same ~120 lines: a newest-first ring buffer, a `Set` of array listeners
- * (`(items) => void`), a `Set` of clear listeners for the desktop's mirror
- * mode, an `enabled` flag (the UI's pause button), a `captureSuppressed` flag
- * (the dashboard must never record its own traffic), a monotonic id counter,
- * `getById`, and hydrate-by-id for lazily fetched detail payloads.
- *
- * This is that core. Tool stores `extend` it and keep their public method
- * names (`addStateChange`, `getActions`, `clearAtomChanges`, …) as thin
- * wrappers, so no call site — including Buoy Desktop — has to change.
- *
- * Semantics preserved from the originals, deliberately:
- * - `getAll()` returns a COPY (`[...items]`) — consumers seed React state
- *   from it and rely on a fresh identity per notification.
- * - `clear()` always notifies, even when already empty, then fires the clear
- *   listeners (the dashboard forwards the clear to the device either way).
- * - `replaceAll()` respects `enabled`: the pause button freezes a mirror.
- * - `disableCapture()` is permanent for the store's lifetime.
- */
-
-export class ChangeLog {
-  /** Newest first. Subclasses may read; mutate only through the helpers. */
-  items = [];
-  itemListeners = new Set();
-  clearListeners = new Set();
-  idCounter = 0;
-  enabled = true;
-  captureSuppressed = false;
-  constructor(options = {}) {
-    this.max = options.max ?? 200;
-  }
-
-  // ---- Recording ----
-
-  /** True when a new item should be recorded (not paused, not a mirror). */
-  canRecord() {
-    return this.enabled && !this.captureSuppressed;
-  }
-
-  /** `${Date.now()}-${n}` — unique per store instance, sorts by time. */
-  nextId() {
-    return `${Date.now()}-${++this.idCounter}`;
-  }
-
-  /**
-   * Prepend one item and trim to `max`. Does NOT notify — subclasses often
-   * touch companion state (per-entity counters, raw-state eviction) before
-   * they notify. Call `notifyListeners()` when done, or use `record()`.
-   */
-  push(item) {
-    this.items = [item, ...this.items].slice(0, this.max);
-  }
-
-  /** `push()` + notify. The common case. */
-  record(item) {
-    this.push(item);
-    this.notifyListeners();
-  }
-
-  /** Replace the buffer wholesale (already merged/hydrated by the caller) and notify. */
-  setItems(next) {
-    this.items = next.slice(0, this.max);
-    this.notifyListeners();
-  }
-
-  // ---- Reading ----
-
-  /** All items, newest first. Fresh array each call. */
-  getAll() {
-    return [...this.items];
-  }
-  getById(id) {
-    return this.items.find(item => item.id === id);
-  }
-  get size() {
-    return this.items.length;
-  }
-
-  // ---- Clearing ----
-
-  /**
-   * Empty the buffer, notify, then fire clear listeners. Always notifies —
-   * a clear is a user action and the list must repaint even if nothing was
-   * in it. Subclasses that keep companion counters reset them first.
-   */
-  clear() {
-    this.items = [];
-    this.notifyListeners();
-    this.clearListeners.forEach(listener => {
-      try {
-        listener();
-      } catch {
-        // Ignore listener errors
-      }
-    });
-  }
-
-  /**
-   * Listen for `clear()` calls. Used in remote mirror mode to forward a
-   * clear performed in the dashboard UI to the synced device.
-   */
-  onClear(listener) {
-    this.clearListeners.add(listener);
-    return () => {
-      this.clearListeners.delete(listener);
-    };
-  }
-
-  // ---- Remote mirror mode ----
-
-  /**
-   * Permanently suppress local capture. Use when this store acts as a mirror
-   * of a remote device (the desktop dashboard): data arrives via
-   * `replaceAll()` / a subclass snapshot method and local instrumentation
-   * must never record.
-   */
-  disableCapture() {
-    this.captureSuppressed = true;
-  }
-
-  /** Whether the store is in remote mirror mode (capture suppressed). */
-  isCaptureSuppressed() {
-    return this.captureSuppressed;
-  }
-
-  /**
-   * Replace the whole list from a remote snapshot and notify. Respects the
-   * enabled flag so the UI's pause button freezes the mirror. Returns false
-   * when skipped. Subclasses with hydration-preserving merges compute the
-   * merged list themselves and call `setItems()`.
-   */
-  replaceAll(next) {
-    if (!this.enabled) return false;
-    this.setItems(next);
-    return true;
-  }
-
-  /**
-   * Patch one item in place (by id) and notify. Used to hydrate a mirrored
-   * item with detail payloads fetched on demand from the device.
-   */
-  hydrateById(id, patch) {
-    const index = this.items.findIndex(item => item.id === id);
-    if (index === -1) return;
-    this.items = [...this.items.slice(0, index), {
-      ...this.items[index],
-      ...patch
-    }, ...this.items.slice(index + 1)];
-    this.notifyListeners();
-  }
-
-  // ---- Enable / disable ----
-
-  setEnabled(enabled) {
-    this.enabled = enabled;
-  }
-  getEnabled() {
-    return this.enabled;
-  }
-  setMax(max) {
-    this.max = max;
-    if (this.items.length > max) {
-      this.items = this.items.slice(0, max);
-      this.notifyListeners();
-    }
-  }
-  getMax() {
-    return this.max;
-  }
-
-  // ---- Subscriptions ----
-
-  subscribe(listener) {
-    this.itemListeners.add(listener);
-    return () => {
-      this.itemListeners.delete(listener);
-    };
-  }
-  notifyListeners() {
-    const items = this.getAll();
-    this.itemListeners.forEach(listener => listener(items));
-  }
-  get listenerCount() {
-    return this.itemListeners.size;
-  }
-}
+"use strict";export class ChangeLog{items=[];itemListeners=new Set;clearListeners=new Set;idCounter=0;enabled=true;captureSuppressed=false;constructor(e={}){this.max=e.max??200}canRecord(){return this.enabled&&!this.captureSuppressed}nextId(){return`${Date.now()}-${++this.idCounter}`}push(e){this.items=[e,...this.items].slice(0,this.max)}record(e){this.push(e);this.notifyListeners()}setItems(e){this.items=e.slice(0,this.max);this.notifyListeners()}getAll(){return[...this.items]}getById(e){return this.items.find(t=>t.id===e)}get size(){return this.items.length}clear(){this.items=[];this.notifyListeners();this.clearListeners.forEach(e=>{try{e()}catch{}})}onClear(e){this.clearListeners.add(e);return()=>{this.clearListeners.delete(e)}}disableCapture(){this.captureSuppressed=true}isCaptureSuppressed(){return this.captureSuppressed}replaceAll(e){if(!this.enabled)return false;this.setItems(e);return true}hydrateById(e,t){const s=this.items.findIndex(i=>i.id===e);if(s===-1)return;this.items=[...this.items.slice(0,s),{...this.items[s],...t},...this.items.slice(s+1)];this.notifyListeners()}setEnabled(e){this.enabled=e}getEnabled(){return this.enabled}setMax(e){this.max=e;if(this.items.length>e){this.items=this.items.slice(0,e);this.notifyListeners()}}getMax(){return this.max}subscribe(e){this.itemListeners.add(e);return()=>{this.itemListeners.delete(e)}}notifyListeners(){const e=this.getAll();this.itemListeners.forEach(t=>t(e))}get listenerCount(){return this.itemListeners.size}}