local-lite 0.0.2 → 0.0.4

package/dist/react/status.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSyncStatus = useSyncStatus;
+exports.useSyncMetrics = useSyncMetrics;
+const react_1 = require("react");
+const runner_js_1 = require("./runner.js");
+/**
+ * Consolidated hook that tracks real-time sync connectivity, sync worker activity
+ * (pushing/pulling/syncing), and pending items in the local SQLite outbox queue.
+ */
+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 [metrics, records, lastSynced] = await Promise.all([
+                client.getMetrics().catch(() => null),
+                client.getOutboxRecords({ limit: 50 }).catch(() => []),
+                client.getLastSyncedAt().catch(() => null),
+            ]);
+            if (metrics) {
+                setIsOnline(metrics.isOnline);
+                setIsPushing(metrics.isPushing);
+                setIsPulling(metrics.isPulling);
+            }
+            if (records) {
+                setPendingRecords(records);
+                const activeCount = metrics
+                    ? metrics.outboxPendingCount + metrics.outboxProcessingCount + metrics.outboxFailedCount
+                    : records.length;
+                setPendingCount(activeCount);
+            }
+            if (lastSynced !== null && lastSynced !== undefined) {
+                setLastSyncedAt(lastSynced > 0 ? lastSynced : null);
+            }
+        }
+        catch {
+            // Ignored if client is stopping or tables initializing
+        }
+    }, [client]);
+    const scheduleRefresh = (0, runner_js_1.useCoalescedRunner)(refresh);
+    (0, react_1.useEffect)(() => {
+        if (!client || !client.db)
+            return;
+        refresh();
+        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', () => {
+            scheduleRefresh();
+        });
+        const unsubPush = client.events.on('sync:push', () => {
+            scheduleRefresh();
+        });
+        const unsubPull = client.events.on('sync:pull', () => {
+            scheduleRefresh();
+        });
+        return () => {
+            unsubStatus();
+            unsubOutbox();
+            unsubPush();
+            unsubPull();
+        };
+    }, [client, refresh, scheduleRefresh]);
+    return {
+        isOnline,
+        isPushing,
+        isPulling,
+        isSyncing: isPushing || isPulling,
+        pendingCount,
+        pendingRecords,
+        lastSyncedAt,
+        refresh,
+    };
+}
+/**
+ * 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]);
+    const scheduleRefresh = (0, runner_js_1.useCoalescedRunner)(refresh);
+    (0, react_1.useEffect)(() => {
+        if (!client)
+            return;
+        refresh();
+        // Listen to sync events for immediate (coalesced) refresh
+        const unsubs = [
+            client.events.on('sync:push', () => scheduleRefresh()),
+            client.events.on('sync:pull', () => scheduleRefresh()),
+            client.events.on('sync:status', () => scheduleRefresh()),
+        ];
+        let timer;
+        if (pollIntervalMs > 0) {
+            timer = setInterval(scheduleRefresh, pollIntervalMs);
+        }
+        return () => {
+            unsubs.forEach((u) => u());
+            if (timer)
+                clearInterval(timer);
+        };
+    }, [client, refresh, scheduleRefresh, pollIntervalMs]);
+    return { metrics, refresh };
+}

package/dist/react/theme.d.ts

@@ -0,0 +1,18 @@
+export interface SyncThemeColors {
+    isDark: boolean;
+    bg: string;
+    surface: string;
+    surfaceSubtle: string;
+    card: string;
+    border: string;
+    borderSubtle: string;
+    text: string;
+    textSecondary: string;
+    textMuted: string;
+    actionBg: string;
+    actionText: string;
+    accent: string;
+}
+export declare const darkTheme: SyncThemeColors;
+export declare const lightTheme: SyncThemeColors;
+export declare function resolveSyncTheme(themeProp?: 'auto' | 'dark' | 'light' | Partial<SyncThemeColors>, systemColorScheme?: 'dark' | 'light' | null): SyncThemeColors;

package/dist/react/theme.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lightTheme = exports.darkTheme = void 0;
+exports.resolveSyncTheme = resolveSyncTheme;
+exports.darkTheme = {
+    isDark: true,
+    bg: '#111827',
+    surface: '#1F2937',
+    surfaceSubtle: '#1F293780',
+    card: '#1F2937',
+    border: '#374151',
+    borderSubtle: '#37415160',
+    text: '#F9FAFB',
+    textSecondary: '#D1D5DB',
+    textMuted: '#9CA3AF',
+    actionBg: '#374151',
+    actionText: '#F9FAFB',
+    accent: '#8B5CF6',
+};
+exports.lightTheme = {
+    isDark: false,
+    bg: '#F9FAFB',
+    surface: '#FFFFFF',
+    surfaceSubtle: '#F3F4F6',
+    card: '#FFFFFF',
+    border: '#E5E7EB',
+    borderSubtle: '#E5E7EB80',
+    text: '#111827',
+    textSecondary: '#374151',
+    textMuted: '#6B7280',
+    actionBg: '#E5E7EB',
+    actionText: '#1F2937',
+    accent: '#7C3AED',
+};
+function resolveSyncTheme(themeProp, systemColorScheme) {
+    if (typeof themeProp === 'object' && themeProp !== null) {
+        const base = themeProp.isDark === false ? exports.lightTheme : exports.darkTheme;
+        return { ...base, ...themeProp };
+    }
+    const mode = themeProp && themeProp !== 'auto'
+        ? themeProp
+        : systemColorScheme === 'light'
+            ? 'light'
+            : 'dark';
+    return mode === 'light' ? exports.lightTheme : exports.darkTheme;
+}

package/dist/utils/logger.d.ts

@@ -28,6 +28,10 @@ export declare class SyncLogger {
  * Global default logger instance.
  */
 export declare const defaultLogger: SyncLogger;
+/**
+ * Factory to create or resolve a SyncLogger from boolean, config, or existing logger.
+ */
+export declare function createSyncLogger(logger?: SyncLogger | CustomLogger | boolean, logLevel?: LogLevel): SyncLogger;
 /**
  * Translates PostgreSQL / Supabase PostgREST error codes into actionable, human-readable explanations.
  */

package/dist/utils/logger.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultLogger = exports.SyncLogger = void 0;
+exports.createSyncLogger = createSyncLogger;
 exports.formatSupabaseError = formatSupabaseError;
 exports.formatFirestoreError = formatFirestoreError;
 exports.formatConvexError = formatConvexError;
@@ -75,6 +76,10 @@ class SyncLogger {
     error(message, ...args) {
         if (!this.shouldLog('error'))
             return;
+        if (message.includes('Network Offline') || message.includes('Failed to reach')) {
+            this.warn(message, ...args);
+            return;
+        }
         if (this.customLogger?.error) {
             this.customLogger.error(message, ...args);
         }
@@ -88,6 +93,21 @@ exports.SyncLogger = SyncLogger;
  * Global default logger instance.
  */
 exports.defaultLogger = new SyncLogger();
+/**
+ * Factory to create or resolve a SyncLogger from boolean, config, or existing logger.
+ */
+function createSyncLogger(logger, logLevel) {
+    if (logger instanceof SyncLogger) {
+        return logger;
+    }
+    if (typeof logger === 'boolean') {
+        return new SyncLogger({ enabled: logger, level: logLevel });
+    }
+    if (logger && typeof logger === 'object') {
+        return new SyncLogger({ customLogger: logger, level: logLevel });
+    }
+    return logLevel ? new SyncLogger({ level: logLevel }) : exports.defaultLogger;
+}
 /**
  * Translates PostgreSQL / Supabase PostgREST error codes into actionable, human-readable explanations.
  */

package/package.json

@@ -1,133 +1,138 @@
-{
-  "name": "local-lite",
-  "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",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js",
-      "default": "./dist/react/index.js"
-    },
-    "./config": {
-      "types": "./dist/config/index.d.ts",
-      "import": "./dist/config/index.js",
-      "default": "./dist/config/index.js"
-    },
-    "./supabase": {
-      "types": "./dist/adapters/remote/supabase.d.ts",
-      "import": "./dist/adapters/remote/supabase.js",
-      "default": "./dist/adapters/remote/supabase.js"
-    },
-    "./convex": {
-      "types": "./dist/adapters/remote/convex.d.ts",
-      "import": "./dist/adapters/remote/convex.js",
-      "default": "./dist/adapters/remote/convex.js"
-    },
-    "./firebase": {
-      "types": "./dist/adapters/remote/firestore.d.ts",
-      "import": "./dist/adapters/remote/firestore.js",
-      "default": "./dist/adapters/remote/firestore.js"
-    },
-    "./expo-sqlite": {
-      "types": "./dist/adapters/local/expo-sqlite.d.ts",
-      "import": "./dist/adapters/local/expo-sqlite.js",
-      "default": "./dist/adapters/local/expo-sqlite.js"
-    },
-    "./op-sqlite": {
-      "types": "./dist/adapters/local/op-sqlite.d.ts",
-      "import": "./dist/adapters/local/op-sqlite.js",
-      "default": "./dist/adapters/local/op-sqlite.js"
-    },
-    "./better-sqlite3": {
-      "types": "./dist/adapters/local/better-sqlite3.d.ts",
-      "import": "./dist/adapters/local/better-sqlite3.js",
-      "default": "./dist/adapters/local/better-sqlite3.js"
-    },
-    "./libsql": {
-      "types": "./dist/adapters/local/libsql.d.ts",
-      "import": "./dist/adapters/local/libsql.js",
-      "default": "./dist/adapters/local/libsql.js"
-    },
-    "./sql-js": {
-      "types": "./dist/adapters/local/sql-js.d.ts",
-      "import": "./dist/adapters/local/sql-js.js",
-      "default": "./dist/adapters/local/sql-js.js"
-    },
-    "./node-sqlite": {
-      "types": "./dist/adapters/local/node-sqlite.d.ts",
-      "import": "./dist/adapters/local/node-sqlite.js",
-      "default": "./dist/adapters/local/node-sqlite.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run test && npm run build"
-  },
-  "peerDependencies": {
-    "@libsql/client": "^0.6.0",
-    "@op-engineering/op-sqlite": "^0.1.0",
-    "@supabase/supabase-js": "^2.0.0",
-    "better-sqlite3": "^8.0.0",
-    "convex": ">=1.0.0",
-    "expo-sqlite": "^57.0.0",
-    "firebase": ">=9.0.0",
-    "react": ">=18.0.0",
-    "sql.js": "^1.8.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "@supabase/supabase-js": {
-      "optional": true
-    },
-    "convex": {
-      "optional": true
-    },
-    "firebase": {
-      "optional": true
-    },
-    "expo-sqlite": {
-      "optional": true
-    },
-    "@op-engineering/op-sqlite": {
-      "optional": true
-    },
-    "better-sqlite3": {
-      "optional": true
-    },
-    "@libsql/client": {
-      "optional": true
-    },
-    "sql.js": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@supabase/supabase-js": "^2.117.3",
-    "@types/react": "^19.3.0",
-    "@types/uuid": "^11.0.0",
-    "expo-sqlite": "^57.0.4",
-    "react": "^19.3.0",
-    "typescript": "^7.0.2",
-    "vitest": "^5.0.4"
-  },
-  "dependencies": {
-    "uuid": "^14.0.3"
-  }
-}
+{
+  "name": "local-lite",
+  "version": "0.0.4",
+  "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",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js",
+      "default": "./dist/config/index.js"
+    },
+    "./supabase": {
+      "types": "./dist/adapters/remote/supabase.d.ts",
+      "import": "./dist/adapters/remote/supabase.js",
+      "default": "./dist/adapters/remote/supabase.js"
+    },
+    "./convex": {
+      "types": "./dist/adapters/remote/convex.d.ts",
+      "import": "./dist/adapters/remote/convex.js",
+      "default": "./dist/adapters/remote/convex.js"
+    },
+    "./firebase": {
+      "types": "./dist/adapters/remote/firestore.d.ts",
+      "import": "./dist/adapters/remote/firestore.js",
+      "default": "./dist/adapters/remote/firestore.js"
+    },
+    "./expo-sqlite": {
+      "types": "./dist/adapters/local/expo-sqlite.d.ts",
+      "import": "./dist/adapters/local/expo-sqlite.js",
+      "default": "./dist/adapters/local/expo-sqlite.js"
+    },
+    "./op-sqlite": {
+      "types": "./dist/adapters/local/op-sqlite.d.ts",
+      "import": "./dist/adapters/local/op-sqlite.js",
+      "default": "./dist/adapters/local/op-sqlite.js"
+    },
+    "./better-sqlite3": {
+      "types": "./dist/adapters/local/better-sqlite3.d.ts",
+      "import": "./dist/adapters/local/better-sqlite3.js",
+      "default": "./dist/adapters/local/better-sqlite3.js"
+    },
+    "./libsql": {
+      "types": "./dist/adapters/local/libsql.d.ts",
+      "import": "./dist/adapters/local/libsql.js",
+      "default": "./dist/adapters/local/libsql.js"
+    },
+    "./sql-js": {
+      "types": "./dist/adapters/local/sql-js.d.ts",
+      "import": "./dist/adapters/local/sql-js.js",
+      "default": "./dist/adapters/local/sql-js.js"
+    },
+    "./node-sqlite": {
+      "types": "./dist/adapters/local/node-sqlite.d.ts",
+      "import": "./dist/adapters/local/node-sqlite.js",
+      "default": "./dist/adapters/local/node-sqlite.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "peerDependencies": {
+    "@libsql/client": "^0.6.0",
+    "@op-engineering/op-sqlite": "^0.1.0",
+    "@supabase/supabase-js": "^2.0.0",
+    "better-sqlite3": "^8.0.0",
+    "convex": ">=1.0.0",
+    "expo-sqlite": ">=57.0.0",
+    "firebase": ">=9.0.0",
+    "react": ">=18.0.0",
+    "sql.js": "^1.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    },
+    "convex": {
+      "optional": true
+    },
+    "firebase": {
+      "optional": true
+    },
+    "expo-sqlite": {
+      "optional": true
+    },
+    "@op-engineering/op-sqlite": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "@libsql/client": {
+      "optional": true
+    },
+    "sql.js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@supabase/supabase-js": "^2.118.0",
+    "@types/react": "^19.3.0",
+    "@types/uuid": "^11.0.0",
+    "expo-sqlite": "^57.0.4",
+    "react": "^19.3.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "dependencies": {
+    "uuid": "^14.0.3"
+  }
+}