dexie-cloud-addon 4.4.1 → 4.4.2

package/dist/modern/DexieCloudOptions.d.ts

@@ -56,6 +56,8 @@ export interface DexieCloudOptions {
      * reducing sync payload size. The original string is kept intact in IndexedDB.
      *
      * Set to `Infinity` to disable string offloading.
+     * Minimum value is 100 to prevent accidental offloading of primary keys.
+     * Maximum value is 32768 (server limit).
      *
      * @default 32768
      */

package/dist/modern/default-ui/AuthProviderButton.d.ts

@@ -0,0 +1,21 @@
+import { h } from 'preact';
+import type { OAuthProviderInfo } from 'dexie-cloud-common';
+export interface AuthProviderButtonProps {
+    provider: OAuthProviderInfo;
+    onClick: () => void;
+}
+/**
+ * Button component for OAuth provider login.
+ * Displays the provider's icon and name following provider branding guidelines.
+ */
+export declare function AuthProviderButton({ provider, onClick }: AuthProviderButtonProps): h.JSX.Element;
+/**
+ * Button for email/OTP authentication option.
+ */
+export declare function OtpButton({ onClick }: {
+    onClick: () => void;
+}): h.JSX.Element;
+/**
+ * Visual divider with "or" text.
+ */
+export declare function Divider(): h.JSX.Element;

package/dist/modern/default-ui/ProviderSelectionDialog.d.ts

@@ -0,0 +1,7 @@
+import { h } from 'preact';
+import { DXCProviderSelection } from '../types/DXCUserInteraction';
+/**
+ * Dialog component for OAuth provider selection.
+ * Displays available OAuth providers as buttons and optionally an email/OTP option.
+ */
+export declare function ProviderSelectionDialog({ title, alerts, providers, otpEnabled, cancelLabel, onSelectProvider, onSelectOtp, onCancel, }: DXCProviderSelection): h.JSX.Element;

package/dist/modern/default-ui/SelectDialog.d.ts

@@ -0,0 +1,10 @@
+import { h } from 'preact';
+import { DXCSelect } from '../types/DXCUserInteraction';
+/**
+ * Dialog component for generic option selection.
+ * Displays available options as buttons.
+ *
+ * This component is UI-agnostic and works with any DXCSelect interaction,
+ * whether for authentication, settings, or other selection purposes.
+ */
+export declare function SelectDialog({ title, alerts, options, cancelLabel, onSelect, onCancel, }: DXCSelect): h.JSX.Element;

package/dist/modern/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
  *
@@ -4861,13 +4861,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
@@ -4884,7 +4884,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) {
@@ -4905,7 +4905,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(
@@ -4917,7 +4917,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 = [];
@@ -4947,9 +4947,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);
@@ -8265,7 +8273,7 @@ function dexieCloud(dexie) {
     const downloading$ = createDownloadingState();
     dexie.cloud = {
         // @ts-ignore
-        version: "4.4.1",
+        version: "4.4.2",
         options: Object.assign({}, DEFAULT_OPTIONS),
         schema: null,
         get currentUserId() {
@@ -8294,14 +8302,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;
@@ -8689,7 +8700,7 @@ function dexieCloud(dexie) {
     }
 }
 // @ts-ignore
-dexieCloud.version = "4.4.1";
+dexieCloud.version = "4.4.2";
 Dexie.Cloud = dexieCloud;
 
 export { dexieCloud as default, defineYDocTrigger, dexieCloud, getTiedObjectId, getTiedRealmId, resolveText };