dexie-cloud-addon 4.4.1 → 4.4.3

package/dist/modern/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
  *
@@ -4060,13 +4060,13 @@ function MessagesFromServerConsumer(db) {
                             //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
@@ -4083,7 +4083,7 @@ function MessagesFromServerConsumer(db) {
                                         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) {
@@ -4104,7 +4104,7 @@ function MessagesFromServerConsumer(db) {
                                         // 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(
@@ -4116,7 +4116,7 @@ function MessagesFromServerConsumer(db) {
                                     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 = [];
@@ -4146,9 +4146,17 @@ function MessagesFromServerConsumer(db) {
                                 //
                                 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) {
@@ -5920,7 +5928,7 @@ function createBlobResolveMiddleware(db) {
     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);
@@ -6497,7 +6505,7 @@ class WSConnection extends Subscription {
             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)
@@ -8094,7 +8102,7 @@ function dexieCloud(dexie) {
     const downloading$ = createDownloadingState();
     dexie.cloud = {
         // @ts-ignore
-        version: "4.4.1",
+        version: "4.4.3",
         options: Object.assign({}, DEFAULT_OPTIONS),
         schema: null,
         get currentUserId() {
@@ -8123,14 +8131,17 @@ function dexieCloud(dexie) {
         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;
@@ -8518,7 +8529,7 @@ function dexieCloud(dexie) {
     }
 }
 // @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: