// Initiate login - shows provider selection if available
await db.cloud.login();

// Or specify a provider directly
await db.cloud.login({ provider: 'google' });

Configuration Options:

db.cloud.configure({
  databaseUrl: 'https://mydb.dexie.cloud',
  
  // Enable/disable social auth (default: true)
  socialAuth: true, // also configure in https://manager.dexie.cloud
});

⚡ Suspense Support in dexie-react-hooks (Experimental)

Requires installation of dexie-react-hooks@4.2.1-beta.1

New experimental hooks for React Suspense integration:

import { useSuspendingLiveQuery, useSuspendingObservable } from 'dexie-react-hooks';

function MyComponent() {
  // Suspends until data is available - no undefined state!
  const friends = useSuspendingLiveQuery(() => 
    db.friends.where('age').below(30).toArray()
  );
  
  // friends is guaranteed to be defined here
  return <FriendList friends={friends} />;
}

// Wrap with Suspense boundary
function App() {
  return (
    <Suspense fallback={<Loading />}>
      <MyComponent />
    </Suspense>
  );
}

dexie-cloud-addon Changes

New Exports

• AuthProvidersResponse - Type for the /auth-providers endpoint response
• OAuthProviderInfo - Type for OAuth provider metadata

New API Methods

• db.cloud.getAuthProviders() - Fetches available authentication providers from the server

Extended LoginHints Interface for db.cloud.login()

interface LoginHints {
  email?: string;
  userId?: string;
  grant_type?: 'demo' | 'otp';
  otpId?: string;
  otp?: string;
  provider?: string;      // OAuth provider name (e.g., 'google', 'github')
  oauthCode?: string;     // Dexie Cloud authorization code from OAuth callback
  redirectPath?: string;  // Optional redirect path for OAuth redirect URI
}

New Configuration Options

interface DexieCloudOptions {
  // ... existing options ...
  
  /** Enable social/OAuth authentication.
   * - true (default): Fetch providers from server, show if available
   * - false: Disable OAuth, always use OTP flow
   */
  socialAuth?: boolean;

  /** Redirect URI for OAuth callback.
   * Defaults to window.location.href for web SPAs.
   * For Capacitor/native apps, set to a custom URL scheme.
   */
  oauthRedirectUri?: string;
}

Default UI Updates

The default login GUI now includes:

• Provider selection dialog when OAuth providers are available
• Branded buttons for each OAuth provider
• Seamless fallback to OTP when no providers are configured

Documentation

• Social Authentication Guide
• dexie-cloud-addon API
• Dexie React Hooks

Migration Notes

This release is fully backward compatible. Social authentication is opt-in and requires server-side configuration of OAuth providers. Existing OTP authentication continues to work as before.