local-lite 0.0.22 → 0.0.25

package/dist/storage/store.js

@@ -30,36 +30,36 @@ function mapBlobRow(r) {
 }
 class BlobStore {
     static async ensureSchema(db, tableName = exports.DEFAULT_BLOBS_TABLE) {
-        await db.execute(`CREATE TABLE IF NOT EXISTS ${tableName} (
-        id TEXT PRIMARY KEY,
-        key TEXT UNIQUE NOT NULL,
-        name TEXT NOT NULL,
-        mime_type TEXT NOT NULL,
-        size INTEGER NOT NULL,
-        local_path TEXT NOT NULL,
-        remote_url TEXT,
-        status TEXT NOT NULL,
-        sha256 TEXT,
-        metadata TEXT,
-        created_at INTEGER NOT NULL,
-        updated_at INTEGER NOT NULL
+        await db.execute(`CREATE TABLE IF NOT EXISTS ${tableName} (
+        id TEXT PRIMARY KEY,
+        key TEXT UNIQUE NOT NULL,
+        name TEXT NOT NULL,
+        mime_type TEXT NOT NULL,
+        size INTEGER NOT NULL,
+        local_path TEXT NOT NULL,
+        remote_url TEXT,
+        status TEXT NOT NULL,
+        sha256 TEXT,
+        metadata TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
       );`);
         await db.execute(`CREATE INDEX IF NOT EXISTS idx_${tableName}_status ON ${tableName} (status);`);
         await db.execute(`CREATE INDEX IF NOT EXISTS idx_${tableName}_key ON ${tableName} (key);`);
     }
     static async insertOrUpdate(db, tableName = exports.DEFAULT_BLOBS_TABLE, record) {
         const metaStr = record.metadata ? JSON.stringify(record.metadata) : null;
-        await db.execute(`INSERT INTO ${tableName} (id, key, name, mime_type, size, local_path, remote_url, status, sha256, metadata, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-       ON CONFLICT(key) DO UPDATE SET
-         name = excluded.name,
-         mime_type = excluded.mime_type,
-         size = excluded.size,
-         local_path = excluded.local_path,
-         remote_url = excluded.remote_url,
-         status = excluded.status,
-         sha256 = excluded.sha256,
-         metadata = excluded.metadata,
+        await db.execute(`INSERT INTO ${tableName} (id, key, name, mime_type, size, local_path, remote_url, status, sha256, metadata, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(key) DO UPDATE SET
+         name = excluded.name,
+         mime_type = excluded.mime_type,
+         size = excluded.size,
+         local_path = excluded.local_path,
+         remote_url = excluded.remote_url,
+         status = excluded.status,
+         sha256 = excluded.sha256,
+         metadata = excluded.metadata,
          updated_at = excluded.updated_at;`, [
             record.id,
             record.key,

package/dist/utils/portability.d.ts

@@ -4,6 +4,8 @@ export interface ExportJsonOptions {
     pretty?: boolean;
     /** Explicit list of tables to export. If not specified, exports all registered tables. */
     tables?: string[];
+    /** Whether to include internal system/engine tables. Default: false */
+    includeInternal?: boolean;
 }
 export interface JsonExportData {
     version: number;
@@ -24,6 +26,8 @@ export interface ImportJsonOptions {
     skipOutbox?: boolean;
     /** Whitelist of tables to import. If specified, any tables in JSON not in this list are ignored. */
     tables?: string[];
+    /** Whether to import internal system/engine tables. Default: false */
+    includeInternal?: boolean;
 }
 export interface ExportCsvOptions {
     /** Columns to export in order. If omitted, uses all columns from the table. */

package/dist/utils/portability.js

@@ -101,7 +101,10 @@ function parseCsv(text, delimiter = ',') {
  * Exports SQLite tables to a structured JSON string.
  */
 async function exportTablesToJson(client, tables, options = {}) {
-    const targetTables = tables && tables.length > 0 ? tables : client.tables;
+    let targetTables = tables && tables.length > 0 ? tables : client.tables;
+    if (!options.includeInternal) {
+        targetTables = targetTables.filter(t => !(0, sql_js_1.isInternalTable)(t));
+    }
     const result = {
         version: 1,
         exportedAt: new Date().toISOString(),
@@ -139,6 +142,9 @@ async function importTablesFromJson(client, jsonString, options = {}) {
     const importedTables = [];
     const rowCounts = {};
     for (const [table, rows] of Object.entries(parsed.tables)) {
+        if (!options.includeInternal && (0, sql_js_1.isInternalTable)(table)) {
+            continue;
+        }
         if (filterTables && !filterTables.has(table)) {
             continue;
         }

package/dist/utils/sql.d.ts

@@ -2,3 +2,8 @@
  * Safely escape a SQL identifier (table name or column name) with double quotes.
  */
 export declare function escapeIdentifier(identifier: string): string;
+/**
+ * Determines whether a table name is an internal SQLite or local-lite system/engine table
+ * (e.g. FTS5 index and shadow tables, sync outbox, local session/key stores, sqlite/android internals).
+ */
+export declare function isInternalTable(tableName: string): boolean;

package/dist/utils/sql.js

@@ -1,9 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.escapeIdentifier = escapeIdentifier;
+exports.isInternalTable = isInternalTable;
 /**
  * Safely escape a SQL identifier (table name or column name) with double quotes.
  */
 function escapeIdentifier(identifier) {
     return `"${identifier.replace(/"/g, '""')}"`;
 }
+/**
+ * Determines whether a table name is an internal SQLite or local-lite system/engine table
+ * (e.g. FTS5 index and shadow tables, sync outbox, local session/key stores, sqlite/android internals).
+ */
+function isInternalTable(tableName) {
+    if (!tableName || typeof tableName !== 'string')
+        return true;
+    const lower = tableName.toLowerCase();
+    if (lower.startsWith('sqlite_') || lower.startsWith('android_'))
+        return true;
+    if (lower.startsWith('_fts_'))
+        return true;
+    if (lower.startsWith('_local_'))
+        return true;
+    if (lower.startsWith('sync_'))
+        return true;
+    if (lower === 'schema_migrations' || lower === '_migrations')
+        return true;
+    return false;
+}

package/package.json

@@ -1,199 +1,205 @@
-{
-  "name": "local-lite",
-  "version": "0.0.22",
-  "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"
-    },
-    "./schema": {
-      "types": "./dist/schema/index.d.ts",
-      "import": "./dist/schema/index.js",
-      "default": "./dist/schema/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"
-    },
-    "./auth": {
-      "types": "./dist/auth/index.d.ts",
-      "import": "./dist/auth/index.js",
-      "default": "./dist/auth/index.js"
-    },
-    "./backups": {
-      "types": "./dist/backups/index.d.ts",
-      "import": "./dist/backups/index.js",
-      "default": "./dist/backups/index.js"
-    },
-    "./portability": {
-      "types": "./dist/utils/portability.d.ts",
-      "import": "./dist/utils/portability.js",
-      "default": "./dist/utils/portability.js"
-    },
-    "./maintenance": {
-      "types": "./dist/core/maintenance.d.ts",
-      "import": "./dist/core/maintenance.js",
-      "default": "./dist/core/maintenance.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"
-    },
-    "./actions": {
-      "types": "./dist/actions/index.d.ts",
-      "import": "./dist/actions/index.js",
-      "default": "./dist/actions/index.js"
-    },
-    "./keys": {
-      "types": "./dist/keys/index.d.ts",
-      "import": "./dist/keys/index.js",
-      "default": "./dist/keys/index.js"
-    },
-    "./kv": {
-      "types": "./dist/kv/index.d.ts",
-      "import": "./dist/kv/index.js",
-      "default": "./dist/kv/index.js"
-    },
-    "./search": {
-      "types": "./dist/search/index.d.ts",
-      "import": "./dist/search/index.js",
-      "default": "./dist/search/index.js"
-    },
-    "./storage": {
-      "types": "./dist/storage/index.d.ts",
-      "import": "./dist/storage/index.js",
-      "default": "./dist/storage/index.js"
-    },
-    "./scheduler": {
-      "types": "./dist/scheduler/index.d.ts",
-      "import": "./dist/scheduler/index.js",
-      "default": "./dist/scheduler/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-file-system": ">=58.0.0",
-    "expo-sqlite": ">=58.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-file-system": {
-      "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/node": "^26.6.5",
-    "@types/react": "^19.3.0",
-    "@types/uuid": "^11.0.0",
-    "expo-sqlite": "^58.0.14",
-    "react": "^19.3.1",
-    "typescript": "^7.0.2",
-    "vitest": "^5.0.5"
-  },
-  "dependencies": {
-    "@noble/hashes": "^2.4.0",
-    "uuid": "^14.0.3"
-  }
-}
+{
+  "name": "local-lite",
+  "version": "0.0.25",
+  "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"
+    },
+    "./devtools": {
+      "types": "./dist/devtools/index.d.ts",
+      "import": "./dist/devtools/index.js",
+      "default": "./dist/devtools/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js",
+      "default": "./dist/config/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js",
+      "default": "./dist/schema/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"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js",
+      "default": "./dist/auth/index.js"
+    },
+    "./backups": {
+      "types": "./dist/backups/index.d.ts",
+      "import": "./dist/backups/index.js",
+      "default": "./dist/backups/index.js"
+    },
+    "./portability": {
+      "types": "./dist/utils/portability.d.ts",
+      "import": "./dist/utils/portability.js",
+      "default": "./dist/utils/portability.js"
+    },
+    "./maintenance": {
+      "types": "./dist/core/maintenance.d.ts",
+      "import": "./dist/core/maintenance.js",
+      "default": "./dist/core/maintenance.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"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js",
+      "default": "./dist/actions/index.js"
+    },
+    "./keys": {
+      "types": "./dist/keys/index.d.ts",
+      "import": "./dist/keys/index.js",
+      "default": "./dist/keys/index.js"
+    },
+    "./kv": {
+      "types": "./dist/kv/index.d.ts",
+      "import": "./dist/kv/index.js",
+      "default": "./dist/kv/index.js"
+    },
+    "./search": {
+      "types": "./dist/search/index.d.ts",
+      "import": "./dist/search/index.js",
+      "default": "./dist/search/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js",
+      "default": "./dist/storage/index.js"
+    },
+    "./scheduler": {
+      "types": "./dist/scheduler/index.d.ts",
+      "import": "./dist/scheduler/index.js",
+      "default": "./dist/scheduler/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:package": "node package-smoke.mjs",
+    "prepublishOnly": "npm run test && npm run build && npm run test:package"
+  },
+  "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-file-system": ">=58.0.0",
+    "expo-sqlite": ">=58.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-file-system": {
+      "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/node": "^26.6.5",
+    "@types/react": "^19.3.0",
+    "@types/uuid": "^11.0.0",
+    "expo-sqlite": "^58.0.14",
+    "react": "^19.3.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "dependencies": {
+    "@noble/hashes": "^2.4.0",
+    "uuid": "^14.0.3"
+  }
+}