dexie-cloud-addon 4.4.1 → 4.4.3

package/dist/umd/service-worker.js

@@ -8,7 +8,7 @@
  *
  * ==========================================================================
  *
- * Version 4.4.1, Thu Mar 19 2026
+ * Version 4.4.3, Sat Mar 21 2026
  *
  * https://dexie.org
  *
@@ -13558,7 +13558,7 @@
      *
      * ==========================================================================
      *
-     * Version 4.4.0, Thu Mar 19 2026
+     * Version 4.4.0, Sat Mar 21 2026
      *
      * https://dexie.org
      *
@@ -15028,13 +15028,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
@@ -15051,7 +15051,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) {
@@ -15072,7 +15072,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(
@@ -15084,7 +15084,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 = [];
@@ -15114,9 +15114,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);
@@ -17727,7 +17735,7 @@
                 const searchParams = new URLSearchParams();
                 if (this.subscriber.closed)
                     return;
-                searchParams.set('v', '2');
+                searchParams.set('v', '3'); // v3 = supports BlobRef (blob offloading)
                 if (this.rev)
                     searchParams.set('rev', this.rev);
                 if (this.yrev)
@@ -19324,7 +19332,7 @@
         const downloading$ = createDownloadingState();
         dexie.cloud = {
             // @ts-ignore
-            version: "4.4.1",
+            version: "4.4.3",
             options: Object.assign({}, DEFAULT_OPTIONS),
             schema: null,
             get currentUserId() {
@@ -19353,14 +19361,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;
@@ -19748,7 +19759,7 @@
         }
     }
     // @ts-ignore
-    dexieCloud.version = "4.4.1";
+    dexieCloud.version = "4.4.3";
     Dexie.Cloud = dexieCloud;
 
     // In case the SW lives for a while, let it reuse already opened connections: