dexie-cloud-addon 4.4.8 → 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.8, Tue Mar 31 2026
+ * Version 4.4.9, Tue Mar 31 2026
  *
  * https://dexie.org
  *
@@ -4638,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 });
         }
@@ -4712,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);
@@ -8500,7 +8500,7 @@ function dexieCloud(dexie) {
     const downloading$ = createDownloadingState();
     dexie.cloud = {
         // @ts-ignore
-        version: "4.4.8",
+        version: "4.4.9",
         options: Object.assign({}, DEFAULT_OPTIONS),
         schema: null,
         get currentUserId() {
@@ -8528,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;
@@ -8936,7 +8945,7 @@ function dexieCloud(dexie) {
     }
 }
 // @ts-ignore
-dexieCloud.version = "4.4.8";
+dexieCloud.version = "4.4.9";
 Dexie.Cloud = dexieCloud;
 
 export { dexieCloud as default, defineYDocTrigger, dexieCloud, getTiedObjectId, getTiedRealmId, resolveText };