@powersync/common 0.0.0-dev-20250714144421 → 0.0.0-dev-20250715080712

package/lib/utils/BaseObserver.d.ts

@@ -1,15 +1,14 @@
 export interface Disposable {
-    dispose: () => Promise<void>;
+    dispose: () => Promise<void> | void;
 }
+export type BaseListener = Record<string, ((...event: any) => any) | undefined>;
 export interface BaseObserverInterface<T extends BaseListener> {
     registerListener(listener: Partial<T>): () => void;
 }
-export type BaseListener = {
-    [key: string]: ((...event: any) => any) | undefined;
-};
 export declare class BaseObserver<T extends BaseListener = BaseListener> implements BaseObserverInterface<T> {
     protected listeners: Set<Partial<T>>;
     constructor();
+    dispose(): void;
     /**
      * Register a listener for updates to the PowerSync client.
      */

package/lib/utils/BaseObserver.js

@@ -1,6 +1,9 @@
 export class BaseObserver {
     listeners = new Set();
     constructor() { }
+    dispose() {
+        this.listeners.clear();
+    }
     /**
      * Register a listener for updates to the PowerSync client.
      */

package/lib/utils/MetaBaseObserver.d.ts

@@ -0,0 +1,29 @@
+import { BaseListener, BaseObserver, BaseObserverInterface } from './BaseObserver.js';
+/**
+ * Represents the counts of listeners for each event type in a BaseListener.
+ */
+export type ListenerCounts<Listener extends BaseListener> = Partial<Record<keyof Listener, number>> & {
+    total: number;
+};
+/**
+ * Meta listener which reports the counts of listeners for each event type.
+ */
+export interface MetaListener<ParentListener extends BaseListener> extends BaseListener {
+    listenersChanged?: (counts: ListenerCounts<ParentListener>) => void;
+}
+export interface ListenerMetaManager<Listener extends BaseListener> extends BaseObserverInterface<MetaListener<Listener>> {
+    counts: ListenerCounts<Listener>;
+}
+export interface MetaBaseObserverInterface<Listener extends BaseListener> extends BaseObserverInterface<Listener> {
+    listenerMeta: ListenerMetaManager<Listener>;
+}
+/**
+ * A BaseObserver that tracks the counts of listeners for each event type.
+ */
+export declare class MetaBaseObserver<Listener extends BaseListener> extends BaseObserver<Listener> implements MetaBaseObserverInterface<Listener> {
+    protected get listenerCounts(): ListenerCounts<Listener>;
+    get listenerMeta(): ListenerMetaManager<Listener>;
+    protected metaListener: BaseObserver<MetaListener<Listener>>;
+    constructor();
+    registerListener(listener: Partial<Listener>): () => void;
+}

package/lib/utils/MetaBaseObserver.js

@@ -0,0 +1,50 @@
+import { BaseObserver } from './BaseObserver.js';
+/**
+ * A BaseObserver that tracks the counts of listeners for each event type.
+ */
+export class MetaBaseObserver extends BaseObserver {
+    get listenerCounts() {
+        const counts = {};
+        let total = 0;
+        for (const listener of this.listeners) {
+            for (const key in listener) {
+                if (listener[key]) {
+                    counts[key] = (counts[key] ?? 0) + 1;
+                    total++;
+                }
+            }
+        }
+        return {
+            ...counts,
+            total
+        };
+    }
+    get listenerMeta() {
+        return {
+            counts: this.listenerCounts,
+            // Allows registering a meta listener that will be notified of changes in listener counts
+            registerListener: (listener) => {
+                return this.metaListener.registerListener(listener);
+            }
+        };
+    }
+    metaListener;
+    constructor() {
+        super();
+        this.metaListener = new BaseObserver();
+    }
+    registerListener(listener) {
+        const dispose = super.registerListener(listener);
+        const updatedCount = this.listenerCounts;
+        this.metaListener.iterateListeners((l) => {
+            l.listenersChanged?.(updatedCount);
+        });
+        return () => {
+            dispose();
+            const updatedCount = this.listenerCounts;
+            this.metaListener.iterateListeners((l) => {
+                l.listenersChanged?.(updatedCount);
+            });
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/common",
-  "version": "0.0.0-dev-20250714144421",
+  "version": "0.0.0-dev-20250715080712",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"