local-lite 0.0.2 → 0.0.3

package/README.md

@@ -13,7 +13,7 @@ Built around the **Transactional Outbox Pattern**, `local-lite` ensures instant,
 * **[Configuration Reference](docs/configuration.md)** - Options for `defineSyncConfig()`, retries, and loggers
 * **[Local SQLite Adapters](docs/adapters-local.md)** - Expo SQLite, OP-SQLite, better-sqlite3, node:sqlite, and LibSQL
 * **[Remote Cloud Adapters](docs/adapters-remote.md)** - Supabase, Convex, Cloud Firestore, and custom adapters
-* **[React & Expo Hooks](docs/react-hooks.md)** - `useLiveQuery()` and `useOutboxStatus()`
+* **[React & Expo Hooks](docs/react-hooks.md)** - `useLiveQuery()` and `useSyncStatus()`
 * **[Conflict Resolution](docs/conflict-resolution.md)** - LWW, Client-Wins, Server-Wins, and custom resolvers
 
 ---
@@ -147,7 +147,7 @@ export const client = await createSyncClient(syncConfig);
 ### 2. Use in React Native / Expo UI
 
 ```tsx
-import { useLiveQuery, useOutboxStatus } from 'local-lite';
+import { useLiveQuery, useSyncStatus } from 'local-lite/react';
 import { client } from './sync.config';
 
 export function TodoScreen() {
@@ -157,7 +157,7 @@ export function TodoScreen() {
     order: 'desc',
   });
 
-  const { pendingCount } = useOutboxStatus(client);
+  const { pendingCount, isOnline, isSyncing } = useSyncStatus(client);
 
   const addTodo = async (title: string) => {
     await client.insert('todos', {

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export * from './adapters/local/index.js';
 export * from './adapters/remote/index.js';
 export * from './adapters/network/index.js';
 export * from './config/index.js';
-export * from './react/index.js';
+export type * from './react/index.js';
 export * from './utils/uuid.js';
 export * from './utils/sql.js';
 export * from './utils/logger.js';

package/dist/index.js

@@ -28,7 +28,6 @@ __exportStar(require("./adapters/local/index.js"), exports);
 __exportStar(require("./adapters/remote/index.js"), exports);
 __exportStar(require("./adapters/network/index.js"), exports);
 __exportStar(require("./config/index.js"), exports);
-__exportStar(require("./react/index.js"), exports);
 __exportStar(require("./utils/uuid.js"), exports);
 __exportStar(require("./utils/sql.js"), exports);
 __exportStar(require("./utils/logger.js"), exports);

package/dist/react/index.d.ts

@@ -24,23 +24,21 @@ export declare function useLiveQuery<T = any>(client: LocalFirstClient | null |
     refetch: () => Promise<void>;
     loading: boolean;
 };
-/**
- * Hook that tracks the status and pending items in sync_outbox in real time.
- */
-export declare function useOutboxStatus(client: LocalFirstClient | null | undefined): {
+export interface UseSyncStatusResult {
+    isOnline: boolean;
+    isPushing: boolean;
+    isPulling: boolean;
+    isSyncing: boolean;
     pendingCount: number;
     pendingRecords: any[];
+    lastSyncedAt: number | null;
     refresh: () => Promise<void>;
-};
+}
 /**
- * Hook that tracks real-time sync connectivity and sync worker activity (pushing/pulling).
+ * Consolidated hook that tracks real-time sync connectivity, sync worker activity
+ * (pushing/pulling/syncing), and pending items in the local SQLite outbox queue.
  */
-export declare function useSyncStatus(client: LocalFirstClient | null | undefined): {
-    isOnline: boolean;
-    isPushing: boolean;
-    isPulling: boolean;
-    pendingCount: number;
-};
+export declare function useSyncStatus(client: LocalFirstClient | null | undefined): UseSyncStatusResult;
 /**
  * Hook that provides real-time sync telemetry and engine performance metrics.
  */

package/dist/react/index.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useLiveQuery = useLiveQuery;
-exports.useOutboxStatus = useOutboxStatus;
 exports.useSyncStatus = useSyncStatus;
 exports.useSyncMetrics = useSyncMetrics;
 const react_1 = require("react");
@@ -73,66 +72,78 @@ function useLiveQuery(client, tableName, queryOrOptions) {
     return { data, refetch, loading };
 }
 /**
- * Hook that tracks the status and pending items in sync_outbox in real time.
+ * Consolidated hook that tracks real-time sync connectivity, sync worker activity
+ * (pushing/pulling/syncing), and pending items in the local SQLite outbox queue.
  */
-function useOutboxStatus(client) {
+function useSyncStatus(client) {
+    const [isOnline, setIsOnline] = (0, react_1.useState)(true);
+    const [isPushing, setIsPushing] = (0, react_1.useState)(false);
+    const [isPulling, setIsPulling] = (0, react_1.useState)(false);
     const [pendingCount, setPendingCount] = (0, react_1.useState)(0);
     const [pendingRecords, setPendingRecords] = (0, react_1.useState)([]);
+    const [lastSyncedAt, setLastSyncedAt] = (0, react_1.useState)(null);
     const refresh = (0, react_1.useCallback)(async () => {
         if (!client || !client.db)
             return;
         try {
-            const records = await client.getOutboxRecords();
-            setPendingRecords(records || []);
-            setPendingCount(records.filter((r) => r.status === 'PENDING').length);
+            const [metrics, records, lastSynced] = await Promise.all([
+                client.getMetrics().catch(() => null),
+                client.getOutboxRecords().catch(() => []),
+                client.getLastSyncedAt().catch(() => null),
+            ]);
+            if (metrics) {
+                setIsOnline(metrics.isOnline);
+                setIsPushing(metrics.isPushing);
+                setIsPulling(metrics.isPulling);
+            }
+            if (records) {
+                setPendingRecords(records);
+                setPendingCount(records.filter((r) => r.status === 'PENDING').length);
+            }
+            if (lastSynced !== null && lastSynced !== undefined) {
+                setLastSyncedAt(lastSynced > 0 ? lastSynced : null);
+            }
         }
         catch {
-            // Ignored if table doesn't exist yet
+            // Ignored if client is stopping or tables initializing
         }
     }, [client]);
     (0, react_1.useEffect)(() => {
         if (!client || !client.db)
             return;
         refresh();
-        const unsubscribe = client.events.on('sync_outbox', () => {
+        const unsubStatus = client.events.on('sync:status', (e) => {
+            setIsOnline(e.isOnline);
+            setIsPushing(e.isPushing);
+            setIsPulling(e.isPulling);
+            setPendingCount(e.pendingCount);
+        });
+        const unsubOutbox = client.events.on('sync_outbox', () => {
             refresh();
         });
-        return () => {
-            unsubscribe();
-        };
-    }, [client, refresh]);
-    return { pendingCount, pendingRecords, refresh };
-}
-/**
- * Hook that tracks real-time sync connectivity and sync worker activity (pushing/pulling).
- */
-function useSyncStatus(client) {
-    const [status, setStatus] = (0, react_1.useState)({
-        isOnline: true,
-        isPushing: false,
-        isPulling: false,
-        pendingCount: 0,
-    });
-    (0, react_1.useEffect)(() => {
-        if (!client)
-            return;
-        // Fetch initial metrics
-        client.getMetrics().then((m) => {
-            setStatus({
-                isOnline: m.isOnline,
-                isPushing: m.isPushing,
-                isPulling: m.isPulling,
-                pendingCount: m.outboxPendingCount,
-            });
-        }).catch(() => { });
-        const unsubscribe = client.events.on('sync:status', (e) => {
-            setStatus(e);
+        const unsubPush = client.events.on('sync:push', () => {
+            refresh();
+        });
+        const unsubPull = client.events.on('sync:pull', () => {
+            refresh();
         });
         return () => {
-            unsubscribe();
+            unsubStatus();
+            unsubOutbox();
+            unsubPush();
+            unsubPull();
         };
-    }, [client]);
-    return status;
+    }, [client, refresh]);
+    return {
+        isOnline,
+        isPushing,
+        isPulling,
+        isSyncing: isPushing || isPulling,
+        pendingCount,
+        pendingRecords,
+        lastSyncedAt,
+        refresh,
+    };
 }
 /**
  * Hook that provides real-time sync telemetry and engine performance metrics.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-lite",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Never let a lost connection break a promise. Local-first sync that faithfully keeps data safe until you're back online.",
   "license": "MIT",
   "main": "dist/index.js",