dexie-cloud-addon 4.4.1 → 4.4.2

package/dist/umd/dexie-cloud-addon.js

@@ -8,7 +8,7 @@
  *
  * ==========================================================================
  *
- * Version 4.4.1, Thu Mar 19 2026
+ * Version 4.4.2, Thu Mar 19 2026
  *
  * https://dexie.org
  *
@@ -15829,13 +15829,13 @@
                                 //triggerSync(db, 'pull');
                                 yield db.cloud.sync({ purpose: 'pull', wait: true });
                                 break;
-                            case 'changes':
+                            case 'changes': {
                                 console.debug('changes');
                                 if (((_f = db.cloud.syncState.value) === null || _f === void 0 ? void 0 : _f.phase) === 'error') {
                                     triggerSync(db, 'pull');
                                     break;
                                 }
-                                yield db.transaction('rw', db.dx.tables, (tx) => __awaiter(this, void 0, void 0, function* () {
+                                const didApplyChanges = yield db.transaction('rw', db.dx.tables, (tx) => __awaiter(this, void 0, void 0, function* () {
                                     // @ts-ignore
                                     tx.idbtrans.disableChangeTracking = true;
                                     // @ts-ignore
@@ -15852,7 +15852,7 @@
                                             schema,
                                             currentUser,
                                         });
-                                        return; // Initial sync must have taken place - otherwise, ignore this.
+                                        return false; // Initial sync must have taken place - otherwise, ignore this.
                                     }
                                     // Verify again in ACID tx that we're on same server revision.
                                     if (msg.baseRev !== syncState.serverRevision) {
@@ -15873,7 +15873,7 @@
                                             // If we don't do a sync request now, we could stuck in an endless loop.
                                             triggerSync(db, 'pull');
                                         }
-                                        return; // Ignore message
+                                        return false; // Ignore message
                                     }
                                     // Verify also that the message is based on the exact same set of realms
                                     const ourRealmSetHash = yield Dexie.waitFor(
@@ -15885,7 +15885,7 @@
                                         triggerSync(db, 'pull');
                                         // The message isn't based on the same realms.
                                         // Trigger a sync instead to resolve all things up.
-                                        return;
+                                        return false;
                                     }
                                     // Get clientChanges
                                     let clientChanges = [];
@@ -15915,9 +15915,17 @@
                                     //
                                     console.debug('Updating syncState', syncState);
                                     yield db.$syncState.put(syncState, 'syncState');
+                                    return true;
                                 }));
                                 console.debug('msg queue: done with rw transaction');
+                                // Trigger eager blob download for any BlobRefs received via WebSocket.
+                                // This mirrors the behavior after normal HTTP sync (syncCompleteEvent).
+                                // Only emit if changes were actually applied (not on early returns).
+                                if (didApplyChanges && msg.changes.length > 0) {
+                                    db.syncCompleteEvent.next();
+                                }
                                 break;
+                            }
                         }
                     }
                     catch (error) {
@@ -16888,7 +16896,7 @@
         return {
             stack: 'dbcore',
             name: 'blobResolve',
-            level: -2, // Run below other middlewares and after sync and caching middlewares
+            level: 2, // Run above cache (0) and other middlewares (1) to resolve BlobRefs from cached data
             create(downlevelDatabase) {
                 // Create a single queue instance for this database
                 const blobSavingQueue = new BlobSavingQueue(db);
@@ -19495,7 +19503,7 @@
         const downloading$ = createDownloadingState();
         dexie.cloud = {
             // @ts-ignore
-            version: "4.4.1",
+            version: "4.4.2",
             options: Object.assign({}, DEFAULT_OPTIONS),
             schema: null,
             get currentUserId() {
@@ -19524,14 +19532,17 @@
             roles: getGlobalRolesObservable(dexie),
             configure(options) {
                 // Validate maxStringLength — Infinity disables offloading, otherwise must be
-                // a finite positive number not exceeding the server limit (32768).
+                // a finite number between 100 and the server limit (32768).
+                // Minimum 100 prevents accidental offloading of primary keys and short strings
+                // that would break sync.
+                const MIN_STRING_LENGTH = 100;
                 const MAX_SERVER_STRING_LENGTH = 32768;
                 if (options.maxStringLength !== undefined &&
                     options.maxStringLength !== Infinity &&
                     (!Number.isFinite(options.maxStringLength) ||
-                        options.maxStringLength < 0 ||
+                        options.maxStringLength < MIN_STRING_LENGTH ||
                         options.maxStringLength > MAX_SERVER_STRING_LENGTH)) {
-                    throw new Error(`maxStringLength must be Infinity or a finite number in [0, ${MAX_SERVER_STRING_LENGTH}]. Got: ${options.maxStringLength}`);
+                    throw new Error(`maxStringLength must be Infinity or a finite number in [${MIN_STRING_LENGTH}, ${MAX_SERVER_STRING_LENGTH}]. Got: ${options.maxStringLength}`);
                 }
                 options = dexie.cloud.options = Object.assign(Object.assign({}, dexie.cloud.options), options);
                 configuredProgramatically = true;
@@ -19919,7 +19930,7 @@
         }
     }
     // @ts-ignore
-    dexieCloud.version = "4.4.1";
+    dexieCloud.version = "4.4.2";
     Dexie.Cloud = dexieCloud;
 
     exports.default = dexieCloud;