mikser-io-sdk-api 3.5.0 → 3.5.1

package/README.md

@@ -453,6 +453,8 @@ For framework integration, prefer `live()` below — it handles the list+watch c
 
 The higher-level real-time primitive. Calls `onChange(items)` with the initial snapshot, then again with the patched array on every create/update/delete event. Returns a dispose function.
 
+The initial snapshot is the **complete** matching set — `live()` paginates to the end, it doesn't stop at the server's default page size. This keeps the snapshot consistent with the SSE stream that follows: `watch()` subscribes by filter with no limit, so a create/update/delete to *any* matching entity is delivered; if the snapshot were capped at page one, updates to entities past it would silently no-op (they aren't in `items`) and the view would drift. Pass `limit` (or `skip`) only when you want a bounded window — a "latest N" feed — and accept that updates outside that window won't be reflected.
+
 ```js
 const dispose = docs.live(
     { 'meta.published': true, type: 'document' },
@@ -476,7 +478,8 @@ dispose()
 Equivalent to:
 
 ```js
-// 1. await list({ filter, sort, fields, limit, skip })
+// 1. paginate list({ filter, sort, fields }) to the end  (or one bounded
+//    list() when limit/skip is set)
 // 2. onChange(items)
 // 3. for await (event of watch({ filter })) patch + onChange
 // 4. abort on dispose

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mikser-io-sdk-api",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "Client SDK for mikser-io's api plugin — query the document catalog from the browser or Node",
   "main": "index.js",
   "types": "index.d.ts",

package/src/entities.js

@@ -556,19 +556,45 @@ export function createEntitiesClient({ baseUrl, basePath, fetch: doFetch, header
                     }
 
                     if (!usedFastPath) {
-                        // Pass { quiet } so list()'s wide-warning honors
-                        // the live() caller's quiet opt.
+                        // The initial snapshot must be the COMPLETE matching
+                        // set, not a single server page. watch() below
+                        // subscribes by filter with no limit, so create /
+                        // update / delete events arrive for ANY matching
+                        // entity. If the initial load stopped at the server's
+                        // default page size, an update to an entity past page 1
+                        // would silently no-op (it isn't in `items`) and a
+                        // create could append out of sort order — the live view
+                        // would drift out of sync with its own change stream.
+                        // So paginate to completion, unless the caller opted
+                        // into a bounded window via `limit` or `skip`.
                         //
-                        // `expand` flows through to the initial snapshot
-                        // call AND to watch() below, so the server's
-                        // graph-subscription path (runtime.refs) emits
-                        // already-expanded entities on every mutation
-                        // within the expansion graph. Update events
-                        // replace items in place with the new expanded
-                        // shape, keeping the consumer's view consistent.
-                        const env = await list({ filter, sort, fields, limit, skip, expand }, { quiet })
-                        if (disposed || ac.signal.aborted) return
-                        items = env.items
+                        // Pass { quiet } so list()'s wide-warning honors the
+                        // live() caller's quiet opt.
+                        //
+                        // `expand` flows through to the initial snapshot call
+                        // AND to watch() below, so the server's graph-
+                        // subscription path (runtime.refs) emits already-
+                        // expanded entities on every mutation within the
+                        // expansion graph. Update events replace items in place
+                        // with the new expanded shape, keeping the consumer's
+                        // view consistent.
+                        const bounded = limit != null || skip != null
+                        if (bounded) {
+                            const env = await list({ filter, sort, fields, limit, skip, expand }, { quiet })
+                            if (disposed || ac.signal.aborted) return
+                            items = env.items
+                        } else {
+                            const collected = []
+                            let page = 1
+                            while (true) {
+                                const env = await list({ filter, sort, fields, expand, limit: 1000, page }, { quiet })
+                                if (disposed || ac.signal.aborted) return
+                                collected.push(...env.items)
+                                if (!env.hasNext) break
+                                page = env.page + 1
+                            }
+                            items = collected
+                        }
                         onChange(items)
                     }