@pylonsync/react 0.3.227 → 0.3.228

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.227",
+  "version": "0.3.228",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -12,8 +12,8 @@
     "check": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@pylonsync/sdk": "0.3.227",
-    "@pylonsync/sync": "0.3.227"
+    "@pylonsync/sdk": "0.3.228",
+    "@pylonsync/sync": "0.3.228"
   },
   "peerDependencies": {
     "react": ">=19.0.0"

package/src/hooks.ts

@@ -129,6 +129,16 @@ export function useQuery<T = Row>(
 
   const data = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
 
+  // Register interest so the reconcile safety net sweeps this entity
+  // even when the local replica has zero rows for it. Without this, a
+  // server row in a never-cached entity (created on another surface, a
+  // freshly-added entity) stays invisible until a full snapshot / cache
+  // clear. The first observe of an empty+hydrated entity also fires a
+  // one-shot fetch so it appears on mount. See SyncEngine.observeEntity.
+  useEffect(() => {
+    sync.observeEntity(entity);
+  }, [sync, entity]);
+
   const refetch = useCallback(() => {
     loading.current = true;
     error.current = null;
@@ -201,6 +211,12 @@ export function useQueryOne<T = Row>(
 
   const data = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
 
+  // Register interest so reconcile sweeps this entity even with zero
+  // local rows. See SyncEngine.observeEntity.
+  useEffect(() => {
+    sync.observeEntity(entity);
+  }, [sync, entity]);
+
   const refetch = useCallback(() => {
     loading.current = true;
     error.current = null;