@anfenn/dync 1.0.24 → 1.0.26

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@anfenn/dync.svg)](https://www.npmjs.com/package/@anfenn/dync)
 
-A complete React offline-first data layer with sync engine for any local storage (IndexedDB, Sqlite, etc.), and any backend (Restful, GraphQL, Supabase, etc.) in a Website, PWA, CapacitorJs, React Native, or Electron app.
+A complete Typescript offline-first data layer with sync engine for any local storage (IndexedDB, Sqlite, etc.), and any backend (Restful, GraphQL, Supabase, etc.) in a Website, PWA, CapacitorJs, React Native, or Electron app.
 
 Start with a Website or PWA using IndexedDB, sync with your existing REST API, and later ship native apps with encrypted SQLite - without changing a line of code.
 
@@ -48,7 +48,7 @@ And see how Dync compares to the alternatives [below](#hasnt-this-already-been-d
     - Option 1: Map remote api CRUD urls to a local collection:
 
         ```ts
-        const db = makeDync(
+        const db = new Dync(
             ...,
             {
                 // Only add an entry here for tables that should be synced
@@ -60,13 +60,14 @@ And see how Dync compares to the alternatives [below](#hasnt-this-already-been-d
                     list: (since) => fetch(`/api/items?since=${since}`),
                 },
             },
+            ...,
         );
         ```
 
     - Option 2: Batch sync to remote /push & /pull endpoints:
 
         ```ts
-        const db = makeDync(
+        const db = new Dync(
             ...,
             {
                 syncTables: ['items'], // Only add tables to this array that should be synced
@@ -86,6 +87,7 @@ And see how Dync compares to the alternatives [below](#hasnt-this-already-been-d
                     return res.json();
                 },
             },
+            ...,
         );
         ```
 
@@ -94,7 +96,7 @@ And see how Dync compares to the alternatives [below](#hasnt-this-already-been-d
 - Full conflict resolution: `local-wins`, `remote-wins` or with `try-shallow-merge` the user can resolve with:
 
     ```ts
-    const { syncState, db } = useDync();
+    const syncState = useSyncState(db);
     syncState.conflicts; // Record<localId, Conflict>
     db.sync.resolveConflict(localId, true);
     ```
@@ -107,11 +109,12 @@ And see how Dync compares to the alternatives [below](#hasnt-this-already-been-d
 
     ```ts
     useLiveQuery(
-        async (db) => {
+        db,
+        async () => {
             const items = await db.items.toArray(); // toArray() executes the query
             setTodos(items);
         },
-        [], // Re-run when variables change
+        [], // Re-run when variables change (None defined)
         ['items'], // Re-run when tables change
     );
     ```
@@ -124,6 +127,7 @@ And see how Dync compares to the alternatives [below](#hasnt-this-already-been-d
 
 - Full IndexedDB & SQL unified query language:
     - Using IndexedDB functions or raw SQL will always be more expressive independently
+    - When required, best performance will always come from native api
     - No need to learn another api when you might only need one storage type
     - Would greatly increase complexity of this library
 

package/dist/{dexie-DRLMKLl5.d.ts → dexie-B1FuZqDB.d.ts}

@@ -440,4 +440,4 @@ declare class DexieAdapter implements StorageAdapter {
     transaction<T>(mode: TransactionMode, tableNames: string[], callback: (context: StorageTransactionContext) => Promise<T>): Promise<T>;
 }
 
-export { DexieQueryContext as D, MemoryAdapter as M, SQLiteAdapter as S, type TableSchemaDefinition as T, MemoryQueryContext as a, SqliteQueryContext as b, type StorageAdapter as c, type StorageTable as d, DexieAdapter as e };
+export { DexieQueryContext as D, MemoryQueryContext as M, type StorageAdapter as S, type TableSchemaDefinition as T, SqliteQueryContext as a, type StorageTable as b, MemoryAdapter as c, SQLiteAdapter as d, DexieAdapter as e };

package/dist/{dexie-BqktVP7s.d.cts → dexie-DtgGGM68.d.cts}

@@ -440,4 +440,4 @@ declare class DexieAdapter implements StorageAdapter {
     transaction<T>(mode: TransactionMode, tableNames: string[], callback: (context: StorageTransactionContext) => Promise<T>): Promise<T>;
 }
 
-export { DexieQueryContext as D, MemoryAdapter as M, SQLiteAdapter as S, type TableSchemaDefinition as T, MemoryQueryContext as a, SqliteQueryContext as b, type StorageAdapter as c, type StorageTable as d, DexieAdapter as e };
+export { DexieQueryContext as D, MemoryQueryContext as M, type StorageAdapter as S, type TableSchemaDefinition as T, SqliteQueryContext as a, type StorageTable as b, MemoryAdapter as c, SQLiteAdapter as d, DexieAdapter as e };

package/dist/dexie.d.cts

@@ -1,3 +1,3 @@
-export { e as DexieAdapter, D as DexieQueryContext, c as StorageAdapter } from './dexie-BqktVP7s.cjs';
+export { e as DexieAdapter, D as DexieQueryContext, S as StorageAdapter } from './dexie-DtgGGM68.cjs';
 import 'dexie';
 import './types-CSbIAfu2.cjs';

package/dist/dexie.d.ts

@@ -1,3 +1,3 @@
-export { e as DexieAdapter, D as DexieQueryContext, c as StorageAdapter } from './dexie-DRLMKLl5.js';
+export { e as DexieAdapter, D as DexieQueryContext, S as StorageAdapter } from './dexie-B1FuZqDB.js';
 import 'dexie';
 import './types-CSbIAfu2.js';

package/dist/index.cjs

@@ -1340,6 +1340,10 @@ var DyncBase = class {
     this.state = new StateManager({
       storageAdapter: this.adapter
     });
+    Object.defineProperty(this.sync, "state", {
+      get: () => this.getSyncState(),
+      enumerable: true
+    });
     const driverInfo = "driverType" in this.adapter ? ` (Driver: ${this.adapter.driverType})` : "";
     this.logger.debug(`[dync] Initialized with ${this.adapter.type}${driverInfo}`);
   }
@@ -1714,7 +1718,8 @@ var DyncBase = class {
   sync = {
     enable: this.enableSync.bind(this),
     startFirstLoad: this.startFirstLoad.bind(this),
-    getState: this.getSyncState.bind(this),
+    state: void 0,
+    // getter in constructor
     resolveConflict: this.resolveConflict.bind(this),
     onStateChange: this.onSyncStateChange.bind(this),
     onMutation: this.onMutation.bind(this)