@telestack/db-sdk 1.0.8 → 1.1.1

package/dist/index.d.ts

@@ -128,6 +128,10 @@ export declare class Query<T = any> {
         user: string;
         clientId: string;
     }) => void): () => void;
+    /** Broadcast a transient signal to this collection (bypasses database) */
+    signal(data: any): Promise<void>;
+    /** Listen for transient signals on this collection */
+    onSignal(callback: (data: any) => void): () => void;
 }
 /**
  * CollectionReference extends Query with add() and doc() methods

package/dist/index.js

@@ -516,6 +516,57 @@ export class Query {
             sub.removeAllListeners();
         };
     }
+    /** Broadcast a transient signal to this collection (bypasses database) */
+    async signal(data) {
+        const centrifuge = this.client.getCentrifuge();
+        if (!centrifuge)
+            return;
+        const channel = `collection:${this.path.replace(/\//g, '_')}`;
+        let sub = centrifuge.getSubscription(channel);
+        if (!sub) {
+            sub = centrifuge.newSubscription(channel);
+        }
+        if (sub.state !== 'subscribed') {
+            sub.subscribe();
+            // Wait for subscription to be ready
+            await new Promise((resolve) => {
+                const onSubscribed = () => {
+                    sub?.off('subscribed', onSubscribed);
+                    resolve();
+                };
+                sub?.on('subscribed', onSubscribed);
+                // timeout after 2s to prevent hanging
+                setTimeout(resolve, 2000);
+            });
+        }
+        try {
+            await sub.publish({ type: 'SIGNAL', data, userId: this.client.config.userId });
+        }
+        catch (e) {
+            console.warn("Telestack: Signal failed", e);
+        }
+    }
+    /** Listen for transient signals on this collection */
+    onSignal(callback) {
+        const centrifuge = this.client.getCentrifuge();
+        if (!centrifuge)
+            return () => { };
+        const channel = `collection:${this.path.replace(/\//g, '_')}`;
+        let sub = centrifuge.getSubscription(channel);
+        if (!sub) {
+            sub = centrifuge.newSubscription(channel);
+        }
+        const handler = (ctx) => {
+            if (ctx.data.type === 'SIGNAL') {
+                callback({ ...ctx.data.data, _userId: ctx.data.userId });
+            }
+        };
+        sub.on('publication', handler);
+        sub.subscribe();
+        return () => {
+            sub.off('publication', handler);
+        };
+    }
 }
 /**
  * CollectionReference extends Query with add() and doc() methods

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@telestack/db-sdk",
-    "version": "1.0.8",
+    "version": "1.1.1",
     "description": "Fluent, real-time SDK for Telestack DB",
     "type": "module",
     "main": "dist/index.js",