@telestack/db-sdk 1.0.6 → 1.0.9

package/dist/index.d.ts

@@ -116,6 +116,8 @@ export declare class Query<T = any> {
     private buildWhereClause;
     /** Fetch documents matching the query */
     get(): Promise<T[]>;
+    /** Apply sorting and limiting in-memory */
+    private applyOptions;
     /** Check if a document matches the local filters */
     private matches;
     /** Subscribe to realtime updates for this query */
@@ -126,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

@@ -364,23 +364,33 @@ export class Query {
                 const filtered = allDocs
                     .filter(d => d.path.startsWith(this.path) && this.matches(d.data))
                     .map(d => ({ id: d.path.split('/').pop(), data: d.data, metadata: { fromCache: true, hasPendingWrites: true } }));
-                // Sort locally if needed
-                if (this.orderByField) {
-                    filtered.sort((a, b) => {
-                        const valA = a[this.orderByField];
-                        const valB = b[this.orderByField];
-                        if (this.orderDirection === 'asc')
-                            return valA > valB ? 1 : -1;
-                        return valA < valB ? 1 : -1;
-                    });
-                }
-                if (this.limitCount)
-                    return filtered.slice(0, this.limitCount);
-                return filtered;
+                return this.applyOptions(filtered);
             }
             throw e;
         }
     }
+    /** Apply sorting and limiting in-memory */
+    applyOptions(docs) {
+        let results = [...docs];
+        if (this.orderByField) {
+            results.sort((a, b) => {
+                const valA = a.data ? a.data[this.orderByField] : a[this.orderByField];
+                const valB = b.data ? b.data[this.orderByField] : b[this.orderByField];
+                if (valA === undefined || valA === null)
+                    return 1;
+                if (valB === undefined || valB === null)
+                    return -1;
+                if (valA === valB)
+                    return 0;
+                const comparison = valA > valB ? 1 : -1;
+                return this.orderDirection === 'asc' ? comparison : -comparison;
+            });
+        }
+        if (this.limitCount) {
+            results = results.slice(0, this.limitCount);
+        }
+        return results;
+    }
     /** Check if a document matches the local filters */
     matches(doc) {
         for (const filter of this.filters) {
@@ -434,8 +444,8 @@ export class Query {
         }
         const debouncedCallback = () => {
             if (this.debounceTimer)
-                clearTimeout(this.debounceTimer);
-            this.debounceTimer = setTimeout(() => callback([...this.docsCache]), 50);
+                cancelAnimationFrame(this.debounceTimer);
+            this.debounceTimer = requestAnimationFrame(() => callback([...this.docsCache]));
         };
         sub.on('publication', async (ctx) => {
             const event = ctx.data;
@@ -446,26 +456,14 @@ export class Query {
             const docId = event.id || (event.doc && event.doc.id);
             if (event.type === 'CREATED' || event.type === 'SET') {
                 if (this.matches(event.doc.data)) {
-                    if (this.limitCount || this.orderByField) {
-                        const docs = await this.get();
-                        this.docsCache = docs;
-                        callback(docs);
-                    }
-                    else {
-                        this.docsCache = [...this.docsCache.filter(d => d.id !== docId), { id: docId, data: event.doc.data }];
-                        changed = true;
-                    }
+                    this.docsCache = [...this.docsCache.filter(d => d.id !== docId), { id: docId, data: event.doc.data }];
+                    changed = true;
                 }
             }
             else if (event.type === 'UPDATED') {
                 const docData = event.doc ? event.doc.data : (event.patch ? event.patch : {});
                 const matches = this.matches(docData);
-                if (this.limitCount || this.orderByField) {
-                    const docs = await this.get();
-                    this.docsCache = docs;
-                    callback(docs);
-                }
-                else if (matches) {
+                if (matches) {
                     this.docsCache = this.docsCache.map(d => d.id === docId ? { ...d, data: { ...d.data, ...docData } } : d);
                     changed = true;
                 }
@@ -478,7 +476,8 @@ export class Query {
                 this.docsCache = this.docsCache.filter(d => d.id !== docId);
                 changed = true;
             }
-            if (changed && !(this.limitCount || this.orderByField)) {
+            if (changed) {
+                this.docsCache = this.applyOptions(this.docsCache);
                 debouncedCallback();
             }
         });
@@ -517,6 +516,40 @@ 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);
+            sub.subscribe();
+        }
+        await sub.publish({ type: 'SIGNAL', data, userId: this.client.config.userId });
+    }
+    /** 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.6",
+    "version": "1.0.9",
     "description": "Fluent, real-time SDK for Telestack DB",
     "type": "module",
     "main": "dist/index.js",