RaisinDB Authentication

RaisinDB authentication runs over WebSocket. The client connects, gets an anonymous session automatically, and can upgrade to an authenticated session via email/password login or registration. Tokens are persisted in localStorage and restored on reload via initSession().

Session Initialization

Call initSession() once at app startup, before any queries. It restores a stored token (if any) and connects the WebSocket. Returns the authenticated user or null for anonymous.

import { RaisinClient, LocalStorageTokenStorage } from '@raisindb/client';

const client = new RaisinClient('ws://localhost:8080/sys/default/myrepo', {
  tokenStorage: new LocalStorageTokenStorage('myapp'),
  tenantId: 'default',
  defaultBranch: 'main',
  connection: { autoReconnect: true, heartbeatInterval: 30000 },
});

const user = await client.initSession('myrepo');