@livequery/react 2.0.137 → 2.0.138

package/README.md

@@ -91,7 +91,6 @@ The hook must be used under a matching provider. If it is called outside the pro
 Use it when a component needs the full collection API: reactive state plus methods such as querying or mutations.
 
 ```tsx
-import { useEffect } from 'react'
 import { useCollection, useObservable } from '@livequery/react'
 
 type Todo = {
@@ -101,15 +100,12 @@ type Todo = {
 }
 
 export function TodoList() {
+  // lazy: false — collection queries automatically on initialization
   const collection = useCollection<Todo>('todos', { lazy: false })
   const items = useObservable(collection.items, [])
   const loading = useObservable(collection.loading, false)
   const error = useObservable(collection.error)
 
-  useEffect(() => {
-    collection.query()
-  }, [collection])
-
   if (loading) return <p>Loading...</p>
   if (error) return <p>Could not load todos.</p>
 
@@ -123,6 +119,8 @@ export function TodoList() {
 }
 ```
 
+When `lazy: false`, the collection queries automatically when initialized — no `useEffect` or manual `collection.query()` call is needed. Use `lazy: true` (the default) when you need to control when the query fires, such as after user interaction or after other async setup completes.
+
 Behavior notes:
 
 - `ref` may be `undefined`, `null`, `false`, or an empty string. Falsy refs skip initialization.
@@ -239,7 +237,6 @@ function TodoLoading({ loading$ }: { loading$: BehaviorSubject<boolean> }) {
 ### Full example
 
 ```tsx
-import { useEffect } from 'react'
 import { BehaviorSubject } from 'rxjs'
 import { useCollection, useObservable } from '@livequery/react'
 
@@ -257,13 +254,10 @@ function TodoItem({ item$ }: { item$: BehaviorSubject<Todo> }) {
 }
 
 export function TodoList() {
-  const collection = useCollection<Todo>('todos')
+  // lazy: false — no need to call collection.query() manually
+  const collection = useCollection<Todo>('todos', { lazy: false })
   const items = useObservable(collection.items, [])
 
-  useEffect(() => {
-    collection.query()
-  }, [collection])
-
   return (
     <>
       <TodoLoading loading$={collection.loading} />

package/package.json

@@ -4,7 +4,7 @@
     "url": "https://github.com/livequery/react"
   },
   "type": "module",
-  "version": "2.0.137",
+  "version": "2.0.138",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",