@spooky-sync/client-solid2 0.0.1-canary.332 → 0.0.1-canary.334

package/AGENTS.md

@@ -41,8 +41,8 @@ Provider props are identical to client-solid: `config`, `fallback`, `preload` (a
   - `error()` — registration/sync failure (e.g. SSP 503 NOT_READY). Never thrown into the render tree; the sync scheduler retries underneath.
   - `isLoading()` — cold first load only (nothing painted for this identity, server not heard, no error). A cached paint ends it; an authoritative empty answer ends it. Never true again for the same identity.
   - `isFetching()` — a fetch cycle is in flight (registration, a sync round).
-  - `isAuthoritative()` — server membership is known for this identity (latched until it changes). `hasData()` — `data()` holds something. `isEmpty()` — authoritative AND no data: the server said "no rows"; render empty states on this, not on `!hasData()`.
-  - `isSettled()` — authoritative AND idle; gate windowed-list end detection on it. Not monotonic; latch it (a `createMemo(prev => prev || q.isSettled())`) for a verdict that must stick.
+  - `isAuthoritative()`: `data()` holds the rendered rows of a known membership (the server's, or one a previous session left on this device); a known set whose rows are not painted yet, as right after a sign-in, does not count. Latched until the identity changes. `hasData()`: `data()` holds something. `isEmpty()`: authoritative AND no data: the server said "no rows"; render empty states on this, not on `!hasData()`.
+  - `isSettled()`: authoritative AND idle; gate windowed-list end detection and create-if-missing on it (the re-registration that confirms a cached answer counts as fetching). Not monotonic; latch it (a `createMemo(prev => prev || q.isSettled())`) for a verdict that must stick.
   - Options: `enabled?: () => boolean`, `deregisterOnCleanup?: boolean`.
 - **`createSubmission(fn)`** — button pending/error state around a mutation: `submit()`, `pending()`, `error()`, `result()`, `clearError()`. There is deliberately no `action()` / `createOptimisticStore` layer (see `src/lib/create-submission.ts`).
 - **`useSyncActivity(options?)`** — `{ fetchingQueries, pendingMutations, isDownloading, isUploading }`. One subscription on the engine's aggregate fetch count (queries with traffic the user waits on: a first registration or rows to download; a re-registration of a query that already shows rows, as after a reload, is left out) plus the outbox depth; both are debounced ON by their delay (`downloadDelayMs` 200, `uploadDelayMs` 150) and off at once, and `isUploading()` additionally needs `pendingMutations() > uploadThreshold` (0, so any unacknowledged write counts). Drive a logo/traffic indicator off it; pair with `useSyncStatus().connection()` / `.isOffline()` to switch the same mark to a reconnecting or offline state and show the unsaved count.

package/QUICK_START.md

@@ -83,10 +83,10 @@ import { Loading } from 'solid-js';
 | `error()` | Registration/sync error (e.g. SSP 503 during bootstrap). Never thrown into the render tree; the sync scheduler retries underneath. |
 | `isLoading()` | Cold first load only: nothing painted for this identity yet, server not heard, no error. A cached paint ends it; so does the server answering with zero rows. |
 | `isFetching()` | Sync engine is pulling records for this query. |
-| `isAuthoritative()` | Server membership is known for this identity (registration/poll landed, or a previous session's membership was read on boot). Latched until the identity changes. |
+| `isAuthoritative()` | `data()` holds the rendered rows of a known membership for this identity: the server's answer (once its rows are local) or the membership a previous session left on this device. A known set whose rows are not painted yet (right after a sign-in or on boot) does not count. Latched until the identity changes. |
 | `hasData()` | `data()` holds rows (or the `.one()` row). |
 | `isEmpty()` | Authoritative AND no data — the server said "no rows". Render empty states on this. |
-| `isSettled()` | Authoritative AND idle — windowed lists may trust a short result as the true end of the list. Re-enters on later sync rounds; latch it for a sticky verdict. |
+| `isSettled()` | Authoritative AND idle: windowed lists may trust a short result as the true end of the list, and a missing row is missing. The re-registration that confirms a cached answer counts as fetching. Re-enters on later sync rounds; latch it for a sticky verdict. |
 
 Options: `{ enabled?: () => boolean, deregisterOnCleanup?: boolean }` — both as in client-solid.
 

package/dist/index.cjs

@@ -246,12 +246,6 @@ function createQuery(dbOrQuery, queryOrOptions, maybeOptions) {
 			if (disposed || myRun !== runId) return;
 			activeHash = hash;
 			addCleanup(sp00ky.subscribeQueryStatus(hash, (status) => setIsFetching(status === "fetching"), { immediate: true }));
-			addCleanup(sp00ky.subscribeQueryAuthority(hash, (known) => {
-				if (disposed || myRun !== runId) return;
-				setIsAuthoritative(known);
-				if (known) wakeReady();
-				else setHasPainted(false);
-			}, { immediate: true }));
 			addCleanup(sp00ky.subscribe(hash, (rows) => {
 				if (disposed || myRun !== runId) return;
 				const queryData = query.isOne ? rows[0] ?? null : rows;
@@ -266,6 +260,12 @@ function createQuery(dbOrQuery, queryOrOptions, maybeOptions) {
 				});
 				sp00ky.reportFrontendTiming(hash, performance.now() - t0);
 			}, { immediate: true }));
+			addCleanup(sp00ky.subscribeQueryAuthority(hash, (known) => {
+				if (disposed || myRun !== runId) return;
+				setIsAuthoritative(known);
+				if (known) wakeReady();
+				else setHasPainted(false);
+			}, { immediate: true }));
 		}).catch((err) => {
 			if (disposed || myRun !== runId) return;
 			setError(err instanceof Error ? err : new Error(String(err)));