async-storage-sync 1.0.5 → 1.0.6

package/README.md

@@ -64,7 +64,7 @@ console.log(`${pending.length} forms waiting to sync`);
 - `autoSync: false`: no automatic syncing; call sync methods manually when you choose.
 - Manual methods:
   - `store.flushWithResult()` → sync all pending and return summary counts
-  - `store.sync(collection)` → sync one collection
+  - `store.syncWithResult(collection)` → sync one collection and return summary counts
   - `store.syncById(collection, id)` → sync one record
 - Sync destination is controlled by your config: `serverUrl + endpoint`.
 
@@ -88,7 +88,7 @@ console.log(`${pending.length} forms waiting to sync`);
 | `store.deleteById(collection, id)` | Delete one record by internal `_id` |
 | `store.deleteCollection(collection)` | Delete all records in one collection |
 | `store.flushWithResult()` | Sync all pending and return detailed summary (`attempted`, `synced`, `failed`, `retried`, `remainingPending`, `items`) |
-| `store.sync(collection)` | Sync pending items for one collection only |
+| `store.syncWithResult(collection)` | Sync collection and return detailed summary (same format as `flushWithResult()`) |
 | `store.syncById(collection, id)` | Sync one specific record by internal `_id` |
 | `store.requeueFailed()` | Move `failed` records back to pending queue for retry |
 | `store.onSynced(callback)` | Event callback for successful sync of each item |

package/dist/index.d.mts

@@ -80,7 +80,7 @@ declare class AsyncStorageSync {
     getById<T extends Record<string, unknown>>(name: string, id: string): Promise<StoredRecord<T> | null>;
     deleteById(name: string, id: string): Promise<void>;
     deleteCollection(name: string): Promise<void>;
-    sync(name: string): Promise<void>;
+    syncWithResult(name: string): Promise<FlushResult>;
     syncById(_name: string, id: string): Promise<void>;
     flushWithResult(): Promise<FlushResult>;
     /**

package/dist/index.d.ts

@@ -80,7 +80,7 @@ declare class AsyncStorageSync {
     getById<T extends Record<string, unknown>>(name: string, id: string): Promise<StoredRecord<T> | null>;
     deleteById(name: string, id: string): Promise<void>;
     deleteCollection(name: string): Promise<void>;
-    sync(name: string): Promise<void>;
+    syncWithResult(name: string): Promise<FlushResult>;
     syncById(_name: string, id: string): Promise<void>;
     flushWithResult(): Promise<FlushResult>;
     /**

package/dist/index.js

@@ -281,11 +281,41 @@ var SyncEngine = class {
       this.isFlushing = false;
     }
   }
-  async flushCollection(collectionName) {
+  async flushCollectionWithResult(collectionName) {
+    const result = {
+      attempted: 0,
+      synced: 0,
+      failed: 0,
+      retried: 0,
+      deferred: 0,
+      networkErrors: 0,
+      remainingPending: 0,
+      skippedAlreadyFlushing: false,
+      items: []
+    };
     const pending = this.queue.getPendingForCollection(collectionName);
+    if (pending.length === 0) {
+      result.remainingPending = this.queue.getPendingForCollection(collectionName).length;
+      return result;
+    }
     for (const item of pending) {
-      await this.syncItem(item);
+      result.attempted += 1;
+      const itemResult = await this.syncItem(item);
+      result.items.push(itemResult);
+      if (itemResult.status === "synced") {
+        result.synced += 1;
+      } else if (itemResult.status === "failed") {
+        result.failed += 1;
+      } else if (itemResult.status === "retried") {
+        result.retried += 1;
+      } else if (itemResult.status === "deferred-backoff") {
+        result.deferred += 1;
+      } else if (itemResult.status === "network-error") {
+        result.networkErrors += 1;
+      }
     }
+    result.remainingPending = this.queue.getPendingForCollection(collectionName).length;
+    return result;
   }
   async flushRecord(recordId) {
     const item = this.queue.getPendingForRecord(recordId);
@@ -556,8 +586,8 @@ var _AsyncStorageSync = class _AsyncStorageSync {
   async deleteCollection(name) {
     await this.driver.remove(collectionKey(name));
   }
-  async sync(name) {
-    await this.engine.flushCollection(name);
+  async syncWithResult(name) {
+    return this.engine.flushCollectionWithResult(name);
   }
   async syncById(_name, id) {
     await this.engine.flushRecord(id);

package/dist/index.mjs

@@ -259,11 +259,41 @@ var SyncEngine = class {
       this.isFlushing = false;
     }
   }
-  async flushCollection(collectionName) {
+  async flushCollectionWithResult(collectionName) {
+    const result = {
+      attempted: 0,
+      synced: 0,
+      failed: 0,
+      retried: 0,
+      deferred: 0,
+      networkErrors: 0,
+      remainingPending: 0,
+      skippedAlreadyFlushing: false,
+      items: []
+    };
     const pending = this.queue.getPendingForCollection(collectionName);
+    if (pending.length === 0) {
+      result.remainingPending = this.queue.getPendingForCollection(collectionName).length;
+      return result;
+    }
     for (const item of pending) {
-      await this.syncItem(item);
+      result.attempted += 1;
+      const itemResult = await this.syncItem(item);
+      result.items.push(itemResult);
+      if (itemResult.status === "synced") {
+        result.synced += 1;
+      } else if (itemResult.status === "failed") {
+        result.failed += 1;
+      } else if (itemResult.status === "retried") {
+        result.retried += 1;
+      } else if (itemResult.status === "deferred-backoff") {
+        result.deferred += 1;
+      } else if (itemResult.status === "network-error") {
+        result.networkErrors += 1;
+      }
     }
+    result.remainingPending = this.queue.getPendingForCollection(collectionName).length;
+    return result;
   }
   async flushRecord(recordId) {
     const item = this.queue.getPendingForRecord(recordId);
@@ -534,8 +564,8 @@ var _AsyncStorageSync = class _AsyncStorageSync {
   async deleteCollection(name) {
     await this.driver.remove(collectionKey(name));
   }
-  async sync(name) {
-    await this.engine.flushCollection(name);
+  async syncWithResult(name) {
+    return this.engine.flushCollectionWithResult(name);
   }
   async syncById(_name, id) {
     await this.engine.flushRecord(id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "async-storage-sync",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Offline-first data layer for React Native with local-first storage and automatic sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",