cry-synced-db-client 0.1.117 → 0.1.118

package/dist/index.js

@@ -4484,6 +4484,31 @@ var SyncedDb = class _SyncedDb {
     this.syncMetaCache.clear();
     this._clearLastFullSync();
   }
+  /**
+   * Clear all collection data and sync metadata, then re-download
+   * from server. Dirty changes (pending local writes) are preserved
+   * so unsynchronized edits are NOT lost.
+   *
+   * Flow:
+   * 1. Flush pending in-memory changes to Dexie dirty table
+   * 2. Clear collection data tables in Dexie (NOT dirty changes)
+   * 3. Clear in-memory collections
+   * 4. Reset sync timestamps (so next sync downloads everything)
+   *
+   * After this method returns, call sync() to re-download all data.
+   * The sync will also upload any remaining dirty items.
+   */
+  async refreshDatabaseFromServer() {
+    await this.pendingChanges.flushAll();
+    const collectionNames = Array.from(this.collections.keys());
+    for (const collectionName of collectionNames) {
+      await this.dexieDb.deleteCollection(collectionName);
+      this.inMemManager.clearCollection(collectionName);
+      await this.dexieDb.deleteSyncMeta(collectionName);
+    }
+    this.syncMetaCache.clear();
+    this._clearLastFullSync();
+  }
   // ==================== Object Metadata ====================
   getObjectMetadata(collection, _id) {
     return this.inMemManager.getObjectMetadata(collection, _id);

package/dist/src/db/SyncedDb.d.ts

@@ -152,6 +152,21 @@ export declare class SyncedDb implements I_SyncedDb {
     getDirty<T extends DbEntity>(): Promise<Readonly<Record<string, readonly T[]>>>;
     dropCollection(collection: string, force?: boolean): Promise<void>;
     dropDatabase(force?: boolean): Promise<void>;
+    /**
+     * Clear all collection data and sync metadata, then re-download
+     * from server. Dirty changes (pending local writes) are preserved
+     * so unsynchronized edits are NOT lost.
+     *
+     * Flow:
+     * 1. Flush pending in-memory changes to Dexie dirty table
+     * 2. Clear collection data tables in Dexie (NOT dirty changes)
+     * 3. Clear in-memory collections
+     * 4. Reset sync timestamps (so next sync downloads everything)
+     *
+     * After this method returns, call sync() to re-download all data.
+     * The sync will also upload any remaining dirty items.
+     */
+    refreshDatabaseFromServer(): Promise<void>;
     getObjectMetadata<M>(collection: string, _id: Id): M | undefined;
     getObjectsMetadata<M>(collection: string, _ids: Id[]): (M | undefined)[];
     setObjectMetadata<M>(collection: string, _id: Id, metadata: M): void;

package/dist/src/types/I_SyncedDb.d.ts

@@ -664,6 +664,12 @@ export interface I_SyncedDb {
      * @throws Error if offline, forcedOffline, or sync fails (unless force=true)
      */
     dropDatabase(force?: boolean): Promise<void>;
+    /**
+     * Clear all collection data and sync metadata, preserving dirty
+     * changes (pending local writes). Call sync() after to re-download.
+     * Unlike dropDatabase(), this never discards unsynchronized edits.
+     */
+    refreshDatabaseFromServer(): Promise<void>;
     /**
      * Check if this instance is the leader tab.
      * Only the leader processes server notifications and writes to Dexie from server updates.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-synced-db-client",
-  "version": "0.1.117",
+  "version": "0.1.118",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",