local-lite 0.0.10 → 0.0.11

package/dist/adapters/remote/demo.d.ts

@@ -19,3 +19,13 @@ export declare class MemoryDemoRemoteAdapter implements RemoteDBAdapter {
     emitLiveChanges(changes: DeltaChanges): void;
     clear(): void;
 }
+/**
+ * Built-in No-Op Remote Adapter for local-only / offline operation.
+ * Acknowledges all local outbox pushes with 0 latency, performs no remote pulls,
+ * and maintains zero cloud backend connections.
+ */
+export declare class NoopRemoteAdapter implements RemoteDBAdapter {
+    pushChanges(_operations: SyncOperation[]): Promise<boolean>;
+    fetchChanges(_sinceTimestamp: number): Promise<DeltaChanges>;
+    subscribeToLiveChanges(_callback: (changes: DeltaChanges) => void): () => void;
+}

package/dist/adapters/remote/demo.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryDemoRemoteAdapter = void 0;
+exports.NoopRemoteAdapter = exports.MemoryDemoRemoteAdapter = void 0;
 /**
  * Built-in In-Memory Demo Remote Adapter.
  * Useful for prototyping, offline testing, and previewing without a live backend.
@@ -47,3 +47,23 @@ class MemoryDemoRemoteAdapter {
     }
 }
 exports.MemoryDemoRemoteAdapter = MemoryDemoRemoteAdapter;
+/**
+ * Built-in No-Op Remote Adapter for local-only / offline operation.
+ * Acknowledges all local outbox pushes with 0 latency, performs no remote pulls,
+ * and maintains zero cloud backend connections.
+ */
+class NoopRemoteAdapter {
+    async pushChanges(_operations) {
+        return true;
+    }
+    async fetchChanges(_sinceTimestamp) {
+        return {
+            timestamp: Date.now(),
+            changes: [],
+        };
+    }
+    subscribeToLiveChanges(_callback) {
+        return () => { };
+    }
+}
+exports.NoopRemoteAdapter = NoopRemoteAdapter;

package/dist/config/index.d.ts

@@ -13,7 +13,7 @@ export { NodeSQLiteAdapter } from '../adapters/local/node-sqlite.js';
 export { SupabaseRemoteAdapter } from '../adapters/remote/supabase.js';
 export { ConvexRemoteAdapter } from '../adapters/remote/convex.js';
 export { FirestoreRemoteAdapter } from '../adapters/remote/firestore.js';
-export { MemoryDemoRemoteAdapter } from '../adapters/remote/demo.js';
+export { MemoryDemoRemoteAdapter, NoopRemoteAdapter } from '../adapters/remote/demo.js';
 /**
  * Type-safe configuration helper function (similar to defineConfig in Vite/Tailwind).
  */

package/dist/config/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryDemoRemoteAdapter = exports.FirestoreRemoteAdapter = exports.ConvexRemoteAdapter = exports.SupabaseRemoteAdapter = exports.NodeSQLiteAdapter = exports.SqlJsAdapter = exports.LibSQLAdapter = exports.BetterSQLite3Adapter = exports.OpSQLiteAdapter = exports.ExpoSQLiteAdapter = exports.LocalFirstClient = exports.resolveRemoteAdapter = exports.resolveLocalAdapter = void 0;
+exports.NoopRemoteAdapter = exports.MemoryDemoRemoteAdapter = exports.FirestoreRemoteAdapter = exports.ConvexRemoteAdapter = exports.SupabaseRemoteAdapter = exports.NodeSQLiteAdapter = exports.SqlJsAdapter = exports.LibSQLAdapter = exports.BetterSQLite3Adapter = exports.OpSQLiteAdapter = exports.ExpoSQLiteAdapter = exports.LocalFirstClient = exports.resolveRemoteAdapter = exports.resolveLocalAdapter = void 0;
 exports.defineSyncConfig = defineSyncConfig;
 exports.createSyncClient = createSyncClient;
 const client_js_1 = require("../core/client.js");
@@ -51,6 +51,7 @@ var firestore_js_1 = require("../adapters/remote/firestore.js");
 Object.defineProperty(exports, "FirestoreRemoteAdapter", { enumerable: true, get: function () { return firestore_js_1.FirestoreRemoteAdapter; } });
 var demo_js_1 = require("../adapters/remote/demo.js");
 Object.defineProperty(exports, "MemoryDemoRemoteAdapter", { enumerable: true, get: function () { return demo_js_1.MemoryDemoRemoteAdapter; } });
+Object.defineProperty(exports, "NoopRemoteAdapter", { enumerable: true, get: function () { return demo_js_1.NoopRemoteAdapter; } });
 /**
  * Type-safe configuration helper function (similar to defineConfig in Vite/Tailwind).
  */

package/dist/config/resolve-local.js

@@ -7,6 +7,8 @@ const better_sqlite3_js_1 = require("../adapters/local/better-sqlite3.js");
 const libsql_js_1 = require("../adapters/local/libsql.js");
 const sql_js_js_1 = require("../adapters/local/sql-js.js");
 const node_sqlite_js_1 = require("../adapters/local/node-sqlite.js");
+const dynamic_js_1 = require("../utils/dynamic.js");
+const EXPO_SQLITE_PKG = ['expo', 'sqlite'].join('-');
 /**
  * Resolves or instantiates the appropriate LocalDBAdapter based on the provided configuration.
  * Auto-detects Expo SQLite, OP-SQLite, better-sqlite3, LibSQL, sql.js, and Node.js built-in sqlite.
@@ -51,19 +53,11 @@ async function resolveLocalAdapter(config) {
     // 9. Auto-open by name using expo-sqlite if available
     if (typeof rawDb === 'string' || config.databaseName) {
         const dbName = typeof rawDb === 'string' ? rawDb : (config.databaseName ?? 'local_lite.db');
-        let expoSqlite;
-        try {
-            if (typeof require === 'function') {
-                expoSqlite = require('expo-sqlite');
-            }
-        }
-        catch {
-            // ignore
+        let expoSqlite = (0, dynamic_js_1.safeDynamicRequire)(EXPO_SQLITE_PKG);
+        if (!expoSqlite) {
+            expoSqlite = await (0, dynamic_js_1.safeDynamicImport)(EXPO_SQLITE_PKG);
         }
         try {
-            if (!expoSqlite) {
-                expoSqlite = await import('expo-sqlite');
-            }
             if (expoSqlite && typeof expoSqlite.openDatabaseAsync === 'function') {
                 const expoDb = await expoSqlite.openDatabaseAsync(dbName);
                 return new expo_sqlite_js_1.ExpoSQLiteAdapter(expoDb);

package/dist/config/resolve-remote.d.ts

@@ -2,6 +2,6 @@ import { RemoteDBAdapter } from '../adapters/remote/index.js';
 import { LocalLiteConfig } from './types.js';
 /**
  * Resolves or instantiates the appropriate RemoteDBAdapter based on the provided configuration.
- * Supports Supabase, Convex, Firebase / Firestore, in-memory demo adapter, or custom adapters.
+ * Supports Supabase, Convex, Firebase / Firestore, in-memory demo adapter, local-only mode, or custom adapters.
  */
 export declare function resolveRemoteAdapter(config: LocalLiteConfig): Promise<RemoteDBAdapter>;

package/dist/config/resolve-remote.js

@@ -5,9 +5,13 @@ const supabase_js_1 = require("../adapters/remote/supabase.js");
 const convex_js_1 = require("../adapters/remote/convex.js");
 const firestore_js_1 = require("../adapters/remote/firestore.js");
 const demo_js_1 = require("../adapters/remote/demo.js");
+const dynamic_js_1 = require("../utils/dynamic.js");
+// Construct dynamically to prevent Metro, Webpack, and Rollup from treating
+// optional peer dependencies as unconditional build-time dependencies.
+const SUPABASE_PKG = ['@supabase', 'supabase-js'].join('/');
 /**
  * Resolves or instantiates the appropriate RemoteDBAdapter based on the provided configuration.
- * Supports Supabase, Convex, Firebase / Firestore, in-memory demo adapter, or custom adapters.
+ * Supports Supabase, Convex, Firebase / Firestore, in-memory demo adapter, local-only mode, or custom adapters.
  */
 async function resolveRemoteAdapter(config) {
     // 1. Explicit custom remote adapter
@@ -53,34 +57,27 @@ async function resolveRemoteAdapter(config) {
     }
     // 5. Supabase with URL + anonKey (lazy dynamic import)
     if (config.supabase?.url && config.supabase?.anonKey) {
-        let supabaseModule;
-        // In CommonJS / React Native Metro environments, synchronous require avoids async chunk split failure
-        try {
-            if (typeof require === 'function') {
-                supabaseModule = require('@supabase/supabase-js');
-            }
-        }
-        catch {
-            // ignore
-        }
+        let supabaseModule = (0, dynamic_js_1.safeDynamicRequire)(SUPABASE_PKG);
         if (!supabaseModule && typeof globalThis?.supabase?.createClient === 'function') {
             supabaseModule = globalThis.supabase;
         }
         if (!supabaseModule) {
-            try {
-                supabaseModule = await import('@supabase/supabase-js');
-            }
-            catch {
-                throw new Error('To initialize Supabase from url and anonKey, please install @supabase/supabase-js or provide a pre-configured client to config.supabase.client');
-            }
+            supabaseModule = await (0, dynamic_js_1.safeDynamicImport)(SUPABASE_PKG);
+        }
+        if (!supabaseModule) {
+            throw new Error('To initialize Supabase from url and anonKey, please install @supabase/supabase-js or provide a pre-configured client to config.supabase.client');
         }
         const createClientFn = supabaseModule.createClient || supabaseModule.default?.createClient;
         const supabaseClient = createClientFn(config.supabase.url, config.supabase.anonKey);
         return new supabase_js_1.SupabaseRemoteAdapter(supabaseClient, getSupabaseOptions());
     }
-    // 6. Explicitly selected demo backend only; never acknowledge writes into a temporary backend implicitly.
+    // 6. Local-only standalone mode
+    if (config.localOnly === true) {
+        return new demo_js_1.NoopRemoteAdapter();
+    }
+    // 7. Explicitly selected demo backend only; never acknowledge writes into a temporary backend implicitly.
     if (config.inMemoryRemote === true) {
         return new demo_js_1.MemoryDemoRemoteAdapter(300);
     }
-    throw new Error('No remote adapter configured. Please specify config.supabase, config.convex, config.firebase, or config.remote. For demos only, explicitly set config.inMemoryRemote: true.');
+    throw new Error('No remote adapter configured. Please specify config.supabase, config.convex, config.firebase, or config.remote. For local-only use, set config.localOnly: true. For demos, set config.inMemoryRemote: true.');
 }

package/dist/config/types.d.ts

@@ -120,6 +120,13 @@ export interface LocalLiteConfig {
      * Default: false
      */
     inMemoryRemote?: boolean;
+    /**
+     * Run purely local-only without requiring any remote cloud backend.
+     * Disables cloud sync pushes and pulls while preserving all local SQLite features,
+     * schema management, outbox tracking, and transactions.
+     * Default: false
+     */
+    localOnly?: boolean;
     /**
      * Conflict resolution strategy. Default: 'last-write-wins'
      */

package/dist/core/sync-worker.js

@@ -7,6 +7,7 @@ const outbox_store_js_1 = require("./outbox-store.js");
 const meta_store_js_1 = require("./meta-store.js");
 const table_manager_js_1 = require("./table-manager.js");
 const logger_js_1 = require("../utils/logger.js");
+const REACT_NATIVE_PKG = ['react', 'native'].join('-');
 /** Maximum outbox records sent per push cycle. */
 const PUSH_BATCH_SIZE = 50;
 /** Maximum incoming delta changes applied in a single database transaction. */

package/dist/utils/dynamic.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Safely loads an optional dependency at runtime without triggering
+ * ahead-of-time static analysis in bundlers like Metro, Webpack, or Rollup.
+ */
+export declare function safeDynamicRequire(pkgName: string): any;
+export declare function safeDynamicImport(pkgName: string): Promise<any>;

package/dist/utils/dynamic.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeDynamicRequire = safeDynamicRequire;
+exports.safeDynamicImport = safeDynamicImport;
+/**
+ * Safely loads an optional dependency at runtime without triggering
+ * ahead-of-time static analysis in bundlers like Metro, Webpack, or Rollup.
+ */
+function safeDynamicRequire(pkgName) {
+    try {
+        const req = typeof __non_webpack_require__ !== 'undefined'
+            ? __non_webpack_require__
+            : typeof require === 'function'
+                ? require
+                : undefined;
+        return req ? req(pkgName) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function safeDynamicImport(pkgName) {
+    try {
+        // Metro's AST worker rejects `import(dynamicVariable)` with "Invalid call at line ...: import(...)".
+        // Evaluating via new Function bypasses the bundler AST parser entirely while working in Node/browser.
+        const dynamicImport = new Function('specifier', 'return import(specifier);');
+        return await dynamicImport(pkgName);
+    }
+    catch {
+        return undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-lite",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "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",