local-lite 0.0.1 → 0.0.2

package/dist/react/index.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useLiveQuery = useLiveQuery;
 exports.useOutboxStatus = useOutboxStatus;
+exports.useSyncStatus = useSyncStatus;
+exports.useSyncMetrics = useSyncMetrics;
 const react_1 = require("react");
 /**
  * Hook to execute a live reactive table query that automatically re-runs
@@ -11,9 +13,9 @@ const react_1 = require("react");
  * 1. Zero-SQL (all rows):
  *    const { data: todos } = useLiveQuery<Todo>(client, 'todos');
  *
- * 2. Declarative options (filtering & sorting without SQL):
+ * 2. Declarative options (filtering with rich operators & sorting without SQL):
  *    const { data: active } = useLiveQuery<Todo>(client, 'todos', {
- *      where: { completed: 0 },
+ *      where: { completed: 0, priority: { $gte: 2 } },
  *      orderBy: 'created_at',
  *      order: 'desc'
  *    });
@@ -80,9 +82,9 @@ function useOutboxStatus(client) {
         if (!client || !client.db)
             return;
         try {
-            const records = await client.db.execute('SELECT * FROM sync_outbox ORDER BY timestamp DESC');
+            const records = await client.getOutboxRecords();
             setPendingRecords(records || []);
-            setPendingCount((records || []).length);
+            setPendingCount(records.filter((r) => r.status === 'PENDING').length);
         }
         catch {
             // Ignored if table doesn't exist yet
@@ -101,3 +103,72 @@ function useOutboxStatus(client) {
     }, [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);
+        });
+        return () => {
+            unsubscribe();
+        };
+    }, [client]);
+    return status;
+}
+/**
+ * Hook that provides real-time sync telemetry and engine performance metrics.
+ */
+function useSyncMetrics(client, pollIntervalMs = 3000) {
+    const [metrics, setMetrics] = (0, react_1.useState)(null);
+    const refresh = (0, react_1.useCallback)(async () => {
+        if (!client)
+            return;
+        try {
+            const data = await client.getMetrics();
+            setMetrics(data);
+        }
+        catch {
+            // Ignored
+        }
+    }, [client]);
+    (0, react_1.useEffect)(() => {
+        if (!client)
+            return;
+        refresh();
+        // Listen to sync events for immediate refresh
+        const unsubs = [
+            client.events.on('sync:push', () => refresh()),
+            client.events.on('sync:pull', () => refresh()),
+            client.events.on('sync:status', () => refresh()),
+        ];
+        let timer;
+        if (pollIntervalMs > 0) {
+            timer = setInterval(refresh, pollIntervalMs);
+        }
+        return () => {
+            unsubs.forEach((u) => u());
+            if (timer)
+                clearInterval(timer);
+        };
+    }, [client, refresh, pollIntervalMs]);
+    return { metrics, refresh };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "local-lite",
-  "version": "0.0.1",
-  "description": "Vendor-agnostic local-first sync engine with outbox pattern, Supabase, Convex, and Firebase support",
+  "version": "0.0.2",
+  "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",
   "types": "dist/index.d.ts",
@@ -130,4 +130,4 @@
   "dependencies": {
     "uuid": "^14.0.3"
   }
-}
+}