cry-synced-db-client 0.1.113 → 0.1.115

package/dist/index.js

@@ -3427,7 +3427,7 @@ var SyncedDb = class _SyncedDb {
     this.syncOnlyCollections = null;
     // Sync metadata cache
     this.syncMetaCache = /* @__PURE__ */ new Map();
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
     this.tenant = config.tenant;
     this.dexieDb = config.dexieDb;
     this.inMemDb = config.inMemDb;
@@ -3435,9 +3435,11 @@ var SyncedDb = class _SyncedDb {
     this.serverUpdateNotifier = config.serverUpdateNotifier;
     this.updaterId = Math.random().toString(36).substring(2, 15);
     this.syncedDbInstanceId = `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
-    const windowId = (_a = config._testWindowId) != null ? _a : this.getOrCreateWindowId();
-    this.defaultReturnDeleted = (_b = config.returnDeleted) != null ? _b : false;
-    this.defaultReturnArchived = (_c = config.returnArchived) != null ? _c : false;
+    this.dexieLoadConcurrency = (_a = config.dexieLoadConcurrency) != null ? _a : 1;
+    const windowId = (_b = config._testWindowId) != null ? _b : this.getOrCreateWindowId();
+    this.defaultReturnDeleted = (_c = config.returnDeleted) != null ? _c : false;
+    this.defaultReturnArchived = (_d = config.returnArchived) != null ? _d : false;
+    this.onDatabaseCreated = config.onDatabaseCreated;
     this.onSyncStart = config.onSyncStart;
     this.onSyncEnd = config.onSyncEnd;
     this.onDexieSyncStart = config.onDexieSyncStart;
@@ -3455,7 +3457,7 @@ var SyncedDb = class _SyncedDb {
     this.inMemManager = new InMemManager({
       inMemDb: this.inMemDb,
       collections: this.collections,
-      useObjectMetadata: (_d = config.useObjectMetadata) != null ? _d : false
+      useObjectMetadata: (_e = config.useObjectMetadata) != null ? _e : false
     });
     this.leaderElection = new LeaderElectionManager({
       tenant: this.tenant,
@@ -3477,7 +3479,7 @@ var SyncedDb = class _SyncedDb {
       tenant: this.tenant,
       instanceId: this.syncedDbInstanceId,
       windowId,
-      debounceMs: (_e = config.crossTabSyncDebounceMs) != null ? _e : 100,
+      debounceMs: (_f = config.crossTabSyncDebounceMs) != null ? _f : 100,
       callbacks: {
         onCrossTabSync: config.onCrossTabSync,
         onInfrastructureError: config.onInfrastructureError ? (type, message, error) => {
@@ -3503,8 +3505,8 @@ var SyncedDb = class _SyncedDb {
     });
     this.connectionManager = new ConnectionManager({
       restInterface: this.restInterface,
-      restTimeoutMs: (_f = config.restTimeoutMs) != null ? _f : 9e4,
-      syncTimeoutMs: (_g = config.syncTimeoutMs) != null ? _g : 12e4,
+      restTimeoutMs: (_g = config.restTimeoutMs) != null ? _g : 9e4,
+      syncTimeoutMs: (_h = config.syncTimeoutMs) != null ? _h : 12e4,
       autoSyncIntervalMs: config.autoSyncIntervalMs,
       callbacks: {
         onOnlineStatusChange: config.onOnlineStatusChange,
@@ -3530,8 +3532,8 @@ var SyncedDb = class _SyncedDb {
     });
     this.pendingChanges = new PendingChangesManager({
       tenant: this.tenant,
-      debounceDexieWritesMs: (_h = config.debounceDexieWritesMs) != null ? _h : 500,
-      debounceRestWritesMs: (_i = config.debounceRestWritesMs) != null ? _i : 100,
+      debounceDexieWritesMs: (_i = config.debounceDexieWritesMs) != null ? _i : 500,
+      debounceRestWritesMs: (_j = config.debounceRestWritesMs) != null ? _j : 100,
       callbacks: {
         onDexieWriteRequest: config.onDexieWriteRequest,
         onDexieWriteResult: config.onDexieWriteResult,
@@ -3608,8 +3610,8 @@ var SyncedDb = class _SyncedDb {
     });
     if (config.wakeSyncEnabled) {
       this.wakeSync = new WakeSyncManager({
-        gapThresholdMs: (_j = config.wakeSyncGapThresholdMs) != null ? _j : 1e4,
-        debounceMs: (_k = config.wakeSyncDebounceMs) != null ? _k : 2e3,
+        gapThresholdMs: (_k = config.wakeSyncGapThresholdMs) != null ? _k : 1e4,
+        debounceMs: (_l = config.wakeSyncDebounceMs) != null ? _l : 2e3,
         callbacks: {
           onWakeSync: config.onWakeSync
         },
@@ -3624,7 +3626,7 @@ var SyncedDb = class _SyncedDb {
     }
     if (config.networkStatusEnabled) {
       this.networkStatus = new NetworkStatusManager({
-        debounceMs: (_l = config.networkStatusDebounceMs) != null ? _l : 100,
+        debounceMs: (_m = config.networkStatusDebounceMs) != null ? _m : 100,
         callbacks: {
           onBrowserNetworkChange: config.onBrowserNetworkChange,
           onBrowserOnline: config.onBrowserOnline,
@@ -3667,16 +3669,7 @@ var SyncedDb = class _SyncedDb {
       }
     }
     if (newlyAllowed.length > 0) {
-      const dexieStart = Date.now();
-      let totalItems = 0;
-      this.safeCallback(this.onDexieSyncStart, { calledFrom: "setSyncOnlyTheseCollections", collectionCount: newlyAllowed.length });
-      for (let i = 0; i < newlyAllowed.length; i++) {
-        const name = newlyAllowed[i];
-        const items = await this.loadCollectionToInMem(name);
-        totalItems += items;
-        this.safeCallback(this.onSyncProgress, { collection: name, loaded: i + 1, total: newlyAllowed.length, items });
-      }
-      this.safeCallback(this.onDexieSyncEnd, { calledFrom: "setSyncOnlyTheseCollections", collectionCount: newlyAllowed.length, totalItems, durationMs: Date.now() - dexieStart });
+      await this.loadCollectionsToInMem(newlyAllowed, "setSyncOnlyTheseCollections");
     }
     if (newlyAllowed.length > 0 && this.connectionManager.canSync()) {
       this.sync("setSyncOnlyTheseCollections").catch(() => {
@@ -3714,18 +3707,16 @@ var SyncedDb = class _SyncedDb {
     }
     await this._loadLastFullSync();
     await this._loadLastInitialSync();
+    if (this.dexieDb.isNewDatabase() && this.onDatabaseCreated) {
+      try {
+        this.onDatabaseCreated();
+      } catch (err) {
+        console.error("onDatabaseCreated callback failed:", err);
+      }
+    }
     await this.pendingChanges.recoverPendingWrites();
     const allowedColls = [...this.collections.keys()].filter((n) => this.isSyncAllowed(n));
-    const dexieStart = Date.now();
-    let totalItems = 0;
-    this.safeCallback(this.onDexieSyncStart, { calledFrom: "init", collectionCount: allowedColls.length });
-    for (let i = 0; i < allowedColls.length; i++) {
-      const name = allowedColls[i];
-      const items = await this.loadCollectionToInMem(name);
-      totalItems += items;
-      this.safeCallback(this.onSyncProgress, { collection: name, loaded: i + 1, total: allowedColls.length, items });
-    }
-    this.safeCallback(this.onDexieSyncEnd, { calledFrom: "init", collectionCount: allowedColls.length, totalItems, durationMs: Date.now() - dexieStart });
+    await this.loadCollectionsToInMem(allowedColls, "init");
     this.leaderElection.init();
     this.crossTabSync.init();
     (_a = this.wakeSync) == null ? void 0 : _a.init();
@@ -4558,6 +4549,47 @@ var SyncedDb = class _SyncedDb {
       }
     }
   }
+  /**
+   * Load multiple collections from Dexie into in-mem with concurrency control.
+   * @returns total items loaded
+   */
+  async loadCollectionsToInMem(names, calledFrom) {
+    if (names.length === 0) return 0;
+    const dexieStart = Date.now();
+    let totalItems = 0;
+    let loaded = 0;
+    this.safeCallback(this.onDexieSyncStart, {
+      calledFrom,
+      collectionCount: names.length
+    });
+    const concurrency = this.dexieLoadConcurrency;
+    const queue = [...names];
+    const workers = Array.from(
+      { length: Math.min(concurrency, queue.length) },
+      async () => {
+        while (queue.length > 0) {
+          const name = queue.shift();
+          const items = await this.loadCollectionToInMem(name);
+          totalItems += items;
+          loaded++;
+          this.safeCallback(this.onSyncProgress, {
+            collection: name,
+            loaded,
+            total: names.length,
+            items
+          });
+        }
+      }
+    );
+    await Promise.all(workers);
+    this.safeCallback(this.onDexieSyncEnd, {
+      calledFrom,
+      collectionCount: names.length,
+      totalItems,
+      durationMs: Date.now() - dexieStart
+    });
+    return totalItems;
+  }
   async loadCollectionToInMem(name) {
     const allItems = [];
     await this.dexieDb.forEachBatch(name, 2e3, async (chunk) => {
@@ -4577,7 +4609,7 @@ var SyncedDb = class _SyncedDb {
   }
   assertCollection(name) {
     if (!this.collections.has(name)) {
-      throw new Error(`Collection "${name}" not configured`);
+      throw new Error(`SyncedDb: Collection "${(name == null ? void 0 : name.toString()) || "?"}" not configured`);
     }
   }
   /** Stringify an Id parameter (ObjectId → hex string). */
@@ -4658,6 +4690,7 @@ var DexieDb = class extends Dexie {
   constructor(tenant, collectionConfigs) {
     super(`synced-db-${tenant}`);
     this.collections = /* @__PURE__ */ new Map();
+    this._isNewDatabase = false;
     this.tenant = tenant;
     const schema = {};
     schema[SYNC_META_TABLE] = "[tenant+collection]";
@@ -4666,6 +4699,9 @@ var DexieDb = class extends Dexie {
       schema[config.name] = "_id";
     }
     this.version(1).stores(schema);
+    this.on("populate", () => {
+      this._isNewDatabase = true;
+    });
     this.syncMeta = this.table(SYNC_META_TABLE);
     this.dirtyChanges = this.table(DIRTY_CHANGES_TABLE);
     for (const config of collectionConfigs) {
@@ -4675,7 +4711,7 @@ var DexieDb = class extends Dexie {
   getTable(collection) {
     const table = this.collections.get(collection);
     if (!table) {
-      throw new Error(`Collection "${collection}" not configured`);
+      throw new Error(`DexieDb: Collection "${(collection == null ? void 0 : collection.toString()) || "?"}" not configured`);
     }
     return table;
   }
@@ -4874,6 +4910,9 @@ var DexieDb = class extends Dexie {
   getTenant() {
     return this.tenant;
   }
+  isNewDatabase() {
+    return this._isNewDatabase;
+  }
 };
 
 // node_modules/msgpackr/unpack.js

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

@@ -12,6 +12,7 @@ export declare class DexieDb extends Dexie implements I_DexieDb {
     private collections;
     private syncMeta;
     private dirtyChanges;
+    private _isNewDatabase;
     constructor(tenant: string, collectionConfigs: CollectionConfig<any>[]);
     private getTable;
     private idToString;
@@ -51,4 +52,5 @@ export declare class DexieDb extends Dexie implements I_DexieDb {
     setSyncMeta(collection: string, lastSyncTs: any): Promise<void>;
     deleteSyncMeta(collection: string): Promise<void>;
     getTenant(): string;
+    isNewDatabase(): boolean;
 }

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

@@ -31,12 +31,14 @@ export declare class SyncedDb implements I_SyncedDb {
     private syncOnlyCollections;
     private readonly updaterId;
     private readonly syncedDbInstanceId;
+    private readonly dexieLoadConcurrency;
     private syncMetaCache;
     private unsubscribeServerUpdates?;
     private cleanupNotifierCallbacks?;
     private beforeUnloadHandler?;
     private readonly defaultReturnDeleted;
     private readonly defaultReturnArchived;
+    private readonly onDatabaseCreated?;
     private readonly onSyncStart?;
     private readonly onSyncEnd?;
     private readonly onDexieSyncStart?;
@@ -181,6 +183,11 @@ export declare class SyncedDb implements I_SyncedDb {
      */
     /** Safe callback invocation — swallows errors */
     private safeCallback;
+    /**
+     * Load multiple collections from Dexie into in-mem with concurrency control.
+     * @returns total items loaded
+     */
+    private loadCollectionsToInMem;
     private loadCollectionToInMem;
     private assertCollection;
     /** Stringify an Id parameter (ObjectId → hex string). */

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

@@ -116,5 +116,7 @@ export interface I_DexieDb {
     deleteSyncMeta(collection: string): Promise<void>;
     /** Vrne tenant */
     getTenant(): string;
+    /** Returns true if the IndexedDB database was created fresh during this session (first ever open). */
+    isNewDatabase(): boolean;
 }
 export {};

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

@@ -293,6 +293,8 @@ export interface SyncedDbConfig {
     debounceRestWritesMs?: number;
     /** Callback ki se pokliče, ko SyncedDb sam preide v offline stanje (npr. ob sync napaki) */
     onForcedOffline?: (reason: string) => void;
+    /** Callback fired once during init() when the IndexedDB database was created fresh (first ever open). */
+    onDatabaseCreated?: () => void;
     /** Callback at the start of each sync cycle. initialSync=true if no full sync has completed yet. */
     onSyncStart?: (info: {
         calledFrom?: string;
@@ -406,6 +408,12 @@ export interface SyncedDbConfig {
      * Default: false
      */
     returnArchived?: boolean;
+    /**
+     * Number of collections to load from Dexie concurrently during init
+     * and setSyncOnlyTheseCollections. Higher values speed up initial load
+     * by issuing parallel IndexedDB reads. Default: 1 (sequential).
+     */
+    dexieLoadConcurrency?: number;
     /**
      * Enable sync on wake from sleep for leader tab.
      * When enabled, detects wake via pageshow/focus/visibilitychange events

package/package.json

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