dexie-cloud-addon 4.4.7 → 4.4.9

package/dist/modern/DexieCloudOptions.d.ts

@@ -50,7 +50,7 @@ export interface DexieCloudOptions {
      *   Best for apps with large media that may not all be needed offline.
      */
     blobMode?: 'eager' | 'lazy';
-    /** Maximum string length (in characters) before offloading to blob storage during sync.
+    /** String length threshold (in characters) for offloading to blob storage during sync.
      *
      * Strings longer than this threshold are uploaded as blobs during sync,
      * reducing sync payload size. The original string is kept intact in IndexedDB.
@@ -61,5 +61,9 @@ export interface DexieCloudOptions {
      *
      * @default 32768
      */
+    largeStringThreshold?: number;
+    /**
+     * @deprecated Use `largeStringThreshold` instead.
+     */
     maxStringLength?: number;
 }

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

@@ -8,7 +8,7 @@
  *
  * ==========================================================================
  *
- * Version 4.4.7, Fri Mar 27 2026
+ * Version 4.4.9, Tue Mar 31 2026
  *
  * https://dexie.org
  *
@@ -4569,6 +4569,14 @@ function loadCachedAccessToken(db) {
         });
         return Promise.resolve(currentUser.accessToken);
     }
+    // If the current user is not logged in (no isLoggedIn flag), there's no
+    // token to load from the database — skip the Dexie.ignoreTransaction() call.
+    // This avoids a crash in service worker context where Dexie's Promise zone
+    // (PSD.transless.env) may be undefined when called from within an active
+    // rw transaction (e.g. during applyServerChanges).
+    if (!(currentUser === null || currentUser === void 0 ? void 0 : currentUser.isLoggedIn)) {
+        return Promise.resolve(null);
+    }
     return Dexie.ignoreTransaction(() => loadAccessToken(db).then((user) => {
         var _a, _b;
         if (user === null || user === void 0 ? void 0 : user.accessToken) {
@@ -4630,7 +4638,7 @@ function _sync(db_1, options_1, schema_1) {
     return __awaiter(this, arguments, void 0, function* (db, options, schema, { isInitialSync, cancelToken, justCheckIfNeeded, purpose } = {
         isInitialSync: false,
     }) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         if (!justCheckIfNeeded) {
             console.debug('SYNC STARTED', { isInitialSync, purpose });
         }
@@ -4704,7 +4712,7 @@ function _sync(db_1, options_1, schema_1) {
         // Offload large blobs to blob storage before sync
         //
         let processedChangeSet = clientChangeSet;
-        const maxStringLength = (_c = (_b = db.cloud.options) === null || _b === void 0 ? void 0 : _b.maxStringLength) !== null && _c !== void 0 ? _c : 32768;
+        const maxStringLength = (_e = (_c = (_b = db.cloud.options) === null || _b === void 0 ? void 0 : _b.largeStringThreshold) !== null && _c !== void 0 ? _c : (_d = db.cloud.options) === null || _d === void 0 ? void 0 : _d.maxStringLength) !== null && _e !== void 0 ? _e : 32768;
         const hasLargeBlobs = hasLargeBlobsInOperations(clientChangeSet, maxStringLength);
         if (hasLargeBlobs) {
             processedChangeSet = yield offloadBlobsInOperations(clientChangeSet, databaseUrl, () => loadCachedAccessToken(db), maxStringLength);
@@ -5150,8 +5158,9 @@ class BlobDownloadTracker {
         if (!promise) {
             promise = loadCachedAccessToken(this.db)
                 .then((accessToken) => {
-                if (!accessToken)
-                    throw new Error('No access token available for blob download');
+                // accessToken may be null for anonymous/unauthenticated users.
+                // Public realm blobs (rlm-public) are accessible without auth.
+                // downloadBlob will omit the Authorization header when token is null.
                 return downloadBlob(blobRef, dbUrl, accessToken);
             })
                 .finally(() => this.inFlight.delete(blobRef.ref));
@@ -5164,19 +5173,22 @@ class BlobDownloadTracker {
 /**
  * Download blob data from server via proxy endpoint.
  * Uses auth header for authentication (same as sync).
+ * When accessToken is null, the request is made without Authorization header —
+ * this allows downloading blobs from public realms (rlm-public) for
+ * unauthenticated users.
  *
  * @param blobRef - The BlobRef to download
  * @param dbUrl - Base URL for the database (e.g., 'https://mydb.dexie.cloud')
- * @param accessToken - Access token for authentication
+ * @param accessToken - Access token for authentication, or null for anonymous access
  */
 function downloadBlob(blobRef, dbUrl, accessToken) {
     return __awaiter(this, void 0, void 0, function* () {
         const downloadUrl = `${dbUrl}/blob/${blobRef.ref}`;
-        const response = yield fetch(downloadUrl, {
-            headers: {
-                Authorization: `Bearer ${accessToken}`,
-            },
-        });
+        const headers = {};
+        if (accessToken) {
+            headers['Authorization'] = `Bearer ${accessToken}`;
+        }
+        const response = yield fetch(downloadUrl, { headers });
         if (!response.ok) {
             throw new Error(`Failed to download blob ${blobRef.ref}: ${response.status} ${response.statusText}`);
         }
@@ -8488,7 +8500,7 @@ function dexieCloud(dexie) {
     const downloading$ = createDownloadingState();
     dexie.cloud = {
         // @ts-ignore
-        version: "4.4.7",
+        version: "4.4.9",
         options: Object.assign({}, DEFAULT_OPTIONS),
         schema: null,
         get currentUserId() {
@@ -8516,18 +8528,27 @@ function dexieCloud(dexie) {
         invites: getInvitesObservable(dexie),
         roles: getGlobalRolesObservable(dexie),
         configure(options) {
-            // Validate maxStringLength — Infinity disables offloading, otherwise must be
-            // a finite number between 100 and the server limit (32768).
+            // Validate largeStringThreshold (preferred) or maxStringLength (deprecated) —
+            // Infinity disables offloading, otherwise must be 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 < MIN_STRING_LENGTH ||
-                    options.maxStringLength > MAX_SERVER_STRING_LENGTH)) {
-                throw new Error(`maxStringLength must be Infinity or a finite number in [${MIN_STRING_LENGTH}, ${MAX_SERVER_STRING_LENGTH}]. Got: ${options.maxStringLength}`);
+            if (options.maxStringLength !== undefined) {
+                console.warn('maxStringLength is deprecated, use largeStringThreshold instead');
+                // If largeStringThreshold is not explicitly set, migrate to new name
+                if (options.largeStringThreshold === undefined) {
+                    options = Object.assign(Object.assign({}, options), { largeStringThreshold: options.maxStringLength });
+                }
+            }
+            const thresholdValue = options.largeStringThreshold;
+            if (thresholdValue !== undefined &&
+                thresholdValue !== Infinity &&
+                (!Number.isFinite(thresholdValue) ||
+                    thresholdValue < MIN_STRING_LENGTH ||
+                    thresholdValue > MAX_SERVER_STRING_LENGTH)) {
+                throw new Error(`largeStringThreshold must be Infinity or a finite number in [${MIN_STRING_LENGTH}, ${MAX_SERVER_STRING_LENGTH}]. Got: ${thresholdValue}`);
             }
             options = dexie.cloud.options = Object.assign(Object.assign({}, dexie.cloud.options), options);
             configuredProgramatically = true;
@@ -8924,7 +8945,7 @@ function dexieCloud(dexie) {
     }
 }
 // @ts-ignore
-dexieCloud.version = "4.4.7";
+dexieCloud.version = "4.4.9";
 Dexie.Cloud = dexieCloud;
 
 export { dexieCloud as default, defineYDocTrigger, dexieCloud, getTiedObjectId, getTiedRealmId, resolveText };