@bunbase-ae/react-sdk 2.13.3-next.304.484953e → 2.14.1-next.321.8b883e8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/react-sdk",
-  "version": "2.13.3-next.304.484953e",
+  "version": "2.14.1-next.321.8b883e8",
   "type": "module",
   "description": "React hooks for BunBase — caching, mutations, auth, realtime",
   "license": "UNLICENSED",
@@ -37,7 +37,7 @@
   "peerDependencies": {
     "react": ">=19",
     "react-dom": ">=19",
-    "@bunbase-ae/js": ">=2.13.3-next.304.484953e"
+    "@bunbase-ae/js": ">=2.14.1-next.321.8b883e8"
   },
   "devDependencies": {
     "@types/react": "19.2.14",

package/src/realtimeCacheSync.ts

@@ -0,0 +1,30 @@
+// Realtime cache-sync — shared between useList(realtime: true) and useRealtime(invalidateCache: true).
+//
+//   update → write the record to its get-key (instant UI), invalidate list-keys
+//   delete → invalidate the record's get-key + list-keys
+//   create → invalidate list-keys only (can't safely insert into sorted/filtered lists)
+//
+// Note: the per-record cache key is keyed off `record._id` — the server's
+// BunBaseRecord uses `_id` (with leading underscore), not `id`. Earlier
+// inline copies of this block read `record.id` and silently wrote to
+// `<col>:get:undefined`.
+
+import type { RealtimeEvent } from "@bunbase-ae/js";
+import type { QueryCache } from "./cache";
+
+export function applyRealtimeCacheSync<T extends Record<string, unknown>>(
+  cache: QueryCache,
+  event: RealtimeEvent<T>,
+): void {
+  const col = event.collection;
+  const id = event.record._id;
+  if (event.event === "update") {
+    cache.setData(`${col}:get:${id}`, event.record);
+    cache.invalidate(`${col}:list`);
+  } else if (event.event === "delete") {
+    cache.invalidate(`${col}:get:${id}`);
+    cache.invalidate(`${col}:list`);
+  } else {
+    cache.invalidate(`${col}:list`);
+  }
+}

package/src/useList.ts

@@ -4,6 +4,7 @@ import type { BunBaseRecord, ListQuery, ListResult, WithExpand } from "@bunbase-
 import { useCallback, useEffect, useReducer, useRef } from "react";
 import { useBunBase } from "./Context";
 import type { CacheEntry } from "./cache";
+import { applyRealtimeCacheSync } from "./realtimeCacheSync";
 
 // Stable JSON — sorts keys so query object identity doesn't matter.
 function stableKey(value: unknown): string {
@@ -115,22 +116,10 @@ export function useList<
   }, [cache, cacheKey, staleTime, options.refetchInterval, enabled]);
 
   // Realtime: smart cache sync on any collection change.
-  //   update → write directly to get cache (instant) + invalidate list
-  //   delete → remove get cache entry + invalidate list
-  //   create → invalidate list only (can't safely insert into sorted/filtered list)
   useEffect(() => {
     if (!options.realtime || !enabled) return;
     return client.realtime.subscribe(`collection:${collection}`, (event) => {
-      const id = event.record.id;
-      if (event.event === "update") {
-        cache.setData(`${collection}:get:${id}`, event.record);
-        cache.invalidate(`${collection}:list`);
-      } else if (event.event === "delete") {
-        cache.invalidate(`${collection}:get:${id}`);
-        cache.invalidate(`${collection}:list`);
-      } else {
-        cache.invalidate(`${collection}:list`);
-      }
+      applyRealtimeCacheSync(cache, event);
     });
   }, [client, collection, cache, options.realtime, enabled]);
 

package/src/useRealtime.ts

@@ -5,6 +5,7 @@
 import type { RealtimeEvent, SubscribeOptions } from "@bunbase-ae/js";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useBunBase } from "./Context";
+import { applyRealtimeCacheSync } from "./realtimeCacheSync";
 
 // ─── useRealtime ─────────────────────────────────────────────────────────────
 
@@ -47,20 +48,7 @@ export function useRealtime<T extends Record<string, unknown> = Record<string, u
       (event) => {
         cbRef.current?.(event);
         if (optsRef.current.invalidateCache) {
-          const col = event.collection;
-          const id = event.record.id;
-          if (event.event === "update") {
-            // Write updated record directly to get cache — instant UI, no round-trip.
-            cache.setData(`${col}:get:${id}`, event.record);
-            // Invalidate list cache so any ordering/filter changes are reflected.
-            cache.invalidate(`${col}:list`);
-          } else if (event.event === "delete") {
-            cache.invalidate(`${col}:get:${id}`);
-            cache.invalidate(`${col}:list`);
-          } else {
-            // create — can't safely insert into sorted/filtered lists.
-            cache.invalidate(`${col}:list`);
-          }
+          applyRealtimeCacheSync(cache, event);
         }
       },
       { events, filter, ids },