local-lite 0.0.4 → 0.0.6

package/dist/core/schema-manager.d.ts

@@ -3,15 +3,6 @@ export interface DBExecutable {
 }
 /**
  * Detects the appropriate SQLite column type affinity from a JavaScript runtime value.
- *
- * Mapping:
- * - boolean -> INTEGER (0 or 1)
- * - integer -> INTEGER
- * - float/double -> REAL
- * - string -> TEXT
- * - object/array -> TEXT (JSON formatted)
- * - Uint8Array -> BLOB
- * - null/undefined -> TEXT (flexible SQLite type affinity)
  */
 export declare function detectSQLiteType(value: any): 'INTEGER' | 'REAL' | 'TEXT' | 'BLOB';
 /**
@@ -24,18 +15,16 @@ export declare class SchemaManager {
     private knownTables;
     private knownColumns;
     private knownIndexes;
-    /**
-     * Resets the schema cache (useful for testing or full database resets).
-     */
     clearCache(): void;
-    /**
-     * Checks whether a column is known to exist on the specified table.
-     */
     hasColumn(tableName: string, column: string): boolean;
     /**
      * Introspects table columns via PRAGMA table_info if not previously cached.
      */
     ensureTableIntrospected(db: DBExecutable, tableName: string): Promise<void>;
+    /**
+     * Automatically creates single-column and composite FK+deleted indexes for given columns.
+     */
+    private autoIndexColumns;
     /**
      * Ensures that the target table exists in SQLite with the specified primary key.
      */

package/dist/core/schema-manager.js

@@ -6,36 +6,14 @@ exports.formatValueForStorage = formatValueForStorage;
 const sql_js_1 = require("../utils/sql.js");
 /**
  * Detects the appropriate SQLite column type affinity from a JavaScript runtime value.
- *
- * Mapping:
- * - boolean -> INTEGER (0 or 1)
- * - integer -> INTEGER
- * - float/double -> REAL
- * - string -> TEXT
- * - object/array -> TEXT (JSON formatted)
- * - Uint8Array -> BLOB
- * - null/undefined -> TEXT (flexible SQLite type affinity)
  */
 function detectSQLiteType(value) {
-    if (value === null || value === undefined) {
-        return 'TEXT';
-    }
-    const type = typeof value;
-    if (type === 'boolean') {
+    if (typeof value === 'boolean')
         return 'INTEGER';
-    }
-    if (type === 'number') {
+    if (typeof value === 'number')
         return Number.isInteger(value) ? 'INTEGER' : 'REAL';
-    }
-    if (type === 'string') {
-        return 'TEXT';
-    }
-    if (value instanceof Uint8Array) {
+    if (value instanceof Uint8Array)
         return 'BLOB';
-    }
-    if (type === 'object') {
-        return 'TEXT';
-    }
     return 'TEXT';
 }
 /**
@@ -44,32 +22,23 @@ function detectSQLiteType(value) {
  * - Plain objects and arrays are JSON serialized
  */
 function formatValueForStorage(value) {
-    if (value === null || value === undefined) {
+    if (value === null || value === undefined)
         return null;
-    }
-    if (typeof value === 'boolean') {
+    if (typeof value === 'boolean')
         return value ? 1 : 0;
-    }
-    if (typeof value === 'object' && !(value instanceof Uint8Array)) {
+    if (typeof value === 'object' && !(value instanceof Uint8Array))
         return JSON.stringify(value);
-    }
     return value;
 }
 class SchemaManager {
     knownTables = new Set();
     knownColumns = new Set();
     knownIndexes = new Set();
-    /**
-     * Resets the schema cache (useful for testing or full database resets).
-     */
     clearCache() {
         this.knownTables.clear();
         this.knownColumns.clear();
         this.knownIndexes.clear();
     }
-    /**
-     * Checks whether a column is known to exist on the specified table.
-     */
     hasColumn(tableName, column) {
         return this.knownColumns.has(`${tableName}:${column.toLowerCase()}`);
     }
@@ -84,25 +53,54 @@ class SchemaManager {
         const safeTable = (0, sql_js_1.escapeIdentifier)(tableName);
         try {
             const tableInfo = await db.execute(`PRAGMA table_info(${safeTable});`);
+            const cols = [];
             if (Array.isArray(tableInfo)) {
                 for (const col of tableInfo) {
-                    if (col && col.name) {
+                    if (col?.name) {
                         this.knownColumns.add(`${tableName}:${String(col.name).toLowerCase()}`);
+                        cols.push(String(col.name));
                     }
                 }
             }
+            await this.autoIndexColumns(db, tableName, safeTable, cols);
         }
-        catch {
-            // Ignore
+        catch { }
+    }
+    /**
+     * Automatically creates single-column and composite FK+deleted indexes for given columns.
+     */
+    async autoIndexColumns(db, tableName, safeTable, columns) {
+        const hasDeleted = this.knownColumns.has(`${tableName}:deleted`);
+        for (const key of columns) {
+            const lower = key.toLowerCase();
+            if (lower.endsWith('_id') || lower === 'deleted' || lower === 'created_at' || lower === 'updated_at') {
+                const indexKey = `${tableName}:${lower}`;
+                if (!this.knownIndexes.has(indexKey)) {
+                    this.knownIndexes.add(indexKey);
+                    try {
+                        await db.execute(`CREATE INDEX IF NOT EXISTS ${(0, sql_js_1.escapeIdentifier)(`idx_${tableName}_${key}`)} ON ${safeTable} (${(0, sql_js_1.escapeIdentifier)(key)});`);
+                    }
+                    catch { }
+                }
+            }
+            if (hasDeleted && lower.endsWith('_id') && lower !== 'id') {
+                const compositeKey = `${tableName}:${lower}_deleted`;
+                if (!this.knownIndexes.has(compositeKey)) {
+                    this.knownIndexes.add(compositeKey);
+                    try {
+                        await db.execute(`CREATE INDEX IF NOT EXISTS ${(0, sql_js_1.escapeIdentifier)(`idx_${tableName}_${lower}_del`)} ON ${safeTable} (${(0, sql_js_1.escapeIdentifier)(key)}, "deleted");`);
+                    }
+                    catch { }
+                }
+            }
         }
     }
     /**
      * Ensures that the target table exists in SQLite with the specified primary key.
      */
     async ensureTable(db, tableName, primaryKey = 'id') {
-        if (this.knownTables.has(tableName)) {
+        if (this.knownTables.has(tableName))
             return;
-        }
         const safeTable = (0, sql_js_1.escapeIdentifier)(tableName);
         const safePk = (0, sql_js_1.escapeIdentifier)(primaryKey);
         await db.execute(`CREATE TABLE IF NOT EXISTS ${safeTable} (${safePk} TEXT PRIMARY KEY);`);
@@ -115,99 +113,46 @@ class SchemaManager {
      */
     async ensureColumns(db, tableName, payload, primaryKey = 'id') {
         await this.ensureTable(db, tableName, primaryKey);
-        if (!payload || typeof payload !== 'object') {
+        if (!payload || typeof payload !== 'object')
             return {};
-        }
         const keys = Object.keys(payload);
-        if (keys.length === 0) {
+        if (keys.length === 0)
             return {};
-        }
         const safeTable = (0, sql_js_1.escapeIdentifier)(tableName);
         let cacheMiss = false;
         for (const key of keys) {
-            if (key === primaryKey)
-                continue;
-            const cacheKey = `${tableName}:${key.toLowerCase()}`;
-            if (!this.knownColumns.has(cacheKey)) {
+            if (key !== primaryKey && !this.knownColumns.has(`${tableName}:${key.toLowerCase()}`)) {
                 cacheMiss = true;
                 break;
             }
         }
         if (cacheMiss) {
-            // Query PRAGMA table_info to discover existing columns from SQLite
             try {
                 const tableInfo = await db.execute(`PRAGMA table_info(${safeTable});`);
                 if (Array.isArray(tableInfo)) {
                     for (const col of tableInfo) {
-                        if (col && col.name) {
+                        if (col?.name) {
                             this.knownColumns.add(`${tableName}:${String(col.name).toLowerCase()}`);
                         }
                     }
                 }
             }
-            catch (err) {
-                // Fallback for mocks or custom drivers where PRAGMA table_info might not be supported
-            }
-            // Check for columns that still do not exist, and alter table
+            catch { }
             for (const key of keys) {
                 if (key === primaryKey)
                     continue;
                 const cacheKey = `${tableName}:${key.toLowerCase()}`;
                 if (!this.knownColumns.has(cacheKey)) {
                     const detectedType = detectSQLiteType(payload[key]);
-                    const safeCol = (0, sql_js_1.escapeIdentifier)(key);
                     try {
-                        await db.execute(`ALTER TABLE ${safeTable} ADD COLUMN ${safeCol} ${detectedType};`);
-                    }
-                    catch (err) {
-                        // Ignore if column already exists (e.g. concurrent race)
-                        const msg = String(err?.message || err || '');
-                        if (!msg.toLowerCase().includes('duplicate column')) {
-                            // Ignore or rethrow
-                        }
+                        await db.execute(`ALTER TABLE ${safeTable} ADD COLUMN ${(0, sql_js_1.escapeIdentifier)(key)} ${detectedType};`);
                     }
+                    catch { }
                     this.knownColumns.add(cacheKey);
                 }
-                // Auto-index foreign keys and common query columns
-                const lowerKey = key.toLowerCase();
-                if (lowerKey.endsWith('_id') ||
-                    lowerKey === 'business_id' ||
-                    lowerKey === 'deleted' ||
-                    lowerKey === 'created_at' ||
-                    lowerKey === 'payment_date') {
-                    const indexKey = `${tableName}:${lowerKey}`;
-                    if (!this.knownIndexes.has(indexKey)) {
-                        this.knownIndexes.add(indexKey);
-                        try {
-                            const idxName = (0, sql_js_1.escapeIdentifier)(`idx_${tableName}_${key}`);
-                            const safeCol = (0, sql_js_1.escapeIdentifier)(key);
-                            await db.execute(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${safeTable} (${safeCol});`);
-                        }
-                        catch {
-                            // Ignore if indexes are not supported by adapter or already exist
-                        }
-                    }
-                }
-            }
-        }
-        // Auto-create high performance composite index for multi-tenant soft-deleted queries
-        if (this.knownColumns.has(`${tableName}:business_id`) &&
-            this.knownColumns.has(`${tableName}:deleted`)) {
-            const compositeKey = `${tableName}:business_id_deleted`;
-            if (!this.knownIndexes.has(compositeKey)) {
-                this.knownIndexes.add(compositeKey);
-                try {
-                    const idxName = (0, sql_js_1.escapeIdentifier)(`idx_${tableName}_biz_del`);
-                    const safeBiz = (0, sql_js_1.escapeIdentifier)('business_id');
-                    const safeDel = (0, sql_js_1.escapeIdentifier)('deleted');
-                    await db.execute(`CREATE INDEX IF NOT EXISTS ${idxName} ON ${safeTable} (${safeBiz}, ${safeDel});`);
-                }
-                catch {
-                    // Ignore
-                }
             }
+            await this.autoIndexColumns(db, tableName, safeTable, keys);
         }
-        // Format all values for SQLite storage
         const formatted = {};
         for (const key of keys) {
             formatted[key] = formatValueForStorage(payload[key]);

package/dist/core/sync-worker.js

@@ -611,9 +611,12 @@ class SyncWorker {
             const isLastChunk = i + DELTA_CHUNK_SIZE >= totalChanges;
             const queuedEvents = [];
             await this.db.transaction(async (tx) => {
+                // Pre-fetch active pending outbox records in 1 query for this chunk to eliminate N+1 bridge roundtrips
+                const pendingOutboxMap = await outbox_store_js_1.OutboxStore.getActivePendingMap(tx);
                 for (const change of chunk) {
-                    // 1. Check for pending local mutations for this (table_name, row_id)
-                    const localPendingRecord = await outbox_store_js_1.OutboxStore.findPendingByRow(tx, change.tableName, change.rowId);
+                    const outboxKey = `${change.tableName}:${change.rowId}`;
+                    // 1. Check in-memory map for pending local mutations for this (table_name, row_id)
+                    const localPendingRecord = pendingOutboxMap.get(outboxKey);
                     // 2. Conflict resolution if there is a pending local change
                     if (localPendingRecord) {
                         // Only load the current local row when a resolver actually needs it.
@@ -640,11 +643,13 @@ class SyncWorker {
                         if (resolution === 'apply-remote') {
                             // Remote change wins: remove the superseded local pending outbox mutation
                             await outbox_store_js_1.OutboxStore.deleteRecord(tx, localPendingRecord.id);
+                            pendingOutboxMap.delete(outboxKey);
                         }
                         else if (typeof resolution === 'object' && resolution.mergePayload) {
                             // Merge scenario
                             change.payload = resolution.mergePayload;
                             await outbox_store_js_1.OutboxStore.updatePayload(tx, localPendingRecord.id, resolution.mergePayload);
+                            localPendingRecord.payload = resolution.mergePayload;
                         }
                     }
                     // 3. Apply remote change to local database

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './core/outbox-store.js';
 export * from './core/meta-store.js';
 export * from './core/table-manager.js';
 export * from './core/schema-manager.js';
+export * from './core/query-builder.js';
 export * from './reactive/event-emitter.js';
 export * from './adapters/local/index.js';
 export * from './adapters/remote/index.js';
@@ -16,3 +17,4 @@ export type * from './react/index.js';
 export * from './utils/uuid.js';
 export * from './utils/sql.js';
 export * from './utils/logger.js';
+export * from './schema/index.js';

package/dist/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./core/outbox-store.js"), exports);
 __exportStar(require("./core/meta-store.js"), exports);
 __exportStar(require("./core/table-manager.js"), exports);
 __exportStar(require("./core/schema-manager.js"), exports);
+__exportStar(require("./core/query-builder.js"), exports);
 __exportStar(require("./reactive/event-emitter.js"), exports);
 __exportStar(require("./adapters/local/index.js"), exports);
 __exportStar(require("./adapters/remote/index.js"), exports);
@@ -31,3 +32,4 @@ __exportStar(require("./config/index.js"), exports);
 __exportStar(require("./utils/uuid.js"), exports);
 __exportStar(require("./utils/sql.js"), exports);
 __exportStar(require("./utils/logger.js"), exports);
+__exportStar(require("./schema/index.js"), exports);

package/dist/react/SyncInspector.js

@@ -92,37 +92,6 @@ function SyncInspector({ client, position = 'bottom-right', variant = 'pill', in
             numColor: metrics?.outboxFailedCount ? '#EF4444' : '#10B981',
         },
     ], [status.pendingCount, metrics?.outboxFailedCount, currentTheme.text]);
-    // Shared Connection & Telemetry Rows
-    const telemetryItems = (0, react_1.useMemo)(() => [
-        {
-            id: 'status',
-            label: 'Connection Status',
-            value: status.isOnline ? 'Online (Connected)' : 'Offline',
-            color: statusColor,
-            hasDot: true,
-        },
-        {
-            id: 'sync-state',
-            label: 'Sync State',
-            value: status.isSyncing ? 'Syncing...' : 'Idle',
-            color: status.isSyncing ? '#F59E0B' : currentTheme.textMuted,
-        },
-        {
-            id: 'last-synced',
-            label: 'Last Synchronized',
-            value: status.lastSyncedAt ? new Date(status.lastSyncedAt).toLocaleTimeString() : 'Never',
-        },
-        {
-            id: 'push-duration',
-            label: 'Last Push Duration',
-            value: `${metrics?.lastPushDurationMs || 0} ms`,
-        },
-        {
-            id: 'pull-duration',
-            label: 'Last Pull Duration',
-            value: `${metrics?.lastPullDurationMs || 0} ms`,
-        },
-    ], [status.isOnline, status.isSyncing, status.lastSyncedAt, statusColor, metrics?.lastPushDurationMs, metrics?.lastPullDurationMs, currentTheme.textMuted]);
     // Shared Action Buttons
     const actionButtons = (0, react_1.useMemo)(() => [
         { id: 'push', label: '🚀 Push Changes', onPress: handlePush, bg: '#3B82F6', color: '#FFFFFF' },
@@ -185,19 +154,6 @@ function SyncInspector({ client, position = 'bottom-right', variant = 'pill', in
                                                 backgroundColor: currentTheme.card,
                                                 borderColor: currentTheme.border,
                                             },
-                                        ], children: [(0, jsx_runtime_1.jsx)(Text, { style: [rnStyles.infoCardTitle, { color: currentTheme.textMuted }], children: "CONNECTION & TELEMETRY" }), telemetryItems.map((item, idx) => ((0, jsx_runtime_1.jsxs)(View, { style: [
-                                                    rnStyles.infoRow,
-                                                    { borderBottomColor: currentTheme.border },
-                                                    idx === telemetryItems.length - 1 && { borderBottomWidth: 0 },
-                                                ], children: [(0, jsx_runtime_1.jsx)(Text, { style: [rnStyles.infoKey, { color: currentTheme.textMuted }], children: item.label }), (0, jsx_runtime_1.jsxs)(View, { style: { flexDirection: 'row', alignItems: 'center', gap: 6 }, children: [item.hasDot && (0, jsx_runtime_1.jsx)(View, { style: [rnStyles.dotSmall, { backgroundColor: item.color }] }), (0, jsx_runtime_1.jsx)(Text, { style: [
-                                                                    rnStyles.infoVal,
-                                                                    item.color ? { color: item.color, fontWeight: '700' } : { color: currentTheme.text },
-                                                                ], children: item.value })] })] }, item.id)))] }), (0, jsx_runtime_1.jsxs)(View, { style: [
-                                            rnStyles.infoCard,
-                                            {
-                                                backgroundColor: currentTheme.card,
-                                                borderColor: currentTheme.border,
-                                            },
                                         ], children: [(0, jsx_runtime_1.jsx)(Text, { style: [rnStyles.infoCardTitle, { color: currentTheme.textMuted }], children: "ENGINE ACTIONS" }), (0, jsx_runtime_1.jsx)(View, { style: rnStyles.btnRow, children: actionButtons.slice(0, 2).map((btn) => ((0, jsx_runtime_1.jsx)(TouchableOpacity, { onPress: btn.onPress, style: [rnStyles.actionBtn, { backgroundColor: btn.bg }], activeOpacity: 0.8, children: (0, jsx_runtime_1.jsx)(Text, { style: [rnStyles.actionBtnText, { color: btn.color }], children: btn.label }) }, btn.id))) }), (0, jsx_runtime_1.jsx)(View, { style: [rnStyles.btnRow, { marginTop: 8 }], children: actionButtons.slice(2, 4).map((btn) => ((0, jsx_runtime_1.jsx)(TouchableOpacity, { onPress: btn.onPress, style: [rnStyles.actionBtn, { backgroundColor: btn.bg }], activeOpacity: 0.8, children: (0, jsx_runtime_1.jsx)(Text, { style: [rnStyles.actionBtnText, { color: btn.color }], children: btn.label }) }, btn.id))) })] }), (metrics?.lastPushError || metrics?.lastPullError) && ((0, jsx_runtime_1.jsxs)(View, { style: [rnStyles.infoCard, { borderColor: '#EF444480', backgroundColor: '#7F1D1D20' }], children: [(0, jsx_runtime_1.jsx)(Text, { style: [rnStyles.infoCardTitle, { color: '#F87171' }], children: "SYNC ENGINE ERRORS" }), metrics?.lastPushError && ((0, jsx_runtime_1.jsxs)(View, { style: { marginBottom: 6 }, children: [(0, jsx_runtime_1.jsx)(Text, { style: { fontSize: 11, color: '#FCA5A5', fontWeight: '700' }, children: "Last Push Error:" }), (0, jsx_runtime_1.jsx)(Text, { style: { fontSize: 12, color: '#FECACA' }, children: String(metrics.lastPushError) })] })), metrics?.lastPullError && ((0, jsx_runtime_1.jsxs)(View, { children: [(0, jsx_runtime_1.jsx)(Text, { style: { fontSize: 11, color: '#FCA5A5', fontWeight: '700' }, children: "Last Pull Error:" }), (0, jsx_runtime_1.jsx)(Text, { style: { fontSize: 12, color: '#FECACA' }, children: String(metrics.lastPullError) })] }))] })), status.pendingRecords && status.pendingRecords.length > 0 && ((0, jsx_runtime_1.jsxs)(View, { style: [
                                             rnStyles.infoCard,
                                             {
@@ -324,32 +280,6 @@ function SyncInspector({ client, position = 'bottom-right', variant = 'pill', in
                                     border: `1px solid ${currentTheme.border}`,
                                     borderRadius: 12,
                                     padding: 16,
-                                }, children: [(0, jsx_runtime_1.jsx)("div", { style: {
-                                            fontSize: 11,
-                                            fontWeight: 700,
-                                            color: currentTheme.textMuted,
-                                            letterSpacing: '0.8px',
-                                            marginBottom: 12,
-                                        }, children: "CONNECTION & TELEMETRY" }), telemetryItems.map((item, idx) => ((0, jsx_runtime_1.jsxs)("div", { style: {
-                                            display: 'flex',
-                                            justifyContent: 'space-between',
-                                            alignItems: 'center',
-                                            padding: '8px 0',
-                                            borderBottom: idx === telemetryItems.length - 1 ? 'none' : `1px solid ${currentTheme.border}`,
-                                        }, children: [(0, jsx_runtime_1.jsx)("span", { style: { color: currentTheme.textMuted, fontSize: 13 }, children: item.label }), (0, jsx_runtime_1.jsxs)("div", { style: { display: 'flex', alignItems: 'center', gap: 6 }, children: [item.hasDot && ((0, jsx_runtime_1.jsx)("span", { style: {
-                                                            width: 8,
-                                                            height: 8,
-                                                            borderRadius: 4,
-                                                            backgroundColor: item.color,
-                                                        } })), (0, jsx_runtime_1.jsx)("span", { style: {
-                                                            color: item.color || currentTheme.text,
-                                                            fontSize: 13,
-                                                            fontWeight: item.color ? 700 : 600,
-                                                        }, children: item.value })] })] }, item.id)))] }), (0, jsx_runtime_1.jsxs)("div", { style: {
-                                    backgroundColor: currentTheme.card,
-                                    border: `1px solid ${currentTheme.border}`,
-                                    borderRadius: 12,
-                                    padding: 16,
                                 }, children: [(0, jsx_runtime_1.jsx)("div", { style: {
                                             fontSize: 11,
                                             fontWeight: 700,

package/dist/react/index.d.ts

@@ -28,6 +28,45 @@ export declare function useLiveQuery<T = any>(client: LocalFirstClient | null |
     refetch: () => Promise<void>;
     loading: boolean;
 };
+export type MultiQuerySpec<T = any> = string | (QueryOptions & {
+    table?: string;
+}) | LiveQueryFn<T>;
+export type MultiQueryInput = Array<string | (QueryOptions & {
+    table: string;
+})> | Record<string, MultiQuerySpec>;
+export interface UseLiveQueriesResult<T extends Record<string, any[]>> {
+    data: T;
+    loading: boolean;
+    refetch: () => Promise<void>;
+}
+/**
+ * Reactive multi-table live query hook that loads data from multiple tables concurrently.
+ *
+ * Benefits:
+ * - Parallel fetching: queries SQLite tables concurrently via Promise.all.
+ * - Single atomic React commit: coalesces multiple table results into a single state update,
+ *   preventing cascading re-renders and UI freezing.
+ * - Multi-table event coordination: listens to mutations across all requested tables,
+ *   coalescing updates so downstream calculations only run once.
+ * - Zero-latency cache read-through: returns instant cached rows on mount.
+ *
+ * Usage with dictionary:
+ * ```ts
+ * const { data, loading } = useLiveQueries(client, {
+ *   projects: 'projects',
+ *   tasks: { where: { project_id: '123' }, orderBy: 'created_at' },
+ *   tags: { table: 'labels' }
+ * });
+ * // data.projects, data.tasks, data.tags
+ * ```
+ *
+ * Usage with array:
+ * ```ts
+ * const { data, loading } = useLiveQueries(client, ['projects', 'tasks', 'tags']);
+ * // data.projects, data.tasks, data.tags
+ * ```
+ */
+export declare function useLiveQueries<T extends Record<string, any[]> = Record<string, any[]>>(client: LocalFirstClient | null | undefined, queries: MultiQueryInput): UseLiveQueriesResult<T>;
 /**
  * Reactive hook to query a single record by primary key with 0ms cache read-through.
  * Automatically re-renders only when this specific row or table changes.