@syncular/react 0.24.0 → 0.25.1

package/README.md

@@ -66,8 +66,8 @@ availability, refresh }`. `availability` is the typed `ready`, `migrating`, or
   schema is incompatible or the browser leader is unreachable. `isLoading`
   is `false`; previously read rows remain available for deliberate read-only
   UI, and `availability.reason` identifies the boundary;
-- `error`: the initial read failed. A later refresh error keeps existing rows
-  and phase visible through `error`/`isRefreshing`.
+- `error`: the latest read failed. A refresh error keeps the rows and revision
+  from the last successful read while setting `isRefreshing` to `false`.
 
 ## Provider and async initialization
 
@@ -279,6 +279,13 @@ mirrored store. The maintained fixture and upgrade guidance live in the
 
 ### Privacy-safe support view
 
+Failed generated and raw live-query reads appear in
+`diagnosticsSnapshot().queryFailures` until that query reads successfully.
+Each entry contains only the stable PHI-free query id, generated table names,
+a stable error code, an optional SQLite result code, and the first failure
+time. It never contains SQL, parameters, rows, or SQLite error prose. Raw SQL
+uses the diagnostic id `raw` unless `useRawSql` receives an explicit `id`.
+
 Use application-owned, stable, PHI-free subscription ids to make missing
 registration distinguishable from a completed zero-row bootstrap. The hook
 refreshes after diagnostics events on direct, Worker, Tauri, and React Native

package/dist/runtime-version.d.ts

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export declare const SYNCULAR_REACT_RUNTIME_VERSION = "0.24.0";
+export declare const SYNCULAR_REACT_RUNTIME_VERSION = "0.25.1";

package/dist/runtime-version.js

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export const SYNCULAR_REACT_RUNTIME_VERSION = '0.24.0';
+export const SYNCULAR_REACT_RUNTIME_VERSION = '0.25.1';

package/dist/use-raw-sql.d.ts

@@ -12,7 +12,11 @@ export interface UseRawSqlOptions<Row = SqlRow> {
     /** Generated coverage claims its windows by default. */
     readonly claimCoverage?: boolean;
     readonly enabled?: boolean;
-    /** Stable identity override for a raw query cache entry. */
+    /**
+     * Stable, PHI-free query id. It names the query in
+     * `diagnosticsSnapshot().queryFailures`; without it the query reports as
+     * `raw`.
+     */
     readonly id?: string;
 }
 export interface UseRawSqlResult<Row> {

package/dist/use-raw-sql.js

@@ -35,7 +35,9 @@ export function useRawSql(sql, params, options) {
     // identity; executable decoders and row keys follow function identity.
     // oxlint-disable react-hooks/exhaustive-deps -- canonical value identity is the dependency
     const entry = useMemo(() => store.query({
-        id: options?.id ?? `raw:${identity}`,
+        // The store keys entries by SQL, params, and dependencies as well, so
+        // the id only names the query in diagnostics and never carries SQL.
+        id: options?.id ?? 'raw',
         sql,
         ...(params !== undefined ? { params } : {}),
         dependencies,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/react",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "description": "React hooks for Syncular offline-first sync",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -55,15 +55,15 @@
     "test": "bun test --preload ./test/setup.ts"
   },
   "dependencies": {
-    "@syncular/client": "0.24.0"
+    "@syncular/client": "0.25.1"
   },
   "peerDependencies": {
     "react": ">=18.0.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.0.0",
-    "@syncular/core": "0.24.0",
-    "@syncular/server": "0.24.0",
+    "@syncular/core": "0.25.1",
+    "@syncular/server": "0.25.1",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",

package/src/runtime-version.ts

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export const SYNCULAR_REACT_RUNTIME_VERSION = '0.24.0';
+export const SYNCULAR_REACT_RUNTIME_VERSION = '0.25.1';

package/src/use-raw-sql.ts

@@ -24,7 +24,11 @@ export interface UseRawSqlOptions<Row = SqlRow> {
   /** Generated coverage claims its windows by default. */
   readonly claimCoverage?: boolean;
   readonly enabled?: boolean;
-  /** Stable identity override for a raw query cache entry. */
+  /**
+   * Stable, PHI-free query id. It names the query in
+   * `diagnosticsSnapshot().queryFailures`; without it the query reports as
+   * `raw`.
+   */
   readonly id?: string;
 }
 
@@ -81,7 +85,9 @@ export function useRawSql<Row = SqlRow>(
   const entry = useMemo(
     () =>
       store.query<Row>({
-        id: options?.id ?? `raw:${identity}`,
+        // The store keys entries by SQL, params, and dependencies as well, so
+        // the id only names the query in diagnostics and never carries SQL.
+        id: options?.id ?? 'raw',
         sql,
         ...(params !== undefined ? { params } : {}),
         dependencies,