@lumibase/sdk 0.21.0 → 0.22.0

package/dist/index.cjs

@@ -370,6 +370,7 @@ var RealtimeClient = class {
   opts;
   ws = null;
   subscriptions = /* @__PURE__ */ new Map();
+  subscriptionFilters = /* @__PURE__ */ new Map();
   presenceListeners = /* @__PURE__ */ new Set();
   currentPresence = {};
   sessionId = null;
@@ -402,14 +403,20 @@ var RealtimeClient = class {
    * Subscribe to item mutation events for a specific collection.
    * Multiple handlers per collection are supported.
    *
+   * `opts.filter` is an optional Directus-style condition rule evaluated
+   * server-side over the event envelope (`collection`/`action`/`itemId`) —
+   * studio broadcasts are signal-only, so row data is never filterable. The
+   * filter is per-collection: the most recent subscribe call's filter wins.
+   *
    * @returns Unsubscribe function.
    */
-  subscribe(collection, callback) {
+  subscribe(collection, callback, opts = {}) {
     if (!this.subscriptions.has(collection)) {
       this.subscriptions.set(collection, /* @__PURE__ */ new Set());
     }
     this.subscriptions.get(collection).add(callback);
-    this._send({ type: "subscribe", collection });
+    if (opts.filter) this.subscriptionFilters.set(collection, opts.filter);
+    this._send({ type: "subscribe", collection, ...opts.filter ? { filter: opts.filter } : {} });
     return () => this.unsubscribe(collection, callback);
   }
   /** Remove a specific handler from a collection subscription. */
@@ -419,6 +426,7 @@ var RealtimeClient = class {
     set.delete(callback);
     if (set.size === 0) {
       this.subscriptions.delete(collection);
+      this.subscriptionFilters.delete(collection);
       this._send({ type: "unsubscribe", collection });
     }
   }
@@ -483,7 +491,8 @@ var RealtimeClient = class {
     ws.addEventListener("open", () => {
       this.backoffMs = this.opts.initialBackoffMs ?? 1e3;
       for (const collection of this.subscriptions.keys()) {
-        this._sendRaw({ type: "subscribe", collection });
+        const filter = this.subscriptionFilters.get(collection);
+        this._sendRaw({ type: "subscribe", collection, ...filter ? { filter } : {} });
       }
       if (Object.keys(this.currentPresence).length > 0) {
         this._sendRaw({ type: "presence", ...this.currentPresence });

package/dist/index.d.cts

@@ -1563,6 +1563,7 @@ declare class RealtimeClient {
     private readonly opts;
     private ws;
     private readonly subscriptions;
+    private readonly subscriptionFilters;
     private presenceListeners;
     private currentPresence;
     private sessionId;
@@ -1578,9 +1579,16 @@ declare class RealtimeClient {
      * Subscribe to item mutation events for a specific collection.
      * Multiple handlers per collection are supported.
      *
+     * `opts.filter` is an optional Directus-style condition rule evaluated
+     * server-side over the event envelope (`collection`/`action`/`itemId`) —
+     * studio broadcasts are signal-only, so row data is never filterable. The
+     * filter is per-collection: the most recent subscribe call's filter wins.
+     *
      * @returns Unsubscribe function.
      */
-    subscribe(collection: string, callback: RealtimeEventCallback): () => void;
+    subscribe(collection: string, callback: RealtimeEventCallback, opts?: {
+        filter?: Record<string, unknown>;
+    }): () => void;
     /** Remove a specific handler from a collection subscription. */
     unsubscribe(collection: string, callback: RealtimeEventCallback): void;
     /** Update the current user's presence. Sent immediately and on reconnect. */

package/dist/index.d.ts

@@ -1563,6 +1563,7 @@ declare class RealtimeClient {
     private readonly opts;
     private ws;
     private readonly subscriptions;
+    private readonly subscriptionFilters;
     private presenceListeners;
     private currentPresence;
     private sessionId;
@@ -1578,9 +1579,16 @@ declare class RealtimeClient {
      * Subscribe to item mutation events for a specific collection.
      * Multiple handlers per collection are supported.
      *
+     * `opts.filter` is an optional Directus-style condition rule evaluated
+     * server-side over the event envelope (`collection`/`action`/`itemId`) —
+     * studio broadcasts are signal-only, so row data is never filterable. The
+     * filter is per-collection: the most recent subscribe call's filter wins.
+     *
      * @returns Unsubscribe function.
      */
-    subscribe(collection: string, callback: RealtimeEventCallback): () => void;
+    subscribe(collection: string, callback: RealtimeEventCallback, opts?: {
+        filter?: Record<string, unknown>;
+    }): () => void;
     /** Remove a specific handler from a collection subscription. */
     unsubscribe(collection: string, callback: RealtimeEventCallback): void;
     /** Update the current user's presence. Sent immediately and on reconnect. */

package/dist/index.js

@@ -293,6 +293,7 @@ var RealtimeClient = class {
   opts;
   ws = null;
   subscriptions = /* @__PURE__ */ new Map();
+  subscriptionFilters = /* @__PURE__ */ new Map();
   presenceListeners = /* @__PURE__ */ new Set();
   currentPresence = {};
   sessionId = null;
@@ -325,14 +326,20 @@ var RealtimeClient = class {
    * Subscribe to item mutation events for a specific collection.
    * Multiple handlers per collection are supported.
    *
+   * `opts.filter` is an optional Directus-style condition rule evaluated
+   * server-side over the event envelope (`collection`/`action`/`itemId`) —
+   * studio broadcasts are signal-only, so row data is never filterable. The
+   * filter is per-collection: the most recent subscribe call's filter wins.
+   *
    * @returns Unsubscribe function.
    */
-  subscribe(collection, callback) {
+  subscribe(collection, callback, opts = {}) {
     if (!this.subscriptions.has(collection)) {
       this.subscriptions.set(collection, /* @__PURE__ */ new Set());
     }
     this.subscriptions.get(collection).add(callback);
-    this._send({ type: "subscribe", collection });
+    if (opts.filter) this.subscriptionFilters.set(collection, opts.filter);
+    this._send({ type: "subscribe", collection, ...opts.filter ? { filter: opts.filter } : {} });
     return () => this.unsubscribe(collection, callback);
   }
   /** Remove a specific handler from a collection subscription. */
@@ -342,6 +349,7 @@ var RealtimeClient = class {
     set.delete(callback);
     if (set.size === 0) {
       this.subscriptions.delete(collection);
+      this.subscriptionFilters.delete(collection);
       this._send({ type: "unsubscribe", collection });
     }
   }
@@ -406,7 +414,8 @@ var RealtimeClient = class {
     ws.addEventListener("open", () => {
       this.backoffMs = this.opts.initialBackoffMs ?? 1e3;
       for (const collection of this.subscriptions.keys()) {
-        this._sendRaw({ type: "subscribe", collection });
+        const filter = this.subscriptionFilters.get(collection);
+        this._sendRaw({ type: "subscribe", collection, ...filter ? { filter } : {} });
       }
       if (Object.keys(this.currentPresence).length > 0) {
         this._sendRaw({ type: "presence", ...this.currentPresence });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumibase/sdk",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "LumiBase JS SDK (REST + WebSocket) + typegen core. Isomorphic ESM.",
   "type": "module",
   "repository": {